hkc
/
EMS3.0
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
EMS3.0/00. 预研阶段/wudun_EMS_MQTT/level-2-ems/pcs-control.md

15 KiB
Raw Blame History

手动控制-PCS远程控制

发送pcs远程控制策略

  • Topic：

    • 用户自定义MQTT： v1/wudun/${PRODUCT_KEY}/${DEVICE}/pcs_control/set/command
    • 平台默认MQTT： v1/user/${TENANT}/${DEVICE}/pcs_control/set/command

  • **权限：**订阅

  • Payload主结构

    参数类型是否必填描述范围样例
    midUUIDtrue消息ID-3e681859-6917-4b9a-9afd-3f162cd185bd
    typestrtrue消息类型pcs_setpcs_set
    datadatatrue消息内容-见Payload - data
    sub_device_uidstrtrue一级设备UID，仅二级替一级设备上报时需要该字段-jHODSda39
    sub_device_idinttrue一级设备ID，仅二级替一级设备上报时需要该字段(0, ∞)2
    device_uidstrtrue设备UID-iYRkfVpi77
    timestampinttrue消息时间戳（单位：毫秒）(0, ∞)1696837112000

  • Payload - data

    参数类型是否必填描述范围样例
    pcs_fault_resetintfalse故障复位[0,1]1
    pcs_device_startupintfalse设备启动[0,1]0
    pcs_device_stopintfalse设备停机[0,1]1
    pcs_remote_emergency_stopintfalse远程急停[0,1]0
    pcs_reset_cumulative_chargeintfalse累计充电电量清零[0, 1]1
    pcs_reset_cumulative_dischargeintfalse累计放电电量清零[0,1]1
    pcs_remote_local_settingintfalse远程/就地设置 0-就地，1-远程 }[0, 1]1

  • Payload示例

{
  "trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
  "mid": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
  "type": "pcs_set",
  "data": {
    "pcs_device_stop":1,
    },
  "sub_device_uid": "${SUB_DEVICE_UID}",
  "sub_device_id": "${SUB_DEVICE_ID}",
  "device_uid": "${DEVICE_UID}",
  "timestamp": 1695265371000
}

发送pcs远程控制策略响应

  • Topic：

    • 用户自定义MQTT：v1/wudun/${PRODUCT_KEY}/${DEVICE}/pcs_control/set/result
    • 平台默认MQTT： v1/user/${TENANT}/${DEVICE}/pcs_control/set/result

  • **权限：**订阅

  • Payload主结构

    参数类型是否必填描述范围样例
    midUUIDtrue消息ID-4c5b3c27-cea8-4ea1-a936-41fd3596e0e9
    replyUUIDtrue所回复消息的mid-3e681859-6917-4b9a-9afd-3f162cd185bd
    typestrtrue消息类型pcs_setpcs_set
    codeinttrue响应代码-见响应代码
    msgstrfalse失败原因-参数错误
    sub_device_uidstrtrue子设备UID
    sub_device_idinttrue子设备ID2
    device_uidstrtrue（二级）设备UID-iYRkfVpi77
    timestampinttrue消息时间戳（单位：毫秒）(0, ∞)1696837112000

  • 响应代码

    错误码描述说明
    200下发成功
    400参数有误

  • Payload示例

{
    "trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
    "mid": "4c5b3c27-cea8-4ea1-a936-41fd3596e0e9",
    "type": "pcs_set",
    "reply": "3e681859-6917-4b9a-9afd-3f162cd185bd",
    "code": 200,
    "msg": "下发成功",
    "sub_device_uid": "jHODSda39",
    "sub_device_id": 2,
    "device_uid": "iYRkfVpi77",
    "timestamp": 1695265671000
}

请求同步pcs远程控制策略

  • Topic：

    • 用户自定义MQTT：v1/wudun/${PRODUCT_KEY}/${DEVICE}/pcs_control/sync/command
    • 平台默认MQTT： v1/user/${TENANT}/${DEVICE}/pcs_control/sync/command

  • **权限：**发布

  • Payload主结构

    参数类型是否必填描述范围样例
    midUUIDtrue消息ID-4c5b3c27-cea8-4ea1-a936-41fd3596e0e9
    typestrtrue消息类型pcs_syncpcs_sync
    sub_device_uidstrtrue一级设备UID，仅二级替一级设备上报时需要该字段-jHODSda39
    device_uidstrtrue设备UID-iYRkfVpi77
    timestampinttrue消息时间戳（单位：毫秒）(0, ∞)1696837112000

  • 响应代码

    错误码描述说明
    200下发成功
    400参数有误

  • Payload示例

