物美协议接入
简介
物美协议（wumei）是联犀平台对接物美设备生态的 MQTT 直连协议，使用产品级 MQTT 账号密码认证（非设备三元组签名），设备通过 MQTT 连接平台并按物美 Topic 规范上报数据。
应用场景
- 物美设备接入：支持物美协议的智能设备（传感器、控制器等）接入联犀
- 产品级认证：同一产品的设备共享产品级账号密码，简化设备配置
前置条件
- 协议容器已部署：
protocol-wumei容器运行正常 - MQTT Broker 可访问：平台 MQTT 服务端口 1883 开放
产品配置
1. 创建产品
创建产品时选择协议 wumei（传输协议 MQTT）。
2. 产品级账号密码
进入产品详情「设备接入」Tab，配置产品级 MQTT 账号密码（配置页由 protocol-wumei 协议服务内嵌提供，保存到产品协议配置 protocolConf）：
| 字段 | 说明 |
|---|---|
userName | 产品级 MQTT 账号 |
password | 产品级 MQTT 密码 |
设备登录认证以产品级配置校验 MQTT 用户名与密码，修改后需同步更新设备端连接凭证。
若协议服务未运行或未提供配置页服务实例，该 Tab 会显示「配置页暂不可用（协议 wumei 暂无可用的配置页服务实例，服务未启动或未提供配置页）」占位提示，此时产品级账号密码需通过产品协议配置（
protocolConf.userName/protocolConf.password）方式设置：
设备接入
设备详情「设备接入」Tab 展示本设备的 MQTT 接入凭证（Broker / ClientID / 用户名 / 密码，均可一键复制），并支持为单个设备覆盖用户名密码（留空则回退产品级账号密码/设备名/设备密钥）：
| 参数 | 值 |
|---|---|
| Broker | mqtt://{host}:1883 |
| ClientID | S&{deviceName}&{productID}&{userID}（4 段 & 分隔；第 1 段固定 S，第 4 段任意数值可为 0） |
| Username | 设备级覆盖用户名，未配置时为产品级 MQTT 账号（protocolConf.userName） |
| Password | 设备级覆盖密码，未配置时为产品级 MQTT 密码（protocolConf.password） |
若协议服务未提供配置页服务实例，设备页同样显示「配置页暂不可用」占位提示，此时连接参数以上表及产品
protocolConf配置为准；占位提示不影响设备通过 MQTT 使用产品级账号密码接入，协议服务正常提供配置页后，页面会自动展示配置表单与接入凭证：
设备无需预创建，使用产品级账号密码首次登录即自动创建设备。
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/31 22:31
查看所有更新日志
2fc1c-于eb33f-于70dbb-于4ab8f-于
