節流計劃-基礎知識-1-相關資料

目錄

軟體工具

LuatoolsV2

VSCODE

LUA在線工具

資料手冊

開源代碼

網址網站

官方產品中心

LUA知識庫

問答社區

網頁問答社區

QQ群討論組

節流計劃旨在降低物聯網產品的硬體成本，本專欄將在2021年持續更新，

節流計劃不采用STM32/STC/PIC等傳統MCU，而是充分挖掘AIR724UG芯片除4G通信外的其他功能，包含但不限于GPIO、TTS、LCD、OTA、FLASH、ADC，KEY，UART，I2C、SPI等，

著作權所有，謝絕轉載，侵權必究，承接相關物聯網專案合作，郵箱：realiot@163.com，

工欲善其事必先利其器，本文將介紹LUAT開發所需要的一些常用的軟體工具和網站資料，這些資料,將是我們進行后續開發學習的基礎，也將是我們后期處理問題經常用到的知識源泉，

軟體工具

LuatoolsV2

軟體簡介：一款合宙官方推出的LUAT開發工具，為了區別上一代用于2G和4G模組的LuatoosV1，改軟體被命名為LuatoolsV2，主要功能包含：日志列印，韌體下載，專案管理測驗，

驅動安裝：在使用該軟體前，為了確保軟體和AIR724UG能夠正常通信，需要在您的電腦上安裝AIR724UG的驅動，同時，您也可以在下載LuatoolsV2這個軟體，鏈接：http://old.openluat.com/Product/4gcat1/Air724UG.html#

小提示1：軟體打開后，可能軟體會提示需要更新，按照提示進行更新即可，如果軟體更新后卡死，可以重新按照上述鏈接下載安裝包，換一個運行路徑打開軟體即可，在軟體升級更新程序中，建議您不要關閉軟體，

小提示2：AIR724UG模塊通過USB連接電腦后，可能會造成現有的連接網路變成724UG提供，即724UG作為上網卡供電腦聯網，這就意味著有可能消耗流量卡大量的流量，如果您想避免上述情況發生，可以在電腦右下角的聯網標志發生改變后，在電腦系統設定的網路和配接器設定選擇中，手動設定網路連接方式為禁用724UG虛擬出來的本地連接，

日志列印：AIR724UG模塊通過USB連接電腦后，勾選4G模塊USB列印，并點擊開始列印打開軟體的日志列印功能，軟體視窗便開始列印運行資訊，列印出的訊息主要有以下幾種：

1、724UG內燒錄的程式控制的列印輸出（輸出內容受腳本控制）

2、724UG內燒錄的程式運行時的錯誤、警告或提示（輸出內容受框架控制）

您還可以通過軟體列印視窗右上角的日志搜索功能，檢索日志中出現的特定字符，例如，您的程式是每5秒列印一次“hello”，那么您可以通過檢索列印資訊中的“hello”，來判斷程式是否正確執行，

韌體下載

讀者可以使用韌體下載功能下載已經編譯好的pac檔案，例如下圖中展示的就是合宙官方提供的一個DTU韌體，下載后檔案可以直接在AIR724UG上運行，詳細的使用步驟如下：

1 點擊下載韌體 彈出下載視窗

2 點擊選擇檔案 選擇需要下載的韌體

3 如果采用USB BOOT方式下載，請勾選該選項，下載的可靠性和成功率高，不過筆者一直采用非USB BOOT方式下載，實在不行的，就用USB BOOT方式下載，而USB BOOT方式簡而言之，就是在點擊下載按鍵前，短接模塊的1.8V和BOOOT引腳，待下載開始后，軟體會有提示，此時可以斷開兩個引腳的連接，

4 下載成功后，軟體會有綠色的文字提示下載完成，同時列印視窗也會開始輸出日志檔案，

專案管理測驗

讀者可以使用專案管理測驗功能下載測驗自己創建的腳本程式或專案，例如下圖展示的就是筆者自建的一個測驗專案，詳細的使用步驟如下：

1 新建專案，匯入底層core檔案，這個底層core檔案是官方提供的代碼運行的平臺，是pac格式的，可以理解為一個餐桌，

2 增加腳本，匯入庫檔案和自建代碼檔案，是lua格式的，可以理解為一個個的盤子，而自己撰寫的代碼，可以理解為盤子里的菜，

3 按需勾選選項，可以選擇trace資訊的列印方式，也可對其它選項進行配置，建議采用軟體默認的配置方式即可，

4 語法檢查，下載腳本，lua屬于腳本語言，和傳統的C語音有一個非常明顯的區別就是錯誤代碼的檢查上，C語言的代碼運行前，會檢測出所以的錯誤，存在錯誤則無法執行，而lua語言即使代碼中有錯誤，整個程式依然會順序執行，知道執行到有錯誤的代碼的位置，為了避免問題代碼被下載而白白浪費時間，可以在代碼下載前進行一下語法檢查，語法檢查的時間約有2分鐘，檢查完成后無錯誤，會有綠色的文字提示，此時再下載即可，

