添加升级包

更新时间：2024-09-12 06:23:50

物联网设备进行OTA升级，需先在物联网平台为对应产品添加升级包。本文介绍添加升级包的具体操作步骤。

前提条件

设备端已支持OTA升级功能。
若添加包含多个文件的OTA升级包，设备端必须支持使用多个升级包文件发起的升级任务，进行OTA升级。

背景

1、选择目标物联网实例
2、登录物联网平台
3、在左侧导航栏，选择监控运维>OTA升级
4、自定义OTA模块（可选）
OTA模块是同产品下设备的不同可升级模块，例如固件、软件、驱动等。默认（default）模块表示整个设备的固件，支持自定义其他OTA模块。

在模块列表页签，单击添加模块，配置模块信息，单击确认。

参数	说明
所属产品	选择模块所属产品
模块名称	设置模块名称。模块名称需要在产品下唯一，创建后不可修改。支持英文字母、数字、半角句号（.）、短划线（-）和下划线（_），长度限制为1~64个字符。
模块别名	设置模块别名。支持英文字母、数字、半角句号（.）、短划线（-）和下划线（_），长度限制为4~64个字符。
模块描述	可描述该模块的用途等信息。描述长度不超过100个字符，一个中文计为一个字符。

5、在OTA升级页面，单击升级包列表页签，单击添加升级包
6、配置升级包信息，上传升级包文件，单击确认

参数	描述
升级包类型	整包：您上传的升级包文件是完整的升级包文件，会推送整包升级包给设备进行升级。
升级包名称	设置升级包名称，需在阿里云账号下唯一，创建后不可修改。支持中文、英文字母、日文、数字、短划线（-）、下划线（_）和半角圆括号（()），必须以中文、英文、日文或数字开头，长度限制为1~40个字符。添加升级包成功后，可在升级包详情页面的升级包信息页签，单击编辑，修改升级包名称
所属产品	选择升级包所属产品。
升级包模块	选择升级包所属OTA模块。您可以单击添加模块，在弹出的对话框中新增一个模块。
升级包版本号	设置该升级包的版本号。版本号支持英文字母、数字、半角句号（.）、短划线（-）和下划线（_），长度限制为1~64个字符。升级包类型选择为整包时，需设置的参数。
待升级版本号	输入或选择待升级设备的OTA模块版本号。下拉列表中，会展示当前产品下所有设备的OTA模块版本号，选择一个待升级的版本。升级包类型选择为差分时，需设置的参数。
升级后版本号	设置该升级包的版本号。
签名算法	支持MD5和SHA256算法。
上传升级包	上传升级包文件。最多支持上传20个文件，总文件大小不能超过1,000 MB。文件格式仅支持.bin、.dav、.tar、.gz、.zip、.gzip、.apk、.tar.gz、.tar.xz、.pack。上传多个升级包文件时，需注意：1、文件名称不能重复，单个文件名称长度不能超过32个字符。2、物联网平台会校验多个文件的签名是否一致，若文件签名一致，则视其为重复的文件。
升级包是否需要平台验证	选择是否在批量升级前，使用少量测试设备对升级包进行验证。是必须进行验证，验证通过后，才能进行批量升级。否：无需验证，直接进行批量升级。
升级包描述	可描述该升级包的功能等信息。描述长度不超过1024个字符，一个中文计为一个字符。添加升级包成功后，可在升级包详情页面的升级包信息页签，单击编辑，修改升级包描述。
推送给设备的自定义信息	添加该升级包完成，并创建升级任务后，物联网平台向设备推送升级通知时，会下发该自定义信息给设备。自定义信息的长度不超过4096个字符，内容和格式没有限制。添加升级包成功后，可在升级包详情页面的升级包信息页签，单击编辑，修改推送给设备的自定义信息。

执行结果

添加升级包

后续操作

若升级包中升级包是否需要平台验证选择了是，需先验证升级包。
否则，可直接向设备发起批量升级。

删除升级包

1、在升级包列表页签，单击升级包对应操作列的删除。
2、单击确认。

上一篇推送升级包到设备端

下一篇验证升级包（可选）