作為由合宙所提供的調(diào)試工具，Luatools支持最新固件獲取、固件打包、trace打印、單機(jī)燒錄等功能

此工具適用于合宙所有 4G 模組和 4G + GNSS 模組。

一、下載和安裝

（一）運(yùn)行環(huán)境要求

• 此工具運(yùn)行于win7及以上系統(tǒng);
• 不支持 Mac和 Linux。

（二）支持的模組型號

• Air724,
• 所有的 Air780 系列模組；
• 所有的 Air700 系列模組；
• Air201 系列模組；

（三）Luatools下載

點(diǎn)擊下載：[Luatools v3 下載調(diào)試工具]

（四）Luatools安裝

• 1. 工具下載后的文件名為：Luatools_v3.exe
• 1. 在win系統(tǒng)--D盤（或其他盤）推薦在根目錄下新建文件名，并重命名為 Luatools，目錄太深可能會導(dǎo)致工具某些功能會出問題。
• 1. 將下載的Luatools_v3.exe拷貝或移動到新建的Luatools文件夾內(nèi) 注意：若出現(xiàn)危險(xiǎn)提醒，無需理會，繼續(xù)下載即可

• 1. 雙擊Luatools_v3.exe啟動程序， 關(guān)閉每日tips，點(diǎn)擊開始后更新 注意：如果有殺軟攔截，請務(wù)必通過?。?！務(wù)必通過?。?！務(wù)必通過?。。?/strong>

• 1. 更新完成后，Luatools文件夾內(nèi)，會生成幾個新文件夾：

二、主要文件夾介紹

1， _temp 文件夾

臨時(shí)文件

2. config 文件夾

對 Luatools_v3 進(jìn)行的一些配置會存放到這個文件夾

3. log 文件夾

里面存放有模塊輸出的各種日志信息，當(dāng)模塊出現(xiàn)問題需要向合宙技術(shù)人員尋求技術(shù)支持的時(shí)候，就需要提交這個目錄下的文件：

• 4gdiag 文件夾：ap和cp日志
• ramdump 文件夾：死機(jī)dump文件
• main_xxxxxx：模塊輸出的調(diào)試日志
• trace_xxxxxx：Luatools工具輸出的日志

4. resource 文件夾

合宙模塊相關(guān)的AT固件，LuaTask開發(fā)的Core底層固件，Lib庫和demo腳本

• aa_bb_lod 文件夾：aa表示芯片平臺，bb表示開發(fā)方式（at / lua）,比如 LuatOS_Air780E, AT_Air780EQ
• 8910_script 文件夾：Air724 模塊的demo和Lib
• soc_script 文件夾：gitee Luatos 主倉庫更新的demo和Lib
• LuatOS_iRTU_bb：LuatOS_iRTU表示是iRTU開發(fā)方式，bb表示模塊名稱

5. project 文件夾

使用項(xiàng)目管理后會自動生成這個目錄，用于管理下載項(xiàng)目

三、菜單和界面介紹

1. 賬戶

• 登錄

使用購買時(shí)銷售為你自動創(chuàng)建的erp賬號登陸，可以在合宙技術(shù)人員遠(yuǎn)程支持客戶時(shí)協(xié)助抓取本機(jī)log

• 工具配置

點(diǎn)擊Log，當(dāng)配合技術(shù)人員抓取bug日志時(shí)在此頁面打開log功能，例如AP與CP日志，若使用工具經(jīng)常遇到藍(lán)屏，可先關(guān)閉底層日志的抓取

• Exit：退出工具

2. LuatOS

2.1 代碼調(diào)試

對應(yīng)各個模塊的DEMO的gitee路徑

• Air780E模塊gitee路徑： [Air780E]
• Air780EX模塊gitee路徑：[Air780EX]
• Air724UG模塊gitee路徑： [Air724UG]
• Air201模塊gitee路徑：[Air201]
• Air780EPS模塊gitee路徑：[Air780EPS]
• Air780EP模塊gitee路徑：[Air780EP]

