推送固件到设备端

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

1. 登录物联网平台控制台。
2. 在左侧导航栏，选择监控运维 > 固件升级。
   说明 为提供更好的服务，物联网平台改版了原固件升级，新增了产品版本统计功能。首次进入改版后的固件升级页面时，您需要手动将之前上传的固件与产品进行关联。固件与产品一一对应，一个固件只能关联一个产品。详情请参见控制台指引。
3. （可选）若您的设备搭载了AliOS Things芯片，可以开启安全升级功能。

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

   1. 在固件升级页，单击安全升级。
   2. 在对话框中，将待升级产品对应的安全升级按钮设置为开。
      当安全升级功能为开时，可单击对应的复制按钮，复制公钥，用于设备端验证签名。
4. 在固件升级页，单击新增固件。
5. 在添加固件对话框中，输入固件信息，单击确定，上传固件文件。

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

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

   参数	描述
   待升级版本号	下拉选项框中，展示当前产品下所有设备的固件版本号，选择一个或者多个待升级的固件版本。 选择待升级版本号后，使用这些固件版本的设备将展示在待验证设备列表中。
   待验证设备	选择用于此次测试的设备。
   设备升级超时时间	设置单个设备的升级超时时间，即多长时间之后，升级未完成则为超时。从设备第一次上报升级进度开始计算时间。可选值范围：1分钟~1,440分钟。

7. 固件验证通过后，单击批量升级按钮，设置参数。单击确定，批量向设备推送升级通知。

   参数	描述
   待升级版本号	下拉选项框中，展示当前产品下所有设备的当前固件版本号，从中选择待升级的固件版本。 整包升级时，需设置该参数。
   升级策略	静态升级：仅升级当前满足升级条件的设备。 动态升级：除了升级当前满足升级条件的设备，还将持续检查设备是否满足升级条件，对满足升级条件的设备进行升级。包括但不限于以下情况： 后续新激活的设备满足升级条件。 设备当前上报的固件版本号不满足升级条件，后续上报了满足升级条件的固件版本号。 说明 一个固件下只能有一个动态升级批次。如果固件下已有一个动态升级批次，将不能创建新的动态升级，需先取消原有动态升级批次。
   升级范围	全部设备：升级该产品下的全部设备。 定向升级：选择为定向升级后，下方出现设备范围选项框。单击选项框，在右侧弹出的对话框中，选择要升级的设备。仅升级被选中的设备。 说明 定向升级的待升级版本为多选。默认选中您之前已输入的待升级版本号。 区域升级：升级实际地理位置在指定区域的设备。选择为区域升级后，下方出现指定区域的省份和城市选项框。 灰度升级：即局部升级。升级策略选择为静态升级时出现的可选项。 选择为灰度升级后，下方出现灰度范围输入框，需针对已选择的设备，设置灰度百分比。物联网平台根据设置的灰度百分进行计算，计算结果向下取整。灰度升级的设备至少为1个。
   升级时间	指定设备固件升级的时间。 立即升级：立即进行固件升级。 定时升级：设置升级开始时间、升级结束时间。升级开始时间距当前时间最少5分钟，最多7天。升级结束时间距开始时间最少1小时，最多为30天，可不设置，不设置表示不会强制结束。 说明 仅当升级策略为静态升级时，支持定时升级。
   固件推送速率	设置每分钟向多少个设备推送固件下载URL。取值范围：10~1,000。
   升级失败重试间隔	如果升级失败，在什么时候进行重试升级。可选： 不重试 立即重试 10分钟后重试 30分钟后重试 1小时后重试 24小时后重试
   升级重试上限次数	选择升级失败后，最多可重试几次。可选： 1次 2次 5次
   设备升级超时时间	设置单个设备的升级超时时间，即多长时间之后，升级未完成则为超时。从设备第一次上报升级进度开始计算时间。可选值范围：1分钟~1,440分钟。
   是否覆盖设备之前的升级任务	选择是否对同一待升级版本号，覆盖之前的升级任务。不覆盖升级中的任务。
   是否仅对新上报版本的设备生效	当升级策略选择为动态升级时的参数。 选择是否仅对上报新版本号的设备生效，待升级版本号以上报的新版本号为准。