docs(M06-E-R1): 回填插座协议与游标

This commit is contained in:
Codex
2026-08-10 19:15:15 +08:00
parent 36b3b2fd25
commit 95cc5ea444
8 changed files with 59 additions and 26 deletions
+14 -2
View File
@@ -1,12 +1,12 @@
# MQTT 协议映射
M06-C-R1 已依据 V5.6 中完成的两份厂商协议原件审计,校正控制箱Sub-1G 门锁的 Wire JSON、上行结果、事件、脱敏和离线处理。智慧插座的原件差异已识别,当前游标在 M06-E-R1,未完成前不得沿用`powerW/temperature/overLoad` 假字段作为有效协议结论
M06-C/E-R1 已依据 V5.6 中完成的两份厂商协议原件审计,校正控制箱Sub-1G 门锁与智慧插座的 Wire JSON、上行结果、事件、脱敏和离线处理。旧 `powerW/temperature/overLoad` 假字段已从生产告警逻辑删除,仅保留负向 fixture 证明其不会触发保护告警
| 设备 | Topic/命令 | 方向 | 字段 | 状态 |
|---|---|---|---|---|
| 4G 智能门禁控电箱 | `/devicesend/{DeviceID}``/devicewill/{DeviceID}``/deviceaccept/{DeviceID}` | 双向 | `basicInfo/mqttConfig/startVoice/task/taskconfig``ConctolPower``Crldoor``PlayTTS/stopTTS``CrlLED``task/addtask/canceltask` | PROTOCOL_FIXTURE_PASS |
| Sub-1G 智能门锁 | 经父控制箱使用相同三个 Topic | 双向 | `AddDevice``CtrlDevice``open/close/none/setkey/delkey/setcard/delcard/factoryreset` | PROTOCOL_FIXTURE_PASS |
| 4G 智慧插座 | `/devicesend/{DeviceID}``/devicewill/{DeviceID}``/deviceaccept/{DeviceID}` | 双向 | `basicInfo/workInfo/localtask/mqttConfig``on/off``localtask/clearTask`保护配置与特殊断电事件 | M06-E-R1 DOING |
| 4G 智慧插座 | `/devicesend/{DeviceID}``/devicewill/{DeviceID}``/deviceaccept/{DeviceID}` | 双向 | `basicInfo/workInfo/localtask/mqttConfig``on/off``localtask/clearTask``protectOff/parameter`、危险维护动作与 `special` | PROTOCOL_FIXTURE_PASS |
## M06-A ACL 基线
@@ -37,3 +37,15 @@ M06-C-R1 已依据 V5.6 中完成的两份厂商协议原件审计,校正控
| 门锁动作 | `action=CtrlDevice,subtype,subID,order,id[,value]` | `subtype` 仅 14/15;密码按连续 6 位分组,卡号按连续 8 位十六进制分组;卡号发送大写 |
`delkey/delcard value=all``factoryreset` 仅平台管理员加固定确认短语可下发;凭据管理至少要求门店管理员权限。`magstate``taskfinish``Poweron``connected``record` 均按事件处理,不进入命令 ACK。
## M06-E-R1 智慧插座精确映射
| 领域输入/上行 | Canonical Wire/领域字段 | 规则 |
|---|---|---|
| 读取本地任务 | `read=localtask,slotNum,taskNum` | `taskNum=0` 仅表示读取全部;另支持 canonical `read=mqttConfig` |
| `mode/time/weekdays/action` | `cyctype/actiontime/weekdata/tasktype` | once/daycyc/weekcyc;时间固定 HHmmweekdata 固定周一至周日 7 位 0/1 |
| 保护 DTO + 设备型号/能力 | `setting=protectOff` | `maxCurrent/maxPower` 按 10A/16A/63A 分级校验;自停功率不得高于最大功率 |
| `keyOff` | `setting=parameter,...,KeyOff,id` | 接收兼容 `keyOff/KeyOff`,发送只用 `KeyOff` |
| `onOff/vol/cur/pow/temp|temperature/energy` | `switchOn/voltage/current/power/temperature/energy` | 十进制字符串规范化,不用浮点累计;temp 优先,冲突写协议告警/死信 |
`special.closeReason` 1/2 是本地按键操作,不生成保护告警;3/4/5/6/7 分别映射 `SOCKET_PULL_OUT_STOP/SOCKET_CHARGE_FULL_STOP/SOCKET_OVERPOWER/SOCKET_OVERCURRENT/SOCKET_OVERTEMPERATURE``emptyPower``returnFactory`、清空全部任务以及其他危险维护命令要求平台管理员和固定确认短语,复位口令只保存哈希与脱敏值。