crosstyan/whtp
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update device identifier format from UUID to NanoID in example.jsonc, mqtt.md, schema.json, and schema.md; enhance documentation to reflect changes in device ID representation.

Browse Source
This commit is contained in:
crosstyan
2025-07-07 18:52:54 +08:00
parent 6c90561b6f
commit fb42ca777f
5 changed files with 17 additions and 21 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
mqtt.md
View File

@ -24,11 +24,11 @@
## 消息主题
假设设备唯一标识 `dev_id = 148413b4-c352-49a9-9c48-9d15276a99e7`，则常用主题如下：
假设设备唯一标识 `dev_id = 2B1oj2S5k7kS8mL_QaCs`，则常用主题如下：
| 方向 | 主题模板 | 示例 | 说明 |
| ---- | ------------------- | ---------------------------------------------- | ------------------------------------ |
| 上行 | `/whtp/up/{dev_id}` | `whtp/up/148413b4-c352-49a9-9c48-9d15276a99e7` | 发送遥测数据（Payload 为 WHTP JSON） |
| 方向 | 主题模板 | 示例 | 说明 |
| ---- | ------------------- | ------------------------------- | ------------------------------------ |
| 上行 | `/whtp/up/{dev_id}` | `/whtp/up/2B1oj2S5k7kS8mL_QaCs` | 发送遥测数据（Payload 为 WHTP JSON） |
## QoS 与重传策略
@ -47,13 +47,13 @@ MQTT Payload **必须**为 UTF-8 编码的文本，遵循 [WHTP 主规范](schem
```jsonc
// 示例：设备侧发布
Topic : /whtp/up/148413b4-c352-49a9-9c48-9d15276a99e7
Topic : /whtp/up/2B1oj2S5k7kS8mL_QaCs
QoS : 1
Retained: false
Payload : {
"version": 1,
"msg_type": "telemetry",
"dev_id": "148413b4-c352-49a9-9c48-9d15276a99e7",
"dev_id": "2B1oj2S5k7kS8mL_QaCs",
"dev_type": "device_type_name",
"timestamp": 1715145600,
"fields": [