Modbus 协议实战Modbus-RTU/TCP 采集传感器、变频器工控案例工控圈有句行话没听过 Modbus都不好意思说自己是搞自动化的。这篇从协议帧到代码实操一次性讲透。一、Modbus 协议简介Modbus 是 1979 年 Modicon 公司现施耐德电气发明的工业通信协议如今已成为工业自动化领域事实上的通信标准。几乎所有工控设备——PLC、变频器、传感器、电表——都支持 Modbus。Modbus 有三种传输模式模式传输介质特点典型场景Modbus-RTU串口RS232/RS485二进制帧CRC校验效率高现场设备通信Modbus-ASCII串口ASCII字符LRC校验可读性好调试场景Modbus-TCP以太网去掉CRC加MBAP头端口502网络化监控实际工控项目中RTU 和 TCP 用得最多ASCII 基本淘汰。二、Modbus-RTU 帧结构2.1 帧格式一个完整的 Modbus-RTU 帧结构如下| 从机地址(1B) | 功能码(1B) | 数据区(NB) | CRC校验(2B) |帧与帧之间靠时间间隔区分两个字符之间的间隔不能超过 3.5 个字符的传输时间在 9600bps 下约 3.6ms。超过这个间隔就认为是新的一帧。2.2 常用功能码功能码操作说明0x01读线圈读开关量输出状态ON/OFF0x02读离散输入读开关量输入状态只读0x03读保持寄存器读模拟量/参数最常用0x04读输入寄存器读模拟量输入只读0x05写单个线圈控制单个开关0x06写单个寄存器设定单个参数值0x0F写多个线圈批量控制开关0x10写多个寄存器批量设定参数举例读保持寄存器的请求帧和响应帧请求01 03 00 00 00 02 C4 0B | | | | |—CRC | | | |—寄存器数量(2个) | | |—起始地址(0x0000) | |—功能码(03 读保持寄存器) |—从机地址(01) 响应01 03 04 01 90 00 7A 6B 3D | | | |————|—数据(2个寄存器4字节) | | |—字节数(4) | |—功能码 |—从机地址寄存器值 0x0190 和 0x007A即十进制 400 和 122。三、Modbus-TCP 帧结构Modbus-TCP 用 MBAP 头替代了 RTU 的从机地址CRC| MBAP头(7B) | 功能码(1B) | 数据区(NB) |MBAP 头结构字段长度说明事务标识2B请求/响应匹配标识协议标识2B固定0x0000长度2B后续字节数单元标识1B从机地址对应RTU地址TCP 不需要 CRC因为 TCP 本身就保证数据完整性。默认端口502。四、libmodbus 开源库使用4.1 安装# Ubuntu/Debiansudoaptinstalllibmodbus-dev# 或从源码编译推荐版本更新gitclone https://github.com/stephane/libmodbus.gitcdlibmodbus ./autogen.sh ./configuremake-j$(nproc)sudomakeinstallsudoldconfig4.2 libmodbus 核心APImodbus_t*mb;// 上下文句柄mbmodbus_new_rtu(/dev/ttyS0,9600,N,8,1);// RTU模式mbmodbus_new_tcp(192.168.1.100,502);// TCP模式modbus_set_slave(mb,1);// 设置从机地址modbus_connect(mb);// 建立连接// 读写操作uint16_tregs[10];modbus_read_registers(mb,0,2,regs);// 读保持寄存器modbus_write_register(mb,0,500);// 写单个寄存器modbus_write_registers(mb,0,2,regs);// 写多个寄存器uint8_tbits[10];modbus_read_bits(mb,0,8,bits);// 读线圈modbus_write_bit(mb,0,TRUE);// 写单个线圈modbus_close(mb);modbus_free(mb);五、实战案例1读取温湿度传感器 Modbus 数据场景某 RS485 温湿度传感器地址01波特率96008N1。温度在保持寄存器0x0000湿度在0x0001。#includestdio.h#includemodbus.hintmain(){modbus_t*mb;uint16_tregs[2];intrc;// 初始化RTU连接mbmodbus_new_rtu(/dev/ttyS0,9600,N,8,1);if(mbNULL){fprintf(stderr,Failed to create modbus context\n);return-1;}modbus_set_slave(mb,1);if(modbus_connect(mb)-1){fprintf(stderr,Connection failed: %s\n,modbus_strerror(errno));modbus_free(mb);return-1;}// 读取地址0x0000开始的2个保持寄存器rcmodbus_read_registers(mb,0x0000,2,regs);if(rc-1){fprintf(stderr,Read failed: %s\n,modbus_strerror(errno));}else{// 假设传感器输出温度×10存于寄存器0湿度×10存于寄存器1floattempregs[0]/10.0f;floathumiregs[1]/10.0f;printf(Temperature: %.1f C\n,temp);printf(Humidity: %.1f %%\n,humi);}modbus_close(mb);modbus_free(mb);return0;}编译gcc modbus_sensor.c -o modbus_sensor -lmodbus六、实战案例2控制变频器启停与频率设定场景变频器地址02波特率96008E1。控制字寄存器地址0x2000频率设定寄存器地址0x2001。#includestdio.h#includemodbus.h#includeunistd.h#defineVFD_ADDR2#defineCTRL_REG0x2000// 控制字寄存器#defineFREQ_REG0x2001// 频率设定寄存器// 控制字定义以某品牌变频器为例#defineCMD_STOP0x0006// 停止#defineCMD_START0x0007// 正转启动#defineCMD_REVERSE0x000F// 反转启动intmain(){modbus_t*mb;intrc;mbmodbus_new_rtu(/dev/ttyS0,9600,E,8,1);if(mbNULL)return-1;modbus_set_slave(mb,VFD_ADDR);if(modbus_connect(mb)-1){modbus_free(mb);return-1;}// 设置频率25.0Hz → 寄存器值250频率×10rcmodbus_write_register(mb,FREQ_REG,250);if(rc-1){fprintf(stderr,Set frequency failed: %s\n,modbus_strerror(errno));}else{printf(Frequency set to 25.0 Hz\n);}// 启动变频器rcmodbus_write_register(mb,CTRL_REG,CMD_START);if(rc-1){fprintf(stderr,Start failed: %s\n,modbus_strerror(errno));}else{printf(VFD started\n);}// 运行10秒后停止sleep(10);modbus_write_register(mb,CTRL_REG,CMD_STOP);printf(VFD stopped\n);modbus_close(mb);modbus_free(mb);return0;}注意不同品牌变频器的控制字定义和寄存器地址不同务必查阅对应型号的 Modbus 通信手册。七、CRC 校验原理与手动计算Modbus-RTU 使用 CRC-16 校验多项式 0xA001计算步骤预置 CRC 寄存器为 0xFFFF取帧中第一个字节与 CRC 低8位异或如果最低位为1右移一位并异或 0xA001为0则直接右移重复步骤3共8次处理完一个字节对帧中每个字节重复步骤2~4最终 CRC 寄存器的值即为校验码低字节在前高字节在后C 语言实现uint16_tmodbus_crc16(uint8_t*data,intlen){uint16_tcrc0xFFFF;for(inti0;ilen;i){crc^data[i];for(intj0;j8;j){if(crc0x0001)crc(crc1)^0xA001;elsecrc1;}}returncrc;}手动验证对帧01 03 00 00 00 02计算 CRC结果应为0x0BC4发送时低字节在前... C4 0B。八、Modbus 调试工具推荐8.1 modpoll命令行工具快速测试 Modbus 设备# 读RTU设备地址1的保持寄存器0数量2modpoll-mrtu-b9600-pnone-a1-r1-c2/dev/ttyS0# 读TCP设备地址1的保持寄存器0modpoll-mtcp-a1-r1-c2192.168.1.1008.2 QModMaster图形化 Modbus 主站工具支持 RTU/TCP可以图形界面配置参数、查看数据适合现场调试。8.3 Modbus Poll / Modbus Slave经典调试组合Poll 模拟主站Slave 模拟从站方便在没有真实设备时测试程序。九、小结Modbus 协议本身非常简单——就是地址功能码数据CRC的字节流。但它的工程价值极高RTU 场景用 libmodbus 几行代码就能读传感器、控变频器TCP 场景换一个初始化函数其余 API 完全一样调试modpoll QModMaster 足以覆盖现场大部分需求掌握 Modbus等于拿到了工控通信的入场券。
Modbus 协议实战：Modbus-RTU/TCP 采集传感器、变频器工控案例
Modbus 协议实战Modbus-RTU/TCP 采集传感器、变频器工控案例工控圈有句行话没听过 Modbus都不好意思说自己是搞自动化的。这篇从协议帧到代码实操一次性讲透。一、Modbus 协议简介Modbus 是 1979 年 Modicon 公司现施耐德电气发明的工业通信协议如今已成为工业自动化领域事实上的通信标准。几乎所有工控设备——PLC、变频器、传感器、电表——都支持 Modbus。Modbus 有三种传输模式模式传输介质特点典型场景Modbus-RTU串口RS232/RS485二进制帧CRC校验效率高现场设备通信Modbus-ASCII串口ASCII字符LRC校验可读性好调试场景Modbus-TCP以太网去掉CRC加MBAP头端口502网络化监控实际工控项目中RTU 和 TCP 用得最多ASCII 基本淘汰。二、Modbus-RTU 帧结构2.1 帧格式一个完整的 Modbus-RTU 帧结构如下| 从机地址(1B) | 功能码(1B) | 数据区(NB) | CRC校验(2B) |帧与帧之间靠时间间隔区分两个字符之间的间隔不能超过 3.5 个字符的传输时间在 9600bps 下约 3.6ms。超过这个间隔就认为是新的一帧。2.2 常用功能码功能码操作说明0x01读线圈读开关量输出状态ON/OFF0x02读离散输入读开关量输入状态只读0x03读保持寄存器读模拟量/参数最常用0x04读输入寄存器读模拟量输入只读0x05写单个线圈控制单个开关0x06写单个寄存器设定单个参数值0x0F写多个线圈批量控制开关0x10写多个寄存器批量设定参数举例读保持寄存器的请求帧和响应帧请求01 03 00 00 00 02 C4 0B | | | | |—CRC | | | |—寄存器数量(2个) | | |—起始地址(0x0000) | |—功能码(03 读保持寄存器) |—从机地址(01) 响应01 03 04 01 90 00 7A 6B 3D | | | |————|—数据(2个寄存器4字节) | | |—字节数(4) | |—功能码 |—从机地址寄存器值 0x0190 和 0x007A即十进制 400 和 122。三、Modbus-TCP 帧结构Modbus-TCP 用 MBAP 头替代了 RTU 的从机地址CRC| MBAP头(7B) | 功能码(1B) | 数据区(NB) |MBAP 头结构字段长度说明事务标识2B请求/响应匹配标识协议标识2B固定0x0000长度2B后续字节数单元标识1B从机地址对应RTU地址TCP 不需要 CRC因为 TCP 本身就保证数据完整性。默认端口502。四、libmodbus 开源库使用4.1 安装# Ubuntu/Debiansudoaptinstalllibmodbus-dev# 或从源码编译推荐版本更新gitclone https://github.com/stephane/libmodbus.gitcdlibmodbus ./autogen.sh ./configuremake-j$(nproc)sudomakeinstallsudoldconfig4.2 libmodbus 核心APImodbus_t*mb;// 上下文句柄mbmodbus_new_rtu(/dev/ttyS0,9600,N,8,1);// RTU模式mbmodbus_new_tcp(192.168.1.100,502);// TCP模式modbus_set_slave(mb,1);// 设置从机地址modbus_connect(mb);// 建立连接// 读写操作uint16_tregs[10];modbus_read_registers(mb,0,2,regs);// 读保持寄存器modbus_write_register(mb,0,500);// 写单个寄存器modbus_write_registers(mb,0,2,regs);// 写多个寄存器uint8_tbits[10];modbus_read_bits(mb,0,8,bits);// 读线圈modbus_write_bit(mb,0,TRUE);// 写单个线圈modbus_close(mb);modbus_free(mb);五、实战案例1读取温湿度传感器 Modbus 数据场景某 RS485 温湿度传感器地址01波特率96008N1。温度在保持寄存器0x0000湿度在0x0001。#includestdio.h#includemodbus.hintmain(){modbus_t*mb;uint16_tregs[2];intrc;// 初始化RTU连接mbmodbus_new_rtu(/dev/ttyS0,9600,N,8,1);if(mbNULL){fprintf(stderr,Failed to create modbus context\n);return-1;}modbus_set_slave(mb,1);if(modbus_connect(mb)-1){fprintf(stderr,Connection failed: %s\n,modbus_strerror(errno));modbus_free(mb);return-1;}// 读取地址0x0000开始的2个保持寄存器rcmodbus_read_registers(mb,0x0000,2,regs);if(rc-1){fprintf(stderr,Read failed: %s\n,modbus_strerror(errno));}else{// 假设传感器输出温度×10存于寄存器0湿度×10存于寄存器1floattempregs[0]/10.0f;floathumiregs[1]/10.0f;printf(Temperature: %.1f C\n,temp);printf(Humidity: %.1f %%\n,humi);}modbus_close(mb);modbus_free(mb);return0;}编译gcc modbus_sensor.c -o modbus_sensor -lmodbus六、实战案例2控制变频器启停与频率设定场景变频器地址02波特率96008E1。控制字寄存器地址0x2000频率设定寄存器地址0x2001。#includestdio.h#includemodbus.h#includeunistd.h#defineVFD_ADDR2#defineCTRL_REG0x2000// 控制字寄存器#defineFREQ_REG0x2001// 频率设定寄存器// 控制字定义以某品牌变频器为例#defineCMD_STOP0x0006// 停止#defineCMD_START0x0007// 正转启动#defineCMD_REVERSE0x000F// 反转启动intmain(){modbus_t*mb;intrc;mbmodbus_new_rtu(/dev/ttyS0,9600,E,8,1);if(mbNULL)return-1;modbus_set_slave(mb,VFD_ADDR);if(modbus_connect(mb)-1){modbus_free(mb);return-1;}// 设置频率25.0Hz → 寄存器值250频率×10rcmodbus_write_register(mb,FREQ_REG,250);if(rc-1){fprintf(stderr,Set frequency failed: %s\n,modbus_strerror(errno));}else{printf(Frequency set to 25.0 Hz\n);}// 启动变频器rcmodbus_write_register(mb,CTRL_REG,CMD_START);if(rc-1){fprintf(stderr,Start failed: %s\n,modbus_strerror(errno));}else{printf(VFD started\n);}// 运行10秒后停止sleep(10);modbus_write_register(mb,CTRL_REG,CMD_STOP);printf(VFD stopped\n);modbus_close(mb);modbus_free(mb);return0;}注意不同品牌变频器的控制字定义和寄存器地址不同务必查阅对应型号的 Modbus 通信手册。七、CRC 校验原理与手动计算Modbus-RTU 使用 CRC-16 校验多项式 0xA001计算步骤预置 CRC 寄存器为 0xFFFF取帧中第一个字节与 CRC 低8位异或如果最低位为1右移一位并异或 0xA001为0则直接右移重复步骤3共8次处理完一个字节对帧中每个字节重复步骤2~4最终 CRC 寄存器的值即为校验码低字节在前高字节在后C 语言实现uint16_tmodbus_crc16(uint8_t*data,intlen){uint16_tcrc0xFFFF;for(inti0;ilen;i){crc^data[i];for(intj0;j8;j){if(crc0x0001)crc(crc1)^0xA001;elsecrc1;}}returncrc;}手动验证对帧01 03 00 00 00 02计算 CRC结果应为0x0BC4发送时低字节在前... C4 0B。八、Modbus 调试工具推荐8.1 modpoll命令行工具快速测试 Modbus 设备# 读RTU设备地址1的保持寄存器0数量2modpoll-mrtu-b9600-pnone-a1-r1-c2/dev/ttyS0# 读TCP设备地址1的保持寄存器0modpoll-mtcp-a1-r1-c2192.168.1.1008.2 QModMaster图形化 Modbus 主站工具支持 RTU/TCP可以图形界面配置参数、查看数据适合现场调试。8.3 Modbus Poll / Modbus Slave经典调试组合Poll 模拟主站Slave 模拟从站方便在没有真实设备时测试程序。九、小结Modbus 协议本身非常简单——就是地址功能码数据CRC的字节流。但它的工程价值极高RTU 场景用 libmodbus 几行代码就能读传感器、控变频器TCP 场景换一个初始化函数其余 API 完全一样调试modpoll QModMaster 足以覆盖现场大部分需求掌握 Modbus等于拿到了工控通信的入场券。
