EMS3.0/00. 预研阶段/wudun_EMS_MQTT/level-2-ems/condition-control.md

手动控制-冷却系统远程控制

发送液冷远程控制策略

• Topic：

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

• **权限：**订阅

• Payload主结构

  参数	类型	是否必填	描述	范围	样例
  mid	UUID	true	消息ID	-	3e681859-6917-4b9a-9afd-3f162cd185bd
  type	str	true	消息类型	condition_set	condition_set
  data	data	true	消息内容	-	见Payload - data
  sub_device_uid	str	true	一级设备UID，仅二级替一级设备上报时需要该字段	-	jHODSda39
  sub_device_id	int	true	一级设备ID，仅二级替一级设备上报时需要该字段		2
  device_uid	str	true	设备UID	-	iYRkfVpi77
  timestamp	int	true	消息时间戳（单位：毫秒）	(0, ∞)	1696837112000

• Payload - data

  参数	类型	是否必填	描述	范围	样例
  power_on	int	false	开机 (0:关机, 1:开机)	[0,1]	1
  target_heating_point	float	false	加热目标温度	[0,∞]	0
  target_cooling_point	float	false	制冷目标温度	[0,∞]	1

• Payload示例

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

发送液冷远程控制策略响应

• Topic：

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

• **权限：**订阅

• Payload主结构

  参数	类型	是否必填	描述	范围	样例
  mid	UUID	true	消息ID	-	4c5b3c27-cea8-4ea1-a936-41fd3596e0e9
  reply	UUID	true	所回复消息的mid	-	3e681859-6917-4b9a-9afd-3f162cd185bd
  type	str	true	消息类型	condition_set	condition_set
  code	int	true	响应代码	-	见响应代码
  msg	str	false	失败原因	-	参数错误
  sub_device_uid	str	true	子设备UID
  sub_device_id	int	true	一级设备ID，仅二级替一级设备上报时需要该字段		2
  device_uid	str	true	（二级）设备UID	-	iYRkfVpi77
  timestamp	int	true	消息时间戳（单位：毫秒）	(0, ∞)	1696837112000

• 响应代码

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

• Payload示例

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

请求同步液冷远程控制策略

• Topic：

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

• **权限：**发布

• Payload主结构

  参数	类型	是否必填	描述	范围	样例
  mid	UUID	true	消息ID	-	4c5b3c27-cea8-4ea1-a936-41fd3596e0e9
  type	str	true	消息类型	condition_sync	condition_sync
  sub_device_uid	str	true	一级设备UID，仅二级替一级设备上报时需要该字段	-	jHODSda39
  sub_device_id	int	true	一级设备ID，仅二级替一级设备上报时需要该字段		2
  device_uid	str	true	设备UID	-	iYRkfVpi77
  timestamp	int	true	消息时间戳（单位：毫秒）	(0, ∞)	1696837112000

• 响应代码

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

• Payload示例

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

同步液冷远程控制策略响应

• Topic：

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

• **权限：**订阅

• Payload主结构

  参数	类型	是否必填	描述	范围	样例
  mid	UUID	true	消息ID	-	3e681859-6917-4b9a-9afd-3f162cd185bd
  type	str	true	消息类型	condition_sync	condition_sync
  code	int	true	响应代码		见响应代码
  data	data	true	消息内容	-	见Payload - data
  sub_device_uid	str	true	一级设备UID，仅二级替一级设备上报时需要该字段	-	jHODSda39
  sub_device_id	int	true	一级设备ID，仅二级替一级设备上报时需要该字段		2
  device_uid	str	true	设备UID	-	iYRkfVpi77
  timestamp	int	true	消息时间戳（单位：毫秒）	(0, ∞)	1696837112000

• Payload - data

<table><thead><tr><th width="209">参数</th><th width="81">类型<select><option value="7a689ae99ed145e183989371bbcf21ce" label="int" color="blue"></option><option value="b1iX7Pkjvcfr" label="float" color="blue"></option></select></th><th width="85" data-type="checkbox">是否必填</th><th>描述</th><th>范围</th><th>样例</th></tr></thead><tbody><tr><td>power_on</td><td><span data-option="7a689ae99ed145e183989371bbcf21ce">int</span></td><td>false</td><td>开机 (0:关机, 1:开机)</td><td>[0,1]</td><td>1</td></tr><tr><td>target_heating_point</td><td><span data-option="b1iX7Pkjvcfr">float</span></td><td>false</td><td>加热目标温度</td><td>[0,∞]</td><td>0</td></tr><tr><td>target_cooling_point</td><td><span data-option="b1iX7Pkjvcfr">float</span></td><td>false</td><td>制冷目标温度</td><td>[0,∞]</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": "condition_sync",
  "code": 200,
  "data": {
    "power_on":1,
    "target_heating_point":100,
    "target_cooling_point":10,
    },
  "sub_device_uid": "${SUB_DEVICE_UID}",
  "sub_device_id": "${SUB_DEVICE_ID}",
  "device_uid": "${DEVICE_UID}",
  "timestamp": 1695265371000
}