推送升级包到设备端

物联网平台提供OTA升级与管理服务。首先确保设备端支持OTA服务，然后在控制台上传新的升级包，并将OTA升级消息推送给设备，设备即可在线升级。本文介绍如何在物联网平台控制台添加升级包、验证升级包和向设备批量推送升级包。

1. 登录物联网平台控制台。
2. 在实例概览页，找到对应的实例，单击实例进入实例详情页。
   
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. 配置升级包信息，上传升级包文件，单击确认。

   参数	描述
   升级包类型	整包：您上传的升级包文件是完整的升级包文件，将推送整包升级包给设备进行升级。 差分：您上传的升级包文件仅包含新版本升级包与之前版本的差异部分，仅推送差异部分至设备，设备进行差分还原，还原为完整升级包。差分升级可有效减少升级对设备资源的占用，和减少下发升级包的流量消耗。 以下情况，我们提供差分包生成方法和差分还原算法。您也可以自行生成差分包并完成差分还原算法开发。 使用Android SDK的设备，差分包生成方法和差分还原算法，请参见Android差分升级。 设备使用AliOS-Things芯片，请参见OTA差分工具使用指南。
   升级包名称	设置升级包名称。支持中文、英文字母、日文、数字、短划线（-）、下划线（_）和圆括号()，必须以中文、英文、日文或数字开头，长度限制为1~40个字符。
   所属产品	选择升级包所属产品。
   升级包模块	选择升级包所属OTA模块。 您可以单击新增模块，在弹出的对话框中新增一个模块。
   升级包版本号	设置该升级包的版本号。版本号支持英文字母、数字、点号（.）、短划线（-）和下划线（_），长度限制为1~64个字符。 升级包类型选择为整包时，需设置的参数。
   待升级版本号	输入或选择待升级设备的OTA模块版本号。下拉列表中，将展示当前产品下所有设备的OTA模块版本号，选择一个待升级的版本。 升级包类型选择为差分时，需设置的参数。
   升级后版本号	设置该升级包的版本号。 升级包类型选择为差分时，需设置的参数。
   签名算法	支持MD5和SHA256算法。 当设备使用阿里云提供的Android SDK，且升级包类型选择为差分时，请选择MD5算法。
   上传升级包	上传升级包文件。文件大小不能超过1,000 MB，仅支持.bin、.tar、.gz、.tar.gz、.zip、.gzip类型的文件。
   升级包描述	可描述该升级包的功能等信息。描述长度不超过100个字符，一个中文计为一个字符。
   升级包安全检测服务	检测您上传的升级包的安全性。目前仅华东2（上海）的公共实例支持该服务。 选择使用检测服务后，需输入您的邮箱地址，用于接收检测报告。 在升级包详情页的升级包信息页签下，安全检测栏将展示升级包安全检测状态和安全风险数量。

8. 在升级包列表中，单击升级包对应的验证按钮，配置参数后，单击确认，在一个或多个设备上进行升级包测试。
   说明 升级包上传至物联网平台后，必须使用少量设备对升级包进行验证。确认测试设备升级成功后，才能批量升级。

   参数	描述
   待升级版本号	整包升级时，该参数为非必选配置。 下拉列表中，展示当前产品下所有设备的除升级目标版本号外的其他版本号，您可以选择一个或者多个待升级的版本。选择后，相应的设备将作为待验证设备列表中的备选设备。 如不选择，表示对备选待验证设备的OTA模块当前版本不做限制。 差分升级时，该参数默认为已在添加升级包时配置的待升级版本号。
   待验证设备	选择用于此次测试的设备。
   设备升级超时时间	设置单个设备的升级超时时间，即多长时间之后，升级未完成则为超时。从设备第一次上报升级进度开始计算时间。可选值范围：1分钟~1,440分钟。

9. 升级包验证通过后，单击批量升级按钮，进行升级范围配置和升级策略配置，单击确定，批量向设备推送升级通知。

   参数	描述
   待升级版本号	整包静态升级时，该参数为非必选配置；整包动态升级时，为必选配置。当升级范围为定向升级时，不配置该参数。 下拉列表中，展示当前产品下所有设备的除升级目标版本号外的其他版本号，选择一个或者多个待升级的版本。 如不选择，表示对待升级设备的OTA模块当前版本不做限制。 差分升级时，该参数默认为添加升级包时配置的待升级版本号。
   升级方式	静态升级：仅升级当前满足升级条件的设备。 动态升级：除了升级当前满足升级条件的设备，还将持续检查设备是否满足升级条件，对满足升级条件的设备进行升级。包括但不限于以下情况： 后续新激活的设备满足升级条件。 设备当前上报的OTA模块版本号不满足升级条件，后续上报了满足升级条件的OTA模块版本号。 说明 一个升级包下只能有一个动态升级批次。如果升级包下已有一个动态升级批次，将不能创建新的动态升级，需先取消原有动态升级批次。
   升级范围	全部设备：升级该产品下满足升级条件的全部设备。 定向升级：仅升级被选中的设备。选择为定向升级后，提供两种设备选择方式： 手动勾选：从设备范围下拉列表选择要升级的设备。 文件上传：下载模板，填写、上传.csv格式的设备列表文件。单次最多包含10,000条记录。 区域升级：升级实际地理位置在指定区域的设备。选择为区域升级后，下方出现指定区域的省份和城市选项框。 灰度升级：即局部升级。升级方式选择为静态升级时出现的可选项。 选择为灰度升级后，下方出现灰度范围输入框，需针对已选择的设备，设置灰度百分比。物联网平台根据设置的灰度百分进行计算，计算结果向下取整。灰度升级的设备至少为1个。
   升级时间	指定设备OTA升级的时间。 立即升级：立即进行OTA升级。 定时升级：设置升级开始时间、升级结束时间。升级开始时间距当前时间最少5分钟，最多7天。升级结束时间距开始时间最少1小时，最多为30天，可不设置，不设置表示不会强制结束。 说明 仅当升级方式为静态升级时，支持定时升级。
   升级包推送速率	设置每分钟向多少个设备推送升级包下载URL。取值范围：10~1,000。
   升级失败重试间隔	如果升级失败，在什么时候进行重试升级。可选： 不重试 立即重试 10分钟后重试 30分钟后重试 1小时后重试 24小时后重试
   升级重试上限次数	选择升级失败后，最多可重试几次。可选： 1次 2次 5次
   设备升级超时时间	设置单个设备的升级超时时间，即多长时间之后，升级未完成则为超时。从设备第一次上报升级进度开始计算时间。可选值范围：1分钟~1,440分钟。
   是否覆盖设备之前的升级任务	由于一个设备同一时间只能在一个正在进行的升级批次中（设备处于待推送、已推送或升级中状态），需要选择是否覆盖设备之前的升级任务。 选择是，则设备只执行新的升级任务。 选择否，若设备已有升级任务，则只执行已有任务。 不覆盖升级中的任务，此时继续执行升级中的任务，不执行新的任务。
   是否仅对新上报版本的设备生效	当升级方式选择为动态升级时的参数。 选择是否仅对后续新上报版本号的设备生效，待升级版本号以新上报的新版本号为准。 选择是，则仅升级后续新上报版本号的设备。 选择否，则升级当前满足升级条件的设备，并持续检查后续新上报版本号的设备是否满足升级条件。
   批次标签	单击新增标签，在弹出的对话框中，输入标签的标签Key和标签Value，然后单击确认，为批次添加标签。批次创建后标签不可修改。 批次标签将在向设备推送升级通知时下发给设备。