设备升级（OTA）问题

本文档主要针对设备升级过程中遇到的一些常见问题，梳理出对应的问题排查指引，帮助您解决一些日常问题。更多详情，请参考 固件升级。

有没有固件 OTA 升级的时序图？

OTA升级需要配置什么？

请参考 固件升级。

设备升级失败？

• 设备升级过程中，设备出现断电、断网的情况
• 设备升级过程中，网络环境是否正常

OTA升级对网速有什么要求？

OTA升级网速最低要求20KB以上。

设备升级时，App端多长时间会判断超时？

App端每收到一个进度更新，超时时间会重新计时，其实也是受设备控制的；设备下载固件过程中断网的话，SDK会不断重连，如果长时间断网，那App就超时退出，升级失败，公版App超时时间为60s。

设备升级过程中设备状态显示为离线？

升级固件时设备会暂时离线，升级完成后会自动回连到网络。

烧录与固件升级有什么区别？

烧录可以对空模组进行烧录，或者烧录不同固件；固件升级只是对本身固件的一个升级， 固件升级前置条件必须是固件已经存在模组中。

Wi-Fi模组离线后重新上线对OTA有什么影响？

在超时时间内（60S），离线后再上线，会断点续传（从离线前下载进度开始），升级会继续的。

在 OTA 升级中，服务器是如何把固件下发到 Wi-Fi 模组的？这一环节有校验吗？

固件走HTTPS加密传输的，采用HMAC校验或MD5校验。

设备当前是1.0.0 版本 ，在后台配置App提醒升级 2.1.3 ，但是一直收不到升级提醒 是什么原因？

OTA 需要符合的几个点：

1. 设备激活固件KEY信息与配置的OTA信息固件KEY匹配。
2. 固件类型匹配，即固件升级通道号要一致。

查询办法：

先通过设备ID去查设备上报的KEY，通用设备日志查看设备详情可查询设备使用的固件KEY信息，如果上报KEY与Pid绑定的固件KEY不同的话，就收不到升级提示。

排查方向：

PID绑定的固件KEY发生了修改，但是此固件在换KEY之前出的设备，解决的操作方法可在PID管理页面绑定两个KEY可以实现升级操作。量产的产品让负责的产品经理去操作,也可以以技术工单的形式反馈给涂鸦。

我要做OTA压测怎么配置？

假设您现在是1.0.0版本。正常OTA时：需要在后台上传一个1.0.1版本的固件，这个1.0.1版本固件是真实编译出来的，然后配置固件升级，正常升级之后实际运行的固件版本就是1.0.1，并且App提示升级成功。如果需要OTA压测：那么上传的这个1.0.1版本固件是1.0.0版本的固件将文件名称改成1.0.1，1.0.1是假的固件版本，实际固件版本是1.0.0，升级完之后，实际运行的固件版本还是1.0.0，还是会检测到固件升级。

我想验证正常的OTA功能，希望固件版本可以回退？

假设您现在是1.0.0版本。正常OTA时：需要在后台上传一个1.0.1版本的固件，这个1.0.1版本固件是真实编译出来的，然后配置固件升级。然后在创建一个1.0.2或者更高的版本号，和OTA压测的操作方法类似，将1.0.0版本的固件的文件名改一下，把版本号改成1.0.2，然后将这个假的1.0.2版本固件上传，并配置OTA，升级完之后，实际运行的固件版本就回退到1.0.0，App会提示升级失败，之后可以再次升级。