设备侧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安全加密算法（若已支持不用切换）。若您选择继续使用老域名，可以不用改造。
- 如果设备侧使用的是SDK集成接入：请先下载最新版本的SDK代码（内置了安全加密算法和新证书），然后切换接入域名为新地址。
- 如果设备侧使用的是原生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 |
新增功能，平台可以通过此接口对设备进行属性下发。 |
Did this article solve your problem?
Thank you for your score！Your feedback would help us improve the website.