本地局域网API

EMS能源管理系统

本文档介绍 EMS 能源管理系统的本地局域网（LAN）API 通信协议，涵盖采集器、储能机、逆变器等设备的 Modbus RTU/TCP 通信协议，包括寄存器地址、功能码和命令示例。

1. 采集器 (Data logger)
1.1. 通信配置
协议类型: Modbus RTU/TCP
通信地址: 192.168.1.100:502
设备地址: 0x01-0xF7
波特率: 9600/19200/38400
1.2. 设备参数查询命令
字段 字段名 类型 说明
功能码 Function Code uint8 0x03 (读保持寄存器)
起始地址 Start Address uint16 0x0000-0xFFFF
寄存器数量 Register Count uint16 1-125
1.3. 命令实例 
查询设备参数 (地址0x01, 起始地址0x0000, 读取10个寄存器)
请求: 01 03 00 00 00 0A C5 CD
响应: 01 03 14 00 64 00 C8 01 F4 02 58 00 00 00 00 00 00 00 00 00 00 XX XX
1.4. 设备参数应答说明
字段 字段名 类型 说明
设备地址 Device Address uint8 0x01
功能码 Function Code uint8 0x03
数据长度 Data Length uint8 字节数
寄存器数据 Register Data uint16[] 参数值数组
2. 储能机 (Energy Storage System)
2.1. 通信配置
协议类型: Modbus TCP
通信地址: 192.168.1.101:502
设备地址: 0x01
数据格式: 大端序 (Big-Endian)
2.2. 设备参数查询命令
字段 字段名 类型 说明
功能码 Function Code uint8 0x03
起始地址 Start Address uint16 0x1000 (SOC), 0x1001 (功率)
寄存器数量 Register Count uint16 2-20
2.3. 命令实例 
查询SOC和功率 (地址0x01, 起始地址0x1000, 读取2个寄存器)
请求: 01 03 10 00 00 02 C4 0B
响应: 01 03 04 01 2C 0F A0 XX XX
      (SOC=30%, 功率=4000W)
2.4. 设备参数应答说明
字段 字段名 类型 说明
SOC State of Charge uint16 0-100 (百分比)
功率 Power int16 单位: W (正数充电, 负数放电)
电压 Voltage uint16 单位: V (0.1V精度)
电流 Current int16 单位: A (0.1A精度)
3. 逆变器 (Inverter)
3.1. 通信配置
协议类型: Modbus RTU
通信地址: 192.168.1.102:502
设备地址: 0x01-0x0F
波特率: 9600, 8N1
3.2. 设备参数查询命令
字段 字段名 类型 说明
功能码 Function Code uint8 0x03
起始地址 Start Address uint16 0x2000 (AC电压), 0x2001 (AC电流)
寄存器数量 Register Count uint16 1-10
3.3. 命令实例 
查询AC电压和电流 (地址0x01, 起始地址0x2000, 读取2个寄存器)
请求: 01 03 20 00 00 02 85 C0
响应: 01 03 04 0B B8 01 F4 XX XX
      (AC电压=3000V, AC电流=500A)
3.4. 设备参数应答说明
字段 字段名 类型 说明
AC电压 AC Voltage uint16 单位: V (0.1V精度)
AC电流 AC Current uint16 单位: A (0.1A精度)
频率 Frequency uint16 单位: Hz (0.01Hz精度)
功率 Power int16 单位: W
4. 电池 (Battery)
4.1. 通信配置
协议类型: Modbus RTU
通信地址: 192.168.1.103:502
设备地址: 0x01
波特率: 9600
4.2. 设备参数查询命令
字段 字段名 类型 说明
功能码 Function Code uint8 0x03
起始地址 Start Address uint16 0x3000 (电压), 0x3001 (电流)
寄存器数量 Register Count uint16 1-8
4.3. 命令实例 
查询电池电压和电流 (地址0x01, 起始地址0x3000, 读取2个寄存器)
请求: 01 03 30 00 00 02 C4 0B
响应: 01 03 04 0F A0 00 C8 XX XX
      (电压=4000V, 电流=200A)
4.4. 设备参数应答说明
字段 字段名 类型 说明
电压 Voltage uint16 单位: V (0.1V精度)
电流 Current int16 单位: A (0.1A精度, 正数充电)
温度 Temperature int16 单位: ℃ (0.1℃精度)
容量 Capacity uint16 单位: Ah
5. 插座 (Smart Plug)
5.1. 通信配置
协议类型: HTTP REST API
通信地址: http://192.168.1.104:80
认证方式: API Key
5.2. 设备参数查询命令
字段 字段名 类型 说明
方法 Method string GET
路径 Path string /api/v1/status
Header Authorization string Bearer {API_KEY}
5.3. 命令实例 
GET /api/v1/status HTTP/1.1
Host: 192.168.1.104
Authorization: Bearer abc123xyz

响应:
{
  "status": "on",
  "power": 1250.5,
  "voltage": 220.0,
  "current": 5.68,
  "energy": 1234.56
}
5.4. 设备参数应答说明
字段 字段名 类型 说明
status 开关状态 string "on" 或 "off"
power 功率 float 单位: W
voltage 电压 float 单位: V
current 电流 float 单位: A
energy 累计电量 float 单位: kWh
6. 热泵 (Heat Pump)
6.1. 通信配置
协议类型: Modbus TCP
通信地址: 192.168.1.105:502
设备地址: 0x01
超时时间: 3000ms
6.2. 设备参数查询命令
字段 字段名 类型 说明
功能码 Function Code uint8 0x03
起始地址 Start Address uint16 0x4000 (温度), 0x4001 (功率)
寄存器数量 Register Count uint16 1-15
6.3. 命令实例 
查询温度和功率 (地址0x01, 起始地址0x4000, 读取2个寄存器)
请求: 01 03 40 00 00 02 85 C0
响应: 01 03 04 01 90 07 D0 XX XX
      (温度=40.0℃, 功率=2000W)
6.4. 设备参数应答说明
字段 字段名 类型 说明
温度 Temperature int16 单位: ℃ (0.1℃精度)
功率 Power uint16 单位: W
运行模式 Mode uint8 0=待机, 1=制热, 2=制冷
能效比 COP uint16 0.01 精度 (如300表示3.00)
7. 继电器 (Relay)
7.1. 通信配置
协议类型: Modbus RTU
通信地址: 192.168.1.106:502
设备地址: 0x01-0x10
波特率: 9600, 8N1
7.2. 设备参数查询命令
字段 字段名 类型 说明
功能码 Function Code uint8 0x01 (读线圈状态)
起始地址 Start Address uint16 0x0000-0xFFFF
线圈数量 Coil Count uint16 1-2000
7.3. 命令实例 
查询继电器状态 (地址0x01, 起始地址0x0000, 读取8个线圈)
请求: 01 01 00 00 00 08 3D CA
响应: 01 01 01 55 XX XX
      (8个继电器状态: 01010101 = 0x55)
7.4. 设备参数应答说明
字段 字段名 类型 说明
设备地址 Device Address uint8 0x01-0x10
功能码 Function Code uint8 0x01
字节数 Byte Count uint8 数据字节数
线圈状态 Coil Status uint8[] 每个位代表一个继电器 (0=OFF, 1=ON)
👉 联系我们获得完整文档或支持 👈
联系我们