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

合宙LuatOS

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

一、模塊信息概述

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

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

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

二、演示功能概述

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

三、硬件準(zhǔn)備


3.1 Air780E核心板

使用Air780E核心板，

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

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ù)線。

四、軟件環(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)試助手：提供簡潔的串口調(diào)試界面，滿足基本的串口通信測試需求.

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-master\demo\hmeta\main.lua，如圖:

五、API說明


5.1 mcu.unique_id()

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

參數(shù)

無

返回值

[td]

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

例子

5.2 mobile.imei(index)

獲取設(shè)備IMEI

參數(shù)

[td]

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

返回值

[td]

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

例子

5.3 hmeta.model()

獲取硬件型號

參數(shù)

無

返回值

[td]

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

例子

5.4 rtos.bsp()

獲取硬件bsp型號

參數(shù)

無

返回值

[td]

返回值類型	解釋
string	硬件bsp型號

例子

5.5 hmeta.hwver()

獲取模組的硬件版本號

參數(shù)

無

返回值

[td]

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

例子

5.6 rtos.version()

獲取固件版本號

參數(shù)

無

返回值

[td]

返回值類型	解釋
string	固件版本號

例子

六、功能驗(yàn)證


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按鍵時(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 識別電腦的正確端口

判斷是否進(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)目管理測試”按鈕，如下圖所示：

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

開始燒錄

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

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

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

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

6.2 例程

6.3 對應(yīng)log

七、總結(jié)

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

八、常見問題


8.1 模塊唯一ID文檔

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

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

云平臺(tái)(openluat.com)

zmx212

好東東