05 模块信息(hmeta)

作者：沈园园　|　最后修改：2026-04-27

一、硬件元数据概述

硬件元数据是合宙每一个模块携带的信息,就像人的身份证一样，这些信息确定了模块的唯一性；

硬件元数据，包含模组的型号，模组的硬件版本号，原始芯片型号;

模块远程升级需要上传模块信息，解决和分析某些问题的时候可能也会需要确认模块信息。

二、演示功能概述

每隔三秒钟通过日志输出一次模组名称，硬件版本号，原始芯片型号。

三、准备硬件环境

1、Air1601开发板一块

2、TYPE-C USB数据线一根

3、Air1601开发板和数据线的硬件接线方式为

Air1601开发板通过TYPE-C USB口连接TYPE-C USB 数据线，数据线的另外一端连接电脑的USB口；
在 Air1601 开发板上丝印标注 USB1，为芯片烧录下载接口；
若遇到因电脑 USB 端口供电不足导致的烧录失败，也可改用外部稳压电源通过开发板上的 VIN 引脚进行供电；

购买链接：Air1601开发板多功能5寸RGB屏支持AirUI 摄像头代开发固件-淘宝网

四、准备软件环境

4.1 软件环境

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

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

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

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

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

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

4.2 API 介绍

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

五、程序结构

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

5.1 文件说明

main.lua：主程序入口文件。
hmeta_app.lua：每隔三秒钟通过日志输出一次模组名称，硬件版本号，原始芯片型号。

六、代码详解

6.1 main.lua

主程序文件 main.lua 是整个项目的入口点。它负责初始化系统环境。

6.2 hmeta_app.lua

每隔三秒钟通过日志输出一次模组名称，硬件版本号，原始芯片型号

6.2.1 获取模组名称，硬件版本号，原始芯片型号

local function hmeta_task_func()
    while true do
        -- 打印模组名称，硬件版本号，原始芯片型号
        log.info("hmeta", hmeta.model(), hmeta.hwver(), hmeta.chip())
        sys.wait(3000)
    end
end

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

七、运行结果展示

出现类似于下面的日志，就表示运行成功：

[2026-04-21 16:16:55.607][LTOS/N][000000012.019]:I/user.hmeta Air1601 A10 CCM4211
[2026-04-21 16:16:58.593][LTOS/N][000000015.019]:I/user.hmeta Air1601 A10 CCM4211
[2026-04-21 16:17:01.580][LTOS/N][000000018.020]:I/user.hmeta Air1601 A10 CCM4211

八、总结

通过本文学习，你可以学习到模组名称，硬件版本号，原始芯片型号的获取方法。