在物聯(lián)網(wǎng)開(kāi)發(fā)領(lǐng)域，選擇合適的硬件平臺(tái)與操作系統(tǒng)是項(xiàng)目成功的關(guān)鍵。本文將帶領(lǐng)你從零開(kāi)始，通過(guò)詳細(xì)的步驟與示例代碼，掌握Air780EPM與LuatOS的入門(mén)開(kāi)發(fā)流程，并深入探討其核心功能與擴(kuò)展?jié)摿Α?br />

一、必須先要告訴你的一些廢話

這里，先要告訴你一些前提條件，雖然聽(tīng)著像是廢話，但是如果你不知道的話，可能后面會(huì)比較懵逼，所以還是希望你能夠認(rèn)真看一看這一節(jié)。

這個(gè)項(xiàng)目的產(chǎn)品定義是：模組每隔3秒，就往串口輸出一次 “ hello world” 字符串。

要想達(dá)到這個(gè)目的，這里有必要先介紹一下 LuatOS 在4G模組的運(yùn)行原理：

4G模組，除了運(yùn)行4G協(xié)議棧之外，還植入了5.3版本的Lua虛擬機(jī)，以及內(nèi)置的一個(gè)腳本代碼區(qū)。

4G模組上電之后， 虛擬機(jī)會(huì)去代碼區(qū)讀取腳本代碼的main入口， 并執(zhí)行這個(gè) main入口函數(shù)。

你只需要用 Lua 腳本改寫(xiě) main 入口函數(shù)，并把這個(gè)腳本燒錄到模組的正確位置，就可以正確運(yùn)行腳本的代碼。

幸運(yùn)的是， 你只需要用Luatools工具燒錄腳本， 就一定能保證腳本燒錄到正確的位置。

在完成這個(gè)初始項(xiàng)目之前，你還需要準(zhǔn)備好一套合適的硬件。

合適的硬件是什么呢？

是能運(yùn)行LuatOS腳本的4G模組。

怎么知道哪些4G模組能運(yùn)行LuatOS呢？

要想知道答案，你可以看我們的選型手冊(cè)第二頁(yè)：

選型手冊(cè)：https://docs.openluat.com/product/

模塊對(duì)應(yīng)的總代碼倉(cāng)庫(kù)地址：

https://gitee.com/openLuat

打開(kāi)這個(gè)代碼倉(cāng)庫(kù)的網(wǎng)址，你會(huì)看到公開(kāi)的一系列代碼倉(cāng)庫(kù)。

不僅僅公開(kāi)了每個(gè)模組的示例代碼，還把缺陷跟蹤也公開(kāi)了，真是絕對(duì)自信！

你要想運(yùn)行哪個(gè)模組的軟件， 就找到對(duì)應(yīng)的模組開(kāi)發(fā)板， 然后進(jìn)入對(duì)應(yīng)的代碼倉(cāng)庫(kù)，就可以開(kāi)發(fā)了！

今天，我們用 LuatOS-Air780EPM 這個(gè)倉(cāng)庫(kù)中的demo作為例子來(lái)進(jìn)行學(xué)習(xí)。

Air780EPM_LuatOS開(kāi)發(fā)代碼倉(cāng)庫(kù)：https://gitee.com/openLuat/LuatOS-Air780EPM

同時(shí)，還有強(qiáng)大的社區(qū)資料支持,這個(gè)網(wǎng)站的LuatOS-SOC接口文檔中，可以看到使用的API函數(shù)的介紹說(shuō)明：

Luatos_API介紹說(shuō)明：https://docs.openluat.com/air780epm/luatos/api/

在開(kāi)始之前，我已經(jīng)事先準(zhǔn)備好了 Air780EPM 開(kāi)發(fā)板，你準(zhǔn)備好了嗎？

Air780EPM模塊硬件資料：https://docs.openluat.com/air780epm/product/#_1

二、下載模組的示例代碼

下載示例代碼到一個(gè)合適的項(xiàng)目目錄。從gitee下載代碼的教程如下：