第一次下載時可以選擇 下載底層和腳本 這樣可以保證把AIR724UG內的原有的韌體完全覆寫，第二次下載時可以只選擇 下載腳本 這樣可以節省些時間（因為底層在第一次下載已經燒錄進去，無須重復燒錄），

5 生成量產檔案（非必要操作，可選），如果進行上述操作后，您的代碼符合設計預期，需要批量燒錄到AIR724UG中或者生成一個遠程升級的韌體，可以使用生成量產檔案選項，生成后產生的pac檔案，就是一個可以獨立燒錄的韌體，其功能等價于上述步驟中提到的 餐桌+盤子+菜

VSCODE

軟體簡介：一個微軟開發的代碼編輯器，可以根據編程語言和使用者的習慣通過安裝插件的方式自由裁剪功能，界面簡潔友好，是碼農的新寵，

下載地址：https://code.visualstudio.com/

插件安裝：針對lua開發，建議安裝以下幾個插件：

1、vscode-lua，一個在vscode中的lua語音支持工具，可以用于lua代碼的格式優化，

2、EmmyLua 可以對lua代碼進行關鍵詞高亮、變數指示、錯誤提示等功能，

3、lua 0.1.2，可以用于對lua代碼進行格式化處理，此處的格式化不是洗掉，而是合理排列lua代碼，提升代碼的可讀性，提高開發效率，

具體方法是：選中要被格式化的代碼，右鍵，彈出選單中使用Format Document With，然后選擇格式化工具即可，下次使用時可以直接選擇Format Document選項或者shift+alt+F快捷鍵，

顏色主題：淺色主題推薦Bluloco Light，深色主題推薦ReUI或者Solarized Dark，

版本控制：可以使用gitee+vscode+git的方式對撰寫的代碼進行版本控制，不僅代碼更有條理，而且可以遠程分享和下載，具體的使用可以參照：在VSCode中使用碼云(Gitee)進行代碼管理_watfe的專欄-CSDN博客

LUA在線工具

LUA在線工具是一個在線運行lua代碼的網址，網址：https://c.runoob.com/compile/66，

一些針對AIR724UG撰寫的官方庫是不可以在這里運行的，但是一些通用的代碼，例如代數運算的驗證、邏輯運算的驗證，可以把代碼復制到在這里運行，也許這不是最好用的LUA運行工具，但聊勝于無吧，

資料手冊

Air724UG_Air723UG_模塊硬體設計手冊，鏈接：http://old.openluat.com/Product/file/uis8910dm/Air724UG_Air723UG_模塊產品規格書_20200807.pdf

該手冊重點講解了AIR724UG模塊的硬體引數、管教功能、使用方法、注意事項等，在使用AIR724UG進行硬體電路設計前，請務必熟讀該資料手冊，

開源代碼

此處開源代碼指官方提供的底層檔案，官方庫及示例工程，目前已知的下載方式有兩種，

1、在Gitee下載，鏈接：https://gitee.com/hotdll/LuaTask_V3.0

2、在合宙官方的產品中心下載，鏈接： http://old.openluat.com/Product/4gcat1/Air724UG.html

在筆者看來，這兩種下載方式各有利弊，

在Gitee開源網站上下載，可以保證代碼是最新的，也可能是最好用的，不過代碼更新也可能造成一些意想不到的問題，常見的問題有：發布者發布了你不了解的新功能，發布者洗掉了你之前用過的一個函式，建議初學者不要采用這個途徑獲取原始碼，一旦您已經掌握了基本的開發知識和開發技巧，可以隨時切換到最新的代碼，

而在合宙的官方產品中心下載，代碼不一定是最新的，但優點就是穩定可靠，您可以使用該原始碼作為學習資料，直到完全掌味訓礎的開發技能，

網址網站

官方產品中心

網站：http://old.openluat.com/Product/Index.html，此處可以看到合宙的各系列產品及其配套資料，下圖是筆者對AIR724UG的產品中心的截圖，

LUA知識庫

網址：https://wiki.openluat.com，該知識庫對luat開發進行了相當豐富的介紹，不僅涉及LUA語言的語法，還涉及到合宙LUAT官方庫的用法簡介等，對此筆者不再贅述，

問答社區

網頁問答社區

網址：http://ask.openluat.com/，一個合宙官方推出的網頁版的問答社區，在這里您可以提出問題等待高手回答，也可以通過搜索獲取前人的開發經驗，還可以發表文章講述自己的開發心得，不過從筆者自己的體驗來看，這個問答社區的活躍度不是很高，而且問題覆寫的面過于廣泛，面對一些棘手問題時可能幫不上忙，

QQ群討論組

下面截圖的群是合宙官方建立的QQ群，實際上合宙官方建立了很多類似的QQ群服務用戶，比如WIFI模塊建立的專群，DTU韌體建立的專群，LUAT開發建立的專群，

鑒于此時部分群已經滿員，如果您在淘寶購買合宙的模塊或者開發板，可以向客服索要最新的QQ群號，在QQ群里，您的問題將被實時解答，