Luatools下載調(diào)試工具

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

此工具適用于合宙的SoC、cat1模塊、cat4模塊、2G模塊

環(huán)境要求

此工具運(yùn)行于win7及以上系統(tǒng)，不支持mac和linux

注：EC618（例：Air780E）、EC7XX（例：Air780EP/Air780EQ/Air700ECQ/Air201）芯片平臺(tái)的模塊由于USB驅(qū)動(dòng)適配，不支持在win10以下系統(tǒng)上使用

下載與安裝

Luatools下載

1. 直接下載：Luatools下載調(diào)試工具
2. 工具大全：LuatOS工具大全

Luatools安裝

1. 工具下載后的文件名為：Luatools_v2.exe

2.在win系統(tǒng)--D盤（或其他盤）推薦在根目錄下新建文件名并重命名為 LuaTools，目錄太深可能會(huì)導(dǎo)致工具某些功能會(huì)出問題。

3.將下載的Luatools_v2.exe拷貝或移動(dòng)到新建的LuaTools文件夾內(nèi) 注意：若出現(xiàn)危險(xiǎn)提醒，無需理會(huì)，繼續(xù)下載即可

4.鼠標(biāo)左鍵單擊Luatools_v2.exe后右鍵發(fā)送快捷方式到桌面即可

5.雙擊Luatools_v2.exe啟動(dòng)程序并更新 注意：如果有殺軟攔截，請(qǐng)務(wù)必通過！??！務(wù)必通過?。?！務(wù)必通過?。?！

6.更新完成后，LuaTools文件夾會(huì)生成幾個(gè)文件夾

功能介紹

文件夾功能介紹

1. _temp 文件夾：臨時(shí)文件

1. config 文件夾：對(duì)Luatools_v2進(jìn)行的一些配置會(huì)存放到這個(gè)文件夾

1. log 文件夾：里面存放有模塊輸出的各種日志信息，當(dāng)模塊出現(xiàn)問題需要向合宙技術(shù)人員尋求技術(shù)支持的時(shí)候，就需要提交這個(gè)目錄下的文件
   • 4gdiag 文件夾：ap和cp日志
   • ramdump 文件夾：死機(jī)dump文件
   • main_xxxxxx：模塊輸出的調(diào)試日志
   • trace_xxxxxx：Luatools工具輸出的日志

1. resource 文件夾：合宙模塊相關(guān)的AT固件，LuaTask開發(fā)的Core底層固件，Lib庫和demo腳本
   • aa_bb_lod 文件夾：aa表示芯片平臺(tái)，bb表示開發(fā)方式（at / lua）
   • 8910_script 文件夾：展銳8910平臺(tái)的demo和Lib
   • soc_script 文件夾：gitee luatos主倉庫更新的demo和Lib

1. project 文件夾：使用項(xiàng)目管理后會(huì)自動(dòng)生成這個(gè)目錄，用于管理下載項(xiàng)目

主界面介紹

1. 賬戶
   • 登錄：使用購買時(shí)銷售為你自動(dòng)創(chuàng)建的erp賬號(hào)登陸，可以在技術(shù)人員（FAE）遠(yuǎn)程支持客戶時(shí)協(xié)助抓取本機(jī)log
   • 合宙商城：鏈接至合宙商城
   • Luat物聯(lián)平臺(tái)：遠(yuǎn)程升級(jí)或debug時(shí)用，鏈接至合宙云平臺(tái)
   • 經(jīng)緯度查詢：開發(fā)基站定位時(shí)會(huì)用到，鏈接至定位查詢
   • 模塊生產(chǎn)信息查詢：查詢模塊出廠信息時(shí)用，鏈接至合宙售后管理系統(tǒng)
   • 官方淘寶店：合宙官方的淘寶店，鏈接至上海合宙LuatOS官方企業(yè)店
   • DTU管理平臺(tái)：鏈接至DTU管理系統(tǒng)
   • Exit：退出工具

固件相關(guān)

• 4G-Cat.1：4G-Cat.1模組固件相關(guān)的操作

• MCU/SOC：MCU/SOC相關(guān)資料與文檔