Luat/LuatOS-Air780EPM代碼倉(cāng)庫(kù)：https://gitee.com/openLuat/LuatOS-Air780EPM

1、最簡(jiǎn)單快速的方式：

直接進(jìn)入倉(cāng)庫(kù)，點(diǎn)擊下載倉(cāng)庫(kù)文件

2、使用git工具下載

git工具下載地址：Git - Downloading Package

以下是以Git Air780E項(xiàng)目進(jìn)行舉例說(shuō)明，Git Air780EPM流程一樣，只需要替換成Air780EPM Git路徑即可。

（1 ）進(jìn)入下載地址后，下載對(duì)應(yīng)的工具

（2）雙擊安裝工具

（3）雙擊后，直接下一步安裝即可 中途都是一些配置選項(xiàng)，一般使用默認(rèn)選項(xiàng)即可。

git下載好之后。。。

（1）新建一個(gè)文件夾，右鍵打開(kāi)操作面板

（2）設(shè)置用戶簽名：

用戶名和郵箱是用來(lái)標(biāo)識(shí)是誰(shuí)提交的代碼，輸入以下命令

（3）初始化本地庫(kù)，輸入以下命令

輸入這個(gè)命令后，可以在當(dāng)前目錄下看到一個(gè).git文件。只有.git文件是用git init命令生成的。其他的沒(méi)關(guān)系。有了.git文件后，當(dāng)前文件夾就是一個(gè)git倉(cāng)庫(kù)了，可以與遠(yuǎn)程的倉(cāng)庫(kù)進(jìn)行連接。

（4）從遠(yuǎn)程倉(cāng)庫(kù)下載一個(gè)公鑰，為了讓遠(yuǎn)程倉(cāng)庫(kù)驗(yàn)證自己的身份。輸入以下命令

生成的公鑰可以在C:/User/用戶/.ssh下看到

（5）將公鑰添加到gitee倉(cāng)庫(kù)

gitee:Gitee - 基于 Git 的代碼托管和研發(fā)協(xié)作平臺(tái)https://gitee.com/

在gitee找到賬號(hào)設(shè)置，然后找到SSH公鑰，再添加公鑰。

（6）克隆倉(cāng)庫(kù)到本地，輸入以下命令

此時(shí)在資源管理器中可以看到git下來(lái)的倉(cāng)庫(kù)文件

三、修改代碼

用編輯器打開(kāi)你下載下來(lái)的 LuatOS-Air780EPM/demo/helloworld/main.lua 文件。demo鏈接地址

我是習(xí)慣用 vscode，后面的例子都用 vscode 做演示了。

如果你是用其他的編輯器， 也差不多類(lèi)似。

其中sys.timerLoopStart(func, timeout)的作用是每隔timeout的時(shí)間循環(huán)執(zhí)行回調(diào)函數(shù)func中的內(nèi)容。

你把這段代碼稍作修改后，改為這樣：

然后保存，代碼修改工作就大功告成了！

我們實(shí)現(xiàn)了每隔3000ms執(zhí)行一次printf("hello world")

是不是超級(jí)簡(jiǎn)單？

四、燒錄代碼到硬件

燒錄代碼， 需要進(jìn)行如下幾步：

1. 下載和安裝調(diào)試工具 LuatTools

要想燒錄代碼， 先要下載強(qiáng)大的調(diào)試工具： Luatools。

如果你已經(jīng)安裝使用過(guò) Luatools， 可以直接跳到下個(gè)小節(jié)： 燒錄代碼。

Luatools 的最新版本的工具介紹和下載地址為：

https://docs.openluat.com/Luatools/

Luatools 工具主要有如下幾個(gè)功能：

（1）自動(dòng)從服務(wù)器獲取最新的模組固件；

（2）燒錄固件和腳本；

（3）查看和保存模組的串口輸出日志；

（4）簡(jiǎn)單的串口調(diào)試；

Luatools 下載之后， 無(wú)需安裝， 解壓到你的硬盤(pán)，點(diǎn)擊 Luatools_v3.exe 運(yùn)行，出現(xiàn)如下界面，就代表 Luatools

