每一次 core 的升級(jí)都會(huì)帶來一些網(wǎng)絡(luò)上的優(yōu)化(例如信號(hào)差時(shí)的網(wǎng)絡(luò)穩(wěn)定性)以及一些 bug 修復(fù)，所以在發(fā)布新版本以后，用戶可以先測(cè)試下 core 對(duì)自己腳本有無明顯影響或性能提升，然后進(jìn)行遠(yuǎn)程 FOTA。

1、本次選擇腳本版本是 001.000.000，升級(jí)到 001.000.001；固件版本從 2010 升級(jí)到 2012 版本，

按照生成量產(chǎn)固件的步驟，001.000.000 版本腳本搭配 V2010 版本固件生成量產(chǎn)文件如下圖：

2、將對(duì)應(yīng)生成的 2010 版本，001.000.000 的 SOC 的固件燒錄到模組中。

3.3.2.2 新版本軟件級(jí)包制作并上傳

1、修改腳本版本后以及固件版本后重新生成量產(chǎn)固件如下：

需要注意的是：生成了這個(gè)版本以后，再去腳本中改動(dòng)腳本版本號(hào)為 001.000.002(只要前后兩位有一位大于 1，一位大于 0 即可(當(dāng)然第一位大于 1 的時(shí)候，整個(gè)版本號(hào)自然大于 001.000.001)，如 002.000.200；001.000.001；030.000.311 等)

腳本版本號(hào)分為 A.B.C 三段；

因?yàn)闅v史原因，中間這一段 B 沒有任何意義，但是必須存在；

假設(shè)舊的腳本版本號(hào)為 A1.B1.C1，新的腳本版本號(hào)為 A2.B2.C2；

當(dāng)新舊腳本版本號(hào)滿足以下任何一種條件時(shí)，版本號(hào)允許升級(jí)：

（1）、A2 等于 A1，同時(shí) C2 大于 C1；

（2）、A2 大于 A1，同時(shí) C2 大于或者等于 C1；

（3）、B1 B2 無意義

2、接下來就是針對(duì)這兩個(gè)量產(chǎn)文件，制作一個(gè)差分文件，用來遠(yuǎn)程升級(jí)(注：遠(yuǎn)程升級(jí)中 core 為差分，腳本為全量升級(jí))

點(diǎn)擊到 luatools 的主界面，依次點(diǎn)擊圖中藍(lán)框所示意的地方(注：必須使用 luatools_3.0.9 及其以上版本，要不差分包升級(jí)的時(shí)候可能會(huì)出問題)

3、按下圖所示選擇低版本以及高版本的固件，然后點(diǎn)擊開始執(zhí)行即可，如果不想輸出的差分包在 luatools 根目錄下，可以自行選擇一個(gè)輸出路徑

4、在你選擇的目錄下看到如下所示，帶著腳本的 PROJECT core 版本號(hào) 腳本版本號(hào)的 bin 后綴的差分文件。

5、將升級(jí)文件上傳完成以后，為了防止模塊當(dāng)前固件不是最早的版本，可以點(diǎn)擊 luatools 主界面右邊的"下載固件"選擇最早的 001.000.000 版本，按住 boot 重啟模塊，然后點(diǎn)擊下載，將最早的固件下載進(jìn)模塊里即可

6、將升級(jí)文件改名成上面 url 中的文件名字 FOTA2_DEMO_001.000.001_LuatOS-SoC_V2012_Air780EPM_1.soc 。然后上傳到服務(wù)器對(duì)應(yīng)的地址。

7、將對(duì)應(yīng)生成的 2010 版本，001.000.000 的 SOC 的量產(chǎn)固件燒錄到模組中。

3.4 示例結(jié)果展示

本 demo 將會(huì)演示三種場(chǎng)景下的 fota 升級(jí)，場(chǎng)景在 main.lua 中切換。

3.4.1 場(chǎng)景一：fota 升級(jí)簡(jiǎn)單演示

主要代碼如下：

升級(jí)中：模塊請(qǐng)求升級(jí)，下載完升級(jí)包以后會(huì)進(jìn)行 MD5 驗(yàn)證升級(jí)包有無問題，如果沒問題，就會(huì)啟動(dòng)重啟程序，然后進(jìn)行升級(jí)工作

升級(jí)后：升級(jí)成功后按我們之前的腳本，每隔 5S，打印一次"降功耗,找合宙"以及當(dāng)前腳本版本號(hào)，可以看出，當(dāng)前版本號(hào)已經(jīng)由原來的 001.000.000 變?yōu)榱?001.000.001，固件版本從 2010 變?yōu)?2012。

