更新时间:2025-08-13 GMT+08:00

功能支持

SDK面向运算、存储能力较强的嵌入式终端设备,开发者通过调用SDK接口,便可实现设备与物联网平台的上下行通讯。SDK当前支持的功能有:

表1 功能支持列表

功能

描述说明

设备初始化

作为客户端使用MQTT协议接入到华为云平台。分为密钥认证和证书认证两种认证方式。

断线重连

设备连接失败或网络不稳定等原因导致被动断开连接时,会进行一个重连操作。

消息上报、下发

消息上报用于设备将自定义数据上报给平台,平台将设备上报的消息转发给应用服务器或华为云其他云服务上进行存储和处理,消息下发用于平台向设备下发消息,设备对收到的消息进行处理。

属性上报、设置、查询

属性上报用于设备按产品模型中定义的格式将属性数据上报给平台。属性设置用于平台设置设备属性。设备收到属性设置请求后,需要将执行结果返回给平台。属性查询用于平台查询设备的属性,设备收到属性查询请求后,需要将设备的属性数据返回给平台

命令下发

用于平台向设备下发设备控制命令。平台下发命令后,需要设备及时将命令的执行结果返回给平台。

获取设备影子

用于设备向平台获取设备影子数据。

软固件(OTA)升级

用于与平台配合下载OTA升级包。

时间同步

设备向平台发起时间同步请求。

网关与子设备

网关设备:通过平台支持的协议,直接连接到平台的设备。子设备:针对未实现TCP/IP协议栈的设备,由于无法直接同物联网平台通信,它需要通过网关进行数据转发。当前仅支持通过mqtt协议直连到平台的设备作为网关设备。

文件上传、下载

华为物联网平台支持设备将运行日志,配置信息等文件上传至平台,便于用户进行日志分析、故障定位、设备数据备份等。当设备采用HTTPS方式将文件上传到OBS服务进行备份时,您可以在OBS服务管理已上传的设备文件。

端侧规则

通过条件触发,基于预设的规则,引发多设备的协同反应,实现设备联动、智能控制。目前物联网平台支持两种联动规则:云端规则和端侧规则。

设备发放

分为证书认证、密钥认证。主要用于分发到不同局点、实例的场景,动态完成不同批次设备初始化配置。

面向物模型编程

面向物模型编程指的是,基于SDK提供的物模型抽象能力,设备代码只需要按照物模型定义设备服务,SDK就能自动的和平台通讯,完成属性的同步和命令的调用。

相比直接调用客户端接口和平台进行通讯,面向物模型编程简化了设备侧代码的复杂度,让设备代码只需要关注业务,而不用关注和平台的通讯过程。

泛协议接入

当非HTTP、MQTT、LWM2M等第三方协议接入时,需要在平台外部完成协议转换。推荐使用网关来完成协议转换,将第三方协议转成MQTT协议。