hmeta - 硬件元数据

示例

-- 本库开发中
--[[
    这个库的作用是展示当前硬件的能力, 例如:
1. 有多少GPIO, 各GPIO默认模式是什么, 是否支持上拉/下拉
2. 有多少I2C,支持哪些速率
3. 有多少SPI,支持哪些速率和模式
4. 扩展属性, 例如区分Air780E和Air600E

]]

hmeta.model()

获取模组名称

参数

无

返回值

返回值类型	解释
string	若能识别到,返回模组类型, 否则会是nil

例子

sys.taskInit(function()
    while 1 do
        sys.wait(3000)
        -- hmeta识别底层模组类型的
        -- 不同的模组可以使用相同的bsp,但根据封装的不同,根据内部数据仍可识别出具体模块
        log.info("hmeta", hmeta.model())
        log.info("bsp",   rtos.bsp())
    end
end)

---

hmeta.hwver()

获取模组的硬件版本号

参数

无

返回值

返回值类型	解释
string	若能识别到,返回模组类型, 否则会是nil

例子

sys.taskInit(function()
    while 1 do
        sys.wait(3000)
        -- hmeta识别底层模组类型的
        -- 不同的模组可以使用相同的bsp,但根据封装的不同,根据内部数据仍可识别出具体模块
        log.info("hmeta", hmeta.model(), hmeta.hwver())
        log.info("bsp",   rtos.bsp())
    end
end)

---

hmeta.chip()

获取原始芯片型号

参数

无

返回值

返回值类型	解释
string	若能识别到,返回芯片类型, 否则会是nil

例子

-- 若底层正确实现, 这个函数总会返回值
-- 本函数于 2024.12.5 新增

---

hmeta.muid()

获取模组muid

参数

无

返回值

返回值类型	解释
string	模组muid, 32字节的字符串,如果不支持, 会返回空字符串.

例子

local muid = hmeta.muid()
print("muid", muid)

---

hmeta.devid()

获取模组的识别id

参数

无

返回值

返回值类型	解释
string	模组识别id,总是可见字符组成

例子

-- 对于4G模组, devid就是IMEI
-- 对于WiFi模组, devid就是MAC地址
-- 对于MCU模组, 与生产流程有关
-- 本函数于2026.7.18新增

---