3.4.2 場(chǎng)景二：tcp 服務(wù)器下發(fā)升級(jí)指令

通過 tcp 服務(wù)器下發(fā)升級(jí)指令（指令格式使用 json 字符串，包含是否升級(jí)參數(shù)），控制設(shè)備使用 fota 功能模塊。此場(chǎng)景下，設(shè)備會(huì)先連接到 TCP 服務(wù)器，等待服務(wù)器下發(fā)升級(jí)指令。在 air_srv_fota.lua 中會(huì)有一個(gè)參數(shù)控制，防止升級(jí)過程中重復(fù)下載升級(jí)包。

測(cè)試服務(wù)器鏈接：https://netlab.luatos.com/，打開一個(gè) tcp 服務(wù)器，

在 tcp_self_main.lua 中配置 tcp 服務(wù)器信息：

升級(jí)前：設(shè)備連接到 TCP 服務(wù)器，等待指令下發(fā)：{"fota": "true", "url": "http://airtest.openluat.com/download/FOTA2_DEMO_001.000.001_LuatOS-SoC_V2012_Air780EPM_1.soc"}

升級(jí)中：模組收到服務(wù)器下發(fā)的升級(jí)指令后，設(shè)備開始下載升級(jí)包并進(jìn)行驗(yàn)證

升級(jí)后：升級(jí)包下載完成后設(shè)備重啟升級(jí)，并循環(huán)打印新的版本號(hào)信息

3.4.3 場(chǎng)景三：psm 低功耗 fota

此場(chǎng)景是防止 psm 狀態(tài)下升級(jí)沒完成就進(jìn)入休眠導(dǎo)致升級(jí)失敗的情況寫的一個(gè)例子。需要注意的是要等待升級(jí)成功后再去進(jìn)入休眠。

主要代碼如下：

升級(jí)前：設(shè)備會(huì)在開機(jī)的時(shí)候去請(qǐng)求下配置的 url 的升級(jí)包，定期喚醒檢查是否有升級(jí)任務(wù)

在此過程中模組會(huì)保持喚醒狀態(tài)并等待升級(jí)包下載成功并校驗(yàn)通過，以及檢查版本是否一致。如果版本不一致或升級(jí)包檢驗(yàn)沒通過則進(jìn)入休眠等待下次喚醒檢查升級(jí)包。沒問題的話升級(jí)包下載成功后會(huì)重啟并升級(jí)，升級(jí)流程如下：

升級(jí)后：升級(jí)完成后設(shè)備顯示新的版本號(hào)，并重新去請(qǐng)求升級(jí)包，沒有新的升級(jí)包則會(huì)進(jìn)入 PSM 狀態(tài)

四、常見問題與注意事項(xiàng)

4.1 注意事項(xiàng)：

1、版本號(hào)格式：使用 IoT 平臺(tái)時(shí)，項(xiàng)目的 VERSION 必須為 xxx.yyy.zzz 的三段數(shù)字格式（如 "001.000.001"），否則平臺(tái)版本比對(duì)可能出錯(cuò)。

2、PRODUCT_KEY：使用 IoT 平臺(tái)時(shí)，必須在 main.lua 中正確定義全局變量 PRODUCT_KEY，其值需從 IoT 平臺(tái)的項(xiàng)目中獲取。

3、重啟時(shí)機(jī)：下載升級(jí)包成功（result 為 0）后，通常需要調(diào)用 rtos.reboot() 重啟設(shè)備以更新。你可以根據(jù)需要延遲重啟。

4、自建服務(wù)器規(guī)則：

需要升級(jí)時(shí)，服務(wù)器應(yīng)返回 HTTP 200，消息體為升級(jí)文件內(nèi)容。

無需升級(jí)時(shí)，服務(wù)器應(yīng)返回 HTTP 300 或以上的狀態(tài)碼。

5、固件類型：使用 IoT 平臺(tái)進(jìn)行腳本升級(jí)時(shí)，使用 Luatools 生成的 .bin 量產(chǎn)文件。

4.2 為什么升級(jí)后我的模塊沒有任何反應(yīng)了，像是變磚一樣

有多種可能，

4.2.1 檢查腳本

