跳转至

pins - GPIO 功能配置，包括输入输出IO和上升下降沿中断IO

适用范围

层面 说明
运行环境 LuatOS-Air 脚本框架，展锐 8910 平台（Air724UG / Air722UG / Air795UG / Air720UH 等）
前提条件 需目标 GPIO 在该机型上存在且未被占用（引脚复用见机型硬件手册）
不适用 Air780E 及以后跑 LuatOS 的 Cat.1 模组；这些模组的同名库在 osapi 里是另一套接口，不能照抄

pins.setup(pin, val, pull)

配置GPIO模式

参数

名称 传入值类型 释义
pin number GPIO，ID
GPIO 0到GPIO 31表示为pio.P0_0到pio.P0_31
GPIO 32到GPIO XX表示为pio.P1_0到pio.P1_(XX-32)，例如GPIO33 表示为pio.P1_1
GPIO 64到GPIO XX表示为pio.P2_0到pio.P2_(XX-64)，例如GPIO65 表示为pio.P2_1
val param number、nil或者function类型
配置为输出模式时，为number类型，表示默认电平，0是低电平，1是高电平
配置为输入模式时，为nil
配置为中断模式时，为function类型，表示中断处理函数
pull param number，pio.PULLUP：上拉模式。pio.PULLDOWN：下拉模式。pio.NOPULL：高阻态
如果没有设置此参数，默认的上下拉参考模块的硬件设计说明书

返回值

function
配置为输出模式时，返回的函数，可以设置IO的电平
配置为输入或者中断模式时，返回的函数，可以实时获取IO的电平

例子

setOutputFnc = pins.setup(pio.P1_1,0)，配置GPIO 33，输出模式，默认输出低电平；
-- 执行setOutputFnc(0)可输出低电平，执行setOutputFnc(1)可输出高电平
getInputFnc = pins.setup(pio.P1_1,intFnc)，配置GPIO33，中断模式
-- 产生中断时自动调用intFnc(msg)函数：上升沿中断时：msg为cpu.INT_GPIO_POSEDGE；下降沿中断时：msg为cpu.INT_GPIO_NEGEDGE
-- 执行getInputFnc()即可获得当前电平；如果是低电平，getInputFnc()返回0；如果是高电平，getInputFnc()返回1
getInputFnc = pins.setup(pio.P1_1),配置GPIO33，输入模式
-- 执行getInputFnc()即可获得当前电平；如果是低电平，getInputFnc()返回0；如果是高电平，getInputFnc()返回1
-- 有些GPIO需要打开对应的ldo电压域之后，才能正常配置工作，电压域和对应的GPIO关系如下
pmd.ldoset(x,pmd.LDO_VSIM1) -- GPIO 29、30、31
pmd.ldoset(x,pmd.LDO_VLCD) -- GPIO 0、1、2、3、4
pmd.ldoset(x,pmd.LDO_VMMC) -- GPIO 24、25、26、27、28
x=0时：关闭LDO
x=1时：LDO输出1.716V
x=2时：LDO输出1.828V
x=3时：LDO输出1.939V
x=4时：LDO输出2.051V
x=5时：LDO输出2.162V
x=6时：LDO输出2.271V
x=7时：LDO输出2.375V
x=8时：LDO输出2.493V
x=9时：LDO输出2.607V
x=10时：LDO输出2.719V
x=11时：LDO输出2.831V
x=12时：LDO输出2.942V
x=13时：LDO输出3.054V
x=14时：LDO输出3.165V
x=15时：LDO输出3.177V
-- 除了上面列举出的GPIO外，其余的GPIO不需要打开特定的电压域，可以直接配置工作

pins.close(pin)

关闭GPIO模式

参数

名称 传入值类型 释义
pin number GPIO，ID

GPIO 0到GPIO 31表示为pio.P0_0到pio.P0_31

GPIO 32到GPIO XX表示为pio.P1_0到pio.P1_(XX-32)，例如GPIO33 表示为pio.P1_1

返回值

无

例子

pins.close(pio.P1_1)，关闭GPIO33
搜索