對于初學者而言，掌握如何從遠程平臺（如GitHub、GitLab）克隆Demo代碼倉庫是一項必備技能。該操作不僅便于查看示例代碼，還能幫助理解項目結構。本文將系統(tǒng)講解克隆操作的核心流程與實用技巧。

一、下載模組的示例代碼

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

https://gitee.com/openLuat/LuatOS/tree/master/module/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鏈接: https://gitee.com/

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

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

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

二、修改代碼

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

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

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

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

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

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

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

是不是超級簡單？

三、燒錄代碼到硬件

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

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

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

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

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

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

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

（2）燒錄固件和腳本；

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

（4）簡單的串口調試；

Luatools 下載之后， 無需安裝， 解壓到你的硬盤，點擊 Luatools_v3.exe 運行，出現(xiàn)如下界面，就代表 Luatools 安裝成功了：

2、燒錄代碼

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

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

Air780EPM 的固件可以去DOCS網站下載。

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

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

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

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

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

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

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

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

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

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

（5）新建項目

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

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

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

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

新建一個項目

（6） 開始燒錄

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

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

3、燒錄問題排查

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

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

四、驗證功能

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

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

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

你太棒了！ 你成功了！

五、總結

這節(jié)我們學會了

1、如何下載LuatOS的core，

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

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


審核編輯 黃宇