工业通信与现场总线 / 系统课时

读写线圈与保持寄存器

读写线圈与保持寄存器

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。串口参数和从站地址应按实际设备修改。

python
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,则预期输出为:

text
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 地址,线圈与寄存器读写就能从“试地址”变成可检查、可复用的业务映射。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

读写线圈与保持寄存器

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通