2.燒錄代碼

首先要說(shuō)明一點(diǎn)： 腳本代碼， 要和固件的bin文件一起燒錄。

（1）找到燒錄的固件文件

Air780EPM 的固件可以去DOCS網(wǎng)站下載。底層core下載地址：Air780EPM LuatOS固件版本https://docs.openluat.com/air780epm/luatos/firmware/

（2）正確連接電腦和4G模組電路板

使用帶有數(shù)據(jù)通信功能的數(shù)據(jù)線，不要使用僅有充電功能的數(shù)據(jù)線；

（3）識(shí)別4G模組的BOOT引腳

在下載之前，要用模組的BOOT引腳觸發(fā)下載， 也就是說(shuō)，要把4G模組的BOOT引腳拉到 1.8v，或者直接把BOOT引腳和VDD_EXT引腳相連。我們要在按下BOOT按鍵時(shí)讓模塊開(kāi)機(jī)，就可以進(jìn)入下載模式了。

具體到 Air780EMP開(kāi)發(fā)板，

1、當(dāng)我們模塊沒(méi)開(kāi)機(jī)時(shí)，按著B(niǎo)OOT鍵然后長(zhǎng)按PWR開(kāi)機(jī)。

2、當(dāng)我們模塊開(kāi)機(jī)時(shí)，按著B(niǎo)OOT鍵然后點(diǎn)按重啟鍵即可。

（4）識(shí)別電腦的正確端口

判斷是否進(jìn)入BOOT模式：模塊上電，此時(shí)在電腦的設(shè)備管理器中，查看串口設(shè)備， 會(huì)出現(xiàn)一個(gè)端口表示進(jìn)入了boot下載模式，如下圖所示：

一旦進(jìn)入了boot下載模式，表示硬件連接上已經(jīng)處于就緒狀態(tài)，此時(shí)就可以使用Luatools工具進(jìn)行燒錄了！

（5）新建項(xiàng)目

首先，確保你的 Luatools 的版本，是大于 3.0.15 版本的。

在 Luatools 的左上角上有版本顯示的，如圖所示：

Luatools 版本沒(méi)問(wèn)題的話， 就點(diǎn)擊Luatools 右上角的“項(xiàng)目管理測(cè)試”按鈕，如下圖所示：

這時(shí)會(huì)彈出項(xiàng)目管理和燒錄管理的對(duì)話框，如下圖：

1、新建一個(gè)項(xiàng)目

（6） 開(kāi)始燒錄

選擇Air780EPM板子對(duì)應(yīng)的底層core和剛改的main.lua腳本文件。下載到板子中。

點(diǎn)擊下載后，我們需要進(jìn)入boot模式才能正常下載，在(3)(4)小節(jié)已經(jīng)介紹了如何進(jìn)入boot模式。

3. 燒錄問(wèn)題排查

如果你在燒錄過(guò)程中遇到了問(wèn)題， 請(qǐng)點(diǎn)擊如下鏈接，進(jìn)行燒錄的問(wèn)題排查。

詳細(xì)的燒錄操作步驟參考此處：https://docs.openluat.com/Luatools/#_23

五、驗(yàn)證功能

燒錄完成后，會(huì)自動(dòng)開(kāi)機(jī)，此時(shí)電腦的設(shè)備管理器中會(huì)虛擬出三個(gè)端口表示正常開(kāi)機(jī)

Luatools會(huì)自動(dòng)抓取應(yīng)用日志和系統(tǒng)日志，并且在主界面解析顯示應(yīng)用日志，如下圖所示：

從打印的日志可以看到，這個(gè)4G開(kāi)發(fā)板，在不斷的打印 hello world。

你太棒了！ 你成功了！

六、總結(jié)

這節(jié)我們學(xué)會(huì)了

1、如何下載LuatOS的core，

2、如何使用燒錄工具Luatools，

3、如何編輯lua腳本實(shí)現(xiàn)打印hello world

大家快去試試吧~