LuatOS-SOC接口文档(air780E)-- gpio - GPIO操作

常量

常量 类型 解释
gpio.LOW number 低电平
gpio.HIGH number 高电平
gpio.PULLUP number 上拉
gpio.PULLDOWN number 下拉
gpio.RISING number 上升沿触发
gpio.FALLING number 下降沿触发
gpio.BOTH number 双向触发,部分设备支持
gpio.HIGH_IRQ number 高电平触发,部分设备支持
gpio.LOW_IRQ number 低电平触发,部分设备支持

gpio.setup(pin, mode, pull, irq, alt)

设置管脚功能

参数

传入值类型 解释
int pin gpio编号,必须是数值
any mode 输入输出模式: 数字0/1代表输出模式 nil代表输入模式 function代表中断模式
int pull 上拉下列模式, 可以是gpio.PULLUP 或 gpio.PULLDOWN, 需要根据实际硬件选用
int irq 中断触发模式,默认gpio.BOTH。中断触发模式 上升沿gpio.RISING 下降沿gpio.FALLING 上升和下降都触发gpio.BOTH
int alt 复用选项,目前只有EC618平台需要这个参数,有些GPIO可以复用到不同引脚上,可以选择复用选项(0或者4)从而复用到对应的引脚上

返回值

返回值类型 解释
any 输出模式返回设置电平的闭包, 输入模式和中断模式返回获取电平的闭包

例子

复制代码
-- 设置gpio17为输入
gpio.setup(17, nil)
-- 设置gpio17为输出,且初始化电平为低,使用硬件默认上下拉配置
gpio.setup(17, 0)
-- 设置gpio17为输出,且初始化电平为高,且启用内部上拉
gpio.setup(17, 1, gpio.PULLUP)
-- 设置gpio27为中断
gpio.setup(27, function(val) print("IRQ_27",val) end, gpio.PULLUP)
-- 设置gpio27为中断
gpio.setup(27, function(val) print("IRQ_27",val) end, gpio.PULLUP)

-- alt_func 于2023.7.2新增
-- 设置AIR780E的PIN33复用成gpio18,方向输出,且初始化电平为低,使用硬件默认上下拉配置
gpio.setup(18, 0, nil, nil, 4)

gpio.set(pin, value)

设置管脚电平

参数

传入值类型 解释
int pin GPIO编号,必须是数值
int value 电平, 可以是 高电平gpio.HIGH, 低电平gpio.LOW, 或者直接写数值1或0

返回值

返回值类型 解释
nil 无返回值

例子

复制代码
-- 设置gpio17为低电平
gpio.set(17, 0)

gpio.get(pin)

获取管脚电平

参数

传入值类型 解释
int pin GPIO编号,必须是数值

返回值

返回值类型 解释
value 电平, 高电平gpio.HIGH, 低电平gpio.LOW, 对应数值1和0

例子

复制代码
-- 获取gpio17的当前电平
gpio.get(17)

gpio.close(pin)

关闭管脚功能(高阻输入态),关掉中断

参数

传入值类型 解释
int pin GPIO编号,必须是数值

返回值

返回值类型 解释
nil 无返回值,总是执行成功

例子

复制代码
-- 关闭gpio17
gpio.close(17)

gpio.setDefaultPull(val)

设置GPIO脚的默认上拉/下拉设置, 默认是平台自定义(一般为开漏).

参数

传入值类型 解释
int val 0平台自定义,1上拉, 2下拉

返回值

返回值类型 解释
boolean 传值正确返回true,否则返回false

例子

复制代码
-- 设置gpio.setup的pull默认值为上拉
gpio.setDefaultPull(1)

gpio.toggle(pin)

变换GPIO脚输出电平,仅输出模式可用

参数

传入值类型 解释
int 管脚的GPIO号

返回值

返回值类型 解释
nil 无返回值

例子

复制代码
-- 本API于 2022.05.17 添加
-- 假设GPIO16上有LED, 每500ms切换一次开关
gpio.setup(16, 0)
sys.timerLoopStart(function()
    gpio.toggle(16)
end, 500)

gpio.pulse(pin,level,len,delay)

在同一个GPIO输出一组脉冲, 注意, len的单位是bit, 高位在前.

参数

传入值类型 解释
int gpio号
int/string 数值或者字符串.
int len 长度 单位是bit, 高位在前.
int delay 延迟,当前无固定时间单位

返回值

返回值类型 解释
nil 无返回值

例子

复制代码
-- 通过PB06脚输出输出8个电平变化.
gpio.pulse(pin.PB06,0xA9, 8, 0)

gpio.debounce(pin, ms, mode)

防抖设置, 根据硬件ticks进行防抖

参数

传入值类型 解释
int gpio号, 0~127, 与硬件相关
int 防抖时长,单位毫秒, 最大 65555 ms, 设置为0则关闭
int 模式, 0冷却模式, 1延时模式. 默认是0

返回值

返回值类型 解释
nil 无返回值

例子

复制代码
-- 消抖模式, 当前支持2种, 2022.12.16开始支持mode=1
-- 0 触发中断后,马上上报一次, 然后冷却N个毫秒后,重新接受中断
-- 1 触发中断后,延迟N个毫秒,期间没有新中断且电平没有变化,上报一次

-- 开启防抖, 模式0-冷却, 中断后马上上报, 但100ms内只上报一次
gpio.debounce(7, 100) -- 若芯片支持pin库, 可用pin.PA7代替数字7
-- 开启防抖, 模式1-延时, 中断后等待100ms,期间若保持该电平了,时间到之后上报一次
-- 对应的,如果输入的是一个 50hz的方波,那么不会触发任何上报
gpio.debounce(7, 100, 1)

-- 关闭防抖,时间设置为0就关闭
gpio.debounce(7, 0)
相关推荐
合宙Luat4 个月前
Air780EP模块 LuatOS开发-MQTT接入阿里云应用指南
阿里云·云计算·合宙·air780e
l5317981511 年前
LuatOS-SOC接口文档(air780E)--rsa - RSA加密解密
air780e
l5317981511 年前
LuatOS-SOC接口文档(air780E)--rtos - RTOS底层操作库
air780e
l5317981511 年前
LuatOS-SOC接口文档(air780E)--repl - “读取-求值-输出” 循环
air780e
l5317981511 年前
LuatOS-SOC接口文档(air780E)--pwm - PWM模块
air780e
l5317981511 年前
LuatOS-SOC接口文档(air780E)--protobuf - ProtoBuffs编解码
air780e
l5317981511 年前
LuatOS-SOC接口文档(air780E)--otp - OTP操作库
air780e
l5317981511 年前
LuatOS-SOC接口文档(air780E)--os - os操作
air780e
l5317981511 年前
LuatOS-SOC接口文档(air780E)--nimble - 蓝牙BLE库(nimble版)
air780e
l5317981511 年前
LuatOS-SOC接口文档(air780E)--pack - 打包和解包格式串
air780e