OTA升级-华为云

设备接入 IOTDA-软固件包上传:概述

概述软件（Software）一般分为系统软件和应用软件，系统软件实现设备最基本的功能，比如编译工具、系统文件管理等；应用软件可以根据设备的特点，提供不同的功能，比如采集数据、数据分析处理等。软件升级又称为SOTA（SoftWare Over The Air），是指用户可以通过OTA的方式支持对LwM2M协议和MQTT协议的设备进行软件升级。基于LwM2M协议的产品模型，软件升级遵循的协议为PCP协议（PCP协议介绍），设备侧需要遵循PCP协议进行软件升级的适配开发，适配方法请参考设备侧适配开发指导。基于MQTT协议的产品模型，不校验软件升级协议类型。固件（Firmware）一般是指设备硬件的底层“驱动程序”，承担着一个系统最基础最底层工作的软件，比如计算机主板上的基本输入/输出系统BIOS（Basic Input/output System)。固件升级又称为FOTA（Firmware Over The Air），华为云用户可以通过OTA的方式对支持LwM2M协议和MQTT协议的设备进行固件升级。

设备接入 IOTDA OTA升级

设备接入 IOTDA-设备侧适配开发指导:上报升级结果

上报升级结果根据PCP协议约定的交互流程，设备在执行完软件升级后，将会向物联网平台上报升级的结果。设备发送的请求消息根据PCP消息结构的定义可以得出，设备向物联网平台上报升级结果，各个消息字段的填写如下：起始标识固定为：FFFE。版本号固定为：01。消息码：与请求的消息码一致，为18。校验码：CRC16计算前先用0000替代。数据区长度：根据数据区的字段的数据类型得出数据区长度为17字节，转换为十六进制为：0011。数据区：结果码，以上报升级成功为例，结果码为00。当前版本号：升级完成后的版本号，与物联网平台下发的软件版本一致，即v1.0，转换为十六进制为：56312E30000000000000000000000000。字段数据类型描述及要求结果码 BYTE 0X00升级成功。 0X01设备使用中。 0X04电量不足。 0X05剩余空间不足。 0X09内存不足。 0X0A安装升级包失败。 0X7F内部异常。当前版本号 BYTE[16] 设备当前版本号。设备向物联网平台上报升级结果的消息为：FFFE 01 18 0000 0011 0056312E30000000000000000000000000（CRC16校验前），经CRC16计算得到校验码为：C7D2。则替换校验码后设备向物联网平台上报升级结果码流为：FFFE0118C7D200110056312E30000000000000000000000000。物联网平台发送的应答消息物联网平台收到设备上报的升级结果消息后，将对设备进行应答，各个消息字段的填写如下。起始标识固定为：FFFE。版本号固定为：01。消息码：与请求的消息码一致：18。校验码：CRC16计算前先用0000替代。数据区长度：根据数据区的字段定义得出该数据长度为1个字节，转换为十六进制为：0001。数据区：处理成功，则返回00，升级任务不存在80。本示例以返回00处理成功为例进行说明。字段数据类型描述及要求结果码 BYTE 0X00处理成功。 0X80升级任务不存在。物联网平台向设备的应答消息为：FFFE 01 18 0000 0001 00 （CRC16校验前），经CRC16计算得到校验码为：AFA1。则替换校验码后物联网平台返回的应答消息为：FFFE0118AFA1000100 。

设备接入 IOTDA OTA升级设备侧适配

设备接入 IOTDA-设备侧适配开发指导:执行软件升级

