跳到主要内容

Modbus TCP 设备接入

本文说明如何将 Modbus TCP 设备接入 Aqara Studio。

前提条件​

在开始之前，请确保：

  • 您的 Modbus TCP 设备、Aqara 网关和电脑处于同一局域网中。
  • 您的 Modbus TCP 设备已完成 Modbus TCP 相关配置。如何配置，请参考产品说明书或咨询设备厂商技术支持。

添加 Modbus TCP 设备​

  1. 在左侧侧边栏点击进入设备管理页面。在左侧 协议和设备 单击 ... 按钮，选择 添加协议。

    添加协议

  2. 在弹窗中选择 Modbus TCP，以添加 Modbus TCP。

    选择 Modbus TCP

  3. （可选）在左侧 协议和设备 树选择新增的 Modbus TCP 节点，选择 协议配置 按钮，即可设置高级配置。配置完成后即可关闭此弹窗：

    单击协议配置按钮

    高级配置
    参数名称说明
    启用/禁用该设备注意：禁用后该设备将不可用。
    浮点数字节序32 位浮点数的读写顺序，支持如下：
    • Order BADC
    • Order ABCD（默认）
    • Order CDAB
    • Order DCBA
    长整型字节序64 位长整型字节顺序，支持如下：
    • Order BADC
    • Order ABCD（默认）
    • Order CDAB
    • Order DCBA

  4. 单击添加设备按钮，进入添加流程。

    单击添加设备按钮

  5. 在步骤 1 中配置目标 Modbus TCP 设备的设备配置和高级配置。完成后，单击下一步按钮。

    添加设备步骤 1

  • 设备配置：

    参数名称是否必填说明
    设备名称✔您自定义的设备名称。
    设备地址✘此设备从站地址（单位标识符），范围 0~255。
    IP 地址✔此设备的 IP 地址。
    端口✔Modbus TCP 通信端口，默认 502。
    TCP 帧模式✘支持以下值：
    • Modbus TCP
    • RTU Over TCP
    • ASCII Over TCP

  • 高级配置：

    参数名称是否必填说明
    是否启用批量写入线圈指令✔是否使用 "Force Multiple Coils" 指令写多个线圈（对应 Modbus 协议中的功能码 15）。
    是否启用批量写入寄存器指令✔是否使用 "Preset Multiple Registers" 指令写多个保持寄存器（对应 Modbus 协议中的功能码 16）。
    浮点数字节序✔32 位浮点数的读写顺序，支持如下：
    • Order BADC
    • Order ABCD（默认）
    • Order CDAB
    • Order DCBA
    长整型字节序✔64 位长整型字节顺序，支持如下：
    • Order BADC
    • Order ABCD（默认）
    • Order CDAB
    • Order DCBA
    是否覆盖网络配置✔不开启则使用 network 的字节序配置，当前字节序配置无效。
    rxProcessMode✔接收数据处理模式，支持以下值：
    • Byte
    • Packet

  1. 在步骤 2 单击 手动添加 按钮，以进入添加功能点流程。
    点击手动添加按钮

  2. 在功能点列表单击 + 按钮，以添加一个功能点。

    添加并配置点位

    添加点之后，您可以配置该点的如下类型参数：点添加、类型设置和数据映射规则。

    • 点添加：

      参数名称是否必填参数说明配置示例
      功能点名称✔您自定义的功能点名称。-
      轮询频率✘用于控制该点位的轮询频率。支持以下选项：
      • 快速：为 1 秒，高频轮询（适用于关键控制）
      • 正常：为 5 秒，常规频率
      • 慢速：为 30 秒，低频轮询（适用于非实时状态）。
      此配置主要在点位独立读取时生效；如果启用了设备级轮询，实际刷新频率可能会以设备轮询组配置为准。      		正常
      寄存器类型✔支持以下：
      • 保持寄存器
      • 输入寄存器
      • 离散线圈
      • 离散输入
      		保持寄存器
      访问类型✘支持以下：
      • 只读
      • 读写
      		读写
      寄存器地址格式✔地址格式类型，支持以下：
      • 十六进制：如 0x0013。
      • 十进制：如 19。
      • 标准 Modbus 地址：如 00001、10001、30001、40001。
      		十进制
      寄存器地址✔根据“寄存器地址格式”填写。hex 示例：000A；decimal 示例：10；modbus 示例：00001、10001、30001、40001。10
      数据类型数值型点必填数据类型 当寄存器类型为 保存寄存器 或 输入寄存器 时必填，支持以下：
      • UInt16
      • Int16
      • UInt32
      • Int32
      • Float32
      		Int16
      单位数值型点必填您可以自定义适合此功能点的单位。-
      位编号数值型点必填用于从一个 16 位保持寄存器或输入寄存器中读取指定单个位。位编号从 0 开始，范围为 0-15，0 表示最低位。-1 标识不使用该配置。-1
      起始位数值型点必填当一个 16 位寄存器中的连续几位代表一个数值或状态枚举时，填写这段数据的起始位。位编号从 0 开始，范围为 0-15，0 表示最低位。0
      位数数值型点必填当一个 16 位寄存器中的连续几位代表一个数值或状态枚举时，填写从起始位开始占用的连续位数。范围为 1-16，且起始位 + 位数不能超过 16。当前只支持从单个 16 位寄存器中取连续位段。1

    • 类型设置：

      • 当寄存器类型为 保持寄存器 或 输入寄存器 时：

        参数类型参数名称是否必填参数说明配置示例
        Aqara Spec-✔用于将此点位关联到 Aqara Spec 协议中的对应功能点，实现标准化控制与管理。空调/冷暖控制功能/设置温度
        功能取值（数值）最小值✔配置数值型功能点的取值范围的最小值。16
        最大值✔配置数值型功能点的取值范围的最大值。30
        步长✔配置数值型功能点的取值范围的步长。1
        单位✔配置数值型功能点的取值范围的单位。摄氏度（℃）
        精度✔配置数值型功能点的取值范围的精度，支持以下：
        • 整数
        • 小数点后 1 位
        • 小数点后 2 位
        • 小数点后 3 位
        		整数

      • 当寄存器类型为 离散线圈 或 离散输入 时：

        参数类型参数名称是否必填参数说明配置示例
        Aqara Spec-✔用于将此点位关联到 Aqara Spec 协议中的对应功能点，实现标准化控制与管理。门窗传感器/接触/接触状态
        功能取值（布尔）true 文本✔配置布尔型功能点取值为 true 时显示的文本。已关上
        false 文本✔配置布尔型功能点取值为 false 时显示的文本。已打开

    • 数据映射规则：开启后可对读取到的原始物理数值进行二次逻辑计算与状态映射。相关规则请阅读 数值映射函数

      • 当点的寄存器类型与 Aqara Spec 类型不一致时（如数值型需要映射为布尔型，或布尔型需要映射为数值型），请开启此选项，实现物理值与标准功能点类型之间的转换与映射。
      • 若点的寄存器类型与 Aqara Spec 类型一致，则无需开启本选项。

  3. 完成功能点添加后，返回 设备管理 页面，即可在 Modbus TCP 节点下看到新增的设备。

    选择该设备，即可在设备详情页面中的 功能点 列表中看到新增的功能点。

    设备详情

下一步​

接下来，您可以直接 查看该设备的详情和控制该设备，还可以利用该设备 编排自动化逻辑 了。