检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
平台下发日志收集通知 Topic 下行: $oc/devices/{device_id}/sys/events/down 接口功能 用于平台下发日志收集通知给设备。 参数说明 字段名 必选/可选 类型 参数描述 services 可选 List<EventService> 参数解释：
软固件升级 平台下发获取版本信息通知 设备上报软固件版本 平台下发升级通知 设备上报升级状态 父主题： 设备侧MQTT/MQTTS接口参考
String 参数说明：SHA256算法计算出的升级包签名值。添加该升级包完成，并创建升级任务后，物联网平台向设备下发升级通知时，会下发该签名给设备。 取值范围：长度为64，只允许大小写字母a到f、数字的组合。 请求示例 查询OTA升级包详情。 GET https://{endpo
平台通知网关子设备新增 功能介绍 平台将该网关新增的子设备列表信息通知给网关设备。网关与子设备关系，请查看网关与子设备。 Topic 下行: $oc/devices/{device_id}/sys/events/down 参数说明 字段名 必选/可选 类型 参数描述 object_device_id
删除OTA升级包 功能介绍 用户可调用此接口删除关联OBS对象的升级包信息，不会删除OBS上对象 使用前提：使用该API需要您授权设备接入服务(IoTDA)的实例访问对象存储服务(OBS)以及 密钥管理服务(KMS Administrator)的权限。在“统一身份认证服务（IAM）
参数解释： 设备的升级进度。 取值范围： 0到100。 version 必选 String 参数解释： 设备当前版本号（升级完成时上报的版本号要与上传软固件包时在平台设置的版本号一致）。 description 可选 String 参数解释： 升级状态描述信息，可以返回具体升级失败原因。
description String 参数说明：用于描述升级包的功能等信息。 取值范围：长度不超过1024。 custom_info String 参数说明：推送给设备的自定义信息。添加该升级包完成，并创建升级任务后，物联网平台向设备下发升级通知时，会下发该自定义信息给设备。 取值范围：长度不超过4096。
平台下发配置通知 功能介绍 物联网平台向设备侧下发配置通知。物联网平台为用户提供远程配置功能，用户可以在不中断设备运行的情况下，远程更新设备的系统参数、运行参数等配置信息。例如：Windows的收银台机器，需要通过远程配置修改一些系统参数；车联网中的T-BOX，需要通过远程配置修改设备侧的一些数据上报频率等。
平台通知网关子设备删除 功能介绍 平台将该网关删除的子设备信息通知给网关设备。网关与子设备关系，请查看网关与子设备。 Topic 下行: $oc/devices/{device_id}/sys/events/down 参数说明 字段名 必选/可选 类型 参数描述 object_device_id
设备异步命令状态变更通知 功能介绍 应用服务器在调用物联网平台的创建规则触发条件（Resource:device.command.status，Event:update）、创建规则动作、修改规则触发条件接口配置并激活规则后，当命令状态变更时，物联网平台会向应用服务器推送通知消息。 URI
OTA升级 软固件包上传 NB-IoT设备OTA升级 MQTT设备OTA升级 批量设备OTA升级 父主题： 设备管理
图3 上传升级包-OBS文件 图4 上传升级包-本地文件 上传升级包后，填写升级包参数信息，单击“确定”完成升级包上传。 图5 上传升级包-OBS文件参数 图6 上传升级包-本地文件参数 升级包上传完成后会在"固件列表"中显示出来。 图7 软固件升级-固件列表 选择"升级任务"，在
升级过程中，上报了升级结果后，下载升级包失败？ 平台下发升级包后，设备下载完升级包升级然后上报结果给平台。如果上报了升级结果，平台就认为升级完成。再次下载升级包就会失败。 查看升级任务详情显示设备升级超时失败？ 软固件升级分为多个阶段，不同的阶段有不同的超时时间，在超时时间内
由于业务应用所在的网络不同，业务应用的访问地址也不同。 业务应用部署在公网时，业务应用的访问地址就是业务应用的公网IP:端口（或域名:端口）。 业务应用部署在局域网时，需要在业务应用配置网络穿透，生成业务应用的公网访问地址，具体配置自行从网上获取网络穿透工具的配置步骤。 不同通知类型的订阅，回调地址
协议和MQTT协议的设备进行固件升级。 操作步骤 华为物联网平台进行软固件升级，需要在console平台添加升级包。平台支持升级包关联OBS服务桶中对象和本地文件上传升级包两种方式。 升级包关联OBS服务桶中对象，升级包大小限制最大为1G，由于升级文件保存在OBS服务中，会产生额外的存储和下载费用。
OTA升级包管理 创建OTA升级包 查询OTA升级包列表 获取OTA升级包详情 删除OTA升级包 父主题： API
码的定义为： 0-18：预留消息码，暂未使用。 19：查询设备版本。 20：下载新版本软件包通知。 21：请求下载升级包。 22：上报升级包下载结果。 23：执行软件升级。 24：上报升级结果。 25-127：预留消息码，暂未使用。 校验码 WORD 从起始标识到数据区的最后一个
码的定义为： 0-18：预留消息码，暂未使用。 19：查询设备版本。 20：下载新版本软件包通知。 21：请求下载升级包。 22：上报升级包下载结果。 23：执行软件升级。 24：上报升级结果。 25-127：预留消息码，暂未使用。 校验码 WORD 从起始标识到数据区的最后一个
OTA升级设备侧适配 设备侧适配开发指导 PCP协议介绍 父主题： 设备侧开发
平台无法将子设备新增和删除的信息及时通知到网关设备。网关设备离线再上线时，可以通过此接口从平台同步这段时间内新增或者删除的子设备信息。新增的子设备信息会通过平台通知网关子设备新增接口通知网关设备，删除的子设备信息会通过平台通知网关子设备删除通知网关设备。网关与子设备关系，请查看网关与子设备。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