执行软件升级根据PCP协议约定的交互流程，物联网平台收到设备发送的软件包下载结果通知后，需要通知设备进行升级操作。物联网平台发送的请求消息根据PCP消息结构的定义可以得出，物联网平台向设备发送执行软件升级消息，各个消息字段的填写如下：起始标识固定为：FFFE。版本号固定为：01。消息码：与请求的消息码一致，为17。校验码：CRC16计算前先用0000替代。数据区长度：根据数据区的字段的数据类型得出无数据区，即为0字节，转换为十六进制为：0000。数据区：无数据区，无需携带该字段。字段数据类型描述及要求无数据区物联网平台向设备下发的执行软件升级的消息为：FFFE 01 17 0000 0000（CRC16校验前），经CRC16计算得到校验码为：CF90。则替换校验码后物联网平台向设备发送的消息为：FFFE0117CF900000。设备发送的应答消息设备收到物联网平台下发的执行升级消息后，将对收到消息后的执行动作进行应答，各消息字段的填写如下。起始标识固定为：FFFE。版本号固定为：01。消息码：与请求的消息码一致：17。校验码：CRC16计算前先用0000替代。数据区长度：根据数据区的字段定义得出该数据长度为1个字节，转换为十六进制为：0001。数据区：处理成功，则返回00，其它处理结果请参考数据区定义。本示例以返回00处理成功为例进行说明。字段数据类型描述及要求结果码 BYTE 0X00处理成功。 0X01设备使用中。 0X04电量不足。 0X05剩余空间不足。 0X09内存不足。设备向物联网平台应答的消息为：FFFE 01 17 0000 0001 00 （CRC16校验前），经CRC16计算得到校验码为：B725。则替换校验码后设备返回的响应消息为：FFFE0117B725000100 。

设备接入 IOTDA OTA升级设备侧适配

设备接入 IOTDA-设备侧适配开发指导:上报下载结果

上报下载结果根据PCP协议约定的交互流程，设备接收完所有分片数据并组装完软件包后，需要向物联网平台上报软件包的下载结果。设备发送的请求消息根据PCP消息结构的定义可以得出，设备向物联网平台发送的上报软件包下载结果消息，各个消息字段的填写如下：起始标识固定为：FFFE。版本号固定为：01。消息码：与请求的消息码一致，为16。校验码：CRC16计算前先用0000替代。数据区长度：根据数据区的字段的数据类型得出数据区长度为1个字节，转换为十六进制为：0001。数据区：上报软件包的下载结果，比如下载成功，设备侧上报00。字段数据类型描述及要求下载状态 BYTE 0X00下载成功。 0X05剩余空间不足。 0X06下载超时。 0X07升级包校验失败。 0X08升级包类型不支持。设备向物联网平台发送升级包下载结果的消息为：FFFE 01 16 0000 0001 00（CRC16校验前），经CRC16计算得到校验码为：850E。则替换校验码后设备发送的升级包下载结果的消息为：FFFE0116850E000100。物联网平台的应答消息物联网平台收到设备上报的软件包下载结果后，将会向设备返回应答消息，各个消息字段的填写如下。起始标识固定为：FFFE。版本号固定为：01。消息码：与请求的消息码一致：16。校验码：CRC16计算前先用0000替代。数据区长度：根据数据区的字段定义得出该数据长度为1个字节，转换为十六进制为：0001。数据区：处理成功，则返回00，处理失败返回80。本示例以返回00处理成功为例进行说明。字段数据类型描述及要求结果码 BYTE 0X00处理成功。 0X80升级任务不存在。物联网平台向设备应答的消息为：FFFE 01 16 0000 0001 00 （CRC16校验前），经CRC16计算得到校验码为：850E。则替换校验码后物联网平台向设备应答的消息为：FFFE0116850E000100。

设备接入 IOTDA OTA升级设备侧适配

设备接入 IOTDA-设备侧适配开发指导:下载升级包

