工业通信与现场总线 / 系统课时
读写线圈与保持寄存器
读写线圈与保持寄存器
Modbus 的业务变量并不是统一的一片地址空间,而是分在线圈、离散输入、输入寄存器和保持寄存器中。本节用实际 RTU 请求完成读取与写入,建立“变量类型—功能码—协议地址”的对应关系,并避开最常见的地址偏移错误。
学习目标
- 区分线圈、离散输入、输入寄存器和保持寄存器的读写属性
- 根据目标数据区选择常见读取和写入功能码
- 正确处理文档地址与 Modbus PDU 零基地址之间的偏移
先确定数据区再选择功能码
Modbus 请求中的地址本身不能说明变量类型,数据区由功能码决定。相同的协议地址 0,配合不同功能码,可以分别指向线圈 0、离散输入 0 或保持寄存器 0。
| 数据区 | 常见文档写法 | 读功能码 | 写功能码 | 单个元素宽度 |
|---|---|---|---|---|
| 线圈 | 00001 起 | 0x01 |
0x05、0x0F |
1 bit |
| 离散输入 | 10001 起 | 0x02 |
不可写 | 1 bit |
| 输入寄存器 | 30001 起 | 0x04 |
不可写 | 16 bit |
| 保持寄存器 | 40001 起 | 0x03 |
0x06、0x10 |
16 bit |
设备手册中的 40001 往往是面向人的引用编号,而 Modbus PDU 中传输的起始地址通常是 0。因此看到“保持寄存器 40010”时,不能直接把十进制 40010 填进请求;若厂商采用标准引用编号,它通常对应 PDU 地址 9。
完成读取和单点写入
下面的完整脚本通过 Modbus RTU 依次完成三件事:读取 8 个线圈、读取 2 个保持寄存器,再把线圈 0 写为 ON。串口参数和从站地址应按实际设备修改。
import serial
PORT = "/dev/ttyUSB0"
SLAVE_ID = 1
def crc16_modbus(data: bytes) -> int:
crc = 0xFFFF
for byte in data:
crc ^= byte
for _ in range(8):
crc = (crc >> 1) ^ 0xA001 if crc & 1 else crc >> 1
return crc
def frame(payload: bytes) -> bytes:
crc = crc16_modbus(payload)
return payload + bytes((crc & 0xFF, crc >> 8))
def transact(ser: serial.Serial, payload: bytes, response_size: int) -> bytes:
request = frame(payload)
ser.reset_input_buffer()
ser.write(request)
response = ser.read(response_size)
if len(response) != response_size:
raise TimeoutError(f"expected {response_size} bytes, got {len(response)}")
if crc16_modbus(response[:-2]) != int.from_bytes(response[-2:], "little"):
raise ValueError("CRC check failed")
return response
with serial.Serial(PORT, 9600, parity=serial.PARITY_EVEN, timeout=1.0) as ser:
# 0x01:从协议地址 0 开始读取 8 个线圈。
coils = transact(ser, bytes((SLAVE_ID, 0x01, 0x00, 0x00, 0x00, 0x08)), 6)
coil_bits = coils[3]
# 0x03:从协议地址 0 开始读取两个 16 位保持寄存器。
regs = transact(ser, bytes((SLAVE_ID, 0x03, 0x00, 0x00, 0x00, 0x02)), 9)
reg0 = int.from_bytes(regs[3:5], "big")
reg1 = int.from_bytes(regs[5:7], "big")
# 0x05 写单线圈,FF00 表示 ON,0000 表示 OFF。
write_reply = transact(ser, bytes((SLAVE_ID, 0x05, 0x00, 0x00, 0xFF, 0x00)), 8)
print(f"coils[0..7]=0b{coil_bits:08b}")
print(f"holding[0]={reg0}, holding[1]={reg1}")
print("write coil 0: ok" if write_reply[1] == 0x05 else "write failed")假设线圈返回字节为 0x05,两个保持寄存器当前值分别为 100 和 250,则预期输出为:
coils[0..7]=0b00000101
holding[0]=100, holding[1]=250
write coil 0: ok现场设备的数据值可能不同。线圈响应按低位优先打包,因此 0x05 表示第 0、2 个线圈为 1,其余为 0。
理解单点与多点写入
写单线圈使用 0x05,一次改变一个 bit;写多个连续线圈使用 0x0F。写单保持寄存器使用 0x06,写多个连续保持寄存器使用 0x10。多点写入可以减少往返次数,也能把一组连续变量放在同一条请求中。
离散输入和输入寄存器通常代表设备采集值或只读状态,因此标准功能码只提供读取操作。若业务需要修改某个参数,应先确认它实际位于保持寄存器,而不是看到“寄存器”三个字就直接使用写功能码。
把业务变量映射到协议地址
工程中不要让业务代码到处散落裸地址。更可靠的做法是维护一份变量映射,例如“启动命令 → coil 0”“运行状态 → discrete input 3”“目标转速 → holding register 10”“实际温度 → input register 5”。
映射表至少应记录数据区、协议起始地址、数据长度、读写属性和工程单位。对于 32 位整数或浮点数,还要额外确认两个 16 位寄存器的字顺序;Modbus 规定了单个寄存器内部的字节顺序,却没有统一规定多个寄存器组合成 32 位数据时的字顺序。
验证写入是否真正生效
收到正常写响应只能证明从站接受了请求,不一定证明现场对象已经达到目标状态。例如写入“电机启动”线圈后,设备还可能因为急停或联锁条件保持停止。
因此写入后应再次读取对应命令寄存器,并结合运行状态、故障状态等反馈变量验证业务结果。遇到异常响应时,还应检查响应功能码最高位是否置 1;例如请求 0x03 后收到 0x83,表示设备返回了 Modbus 异常码,而不是普通寄存器数据。
只要先锁定数据区,再选择功能码,并把设备手册中的地址转换成明确的 PDU 地址,线圈与寄存器读写就能从“试地址”变成可检查、可复用的业务映射。