LuatOS-SOC接口文档(air780E)--mcu - 封装mcu一些特殊操作

常量

mcu.setClk(mhz)

设置主频,单位MHZ

参数

返回值

例子

--  请注意,主频与外设主频有关联性, 例如主频2M时SPI的最高只能1M
-- 设置到80MHZ
mcu.setClk(80)
sys.wait(1000)
-- 设置到240MHZ
mcu.setClk(240)
sys.wait(1000)
-- 设置到2MHZ
mcu.setClk(2)
sys.wait(1000)

mcu.getClk()

获取主频,单位MHZ

参数

无

返回值

例子

local mhz = mcu.getClk()
print("Boom", mhz)

mcu.unique_id()

获取设备唯一id. 注意,可能包含不可见字符,如需查看建议toHex()后打印

参数

无

返回值

例子

local unique_id = mcu.unique_id()
print("unique_id", unique_id)

mcu.ticks()

获取启动后的tick数,注意会出现溢出会出现负数

参数

无

返回值

例子

local tick = mcu.ticks()
print("ticks", tick)

mcu.hz()

获取每秒的tick数量

参数

无

返回值

例子

local hz = mcu.hz()
print("mcu.hz", hz)

mcu.reg32(address, value, mask)

读写mcu的32bit寄存器或者ram,谨慎使用写功能,请熟悉mcu的寄存器使用方法后再使用

参数

返回值

例子

local value = mcu.reg32(0x2009FFFC, 0x01, 0x01) --对0x2009FFFC地址上的值,修改bit0为1

mcu.x32(value)

转换10进制数为16进制字符串输出

参数

返回值

例子

local value = mcu.x32(0x2009FFFC) --输出"0x2009fffc"

mcu.tick64()

获取启动后的高精度tick，如果支持bit64库，可以直接输出转换好的bit64结构

参数

返回值

例子

local tick_str, tick_per = mcu.tick64()
print("ticks", tick_str, tick_per)

mcu.dtick64(tick1, tick2, check_value)

计算2个64bit tick的差值

参数

返回值

例子

local result, diff_tick = mcu.dtick64(tick1, tick2)
print("ticks", result, diff_tick)

mcu.setXTAL(source_main, source_32k, delay)

选择时钟源,当前仅air105支持

参数

返回值

无

例子

mcu.setXTAL(true, true, 1248)	--高速时钟使用外部时钟,低速32K使用外部晶振, delay1248

mcu.hardfault(mode)

mcu死机时处理模式，目前只有EC618平台适用

参数

返回值

无

例子

mcu.hardfault(0)	--死机后停机，一般用于调试状态
mcu.hardfault(1)	--死机后重启，一般用于正式产品
mcu.hardfault(2)	--死机后尽量将错误信息提交给外部工具后重启，一般用于压力测试或者正式产品

mcu.iomux(type, channel, value)

在外设打开前，将外设IO复用到非默认配置上，目前只支持Air780E的部分外设复用到其他配置，这是一个临时接口，如果后续有更合适的api，本接口将不再更新

参数

返回值

无

例子

mcu.iomux(mcu.UART, 2, 1)	-- Air780E的UART2复用到gpio12和gpio13(Air780EG默认是这个复用，不要动)
mcu.iomux(mcu.UART, 2, 2)	-- Air780E的UART2复用到gpio6和gpio7
mcu.iomux(mcu.I2C, 0, 1)	-- Air780E的I2C0复用到gpio12和gpio13
mcu.iomux(mcu.I2C, 0, 2)	-- Air780E的I2C0复用到gpio16和gpio17
mcu.iomux(mcu.I2C, 1, 1)	-- Air780E的I2C1复用到gpio4和gpio5

mcu.altfun(type, sn, pad_index, alt_fun, is_input)

IO外设功能复用选择，注意普通MCU是以GPIO号为序号，但是专用SOC，比如CAT1的，是以PAD号为序号。本函数不是所有平台适用

参数

返回值

无

例子

mcu.altfun(mcu.GPIO, 46, 32, 1, 0)
mcu.altfun(mcu.GPIO, 46)