下载升级包根据PCP协议约定的交互流程，物联网平台通知设备有新的软件版本时，设备向物联网平台请求下载软件包，按照分片的序号进行下载。设备发送的请求消息根据PCP消息结构的定义可以得出，设备向物联网平台发送的请求软件包分片的第一条消息，各消息字段的填写如下。起始标识固定为：FFFE。版本号固定为：01。消息码：查询消息码表可知请求升级包的消息码为21，转换为十六进制为：15。校验码：CRC16计算前先用0000替代。数据区长度：根据数据区的字段的数据类型得出数据区长度为18个字节，转换为十六进制为：0012。数据区：目标版本号为平台下发的新版本通知版本号，即v1.0，转换为十六进制为56312E30000000000000000000000000，分片序号为第0个分片，即0000。字段数据类型描述及要求目的版本号 BYTE[16] 目的版本号，由ASCII字符组成，位数不足时，后补“0X00”。分片序号 WORD 表示请求获取的分片序号，从0开始计算，分片的总数为软件包大小除以每个分片的大小并向上取整获得。设备可以保存已经收到的分片，下次直接从缺失的分片开始请求，达到断点续传的效果。设备向物联网平台发送请求软件包分片的第一条消息为：FFFE 01 15 0000 0012 56312E30000000000000000000000000 0000（CRC16校验前），经CRC16计算得到校验码为：5618。则替换校验码后设备发送的第一条请求分片消息为：FFFE01155618001256312E300000000000000000000000000000。其它分片请求的消息流只需要替换分片序号后，重新计算并替换CRC16校验码即可，此处就不再展开。物联网平台的应答消息物联网平台收到设备的请求软件包分片消息后，将会给设备下发分片的数据。物联网平台向设备响应的第一条请求分片的消息，各消息字段的填写如下。起始标识固定为：FFFE。版本号固定为：01。消息码：与请求的消息码一致：15。校验码：CRC16计算前先用0000替代。数据区：先讲数据区再讲数据区长度。结果码：00，分片序号：第0个分片：0000，分片数据：跟软件包定义的内容有关，我们假设软件包内容为HELLO, IoT SOTA!，经ASCII码转换为十六进制为：48454C4C4F2C20496F5420534F544121，共16字节。用户上传软件包时手动输入升级包分片大小为500byte，即最大长度为500字节。这种情况下，无需在数据的后面补充0。数据区长度：根据数据区的字段定义得出该数据长度为19，转换为十六进制为：0013。字段数据类型描述及要求结果码 BYTE 0X00处理成功。 0X80升级任务不存在。 0X81指定的分片不存在。分片序号 WORD 表示返回的分片序号。分片数据 BYTE[n] 分片的内容，n为实际的分片大小。如果结果码不为0，则不带此字段。物联网平台向设备发送的第一个软件包分片消息为：FFFE 01 15 0000 0013 00 0000 48454C4C4F2C20496F5420534F544121（CRC16校验前），经CRC16计算得到校验码为：E107。则替换校验码后物联网平台向设备发送的第一个软件包分片消息为：FFFE0115E107001300000048454C4C4F2C20496F5420534F544121。其它软件包分片的消息流只需要替换分片序号和分片数据后，重新计算并替换CRC16校验码即可，此处就不再展开。

设备接入 IOTDA OTA升级设备侧适配

设备接入 IOTDA-设备侧适配开发指导:下载新版本软件包通知