2.2 資源目錄

點(diǎn)擊后進(jìn)入對應(yīng)資源所在目錄

2.3 固件工具

 差分包制作工具，固件腳本合并工具，轉(zhuǎn)量產(chǎn)bin文件工具，iot平臺賬號綁定工具

• 差分包/整包升級包制作 可生成差分包或整包，用于FOTA遠(yuǎn)程升級使用，由于部分模塊不支持在該工具上生成，具體以各模塊FOTA遠(yuǎn)程升級例程上的要求為準(zhǔn)。
  
• 固件合并文件工具：固件合入bin文件。
  對 Air780E，Air780EX 模組： 使用xxx.binpkg；
  對 Air780EP，Air780EPS，Air780EQ，Air700ECQ，Air201，Air700 模組： 使用xxx.soc；
  對 Air724 模組： 使用 xxx.pac
  

3，AT指令

3.1 固件燒錄

 點(diǎn)擊可以直接燒錄對應(yīng)模塊的AT最新固件

 會彈出如下界面，點(diǎn)擊下載后可以直接下載對應(yīng)最新的AT固件版本（AT詳細(xì)燒錄過程見下面AT固件燒錄部分描述）

3.2 調(diào)試工具

 - 內(nèi)置簡約版本的串口調(diào)試工具，選擇菜單：

 - 選擇串口調(diào)試工具后，會彈出如下界面：

4，資料和工具

4.1 Web工具

• 經(jīng)緯度查詢和糾偏： [GPS-Offset]
• TCP/UDP WEB測試工具： [netlab.luatos.com]

4.2 合宙 IOT平臺

• FOTA遠(yuǎn)程升級服務(wù)：[合宙云平臺]
• ERP模塊生產(chǎn)記錄： [合宙ERP系統(tǒng)]
• 合宙DTU管理平臺： [DTU管理系統(tǒng)]
• LBS基站定位服務(wù)： [基站定位]

4.3 資料

5， 幫助和支持

5.1 購買

5.2 幫助

6. 日志打印窗口

- 支持4G模塊USB（默認(rèn)）打印和通用串口打印日志

- 在非USB打印時(shí)，可選擇通用串口工具在windows設(shè)備管理器對應(yīng)的端口號，例如USB-TTL：

- 開始/停止打印可以暫停文本區(qū)的自動滾動打印

- 清除打印可以清空文本區(qū)的打印日志，但是不會刪除log文件夾下的文件內(nèi)容

7，模塊狀態(tài)顯示窗口

• 啟動原因：模塊開機(jī)原因
• 系統(tǒng)狀態(tài)：如果文本區(qū)中存在對應(yīng)的日志，這里會顯示SIM卡、網(wǎng)絡(luò)注冊等信息
• 固件版本：這里僅僅顯示core的版本信息，例如AT或者Luat的版本信息，不顯示Lib和用戶腳本的版本號
• 小區(qū)信號：顯示模塊接入主小區(qū) RSRQ、RSRP、SNR 信號值
• 信號強(qiáng)度：這里顯示GSM的信號強(qiáng)度。信號強(qiáng)度與卡是否欠費(fèi)無關(guān)，不插卡也可以有信號強(qiáng)度
• 當(dāng)前網(wǎng)絡(luò)：網(wǎng)絡(luò)類型，例如 4G網(wǎng)絡(luò)
• 軟件類型：這里是指Core的類型，例如Luatask或者AT
• 小區(qū)ID：顯示模塊接入主小區(qū)的cellid
• 資料鏈接：模塊對應(yīng)資料鏈接

8，下載固件入口

• 除第二步點(diǎn)擊選擇文件后選擇固件外，也可以直接拖動固件至該界面
• 除AT固件外，可根據(jù)自己需要選擇是否操作第三步，不需要可跳過第三步

