Appearance
Modbus 连接器使用指南
本使用指南详细介绍如何将 Modbus RTU 和 Modbus TCP 设备接入 X-Link 物联网平台，包括 产品创建、驱动部署、证书配置、设备注册 等完整流程。适用于工业设备厂商、系统集成商、开发者和物联网平台运维人员。
1. 前提条件
在开始进行 Modbus 接入前，请确保以下条件已满足：
- 具备 产品管理、X-Edge 边缘计算、证书管理 等权限
- 已完成 边缘网关激活并成功上云
- 已准备好 Modbus RTU（RS-485）或 Modbus TCP（以太网） 设备
- 清楚设备的通讯信息：
- Slave ID / Unit ID
- 波特率、校验方式（RTU）
- 设备 IP（TCP）
- 寄存器地址、功能码、数据类型、字节序
2. Modbus 设备接入流程总览
X-Link 的 Modbus 接入流程包括以下五步：
- 创建产品（定义设备模型）
- 产品配置（开启自助注册）
- 驱动部署（安装并配置 Modbus 驱动）
- 证书配置（授权设备自动上云）
- 设备自动注册（完成设备入库）
3. 创建产品（完成 Modbus 设备模型定义）
进入：产品管理 → 创建产品
在创建产品时你需要：
- 填写产品名称，例如 “Modbus 温湿度传感器”
- 选择设备分类
- 在 功能定义 中为设备添加数据点
示例：
| 名称 | 标识符 | 类型 | 单位 | 说明 |
|---|---|---|---|---|
| 温度 | temperature | float | ℃ | 对应保持寄存器 40001 |
| 电流 | current | float | A | 对应寄存器 40010–40011 |
4. 产品配置（开启设备自助注册能力）
进入：产品管理 → 产品设置
启用 “设备自助注册” 后，当网关收到设备上报数据时，平台将自动为设备创建实例，无需手动录入。
自助注册适用于：
- 大批量 Modbus 设备接入
- 设备动态上线场景
- 边缘侧自动发现设备
5. 部署 Modbus 驱动（X-Edge 边缘计算）
进入：
X-Edge 边缘计算 → 边缘实例 → 驱动管理
5.1 分配 Modbus 驱动
支持两种驱动：
- Modbus RTU 驱动（串口 RS-485）
- Modbus TCP 驱动（Ethernet）
将驱动分配到当前边缘实例。
5.2 配置驱动参数
Modbus RTU 配置示例：
- 串口：
/dev/ttyS1 - 波特率：9600
- 校验：None/Even/Odd
- 停止位：1
- Slave ID：1
Modbus TCP 配置示例：
- IP：
192.168.1.100 - 端口：502
- Unit ID：1
5.3 配置采集点位（寄存器映射）
为每个数据点配置：
- 功能码（如 03、04）
- 寄存器地址（如 40001 → 实际寄存器偏移 0）
- 数据类型（uint16，float32，int32 等）
- 字节序（大端、ABCD、DCBA 等）
- 采集周期（单位：毫秒）
完成后点击 部署驱动。
6. 证书配置（授权边缘实例与云端通讯）
进入：
X-Edge 边缘计算 → 边缘实例 → 证书管理
- 将之前创建的 产品 关联到边缘证书中
- 确保设备上报时能自动获得授权，完成平台身份认证
7. 设备自动注册（接入完成）
在设备接入成功后，当设备开始上报数据：
- 网关解析 Modbus 数据
- X-Edge 将数据上送云端
- 云端检测到新设备后自动创建设备实例
进入：
设备管理 → 设备列表
即可查看：
- 实时数据
- 历史数据
- 设备状态
- 告警与事件
至此，Modbus RTU 或 Modbus TCP 设备已成功完成接入。
8. 常见问题（FAQ）
Q1：设备未自动注册？
- 产品未开启自助注册
- 边缘实例未关联证书
- 驱动未部署或配置错误
Q2：数据读取不到或不正确？
- 功能码配置错误
- 寄存器偏移未处理（如 40001 实际为 0）
- 字节序不匹配
Q3：Modbus RTU 通讯失败？
- 波特率 / 校验 / 停止位 设置不一致
- A/B 线反接
- 485 总线终端电阻未正确处理
9. 总结
通过 X-Link 物联网平台的边缘计算与驱动系统，您可以快速完成以下能力：
- Modbus RTU / Modbus TCP 设备的零代码接入
- 自动注册设备，无需手动创建
- 灵活的数据点解析与寄存器映射
- 可靠的工业通讯与数据上云能力
本指南帮助您从产品创建到驱动部署，再到设备注册，全流程掌握 Modbus 设备接入方法，便于快速构建稳定可靠的物联网系统。