下载新版本软件包通知根据PCP协议约定的交互流程，查询完版本号后，物联网平台下发指令让设备下载新版本的软件包。物联网平台发送消息根据PCP消息结构的定义可以得出，物联网平台向设备下发下载新版本软件包通知时，各消息字段的填写如下。起始标识固定为：FFFE。版本号固定为：01。消息码：此处为新版本通知，查询消息码表可以知道新版本通知为20，转换为十六进制为14。校验码：CRC16计算前先用0000替代。数据区长度：根据数据区的消息字段可以得出，数据区长度为22个字节，转换为十六进制为：0016。数据区：根据数据区的定义可知。目标版本号：由16个字节组成，假设升级的目标版本号为v1.0版本，转换为十六进制并在后面14个字节补充0后得到：56312E30000000000000000000000000。升级包分片大小：由2个字节组成，单位为byte，用户上传软件包时可以手动输入升级包分片大小，如果不设置默认为500byte，大小为32~500之间。假设为500byte，转换为十六进制后为：01F4。升级包分片总数：由2个字节组成，由软件包大小除以每个分片的大小并向上取整获得。假设软件包大小为500byte，则分片数量为1，转换为十六进制后为：0001。检验码：由2个字节组成，目前已废弃，固定为：0000。字段数据类型描述及要求目的版本号 BYTE[16] 目的版本号，由ASCII字符组成，位数不足时，后补“0X00”。升级包分片大小 WORD 每个分片的大小升级包分片总数 WORD 升级包分片总数升级包校验码 WORD 固定为：0000 将下载新版本软件包通知的消息流组合起来得到：FFFE 01 14 0000 0016 56312E30000000000000000000000000 01F4 0001 0000。前面说了，还要将消息流进行CRC16算法计算得到校验码为02F7。因此，物联网平台向设备通知下载新版本软件包的信息，物联网平台向设备发送的消息流为FFFE011402F7001656312E3000000000000000000000000001F400010000。设备返回的应答消息设备收到下载新版本软件包通知后，设备向物联网平台返回应答消息，是否允许设备进行升级，各消息字段的填写如下。起始标识固定为：FFFE。版本号固定为：01。消息码：与请求的消息码一致，为14。校验码：CRC16计算前先用0000替代。数据区长度：根据数据区的字段的数据类型得出数据区长度为1个字节，转换为十六进制为：0001。数据区：设备根据自身的情况对平台下发的新版本通知进行响应，本示例以设备应答“允许升级”为例进行介绍，得出数据区为：00。其它应答消息请根据应答消息字段进行适配。字段数据类型描述及要求结果码 BYTE “0X00”允许升级 “0X01”设备使用中 “0X02”信号质量差 “0X03”已经是最新版本 “0X04”电量不足 “0X05”剩余空间不足 “0X09”内存不足 “0X7F”内部异常将设备给物联网平台的应答消息流组合起来得到：FFFE 01 14 0000 0001 00。前面说了，还要将消息流进行CRC16算法计算得到校验码为D768。因此，设备向平台返回的应答消息流为FFFE0114D768000100。

设备接入 IOTDA OTA升级设备侧适配

设备接入 IOTDA-设备侧适配开发指导:概述

概述设备的OTA软件升级是基于华为定义的PCP协议进行的，设备侧需根据PCP协议定义的交互流程进行适配开发。下面我们将结合物联网平台与设备的软件升级交互流程，介绍终端设备将如何基于PCP协议构建交互过程中的请求消息和应答消息，帮助您更好的根据PCP协议进行终端侧的软件升级功能开发。下面我们先了解下PCP消息的结构，PCP协议的请求消息和应答消息都遵循相同的消息结构，主要由这几部分组成： PCP协议消息由：起始标识位、版本号、消息码、校验码、数据区长度和数据区组成，各字段的要求和描述如下表所示。字段名字段类型描述和要求起始标识 WORD 起始标识，固定为0XFFFE。版本号 BYTE 高四位预留；低四位表示协议版本号，当前为1。消息码 BYTE 标识物联网平台与设备之间的请求消息类型，应答消息的消息码和请求消息相同。消息码的定义为： 0-18：预留消息码，暂未使用。 19：查询设备版本。 20：下载新版本软件包通知。 21：请求下载升级包。 22：上报升级包下载结果。 23：执行软件升级。 24：上报升级结果。 25-127：预留消息码，暂未使用。校验码 WORD 从起始标识到数据区的最后一个字节的CRC16校验值，计算前先把校验码字段置为0，计算完成后把结果写到校验码字段。说明： CRC16算法：CRC16/CCITT x16+x12+x5+1 数据区长度 WORD 数据区的长度。数据区 BYTE[n] 可变长度，具体由各个指令定义，可参考下面介绍的各个指令对应的请求消息和应答消息定义。数据类型描述 BYTE 无符号一字节整数 WORD 无符号二字节整数 DWORD 无符号四字节整数 BYTE[n] n字节的十六进制数 STRING 字符串

设备接入 IOTDA OTA升级设备侧适配

设备接入 IOTDA-设备侧适配开发指导:查询设备版本号

