跳至主要內容

平台主题

fastbee2024年9月27日大约 3 分钟

提示

一般的自定制设备、DTU或者模组,:有一个订阅主题 和 一个发布主题。其中

  • {productId}:平台产品ID
  • {deviceNum}: 设备编号(IMEI号或MAC地址,或平台生成的唯一编号)
  • 带有遗弃字样的主题,2.X版本后不再使用

一、服务端主题

提示

  • 平台下发指令主题:/{productId}/{deviceNum}/function/get
  • 服务端订阅采用通配符,订阅所有设备
/{productId}/{deviceNum}/function/get         发布属性/功能
/{productId}/{deviceNum}/status/post          发布设备状态
/{productId}/{deviceNum}/ntp/get              发布时钟同步
/{deviceNum}/http/upgrade/set                 发布OTA升级HTTPS方式()
/{deviceNum}/fetch/upgrade/set                发布OTA升级二进制包方式()
/{productId}/{deviceNum}/upgrade/get          发布OTA升级(旧)

/+/+/info/post                                订阅设备信息
/+/+/ntp/post                                 订阅时钟同步
/+/+/event/post                               订阅事件
/+/+/property/post                            订阅属性/功能
/{deviceNum}/http/upgrade/reply               订阅OTA升级HTTPS方式()
/{deviceNum}/fetch/upgrade/reply              订阅OTA升级二进制包方式()
/+/+/upgrade/reply                            订阅OTA升级(旧)

# 遗弃
/{productId}/{deviceNum}/property/get         发布属性(遗弃)
/+/+/function/post                            订阅功能(遗弃)
/+/+/property-offline/post                    订阅属性(遗弃,影子模式)
/+/+/function-offline/post                    订阅功能(遗弃,影子模式)

二、设备端主题

提示

设备段主要上报状态和指令,订阅平台下发的指令:

  • /{productId}/{deviceNum}/property/post 发布属性/功能
  • /{productId}/{deviceNum}/function/get 订阅属性/功能
/{productId}/{deviceNum}/property/post        发布属性/功能
/{productId}/{deviceNum}/event/post           发布事件
/{productId}/{deviceNum}/monitor/post         发布实时监测数据 
/{productId}/{deviceNum}/info/post            发布设备信息
/{productId}/{deviceNum}/ntp/post             发布时钟同步
/{deviceNum}/http/upgrade/set                 发布OTA升级HTTPS方式()
/{deviceNum}/fetch/upgrade/set                发布OTA升级二进制包方式()
/{productId}/{deviceNum}/upgrade/reply        发布OTA升级(旧)

/{productId}/{deviceNum}/function/get         订阅属性/功能
/{productId}/{deviceNum}/info/get             订阅设备信息
/{productId}/{deviceNum}/ntp/get              订阅时钟同步
/{productId}/{deviceNum}/ota/get              订阅设备升级(旧)
/{productId}/{deviceNum}/monitor/get          订阅实时监测  (返回实时监测的次数和间隔)
/{deviceNum}/http/upgrade/reply               订阅OTA升级HTTPS方式()
/{deviceNum}/fetch/upgrade/reply              订阅OTA升级二进制包方式()
/{productId}/{deviceNum}/upgrade/get          订阅OTA升级(旧)

# 遗弃
/{productId}/{deviceNum}/function/post        发布功能(遗弃)
/{productId}/{deviceNum}/property/get         订阅属性(遗弃)
/{productId}/{deviceNum}/property-online/get  订阅属性,在线模式(遗弃)
/{productId}/{deviceNum}/function-online/get  订阅功能,在线模式(遗弃)

三、用户端(网页端/小程序/App)主题

提示

用户端主要是界面实时显示,包括设备状态和物模型指令

  • /{productId}/{deviceNum}/ws/service 订阅属性/功能(mqtt over websocket)
  • /{productId}/{deviceNum}/status/post 订阅设备状态(终端订阅)
/{productId}/{deviceNum}/monitor/get               发布实时监测 (实时监测的次数和间隔)                           
/{productId}/{deviceNum}/ota/get                   发布设备升级(旧)

/{productId}/{deviceNum}/ws/service                订阅属性/功能(mqtt over websocket)
/{productId}/{deviceNum}/status/post               订阅设备状态(终端订阅)
/{productId}/{deviceNum}/monitor/post              订阅实时监测数据             
/{taskId}/ws/ota/status                            订阅ota升级状态             

# 遗弃
/{productId}/{deviceNum}/function/post             订阅功能(遗弃)
/{productId}/{deviceNum}/property-online/get       发布属性,在线模式(遗弃)
/{productId}/{deviceNum}/function-online/get       发布功能,在线模式(遗弃)
/{productId}/{deviceNum}/property-offline/post     发布属性(遗弃,影子模式,用户端为主)
/{productId}/{deviceNum}/function-offline/post     发布功能(遗弃,影子模式,用户端为主)