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/charge-depth.md

135 lines
16 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# 策略-充放电深度保护
## 上报放电深度保护策略
* **Topic：**
* 用户自定义MQTT： `v1/wudun/${PRODUCT_KEY}/${DEVICE}/`<mark style="color:red;">`charge_percentage/details`</mark>`/post`
* 平台默认MQTT： `v1/user/${TENANT}/${DEVICE}/`<mark style="color:red;">`charge_percentage/details`</mark>`/post`
* **权限：**订阅
* **Payload主结构**
<table><thead><tr><th width="173">参数</th><th width="80">类型<select><option value="36cc16022bbb4c7b93fe3a347e4eee85" label="UUID" color="blue"></option><option value="826385f71ccd46638f3a63c8d6abef21" label="str" color="blue"></option><option value="bb5bb2c3a10846bf881acb0506b5951f" label="int" color="blue"></option><option value="f53674f5f7b044bab9768d2995855ea2" label="[]str" color="blue"></option><option value="005ee50172ec4f44a83308b0bfb12d48" label="data" color="blue"></option></select></th><th width="100" data-type="checkbox">是否必填</th><th>描述</th><th>范围</th><th>样例</th></tr></thead><tbody><tr><td>mid</td><td><span data-option="36cc16022bbb4c7b93fe3a347e4eee85">UUID</span></td><td>true</td><td>消息ID</td><td>-</td><td>3e681859-6917-4b9a-9afd-3f162cd185bd</td></tr><tr><td>type</td><td><span data-option="826385f71ccd46638f3a63c8d6abef21">str</span></td><td>true</td><td>消息类型</td><td>charge_percentage_details</td><td>charge_percentage_details</td></tr><tr><td>data</td><td><span data-option="005ee50172ec4f44a83308b0bfb12d48">data</span></td><td>true</td><td>消息内容</td><td>-</td><td>见<strong>Payload - ChargePercentage</strong></td></tr><tr><td>sub_device_uid</td><td><span data-option="826385f71ccd46638f3a63c8d6abef21">str</span></td><td>false</td><td>sub_device_uid和sub_device_id根据实际情况二选一</td><td>-</td><td>jHODSda39</td></tr><tr><td>sub_device_id</td><td><span data-option="bb5bb2c3a10846bf881acb0506b5951f">int</span></td><td>false</td><td>sub_device_uid和sub_device_id根据实际情况二选一</td><td>-</td><td>1</td></tr><tr><td>device_uid</td><td><span data-option="826385f71ccd46638f3a63c8d6abef21">str</span></td><td>true</td><td>设备UID</td><td>-</td><td>iYRkfVpi77</td></tr><tr><td>timestamp</td><td><span data-option="bb5bb2c3a10846bf881acb0506b5951f">int</span></td><td>true</td><td>消息时间戳（单位：毫秒）</td><td>(0, ∞)</td><td>1696837112000</td></tr></tbody></table>
* **Payload - data/ChargePercentage**
<table><thead><tr><th>参数</th><th width="130">类型<select><option value="bb43c884142f4569b3ec2e9619564912" label="int" color="blue"></option><option value="fQ297IJfuUxN" label="float" color="blue"></option></select></th><th data-type="checkbox">是否必填</th><th>描述</th><th>范围</th><th>样例</th></tr></thead><tbody><tr><td>charge_depth_on</td><td><span data-option="bb43c884142f4569b3ec2e9619564912">int</span></td><td>true</td><td>充电深度保护开关 </td><td><p>0-关闭</p><p>1-开启</p></td><td>1</td></tr><tr><td>charge_energy_soc_1</td><td><span data-option="fQ297IJfuUxN">float</span></td><td>true</td><td>充电电量SOC-1</td><td>[0.0, 100.0]<br>0代表不配置</td><td>99</td></tr><tr><td>charge_cell_voltage_1</td><td><span data-option="fQ297IJfuUxN">float</span></td><td>true</td><td>充电单体电压-1</td><td>[0.00, ∞)<br>0代表不配置</td><td>3.6</td></tr><tr><td>charge_cell_power_1</td><td><span data-option="fQ297IJfuUxN">float</span></td><td>true</td><td>充电输出功率-1</td><td>[0.0, ∞)</td><td>0</td></tr><tr><td>charge_energy_soc_2</td><td><span data-option="fQ297IJfuUxN">float</span></td><td>true</td><td>充电电量SOC-2</td><td>[0.0, 100.0]<br>0代表不配置</td><td>98</td></tr><tr><td>charge_cell_voltage_2</td><td><span data-option="fQ297IJfuUxN">float</span></td><td>true</td><td>充电单体电压-2</td><td>[0.00, ∞)<br>0代表不配置</td><td>0</td></tr><tr><td>charge_cell_power_2</td><td><span data-option="fQ297IJfuUxN">float</span></td><td>true</td><td>充电输出功率-2</td><td>[0.0, ∞)</td><td>15</td></tr><tr><td>charge_energy_soc_3</td><td><span data-option="fQ297IJfuUxN">float</span></td><td>true</td><td>电量SOC-3</td><td>[0.0, 100.0]<br>0代表不配置</td><td>97</td></tr><tr><td>charge_cell_voltage_3</td><td><span data-option="fQ297IJfuUxN">float</span></td><td>true</td><td>充电单体电压-3</td><td>[0.00, ∞)<br>0代表不配置</td><td>0</td></tr><tr><td>charge_cell_power_3</td><td><span data-option="fQ297IJfuUxN">float</span></td><td>true</td><td>充电输出功率-3</td><td>[0.0, ∞)</td><td>30</td></tr><tr><td>charge_energy_soc_4</td><td><span data-option="fQ297IJfuUxN">float</span></td><td>true</td><td>电量SOC-4</td><td>[0.0, 100.0]<br>0代表不配置</td><td>96</td></tr><tr><td>charge_cell_voltage_4</td><td><span data-option="fQ297IJfuUxN">float</span></td><td>true</td><td>充电单体电压-4</td><td>[0.00, ∞)<br>0代表不配置</td><td>0</td></tr><tr><td>charge_cell_power_4</td><td><span data-option="fQ297IJfuUxN">float</span></td><td>true</td><td>充电输出功率-4</td><td>[0.0, ∞)</td><td>50</td></tr><tr><td>discharge_depth_on</td><td><span data-option="bb43c884142f4569b3ec2e9619564912">int</span></td><td>true</td><td>放电深度保护开关</td><td><p>0-关闭</p><p>1-开启</p></td><td>1</td></tr><tr><td>discharge_energy_soc_1</td><td><span data-option="fQ297IJfuUxN">float</span></td><td>true</td><td>放电电量SOC-1</td><td>[0.0, 100.0]<br>0代表不配置</td><td>2</td></tr><tr><td>discharge_cell_voltage_1</td><td><span data-option="fQ297IJfuUxN">float</span></td><td>true</td><td>放电单体电压-1</td><td>[0.00, ∞)<br>0代表不配置</td><td>3</td></tr><tr><td>discharge_cell_power_1</td><td><span data-option="fQ297IJfuUxN">float</span></td><td>true</td><td>放电输出功率-1</td><td>[0.0, ∞)</td><td>0</td></tr><tr><td>discharge_energy_soc_2</td><td><span data-option="fQ297IJfuUxN">float</span></td><td>true</td><td>放电电量SOC-2</td><td>[0.0, 100.0]<br>0代表不配置</td><td>3</td></tr><tr><td>discharge_cell_voltage_2</td><td><span data-option="fQ297IJfuUxN">float</span></td><td>true</td><td>放电单体电压-2</td><td>[0.00, ∞)<br>0代表不配置</td><td>0</td></tr><tr><td>discharge_cell_power_2</td><td><span data-option="fQ297IJfuUxN">float</span></td><td>true</td><td>放电输出功率-2</td><td>[0.0, ∞)</td><td>30</td></tr><tr><td>discharge_energy_soc_3</td><td><span data-option="fQ297IJfuUxN">float</span></td><td>true</td><td>放电电量SOC-3</td><td>[0.0, 100.0]<br>0代表不配置</td><td>4</td></tr><tr><td>discharge_cell_voltage_3</td><td><span data-option="fQ297IJfuUxN">float</span></td><td>true</td><td>放电单体电压-3</td><td>[0.00, ∞)<br>0代表不配置</td><td>0</td></tr><tr><td>discharge_cell_power_3</td><td><span data-option="fQ297IJfuUxN">float</span></td><td>true</td><td>放电输出功率-3</td><td>[0.0, ∞)</td><td>50</td></tr><tr><td>discharge_energy_soc_4</td><td><span data-option="fQ297IJfuUxN">float</span></td><td>true</td><td>放电电量SOC-4</td><td>[0.0, 100.0]<br>0代表不配置</td><td>5</td></tr><tr><td>discharge_cell_voltage_4</td><td><span data-option="fQ297IJfuUxN">float</span></td><td>true</td><td>放电单体电压-4</td><td>[0.00, ∞)<br>0代表不配置</td><td>0</td></tr><tr><td>discharge_cell_power_4</td><td><span data-option="fQ297IJfuUxN">float</span></td><td>true</td><td>放电输出功率-4</td><td>[0.0, ∞)</td><td>70</td></tr></tbody></table>
* **Payload示例**
{% code lineNumbers="true" %}
```json
{
"trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
"mid": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
"type": "charge_percentage_details",
"data": {
"charge_depth_on": 1,
"charge_energy_soc_1": 99,
"charge_cell_voltage_1": 3.6,
"charge_cell_power_1": 0,
"charge_energy_soc_2": 98,
"charge_cell_voltage_2": 0,
"charge_cell_power_2": 15,
"charge_energy_soc_3": 97,
"charge_cell_voltage_3": 0,
"charge_cell_power_3": 30,
"charge_energy_soc_4": 96,
"charge_cell_voltage_4": 0,
"charge_cell_power_4": 50,
"discharge_depth_on": 1,
"discharge_energy_soc_1": 2,
"discharge_cell_voltage_1": 3,
"discharge_cell_power_1": 0,
"discharge_energy_soc_2": 3,
"discharge_cell_voltage_2": 0,
"discharge_cell_power_2": 30,
"discharge_energy_soc_3": 4,
"discharge_cell_voltage_3": 0,
"discharge_cell_power_3": 50,
"discharge_energy_soc_4": 5,
"discharge_cell_voltage_4": 0,
"discharge_cell_power_4": 70
},
"sub_device_id": 1,
"device_uid": "${DEVICE_UID}",
"timestamp": 1695265371000
}
```
{% endcode %}
## 平台请求同步放电深度保护策略
* **Topic：**
* 用户自定义MQTT：`v1/wudun/${PRODUCT_KEY}/${DEVICE}/`<mark style="color:red;">`charge_percentage/sync`</mark>`/command`
* 平台默认MQTT： `v1/user/${TENANT}/${DEVICE}/`<mark style="color:red;">`charge_percentage/sync`</mark>`/command`
* **权限：**发布
* **Payload主结构**
<table><thead><tr><th width="173">参数</th><th width="80">类型<select><option value="36cc16022bbb4c7b93fe3a347e4eee85" label="UUID" color="blue"></option><option value="826385f71ccd46638f3a63c8d6abef21" label="str" color="blue"></option><option value="bb5bb2c3a10846bf881acb0506b5951f" label="int" color="blue"></option><option value="f53674f5f7b044bab9768d2995855ea2" label="[]str" color="blue"></option><option value="005ee50172ec4f44a83308b0bfb12d48" label="data" color="blue"></option></select></th><th width="100" data-type="checkbox">是否必填</th><th>描述</th><th>范围</th><th>样例</th></tr></thead><tbody><tr><td>mid</td><td><span data-option="36cc16022bbb4c7b93fe3a347e4eee85">UUID</span></td><td>true</td><td>消息ID</td><td>-</td><td>4c5b3c27-cea8-4ea1-a936-41fd3596e0e9</td></tr><tr><td>reply</td><td><span data-option="36cc16022bbb4c7b93fe3a347e4eee85">UUID</span></td><td>true</td><td>所回复消息的mid</td><td>-</td><td>3e681859-6917-4b9a-9afd-3f162cd185bd</td></tr><tr><td>type</td><td><span data-option="826385f71ccd46638f3a63c8d6abef21">str</span></td><td>true</td><td>消息类型</td><td>charge_percentage_sync</td><td>charge_percentage_sync</td></tr><tr><td>code</td><td><span data-option="bb5bb2c3a10846bf881acb0506b5951f">int</span></td><td>true</td><td>响应代码</td><td>-</td><td>见响应代码</td></tr><tr><td>msg</td><td><span data-option="826385f71ccd46638f3a63c8d6abef21">str</span></td><td>true</td><td>失败原因</td><td>-</td><td>参数错误</td></tr><tr><td>sub_device_uid</td><td><span data-option="826385f71ccd46638f3a63c8d6abef21">str</span></td><td>false</td><td>sub_device_uid和sub_device_id根据实际情况二选一</td><td>-</td><td>jHODSda39</td></tr><tr><td>sub_device_id</td><td><span data-option="bb5bb2c3a10846bf881acb0506b5951f">int</span></td><td>false</td><td>sub_device_uid和sub_device_id根据实际情况二选一</td><td>-</td><td>1</td></tr><tr><td>device_uid</td><td><span data-option="826385f71ccd46638f3a63c8d6abef21">str</span></td><td>true</td><td>设备ID</td><td>-</td><td>iYRkfVpi77</td></tr><tr><td>timestamp</td><td><span data-option="bb5bb2c3a10846bf881acb0506b5951f">int</span></td><td>true</td><td>消息时间戳（单位：毫秒）</td><td>(0, ∞)</td><td>1696837112000</td></tr></tbody></table>
* **响应代码**
<table><thead><tr><th>错误码<select><option value="271841fe398248e2ad777dd883d4754c" label="400" color="blue"></option><option value="3c1ae8fc6fe644f78b5f6b6f889f7621" label="200" color="blue"></option></select></th><th>描述</th><th>说明</th></tr></thead><tbody><tr><td><span data-option="3c1ae8fc6fe644f78b5f6b6f889f7621">200</span></td><td>下发成功</td><td></td></tr><tr><td><span data-option="271841fe398248e2ad777dd883d4754c">400</span></td><td>参数有误</td><td></td></tr></tbody></table>
* **Payload示例**
```json
{
"trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
"mid": "4c5b3c27-cea8-4ea1-a936-41fd3596e0e9",
"type": "charge_percentage_sync",
"code": 200,
"msg": "",
"sub_device_id": 1,
"device_uid": "${DEVICE_UID}",
"timestamp": 1695265671000
}
```
### 同步放电深度保护策略响应
* **Topic：**
* 用户自定义MQTT：`v1/wudun/${PRODUCT_KEY}/${DEVICE}/`<mark style="color:red;">`device_info/sync`</mark>`/result`
* 平台默认MQTT： `v1/user/${TENANT}/${DEVICE}/`<mark style="color:red;">`device_info/sync`</mark>`/result`
* **权限：**订阅
* **Payload主结构**
<table><thead><tr><th width="173">参数</th><th width="80">类型<select><option value="36cc16022bbb4c7b93fe3a347e4eee85" label="UUID" color="blue"></option><option value="826385f71ccd46638f3a63c8d6abef21" label="str" color="blue"></option><option value="bb5bb2c3a10846bf881acb0506b5951f" label="int" color="blue"></option><option value="f53674f5f7b044bab9768d2995855ea2" label="[]str" color="blue"></option><option value="005ee50172ec4f44a83308b0bfb12d48" label="data" color="blue"></option></select></th><th width="100" data-type="checkbox">是否必填</th><th>描述</th><th>范围</th><th>样例</th></tr></thead><tbody><tr><td>mid</td><td><span data-option="36cc16022bbb4c7b93fe3a347e4eee85">UUID</span></td><td>true</td><td>消息ID</td><td>-</td><td>3e681859-6917-4b9a-9afd-3f162cd185bd</td></tr><tr><td>type</td><td><span data-option="826385f71ccd46638f3a63c8d6abef21">str</span></td><td>true</td><td>消息类型</td><td>charge_percentage_sync</td><td>charge_percentage_sync</td></tr><tr><td>data</td><td><span data-option="005ee50172ec4f44a83308b0bfb12d48">data</span></td><td>true</td><td>消息内容</td><td>-</td><td>见<strong>Payload - ChargePercentage</strong></td></tr><tr><td>sub_device_uid</td><td><span data-option="826385f71ccd46638f3a63c8d6abef21">str</span></td><td>false</td><td>sub_device_uid和sub_device_id根据实际情况二选一</td><td>-</td><td>jHODSda39</td></tr><tr><td>sub_device_id</td><td><span data-option="bb5bb2c3a10846bf881acb0506b5951f">int</span></td><td>false</td><td>sub_device_uid和sub_device_id根据实际情况二选一</td><td>-</td><td>1</td></tr><tr><td>device_uid</td><td><span data-option="826385f71ccd46638f3a63c8d6abef21">str</span></td><td>true</td><td>设备UID</td><td>-</td><td>iYRkfVpi77</td></tr><tr><td>timestamp</td><td><span data-option="bb5bb2c3a10846bf881acb0506b5951f">int</span></td><td>true</td><td>消息时间戳（单位：毫秒）</td><td>(0, ∞)</td><td>1696837112000</td></tr></tbody></table>
**Payload示例**
<pre class="language-json"><code class="lang-json"><strong>{
</strong><strong> "trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
</strong> "mid": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
"reply": "3e681859-6917-4b9a-9afd-3f162cd185bd",
"type": "charge_percentage_sync",
"data": {
"charge_depth_on": 1,
"charge_energy_soc_1": 99,
"charge_cell_voltage_1": 3.6,
"charge_cell_power_1": 0,
"charge_energy_soc_2": 98,
"charge_cell_voltage_2": 0,
"charge_cell_power_2": 15,
"charge_energy_soc_3": 97,
"charge_cell_voltage_3": 0,
"charge_cell_power_3": 30,
"charge_energy_soc_4": 96,
"charge_cell_voltage_4": 0,
"charge_cell_power_4": 50,
"discharge_depth_on": 1,
"discharge_energy_soc_1": 2,
"discharge_cell_voltage_1": 3,
"discharge_cell_power_1": 0,
"discharge_energy_soc_2": 3,
"discharge_cell_voltage_2": 0,
"discharge_cell_power_2": 30,
"discharge_energy_soc_3": 4,
"discharge_cell_voltage_3": 0,
"discharge_cell_power_3": 50,
"discharge_energy_soc_4": 5,
"discharge_cell_voltage_4": 0,
"discharge_cell_power_4": 70
},
"sub_device_id": 1,
"device_uid": "${DEVICE_UID}",
"timestamp": 1695265371000
}
</code></pre>
Reference in New Issue View Git Blame Copy Permalink