Modbus 透传接入

平台支持通过网关透传接入 Modbus 设备，提供两种协议：

• Modbus RTU 透传：网关通过 RS485/RS232 串口连接 Modbus RTU 从机设备。
• Modbus TCP 透传：网关通过以太网连接 Modbus TCP 从机设备。

拓扑结构

Modbus 透传采用「网关 + 子设备」两级结构：

1. 创建一个网关设备类型（接入类型 = 网关设备，接入协议 = Modbus RTU 透传或 Modbus TCP 透传），网关自身连接平台。
2. 创建子设备类型（接入类型 = 子设备，接入协议与网关一致），用于描述从机设备的功能定义。
3. 从机设备作为子设备挂在网关下，平台按「网关设备码 + 子设备地址」寻址每台从机。

子设备的添加方式请浏览 网关 MQTT 接入。

Modbus 寄存器设置

当设备类型的接入协议选择 Modbus 透传时，类型详情中会出现「Modbus配置」页签，用于设置 Modbus 寄存器地址，实现设备属性与 Modbus 消息之间的自动转换：

自定义数据流

Modbus 报文通过 Modbus RTU 格式的自定义数据流在网关与平台之间传输，需先在该类型上创建自定义数据流并在此处选择，见 自定义数据流。

IO 寄存器

IO 寄存器包括线圈、离散寄存器，可以和开关量（Boolean）属性绑定，仅支持属性类型为「设备上报」和「设备云端共享」的属性。

每个绑定项配置：属性、从机地址、寄存器地址、读写类型。

数据寄存器

数据寄存器包括输入寄存器、保持寄存器，可以和数值型（Number）属性绑定，同样仅支持「设备上报」和「设备云端共享」属性。

每个绑定项配置：

配置项	说明
属性	绑定的物模型属性
从机地址	Modbus 从站地址
寄存器地址	寄存器起始地址，支持 10 进制或 16 进制显示
读写类型	读 / 读写
数据类型	如 int16、uint16、int32 等
字节序	多字节数据的字节顺序（如 AB、BA）
系数 / 偏移	原始寄存器值与属性值之间的换算：属性值 = 原始值 × 系数 + 偏移

配置寄存器映射时请对照从机设备的点表文档，确认寄存器地址范围与数据长度一致。开启「寄存器地址显示 16 进制」可按点表习惯的 16 进制方式查看地址。

使用建议

• 属性值换算依赖系数与偏移配置，配置后通过"属性采集"或真实设备上报验证数值是否正确。
• 合理设置采集周期，避免过密轮询造成网关与从机通信繁忙。
• 从机无响应时网关会返回超时，设备返回码以命令回复中的 code 为准。
• Modbus 子设备的上下线依赖网关代报，网关离线时其下子设备同时离线。