新设备接入流程
接入分为产品定义、设备身份、通信、运行能力和应用呈现。先用一个独立开发产品/设备验证,禁止拿真实设备ClientId启动模拟器。
- 定义产品:管理员创建产品物模型,明确properties(实际可写/只读测量)、settings(范围/默认值/生效时机)、模型version。参考物模型,不要用产品名称匹配能力。
- 确定身份:productId是MQTT用户名与Topic产品段,physicalId是稳定物理标识/ClientId,逻辑Device.id用于HTTP。通用空板首次本地生成秘密,或由受控出厂流程登记,不能在共享源码内置逐板密钥。
- 配网认领:按BLE协议实现物理窗口、安全通道、身份读取、DHCP及票据交接;普通用户不手填MQTT凭据。新epoch只能走归属屏障握手。
- MQTT:验证CA/主机名,经后端认证授权,只订阅自身精确下行;实现property/set与明确code回复、property/post实际状态,不能在执行前乐观上报。
- 配置/本地任务:按需注册通用device_runtime属性/设置、持久适配与产品清理回调,上报匹配modelRevision的capabilities。不支持调度就报告零容量,不为凑统一页面虚构能力。
- 应用:定义可读标签、单位、缺失值;通用面板可先接入,自主产品可加独立分包,共用Store/权限/实时恢复,不能复制一套绕过权限的设备API。
- 验证:先主机测试硬件失败不假成功、持久失败/重启/重复消息、ACL越权与旧epoch拒绝,再实际手机配网、控制、离线、状态恢复。只编译通过不能认定设备已接入。
两款现有产品工程及烧录详见固件交付,遇到认领/配置卡住按排障逐层定位。BLE网关与异品牌子设备尚未实施,不把预留架构写成当前接入能力。
