引脚类 – 控制 I/O 引脚

引脚对象用于控制 I/O 引脚(也称为 GPIO - 通用输入/输出)。引脚对象通常与可以驱动输出电压和读取输入电压的物理引脚相关联。pin 类具有设置 pin 模式(IN、OUT 等)的方法以及获取和设置数字逻辑电平的方法。有关引脚的模拟控制,请参见 ADC 类。

引脚对象是通过使用明确指定某个 I/O 引脚的标识符来构造的。标识符的允许形式和标识符映射到的物理引脚是特定于端口的。标识符可能是整数、字符串或带有端口和引脚号的元组。

使用型号:

from machine import Pin

# create an output pin on pin #0
p0 = Pin(0, Pin.OUT)

# set the value low then high
p0.value(0)
p0.value(1)

# create an input pin on pin #2, with a pull up resistor
p2 = Pin(2, Pin.IN, Pin.PULL_UP)

# read and print the pin value
print(p2.value())

# reconfigure pin #0 in input mode with a pull down resistor
p0.init(p0.IN, p0.PULL_DOWN)

# configure an irq callback
p0.irq(lambda p:print(p))

构造函数

class machine.Pin(id, mode=- 1, pull=- 1, *, value, drive, alt)

访问与给定 id. 如果在构造函数中给出了额外的参数,那么它们将用于初始化引脚。任何未指定的设置将保持其先前状态。

论据是:

  • id 是强制性的,可以是任意对象。可能的值类型包括:int(内部 Pin 标识符)、str(Pin 名称)和元组([port, pin] 对)。

  • mode 指定引脚模式,可以是以下之一:

    • Pin.IN - 引脚配置为输入。如果将其视为输出,则该引脚处于高阻抗状态。

    • Pin.OUT - 引脚配置为(正常)输出。

    • Pin.OPEN_DRAIN - 引脚配置为开漏输出。开漏输出的工作方式如下:如果输出值设置为0,则该引脚处于低电平有效;如果输出值为 1,则引脚处于高阻抗状态。并非所有端口都实现此模式,或者某些端口可能仅在某些引脚上。

    • Pin.ALT - 引脚配置为执行特定于端口的替代功能。对于以这种方式配置的引脚,任何其他引脚方法(除了 Pin.init())都不适用(调用它们将导致未定义或特定于硬件的结果)。并非所有端口都实现此模式

    • Pin.ALT_OPEN_DRAIN - 与 相同 Pin.ALT,但引脚配置为开漏。并非所有端口都实现此模式。

  • pull指定引脚是否连接了(弱)上拉电阻,并且可以是以下之一:

    • None - 没有上拉或下拉电阻。

    • Pin.PULL_UP - 上拉电阻使能。

    • Pin.PULL_DOWN - 下拉电阻启用。

  • value仅对 Pin.OUT 和 Pin.OPEN_DRAIN 模式有效,如果给定,则指定初始输出引脚值,否则引脚外设的状态保持不变。

  • drive 指定引脚的输出功率,可以是以下之一: Pin.LOW_POWER, Pin.MED_POWERPin.HIGH_POWER。实际的当前驱动能力取决于端口。并非所有端口都实现此参数。

  • alt为引脚指定一个备用功能,它可以采用的值取决于端口。此参数仅对Pin.ALTPin.ALT_OPEN_DRAIN 模式有效。当一个引脚支持多个备用功能时,可以使用它。如果仅支持一个引脚备用功能,则不需要此参数。并非所有端口都实现此参数。

如上所述,Pin 类允许为特定的 pin 设置备用功能,但它没有指定对此类 pin 的任何进一步操作。在交替功能模式下配置的引脚通常不用作 GPIO,而是由其他硬件外设驱动。此类引脚支持的唯一操作是通过调用构造函数或 Pin.init() 方法重新初始化。如果在复用功能模式下配置的引脚用Pin.IN, Pin.OUT、 或 重新初始化,复用 Pin.OPEN_DRAIN功能将从引脚中删除。

方法

Pin.init(mode=- 1, pull=- 1, *, value, drive, alt)

使用给定的参数重新初始化引脚。只会设置那些指定的参数。其余引脚外设状态将保持不变。有关参数的详细信息,请参阅构造函数文档。

返回 None.

Pin.value([x])

此方法允许设置和获取引脚的值,具体取决于是否x提供参数。

