检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
消息下发 概述 消息下发不依赖产品模型,提供给设备的单向通知,具有消息缓存功能;云端消息下发中,平台会以异步方式(消息下发后无需等待设备侧回复响应)下发消息给设备;若设备不在线,则在设备上线后发送数据(支持配置,最长缓存时间24小时)。平台对每个设备默认只保存20条消息,超过20
修改设备属性 功能介绍 设备的产品模型中定义了物联网平台可向设备下发的属性,应用服务器可调用此接口向指定设备下发属性。平台负责将属性以同步方式发送给设备,并将设备执行属性结果同步返回。 注意:此接口适用于MQTT设备,暂不支持NB-IoT设备。 调用方法 请参见如何调用API。 URI
创建产品-MQTT 下载模型文件,该模型文件已开发完毕(由开发产品模型开发完毕的产品模型导出)。详细开发过程指导请参考在线开发产品模型。 创建成功后,单击刚创建的产品,然后单击上传模型文件(无需解压,并且压缩包的名称不能有括号),上传刚下载的模型文件。 图3 上传产品模型-MQTT 创建设备
删除产品 功能介绍 应用服务器可调用此接口删除已导入物联网平台的指定产品模型。此接口仅删除了产品,未删除关联的插件,在产品下存在设备时,该产品不允许删除。 调用方法 请参见如何调用API。 URI DELETE /v5/iot/{project_id}/products/{product_id}
} 属性下发Java SDK使用示例 本部分介绍如何使用JAVA SDK进行属性配置的开发。SDK代码获取:SDK下载。本示例使用的开发环境为JDK 1.8及以上版本。 配置应用侧SDK步骤如下: 配置Maven依赖。 <dependency> <groupId>com.huaweicloud
功能介绍 用于平台设置设备属性。设备的产品模型中定义了平台可向设备设置的属性,平台可调用此修改设备属性接口设置指定设备的属性数据。设备收到属性设置请求后,需要将执行结果返回给平台,如果设备没回响应平台会认为属性设置请求执行超时。 低配置且资源受限或者对网络流量有要求的设备,不适合
查询设备属性 功能介绍 设备的产品模型中定义了物联网平台可向设备下发的属性,应用服务器可调用此接口向设备发送指令用以查询设备的实时属性, 并由设备将属性查询的结果同步返回给应用服务器。 注意:此接口适用于MQTT设备,暂不支持NB-IoT设备。 调用方法 请参见如何调用API。 URI
所属行业 根据实际情况进行选择。 设备类型 所属子行业 下载文件,获取产品模型文件样例。 在基本信息页面,单击“上传模型文件”,在弹出的页面中加载产品模型文件,然后单击“确定”。 图2 产品-上传产品模型 选择左侧导航栏的“设备 > 所有设备”,单击“注册设备”,填写设备注册参数
应用服务器可调用此接口新建设备组,一个华为云账号下最多可有1,000个设备组,包括父设备组和子设备组。设备组的最大层级关系不超过5层,即群组形成的关系树最大深度不超过5。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/device-group 表1 路径参数
的服务,请根据界面提示,配置云服务访问授权。 存储桶 选择要存储数据的桶。若没有,请前往OBS服务创建桶。 图3 新建转发目标-转发至OBS-JSON格式 单击“启动规则”,激活配置好的数据转发规则。 图4 启动规则-转发至OBS 验证操作 您可以使用配置设备接入服务时注册的真实设备接入平台,上报任意数据。
该场景主要描述的是应用侧或控制台可以给离线设备下发缓存命令,待设备上线后执行,控制台通过设备影子配置属性,待设备上线后上报的属性不匹配的话,会自动下发属性修改的指令,直至修改成功。 核心知识点:产品模型、编辑码插件、设备影子、属性上报、属性修改。 最佳实践参考:预置设备影子自动调节空调温度。
已经注册华为账号并开通华为云,具体可参考华为账号注册。 已开通设备接入服务。 已在管理控制台创建MQTT协议类型的产品、开发产品模型、新增设备。创建产品、开发产品模型和新增设备的具体操作细节,请参考创建产品、开发产品模型、注册单个设备或批量注册设备。 已建立设备和平台之间的连接。具体操作细节,请参考连接鉴权。 新增自定义Topic
拖动右侧“产品模型”区域的属性字段和命令字段(产品模型文件定义的字段),与编解码插件定义的数据上报消息和命令下发消息的相应字段建立映射关系。 图19 插件开发-在线开发插件 编解码插件与产品模型文件建立映射完成后,单击右上角“保存”,并单击“部署”,完成编解码插件的部署。 使用真实设备在线调试
选择“JSON” 所属行业 根据实际情况进行选择。 设备类型 单击文件,获取产品模型文件样例。 在基本信息页面,单击“上传模型文件”,在弹出的页面中加载产品模型文件,然后单击“确定”。 图2 产品-上传产品模型 选择左侧导航栏的“设备 > 所有设备”,单击“注册设备”,填写设备注册参数
参数说明:设备命令所属的设备服务ID,在设备关联的产品模型中定义。如设备需要编解码插件来解析命令,此参数为必填项。 取值范围:长度不超过64的字符串。 command_name 否 String 参数说明:设备命令名称,在设备关联的产品模型中定义。如设备需要编解码插件来解析命令,此参数为必填项。
SDK使用示例 本部分介绍如何使用JAVA SDK进行消息上报的开发。本示例使用的开发环境为JDK 1.8及以上版本。 配置设备侧SDK步骤如下: SDK代码获取:SDK下载。 配置设备侧SDK的Maven依赖。 <dependency> <groupId>com.huaweicloud</groupId>
需要通过数据转发规则转发到华为云其他云服务上进行存储和处理的场景。 使用限制 单个消息内容不大于256KB。 需要定义产品模型。 同步命令设备响应时间为20秒以内。 设备异步命令缓存数量为20个。 设备异步命令缓存时间支持配置,最长不超过48小时。 命令下发相关API接口 平台及应用侧API接口 下发同步设备命令
“数据类型”根据设备上报数据的实际情况进行配置,需要和产品模型相应字段的定义相匹配。产品模型中定义的火灾级别level属性的数据类型为int,最大值为9。所以选择的数据类型为int8u。 “偏移值”是根据字段位置和字段的字节数的配置自动填充的。“level”字段的起始位置就是前
功能描述 是指设备无法按照产品模型中定义的属性格式进行数据上报时,可调用此接口将设备的自定义数据格式上报给平台,平台对该消息不进行解析,该消息可以转发给应用服务器或华为云其他云服务上进行存储和处理。 消息上报和属性上报的区别,请查看消息通信说明。 低配置且资源受限或者对网络流量有要
否 String 参数说明:设备命令所属的设备服务ID,在设备关联的产品模型中定义。 取值范围:长度不超过64的字符串。 command_name 否 String 参数说明:设备命令名称,在设备关联的产品模型中定义。 取值范围:长度不超过128的字符串。 paras 是 Object