{
    "trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
    "mid": "4c5b3c27-cea8-4ea1-a936-41fd3596e0e9",
    "type": "pcs_sync",
    "sub_device_uid": "${SUB_DEVICE_UID}",
    "sub_device_id": "${SUB_DEVICE_ID}",
    "device_uid": "${DEVICE_UID}",
    "timestamp": 1695265671000
}

同步pcs远程控制策略响应

  • Topic：

    • 用户自定义MQTT：v1/wudun/${PRODUCT_KEY}/${DEVICE}/pcs_control/sync/result
    • 平台默认MQTT： v1/user/${TENANT}/${DEVICE}/pcs_control/sync/result

  • **权限：**订阅

  • Payload主结构

    参数类型是否必填描述范围样例
    midUUIDtrue消息ID-3e681859-6917-4b9a-9afd-3f162cd185bd
    typestrtrue消息类型pcs_syncpcs_sync
    code inttrue响应代码见响应代码
    datadatatrue消息内容-见Payload - data
    sub_device_uidstrtrue一级设备UID，仅二级替一级设备上报时需要该字段-jHODSda39
    sub_device_idinttrue一级设备ID，仅二级替一级设备上报时需要该字段2
    device_uidstrtrue设备UID-iYRkfVpi77
    timestampinttrue消息时间戳（单位：毫秒）(0, ∞)1696837112000

  • Payload - data

<table><thead><tr><th width="209">参数</th><th width="81">类型<select><option value="7a689ae99ed145e183989371bbcf21ce" label="int" color="blue"></option></select></th><th width="85" data-type="checkbox">是否必填</th><th>描述</th><th>范围</th><th>样例</th></tr></thead><tbody><tr><td>pcs_fault_reset</td><td><span data-option="7a689ae99ed145e183989371bbcf21ce">int</span></td><td>false</td><td>故障复位</td><td>[0,1]</td><td>1</td></tr><tr><td>pcs_device_startup</td><td><span data-option="7a689ae99ed145e183989371bbcf21ce">int</span></td><td>false</td><td>设备启动</td><td>[0,1]</td><td>0</td></tr><tr><td>pcs_device_stop</td><td><span data-option="7a689ae99ed145e183989371bbcf21ce">int</span></td><td>false</td><td>设备停机</td><td>[0,1]</td><td>1</td></tr><tr><td>pcs_remote_emergency_stop</td><td><span data-option="7a689ae99ed145e183989371bbcf21ce">int</span></td><td>false</td><td>远程急停</td><td>[0,1]</td><td>0</td></tr><tr><td>pcs_reset_cumulative_charge</td><td><span data-option="7a689ae99ed145e183989371bbcf21ce">int</span></td><td>false</td><td>累计充电电量清零</td><td>[0, 1]</td><td>1</td></tr><tr><td>pcs_reset_cumulative_discharge</td><td><span data-option="7a689ae99ed145e183989371bbcf21ce">int</span></td><td>false</td><td>累计放电电量清零</td><td>[0,1]</td><td>1</td></tr><tr><td>pcs_remote_local_setting</td><td><span data-option="7a689ae99ed145e183989371bbcf21ce">int</span></td><td>false</td><td>远程/就地设置 0-就地，1-远程 }</td><td>[0, 1]</td><td>1</td></tr></tbody></table>
  • Payload示例
{  
  "trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
  "mid": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
  "reply": "3e681859-6917-4b9a-9afd-3f162cd185bd",
  "type": "pcs_sync",
  "code": 200,
  "data": {
    "pcs_fault_reset":0,
    "pcs_device_startup":0,
    "pcs_device_stop":1,
    "pcs_remote_emergency_stop":0,
    "pcs_reset_cumulative_charge":0,
    "pcs_reset_cumulative_discharge":0,
    "pcs_remote_local_setting":0
    },
  "sub_device_uid": "${SUB_DEVICE_UID}",
  "sub_device_id": "${SUB_DEVICE_ID}",
  "device_uid": "${DEVICE_UID}",
  "timestamp": 1695265371000
}