| name | modbus-debug |
| description | 当需要调试 Modbus RTU(串口)或 Modbus TCP(网络)设备通信时使用,支持寄存器读写、从站扫描和持续监控。 |
Modbus 调试
适用场景
- 嵌入式设备实现了 Modbus RTU/TCP 从站,需要验证通信是否正常。
- 需要读写保持寄存器、输入寄存器、线圈或离散输入。
- 需要扫描总线上的从站地址,确认设备是否在线。
- 需要持续监控寄存器值的变化。
必要输入
- RTU 模式:串口号(如 COM42)、波特率、从站地址。
- TCP 模式:主机 IP 和端口、从站地址。
- 操作类型:读/写/扫描/监控。
依赖
pymodbus(pip install pymodbus)
pyserial(RTU 模式需要)
执行步骤
- 先阅读 references/usage.md,确认操作参数。
- 探测环境:
python scripts/modbus_tool.py --detect
- 根据需求执行对应操作:
python scripts/modbus_tool.py --port COM42 --slave 1 --read --address 0 --count 10
python scripts/modbus_tool.py --port COM42 --slave 1 --write --address 0 --values 100,200
python scripts/modbus_tool.py --port COM42 --scan --scan-range 1-10
python scripts/modbus_tool.py --tcp --host 192.168.1.100 --slave 1 --read --address 0 --count 10
失败分流
connection-failure:串口无法打开、网络不通。
slave-no-response:从站地址无响应。
illegal-function:设备不支持该功能码。
illegal-address:寄存器地址越界。
输出约定
示例输出格式:
结果: ✅ 读取 10 个寄存器
连接: RTU COM42 9600 8N1
从站: 1
地址 | 十进制 | 十六进制 | 二进制
------+---------+----------+--------------------
0 | 100 | 0x0064 | 0000000001100100
1 | 200 | 0x00c8 | 0000000011001000
交接关系
- 从
build-keil / build-platformio 烧录固件后,用此 skill 验证 Modbus 通信。
- 与
serial-monitor 互补:serial-monitor 查看串口原始输出,modbus-debug 进行协议级调试。