gpio - GPIO操作#

本页文档由这个文件自动生成。如有错误,请提交issue或帮忙修改后pr,谢谢!

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

设置管脚功能

参数

传入值类型

解释

int

pin 针脚编号,必须是数值

any

mode 输入输出模式. 数字0/1代表输出模式,nil代表输入模式,function代表中断模式

int

pull 上拉下列模式, 可以是gpio.PULLUP 或 gpio.PULLDOWN, 需要根据实际硬件选用

int

irq 默认gpio.BOTH。中断触发模式, 上升沿gpio.RISING, 下降沿gpio.FALLING, 上升和下降都要gpio.BOTH

返回值

返回值类型

解释

any

输出模式返回设置电平的闭包, 输入模式和中断模式返回获取电平的闭包

例子

-- 设置gpio17为输入
gpio.setup(17, nil)
-- 设置gpio17为输出
gpio.setup(17, 0)
-- 设置gpio27为中断
gpio.setup(27, function(val) print("IRQ_27",val) end, gpio.PULLUP)

gpio.set(pin, value)#

设置管脚电平

参数

传入值类型

解释

int

pin 针脚编号,必须是数值

int

value 电平, 可以是 高电平gpio.HIGH, 低电平gpio.LOW, 或者直接写数值1或0

返回值

返回值类型

解释

nil

无返回值

例子

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

gpio.get(pin)#

获取管脚电平

参数

传入值类型

解释

int

pin 针脚编号,必须是数值

返回值

返回值类型

解释

value

电平, 高电平gpio.HIGH, 低电平gpio.LOW, 对应数值1和0

例子

-- 获取gpio17的当前电平
gpio.get(17)

gpio.close(pin)#

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

参数

传入值类型

解释

int

pin 针脚编号,必须是数值

返回值

返回值类型

解释

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

管脚的GPIO0AB4276E.png

返回值

返回值类型

解释

nil

无返回值

例子

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