Air780E軟件指南：模塊信息(hmeta)

合宙LuatOS

今天我會(huì )分享關(guān)于4G模組軟件的模塊信息之強基篇，其中詳細分析了模塊信息，必看版。

一、模塊信息概述

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

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

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

二、演示功能概述

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

三、硬件準備


3.1 Air780E核心板

使用Air780E核心板，

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

3.2 SIM卡

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

3.3 PC電腦

WINDOWS系統。

3.4 數據通信線(xiàn)

帶TYPE-C口的USB數據線(xiàn)。

四、軟件環(huán)境


4.1 Luatools工具

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

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

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

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

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

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

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

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

4.2 準備需要燒錄的代碼

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

4.2.1 燒錄的底層固件文件

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

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

4.2.2 燒錄的腳本代碼

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

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

下載流程參考下圖:

下載的文件解壓，找到LuatOS-Air780E-master\demo\hmeta\main.lua，如圖:

五、API說(shuō)明


5.1 mcu.unique_id()

獲取設備唯一id。

參數

無(wú)

返回值

[td]

返回值類(lèi)型	解釋
string	設備唯一id

例子

5.2 mobile.imei(index)

獲取設備IMEI

參數

[td]

傳入值類(lèi)型	解釋
int	編號,默認0.在支持雙卡的模塊上才會(huì )出現0或1的情況

返回值

[td]

返回值類(lèi)型	解釋
string	設備IMEI

例子

5.3 hmeta.model()

獲取硬件型號

參數

無(wú)

返回值

[td]

返回值類(lèi)型	解釋
string	若能識別到,返回硬件型號,否則會(huì )是nil

例子

5.4 rtos.bsp()

獲取硬件bsp型號

參數

無(wú)

返回值

[td]

返回值類(lèi)型	解釋
string	硬件bsp型號

例子

5.5 hmeta.hwver()

獲取模組的硬件版本號

參數

無(wú)

返回值

[td]

返回值類(lèi)型	解釋
string	若能識別到,返回模組的硬件版本號,否則會(huì )是nil

例子

5.6 rtos.version()

獲取固件版本號

參數

無(wú)

返回值

[td]

返回值類(lèi)型	解釋
string	固件版本號

例子

六、功能驗證


6.1 燒錄固件

​

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

使用帶有數據通信功能的數據線(xiàn)，不要使用僅有充電功能的數據線(xiàn).

6.1.2 識別4G模組的boot引腳

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

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

1、當我們模塊沒(méi)開(kāi)機時(shí)，按著(zhù)BOOT鍵然后長(cháng)按POW開(kāi)機。

2、當我們模塊開(kāi)機時(shí)，按著(zhù)BOOT鍵然后點(diǎn)按重啟鍵即可。

6.1.3 識別電腦的正確端口

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

6.1.4 用Luatools工具燒錄

新建項目

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

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

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

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

開(kāi)始燒錄

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

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

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

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

6.2 例程

6.3 對應log

七、總結

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

八、常見(jiàn)問(wèn)題


8.1 模塊唯一ID文檔

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

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

云平臺(openluat.com)