前言：

我經(jīng)常在各個(gè)討論群里看到有合宙Air780EP的用戶說(shuō)：

FOTA遠(yuǎn)程升級(jí)有點(diǎn)難呀~一步錯(cuò)后面就得重新來(lái)了，有沒(méi)有大佬給個(gè)教程??？

用戶提需求了，那我們肯定要滿足啊，就連夜趕了一篇

在整理這篇文章之前，是沒(méi)有覺(jué)得這個(gè)FOTA遠(yuǎn)程升級(jí)有多復(fù)雜的，寫(xiě)完回頭一看，好家伙，這么多步驟??！

本篇保姆級(jí)教程，手把手教你FOTA遠(yuǎn)程升級(jí)，小白秒變專家！

合宙支持LuatOS功能的模組型號(hào)，除本文介紹的Air780EP外， 還有Air780EPA、Air780E、Air780EX、Air201、Air780EPT、Air780EPS等型號(hào)， 本文介紹的FOTA應(yīng)用流程，同樣也適用于這些型號(hào)。

一. 概述

合宙Air780EP具有高度集成、低功耗、強(qiáng)大的開(kāi)發(fā)支持的特點(diǎn)，提供了豐富的接口，支持多種外設(shè)連接，支持標(biāo)準(zhǔn)AT指令和LuatOS開(kāi)發(fā)。

Air780EP開(kāi)發(fā)板適用于多種物聯(lián)網(wǎng)應(yīng)用場(chǎng)景，比如智能家居、智能城市、工業(yè)控制、遠(yuǎn)程監(jiān)控等。

在開(kāi)始之前,我們先學(xué)習(xí)一下FOTA升級(jí)的背景知識(shí)：

遠(yuǎn)程升級(jí)是物聯(lián)網(wǎng)中比較常用的功能，本文介紹如何使用Air780EP開(kāi)發(fā)板進(jìn)行遠(yuǎn)程升級(jí)

LuatOS-Air開(kāi)發(fā)模式下，固件分為兩部分：core和script

（core為底層固件，script為腳本文件）

遠(yuǎn)程升級(jí)時(shí)：可以僅升級(jí)script；可以僅升級(jí)core；也可以同時(shí)升級(jí)core+script

我詳細(xì)介紹了兩種方式的升級(jí)教程：一個(gè)是合宙iot平臺(tái)升級(jí)教程，另一個(gè)是自建第三方服務(wù)器升級(jí)教程。

根據(jù)你的需求，選擇哪一種都可以。

二. 材料準(zhǔn)備

我們升級(jí)前需要的工具準(zhǔn)備有這些：

780EP開(kāi)發(fā)板一套，包括天線SIM卡，USB線

PC電腦，以及登錄官方IOT后臺(tái) https://iot.openluat.com/

固件和DEMO下載地址 LuatOS軟件包

三. 合宙iot平臺(tái)升級(jí)core+script過(guò)程

1. iot平臺(tái)創(chuàng)建產(chǎn)品

登錄合宙iot平臺(tái)

如果沒(méi)有賬戶，注冊(cè)一個(gè)賬戶

打開(kāi)：我的項(xiàng)目->新建項(xiàng)目

復(fù)制PRODUCT_KEY

2. 模塊端腳本修改，生成升級(jí)包

3. 按照新版本的需求，修改main.lua

如下圖所示，PROJECT和PRODUCT_KEY保持不變，PRODUCT_KEY需和服務(wù)器保持一致，VERSION修改為1.0.1

注意事項(xiàng)：

1. main.lua 內(nèi)填寫(xiě)版本號(hào)要符合 x.y.z 形式, 其中 x/y/z 均為數(shù)值, 不限于個(gè)位數(shù)；

2. 若fota使用合宙iot平臺(tái), 版本號(hào)中的 y 會(huì)被忽略, 推薦寫(xiě)0, 務(wù)必留意

4. 使用Luatools生成bin文件差分包

注意：只有Luatools版本2.1.89以上支持生成bin文件差分包，低版本僅支持生成sota文件

只升級(jí)腳本，差分包制作流程如下：

固件和DEMO下載地址 LuatOS軟件包，這里下載的是LuatOS-SoC@EC718P V1001下面的core_V1001.zip軟件包。下載對(duì)應(yīng)軟件包后按如下步驟生成對(duì)應(yīng)的差分包。

在Luatools目錄下的SOC量產(chǎn)及遠(yuǎn)程升級(jí)文件下，找到EC718P文件夾，打開(kāi)后綴名為.bin的文件fotademo_1001.1.1_LuatOS-SoC_EC718P.bin，這個(gè)就是文件差分包。

需要升級(jí)底層CORE，差分包制作流程如下：

生成新版本的量產(chǎn)固件，如下所示

根據(jù)新舊固件生成對(duì)應(yīng)差分文件，如下所示

a. 點(diǎn)擊選項(xiàng)及工具選項(xiàng)，選擇升級(jí)包制作工具

b. 選擇對(duì)應(yīng)文件，點(diǎn)擊開(kāi)始執(zhí)行生成對(duì)應(yīng)差分文件

c. 生成的差分文件

