Skip to main content

平台接入

本文档介绍设备接入能耗平台的完整流程，包括 HTTP API 接口调用和平台配置。

tip
  • 如果你是开发者，需要调用 API 接口，请查看 API 接口文档
  • 如果你是普通用户，进行设备配置，请继续阅读本页面

接入流程​

设备接入能耗平台的完整流程：

设备准备 → 网络配置 → 平台注册 → 数据配置 → 验证测试

设备准备​

支持的设备类型​

  • MBGW 系列网关
  • EDGE 系列边缘网关
  • 第三方 Modbus 设备

设备检查​

  1. 确认设备供电正常
  2. 检查网络接口连接
  3. 确认设备地址（设备 ID）

网络配置​

有线网络（Ethernet）​

  1. 连接网线到设备
  2. 配置设备 IP 地址（DHCP 或静态 IP）
  3. 确保设备与平台网络连通

无线网络（4G/NB-IoT）​

  1. 安装 SIM 卡
  2. 配置 APN 参数
  3. 等待网络信号连接

平台注册​

添加设备​

方式一：通过 API 接口注册（开发者）

调用 /Device_Register 接口进行设备注册：

POSTMAN 设置

接口地址: http://iot.datacom.vip:11111/Device_Register

请求方式: POST

Headers:

KeyValue
Content-Typeapplication/json
AuthorizationBearer <your_token>

Body (raw JSON):

{
  "BuildID": "1234567890",
  "Code": "DEVICE001",
  "Name": "1 号电表",
  "Type": 1
}

详细说明请查看 API 接口文档 - 设备注册

方式二：通过平台管理后台（普通用户）

  1. 登录平台管理后台
  2. 进入"设备管理"菜单
  3. 点击"添加设备"按钮
  4. 填写设备信息：
    • 设备名称
    • 设备类型
    • 设备地址/MAC 地址
    • 通信参数

配置通信参数​

参数项说明示例
通信协议设备使用的协议Modbus TCP
端口号通信端口502
采集间隔数据采集周期60 秒
超时时间通信超时设置10 秒

数据配置​

配置监测点​

方式一：通过 API 接口上传数据（开发者）

调用 /Update_Data 接口上传设备数据：

POSTMAN 设置

接口地址: http://iot.datacom.vip:11111/Update_Data

请求方式: POST

Headers:

KeyValue
Content-Typeapplication/json
AuthorizationBearer <your_token>

Body (raw JSON):

{
  "BuildID": "1234567890",
  "DateTime": "2025-03-17 10:30:00",
  "Data": [
    {
      "MeterID": "MTR123456",
      "VA": 220.5,
      "VB": 221.0,
      "VC": 219.8,
      "Ia": 10.2,
      "Ib": 10.5,
      "Ic": 10.3,
      "SumValue": 1234.56,
      "Type": 1,
      "isOnline": 1
    }
  ]
}

详细说明请查看 API 接口文档 - 数据上传

方式二：通过平台管理后台（普通用户）

  1. 选择设备进入详情
  2. 点击"配置监测点"
  3. 添加需要采集的数据项：
    • RTU 总线编号（Modbus RTU 模式）
    • 从站地址（Modbus RTU 模式）
    • 波特率校验方式（Modbus RTU 模式）
    • IP 地址（Modbus TCP 模式）
    • 端口号（Modbus TCP 模式）
    • 寄存器地址
    • 寄存器长度
    • 数据类型

常用数据项​

数据项寄存器地址类型单位
A 相电压0x0000FloatV
B 相电压0x0001FloatV
C 相电压0x0002FloatV
A 相电流0x0010FloatA
B 相电流0x0011FloatA
C 相电流0x0012FloatA
正向有功电能0x0020FloatkWh

验证测试​

数据验证​

  1. 查看实时数据是否更新
  2. 对比设备显示值与平台显示值
  3. 确认数据准确性

告警测试​

  1. 配置告警阈值
  2. 触发告警条件
  3. 确认告警通知正常

常见问题​

设备无法连接​

  • 检查网络连接
  • 确认 IP 地址和端口配置
  • 检查防火墙设置

数据不更新​

  • 检查设备通信状态
  • 确认采集间隔配置
  • 查看设备日志

数据不准确​

  • 核对寄存器地址
  • 检查数据类型配置
  • 确认量程范围设置