查询设备版本号从设备的软件升级流程（本流程只描述物联网平台与设备基于PCP协议交互的流程）可以看到，首先物联网平台向设备下发查询版本号信息，设备进行应答。物联网平台发送消息根据PCP消息结构的定义可以得出，物联网平台向设备下发查询版本号时，各消息字段的填写如下：起始标识：固定为消息流的前2个字节，固定为FFFE。版本号：数据类型为1个字节整数，且固定为1，即在消息流中为01。消息码：数据类型为1个字节整数，查询设备版本的消息码为19，转换为十六进制为13。校验码：数据类型为2个字节整数，先将校验码置为0000，然后将完整的消息码流进行CRC16的算法计算得到校验码，再将得到的校验码替换原消息中的0000。数据区长度：数据类型为2个字节整数，代表数据区的消息长度，根据数据区的数据结构可以得出该条消息无数据区，即数据区长度为0000。数据区：数据区代表要真正发送给设备的数据，根据查询版本信息的数据区定义，该条消息是没有实际要传送的数据的，即无需数据区字段。字段数据类型描述及要求无数据区因此将查询版本消息的码流组合起来得到：FFFE 01 13 0000 0000。前面的校验码时讲了，需要将组合后的消息码流进行CRC16算法（物联网平台提供了基于JAVA和C语言的CRC16算法代码样例，您可以直接使用）得到校验码4C9A，然后将该校验码替换原码流中的0000后得到FFFE01134C9A0000，该消息码流即为物联网平台发送给设备的查询版本信息的消息码流。设备返回的应答消息设备收到物联网平台要查询设备的软件版本号消息，设备要向物联网平台反馈查询的结果，各消息字段的填写如下。起始标识固定为：FFFE。版本号固定为：01。消息码：与请求的消息码一致，为13。校验码：CRC16计算前先用0000替代。数据区长度：根据数据区的字段的数据类型得出数据区长度为17个字节，转换为十六进制为：0011。数据区：根据数据区的定义可知，处理成功的结果码为00，版本号信息假设为V0.9，将V0.9进行ASCII转码得到56302E39，由于版本号的数据类型为BYTE[16]，即16个字节，当前只有4个字节，因此需要在版本号数据后面补0，得到56302E39000000000000000000000000。因此，数据区合并后为0056302E39000000000000000000000000。字段数据类型描述及要求结果码 BYTE “0X00”处理成功当前版本号 BYTE[16] 当前版本号，由ASCII字符组成，位数不足时，后补“0X00”。将查询版本信息的消息流组合起来得到：FFFE 01 13 0000 0011 0056302E39000000000000000000000000。前面讲到，还要将消息流进行CRC16算法计算得到校验码为8DE3。因此，物联网平台向设备查询版本号信息，设备向平台返回的消息流为FFFE01138DE300110056302E39000000000000000000000000。

设备接入 IOTDA OTA升级设备侧适配

设备接入 IOTDA-删除OTA升级包:请求参数

请求参数表2 请求Header参数参数是否必选参数类型描述 X-Auth-Token 否 String 参数说明：用户Token。通过调用 IAM 服务获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id 否 String 参数说明：实例ID。物理多租下各实例的唯一标识，建议携带该参数，在使用专业版时必须携带该参数。您可以在IoTDA管理控制台界面，选择左侧导航栏“总览”页签查看当前实例的ID，具体获取方式请参考查看实例详情。

设备接入 IOTDA OTA升级包管理

设备接入 IOTDA-删除OTA升级包:URI

URI DELETE /v5/iot/{project_id}/ota-upgrades/packages/{package_id} 表1 路径参数参数是否必选参数类型描述 project_id 是 String 参数说明：项目ID。获取方法请参见获取项目ID 。 package_id 是 String 参数说明：升级包ID，用于唯一标识一个升级包。由物联网平台分配获得。取值范围：长度不超过36，只允许字母、数字、连接符（-）的组合。

设备接入 IOTDA OTA升级包管理

设备接入 IOTDA-删除OTA升级包:功能介绍

功能介绍用户可调用此接口删除关联OBS对象的升级包信息，不会删除OBS上对象使用前提：使用该API需要您授权设备接入服务 (IoTDA)的实例访问对象存储服务 (OBS)以及密钥管理服务(KMS Administrator)的权限。在“ 统一身份认证服务（IAM） - 委托”中将委托名称为iotda_admin_trust的委托授权KMS Administrator和OBS OperateAccess

设备接入 IOTDA OTA升级包管理

设备接入 IOTDA-创建OTA升级包:响应参数

