modbus-debug

Original：🇨🇳 Chinese

Translated

1 scriptsChecked / no sensitive code detected

Used for debugging communication of Modbus RTU (serial port) or Modbus TCP (network) devices, supporting register read/write, slave scanning, and continuous monitoring.

4installs

Sourceleokemp223/embed-ai-tool

Added on2026-05-16

NPX Install

npx skill4agent add leokemp223/embed-ai-tool modbus-debug

SKILL.md Content (Chinese)

View Translation Comparison →

Modbus Debugging

Application Scenarios

The embedded device implements Modbus RTU/TCP slave, and needs to verify whether the communication is normal.
Need to read/write holding registers, input registers, coils or discrete inputs.
Need to scan slave addresses on the bus to confirm whether the device is online.
Need to continuously monitor changes in register values.

Required Inputs

RTU mode: serial port number (e.g. COM42), baud rate, slave address.
TCP mode: host IP and port, slave address.
Operation type: read/write/scan/monitor.

Dependencies

```
pymodbus
```
(pip install pymodbus)
```
pyserial
```
(required for RTU mode)

Execution Steps

First read references/usage.md to confirm the operation parameters.
Detect the environment:
bash
```
python scripts/modbus_tool.py --detect
```

Execute the corresponding operation according to requirements:

bash

# Read holding registers
python scripts/modbus_tool.py --port COM42 --slave 1 --read --address 0 --count 10

# Write registers
python scripts/modbus_tool.py --port COM42 --slave 1 --write --address 0 --values 100,200

# Scan slaves
python scripts/modbus_tool.py --port COM42 --scan --scan-range 1-10

# TCP read
python scripts/modbus_tool.py --tcp --host 192.168.1.100 --slave 1 --read --address 0 --count 10

Failure Branches

```
connection-failure
```
: Serial port cannot be opened, network is unreachable.
```
slave-no-response
```
: No response from slave address.
```
illegal-function
```
: The device does not support this function code.
```
illegal-address
```
: Register address is out of bounds.

Output Convention

Example output format:

Result: ✅ Read 10 registers
  Connection: RTU COM42 9600 8N1
  Slave: 1

    Address |  Decimal |  Hexadecimal |             Binary
  ------+---------+----------+--------------------
       0 |     100 | 0x0064   | 0000000001100100
       1 |     200 | 0x00c8   | 0000000011001000

Handover Relationships

After burning firmware with
```
build-keil
```
/
```
build-platformio
```
, use this skill to verify Modbus communication.
Complementary to
```
serial-monitor
```
: serial-monitor views raw serial port output, modbus-debug performs protocol-level debugging.