5. 在合宙iot平臺(tái)配置升級(jí)包

進(jìn)入iot平臺(tái)，打開(kāi)我的項(xiàng)目->固件列表->創(chuàng)建固件

選擇新固件升級(jí)文件

如果升級(jí)全部設(shè)備勾選的是否，則需要添加需要升級(jí)的模塊imei

6. 模塊開(kāi)機(jī)，完成升級(jí)

燒錄舊版本的模塊開(kāi)機(jī)后，連接升級(jí)服務(wù)器，下載差分升級(jí)包，自動(dòng)重啟，重啟過(guò)程中完成固件升級(jí)，整個(gè)過(guò)程的關(guān)鍵日志如下圖所示

7. 云平臺(tái)查看升級(jí)日志

登錄云平臺(tái)，選擇對(duì)應(yīng)設(shè)備升級(jí)的產(chǎn)品->固件升級(jí)->升級(jí)日志->輸入對(duì)應(yīng)的imei并選擇日期->搜索

可以看到設(shè)備在此日期下的空中升級(jí)日志。正常升級(jí)成功的情況下，短時(shí)間內(nèi)會(huì)有兩次升級(jí)請(qǐng)求，第一次請(qǐng)求升級(jí)獲取到升級(jí)包之后，設(shè)備重啟升級(jí)成功會(huì)再次向云平臺(tái)請(qǐng)求是否有更高版本的固件可以升級(jí)。直到升級(jí)結(jié)果為 “已是最新版本” 服務(wù)器沒(méi)有更高版本的固件為止。

如果你的存在設(shè)備升級(jí)失敗等情況，可以對(duì)照以下表格尋求解決方案：

四. 自建第三方服務(wù)器升級(jí)過(guò)程

使用自建第三方服務(wù)器升級(jí)

注意：只有Luatools版本2.1.89以上支持生成bin文件差分包，低版本僅支持生成sota文件

手動(dòng)生成core差分包+script全量包。例如core版本有1001、1002、1003，現(xiàn)在要統(tǒng)一升級(jí)到1004，則需要按照如下步驟操作：

手動(dòng)生成：從1001到1004的core差分包+script全量包、從1002到1004的core差分包+script全量包、從1003到1004的core差分包+script全量包

模塊請(qǐng)求升級(jí)時(shí)，服務(wù)器根據(jù)模塊中的core版本返回對(duì)應(yīng)的升級(jí)包文件

手動(dòng)生成差分包的過(guò)程如下：用合宙提供的luatools中的soc差分工具生成差分包

操作步驟

1. 準(zhǔn)備模塊中使用的舊版本core升級(jí)文件

此文件指的是模塊中舊版本core中的.soc文件（從合宙官方渠道下載），例如以LuatOS-SoC_V1001_EC718P.soc為例

2. 使用Luatools分別生成新舊版本的升級(jí)包

如下圖所示

在Luatools目錄下SOC量產(chǎn)及遠(yuǎn)程升級(jí)文件下的EC718P下，生成了一個(gè)后綴名為.soc的文件fotademo_1.0.1_LuatOS-SoC_V1002_EC718P.soc，這個(gè)就是新版本的升級(jí)包

3. 生成差分包

使用luatools生成升級(jí)文件，無(wú)論core是否需要升級(jí)，升級(jí)文件必須包含core，因?yàn)椴罘謺?huì)用到，使用luatools內(nèi)的soc差分工具生成即可

生成對(duì)應(yīng)差分包如下圖所示：

注意：差分包不能超過(guò)480k

4. 差分包上傳到自建服務(wù)器

lua固件默認(rèn)支持HTTP獲取升級(jí)包

啟動(dòng)遠(yuǎn)程升級(jí)功能，demo\fota2\main.lua文件做如下修改，打開(kāi)使用自建服務(wù)器進(jìn)行升級(jí)部分代碼，填寫(xiě)對(duì)應(yīng)的url

5. 使用其他協(xié)議實(shí)現(xiàn)自建服務(wù)器遠(yuǎn)程升級(jí)

可參考腳本庫(kù)中配置。無(wú)論使用哪種協(xié)議，遠(yuǎn)程升級(jí)的關(guān)鍵是獲取正確的升級(jí)固件包。

總結(jié)：

當(dāng)你看到這里，是不是已經(jīng)感到安心和踏實(shí)一些了，是的，你已經(jīng)掌握了FOTA遠(yuǎn)程升級(jí)的方法了。每一個(gè)步驟都被細(xì)細(xì)拆解，確保即便是技術(shù)小白也能輕松上手。

你在FOTA遠(yuǎn)程升級(jí)的時(shí)候，有沒(méi)有遇到過(guò)什么問(wèn)題？評(píng)論區(qū)一起來(lái)討論吧~

合宙支持LuatOS功能的模組型號(hào)，除本文介紹的Air780EP外， 還有Air780EPA、Air780E、Air780EX、Air201、Air780EPT、Air780EPS等型號(hào)， 本文介紹的FOTA應(yīng)用流程，同樣也適用于這些型號(hào)。

如有需要，請(qǐng)點(diǎn)擊 www.openluat.com 獲取聯(lián)系方式