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

1、模塊信息概述

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

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

模塊遠(yuǎn)程升級(jí)需要上傳模塊信息，解決和分析某些問題的時(shí)候可能也會(huì)需要確認(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)品手冊(cè)中的《開發(fā)板Core_Air780E使用說明VX.X.X.pdf》，寫這篇文章時(shí)最新版本的使用說明為：《開發(fā)板Core_Air780E使用說明V1.0.5.pdf》；核心板使用過程中遇到任何問題，可以直接參考這份使用說明pdf文檔。

3.2 SIM卡

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

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工具集具備以下幾大核心功能：

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

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

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

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

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

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

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

4.2.1 燒錄的底層固件文件

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

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

4.2.2 燒錄的腳本代碼

首先，要下載Air780的LuatOS示例代碼到一個(gè)合適的項(xiàng)目目錄。

示例代碼網(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()

獲取硬件型號(hào)

參數(shù)

無

返回值

例子

5.4 rtos.bsp()

獲取硬件bsp型號(hào)

參數(shù)

無

返回值

例子

5.5 hmeta.hwver()

獲取模組的硬件版本號(hào)

參數(shù)

無

返回值

例子

5.6 rtos.version()

獲取固件版本號(hào)

參數(shù)

無

返回值

例子

6、功能驗(yàn)證

6.1 燒錄固件

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

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

6.1.2 識(shí)別4G模組的boot引腳

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

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

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

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

6.1.3 識(shí)別電腦的正確端口

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

6.1.4 用Luatools工具燒錄

新建項(xiàng)目

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

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

Luatools版本沒問題的話，就點(diǎn)擊Luatools右上角的“項(xiàng)目管理測(cè)試”按鈕，如下圖所示：

這時(shí)會(huì)彈出項(xiàng)目管理和燒錄管理的對(duì)話框，可以新建一個(gè)項(xiàng)目,如下圖：

開始燒錄

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

點(diǎn)擊下載后，我們需要進(jìn)入boot模式才能正常下載.

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

進(jìn)入boot模式下載,如圖:

6.2 例程

6.3 對(duì)應(yīng)log

7、總結(jié)

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

8、常見問題

8.1 模塊唯一ID文檔

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

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

分享完畢

審核編輯 黃宇