• 產(chǎn)品中心：合宙官網(wǎng)，鏈接至上海合宙通信

選項(xiàng)與工具

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

• SOC差分/整包升級(jí)包制作工具：可生成差分包或整包，用于FOTA遠(yuǎn)程升級(jí)使用，由于部分模塊不支持在該工具上生成，具體以各模塊FOTA遠(yuǎn)程升級(jí)例程上的要求為準(zhǔn)

• 固件合并文件工具：固件合入bin文件，EC618（例如780E等）使用xxx.binpkg，EC7XX（例如780EP等）使用xxx.soc

• Soc轉(zhuǎn)binpkg量產(chǎn)文件：

• 內(nèi)置串口調(diào)試工具（簡(jiǎn)約）

合宙特色服務(wù)

• ERP模塊生產(chǎn)記錄：輸入IMEI號(hào)可直接查詢模塊生產(chǎn)信息

• FOTA遠(yuǎn)程升級(jí)服務(wù)：在IOT平臺(tái)通過一系列操作后可對(duì)模塊進(jìn)行FOTA遠(yuǎn)程升級(jí)操作，與之同時(shí)還可以進(jìn)行實(shí)時(shí)調(diào)試等操作。鏈接至：合宙云平臺(tái)

• LBS基站定位服務(wù)：

• NetLab公網(wǎng)透?jìng)髡{(diào)試：可進(jìn)行TCP/UDP透?jìng)鳒y(cè)試。鏈接至：LuatOS 網(wǎng)絡(luò)測(cè)試工具

• Air7xxUx系列差分服務(wù)：用于Air7xxUx系列差分包生成服務(wù)。鏈接至：差分包服務(wù)

• DTU透?jìng)鞴碳╥RTU）：鏈接至：iRTU

• IotProxy云平臺(tái)密鑰分發(fā)服務(wù)：各云平臺(tái)密鑰分發(fā)。鏈接至：iot-regproxy

資源目錄

