Help Center> IoT Device Access> API Reference> 历史API> 设备侧MQTT接口参考> 使用前必读
View PDF

使用前必读

MQTT概述

MQTT消息由固定报头（Fixed header）、可变报头（Variable header）和有效载荷（Payload）三部分组成。

其中固定报头（Fixed header）和可变报头（Variable header）格式的填写请参考MQTT标准规范，有效载荷（Payload）的格式由应用定义，即设备和物联网平台之间自己定义。

MQTT的语法和接口细节，请以MQTT标准规范为准。平台目前只支持MQTTS接入。

常见MQTT消息类型主要有CONNECT、SUBSCRIBE、PUBLISH。

  • CONNECT：指客户端请求和服务端连接。有效载荷（Payload）的主要参数，参考MQTT CONNECT连接鉴权填写。
  • SUBSCRIBE：指客户端订阅请求。有效载荷（Payload）中的主要参数“Topic name”，参考Topic说明中订阅者为设备的Topic。
  • PUBLISH：平台发布消息。
    • 可变报头（Variable header）中的主要参数“Topic name”，指设备上报到物联网平台时发布者为设备的Topic。详细请参考Topic说明。
    • 有效载荷（Payload）中的主要参数为完整的数据上报和命令下发的消息内容，目前是一个JSON对象。

Topic说明

  • 物联网平台作为消息接收方时，已默认订阅了相关Topic，设备只要向对应Topic发送消息，物联网平台就可以接收。
  • 设备作为消息接收方时，需要先订阅相关Topic，这样物联网平台向对应Topic发送消息时，设备才能接收到。设备需要根据具体实现的业务来决定订阅哪些Topic。

Topic

消息发送方

（Publisher）

消息接收方

（Subscriber）

说明

/huawei/v1/devices/{deviceId}/data/{codecMode}

设备

物联网平台

设备向物联网平台上报数据。

  • “codecMode”为订阅的编解码类型，当用户使用自身开发的编解码插件时“codecMode”取值为“binary”，没有开发编解码插件的“codecMode”取值为“json”。
  • “deviceId”的值，对一机一密设备，使用deviceId接入时填写为设备注册成功后返回的“deviceId”值；使用nodeId接入时填写为设备注册成功时的“nodeId”值。

/huawei/v1/devices/{deviceId}/command/{codecMode}

物联网平台

设备

设备接收物联网平台下发的命令。

  • “codecMode”为订阅的编解码类型，当用户使用自身开发的编解码插件时“codecMode”取值为“binary”，没有开发编解码插件的“codecMode”取值为“json”。
  • “deviceId”的值，对一机一密设备，使用deviceId接入时填写为设备注册成功后返回的“deviceId”值；使用nodeId接入时填写为设备注册成功时的“nodeId”值。

设备注册

一机一密设备支持通过以下两种方式在物联网平台进行注册：

  • 调用API注册设备

    通过注册设备（密码方式）接口在物联网平台进行一机一密设备注册，注册成功会返回设备“deviceId”和“secret”。

  • 在控制台注册设备

    选择“设备管理 > 设备 > 设备注册 > 单个注册”，点击“创建”，根据页面内容填写设备信息，注册成功后返回设备“deviceId”和“secret”。