今天我講解的這篇關於4G模組軟體的模組資訊屬於必讀篇，望珍惜！
1、模組資訊概述
模組資訊是每一個模組攜帶的資訊,就像人的身份證一樣,這些資訊確定了模組的唯一性;
包含裝置唯一id,硬體型號,模組的硬體版本號,韌體版本號等;
模組遠端升級需要上傳模組資訊，解決和分析某些問題的時候可能也會需要確認模組資訊。
2、演示功能概述
使用Air780E核心板燒錄底層韌體(LuatOS-SoC_V1112_EC618_FULL.soc)和hmeta例程指令碼學習有關模組資訊的api函式.
3、硬體準備
3.1 Air780E核心板
使用Air780E核心板，
此核心板的詳細使用說明參考：
https://docs.openluat.com/air780e/
Air780E產品手冊中的《開發板Core_Air780E使用說明VX.X.X.pdf》，寫這篇文章時最新版本的使用說明為：《開發板Core_Air780E使用說明V1.0.5.pdf》；核心板使用過程中遇到任何問題，可以直接參考這份使用說明pdf文件。
3.2 SIM卡
中國大陸環境下，可以上網的sim卡,一般來說，使用移動，電信，聯通的物聯網路卡或者手機卡都行。
3.3 PC電腦
WINDOWS系統。
3.4 資料通訊線
帶TYPE-C口的USB資料線。
4、軟體環境
4.1 Luatools工具
要想燒錄LuatOS韌體到4G模組中，需要用到的除錯工具：Luatools；
詳細使用說明參考：
Luatools工具使用說明：
https://docs.openluat.com/Luatools/
Luatools工具集具備以下幾大核心功能：
一鍵獲取最新韌體：自動連線伺服器，輕鬆下載最新的模組韌體.
韌體與指令碼燒錄：便捷地將韌體及指令碼檔案燒錄至目標模組中.
串列埠日誌管理：實時檢視模組透過串列埠輸出的日誌資訊，並支援儲存功能.
串列埠除錯助手：提供簡潔的串列埠除錯介面，滿足基本的串列埠通訊測試需求.
Luatools下載之後，新建一個命名為"Luatools"的資料夾,將下載的Luatools_v3.exe複製或移動到新建的Luatools資料夾內，點選Luatools_v3.exe即可執行.
4.2 準備需要燒錄的程式碼
首先要說明一點：指令碼程式碼，要和韌體的soc檔案一起燒錄.
4.2.1 燒錄的底層韌體檔案
底層core下載地址：LuatOS韌體版本下載地址
Air780E的底層韌體在Luatools解壓後目錄的：
LuatOS-SoC_V1112_EC618_FULL.soc
4.2.2 燒錄的指令碼程式碼
首先，要下載Air780的LuatOS示例程式碼到一個合適的專案目錄。
示例程式碼網站：
https://gitee.com/openLuat/LuatOS-Air780E
下載流程參考下圖:
下載的檔案解壓，找到LuatOS-Air780E-master\demo\hmeta\main.lua，如圖:
5、API說明
5.1 mcu.unique_id()
獲取裝置唯一id。
引數
無
返回值
返回值型別 解釋
string
裝置唯一id
例子
5.2 mobile.imei(index)
獲取裝置IMEI
引數
傳入值型別 解釋
int
編號,預設0.在支援雙卡的模組上才會出現0或1的情況
返回值
返回值型別 解釋
string
裝置IMEI
例子
5.3 hmeta.model()
獲取硬體型號
引數
無
返回值
返回值型別 解釋
string
若能識別到,返回硬體型號,否則會是nil
例子
5.4 rtos.bsp()
獲取硬體bsp型號
引數
無
返回值
返回值型別 解釋
string
硬體bsp型號
例子
5.5 hmeta.hwver()
獲取模組的硬體版本號
引數
無
返回值
返回值型別 解釋
string
若能識別到,返回模組的硬體版本號,否則會是nil
例子
5.6 rtos.version()
獲取韌體版本號
引數
無
返回值
返回值型別 解釋
string
韌體版本號
例子
6、功能驗證
6.1 燒錄韌體
6.1.1 正確連線電腦和4G模組電路板
使用帶有資料通訊功能的資料線，不要使用僅有充電功能的資料線.
6.1.2 識別4G模組的boot引腳
在下載之前，要用模組的boot引腳觸發下載，也就是說，要把4G模組的boot引腳拉到1.8v，或者直接把boot引腳和VDD_EXT引腳相連.我們要在按下BOOT按鍵時讓模組開機，就可以進入下載模式了.
具體到Air780E開發板:
1、當我們模組沒開機時，按著BOOT鍵然後長按POW開機。
2、當我們模組開機時，按著BOOT鍵然後點按重啟鍵即可。
6.1.3 識別電腦的正確埠
判斷是否進入BOOT模式：模組上電，此時在電腦的裝置管理器中，檢視串列埠裝置，會出現一個埠表示進入了boot下載模式，如下圖所示：
6.1.4 用Luatools工具燒錄
新建專案
首先，確保你的Luatools的版本，大於等於3.0.6版本的.
在Luatools的左上角上有版本顯示的，如圖所示：
Luatools版本沒問題的話，就點選Luatools右上角的“專案管理測試”按鈕，如下圖所示：
這時會彈出專案管理和燒錄管理的對話方塊，可以新建一個專案,如下圖：
開始燒錄
選擇Air780E板子對應的底層core和剛改的main.lua指令碼檔案.下載到板子中.
點選下載後，我們需要進入boot模式才能正常下載.
如果沒進入boot模式會出現下圖情況:
進入boot模式下載,如圖:
6.2 例程
6.3 對應log
7、總結
透過本章學習，你可以學習到模組唯一ID，模組硬體型號，韌體版本，硬體版本的獲取方法.
8、常見問題
8.1 模組唯一ID文件
mobile.sn()獲取SN，出廠未必有寫SN;一般用途的唯一id,可以用mobile.imei()代替;如需要真正的唯一ID,使用mcu.unique_id()
8.2 透過IMEI查詢模組生產記錄
分享完畢