Air系列模块（本文指2G和4G模块）支持三种开发模式：AT开发、Lua开发、CSDK开发，本文仅介绍AT和Lua两种开发模式的远程升级功能。不同开发模式的固件组成部分也不相同：

         AT开发模式：core固件

         Lua开发模式：core固件+脚本

         不同模块，不同开发模式，支持的远程升级功能也不尽相同，对比如下图所示

            4G模块的flash总容量为16MB，其中有一个FBF分区（0022之前的core中，FBF分区总空间为5.375MB；0022以及之后的core中，FBF分区总空间为5.875MB），用于存放远程升级包。模块从网络端将远程升级包成功下载保存到FBF分区后，下次重启时，BOOTLOADER程序会从FBF分区将远程升级包解析、搬运到CODE区，而后再清除FBF分区的使用标志，就完成了一次远程升级过程。

         Lua版本中，下载远程升级包，保存到FBF分区的过程如下（可参考lib/update.lua辅助理解）：

         1、执行rtos.fota_start()打开写FBF分区功能，返回0表示打开成功，其余表示失败

         2、下载升级包，如果升级包较小，可以先保存到一个文件中，下载结束之后，循环执行rtos.fota_process(curData， totalLen)将升级包内容分段写到FBF分区，curData为当前要写入的分段数据内容，totalLen为升级包的总大小（单位为字节），返回0表示写成功，其余表示失败；如果升级包较大，可以边下载边写FBF分区

         3、执行rtos.fota_end()关闭写FBF分区功能，返回0表示关闭成功，其余表示失败

         注意：无论第2步是否成功，第1步只要成功，必须执行第3步，第1步和第3步成对出现，并且在一次升级过程中，仅执行一次即可

       2G模块的flash总容量有4MB和8MB两种，其中有一个文件系统分区（不同固件的文件系统空间也不相同，可以在脚本中通过rtos.get_fs_free_size()来打印当前剩余的文件系统空间），此分区可以存放程序运行过程中实时创建的文件，也可以存放远程升级包。模块从网络端将远程升级包成功下载保存为文件系统分区的/luazip/update.bin文件后，下次重启时，内核core程序会解压缩/luazip/update.bin文件，将解压缩出来的新版本脚本和资源文件存放在文件系统分区，然后删除/luazip/update.bin文件，就完成了一次远程升级过程，自动重启以后运行的脚本代码为文件系统分区中的新版本脚本文件。

         整个过程如下图所示

             支持合宙服务器和自建服务器远程升级

         使用方法参考：http://oldask.openluat.com/article/984

        支持合宙服务器、阿里云服务器和自建服务器远程升级

          合宙服务器使用方法参考：http://oldask.openluat.com/article/915

          阿里云服务器使用方法参考：http://oldask.openluat.com/article/877

         自建服务器使用方法参考：http://oldask.openluat.com/article/107

        支持合宙服务器、阿里云服务器和自建服务器远程升级

          合宙服务器使用方法参考：http://oldask.openluat.com/article/984

          阿里云服务器使用方法参考：http://oldask.openluat.com/article/877

         自建服务器使用方法参考：http://oldask.openluat.com/article/107

         登录IOT网站，进入项目，打开“固件升级->升级日志”，根据IMEI查询升级记录错误描述

         如果IOT网站查询不到，搜索设备日志，获取服务器返回的错误码

         然后对照下表分析：

         同一产品下，允许配置多个升级配置项，但是固件名称不能重复，如下图所示

         下面以“本地烧录的脚本为1.0.0，要远程升级到1.0.1”为例说明此问题

         当1.0.0版本成功下载1.0.1升级包文件之后，会自动重启，然后从升级中解压缩出来1.0.1版本的所有脚本和资源文件，保存到文件系统中，如果文件系统空间不足，就会出现应用新版本失败的问题

         目前仅出现过文件系统空间不足导致的失败问题，此问题的典型日志如下图所示：

         TTS的lod，文件系统空间比较紧张，尤其要注意控制项目的脚本大小

         比较可靠的一种文件系统剩余空间是否能够保证成功升级的计算方法为：“升级包bin文件”+“生成升级包时，在luatools的目录ClearScr下的所有文件”< 模块剩余文件系统空间（通过rtos.get_fs_free_size()计算出来）的85%

         可参考：http://oldask.openluat.com/article/110 辅助理解

         2G模块仅支持远程升级脚本，下面以“本地烧录的脚本为1.0.0，要远程升级到1.0.1”为例说明回退功能

         当成功升级到1.0.1版本后，1.0.1运行过程中，如果出现异常（例如对nil值进行算数运算：a = nil+3；这些异常可以通过errDump功能模块上报调试服务器），并且1.0.1配置了允许回退功能，则会删除1.0.1的脚本，自动重启后，运行本地烧录的1.0.0版本，可参考2.2章节的示意图。如果1.0.0版本使用了errDump功能模块，则会自动上报这个异常到errDump服务器；即使1.0.0版本没有errDump功能模块，如果没有新的错误异常产生，这个错误异常也会保存到设备中，可以再升级一个带有errDump功能的新版本，新版本升级后，仍然会上报这个错误异常到errDump服务器；如果使用的是合宙官方的errDump服务器，可以通过如下方式查询这个错误：

         登录iot.openluat.com，随便选择一个产品，点进去，点击左侧的 “查询debug” 菜单， 输入设备imei号、开始结束日期，点击搜索即可（友情提醒：开始和结束日期的跨度越大，搜索速度越慢）

        为什么要设计回退功能呢，功过是非暂且不评；那么有没有什么办法不允许回退版本呢，以task版本为例，有一个sys.setRollBack(flag,secs)可以灵活配置，可在本示例中的1.0.1脚本中调用这个接口配置，详情参考API说明

         注意：一旦发生回退，是回退到最后一次本地烧录的版本，假设本地烧录的是1.0.0，后来远程升级到1.0.1，1.0.1又远程升级到1.0.2，.......，一直远程升级到1.0.9，只要1.0.1到1.0.9中的任何一个版本发生回退，都是回退到1.0.0版本

         另外：V0035以及之前的core有个bug，如果远程升级下载升级包的过程中，重启设备，会自动回退到最后一次本地烧录的版本。如果无法更新core至V0036以及之后的版本，要尽可能的在脚本程序中，最大限度的处理这种异常：例如远程升级下载升级包过程中不要主动重启；自建的升级服务器，升级包下载后，如果校验失败，通过调用os.remove("/luazip/update.bin")删除升级包；原则就是，不要让错误或者不完整的升级包存在

         远程升级功能本身对NVM中的原来保存的参数、运行过程中创建的文件没有任何影响

         有关NVM的详细说明参考：http://oldask.openluat.com/article/76

         远程升级包下载之后，下次重启会首先对升级包的准确性进行检查（算法不便透漏），检查通过之后才会应用升级

         下载过程中，异常重启，导致升级包没有下载完整；此时异常重启，不会导致模块死机或者变砖，只是校验升级包不对，直接将升级包删除，然后2G和4G模块运行的软件代码不太相同：

1.      2G模块：如果设备中core固件的版本号是0035或者之前的版本，core中存在一个bug，会导致重启后运行的是设备最后一次本地烧录的脚本；0036以及之后的core版本不存在此bug，重启后仍然运行远程升级之前的脚本

2.      4G模块：重启后运行的是升级前的固件

         升级包中打包的文件如果含有中文名，例如：测试说明.txt，会导致模块下载升级包之后，一直不断重启的问题