检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
物联网平台根据升级的目标版本判断设备是否需要升级 。（第5步超时时间3分钟） 如果返回的固件版本信息与升级的目标版本信息相同，则升级流程结束，不做升级处理，升级任务置为成功。 如果返回的固件版本信息与升级的目标版本信息不同，且该版本号支持升级，则继续进行下一步的升级处理。 6~7
物联网平台向设备下发升级的命令，终端设备进行升级操作，升级完成后终端设备向物联网平台反馈升级结束。（等待设备上报升级结果和升级状态，超时时间为30分钟） 14～16. 物联网平台下发命令查询固件升级的结果，获取升级结果后，向终端设备取消订阅升级状态通知，并向控制台应用服务器通知升级的结果。
图2 接入信息-自定义域名详情 在自定义域名界面，单击“添加域名”，根据参数说明配置自定义域名后单击“确定”。 图3 自定义域名-配置自定义域名 创建DNS记录；配置自定义域名后需要联系购买域名的厂商添加域名解析，以便自定义域名指向华为云IoTDA的接入点。您可以参考平台对接信息获取设备的接入点。
批量设备OTA升级 上传软固件包 创建批量设备软件、固件升级任务前需要上传软件升级包，平台支持两种方式上传软件、固件包： 应用服务器通过调用“创建OTA升级包”API接口，创建OTA升级包，详情请参考创建OTA升级包。 通过控制台，在软固件升级页面上传软件、固件升级包，详情请参考软固件包上传。
} ] } 设备侧升级包下载指导 设备收到升级通知之后，通过HTTPS协议根据升级通知里面的URL下载升级包。基础版和标准版目前建议客户不校验证书可规避不能下载固件的问题。专享版如果需要校验证书，请提工单，后端帮忙配置域名。 请求方法 下载升级包的请求方法为：GET 请求消息头
参数解释： 设备的升级进度。 取值范围： 0到100。 version 必选 String 参数解释： 设备当前版本号（升级完成时上报的版本号要与上传软固件包时在平台设置的版本号一致）。 description 可选 String 参数解释： 升级状态描述信息，可以返回具体升级失败原因。
OTA升级 软固件包上传 NB-IoT设备OTA升级 MQTT设备OTA升级 批量设备OTA升级 父主题： 设备管理
是否必选 参数类型 描述 project_id 是 String 参数说明：项目ID。获取方法请参见 获取项目ID 。 package_id 是 String 参数说明：升级包ID，用于唯一标识一个升级包。由物联网平台分配获得。 取值范围：长度不超过36，只允许字母、数字、连接符（-）的组合。
String 参数说明：SHA256算法计算出的升级包签名值。添加该升级包完成，并创建升级任务后，物联网平台向设备下发升级通知时，会下发该签名给设备。 取值范围：长度为64，只允许大小写字母a到f、数字的组合。 请求示例 创建OTA升级包，上传固件包。 POST https://{
String 参数说明：SHA256算法计算出的升级包签名值。添加该升级包完成，并创建升级任务后，物联网平台向设备下发升级通知时，会下发该签名给设备。 取值范围：长度为64，只允许大小写字母a到f、数字的组合。 请求示例 查询OTA升级包详情。 GET https://{endpo
description String 参数说明：用于描述升级包的功能等信息。 取值范围：长度不超过1024。 custom_info String 参数说明：推送给设备的自定义信息。添加该升级包完成，并创建升级任务后，物联网平台向设备下发升级通知时，会下发该自定义信息给设备。 取值范围：长度不超过4096。
软固件升级 平台下发获取版本信息通知 设备上报软固件版本 平台下发升级通知 设备上报升级状态 父主题： 设备侧MQTT/MQTTS接口参考
升级过程中，上报了升级结果后，下载升级包失败？ 平台下发升级包后，设备下载完升级包升级然后上报结果给平台。如果上报了升级结果，平台就认为升级完成。再次下载升级包就会失败。 查看升级任务详情显示设备升级超时失败？ 软固件升级分为多个阶段，不同的阶段有不同的超时时间，在超时时间内
上传升级包-OBS文件参数 图6 上传升级包-本地文件参数 升级包上传完成后会在"固件列表"中显示出来。 图7 软固件升级-固件列表 选择"升级任务"，在“固件升级”页签，单击“新建任务”按钮，填写参数信息，选择升级包，选择需要升级的设备，单击"立刻创建任务"。 图8 新建固件升级任务-Test_upgrade_1
热门问题 设备管理服务和设备接入服务合一后的差异点是什么？ 如何获取对接物联网平台的地址？ 如何获取新域名和老域名接入的地址/证书？ 新旧域名接入的鉴权方式有什么区别？ 命令/属性下发总是超时？ 应用侧如何获取appid和secret？ Java SDK中有多个demo，该参考哪一个demo？
认加密”时，会影响升级文件的下载。 图1 上传升级包-OBS文件 本地文件，请拖拽或者单击“添加文件”上传软固件升级包。 图2 上传升级包-本地文件 选择OBS对象或上传本地文件后，在升级包列表里面按照如下信息填写参数后，单击“确定”上传软件包。 图3 上传升级包-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
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
