检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
物联网平台根据升级的目标版本判断设备是否需要升级 。（第5步超时时间3分钟） 如果返回的固件版本信息与升级的目标版本信息相同，则升级流程结束，不做升级处理，升级任务置为成功。 如果返回的固件版本信息与升级的目标版本信息不同，且该版本号支持升级，则继续进行下一步的升级处理。 6~7
物联网平台向设备下发升级的命令，终端设备进行升级操作，升级完成后终端设备向物联网平台反馈升级结束。（等待设备上报升级结果和升级状态，超时时间为30分钟） 14～16. 物联网平台下发命令查询固件升级的结果，获取升级结果后，向终端设备取消订阅升级状态通知，并向控制台应用服务器通知升级的结果。
批量设备OTA升级 上传软固件包 创建批量设备软件、固件升级任务前需要上传软件升级包，平台支持两种方式上传软件、固件包： 应用服务器通过调用“创建OTA升级包”API接口，创建OTA升级包，详情请参考创建OTA升级包。 通过控制台，在软固件升级页面上传软件、固件升级包，详情请参考软固件包上传。
String 参数说明：SHA256算法计算出的升级包签名值。添加该升级包完成，并创建升级任务后，物联网平台向设备下发升级通知时，会下发该签名给设备。 取值范围：长度为64，只允许大小写字母a到f、数字的组合。 请求示例 创建OTA升级包，上传固件包。 POST https://{
参数解释： 设备的升级进度。 取值范围： 0到100。 version 必选 String 参数解释： 设备当前版本号（升级完成时上报的版本号要与上传软固件包时在平台设置的版本号一致）。 description 可选 String 参数解释： 升级状态描述信息，可以返回具体升级失败原因。
删除OTA升级包 功能介绍 用户可调用此接口删除关联OBS对象的升级包信息，不会删除OBS上对象 使用前提：使用该API需要您授权设备接入服务(IoTDA)的实例访问对象存储服务(OBS)以及 密钥管理服务(KMS Administrator)的权限。在“统一身份认证服务（IAM）
OTA升级 软固件包上传 NB-IoT设备OTA升级 MQTT设备OTA升级 批量设备OTA升级 父主题： 设备管理
} ] } 设备侧升级包下载指导 设备收到升级通知之后，通过HTTPS协议根据升级通知里面的URL下载升级包。基础版和标准版目前建议客户不校验证书可规避不能下载固件的问题。专享版如果需要校验证书，请提工单，后端帮忙配置域名。 请求方法 下载升级包的请求方法为：GET 请求消息头
String 参数说明：SHA256算法计算出的升级包签名值。添加该升级包完成，并创建升级任务后，物联网平台向设备下发升级通知时，会下发该签名给设备。 取值范围：长度为64，只允许大小写字母a到f、数字的组合。 请求示例 查询OTA升级包详情。 GET https://{endpo
description String 参数说明：用于描述升级包的功能等信息。 取值范围：长度不超过1024。 custom_info String 参数说明：推送给设备的自定义信息。添加该升级包完成，并创建升级任务后，物联网平台向设备下发升级通知时，会下发该自定义信息给设备。 取值范围：长度不超过4096。
软固件升级 平台下发获取版本信息通知 设备上报软固件版本 平台下发升级通知 设备上报升级状态 父主题： 设备侧MQTT/MQTTS接口参考
升级过程中，上报了升级结果后，下载升级包失败？ 平台下发升级包后，设备下载完升级包升级然后上报结果给平台。如果上报了升级结果，平台就认为升级完成。再次下载升级包就会失败。 查看升级任务详情显示设备升级超时失败？ 软固件升级分为多个阶段，不同的阶段有不同的超时时间，在超时时间内
图3 上传升级包-OBS文件 图4 上传升级包-本地文件 上传升级包后，填写升级包参数信息，单击“确定”完成升级包上传。 图5 上传升级包-OBS文件参数 图6 上传升级包-本地文件参数 升级包上传完成后会在"固件列表"中显示出来。 图7 软固件升级-固件列表 选择"升级任务"，在
协议和MQTT协议的设备进行固件升级。 操作步骤 华为物联网平台进行软固件升级，需要在console平台添加升级包。平台支持升级包关联OBS服务桶中对象和本地文件上传升级包两种方式。 升级包关联OBS服务桶中对象，升级包大小限制最大为1G，由于升级文件保存在OBS服务中，会产生额外的存储和下载费用。
OTA升级包管理 创建OTA升级包 查询OTA升级包列表 获取OTA升级包详情 删除OTA升级包 父主题： API
OTA升级设备侧适配 设备侧适配开发指导 PCP协议介绍 父主题： 设备侧开发
PCP协议介绍 平台升级协议（PCP协议）规定了设备和平台之间升级的通信内容与格式。 本协议规定设备和IoT平台（以下简称“平台”）之间的应用层升级协议（简称“PCP协议”），用于实现设备的升级。 通讯方式 PCP协议运行在应用层，底层可以是LwM2M/CoAP/MQTT或者其他非流式协议。
0-18：预留消息码，暂未使用。 19：查询设备版本。 20：下载新版本软件包通知。 21：请求下载升级包。 22：上报升级包下载结果。 23：执行软件升级。 24：上报升级结果。 25-127：预留消息码，暂未使用。 校验码 WORD 从起始标识到数据区的最后一个字节的CRC
ccessCode）进行认证鉴权，详细说明参考AMQP客户端接入说明。 访问控制 IoTDA支持通过IAM进行访问控制。IAM权限是作用于云资源的，IAM权限定义了允许和拒绝的访问操作，以此实现云资源权限访问控制。管理员创建IAM用户后，需要将用户加入到一个用户组中，IAM可以对
"v1.0", "fw_version": "v1.0" } }] } 父主题： 软固件升级
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
