在物聯網開發領域，選擇合適的硬件平臺與操作系統是項目成功的關鍵。本文將帶領你從零開始，通過詳細的步驟與示例代碼，掌握Air780EPM與LuatOS的入門開發流程，并深入探討其核心功能與擴展潛力。

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

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

這個項目的產品定義是：模組每隔3秒，就往串口輸出一次 “ hello world” 字符串。

要想達到這個目的，這里有必要先介紹一下 LuatOS 在4G模組的運行原理：

4G模組，除了運行4G協議棧之外，還植入了5.3版本的Lua虛擬機，以及內置的一個腳本代碼區。

4G模組上電之后， 虛擬機會去代碼區讀取腳本代碼的main入口， 并執行這個 main入口函數。

你只需要用 Lua 腳本改寫 main 入口函數，并把這個腳本燒錄到模組的正確位置，就可以正確運行腳本的代碼。

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

在完成這個初始項目之前，你還需要準備好一套合適的硬件。

合適的硬件是什么呢？

是能運行LuatOS腳本的4G模組。

怎么知道哪些4G模組能運行LuatOS呢？

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

選型手冊：https://docs.openluat.com/product/

模塊對應的總代碼倉庫地址：

https://gitee.com/openLuat

打開這個代碼倉庫的網址，你會看到公開的一系列代碼倉庫。

不僅僅公開了每個模組的示例代碼，還把缺陷跟蹤也公開了，真是絕對自信！

你要想運行哪個模組的軟件， 就找到對應的模組開發板， 然后進入對應的代碼倉庫，就可以開發了！

今天，我們用 LuatOS-Air780EPM 這個倉庫中的demo作為例子來進行學習。

Air780EPM_LuatOS開發代碼倉庫：https://gitee.com/openLuat/LuatOS-Air780EPM

同時，還有強大的社區資料支持,這個網站的LuatOS-SOC接口文檔中，可以看到使用的API函數的介紹說明：

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

在開始之前，我已經事先準備好了 Air780EPM 開發板，你準備好了嗎？

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

二、下載模組的示例代碼

下載示例代碼到一個合適的項目目錄。從gitee下載代碼的教程如下：

Luat/LuatOS-Air780EPM代碼倉庫：https://gitee.com/openLuat/LuatOS-Air780EPM

1、最簡單快速的方式：

直接進入倉庫，點擊下載倉庫文件

2、使用git工具下載

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

以下是以Git Air780E項目進行舉例說明，Git Air780EPM流程一樣，只需要替換成Air780EPM Git路徑即可。

（1 ）進入下載地址后，下載對應的工具

（2）雙擊安裝工具

（3）雙擊后，直接下一步安裝即可 中途都是一些配置選項，一般使用默認選項即可。

git下載好之后。。。

（1）新建一個文件夾，右鍵打開操作面板

（2）設置用戶簽名：

用戶名和郵箱是用來標識是誰提交的代碼，輸入以下命令

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

輸入這個命令后，可以在當前目錄下看到一個.git文件。只有.git文件是用git init命令生成的。其他的沒關系。有了.git文件后，當前文件夾就是一個git倉庫了，可以與遠程的倉庫進行連接。

（4）從遠程倉庫下載一個公鑰，為了讓遠程倉庫驗證自己的身份。輸入以下命令

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

（5）將公鑰添加到gitee倉庫

gitee:Gitee - 基于 Git 的代碼托管和研發協作平臺https://gitee.com/

在gitee找到賬號設置，然后找到SSH公鑰，再添加公鑰。

（6）克隆倉庫到本地，輸入以下命令

此時在資源管理器中可以看到git下來的倉庫文件

三、修改代碼

用編輯器打開你下載下來的 LuatOS-Air780EPM/demo/helloworld/main.lua 文件。demo鏈接地址

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

如果你是用其他的編輯器， 也差不多類似。

其中sys.timerLoopStart(func, timeout)的作用是每隔timeout的時間循環執行回調函數func中的內容。

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

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

我們實現了每隔3000ms執行一次printf("hello world")

是不是超級簡單？

四、燒錄代碼到硬件

燒錄代碼， 需要進行如下幾步：

1. 下載和安裝調試工具 LuatTools

要想燒錄代碼， 先要下載強大的調試工具： Luatools。

如果你已經安裝使用過 Luatools， 可以直接跳到下個小節： 燒錄代碼。

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

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

Luatools 工具主要有如下幾個功能：

（1）自動從服務器獲取最新的模組固件；

（2）燒錄固件和腳本；

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

（4）簡單的串口調試；

Luatools 下載之后， 無需安裝， 解壓到你的硬盤，點擊 Luatools_v3.exe 運行，出現如下界面，就代表 Luatools

2.燒錄代碼

首先要說明一點： 腳本代碼， 要和固件的bin文件一起燒錄。

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

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

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

使用帶有數據通信功能的數據線，不要使用僅有充電功能的數據線；

（3）識別4G模組的BOOT引腳

在下載之前，要用模組的BOOT引腳觸發下載， 也就是說，要把4G模組的BOOT引腳拉到 1.8v，或者直接把BOOT引腳和VDD_EXT引腳相連。我們要在按下BOOT按鍵時讓模塊開機，就可以進入下載模式了。

具體到 Air780EMP開發板，

1、當我們模塊沒開機時，按著BOOT鍵然后長按PWR開機。

2、當我們模塊開機時，按著BOOT鍵然后點按重啟鍵即可。

（4）識別電腦的正確端口

判斷是否進入BOOT模式：模塊上電，此時在電腦的設備管理器中，查看串口設備， 會出現一個端口表示進入了boot下載模式，如下圖所示：

一旦進入了boot下載模式，表示硬件連接上已經處于就緒狀態，此時就可以使用Luatools工具進行燒錄了！

（5）新建項目

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

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

Luatools 版本沒問題的話， 就點擊Luatools 右上角的“項目管理測試”按鈕，如下圖所示：

這時會彈出項目管理和燒錄管理的對話框，如下圖：

1、新建一個項目

（6） 開始燒錄

選擇Air780EPM板子對應的底層core和剛改的main.lua腳本文件。下載到板子中。

點擊下載后，我們需要進入boot模式才能正常下載，在(3)(4)小節已經介紹了如何進入boot模式。

3. 燒錄問題排查

如果你在燒錄過程中遇到了問題， 請點擊如下鏈接，進行燒錄的問題排查。

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

五、驗證功能

燒錄完成后，會自動開機，此時電腦的設備管理器中會虛擬出三個端口表示正常開機

Luatools會自動抓取應用日志和系統日志，并且在主界面解析顯示應用日志，如下圖所示：

從打印的日志可以看到，這個4G開發板，在不斷的打印 hello world。

你太棒了！ 你成功了！

六、總結

這節我們學會了

1、如何下載LuatOS的core，

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

3、如何編輯lua腳本實現打印hello world

大家快去試試吧~

審核編輯 黃宇