Luatools下載調試工具

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

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

環境要求

此工具運行于win7及以上系統，不支持mac和linux

注：EC618（例：Air780E）、EC7XX（例：Air780EP/Air780EQ/Air700ECQ/Air201）芯片平臺的模塊由于USB驅動適配，不支持在win10以下系統上使用

下載與安裝

Luatools下載

1. 直接下載：Luatools下載調試工具
2. 工具大全：LuatOS工具大全

Luatools安裝

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

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

3.將下載的Luatools_v2.exe拷貝或移動到新建的LuaTools文件夾內 注意：若出現危險提醒，無需理會，繼續下載即可

4.鼠標左鍵單擊Luatools_v2.exe后右鍵發送快捷方式到桌面即可

5.雙擊Luatools_v2.exe啟動程序并更新 注意：如果有殺軟攔截，請務必通過！！！務必通過！！！務必通過！！！

6.更新完成后，LuaTools文件夾會生成幾個文件夾

功能介紹

文件夾功能介紹

1. _temp 文件夾：臨時文件

1. config 文件夾：對Luatools_v2進行的一些配置會存放到這個文件夾

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

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

1. project 文件夾：使用項目管理后會自動生成這個目錄，用于管理下載項目

主界面介紹

1. 賬戶
   • 登錄：使用購買時銷售為你自動創建的erp賬號登陸，可以在技術人員（FAE）遠程支持客戶時協助抓取本機log
   • 合宙商城：鏈接至合宙商城
   • Luat物聯平臺：遠程升級或debug時用，鏈接至合宙云平臺
   • 經緯度查詢：開發基站定位時會用到，鏈接至定位查詢
   • 模塊生產信息查詢：查詢模塊出廠信息時用，鏈接至合宙售后管理系統
   • 官方淘寶店：合宙官方的淘寶店，鏈接至上海合宙LuatOS官方企業店
   • DTU管理平臺：鏈接至DTU管理系統
   • Exit：退出工具

固件相關

• 4G-Cat.1：4G-Cat.1模組固件相關的操作

• MCU/SOC：MCU/SOC相關資料與文檔

• 產品中心：合宙官網，鏈接至上海合宙通信

選項與工具

• 工具配置：點擊log，當配合技術人員抓取bug日志時在此頁面打開log功能，例如AP與CP日志，若使用工具經常遇到藍屏，可先關閉底層日志的抓取

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

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

• Soc轉binpkg量產文件：

• 內置串口調試工具（簡約）

合宙特色服務

• ERP模塊生產記錄：輸入IMEI號可直接查詢模塊生產信息

• FOTA遠程升級服務：在IOT平臺通過一系列操作后可對模塊進行FOTA遠程升級操作，與之同時還可以進行實時調試等操作。鏈接至：合宙云平臺

• LBS基站定位服務：

• NetLab公網透傳調試：可進行TCP/UDP透傳測試。鏈接至：LuatOS 網絡測試工具

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

• DTU透傳固件（iRTU）：鏈接至：iRTU

• IotProxy云平臺密鑰分發服務：各云平臺密鑰分發。鏈接至：iot-regproxy

資源目錄

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

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

日志打印窗口

• 支持4G模塊USB（默認）打印和通用串口打印日志
• 在非USB打印時，可選擇通用串口工具在windows設備管理器對應的端口號，例如USB-TTL：

• 開始/停止打印可以暫停文本區的自動滾動打印
• 清除打印可以清空文本區的打印日志，但是不會刪除log文件夾下的文件內容

模塊狀態顯示窗口

• 啟動原因：模塊開機原因
• 系統狀態：如果文本區中存在對應的日志，這里會顯示SIM卡、網絡注冊等信息
• 固件版本：這里僅僅顯示core的版本信息，例如AT或者Luat的版本信息，不顯示Lib和用戶腳本的版本號
• 小區信號：顯示模塊接入主小區 RSRQ、RSRP、SNR 信號值
• 信號強度：這里顯示GSM的信號強度。信號強度與卡是否欠費無關，不插卡也可以有信號強度
• 當前網絡：網絡類型，例如 4G網絡
• 軟件類型：這里是指Core的類型，例如Luatask或者AT
• 小區ID：顯示模塊接入主小區的cellid

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

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

1. 搜索打印
   • 通過關鍵詞搜索可直接跳轉到與之相匹配內容行

1. 底部鏈接
   • 鼠標懸停至窗口四個邊或四個角，可對窗口進行大小縮放

日志查看

使用Luatools文本區查看日志

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

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

項目管理

在使用LuaTools下載源碼時，強烈建議使用項目管理來進行下載，每個下載都用一個項目來區分。

新建項目

創建項目

輸入TestSocket然后確定

單擊TestSocket項目，在右側分別填入

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

注意，首次下載時，強烈建議直接下載底層和腳本

固件燒錄（USB燒錄）

首先USB連接PC，保持上電不開機狀態

AT開發

點擊下載固件按鈕。

選中要下載的AT固件

如果是開發板按住下載模式按鍵（boot 鍵）不放，同時再長按開機鍵開機，這時開發板會進入下載模式，Luatools下載進度條會開始跑，這時可以松開 boot 按鍵。直到工具提示下載完成。

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

LuatOS開發

在Luatools工具主界面點擊"項目管理測試"

如果沒有新建過項目，需要先建立一個項目

選擇底層固件 .soc文件

添加腳本以及資源文件

勾選添加默認lib

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

如果是開發板按住下載模式按鍵（boot 鍵）不放，同時再長按開機鍵開機，這時開發板會進入下載模式，Luatools下載進度條會開始跑，這時可以松開 boot 按鍵。直到工具提示下載完成。

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

如果，未能成功進入下載模式，而是進入正常開模式，這時可以按住 boot 鍵，再短按復位按鍵，讓開發板重啟，重新進入下載模式。

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

• 正常開機模式：

• 下載模式：

視頻燒錄教程

【LuatOS-Air】Air780E燒錄教程

固件燒錄（Uart燒錄）

注意事項

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

AT開發

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

LuatOS開發

• 選擇開發用到的core+腳本+lib后，生成LuatOS量產固件（后綴為 .soc）
• 8910平臺量產固件生成路徑在 "Luatools工具目錄\4G量產文件"
• 618/718P/716E/716S平臺量產固件生成路徑在 "Luatools工具目錄\SOC量產及遠程升級文件\xxx對應芯片平臺文件夾內"
• 得到固件之后，仿照AT開發的固件燒錄教程進行燒錄即可