Pin 对象用于控制输入/输出引脚（也称为 GPIO）。Pin 对象通常与一个物理引脚相关联，他可以驱动输出电压和读取输入电压。Pin 类中有设置引脚模式（输入/输出）的方法，也有获取和设置数字逻辑（0 或 1）的方法。

一个 Pin 对象是通过一个标识符来构造的，它明确地指定了一个特定的输入输出。标识符的形式和物理引脚的映射是特定于一次移植的。标识符可以是整数，字符串或者是一个带有端口和引脚号码的元组。在 MicroPython 中，引脚标识符是一个代号或引脚号，如 Pin("D1", Pin.OUT_PP) 中的"D1"。

构造函数

在MicroPython 中 Pin 对象的构造函数如下：

class machine.Pin( id, mode = -1, pull = -1，value)

• id ：由用户自定义的引脚名和 Pin 设备引脚号组成。

• mode ： 指定引脚模式，可以是以下几种：

  • Pin.IN ：输入模式
  • Pin.OUT ：输出模式
  • Pin.OPEN_DRAIN ：开漏模式

• pull ： 如果指定的引脚连接了上拉下拉电阻，那么可以配置成下面的状态：

  • None ：没有上拉或者下拉电阻。
  • Pin.PULL_UP ：使能上拉电阻。
  • Pin.PULL_DOWN ：使能下拉电阻。
• value ： value 的值只对输出模式和开漏输出模式有效，用来设置初始输出值。

方法

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

根据输入的参数重新初始化引脚。只有那些被指定的参数才会被设置，其余引脚的状态将保持不变，详细的参数可以参考上面的构造函数。

Pin.value([x])

如果没有给定参数 x ,这个方法可以获得引脚的值。如果给定参数 x ，如 0 或 1，那么设置引脚的值为 逻辑 0 或 逻辑 1。

Pin.name()

返回引脚对象在构造时用户自定义的引脚名。

常量

下面的常量用来配置 Pin 对象。 

选择引脚模式：

• Pin.IN
• Pin.OUT
• Pin.OPEN_DRAIN

选择上/下拉模式：

• Pin.PULL_UP
• Pin.PULL_DOWN
• None

使用值 None 代表不进行上下拉。

示例

>>> from machine import Pin
>>>
>>> p_out = Pin(("X1", 33), Pin.OUT_PP)
>>> p_out.value(1)              # set io high
>>> p_out.value(0)              # set io low
>>>
>>> p_in = Pin(("X2", 32), Pin.IN, Pin.PULL_UP)
>>> p_in.value()                # get value, 0 or 1

更多内容可参考 machine.Pin