Air780E软件指南：模块信息(hmeta)

今天我会分享关于4G模组软件的模块信息之强基篇，其中详细分析了模块信息，必看版。
一、模块信息概述模块信息是每一个模块携带的信息,就像人的身份证一样,这些信息确定了模块的唯一性;包含设备唯一id,硬件型号,模组的硬件版本号,固件版本号等;模块远程升级需要上传模块信息，解决和分析某些问题的时候可能也会需要确认模块信息。

二、演示功能概述使用Air780E核心板烧录底层固件(LuatOS-SoC_V1112_EC618_FULL.soc)和hmeta例程脚本学习有关模块信息的api函数.


三、硬件准备


3.1 Air780E核心板使用Air780E核心板，此核心板的详细使用说明参考：
https://docs.openluat.com/air780e/

3.2 SIM卡中国大陆环境下，可以上网的sim卡,一般来说，使用移动，电信，联通的物联网卡或者手机卡都行。
3.3 PC电脑WINDOWS系统。
3.4 数据通信线带TYPE-C口的USB数据线。


四、软件环境


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，如图:




五、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.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模式会出现下图情况:




6.2 例程


6.3 对应log



七、总结通过本章学习，你可以学习到模块唯一ID，模块硬件型号，固件版本，硬件版本的获取方法.



八、常见问题


8.1 模块唯一ID文档mobile.sn()获取SN，出厂未必有写SN;一般用途的唯一id,可以用mobile.imei()代替;如需要真正的唯一ID,使用mcu.unique_id()
8.2 通过IMEI查询模块生产记录云平台(openluat.com)