9， 項(xiàng)目管理入口

詳細(xì)操作教程在第五章，[項(xiàng)目管理]

10，搜索打印

通過關(guān)鍵詞搜索可直接跳轉(zhuǎn)到與之相匹配內(nèi)容行

11，底部鏈接

鼠標(biāo)懸停至窗口四個邊或四個角，可對窗口進(jìn)行大小縮放

四、日志查看

（一）使用Luatools文本區(qū)查看日志

• Luatools 會自動識別USB的虛擬端口，并打開虛擬端口，讀取日志，并顯示出來；
• 當(dāng)使用 USB 物理連接的話，務(wù)必要勾選 “4G模塊USB打印”。

（二）使用文本編輯器直接查看log日志

• Luatools 的日志是 USB-TTL 或者 USB-VCOM 提供的，因此可能會獨(dú)占串口
• 用文本編輯器打開 log的時(shí)候，注意生成的 Log 文件時(shí)間，必要時(shí)，先關(guān)閉 Luatools 再使用文本編輯器查看日志

五、項(xiàng)目管理

（一）創(chuàng)建項(xiàng)目

（二）輸入TestSocket，然后確定

（三）單擊 單擊TestSocket項(xiàng)目，在右側(cè)分別填入

• 底層Core：Lua開發(fā)的底層Core
• 增加腳本或資源文件：添加用戶腳本、數(shù)據(jù)及Lib庫
• 默認(rèn)USB打印trace，trace三個選項(xiàng)是用來選擇打印輸出方式的
• 添加默認(rèn)lib：不建議勾選
• 升級文件包含core：用于項(xiàng)目打包，可按需選擇
• 升級文件包含腳本：用于項(xiàng)目打包，建議直接勾選
• 升級文件無資源文件：用于項(xiàng)目打包，不選
• USB BOOT下載：使用Boot模式下載
• 下載腳本：只下載腳本列表中的數(shù)據(jù)
• 下載底層和腳本：底層core和腳本列表中的數(shù)據(jù)都下載
• 語法檢查：單獨(dú)檢查用戶編寫的腳本有無語法錯誤

（四）注意，首次下載時(shí)，強(qiáng)烈建議直接下載底層和腳本

六、固件燒錄

（一）USB 固件燒錄

首先USB連接PC，保持上電不開機(jī)狀態(tài)。

1，AT開發(fā)方式

• （1）點(diǎn)擊下載固件按鈕。
• （2）選中要下載的AT固件
• （3）如果是開發(fā)板按住下載模式按鍵（boot 鍵）不放，同時(shí)再長按開機(jī)鍵開機(jī)，這時(shí)開發(fā)板會進(jìn)入下載模式，Luatools下載進(jìn)度條會開始跑，這時(shí)可以松開 boot 按鍵。直到工具提示下載完成。
• （4）如果是自己畫板，需要將模塊boot引腳按照對應(yīng)硬件手冊要求，拉高到對應(yīng)電平，再按住boot按鍵，上電開機(jī)，這時(shí)板子會進(jìn)入下載模式，Luatools下載進(jìn)度條會開始跑，這時(shí)可以松開 boot 按鍵。直到工具提示下載完成。

2，LuatOS開發(fā)方式

