Modbus TCP 设备接入
本文说明如何将 Modbus TCP 设备接入 Aqara Studio。
前提条件
在开始之前，请确保：
- 您的 Modbus TCP 设备、Aqara 网关和电脑处于同一局域网中。
- 您的 Modbus TCP 设备已完成 Modbus TCP 相关配置。如何配置，请参考产品说明书或咨询设备厂商技术支持。
添加 Modbus TCP 设备
- 在左侧侧边栏点击进入设备管理页面。
- 在左侧设备树单击“+”按钮，在弹窗中选择
Modbus TCP，以添加Modbus TCP。 - 单击 Modbus TCP，切换至 添加设备 选项卡，填写并保存如下参数：
-
设备配置：
参数名称 是否必填 说明 设备名称 ✔ 您自定义的设备名称。 设备地址 ✘ 此设备从站地址（单位标识符），范围 0~255。 IP地址 ✔ 此设备的 IP 地址。 端口 ✔ Modbus TCP 通信端口，默认 502。 -
高级配置：
参数 说明 Ping地址 地址格式 用于检测此 Modbus 设备正常工作的保持寄存器地址，支持以下格式： - 十六进制
- 十进制
- 标准 Modbus 地址
地址 实际的保持寄存器地址数值。 接收处理模式 接收数据处理模式，支持以下值： - Byte：字节流模式。
- Packet：报文模式。
是否启用批量写入线圈指令 是否使用 "Force Multiple Coils" 指令写多个线圈（对应 Modbus 协议中的功能码 15）。 是否启用批量写入寄存器指令 是否使用 "Preset Multiple Registers" 指令写多个保持寄存器（对应 Modbus 协议中的功能码 16）。 浮点数字节序 32 位浮点数的读写顺序，仅支持 Order1032与Order3210。长整型字节序 64 位长整型字节顺序，仅支持 Order1032与Order3210。输入寄存器偏移地址 地址格式 输入寄存器（对应 Modbus 协议中的功能码 04：Read Input Registers）偏移地址的格式，支持选项如下： - 十六进制
- 十进制
- 标准Modbus地址
地址 偏移地址。 保持寄存器偏移地址 地址格式 保持寄存器（对应 Modbus 协议中的功能码 03：Read Holding Registers）偏移地址的格式，支持格式与"输入寄存器偏移地址"相同。 地址 偏移地址。 线圈状态偏移地址 地址格式 线圈状态（对应 Modbus 协议中的功能码 01：Read Coils）偏移地址的格式，支持格式与"输入寄存器偏移地址"相同。 地址 偏移地址。 离散输入偏移地址 地址格式 离散输入（对应 Modbus 协议中的功能码 02：Discrete Inputs）偏移地址的格式，支持格式与"输入寄存器偏移地址"相同。 地址 偏移地址。 启用/禁用该设备 注意：禁用后该设备将不可用。
-
在“配置功能点”页面，在
类型选择区域单击 +，以添加一个功能点。 -
单击该点，即可设置其类型和点位配置。完成后，单击完成添加。
参数名称 是否必填 参数说明 配置示例 功能点名称 ✔ 您自定义的功能点名称。 - Object Type ✘ 无需修改，使用默认值即可。 状态类型 布尔型点必填 支持以下：
- 线圈
- 输入
线圈 寄存器类型 数值型点必填 支持以下：
- 保持
- 输入
保持 数据类型 数值型点必填 当点位为数值型时选择，支持以下：
- 整数类型
- 长整型
- 浮点类型
- 有符号整数
- 无符号长整型
整数类型 轮询频率 ✘ 支持以下选项：
- 快速：高频轮询（适用于关键控制）
- 正常：常规频率
- 慢速：低频轮询（适用于非实时状态）
正常 地址格式 ✔ 地址格式类型，支持以下：
- 十六进制：如 0x0013。
- 十进制：如 19。
- 标准Modbus地址：如 00001、10001。
十进制 地址 ✔ 传入的值 = 实际地址 - 您上文设置的偏移地址
0 设备类型 ✔ 用于将此点位关联到 Aqara Spec 协议中的对应功能点，实现标准化控制与管理。 -
什么是偏移地址？
在 Modbus 协议中，设备中的数据（如寄存器、线圈）都有一个编号地址，用来读取或写入。
但由于 Modbus 报文中使用的是从 0 开始的内部地址，而用户看到的地址通常是从 1、30001、40001 等逻辑地址开始的，所以 Aqara Studio 需要一个“偏移地址”来进行自动转换。
例如，某个功能点的真实地址是 40001（保持寄存器）。如果你在设置 Modbus TCP 设备时将“保持寄存器偏移地址”设置为 40000，那么，在为这个设备添加点时，你只需要填写数据地址为 1，Aqara Studio 就会自动加上偏移量，计算为：
最终读取地址 = 偏移地址 + 数据地址 = 40000 + 1 = 40001
这使得用户在配置多个点位时，只需填写相对地址（如 1、2、3），无需每次都写完整 Modbus 地址，既方便又统一。
下一步
接下来，您可以直接 查看该设备的详情和控制该设备，还可以利用该设备 编排自动化逻辑 了。