物美协议接入
简介
物美协议（wumei）是联犀平台对接物美设备生态的 MQTT 直连协议，使用产品级 MQTT 账号密码认证（非设备三元组签名），设备通过 MQTT 连接平台并按物美 Topic 规范上报数据。
应用场景
- 物美设备接入：支持物美协议的智能设备（传感器、控制器等）接入联犀
- 产品级认证：同一产品的设备共享产品级账号密码，简化设备配置
前置条件
- 协议容器已部署：
protocol-wumei容器运行正常 - MQTT Broker 可访问：平台 MQTT 服务端口 1883 开放
产品配置
1. 创建产品
创建产品时选择协议 wumei（传输协议 MQTT）。
2. 产品级账号密码
进入产品详情「设备接入」Tab，配置产品级 MQTT 账号密码：
| 字段 | 说明 |
|---|---|
userName | 产品级 MQTT 账号 |
password | 产品级 MQTT 密码 |
设备接入
设备详情「设备接入」Tab 展示 MQTT 连接参数：
| 参数 | 值 |
|---|---|
| Broker | mqtt://{host}:1883 |
| ClientID | S&{deviceName}&{productID}&{userID}（4 段 & 分隔；第 1 段固定 S，第 4 段任意数值可为 0） |
| Username | 产品级 MQTT 账号（protocolConf.userName） |
| Password | 产品级 MQTT 密码（protocolConf.password） |
设备无需预创建，使用产品级账号密码首次登录即自动创建设备。
Topic 清单
| 方向 | Topic | 说明 |
|---|---|---|
| 上行 | /{productID}/{deviceName}/property/post | 属性上报 |
| 上行 | /{productID}/{deviceName}/function/post | 功能上报 |
| 上行 | /{productID}/{deviceName}/info/post | 设备信息上报 |
| 上行 | /{productID}/{deviceName}/ntp/post | NTP 校时请求 |
| 下行 | /{productID}/{deviceName}/function/get | 功能下发 |
| 下行 | /{productID}/{deviceName}/ota/get | OTA 升级 |
| 下行 | /{productID}/{deviceName}/ntp/get | NTP 校时响应 |
技术方案
接入架构
物美设备 ──MQTT──> protocol-wumei 容器(订阅 +/+/+/post) ──> 联犀平台- 设备以产品级账号密码连接 MQTT
- 协议按
/{pid}/{dn}/{type}/post解析上行（type ∈ property/function/info/ntp） - 认证校验：ClientID 4 段 + Username=产品级账号 + Password=产品级密码（AuthType=S）
接入示例
# mosquitto 连接并上报属性
mosquitto_pub -h {host} -p 1883 \
-i 'S&dev01&PRODID&0' \
-u 'wumei-account' -P 'wumei-pwd' \
-t '/PRODID/dev01/property/post' \
-m '{"params":{"Power":{"value":1}}}'注意事项
- ClientID 第 1 段固定
S（简单认证；E加密认证服务端未实现勿用） - 设备自动创建，无需预注册
更新日志
2026/8/20 21:56
查看所有更新日志
70f71-于