响应参数状态码： 201 表6 响应Body参数参数参数类型描述 package_id String 参数说明：升级包ID，用于唯一标识一个升级包。由物联网平台分配获得。取值范围：长度不超过36，只允许字母、数字、连接符（-）的组合。 app_id String 参数说明：资源空间ID。取值范围：长度不超过36，只允许字母、数字、下划线（_）、连接符（-）的组合。 package_type String 参数说明：升级包类型。取值范围：软件包必须设置为：softwarePackage，固件包必须设置为：firmwarePackage。 product_id String 参数说明：设备关联的产品ID，用于唯一标识一个产品模型，创建产品后获得。方法请参见创建产品。取值范围：长度不超过36，只允许字母、数字、下划线（_）、连接符（-）的组合。 version String 参数说明：升级包版本号。取值范围：长度不超过256，只允许字母、数字、下划线（_）、连接符（-）、英文点（.）的组合。 support_source_versions Array of strings 参数说明：支持用于升级此版本包的设备源版本号列表。最多支持20个源版本号。取值范围：源版本号列表，源版本号只允许字母、数字、下划线（_）、连接符（-）、英文点（.）的组合。 description String 参数说明：用于描述升级包的功能等信息。取值范围：长度不超过1024。 custom_info String 参数说明：推送给设备的自定义信息。添加该升级包完成，并创建升级任务后，物联网平台向设备下发升级通知时，会下发该自定义信息给设备。取值范围：长度不超过4096。 create_time String 软固件包上传到物联网平台的时间，格式："yyyyMMdd'T'HHmmss'Z'"。 file_location FileLocation object 升级包的位置表7 FileLocation 参数参数类型描述 obs_location ObsLocation object 升级包关联OBS对象位置表8 ObsLocation 参数参数类型描述 region_name String 参数说明：OBS所在区域。您可以从地区和终端节点中查询服务的终端节点。取值范围：长度不超过256，只允许字母、数字、连接符（-）的组合。 bucket_name String 参数说明：OBS桶名称。取值范围：长度最小为3，最大为63，只允许小写字母、数字、连接符（-）、英文点（.）的组合。 object_key String 参数说明：OBS对象名称(包含文件夹路径)，对象大小最大为1G，且只支持.bin、.dav、.tar、.gz、.zip、.gzip、.apk、.tar.gz、.tar.xz、.pack、.exe、.bat、.img格式的文件。取值范围：长度不超过1024。最小长度：1 最大长度：1024 sign String 参数说明：SHA256算法计算出的升级包签名值。添加该升级包完成，并创建升级任务后，物联网平台向设备下发升级通知时，会下发该签名给设备。取值范围：长度为64，只允许大小写字母a到f、数字的组合。

设备接入 IOTDA OTA升级包管理

设备接入 IOTDA-创建OTA升级包:请求示例

请求示例创建OTA升级包，上传固件包。 POST https://{endpoint}/v5/iot/{project_id}/ota-upgrades/packages { "app_id" : "61f7e74d036aca5be29e1ed4", "package_type" : "firmwarePackage", "product_id" : "5ba24f5ebbe8f56f5a14f605", "version" : "V2.0", "description" : "package v2.0", "custom_info" : "更新了XX功能，修复了XXXX问题", "file_location" : { "obs_location" : { "region_name" : "cn-north-4", "bucket_name" : "abc", "object_key" : "bbb/upgrade.bin" } } } 创建OTA升级包，上传固件包，差分包场景，支持从V1.0和V1.1版本升级。 POST https://{endpoint}/v5/iot/{project_id}/ota-upgrades/packages { "app_id" : "61f7e74d036aca5be29e1ed4", "package_type" : "firmwarePackage", "product_id" : "5ba24f5ebbe8f56f5a14f605", "version" : "V2.0", "support_source_versions" : [ "V1.0", "V1.1" ], "description" : "package for version V1.0 and V1.1", "custom_info" : "更新了XX功能，修复了XXXX问题", "file_location" : { "obs_location" : { "region_name" : "cn-north-4", "bucket_name" : "abc", "object_key" : "bbb/upgrade.bin" } } }

设备接入 IOTDA OTA升级包管理

