【.NET6+Modbus】Modbus TCP协议解析、仿真环境以及基于.NET实现基础通信
前言:随着工业化的发展,目前越来越多的开发,从互联网走向传统行业。其中,工业领域也是其中之一,包括各大厂也都在陆陆续续加入工业4.0的进程当中。
工业领域,最核心的基础设施,应该是与下位硬件设备或程序进行通信有关的了,而下位机市场基本上是PLC的天下。而PLC产品就像编程语言一样,类型繁多,协议也多种多样。例如,西门子PLC最常用的S7协议、施耐德PLC最常用的Modbus协议、以及标准工业通信协议CIP协议等等。而多种通信协议里面,基于以太网通信的居多。以太网通信的里面,通用协议除了CIP协议,就属于Modbus TCP协议了。
接下来的内容,我会以从头开发一个简单的基于modbus tcp通信的案例,来实现一个基础的通信功能。
有关环境:
开发环境: VS 2022企业版
运行环境: Win 10 专业版
.NET 环境版本: .NET 6
【备注】 源码在文末
1、新建一个基于.NET 6带控制器的webapi项目,以及一个类库项目。如下图所示,新建以后的项目目录结构。
2、由于modbus tcp通信实际上就是一个socket通信,所以在类库项目下,先创建了一个Modbus服务类,并且提供一个基于socket通信连接的方法。socket连接以后,需要返回socket实例拿来使用。
3、为了方便一点,再新增一个通用的返回信息类,用于存储一些返回信息使用。
4、基于以上的返回信息类,咱对连接方法进行稍微改造一下,让它看起来更方便一点。这样可以用来验证连接是否正常,以及返回对应的异常信息,好做进一步处理。
5、Modbus TCP请求的报文规则,一些解析信息如下:
站地址:默认0x01, 除非PLC告诉我们其他站地址。
功能码:代表读写数据时候指定的读写方法等。例如读取线圈的功能码是0x01。
地址和读取长度:地址目前个人在施耐德物理的PLC环境上,不能超过30000。同时,单次读写长度不能超过248个byte,否则PLC可能会飘。当然,也可能将来一些PLC可以支持更长的批量数据读写,目前在施耐德PLC环境下不支持(具体型号忘记了,有点久了,当前身边没得PLC了,等下会使用仿真工具来做环境)。
头部校验(消息唯一识别码):0~65535,用于PLC服务端进行区分不同的客户端而使用的一组数据标识,不同的客户端必须保证标识码不重合。例如多个客户端同时存在时候,发起的通信请求,必须保持不一样的识别码,否则Modbus服务端有可能会因为不知是哪个客户端发起的请求而导致信息乱了。
无(协议标识):默认0,代表是Modbus协议。
数据长度:发送的报文的长度,刚好是6位,所以可以写成固定值0x06。(写入的规则不一样,此处固定值只当作读取时候使用)
6、根据协议的一些具体内容,写一个存储功能码和异常返回码的数据类,用于后期做通信时候传参和通信数据验证使用。有关协议具体内容,如下代码所示。
7、由于异常码是byte数据,直接验证可能会麻烦一点,为了可以直观一些,此处再新增一个用于解析Modbus返回的异常信息的方法,用于备用。
8、根据协议规则,提供一些参数,并先搭建一个简单的方法框架,用来可以进行读取线圈的功能。包含简单的报文数据拆分以及报文发送和接收。由于发送报文长度不能超过248byte(1 bool大小 == 1 byte,如果是其他类型,需要做其他长度换算),所以当长度超过时候,做个简单的算法进行拆分再发送,防止发生不必要的异常。以下做一个读取线圈(Bool类型数据)的简单方法。
9、根据上方提供的协议报文组装规则,进行开发一个通用的报文组织方法。有高低位之分,所以对于占用2byte的数据,需要进行"倒装"。
10、发送报文以后,返回的报文含有校验信息:发送的数据报文的第7位的数据,加上 0x80 以后,跟返回的报文的第7位byte数据如果一致,则代表当前通信上可能有异常。异常码在接收的响应报文的第8位。
所以可以继续写一个验证是否成功的校验方法:
11、由于返回的数据也都是byte数据,以上读取的线圈值(布尔值),就需要提供一个数据类型转换的功能用于把byte数组转换为bool数组。
12、对读取线圈的最开始的方法,进行一些完善以后的代码如下。响应报文长度是 发送数据长度*2+9 。
13、接下来做一个简单的测试。准备一下仿真环境,进行本地的测试,看看是否可以连通。先准备两个工具,一个是 modbus poll,另一个是modbus slave。一个用来模拟服务端环境,另一个可用来模拟数据收发验证。
【备注】:由于网上存在很多爬虫爬取博客文章到各个地方的,所以如果有需要这俩工具的小伙伴,可以点击该文章的 原文链接:【https://www.cnblogs.com/weskynet/p/16121383.html】的最下方的QQ群号进行加群进行获取,或者在文章最后提供的个人微信号,加我个人微信私发也可以。
14、两边都设置为读写单个线圈的功能,用于测试以上线圈读取的代码的功能。
15、两边都设置为modbus tcp连接方式。Slave站点启动以后,默认为本地,poll工具上的IP地址选择本地即可。如果是真实PLC环境,则填写真实PLC地址。
16、测试两边是否通信上。给任意一个地址写入一个true,可以看到另一边也同步更新,说明通信是通的了。
【注意】modbus工具,poll和slave工具默认占用了消息唯一标识码,大概是1~5左右的固定值,所以使用该工具期间,建议程序上的唯一消息识别码设置为5以上,以防止通信干扰。
17、接下来就可以继续完善代码进行验证了。先新增ModbusService的接口IModbusService,用于实现依赖注入。然后在program.cs文件里面进行服务注册。
18、新建一个控制器,用来进行模拟实验。有关代码和注释如图所示。
19、进行读取一个长度试试效果。结果是数据不支持,说明报文有问题。
20、通过断点,找到问题所在,上面的代码里面,length经过简单算法计算以后等于0,此处需要用的应该是newLength变量的值。
21、再次测试,地址从1开始,读取两个地址,结果符合预期。
22、再测试一下,从0开始读取30个,并随即设置若干个是True的值。
23、其他的写入、以及其他类型读写,基本类似。由于篇幅有限,就不继续进行一步一步操作的截图了。读取的,选好类型,报文格式都是一样的,唯一有差别的是写入的报文。下面是写入单个线圈值的报文。线圈当前仅支持一个一个写入。
24、写入寄存器的规则会有些偏差,协议规则如下图。
【备注】以上图的标题,我写错了,应该是 “写入寄存器”报文协议,懒得换图了,大佬们看的时候自己辨别哈~
读取线圈当作引导,其他类型也都异曲同工,大佬们可以自行尝试。
另外说点,如果是生产环境下使用,建议把客户端连接做成【长连接】,不然重复创建连接比较耗费资源,耗时也会因为新建连接而占用一大半。同时,如果是多线程访问,使用同一个客户端连接,必须加锁,否则会干扰数据;如果是多线程,不同客户端,就要保证每个消息识别码必须不同,如果存在同一个识别码,很容易发生数据异常等情况。
有关源码:
ModbusService源码:
public class ModbusService: IModbusService
{ public ResultInformation<Socket> ConnectModbusTcpService( IPAddress ip, int port)
{
ResultInformation<Socket> client = new();
try
{
client.Result = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp);
client.Result.Connect(new IPEndPoint(ip, port));
client.IsSucceed = true;
}
catch (Exception ex)
{
client.IsSucceed=false;
client.Message = ex.Message;
}
return client;
} /// <summary>
/// 读取线圈值(Bool)
/// </summary>
/// <param name="client">客户端</param>
/// <param name="headCode">头部标识</param>
/// <param name="station">站地址</param>
/// <param name="address">地址</param>
/// <param name="length">长度</param>
/// <returns></returns>
public ResultInformation<bool[]> ReadCoils(Socket client,ushort headCode,byte station, ushort address, ushort length)
{
ResultInformation<bool[]> result = new();
int resultIndex = 0;
ushort newLength = 0;
ushort realLength = length; // 存储实际长度
try
{
List<byte> byteResult = new List<byte>(); // 存储实际读取到的所有有效的byte数据
while (length > 0)
{
if (length > 248) // 长度限制,不能超过248
{
length = (ushort)(length - 248);
newLength = 248;
}
else
{
newLength = length;
length = 0;
}
resultIndex += newLength;
byte[] sendBuffers = BindByteData(headCode,station,FunctionCode.ReadCoil,address,newLength); // 组装报文
client.Send(sendBuffers);
byte[] receiveBuffers = new byte[newLength * 2 + 9];
int count = client.Receive(receiveBuffers); // 等待接收报文
var checkResult = CheckReceiveBuffer(sendBuffers, receiveBuffers); // 验证消息发送成功与否
if (checkResult.IsSucceed)
{
// 成功,如果长度超出单次读取长度,进行继续读取,然后对数据进行拼接
List<byte> byteList = new List<byte>(receiveBuffers);
byteList.RemoveRange(0, 9); // 去除前面9个非数据位
byteResult.AddRange(byteList); // 读取到的数据进行添加进集合
address += newLength; // 下一个起始地址
}
else
{
throw new Exception(checkResult.Message);
}
}
result.IsSucceed = true;
result.Result = ByteToBoolean(byteResult.ToArray(), realLength);
}
catch (Exception ex)
{
result.IsSucceed = false;
result.Result = new bool[0];
result.Message = ex.Message;
}
return result;
} private bool[] ByteToBoolean(byte[] data,int length)
{
if (data == null)
{
return new bool[0];
}
if (length > data.Length * 8) length = data.Length * 8;
bool[] result = new bool[length];
for (int i = 0; i < length; i++)
{
int index = i / 8;
int offect = i % 8;
byte temp = 0;
switch (offect)
{
case 0: temp = 0x01; break;
case 1: temp = 0x02; break;
case 2: temp = 0x04; break;
case 3: temp = 0x08; break;
case 4: temp = 0x10; break;
case 5: temp = 0x20; break;
case 6: temp = 0x40; break;
case 7: temp = 0x80; break;
default: break;
} if ((data[index] & temp) == temp)
{
result[i] = true;
}
}
return result;
} private byte[] BindByteData(ushort headCode,byte station,byte functionCode,ushort address, ushort length)
{
byte[] head = new byte[6];
head[0] = station; // 站地址
head[1] = functionCode; // 功能码
head[2] = BitConverter.GetBytes(address)[1]; // 起始地址
head[3] = BitConverter.GetBytes(address)[0];
head[4] = BitConverter.GetBytes(length)[1]; // 长度
head[5] = BitConverter.GetBytes(length)[0]; return GetSocketBytes(headCode,head); } private byte[] GetSocketBytes(ushort headCode,byte[] head)
{
byte[] buffers = new byte[head.Length+6];
buffers[0] = BitConverter.GetBytes(headCode)[1];
buffers[1] = BitConverter.GetBytes(headCode)[0];
// 2 和 3位置默认,所以不需要赋值
buffers[4] = BitConverter.GetBytes(head.Length)[1];
buffers[5] = BitConverter.GetBytes(head.Length)[0]; head.CopyTo(buffers, 6); return buffers;
} private ResultInformation<string> CheckReceiveBuffer(byte[] send,byte[] receive)
{
ResultInformation<string> result = new();
if ((send[7] + 0x80) == receive[7])
{
var str = FunctionCode.GetDescriptionByErrorCode(receive[8]);
result.IsSucceed = false;
result.Message = str;
}
else
{
result.IsSucceed = true;
} return result;
} }
控制器源码:
[Route("api/[controller]/[action]")]
[ApiController]
public class TestModbusController : ControllerBase
{
IModbusService _service;
public TestModbusController(IModbusService modbusService)
{
_service = modbusService;
}
[HttpPost]
public IActionResult ReadCoil(ushort address, ushort length)
{
var ip = IPAddress.Parse("127.0.0.1"); // ip地址
int port = 502; // modbus tcp通信,默认端口
byte station = (byte)((short)1); // 站地址为1 var connectResult = _service.ConnectModbusTcpService(ip,port);
if (connectResult.IsSucceed)
{
// socket连接创建成功
var readResult = _service.ReadCoils(connectResult.Result,6,station,address,length); // 唯一消息码设为6(大于5,且不重复即可)
if (readResult.IsSucceed)
{
if (readResult.Result.Any())
{
StringBuilder sb = new StringBuilder();
for(int i = 0; i < readResult.Result.Length; i++)
{
sb.AppendLine($"[{i}]:{readResult.Result[i]}");
}
return Ok(sb.ToString());
}
}
else
{
return Ok(readResult.Message);
}
}
else
{
return Ok(connectResult.Message);
} return Ok();
}
}
功能码和异常码:
public class FunctionCode
{
#region 功能码
public const byte ReadCoil = 0x01; // 读取线圈状态 寄存器PLC地址 00001 - 09999
public const byte ReadInputDiscrete = 0x02; // 读取 可输入的离散量 寄存器PLC地址 10001 - 19999
public const byte ReadRegister = 0x03; // 读取 保持寄存器 40001 - 49999
public const byte ReadInputRegister = 0x04; // 读取 可输入寄存器 30001 - 39999
public const byte WriteSingleCoil = 0x05; // 写单个 线圈 00001 - 09999
public const byte WriteSingleRegister = 0x06; // 写单个 保持寄存器 40001 - 49999
public const byte WriteMultiCoil = 0x0F; // 写多个 线圈 00001 - 09999
public const byte WriteMultiRegister = 0x10; // 写多个 保持寄存器 40001 - 49999
public const byte SelectSlave = 0x11; // 查询从站状态信息 (串口通信使用)
#endregion #region 异常码
public const byte FunctionCodeNotSupport = 0x01;// 非法功能码
public const byte DataAddressNotSupport = 0x02;// 非法数据地址
public const byte DataValueNotSupport = 0x03;// 非法数据值
public const byte DeviceNotWork = 0x04;// 从站设备异常
public const byte LongTimeResponse = 0x05;// 请求需要更长时间才能进行处理请求
public const byte DeviceBusy = 0x06;// 设备繁忙
public const byte OddEvenError = 0x08;// 奇偶性错误
public const byte GatewayNotSupport = 0x0A;// 网关错误
public const byte GatewayDeviceResponseTimeout = 0x0B;// 网关设备响应失败
#endregion public static string GetDescriptionByErrorCode(byte code)
{
switch (code)
{
case FunctionCodeNotSupport:
return "FunctionCodeNotSupport";
case DataAddressNotSupport:
return "DataAddressNotSupport";
case DataValueNotSupport:
return "DataValueNotSupport";
case DeviceNotWork:
return "DeviceNotWork";
case LongTimeResponse:
return "LongTimeResponse";
case DeviceBusy:
return "DeviceBusy";
case OddEvenError:
return "OddEvenError";
case GatewayNotSupport:
return "GatewayNotSupport";
case GatewayDeviceResponseTimeout:
return "GatewayDeviceResponseTimeout";
default:
return "UnknownError";
}
} }
好了,以上就是该文章的全部内容。如果觉得有帮助,欢迎一键三连啊~~ 如果有兴趣,也可以加我私人微信,欢迎大佬来我微信群做客。私人微信:【WeskyNet001】
【.NET6+Modbus】Modbus TCP协议解析、仿真环境以及基于.NET实现基础通信的更多相关文章
- TCP协议解析
本文摘抄自:http://www.kuqin.com/shuoit/20141018/342719.html 本文描述了TCP协议,首先简单介绍了TCP完成了一些什么功能:介绍了TCP报文格式,以及典 ...
- TCP协议解析及相关问题
TCP协议是什么: TCP是一种传输控制层的协议(TCP,Transmission Control Protocol)是为了在不可靠的互联网络上提供可靠的端到端字节流而专门设计的一个传输协议.也就是要 ...
- 还是端口回流问题 TCP协议解析
还是上一篇的问题 在一内部局域网中, client 内网地址为 10.0.0.2 web 服务器内网地址为 10.0.0.1 外网地址为 211.6.15.1 域名为 xx ...
- 网络编程——基于TCP协议的Socket编程,基于UDP协议的Socket编程
Socket编程 目前较为流行的网络编程模型是客户机/服务器通信模式 客户进程向服务器进程发出要求某种服务的请求,服务器进程响应该请求.如图所示,通常,一个服务器进程会同时为多个客户端进程服务,图中服 ...
- 千兆以太网TCP协议的FPGA实现
转自https://blog.csdn.net/zhipao6108/article/details/82386355 千兆以太网TCP协议的FPGA实现 Lzx 2017/4/20 写在前面,这应该 ...
- TCP协议调试工具TcpEngine V1.3.0使用教程
简介 这里说的TCP协议调试定义是在开发长连接TCP协议应用时,为了验证代码流程或查找bug,需要与对端交互数据过来,当需要时可以暂停发送:单条发送:跳过发送:正常发送:发送时修改数据等. T ...
- 初识TCP协议
一.引言 发送一段TCP数据大致需要经过:用户封装 –> TCP封装 –> IP封装 –>帧封装 Note:用户封装没啥好说的,都是客户自己决定的,在一些简单的应用情况下,这个步骤可 ...
- 为什么 TCP 协议有粘包问题
为什么 TCP 协议有粘包问题 这部分转载自draveness博客. TCP/IP 协议簇建立了互联网中通信协议的概念模型,该协议簇中的两个主要协议就是 TCP 和 IP 协议.TCP/ IP 协议簇 ...
- 协议森林08 不放弃 (TCP协议与流通信)
作者:Vamei 出处:http://www.cnblogs.com/vamei 欢迎转载,也请保留这段声明.谢谢! TCP(Transportation Control Protocol)协议与IP ...
随机推荐
- Linux----虚拟机克隆、快照、删除、
克隆 已经安装一台linux系统 还想要更多的,直接克隆CentOS即可 使用vm ware 的克隆操作 注意: 使用前先关闭目前已开启的虚拟机 快照 作用: 虚拟系统出现异常,需要回到原先的状态,此 ...
- docker是干什么的,docker常用命令
镜像下载.域名解析.时间同步请点击 阿里云开源镜像站 一.百度百科 Docker是一个开源的应用容器引擎,让开发者可以打包他们的应用以及依赖到一个可移植的镜像中,然后发布到任何流行的Linux或Win ...
- FLask插件
Flask插件 flask-session 下载 pip install Flask-session 导入 from flask_session import Session 实例化session 在 ...
- 4月10日 python学习总结 模块和面向对象
1.hashlib 1.什么叫hash:hash是一种算法,该算法接受传入的内容,经过运算得到一串hash值 2.hash值的特点是:2.1 只要传入的内容一样,得到的hash值必然一样=====& ...
- CVE-2017-12635(Couchdb垂直权限绕过漏洞)
简介 Apache CouchDB是一个开源数据库,专注于易用性和成为"完全拥抱web的数据库".它是一个使用JSON作为存储格式,JavaScript作为查询语言,MapRedu ...
- C++图像处理算法入门前言
一 前言 由于面试时,很多面试官一直强调算法才是根本,编代码不是.有以下两个原因: 第一个原因:即要想成为一名合格的应用工程师(不管是软件还是硬件),都得以学习算法,动手实现算法为核心,这才是核心竞 ...
- synchronized 与 lock锁的异同
相同点: 二者都可以解决线程安全问题: 不同点: 1..Synchronized 是Java内置的关键字:Lock是一个Java类: 2.Synchronized 无法判断锁的状态:Lock可以判断是 ...
- idea常见设置一
1.顶部执行栏调整 原: 设置:勾选view==>toolbar 后: 这个一看其实没有什么太大的作用,但是你看这个按钮 这个按钮就是File==>Settings,这样会稍微方便点,只要 ...
- 学习HTML5 history API
html5 在 history 对象上添加几个新的方法.事件.属性,用以增强开发者对于浏览器历史记录的控制.大体上说,新的API可以帮助我们在无刷新的情况下改变浏览器的url,新增或者替换之前的历史记 ...
- 推荐一些好用的 HTML5 & JavaScript 游戏引擎开发库
推荐一些好用的 HTML5 & JavaScript 游戏引擎开发库 0. 引言 如果你是一个游戏开发者,并且正在寻找一个可以与 JavaScript 和 HTML5 无缝工作的游戏引擎.那么 ...