一、前言
通信协议解析是整个系统的核心灵魂，绝大部分人做软硬件通信开发，第一步估计就是写demo将协议解析好，然后再慢慢写整个界面和操作流程等，在工业控制领域，modbus协议应用还是非常广泛的，这个系统用的也是modbus协议，采用此协议可以方便的用一些第三方的组态软件接入，兼容性更强，modbus只是个协议规约标准，至于使用串口还是网络还是其他，都由厂家自行具体实现，一般正常来说，使用modbus协议的系统支持255个设备在同一个网络上进行通信，而且大部分都会采用485半双工的机制，挨个轮询设备状态，每次通信链路上要么在发送数据，要么在接收数据，不能同时进行，这样有个好处就是可以传输的距离一般可以到1200米，而如果是串口全双工的话，基本上在100米就歇菜，具体还要看波特率，当然如果可以用中转设备进行转发那除外。
本项目即支持串口设备也支持网络设备，在端口管理中添加好对应的通信端口即可，modbus通信协议的解析库，有个第三方开源的libmodbus，跨平台的，Qt从Qt5.8以来新增了总线serialbus库，其中就包括了QModbusClient和QModbusServer来做modbus协议的解析，本人两种都用过，大同小异，使用方法都差不多，总体上libmodbus要优于Qt自带的modbus。但是为了更大的灵活性，这个项目采用的自己程序解析协议数据来实现，这样不用去纠结封装的接口中每次发送几个字节那些接口对应的含义等，而且自己解析也很方便，我写过的所有的modbus通信项目，都是采用的自己做协议解析。
二、功能特点
2.1 软件模块
设备监控模块，包括数据监控（表格形式展示）、设备面板（面板形式展示）、地图监控（地图形式展示）、曲线监控（曲线形式展示）。数据查询模块，包括报警记录、运行记录、操作记录。系统设置模块，包括基本设置、端口管理、控制器管理、探测器管理、报警联动、类型设置等。其他设置模块，包括用户管理、地图管理、位置调整、组态设计、设备调试等。2.2 基础功能
设备数据采集，支持串口、网络，串口可设置串口号、波特率，网络可设置IP地址、通讯端口。每个端口支持采集周期时间，默认1秒钟一个设备。支持设置通讯超时次数，默认3次。支持最大重连时间，用于重新读取离线的设备。控制器信息，能够添加控制器名称，选择控制器地址、控制器型号，设置该控制器下面的探测器数量。探测器信息，能够添加位号、探测器型号、气体种类、气体符号、高报值、低报值、缓冲值、清零值、是否启用、报警声音、背景地图、存储周期、数值换算小数点位数、报警延时时间、报警的类型（HH,LL,HL）等。类型管理可配置控制器型号、探测器型号、气体种类、气体符号等。地图支持导入和删除，所有的探测器在地图上的位置可自由拖动保存。端口信息、控制器信息、探测器信息、类型信息、用户信息等，都支持导入、导出、导出到excel、打印。运行记录、报警记录、操作记录，都支持多条件组合查询，比如时间段、控制器、探测器等，所有记录支持导出到excel/pdf和打印。运行记录、报警记录、操作记录都可删除指定时间范围内的数据。系统设置可选择对应表最大保存记录数，自动清理早期数据，留出足够的空间存储重要的数据。报警短信转发，支持多个接收手机号码，可设定发送间隔，比如即时发送或者6个小时发送一次所有的报警信息，短信内容过长，自动拆分多条短信。报警邮件转发，支持多个接收邮箱，可设定发送间隔，比如即时发送或者6个小时发送一次所有的报警信息，支持附件发送。设置软件的中文标题、英文标题、logo路径、版权所有等。开关设置开机运行、报警声音、自动登录、记住密码等。报警声音可设置播放次数，界面风格样式提供18套皮肤文件选择。用户管理，包括用户权限配置，不同用户可以有不同模块的权限。用户登录和用户退出，可以记住密码和自动登录，超过三次报错提示并关闭程序。四种监控模式，设备面板监控、地图监控、表格数据监控、曲线数据监控，可自由切换，四种模式下都实时展示采集到的数据，报警闪烁等。报警继电器联动，一个位号可以跨串口联动多个模块和继电器号，支持多对多。2.3 特色功能
通信协议支持modbus_com、modbus_tcp_rtu，后期拓展mqtt等协议。数据源除了真实的硬件设备采集，还可选数据库采集，这样用户可以安排其他程序员比如java程序员将前端采集好的数据放到数据库，本系统直接从数据库采集即可。数据库采集模式可以作为通用的系统使用，更适合多人多系统协作。智能跳过超时的设备，加快对在线设备的采集速度，当设备数量很多的时候尤其有用。对智能跳过的超时的设备，在设定的重连时间自动采集一次，以便探测设备是否又重新上线。每个探测器可控是否启用，不启用则不会采集，也不会在界面显示，相当于运行阶段临时关闭。探测器可设置缓冲值和报警延时时间，在该值附近波动产生的报警，不计入报警，只有持续处于报警值且超过报警延时时间才算真正报警，这样可以规避很多波动导致的误报。探测器可设置存储周期，按照设定的时间来存储一条运行记录，可以按照重要程度对重要性高的设定存储周期短一些，不重要的设定大一些，这样可以节省不少的存储空间，也保证了重要的数据及时存储。探测器可设置清零值，在一些高精度高灵敏的设备可能出厂的时候默认值未必是0，需要设定清零值来表示初始值。探测器可设置小数点，用于计算后的真实数据控制小数点点位显示，相当于除以10、除以100、除以1000，这样大部分的探测器数据直接通过小数点位设置控制真实换算后的值，极个别的需要特殊转换的可以在通信协议中约定。探测器报警的类型支持多种，有些设备是高于某个值高报，低于某个值低报，而有些设备是在最小值最大值范围内是高报，低于最小值低报，高于最大值正常。这样可以分情况处理，涵盖各种报警类型。原创数据导入、导出、打印机制，跨平台不依赖任何组件，瞬间导出数据。导出到excel的记录支持所有excel、wps等表格文件版本，不依赖excel等软件。高报颜色、低报颜色、正常颜色、默认值颜色等，都可以自由设置。支持云端数据同步，将本地采集到的数据实时同步到云端。支持网络转发和网络接收，网络接收开启后，软件从udp接收数据进行解析。网络转发支持多个目标IP，这样就实现了本地采集的软件，自由将数据转到客户端，随时查看采集到的数据。自动记住用户最后停留的界面以及其他配置信息，重启后自动应用。报警自动切换到对应的地图，探测器按钮闪烁，表格数据对应颜色显示。双击探测器图标，弹出对应探测器详细信息，可以根据需要定制回控操作。数据库支持多种，包括sqlite、mysql、sqlserver、postgresql、oracle、人大金仓等。本地设备采集到的数据实时上传到云端，以便手机APP或者web等其他方式提取。自带设备模拟工具，支持不同型号的多个设备数据模拟，同时还带数据库数据模拟，以便在没有设备的时候测试数据。标准modbus协议，各种控制器类型、探测器类型、种类、符号等全部自定义，非常灵活和强大，通信协议示例数据非常完整，通用各种modbus协议系统，适用于各种应用场景接入。同时集成了串口通信、网络通信、数据库通信、数据导入导出打印、通信协议解析、界面UI、全局换肤等众多组件和知识点，非常适合新手入门和进阶。支持xp、win7、win10、、win11、linux、mac、各种国产系统（UOS、中标麒麟、银河麒麟等）、嵌入式linux等系统。注释完整，项目结构清晰，超级详细完整的使用开发手册，精确到每个代码文件的功能说明，不断持续迭代版本。三、体验地址
国内站点：/feiyangqingyun国际站点：/feiyangqingyun个人主页：/feiyangqingyun知乎主页：/people/feiyangqingyun产品主页：/feiyangqingyun/article/details/97565652在线文档：https://feiyangqingyun.gitee.io/qwidgetdemo/iotsystem/体验地址：/s/1ZxG-oyUKe286LPMPxOrO2A 提取码：o05q 文件名：bin_iotsystem.zip。文章导航：https://qtchina./article/details/121330922四、效果图
五、核心代码
void DeviceClient::checkValue(){if (!isOk) {return;}QMutexLocker locker(&mutex);readData();//至少要多少个字节,保证下面取数据不出错int size = buffer.size();if (size < 5) {return;}//01 03 08 00 00 00 00 00 00 00 00 95 D7//01 03 08 00 14 03 12 00 00 00 00 79 E6//取出首字节,判断是否为当前地址集合中的地址quint8 addr = buffer.at(0);quint8 cmd = buffer.at(1);quint8 len = buffer.at(2);//如果是错误码则直接解析错误信息QList<quint8> cmds;cmds << 0x03 << 0x04 << 0x06;if (!cmds.contains(cmd)) {emit receiveError(portName, addr, QString("数据出错: %1").arg(QUIHelper::byteArrayToHexStr(buffer)));buffer.clear();return;}//如果数据过长则丢弃当前数据包,不然一旦产生了错误的数据会一直累积if (size > 517) {emit receiveError(portName, addr, QString("数据出错: %1").arg(QUIHelper::byteArrayToHexStr(buffer)));buffer.clear();return;}//后面的数据长度必须大于等于长度数据位表示的长度if ((cmd == 0x03 || cmd == 0x04 || cmd == 0x06) && size < len + 5) {emit receiveError(portName, addr, QString("数据不全,等待完整数据再解析: %1").arg(QUIHelper::byteArrayToHexStr(buffer)));return;}//放在这里发出去数据是准确的完整的emit receiveData(portName, addr, buffer);//过滤不存在的地址,防止索引越界int index = addrs.indexOf(addr);if (index < 0) {emit receiveError(portName, addr, "地址出错: 当前地址不在设定的地址集合中");buffer.clear();return;}//来过消息的设备,立马更新最后的消息时间,以及判断设备上线times[index] = QDateTime::currentDateTime();if (!onlines.at(index)) {onlines[index] = true;emit receiveOnline(portName, addr, true);emit receiveInfo(portName, addr, "设备上线");}//根据不同的cmd+不同的命令类型 取出对应的数据内容if (cmd == 0x03) {QString info;if (currentType == "查询浓度值") {QList<quint16> values;for (int i = 3; i < size - 2; i = i + 2) {values << (float)QUIHelper::byteToUShort(buffer.mid(i, 2));}QStringList list;foreach (quint16 value, values) {list << QString::number(value);}info = QString("%1返回: %2").arg(currentType).arg(list.join(" "));emit receiveValue(portName, addr, values);} else if (currentType == "查询4路AD值") {//01 03 08 02 07 08 0C 00 00 00 00 73 87QList<quint16> values;for (int i = 3; i < size - 2; i = i + 2) {values << (float)QUIHelper::byteToUShort(buffer.mid(i, 2));}QStringList list;foreach (quint16 value, values) {list << QString::number(value);}info = QString("%1返回: %2").arg(currentType).arg(list.join(" "));emit receiveValueAD4(portName, addr, values);} else if (currentType == "查询报警标志") {//01 03 08 00 00 00 12 07 13 00 12 5D 68} else if (currentType == "查询标定日期") {//01 03 04 00 12 07 13 19 CBint year = QString("20%1").arg(QString::number(buffer.at(4), todate)).toInt();int month = QString::number(buffer.at(5), todate).toInt();int day = QString::number(buffer.at(6), todate).toInt();info = QString("%1返回: %2年%3月%4日").arg(currentType).arg(year).arg(month).arg(day);emit receiveDate(portName, addr, year, month, day);} else if (currentType == "查询出厂日期") {//01 03 04 00 12 07 13 19 CBint year = QString("20%1").arg(QString::number(buffer.at(4), todate)).toInt();int month = QString::number(buffer.at(5), todate).toInt();int day = QString::number(buffer.at(6), todate).toInt();info = QString("%1返回: %2年%3月%4日").arg(currentType).arg(year).arg(month).arg(day);emit receiveDateInit(portName, addr, year, month, day);}//发送对应的文字解析if (!info.isEmpty()) {emit receiveInfo(portName, addr, info);}} else if (cmd == 0x04) {} else if (cmd == 0x06) {}//重新赋值buffer.clear();}