如果省略参数,则此方法获取引脚的数字逻辑电平,分别返回对应于低电压和高电压信号的 0 或 1。此方法的行为取决于引脚的模式:

  • Pin.IN - 该方法返回引脚上当前存在的实际输入值。

  • Pin.OUT - 方法的行为和返回值未定义。

  • Pin.OPEN_DRAIN - 如果引脚处于状态“0”,则该方法的行为和返回值未定义。否则,如果引脚处于状态“1”,则该方法返回引脚上当前存在的实际输入值。

如果提供参数,则此方法设置引脚的数字逻辑电平。参数x可以是任何转换为​​布尔值的东西。如果转换为 True,则引脚设置为状态“1”,否则设置为状态“0”。此方法的行为取决于引脚的模式:

  • Pin.IN - 该值存储在引脚的输出缓冲区中。引脚状态不变,保持高阻态。一旦更改为 Pin.OUTPin.OPEN_DRAIN 模式,存储的值将在引脚上激活 。

  • Pin.OUT -输出缓冲区立即设置为给定值。

  • Pin.OPEN_DRAIN - 如果值为“0”,则引脚设置为低电压状态。否则引脚设置为高阻态。

设置值时,此方法返回 None.

Pin.__call__([x])

Pin 对象是可调用的。call 方法提供了一个(快速)快捷方式来设置和获取引脚的值。它等效于 Pin.value([x])。有关Pin.value() 更多详细信息,请参阅。

Pin.on()

将引脚设置为“1”输出电平。

Pin.off()

将引脚设置为“0”输出电平。

Pin.irq(handler=None, trigger=Pin.IRQ_FALLING | Pin.IRQ_RISING, *, priority=1, wake=None, hard=False)

配置在引脚的触发源处于活动状态时要调用的中断处理程序。如果引脚模式为,Pin.IN 则触发源为引脚上的外部值。如果引脚模式为,Pin.OUT 则触发源为引脚的输出缓冲器。否则,如果引脚模式是,Pin.OPEN_DRAIN则触发源是状态“0”的输出缓冲器和状态“1”的外部引脚值。

论据是:

  • handler是中断触发时要调用的可选函数。处理程序必须只采用一个参数,即 Pin实例。

  • trigger 配置可以产生中断的事件。可能的值为:

    • Pin.IRQ_FALLING 下降沿中断。

    • Pin.IRQ_RISING上升沿中断。

    • Pin.IRQ_LOW_LEVEL 低电平中断。

    • Pin.IRQ_HIGH_LEVEL高电平中断。

    这些值可以通过“或”运算来触发多个事件。

  • priority设置中断的优先级。它可以采用的值是特定于端口的,但更高的值总是代表更高的优先级。

  • wake选择此中断可以唤醒系统的电源模式。它可以是 machine.IDLE, machine.SLEEP or machine.DEEPSLEEP. 。也可以将这些值进行“或”运算,使一个引脚在一种以上的电源模式下产生中断。

  • hard 如果为真,则使用硬件中断。这减少了引脚更改和被调用的处理程序之间的延迟。硬中断处理程序可能不分配内存;请参阅 编写中断处理程序.。并非所有端口都支持此参数。

此方法返回一个回调对象。

以下方法不是核心 Pin API 的一部分,仅在某些端口上实现。

Pin.low()

将引脚设置为“0”输出电平。

可用性:nrf、rp2、stm32 端口。

Pin.high()

将引脚设置为“1”输出电平。

可用性:nrf、rp2、stm32 端口。

Pin.mode([mode])

获取或设置引脚模式。有关mode参数的详细信息,请参阅构造函数文档。

可用性:cc3200、stm32 端口。

Pin.pull([pull])

获取或设置引脚拉动状态。有关pull 参数的详细信息,请参阅构造函数文档。

可用性:cc3200、stm32 端口。

Pin.drive([drive])

获取或设置引脚驱动强度。有关 drive参数的详细信息,请参阅构造函数文档。

可用性:cc3200 端口。

常数

以下常量用于配置引脚对象。请注意,并非所有常量都可用于所有端口。

Pin.IN
Pin.OUT
Pin.OPEN_DRAIN
Pin.ALT
Pin.ALT_OPEN_DRAIN

选择引脚模式。

Pin.PULL_UP
Pin.PULL_DOWN
Pin.PULL_HOLD

选择是否有上拉/下拉电阻。使用 None 无拉取值 。

Pin.LOW_POWER
Pin.MED_POWER
Pin.HIGH_POWER

选择引脚驱动强度。

Pin.IRQ_FALLING
Pin.IRQ_RISING
Pin.IRQ_LOW_LEVEL
Pin.IRQ_HIGH_LEVEL

选择 IRQ 触发类型。