• 固件和demo目錄：[文件夾功能介紹](# 文件夾功能介紹)中所提及的resource文件夾
• 本地日志目錄：[文件夾功能介紹](# 文件夾功能介紹)中所提及的log文件夾
• 本地項(xiàng)目目錄：[文件夾功能介紹](# 文件夾功能介紹)中所提及的project文件夾
• Iot自助綁定固件：
• 歷史版本工具和固件下載：工具、固件、文檔等一系列資料。鏈接至：合宙云盤目錄

1. 幫助
   • LuaTools教程：LuaTools 上手教程。鏈接至：LuaTools 上手教程
   • Luat社區(qū)：各種模塊資料、lua入門教程和工具等。鏈接至：Luat社區(qū)
   • LuatOS-Air入門教程：LuatOS-Air二次開發(fā)入門教程。鏈接至：Luat入門教程
   • 技術(shù)支持QQ群：有解決不了的問題可加群詢問。
   • wiki：鏈接至：LuatOS文檔
   • 銷售總監(jiān)：有需要購買可聯(lián)系陸總
   • 檢查新版本：?jiǎn)?dòng)軟件時(shí)會(huì)自動(dòng)檢查是否有新版本，也可通過手動(dòng)點(diǎn)擊檢查
   • 每日tips

日志打印窗口

• 支持4G模塊USB（默認(rèn)）打印和通用串口打印日志
• 在非USB打印時(shí)，可選擇通用串口工具在windows設(shè)備管理器對(duì)應(yīng)的端口號(hào)，例如USB-TTL：

• 開始/停止打印可以暫停文本區(qū)的自動(dòng)滾動(dòng)打印
• 清除打印可以清空文本區(qū)的打印日志，但是不會(huì)刪除log文件夾下的文件內(nèi)容

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

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

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

1. 項(xiàng)目管理入口
   • 詳細(xì)操作教程在[項(xiàng)目管理](# 項(xiàng)目管理)

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

1. 底部鏈接
   • 鼠標(biāo)懸停至窗口四個(gè)邊或四個(gè)角，可對(duì)窗口進(jìn)行大小縮放

日志查看

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

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

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

項(xiàng)目管理

在使用LuaTools下載源碼時(shí)，強(qiáng)烈建議使用項(xiàng)目管理來進(jìn)行下載，每個(gè)下載都用一個(gè)項(xiàng)目來區(qū)分。

新建項(xiàng)目

創(chuàng)建項(xiàng)目

輸入TestSocket然后確定

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

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

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

固件燒錄（USB燒錄）

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

AT開發(fā)

點(diǎn)擊下載固件按鈕。

選中要下載的AT固件

如果是開發(fā)板按住下載模式按鍵（boot 鍵）不放，同時(shí)再長(zhǎng)按開機(jī)鍵開機(jī)，這時(shí)開發(fā)板會(huì)進(jìn)入下載模式，Luatools下載進(jìn)度條會(huì)開始跑，這時(shí)可以松開 boot 按鍵。直到工具提示下載完成。

如果是自己畫板，需要將模塊boot引腳按照對(duì)應(yīng)硬件手冊(cè)要求，拉高到對(duì)應(yīng)電平，再按住boot按鍵，上電開機(jī)，這時(shí)板子會(huì)進(jìn)入下載模式，Luatools下載進(jìn)度條會(huì)開始跑，這時(shí)可以松開 boot 按鍵。直到工具提示下載完成。

LuatOS開發(fā)

在Luatools工具主界面點(diǎn)擊"項(xiàng)目管理測(cè)試"

如果沒有新建過項(xiàng)目，需要先建立一個(gè)項(xiàng)目

選擇底層固件 .soc文件

添加腳本以及資源文件

勾選添加默認(rèn)lib

如果模塊是第一次還沒有燒錄過固件，或固件更換過，需要點(diǎn)擊"下載固件和腳本"進(jìn)行燒錄。如果固件不需要更改，只有腳本變動(dòng)，只需要點(diǎn)擊"下載腳本"燒錄即可。

如果是開發(fā)板按住下載模式按鍵（boot 鍵）不放，同時(shí)再長(zhǎng)按開機(jī)鍵開機(jī)，這時(shí)開發(fā)板會(huì)進(jìn)入下載模式，Luatools下載進(jìn)度條會(huì)開始跑，這時(shí)可以松開 boot 按鍵。直到工具提示下載完成。

如果是自己畫板，需要將模塊boot引腳按照對(duì)應(yīng)硬件手冊(cè)要求，拉高到對(duì)應(yīng)電平，再按住boot按鍵，上電開機(jī)，這時(shí)板子會(huì)進(jìn)入下載模式，Luatools下載進(jìn)度條會(huì)開始跑，這時(shí)可以松開 boot 按鍵。直到工具提示下載完成。

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

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

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

• 下載模式：

視頻燒錄教程

【LuatOS-Air】Air780E燒錄教程

固件燒錄（Uart燒錄）

注意事項(xiàng)

• Cat.1模塊只有780E/780EP/780EQ/700ECQ...移芯芯片平臺(tái)的支持串口燒錄，也只能通過main_uart（uart1）串口進(jìn)行燒錄，其他串口不行
• 使用串口的前提是模塊可以正常工作，所以串口燒錄不能救磚。需要救磚還是要用usb+boot的方式燒錄
• AT開發(fā)如果main_uart可以通過115200波特率正常通訊AT指令，那么可以不用重啟，只點(diǎn)擊下載，模塊會(huì)自動(dòng)進(jìn)入下載模式。
• LuatOS開發(fā)串口燒錄時(shí)需要重啟下，才可進(jìn)入下載模式。

AT開發(fā)

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

LuatOS開發(fā)

• 選擇開發(fā)用到的core+腳本+lib后，生成LuatOS量產(chǎn)固件（后綴為 .soc）
• 8910平臺(tái)量產(chǎn)固件生成路徑在 "Luatools工具目錄\4G量產(chǎn)文件"
• 618/718P/716E/716S平臺(tái)量產(chǎn)固件生成路徑在 "Luatools工具目錄\SOC量產(chǎn)及遠(yuǎn)程升級(jí)文件\xxx對(duì)應(yīng)芯片平臺(tái)文件夾內(nèi)"
• 得到固件之后，仿照AT開發(fā)的固件燒錄教程進(jìn)行燒錄即可