• （1）在Luatools工具主界面點(diǎn)擊"項(xiàng)目管理測試"
• （2）如果沒有新建過項(xiàng)目，需要先建立一個項(xiàng)目
• （3）選擇底層固件 .soc文件，或者其他后綴的固件
• （4）添加腳本以及資源文件
• （5）勾選添加默認(rèn)lib
• （6）如果模塊是第一次還沒有燒錄過固件，或固件更換過，需要點(diǎn)擊"下載固件和腳本"進(jìn)行燒錄。如果固件不需要更改，只有腳本變動，只需要點(diǎn)擊"下載腳本"燒錄即可。
• （7）如果是開發(fā)板按住下載模式按鍵（boot 鍵）不放，同時(shí)再長按開機(jī)鍵開機(jī)，這時(shí)開發(fā)板會進(jìn)入下載模式，Luatools下載進(jìn)度條會開始跑，這時(shí)可以松開 boot 按鍵。直到工具提示下載完成。
• （8）如果是自己畫板，需要將模塊boot引腳按照對應(yīng)硬件手冊要求，拉高到對應(yīng)電平，再按住boot按鍵，上電開機(jī)，這時(shí)板子會進(jìn)入下載模式，Luatools下載進(jìn)度條會開始跑，這時(shí)可以松開 boot 按鍵。直到工具提示下載完成。

如果，未能成功進(jìn)入下載模式，而是進(jìn)入正常開機(jī)模式，這時(shí)可以按住 boot 鍵，再短按復(fù)位按鍵，讓開發(fā)板重啟，重新進(jìn)入下載模式。

如何判斷有沒有進(jìn)入下載模式:可以通過 PC 端的設(shè)備管理器中虛擬出來的 USB 斷開數(shù)量來判斷：

• 正常開機(jī)模式：

• 下載模式：

（二）視頻燒錄教程

點(diǎn)擊下方鏈接，觀看視頻燒錄教程：

[Air780E燒錄教程]

（三）串口固件燒錄

重要注意事項(xiàng)

• Cat.1模塊只有780E/780EX/780EP/780EQ/700ECQ/780EPS/Air201,支持串口燒錄，
• 只能通過main_uart（uart1）串口進(jìn)行燒錄，其他串口不行
• 使用串口燒錄的前提，是模塊在正常工作，所以串口燒錄不能救磚。
• 救磚一定要用 USB + boot 的方式燒錄；
• AT開發(fā)模式下，如果 main_uart 可以通過115200波特率正常通訊AT指令，那么可以不用重啟，只點(diǎn)擊下載，模塊會自動進(jìn)入下載模式。
• LuatOS開發(fā)模式下，串口燒錄時(shí)需要重啟，才可進(jìn)入下載模式。

1，AT開發(fā)模式

• (1)獲取對應(yīng)模塊的AT固件 獲取方式（其一） ：中的resource文件夾
• (2)勾選通用串口打印
• (3)選擇對應(yīng)的串口號
• (4)打開串口
• (5)開始打印
• (6)點(diǎn)擊下載固件
• (7)點(diǎn)擊選擇文件，選擇對應(yīng)的AT固件
• (8)如果main_uart可以通過115200波特率正常通訊AT指令，點(diǎn)擊下載，模塊會自動進(jìn)入下載模式。
• (9)如果不能通訊，請確保模塊復(fù)位或者下上電通過main_uart 115200波特率可以看到"RDY"的URC上報(bào)（串口功能正常），隨后點(diǎn)擊下載，如果模塊沒有進(jìn)入下載狀態(tài)，則按下復(fù)位或者重新上下電開機(jī)，則可以進(jìn)入下載狀態(tài)。

2，LuatOS開發(fā)模式

七、AT 指令交互

打開 AT 交互工具

Luatools 集成了一個精簡的 AT 指令交互工具。

點(diǎn)擊 "2，AT指令"菜單，選擇 “2.2 調(diào)試工具->2.2.1 內(nèi)置串口調(diào)試工具(簡約)”

即可打開串口交互工具。

如果模組里面是 AT 的標(biāo)準(zhǔn)固件的話， Luatools 會自動打開模組的 AT 命令的串口，

并發(fā)送幾條查詢指令給模組，如圖：

AT 命令交互

在彈出的串口工具編輯框，可以輸入 AT 指令， 勾選 “增加換行”，點(diǎn)擊發(fā)送，

可以在 trace 界面，看到交互的 AT 命令的發(fā)送和返回內(nèi)容，如圖：

回到頁面頂部

審核編輯 黃宇