EMS本地局域网API文档 - AECC-深圳能控云科技有限公司官网

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)

本地局域网API

EMS能源管理系统