开发指南｜如何对产品进行OTA升级

随着物联网、云计算、AI等新技术融合发展，物联网深入应用到千行百业的生产、工作和运营中，实时互动的物联网设备也在改变着我们的生活和工作，能够实现各类设备间的有效通信、自动化、节省时间和成本等诸多好处，其市场继续以稳定的速度增长。

面对万物互通联动的频率不断提高，物联网设备也在不断与时俱进。新的产品需求不断涌现，对于智能家电、工业联网设备等产品更新需求就变得空前高涨，设备不能同传统设备一经出售就不再变更，为此OTA升级功能的应用就极为重要。

什么是OTA？OTA （Over-the-Air Technology），即空间下载技术，是手机终端通过无线网络下载远程服务器上的升级包，对系统或应用进行升级的技术。基于物联网平台支持通过OTA方式进行设备固件升级，是智能设备修复系统漏洞、实现系统升级的手段，通过固件升级用户提供更好的服务。OTA升级功能不仅能够更新固件，而且还能重新配置片上硬件资源。同时，设备固件可通过OTA升级流程获得更新的补丁和更多安全算法确保数据安全。

从长远来看，物联网设备产品具备和支持OTA升级能力是成为后续选型开发的一个关键技术指标。但由于OTA研发投入成本大、需要端+云+业务逻辑三方配合，过于碎片化和复杂化、同时涉及芯片、OS、连接和场景等多种方面，大部分企业会从性价比更多考虑使用第三方平台工具来完成OTA升级。机智云OTA升级服务为了让物联网设备的智能升级和远程服务提供服务通道，帮助企业开发各种功能更好地为客户提供个性化服务成为可能。机智云物联网推出OTA升级服务，可对设备固件远程升级，支持多种定向升级策略，解决设备出厂后的持续升级要求。并针对每一次设备固件升级，设定按批次、按地域、按原固件版本等条件进行远程推送，也可以设定一个时间段进行定时升级，让固件升级的同时不影响用户使用。

当设备连上云端时会收到OTA升级通知，再通过HTTP完成固件升级，帮助企业在项目进展过程中加速产品上线，在产品发布后方便的进行功能缺陷修复和产品性能优化，后续维护过程中也能及时导入新功能，增强产品体验，在提高售后效率的同时降低运维成本。

机智云的OTA服务主要提供以下功能：

◆OTA通知服务，即离线升级。当设备的固件程序有新版本发布，OTA 通知服务会推送升级通知到设备。

◆OTA透传服务，即在线升级。设备固件程序通过M2M消息服务透传到设备端。

◆支持一个产品同时有多个推送。

◆支持Wi-Fi/MCU升级。

◆支持推送全部设备。

◆支持定向升级设备。可指定设备mac地址、区域、旧固件版本进行推送。

◆支持定时推送。可自定义推送周期及推送时段。

◆OTA版本推送记录。

◆OTA进度统计分析。机智云OTA推送流程机智云OTA推送流程由五部分组成，分别是添加推送固件及规则、验证固件、开始推送、推送完成、查询结果。步骤一：创建OTA推送规则点击【添加】创建OTA推送规则及固件。步骤二：编辑推送内容支持的【固件类型】有：整包和差分包，填写【固件系列】和【版本号】，点击【上传固件】，可选Wi-Fi或MCU类型的固件。上传完成后点击【生成固件】。

可点击此处需下载GAgent OTA固件，如设备的模组烧写的固件为：GAgent_00ESP826_04020019_16101715.bin，则可填写固件系列为：00ESP826，版本号为：04020019。GAgent OTA固件下载：https://devdocs.gizwits.com/download.html#166394980598993?1667904134654

备注：所有汉枫WiFi模组OTA固件必须选择web版本，ESP 8266 WiFi模组OTA固件为“非combine文件”。如下图：

名称解释如下：

步骤三：验证固件生成固件后，此时固件为未验证状态。可以先返回固件推送列表验证固件，在固件状态未验证一栏点击【去验证】。验证固件是为了确保固件批量升级后设备能正常工作，请在批量升级前选择单台设备进行验证测试，防止将错误的固件升级到大量设备造成损失，验证通过后，才能新建推送规则。验证入口一：

验证入口二：

输入用于验证固件的设备【Mac】地址，点击【下一步】；

等待验证固件，验证完成后会自动跳转下一步。

固件验证通过后，点击【确认】。

验证固件后，点击【编辑】去新建推送规则。

点击【+添加规则】设置推送规则。

选择推送方式。推送方式分为“用户手动升级（APP内确认升级）”和“云端下发升级”。

名称解释如下：

云端下发升级可以选择推送全部设备或指定设备Mac地址/设备所在地区，同时支持设置推送周期及推送时段，设置完成点击【保存】即可成功创建一条推送规则。

按Mac推送：指定设备MAC，填入目标推送设备的Mac信息，如有多个空格隔开。

按地区推送：选择目标推送设备区域，如“China-Guangdong-Guangzhou”。

按旧固件推送：有旧固件的时候，也支持推送根据旧固件设置推送规则。

备注（重要）：1）设备在推送周期内&推送时段内，且在线状态下，机智云将发送OTA推送通知。每日发送OTA推送通知次数为一次。设备收到通知后，主动下载OTA推送固件。2）设备重新上电，设备都将主动询问机智云是否有推送任务。若符合推送周期&推送时段&目标设备，等推送条件，设备主动下载OTA推送固件。3）同一固件支持创建多条不同的推送规则。每创建一条新规则会生成新的流水号，根据流水号可以查询到推送的详情。4）有推送的目标设备才能创建成功规则。

5）UTC ：协调世界时（英：Coordinated Universal Time，法：Temps Universel Coordonné），又称世界统一时间，世界标准时间，国际协调时间。推送页面中，机智云自动将UTC时间映射为本地（北京）推送时间。

保存成功后会生成一条推送流水号，目标设备指的是推送成功数/设备总数，点击【开始推送】即可推送规则。

自行阅读并勾选「已经自行验证固件稳定性」和「机智云平台服务条款」协议后，点击【确定】。

注意：如果先创建规则后再去验证固件，在验证固件的过程中，若当前验证的Mac地址的设备包含在已创建的规则中，则验证成功固件后，该规则的目标设备总数会减1。

推送完成后，可以刷新状态查看推送成功的目标设备。相同固件相同规则只能推送一次，若有编辑的内容时，可再次推送。

推送完成后，可在固件推送列表中查看到状态更新。

步骤四：查看推送记录

选择OTA-【推送记录】，查看所有规则的推送记录，可以根据流水号查看推送详情。点击【详情】可查看推送结果明细。

查看推送结果明细，可查看Mac、did、推送状态、更新时间、操作人和操作时间等。点击【展开/收起】可查看相同did的不同状态。点击下载图标可下载任意7天内的推送历史记录。

步骤五：版本分布

选择OTA-【版本分布】，可查看版本分布详情。