EMS Local Network API - AECC-SHENZHEN ENERGY CONTROL CLOUD TECHNOLOGY CO., LTD.

1. Data Logger

1.1. Communication Configuration

Protocol Type: Modbus RTU/TCP
Communication Address: 192.168.1.100:502
Device Address: 0x01-0xF7
Baud Rate: 9600/19200/38400

1.2. Device Parameter Query Command

Field	Field Name	Type	Description
Function Code	Function Code	uint8	0x03 (Read Holding Registers)
Start Address	Start Address	uint16	0x0000-0xFFFF
Register Count	Register Count	uint16	1-125

1.3. Command Example

Query device parameters (Address 0x01, Start Address 0x0000, Read 10 registers)
Request: 01 03 00 00 00 0A C5 CD
Response: 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 Parameter Response Description

Field	Field Name	Type	Description
Device Address	Device Address	uint8	0x01
Function Code	Function Code	uint8	0x03
Data Length	Data Length	uint8	Byte count
Register Data	Register Data	uint16[]	Parameter value array

2. Energy Storage System

2.1. Communication Configuration

Protocol Type: Modbus TCP
Communication Address: 192.168.1.101:502
Device Address: 0x01
Data Format: Big-Endian

2.2. Device Parameter Query Command

Field	Field Name	Type	Description
Function Code	Function Code	uint8	0x03
Start Address	Start Address	uint16	0x1000 (SOC), 0x1001 (Power)
Register Count	Register Count	uint16	2-20

2.3. Command Example

Query SOC and Power (Address 0x01, Start Address 0x1000, Read 2 registers)
Request: 01 03 10 00 00 02 C4 0B
Response: 01 03 04 01 2C 0F A0 XX XX
      (SOC=30%, Power=4000W)

2.4. Device Parameter Response Description

Field	Field Name	Type	Description
SOC	State of Charge	uint16	0-100 (Percentage)
Power	Power	int16	Unit: W (Positive=Charging, Negative=Discharging)
Voltage	Voltage	uint16	Unit: V (0.1V precision)
Current	Current	int16	Unit: A (0.1A precision)

3. Inverter

3.1. Communication Configuration

Protocol Type: Modbus RTU
Communication Address: 192.168.1.102:502
Device Address: 0x01-0x0F
Baud Rate: 9600, 8N1

3.2. Device Parameter Query Command

Field	Field Name	Type	Description
Function Code	Function Code	uint8	0x03
Start Address	Start Address	uint16	0x2000 (AC Voltage), 0x2001 (AC Current)
Register Count	Register Count	uint16	1-10

3.3. Command Example

Query AC Voltage and Current (Address 0x01, Start Address 0x2000, Read 2 registers)
Request: 01 03 20 00 00 02 85 C0
Response: 01 03 04 0B B8 01 F4 XX XX
      (AC Voltage=3000V, AC Current=500A)

3.4. Device Parameter Response Description

Field	Field Name	Type	Description
AC Voltage	AC Voltage	uint16	Unit: V (0.1V precision)
AC Current	AC Current	uint16	Unit: A (0.1A precision)
Frequency	Frequency	uint16	Unit: Hz (0.01Hz precision)
Power	Power	int16	Unit: W

4. Battery

4.1. Communication Configuration

Protocol Type: Modbus RTU
Communication Address: 192.168.1.103:502
Device Address: 0x01
Baud Rate: 9600

4.2. Device Parameter Query Command

Field	Field Name	Type	Description
Function Code	Function Code	uint8	0x03
Start Address	Start Address	uint16	0x3000 (Voltage), 0x3001 (Current)
Register Count	Register Count	uint16	1-8

4.3. Command Example

Query Battery Voltage and Current (Address 0x01, Start Address 0x3000, Read 2 registers)
Request: 01 03 30 00 00 02 C4 0B
Response: 01 03 04 0F A0 00 C8 XX XX
      (Voltage=4000V, Current=200A)

4.4. Device Parameter Response Description

Field	Field Name	Type	Description
Voltage	Voltage	uint16	Unit: V (0.1V precision)
Current	Current	int16	Unit: A (0.1A precision, Positive=Charging)
Temperature	Temperature	int16	Unit: ℃ (0.1℃ precision)
Capacity	Capacity	uint16	Unit: Ah

5. Smart Plug

5.1. Communication Configuration

Protocol Type: HTTP REST API
Communication Address: http://192.168.1.104:80
Authentication: API Key

5.2. Device Parameter Query Command

Field	Field Name	Type	Description
Method	Method	string	GET
Path	Path	string	/api/v1/status
Header	Authorization	string	Bearer {API_KEY}

5.3. Command Example

GET /api/v1/status HTTP/1.1
Host: 192.168.1.104
Authorization: Bearer abc123xyz

Response:
{
  "status": "on",
  "power": 1250.5,
  "voltage": 220.0,
  "current": 5.68,
  "energy": 1234.56
}

5.4. Device Parameter Response Description

Field	Field Name	Type	Description
status	Switch Status	string	"on" or "off"
power	Power	float	Unit: W
voltage	Voltage	float	Unit: V
current	Current	float	Unit: A
energy	Accumulated Energy	float	Unit: kWh

6. Heat Pump

6.1. Communication Configuration

Protocol Type: Modbus TCP
Communication Address: 192.168.1.105:502
Device Address: 0x01
Timeout: 3000ms

6.2. Device Parameter Query Command

Field	Field Name	Type	Description
Function Code	Function Code	uint8	0x03
Start Address	Start Address	uint16	0x4000 (Temperature), 0x4001 (Power)
Register Count	Register Count	uint16	1-15

6.3. Command Example

Query Temperature and Power (Address 0x01, Start Address 0x4000, Read 2 registers)
Request: 01 03 40 00 00 02 85 C0
Response: 01 03 04 01 90 07 D0 XX XX
      (Temperature=40.0℃, Power=2000W)

6.4. Device Parameter Response Description

Field	Field Name	Type	Description
Temperature	Temperature	int16	Unit: ℃ (0.1℃ precision)
Power	Power	uint16	Unit: W
Operating Mode	Mode	uint8	0=Standby, 1=Heating, 2=Cooling
COP	COP	uint16	0.01 precision (e.g., 300 represents 3.00)

7. Relay

7.1. Communication Configuration

Protocol Type: Modbus RTU
Communication Address: 192.168.1.106:502
Device Address: 0x01-0x10
Baud Rate: 9600, 8N1

7.2. Device Parameter Query Command

Field	Field Name	Type	Description
Function Code	Function Code	uint8	0x01 (Read Coil Status)
Start Address	Start Address	uint16	0x0000-0xFFFF
Coil Count	Coil Count	uint16	1-2000

7.3. Command Example

Query Relay Status (Address 0x01, Start Address 0x0000, Read 8 coils)
Request: 01 01 00 00 00 08 3D CA
Response: 01 01 01 55 XX XX
      (8 relay status: 01010101 = 0x55)

7.4. Device Parameter Response Description

Field	Field Name	Type	Description
Device Address	Device Address	uint8	0x01-0x10
Function Code	Function Code	uint8	0x01
Byte Count	Byte Count	uint8	Data byte count
Coil Status	Coil Status	uint8[]	Each bit represents a relay (0=OFF, 1=ON)

Local Network API

EMS Energy Management System