1.1 EMS 本地通讯 IP 获取方式

EMS 设备在局域网内通过 mDNS 服务发现暴露自身信息，App 可以无需手动配置 IP 即可发现并连接设备。

1.1.1 通信配置

1.1.2 mDNS 参数说明

Service Type: _http._tcp
Name: SXD-mDNS-IF-NKYWLTS011
Domain: local
Port: 8080
Address: SXD-mDNS.local
TXT Records:
  s_sn=NKYWLTS011
  s_ip=192.168.3.206
  s_port=8080
  s_type=xxx

1.2 设备参数查询命令

请求示例：

{
  "Get": "EnergyParameter",
  "SerialNumber": 1,
  "CommandSource": "Web"
}

1.3 设备参数应答命令说明

应答包含三大部分：顶层字段、功率参数汇总（SSumInfoList）以及子设备列表（储能机 / 逆变器 / 插座 / 充电桩）。

1.3.1 顶层字段

1.3.2 SSumInfoList 字段

1.3.3 子设备列表字段

1.4 设备参数应答命令实例

响应示例：

{
  "Response": "EnergyParameter",
  "SerialNumber": 1,
  "Target": "Web",
  "SSumInfoList": [{
    "MeterTotalActivePower": 0,
    "TotalPVPower": 0,
    "TotalPVChargePower": 0,
    "TotalACChargePower": 0,
    "TotalSmartLoadElectricalPower": 0,
    "AverageBatteryAverageSOC": 20,
    "TotalBatteryOutputPower": 40,
    "TotalGridOutputPower": 0,
    "TotalBackUpPower": 0,
    "TotalChargePower": 0
  }],
  "ControlEnableStatus": 0,
  "Storage_list": [{
    "DevAddr": 1,
    "StorageSN": "ZL-2502250374-00039",
    "StorageStatus": 1,
    "PvChargingPower": 0,
    "AcChargingPower": 0,
    "BatterySoc": 100,
    "BatteryDischargingPower": 50,
    "AcInActivePower": -350,
    "OffGridLoadPower": 0,
    "BatteryChargingPower": 0,
    "PvStringCount": 0,
    "Pv1Power": 0,
    "Pv2Power": 0,
    "Pv3Power": 0,
    "Pv4Power": 0
  }, {
    "DevAddr": 2,
    "StorageSN": "ZL-2411080327-00039",
    "StorageStatus": 1,
    "PvChargingPower": 0,
    "AcChargingPower": 0,
    "BatterySoc": 20,
    "BatteryDischargingPower": 40,
    "AcInActivePower": 0,
    "OffGridLoadPower": 0,
    "BatteryChargingPower": 0,
    "PvStringCount": 0,
    "Pv1Power": 0,
    "Pv2Power": 0,
    "Pv3Power": 0,
    "Pv4Power": 0
  }]
}

2.1 通信配置

2.2 能源控制参数说明

功率控制时段格式说明

[时间段使能],[起始时间],[结束时间],[强制取/馈电功率限制],[允许取电功率限制],[功率控制模式],[充电最大SOC],[放电最小SOC]

"1,09:00,23:59,1000,500,0,100,10"

2.3 能源控制参数命令说明

通用字段

2.4 能源控制参数查询命令实例

查询请求示例：

{
  "Get": "Energycontrolparameters",
  "SerialNumber": 1,
  "CommandSource": "Web",
  "RegControlField": [
    "EnergyManagement",
    "PowerControlPeriod1",
    "PowerControlPeriod2",
    "PowerControlPeriod3",
    "PowerControlPeriod4"
  ]
}

2.5 能源控制参数查询命令应答实例

{
  "Response": "Energycontrolparameters",
  "SerialNumber": 1,
  "Target": "Web",
  "ControlInfoField": {
    "EnergyManagement": "1",
    "PowerControlPeriod1": "1,09:00,23:59,1000,500,0,100,10",
    "PowerControlPeriod2": "1,00:00,1:59,0,500,1,100,10",
    "PowerControlPeriod3": "1,02:00,4:59,0,500,2,50,10",
    "PowerControlPeriod4": "1,05:00,8:59,0,500,2,100,10"
  }
}

2.6 能源控制参数设置命令实例

{
  "Set": "Energycontrolparameters",
  "SerialNumber": 1,
  "CommandSource": "Web",
  "SetControlInfoField": {
    "EnergyManagement": "1",
    "PowerControlPeriod1": "1,09:00,23:59,1000,500,0,100,10"
  }
}

2.7 能源控制参数设置命令应答实例

{
  "Response": "Energycontrolparameters",
  "SerialNumber": 1,
  "Target": "Web",
  "SetParametersField": {
    "EnergyManagement": "1",
    "PowerControlPeriod1": "1,09:00,23:59,1000,500,0,100,10"
  }
}

3.1 通信配置

3.2 透传数据命令说明

App 可以通过数据透传命令将 Modbus RTU 帧下发给 EMS 接入的子设备，设备返回 Modbus 响应。

3.3 透传数据发送实例

{
  "Set": "DataTransmission",
  "SerialNumber": 1,
  "CommandSource": "Web",
  "SetCommand": {
    "FunctionCode": 3,
    "TransmittedData": "01 03 FE 06 00 03 56 67"
  }
}

3.4 透传数据应答实例

{
  "Response": "DataTransmission",
  "SerialNumber": 1,
  "Target": "Web",
  "CommandResponse": {
    "FunctionCode": 3,
    "ControlState": "succeed",
    "TransmittedData": "01 03 06 00 01 02 03 04 05 2F CE"
  }
}

4.1 通信配置

4.2 寄存器透传