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

前提条件

设备端已支持OTA升级功能。具体内容，请参见设备端Link SDK的OTA升级。

若添加包含多个文件的OTA升级包，设备端必须支持使用多个升级包文件发起的升级任务，进行OTA升级。具体内容，请参见多个文件的OTA升级。

重要 目前，仅C语言的设备端Link SDK支持开发多个文件的OTA升级功能。

背景信息

OTA升级的使用说明，请参见OTA升级概述。设备端进行OTA升级的流程，请参见设备端OTA升级。

操作步骤

  1. 登录物联网平台控制台。
  2. 在实例概览页面，找到对应的实例，单击实例进入实例详情页面。
    重要 目前华东2（上海）、华北2（北京）、华南1（深圳）地域开通了企业版实例服务。其他地域，请跳过此步骤。
    实例概览
  3. 在左侧导航栏，选择监控运维 > OTA升级。
    说明 为提供更好的服务，物联网平台改版了原OTA升级，新增了升级包版本统计功能。首次进入改版后的OTA升级页面时，您需要手动将之前上传的升级包与产品进行关联。升级包与产品一一对应，一个升级包只能关联一个产品。详情请参见控制台指引。
  4. （可选）若您的设备搭载了AliOS Things芯片，可以开启安全升级功能。

    安全升级是保证升级包完整性、机密性的一种方式，建议打开。使用安全升级功能，设备端需配合对升级包和升级包的签名进行验证。具体操作，请参见AliOS Things技术文档。

    1. 在OTA升级页面，单击安全升级。
    2. 在对话框中，设置待升级产品对应的安全升级按钮为开。
      当安全升级功能为开时，可单击对应的复制按钮，复制公钥，用于设备端验证签名。
  5. （可选）自定义OTA模块。
    OTA模块是同产品下设备的不同可升级模块，例如固件、软件、驱动等。默认（default）模块表示整个设备的固件，支持自定义其他OTA模块。

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

    参数 说明
    所属产品 选择模块所属产品。
    模块名称 设置模块名称。模块名称需要在产品下唯一，创建后不可修改。支持英文字母、数字、半角句号（.）、短划线（-）和下划线（_），长度限制为1~64个字符。
    模块别名 设置模块别名。支持英文字母、数字、半角句号（.）、短划线（-）和下划线（_），长度限制为4~64个字符。
    模块描述 可描述该模块的用途等信息。描述长度不超过100个字符，一个中文计为一个字符。
  6. 在OTA升级页面，单击升级包列表页签，单击添加升级包。
  7. 配置升级包信息，上传升级包文件，单击确认。
    参数 描述
    升级包类型
    • 整包：您上传的升级包文件是完整的升级包文件，会推送整包升级包给设备进行升级。
    • 差分：您上传的升级包文件仅包含新版本升级包与之前版本的差异部分，仅推送差异部分至设备，设备进行差分还原，还原为完整升级包。差分升级可有效减少升级对设备资源的占用，和减少下发升级包的流量消耗。

      使用AliOS Things芯片的设备，阿里云提供差分包生成方法和差分还原算法，请参见OTA差分工具使用指南。您也可以自行生成差分包并完成差分还原算法开发。

    升级包名称 设置升级包名称，需在阿里云账号下唯一，创建后不可修改。支持中文、英文字母、日文、数字、短划线（-）、下划线（_）和半角圆括号（()），必须以中文、英文、日文或数字开头，长度限制为1~40个字符。

    添加升级包成功后，可在升级包详情页面的升级包信息页签，单击编辑，修改升级包名称。

    所属产品 选择升级包所属产品。
    升级包模块 选择升级包所属OTA模块。

    您可以单击添加模块，在弹出的对话框中新增一个模块。

    升级包版本号 设置该升级包的版本号。版本号支持英文字母、数字、半角句号（.）、短划线（-）和下划线（_），长度限制为1~64个字符。

    升级包类型选择为整包时，需设置的参数。

    待升级版本号 输入或选择待升级设备的OTA模块版本号。下拉列表中，会展示当前产品下所有设备的OTA模块版本号，选择一个待升级的版本。

    升级包类型选择为差分时，需设置的参数。

    升级后版本号 设置该升级包的版本号。

    升级包类型选择为差分时，需设置的参数。

    签名算法 支持MD5和SHA256算法。

    当设备使用阿里云提供的Android SDK，且升级包类型选择为差分时，请选择MD5算法。

    上传升级包 上传升级包文件。最多支持上传20个文件，总文件大小不能超过1,000 MB。文件格式仅支持.bin、.dav、.tar、.gz、.zip、.gzip、.apk、.tar.gz、.tar.xz、.pack。

    上传多个升级包文件时，需注意：

    • 文件名称不能重复，单个文件名称长度不能超过32个字符。
    • 物联网平台会校验多个文件的签名是否一致，若文件签名一致，则视其为重复的文件。
    升级包是否需要平台验证 选择是否在批量升级前，使用少量测试设备对升级包进行验证。
    • 是：必须进行验证，验证通过后，才能进行批量升级。
    • 否：无需验证，直接进行批量升级。
    升级包描述 可描述该升级包的功能等信息。描述长度不超过1024个字符，一个中文计为一个字符。

    添加升级包成功后，可在升级包详情页面的升级包信息页签，单击编辑，修改升级包描述。

    推送给设备的自定义信息 添加该升级包完成，并创建升级任务后，物联网平台向设备推送升级通知时，会下发该自定义信息给设备。

    自定义信息的长度不超过4096个字符，内容和格式没有限制。

    添加升级包成功后，可在升级包详情页面的升级包信息页签，单击编辑，修改推送给设备的自定义信息。

    升级包安全检测服务 检测您上传的升级包的安全性。目前仅华东2（上海）的公共实例支持该服务。

    选择使用检测服务后，需输入您的邮箱地址，用于接收检测报告。

    完成添加升级包后，开始执行检测。在升级包详情页面的升级包信息页签下，升级包安全检测服务模块会展示检测状态和安全风险数。

    重要 若升级包中有多个文件，则不支持安全检测服务。

执行结果

升级包添加完成后，可在升级包列表查看，如图所示。

升级包列表

后续操作

若升级包中升级包是否需要平台验证选择了是，需先验证升级包。具体操作，请参见（可选）验证升级包。

否则，可直接向设备发起批量升级。具体操作，请参见发起升级批次任务。

可选：删除升级包

警告 OTA升级包被删除后，升级包对应的文件立即无法下载，会导致相关业务中断。请谨慎操作。
  1. 在升级包列表页签，单击升级包对应操作列的删除。
  2. 单击确认。

相关API

API 描述
GenerateOTAUploadURL 生成升级包文件上传到OSS的URL及详细信息。
CreateOTAFirmware 添加升级包。
CreateOTAModule 创建产品的OTA模块。
UpdateOTAModule 修改OTA模块别名、描述。
DeleteOTAModule 删除自定义OTA模块。
ListOTAModuleByProduct 查询产品下的OTA模块列表。
DeleteOTAFirmware 删除指定升级包。
ListOTAFirmware 查询升级包列表。

OTA相关API的更多信息，请参见OTA升级相关API。