今天我會把4G模組的模塊信息做出詳細(xì)介紹，做出示例，展示給大家，如果覺得有用的話請點贊收藏。

1、模塊信息概述

模塊信息是每一個模塊攜帶的信息,就像人的身份證一樣,這些信息確定了模塊的唯一性;

包含設(shè)備唯一id,硬件型號,模組的硬件版本號,固件版本號等;

模塊遠程升級需要上傳模塊信息，解決和分析某些問題的時候可能也會需要確認(rèn)模塊信息。

2、演示功能概述

使用Air780E核心板燒錄底層固件(LuatOS-SoC_V1112_EC618_FULL.soc)和hmeta例程腳本學(xué)習(xí)有關(guān)模塊信息的api函數(shù).

3、硬件準(zhǔn)備

3.1 Air780E核心板

使用Air780E核心板，如下圖所示：

此核心板的詳細(xì)使用說明參考：
https://docs.openluat.com/air780e/

Air780E產(chǎn)品手冊中的《開發(fā)板Core_Air780E使用說明VX.X.X.pdf》，寫這篇文章時最新版本的使用說明為：《開發(fā)板Core_Air780E使用說明V1.0.5.pdf》；核心板使用過程中遇到任何問題，可以直接參考這份使用說明pdf文檔。

3.2 SIM卡

中國大陸環(huán)境下，可以上網(wǎng)的sim卡,一般來說，使用移動，電信，聯(lián)通的物聯(lián)網(wǎng)卡或者手機卡都行。

3.3 PC電腦

WINDOWS系統(tǒng)。

3.4 數(shù)據(jù)通信線

帶TYPE-C口的USB數(shù)據(jù)線。

4、軟件環(huán)境

4.1 Luatools工具

要想燒錄LuatOS固件到4G模組中，需要用到的調(diào)試工具：Luatools；

詳細(xì)使用說明參考：
Luatools工具使用說明：
https://docs.openluat.com/Luatools/

Luatools工具集具備以下幾大核心功能：

一鍵獲取最新固件：自動連接服務(wù)器，輕松下載最新的模組固件.

固件與腳本燒錄：便捷地將固件及腳本文件燒錄至目標(biāo)模組中.

串口日志管理：實時查看模組通過串口輸出的日志信息，并支持保存功能.

串口調(diào)試助手：提供簡潔的串口調(diào)試界面，滿足基本的串口通信測試需求.

Luatools下載之后，新建一個命名為"Luatools"的文件夾,將下載的Luatools_v3.exe拷貝或移動到新建的Luatools文件夾內(nèi)，點擊Luatools_v3.exe即可運行.

4.2 準(zhǔn)備需要燒錄的代碼

首先要說明一點：腳本代碼，要和固件的soc文件一起燒錄.

4.2.1 燒錄的底層固件文件

底層core下載地址：LuatOS固件版本下載地址

Air780E的底層固件在Luatools解壓后目錄的：
LuatOS-SoC_V1112_EC618_FULL.soc

4.2.2 燒錄的腳本代碼

首先，要下載Air780的LuatOS示例代碼到一個合適的項目目錄。

示例代碼網(wǎng)站：
https://gitee.com/openLuat/LuatOS-Air780E

下載流程參考下圖:

下載的文件解壓，找到LuatOS-Air780E-masterdemohmetamain.lua，如圖:

5、API說明

5.1 mcu.unique_id()

獲取設(shè)備唯一id。

參數(shù)

無

返回值

例子

5.2 mobile.imei(index)

獲取設(shè)備IMEI

參數(shù)

返回值

例子

5.3 hmeta.model()

獲取硬件型號

參數(shù)

無

返回值

例子

5.4 rtos.bsp()

獲取硬件bsp型號

參數(shù)

無

返回值

例子

5.5 hmeta.hwver()

獲取模組的硬件版本號

參數(shù)

無

返回值

例子

5.6 rtos.version()

獲取固件版本號

參數(shù)

無

返回值

例子

6、功能驗證

6.1 燒錄固件

6.1.1 正確連接電腦和4G模組電路板

使用帶有數(shù)據(jù)通信功能的數(shù)據(jù)線，不要使用僅有充電功能的數(shù)據(jù)線.

6.1.2 識別4G模組的boot引腳

在下載之前，要用模組的boot引腳觸發(fā)下載，也就是說，要把4G模組的boot引腳拉到1.8v，或者直接把boot引腳和VDD_EXT引腳相連.我們要在按下BOOT按鍵時讓模塊開機，就可以進入下載模式了.

具體到Air780E開發(fā)板:

1、當(dāng)我們模塊沒開機時，按著BOOT鍵然后長按POW開機。

2、當(dāng)我們模塊開機時，按著BOOT鍵然后點按重啟鍵即可。

6.1.3 識別電腦的正確端口

判斷是否進入BOOT模式：模塊上電，此時在電腦的設(shè)備管理器中，查看串口設(shè)備，會出現(xiàn)一個端口表示進入了boot下載模式，如下圖所示：

6.1.4 用Luatools工具燒錄

新建項目

首先，確保你的Luatools的版本，大于等于3.0.6版本的.

在Luatools的左上角上有版本顯示的，如圖所示：

Luatools版本沒問題的話，就點擊Luatools右上角的“項目管理測試”按鈕，如下圖所示：

這時會彈出項目管理和燒錄管理的對話框，可以新建一個項目,如下圖：

開始燒錄

選擇Air780E板子對應(yīng)的底層core和剛改的main.lua腳本文件.下載到板子中.

點擊下載后，我們需要進入boot模式才能正常下載.

如果沒進入boot模式會出現(xiàn)下圖情況:

進入boot模式下載,如圖:

6.2 例程

6.3 對應(yīng)log

7、總結(jié)

通過本章學(xué)習(xí)，你可以學(xué)習(xí)到模塊唯一ID，模塊硬件型號，固件版本，硬件版本的獲取方法.

8、常見問題

8.1 模塊唯一ID文檔

mobile.sn()獲取SN，出廠未必有寫SN;一般用途的唯一id,可以用mobile.imei()代替;如需要真正的唯一ID,使用mcu.unique_id()

8.2 通過IMEI查詢模塊生產(chǎn)記錄

分享完畢

審核編輯 黃宇