设备接入 IoTDA设备接入 IoTDA

更新时间:2021/09/06 GMT+08:00
分享

设备侧MQTT接口差异说明

本章节描述物联网平台设备侧MQTT接口新版本和老版本的具体差异。

老版本(即V3版本)设备侧MQTT接口指设备侧MQTT接口参考,新版本(即V5版本)设备侧MQTT接口指设备侧MQTT接口参考

请求访问地址

v3版本接口请求访问地址

v5版本请求访问地址

差异说明

“host:port”:承载REST服务端点的服务器地址,格式为“host:port”,其中host为服务器的访问域名或IP,port为服务器的访问端口。

您可以参考平台对接信息获取应用的接入地址和端口信息。

例如设备接入服务在“华北-北京四”区域的HTTPS/MQTT/MQTTS设备对接地址为“iot-acc.cn-north-4.myhuaweicloud.com”

“Endpoint”:指定承载REST服务端点的服务器域名或IP,不同服务不同区域的Endpoint不同,您可以从地区和终端节点中获取。

例如设备接入服务在“华北-北京四”区域的MQTT/MQTTS设备接入地址为“iot-mqtts.cn-north-4.myhuaweicloud.com”,HTTPS设备接入地址为“iot-https.cn-north-4.myhuaweicloud.com ”。

新版本中HTTPS接入域名不支持原AgentLite SDK的设备绑定、登录接入。新版本SDK推荐直接使用MQTT/MQTTS接入。

MQTT/MQTTS设备侧接入域名做了变更,域名要匹配证书/SDK使用。不支持v3域名搭配v5 SDK/证书混用的情况。

v3版本:

HTTPS iot-acc.cn-north-4.myhuaweicloud.com 8943

MQTT iot-acc.cn-north-4.myhuaweicloud.com 1883

MQTTS iot-acc.cn-north-4.myhuaweicloud.com 8883

v5版本:

HTTPS iot-https.cn-north-4.myhuaweicloud.com 8943

MQTT iot-mqtts.cn-north-4.myhuaweicloud.com 1883

MQTTS iot-mqtts.cn-north-4.myhuaweicloud.com 8883

若使用新域名,则需要配套改造三个地方:设备侧MQTT新接入域名、新证书、TLS安全加密算法(若已支持不用切换)。若您选择继续使用老域名,可以不用改造。

  1. 如果设备侧使用的是SDK集成接入:请先下载最新版本的SDK代码(内置了安全加密算法和新证书),然后切换接入域名为新地址。
  2. 如果设备侧使用的是原生MQTT协议接入:请重新下载新的CA证书进行切换,然后确认是否使用了TLS的安全加密算法(JDK1.8版本以上或OpenSSL 1.0.2u/1.1.0版本以上是支持的不用切换),最后切换接入域名为新地址。

设备发送数据到物联网平台

功能

v3版本

v5版本

差异说明

设备消息上报

$oc/devices/{device_id}/sys/messages/up

新增功能,设备无法按产品模型中定义格式进行属性上报时,可以使用该功能进行自定义格式数据的上报。

设备属性上报

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

$oc/devices/{device_id}/sys/properties/report

1、topic风格进行了统一。

2、payload的JSON格式,改为按产品模型定义的属性格式进行上报。

网关批量设备属性上报

$oc/devices/{device_id}/sys/gateway/sub_devices/properties/report

新增功能,网关需要批量子设备数据一起上报时可以使用此功能。

设备影子数据查询

上行:

$oc/devices/{device_id}/sys/shadow/get/request_id={request_id}

下行:

$oc/devices/{device_id}/sys/shadow/get/response/request_id={request_id}

新增功能,设备侧可以使用此接口查询该设备的影子数据。

设备事件

$oc/devices/{device_id}/sys/events/up

新增功能,设备可通过此接口进行事件上报。

应用服务器下发指令给设备

功能

v3版本

v5版本

差异说明

平台命令下发

下行:

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

上行:

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

下行:$oc/devices/{device_id}/sys/commands/request_id={request_id}

上行:

$oc/devices/{device_id}/sys/commands/response/request_id={request_id}

1、topic风格进行了统一。

2、payload的JSON格式,改为按产品模型定义的命令格式进行控制命令下发。

平台消息下发

$oc/devices/{device_id}/sys/messages/down

新增功能,设备无法按产品模型中定义格式进行命令下发时,可以使用该功能进行自定义格式的控制指令下发。

设备属性设置

下行:

$oc/devices/{device_id}/sys/properties/set/request_id={request_id}

上行:

$oc/devices/{device_id}/sys/properties/set/response/request_id={request_id}

新增功能,平台可以通过此接口设置产品模型中定义的设备的属性数据。

设备属性查询

下行:

$oc/devices/{device_id}/sys/properties/get/request_id={request_id}

上行:

$oc/devices/{device_id}/sys/properties/get/response/request_id={request_id}

新增功能,平台可以通过此接口获取设备的属性数据。

设备事件下发

$oc/devices/{device_id}/sys/events/down

新增功能,平台可以通过此接口对设备进行属性下发。

分享:

    相关文档

    相关产品