在 MicroPython 中使用 GPIO,需要导入 machine 模块,然后使用 Pin 类来创建和控制 GPIO 引脚。Pin 类有以下的方法和属性:
- :构造一个 Pin 对象,指定引脚的编号、模式、上下拉电阻、初始值、驱动能力和替代功能。模式可以是 Pin.IN(输入)、Pin.OUT(输出)、Pin.OPEN_DRAIN(开漏输出)、Pin.ALT(替代功能)或 Pin.ANALOG(模拟输入)。上下拉电阻可以是 Pin.PULL_UP(上拉)、Pin.PULL_DOWN(下拉)或 None(无)。初始值只对输出模式有效,可以是 0 或 1。驱动能力和替代功能是与具体硬件相关的参数,不同的板子可能有不同的选项。
- pin.init(mode, pull, *, value, drive, alt):重新初始化一个 Pin 对象,参数同构造函数。
- pin.value():读取引脚的数字值,返回 0 或 1。
- pin.value(x):设置引脚的数字值,x 可以是 0 或 1。
- pin.on():设置引脚为高电平,相当于 pin.value(1)。
- pin.off():设置引脚为低电平,相当于 pin.value(0)。
- pin.irq(handler=None, trigger=0, *, priority=1, wake=None, hard=False):配置引脚的中断处理函数和触发条件。handler 是一个回调函数,接受一个参数(引脚对象)。trigger 是一个位掩码,指定引脚的变化条件,可以是 Pin.IRQ_FALLING(下降沿)、Pin.IRQ_RISING(上升沿)、Pin.IRQ_LOW_LEVEL(低电平)或 Pin.IRQ_HIGH_LEVEL(高电平)。priority 是中断的优先级,wake 是唤醒模式,hard 是是否使用硬件中断。这些参数都是可选的,如果省略则保持原来的设置。
使用 GPIO 的例子:
- 创建一个输出引脚并设置其值:
from machine import Pin
p = Pin(0, Pin.OUT) # 创建一个编号为 0 的输出引脚
p.value(0) # 设置引脚为低电平
p.value(1) # 设置引脚为高电平
p.off() # 设置引脚为低电平
p.on() # 设置引脚为高电平
复制
- 创建一个输入引脚并读取其值:
from machine import Pin
p = Pin(2, Pin.IN, Pin.PULL_UP) # 创建一个编号为 2 的输入引脚,并启用上拉电阻
print(p.value()) # 打印引脚的值
from machine import Pin
def callback(p):
print('pin change', p) # 打印引脚变化的信息
p = Pin(4, Pin.IN, Pin.PULL_UP) # 创建一个编号为 4 的输入引脚,并启用上拉电阻
p.irq(callback, Pin.IRQ_FALLING) # 配置引脚在下降沿时触发回调函数