认证：一机一密
clientId = sn，密钥由平台在设备预注册时生成，支持按序列号清单批量导入。密钥不得在多台设备间复用。
设备只需要上报
一个在线状态。
本页面向品牌商的硬件厂与固件工程师。我方不做硬件，只提供接入规范与专属凭证。规范刻意做到极简——硬件厂配合成本越低，品牌商落地越快。
MQTT over TLS一机一密1 个必须实现的上行主题支持不接入的降级模式
9.1 / 主题定义
四个主题，只有第一个是必须的。
{tenant} 为品牌商标识，{sn} 为设备序列号，均由平台在设备预注册时下发。
| 主题 | 方向 | 说明 |
|---|---|---|
/t/{tenant}/d/{sn}/status | 设备 → 云 | 唯一必须实现的上行主题。在线心跳，建议 60 秒一次。 |
/t/{tenant}/d/{sn}/control | 云 → 设备 | 控制指令 power_on / power_off / reboot，QoS 1。 |
/t/{tenant}/d/{sn}/response | 设备 → 云 | 指令执行回执。实现控制主题时需要一并实现。 |
/t/{tenant}/d/{sn}/alarm | 设备 → 云 | 故障告警，可选实现。 |
设备侧不上报水量、水质、流量等业务数据。我们不与通用 IoT 平台比协议覆盖，设备状态只用于绑定关系展示与离线告警，报文字段以完整接入文档为准。
9.2 / 接入要求
六条，照做即可。
传输：TLS 1.2 以上
连接需启用 TLS 1.2 及以上版本。明文连接不予接受。
遗嘱消息（LWT）
连接时配置遗嘱消息，用于连接异常断开时快速判定离线，避免等待心跳超时。
在线判定
连续 2 个心跳周期未收到心跳即判为离线并写入告警；心跳丢失满 2 小时触发商家后台工单。
降级模式
硬件尚未接入时，设备仅支持二维码绑定，在线状态显示「未接入」，商城、积分与分销功能不受影响。
故障隔离
接入层异常不影响下单链路。设备侧的任何问题都不会导致品牌商的商城停摆。
交付物
我们会给硬件厂这些东西。
品牌商在开通流程第 4 步（开卖）时，可以直接把文档与专属凭证转给你。
- 完整接入文档主题定义、报文格式、错误码与连接参数。
- 示例代码ESP32 与 Linux 两套可直接编译运行的样例。
- 联调自测工具连上就能看到心跳是否被正确接收，不用等平台侧确认。
- 序列号批量注册模板按表格导入即可批量生成一机一密凭证。
联调
三步接完。
导入序列号
品牌商在后台按模板导入序列号清单，平台生成一机一密凭证。
刷入固件
硬件厂照示例代码接入心跳主题，用自测工具确认心跳被接收。
抽检上线
抽几台机器在商家后台核对在线状态与最后心跳时间，正常即可批量出货。
先出货也不耽误
固件还没准备好，机器照样可以先铺出去，用二维码绑定，之后再补接入。