设备接入 IOTDA-创建OTA升级包:响应示例

响应示例状态码： 201 Created { "package_id" : "28f61af50fc9452aa0ed5ea25c3cc3d3", "app_id" : "61f7e74d036aca5be29e1ed4", "package_type" : "firmwarePackage", "product_id" : "5ba24f5ebbe8f56f5a14f605", "version" : "V2.0", "support_source_versions" : [ "V1.0", "V1.1" ], "description" : "package for version V1.0 and V1.1", "custom_info" : "更新了XX功能，修复了XXXX问题", "create_time" : "20230211T121212Z", "file_location" : { "obs_location" : { "region_name" : "cn-north-4", "bucket_name" : "abc", "object_key" : "bbb/upgrade.bin" } } }

设备接入 IOTDA OTA升级包管理

设备接入 IOTDA-创建OTA升级包:请求参数

请求参数表2 请求Header参数参数是否必选参数类型描述 X-Auth-Token 否 String 参数说明：用户Token。通过调用IAM服务获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id 否 String 参数说明：实例ID。物理多租下各实例的唯一标识，建议携带该参数，在使用专业版时必须携带该参数。您可以在IoTDA管理控制台界面，选择左侧导航栏“总览”页签查看当前实例的ID，具体获取方式请参考查看实例详情。表3 请求Body参数参数是否必选参数类型描述 app_id 是 String 参数说明：资源空间ID。存在多资源空间的用户需要使用该接口时，建议携带该参数指定创建的升级包归属到哪个资源空间下。取值范围：长度不超过36，只允许字母、数字、下划线（_）、连接符（-）的组合。 package_type 是 String 参数说明：升级包类型。取值范围：软件包必须设置为：softwarePackage，固件包必须设置为：firmwarePackage。 product_id 是 String 参数说明：设备关联的产品ID，用于唯一标识一个产品模型，创建产品后获得。方法请参见创建产品。取值范围：长度不超过36，只允许字母、数字、下划线（_）、连接符（-）的组合。 version 是 String 参数说明：升级包版本号。取值范围：长度不超过256，只允许字母、数字、下划线（_）、连接符（-）、英文点（.）的组合。 support_source_versions 否 Array of strings 参数说明：支持用于升级此版本包的设备源版本号列表。最多支持20个源版本号。取值范围：源版本号列表，源版本号只允许字母、数字、下划线（_）、连接符（-）、英文点（.）的组合。 description 否 String 参数说明：用于描述升级包的功能等信息。取值范围：长度不超过1024。最大长度：1024 custom_info 否 String 参数说明：推送给设备的自定义信息。添加该升级包完成，并创建升级任务后，物联网平台向设备下发升级通知时，会下发该自定义信息给设备。取值范围：长度不超过4096。最大长度：4096 file_location 是 FileLocation object 升级包的位置表4 FileLocation 参数是否必选参数类型描述 obs_location 否 ObsLocation object 升级包关联OBS对象位置表5 ObsLocation 参数是否必选参数类型描述 region_name 是 String 参数说明：OBS所在区域。您可以从地区和终端节点中查询服务的终端节点。取值范围：长度不超过256，只允许字母、数字、连接符（-）的组合。 bucket_name 是 String 参数说明：OBS桶名称。取值范围：长度最小为3，最大为63，只允许小写字母、数字、连接符（-）、英文点（.）的组合。 object_key 是 String 参数说明：OBS对象名称(包含文件夹路径)，对象大小最大为1G，且只支持.bin、.dav、.tar、.gz、.zip、.gzip、.apk、.tar.gz、.tar.xz、.pack、.exe、.bat、.img格式的文件。取值范围：长度不超过1024。最小长度：1 最大长度：1024 sign 否 String 参数说明：SHA256算法计算出的升级包签名值。添加该升级包完成，并创建升级任务后，物联网平台向设备下发升级通知时，会下发该签名给设备。取值范围：长度为64，只允许大小写字母a到f、数字的组合。

设备接入 IOTDA OTA升级包管理

云服务器内容精选

OTA升级

7*24

备案

专业服务

退订

建议反馈

售前咨询热线