跳转至

1 模组信息(hmeta)

作者：沈园园　|　最后修改：2026-08-17

一、hmeta 概述

hmeta 库用于获取合宙模组的硬件元数据信息，这些信息确定了模组的唯一性，就像人的身份证一样。

硬件元数据包含模组的型号、模组的硬件版本号、原始芯片型号，以及模组识别 ID（muid、devid）等信息。

模组远程升级需要上传模组信息，解决和分析某些问题的时候可能也会需要确认模组信息，使用 hmeta 库可以快速获取这些信息。

二、演示功能概述

本 demo 演示了 hmeta 核心库的常用 API 使用方法：

1、获取模组名称；

2、获取模组硬件版本号；

3、获取原始芯片型号；

4、获取模组 muid（模组唯一标识，32 字节字符串）；

5、获取模组识别 id（4G 模组即为 IMEI）。

三、准备硬件环境

1、Air724UG 核心板一块（或 EVB_Air724UG_A14 开发板）

2、TYPE-C USB 数据线一根（使用核心板时）；开发板（EVB_Air724UG_A14）为 Micro-USB 接口，需使用 Micro-USB 数据线

3、Air724UG 核心板/开发板和数据线的硬件接线方式为

  • Air724UG 核心板通过 TYPE-C USB 口（开发板通过 Micro-USB 口）连接 USB 数据线，数据线的另外一端连接电脑的 USB 口；

  • Air724UG 核心板/开发板通过 USB 口供电，同时用于烧录固件和查看日志；

更详细的硬件环境说明参考：Air724UG 硬件环境清单。

Air724UG 核心板购买链接：合宙官方淘宝店铺

四、准备软件环境

4.1 软件环境

在开始实践本示例之前，先筹备一下软件环境：

1、烧录工具：Luatools 下载调试工具

2、本 demo 开发测试时使用的固件为Air724UG LuatOS固件，本 demo 对固件版本没有什么特殊要求，所以你如果要测试本 demo 时，可以直接使用最新版本的内核固件；如果发现最新版本的内核固件测试有问题，可以使用我们开发本 demo 时使用的内核固件版本来对比测试；

3、脚本文件：https://gitee.com/openLuat/LuatOS/tree/master/module/Air724/demo/hmeta

4、扩展库脚本文件：使用 Luatools 烧录时，勾选 添加默认扩展库 选项，使用默认扩展库脚本文件

准备好软件环境之后，接下来查看如何烧录项目文件到Air724UG核心板，将本篇文章中演示使用的项目文件烧录到 Air724UG 核心板中。

4.2 API 介绍

hmeta 库：https://docs.openluat.com/osapi/core/hmeta/

五、程序结构

hmeta/
│── main.lua
│── hmeta_app.lua
│── readme.md

5.1 文件说明

  1. main.lua：主程序入口文件，负责定义项目名和版本号、加载业务模块，最后调用 sys.run() 启动 LuatOS 运行框架。

  2. hmeta_app.lua：hmeta 应用功能模块，通过 hmeta 核心库获取模组信息并打印日志。

六、代码详解

6.1 main.lua

主程序文件 main.lua 是整个项目的入口点。它负责定义 PROJECT 和 VERSION 变量、打印项目信息、加载业务模块，最后调用 sys.run() 启动 LuatOS 运行框架。

6.2 hmeta_app.lua

hmeta 应用功能模块，核心业务逻辑为：创建一个 task 协程，在协程中每隔 3 秒获取一次模组信息并打印日志。

6.2.1 获取模组信息并打印

-- hmeta任务主函数
local function hmeta_task_func()
    while true do
        -- 打印模组名称、硬件版本号、原始芯片型号
        log.info("hmeta", hmeta.model(), hmeta.hwver(), hmeta.chip())
        -- 打印模组muid（模组唯一标识，32字节字符串）
        log.info("hmeta", "muid:", hmeta.muid())
        -- 打印模组识别id（4G模组即为IMEI）
        log.info("hmeta", "devid:", hmeta.devid())
        sys.wait(3000)  -- 每隔三秒钟获取一次模组信息
    end
end

--创建一个task，并且运行task的主函数hmeta_task_func
sys.taskInit(hmeta_task_func)

七、运行结果展示

烧录成功后，自动开机运行。出现类似于下面的日志，就表示运行成功：

I/user.hmeta    Air724UG    A11 8910
I/user.hmeta    muid:   20250724040624A234339A8164909044
I/user.hmeta    devid:  866965083774767
I/user.hmeta    Air724UG    A11 8910
I/user.hmeta    muid:   20250724040624A234339A8164909044
I/user.hmeta    devid:  866965083774767

八、总结

通过本文学习，你可以学习到 hmeta 核心库的常用 API 使用方法，包括获取模组名称、硬件版本号、芯片型号、模组 muid 和识别 id，为后续远程升级、设备管理、问题排查等业务打下基础。

搜索