首先先檢查下用戶自己的腳本，有可能是引起重啟/死機(jī)的代碼寫在了最前面，例如新加的某個(gè)值或者函數(shù)為 nil 但是還是去做了些加減乘除或者判斷大小的邏輯?？梢灾苯颖镜?zé)浵滦掳姹镜?core+ 腳本驗(yàn)證，如果有 fskv 等用到 flash 的代碼，可能需要仔細(xì)檢查才能排除問題，比如下載的時(shí)候勾選如下圖所示的兩個(gè)選項(xiàng)。

4.2.2 檢查 core

如果是僅腳本升級(jí)，但是沒注意使用了新 core 中才有的接口，就有可能引起循環(huán)重啟，如果重啟在代碼最開頭，模塊可能來不及打印任何日志就重啟了，可以直接本地?zé)浵滦掳姹镜?core+ 腳本驗(yàn)證，如果有 fskv 等用到 flash 的代碼，可能需要仔細(xì)檢查。

4.3 檢查過腳本和 core，沒問題，為什么會(huì)循環(huán)升級(jí) 6 次以后禁止升級(jí)

檢查下升級(jí)包是否正常，有時(shí)候因?yàn)槿藛T誤操作，經(jīng)常會(huì)出現(xiàn)舊腳本 + 新 core 或者新腳本 + 舊 core 的意外組合，

例如：

本來應(yīng)該如下表描述的一樣

操作人員失誤后變成了如下

然后誤操作舊版本(1) 和誤操作新版本(1)進(jìn)行差分，這樣雖然腳本版本號(hào)舊版本大于了新版本，但是 core 的舊版本小于新版本，所以升級(jí)平臺(tái)依舊認(rèn)為是依次有效的升級(jí)，下發(fā)了升級(jí)包。

升級(jí)完成后，模塊內(nèi)部腳本版本號(hào)變成了 001.000.000 core 版本號(hào)為 V2008，下次模塊請(qǐng)求升級(jí)的時(shí)候，當(dāng)前固件上報(bào)的腳本版本號(hào)(001.000.000)依舊小于云平臺(tái)存儲(chǔ)的腳本版本號(hào)(001.000.001)，然后繼續(xù)下發(fā)升級(jí)包，就這么循環(huán) 6 次，然后觸發(fā) iot 平臺(tái)的禁止升級(jí)規(guī)則

在正確生成差分包，并且上傳成功后，可以在 iot 平臺(tái)里解除禁止升級(jí)的限制

在"我的設(shè)備"中選擇升級(jí) imei 所在的項(xiàng)目，然后點(diǎn)擊右邊的"解除禁止升級(jí)"，

確定“導(dǎo)致設(shè)備循環(huán)升級(jí)的異?！币呀?jīng)處理完成后，點(diǎn)擊確定解除，即可解除限制升級(jí)

4.4 我想在服務(wù)器發(fā)送特定的字符串如"update"時(shí)再觸發(fā)升級(jí)，應(yīng)該怎么做

只需要在你希望的升級(jí)升級(jí)邏輯后面加上升級(jí)語句即可，例如mqtt 的 demo里增加幾句話

又或者希望按鍵升級(jí)：

4.5 如何處理同個(gè)項(xiàng)目外面有多個(gè)版本設(shè)備的升級(jí)情況

4.5.1 場(chǎng)景1：多種不同內(nèi)核固件版本都要升級(jí)為最新版本內(nèi)核固件+最新腳本

需要對(duì)每個(gè)版本都生成對(duì)應(yīng)的差分包操作步驟： 現(xiàn)有A1、A2、A3三種內(nèi)核固件需升級(jí)為B+新腳本： - 生成3個(gè)升級(jí)包：A1→B差分包+新腳本、A2→B差分包+新腳本、A3→B差分包+新腳本- 在合宙IoT平臺(tái)創(chuàng)建3個(gè)升級(jí)配置，分別對(duì)應(yīng)三類設(shè)備IMEI

4.5.2 場(chǎng)景2：多種不同內(nèi)核固件版本+不同版本腳本都要升級(jí)為最新版本腳本，既只升級(jí)腳本。

操作步驟： 1. 準(zhǔn)備完整的最新腳本（無需內(nèi)核差分包） 2. 在IoT平臺(tái)創(chuàng)建一個(gè)升級(jí)配置，指定所有需升級(jí)設(shè)備IMEI列表

4.5.3 升級(jí)規(guī)則說明

內(nèi)核固件：僅支持差分升級(jí)

腳本：支持全量升級(jí)，可一次性完成

今天的內(nèi)容就分享到這里了~

審核編輯 黃宇