MicroPython:Библиотеки/pyb/Класс Pin: различия между версиями

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
Нет описания правки
Нет описания правки
 
(не показана 1 промежуточная версия 1 участника)
Строка 11: Строка 11:
Все контакты платы предварительно определены в pyb.Pin.board.Name:
Все контакты платы предварительно определены в pyb.Pin.board.Name:


<syntaxhighlight lang="python" enclose="div">
<syntaxhighlight lang="python">
x1_pin = pyb.Pin.board.X1
x1_pin = pyb.Pin.board.X1


Строка 21: Строка 21:
Также можно использовать строки:
Также можно использовать строки:


<syntaxhighlight lang="python" enclose="div">
<syntaxhighlight lang="python">
g = pyb.Pin('X1', pyb.Pin.OUT_PP)
g = pyb.Pin('X1', pyb.Pin.OUT_PP)
</syntaxhighlight>
</syntaxhighlight>
Строка 27: Строка 27:
Кроме того, пользователи могут задавать собственные названия контактов...
Кроме того, пользователи могут задавать собственные названия контактов...


<syntaxhighlight lang="python" enclose="div">
<syntaxhighlight lang="python">
MyMapperDict = { 'LeftMotorDir' : pyb.Pin.cpu.C12 }
MyMapperDict = { 'LeftMotorDir' : pyb.Pin.cpu.C12 }
pyb.Pin.dict(MyMapperDict)
pyb.Pin.dict(MyMapperDict)
Строка 35: Строка 35:
...и запрашивать привязочные данные:
...и запрашивать привязочные данные:


<syntaxhighlight lang="python" enclose="div">
<syntaxhighlight lang="python">
pin = pyb.Pin("LeftMotorDir")
pin = pyb.Pin("LeftMotorDir")
</syntaxhighlight>
</syntaxhighlight>
Строка 41: Строка 41:
Также пользователь может создать собственную привязочную функцию:
Также пользователь может создать собственную привязочную функцию:


<syntaxhighlight lang="python" enclose="div">
<syntaxhighlight lang="python">
def MyMapper(pin_name):
def MyMapper(pin_name):
   if pin_name == "LeftMotorDir":
   if pin_name == "LeftMotorDir":
Строка 109: Строка 109:
Пример использования:
Пример использования:


<syntaxhighlight lang="python" enclose="div">
<syntaxhighlight lang="python">
x3 = pyb.Pin.board.X3
x3 = pyb.Pin.board.X3
x3_af = x3.af_list()
x3_af = x3.af_list()
Строка 118: Строка 118:
На [[PyBoard]] в ''x3_af'' будет содержаться:
На [[PyBoard]] в ''x3_af'' будет содержаться:


<syntaxhighlight lang="python" enclose="div">
<syntaxhighlight lang="python">
[Pin.AF1_TIM2, Pin.AF2_TIM5, Pin.AF3_TIM9, Pin.AF7_USART2]
[Pin.AF1_TIM2, Pin.AF2_TIM5, Pin.AF3_TIM9, Pin.AF7_USART2]
</syntaxhighlight>
</syntaxhighlight>
Строка 126: Строка 126:
Чтобы настроить ''X3'' на использование ''TIM2_CH3'', можно выполнить следующее:
Чтобы настроить ''X3'' на использование ''TIM2_CH3'', можно выполнить следующее:


<syntaxhighlight lang="python" enclose="div">
<syntaxhighlight lang="python">
pin = pyb.Pin(pyb.Pin.board.X3, mode=pyb.Pin.AF_PP, af=pyb.Pin.AF1_TIM2)
pin = pyb.Pin(pyb.Pin.board.X3, mode=pyb.Pin.AF_PP, af=pyb.Pin.AF1_TIM2)
</syntaxhighlight>
</syntaxhighlight>
Строка 132: Строка 132:
...или...
...или...


<syntaxhighlight lang="python" enclose="div">
<syntaxhighlight lang="python">
pin = pyb.Pin(pyb.Pin.board.X3, mode=pyb.Pin.AF_PP, af=1)
pin = pyb.Pin(pyb.Pin.board.X3, mode=pyb.Pin.AF_PP, af=1)
</syntaxhighlight>
</syntaxhighlight>
Строка 138: Строка 138:
===Методы===
===Методы===


* [[MicroPython:Библиотеки/pyb/Класс Pin/Класс PinAF|Класс PinAF/pinaf.__str__()|pinaf.__str__()]]
* [[MicroPython:Библиотеки/pyb/Класс Pin/Класс PinAF/pinaf.__str__()|pinaf.__str__()]]
* [[MicroPython:Библиотеки/pyb/Класс Pin/Класс PinAF|Класс PinAF/pinaf.index()|pinaf.index()]]
* [[MicroPython:Библиотеки/pyb/Класс Pin/Класс PinAF/pinaf.index()|pinaf.index()]]
* [[MicroPython:Библиотеки/pyb/Класс Pin/Класс PinAF|Класс PinAF/pinaf.name()|pinaf.name()]]
* [[MicroPython:Библиотеки/pyb/Класс Pin/Класс PinAF/pinaf.name()|pinaf.name()]]
* [[MicroPython:Библиотеки/pyb/Класс Pin/Класс PinAF|Класс PinAF/pinaf.reg()|pinaf.reg()]]
* [[MicroPython:Библиотеки/pyb/Класс Pin/Класс PinAF/pinaf.reg()|pinaf.reg()]]


=См.также=
=См.также=

Текущая версия от 18:16, 14 мая 2023

Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.


Класс Pin – управление I/O-контактами[1]

Класс Pin – это базовый класс для управления I/O-контактами. В нем есть методы, чтобы задать режим работы контакта (входной, выходной и т.д.), а также методы, позволяющие задать и прочесть цифровой логический уровень контакта. Об управлении аналоговыми контактами читайте в статье о классе ADC.

Модель использования

Все контакты платы предварительно определены в pyb.Pin.board.Name:

x1_pin = pyb.Pin.board.X1

g = pyb.Pin(pyb.Pin.board.X1, pyb.Pin.IN)

Контакты CPU, соответствующие контактам платы, заданы в pyb.Pin.cpu.Name. Название CPU-контакта состоит из буквы порта, после которой идет номер контакта. На PYBv1.0 pyb.Pin.board.X1 и pyb.Pin.cpu.A0 – это один и тот же контакт.

Также можно использовать строки:

g = pyb.Pin('X1', pyb.Pin.OUT_PP)

Кроме того, пользователи могут задавать собственные названия контактов...

MyMapperDict = { 'LeftMotorDir' : pyb.Pin.cpu.C12 }
pyb.Pin.dict(MyMapperDict)
g = pyb.Pin("LeftMotorDir", pyb.Pin.OUT_OD)

...и запрашивать привязочные данные:

pin = pyb.Pin("LeftMotorDir")

Также пользователь может создать собственную привязочную функцию:

def MyMapper(pin_name):
   if pin_name == "LeftMotorDir":
       return pyb.Pin.cpu.A0

pyb.Pin.mapper(MyMapper)

Таким образом, если вызвать pyb.Pin("LeftMotorDir", pyb.Pin.OUT_PP), то контакт "LeftMotorDir" будет напрямую передан привязочной функции.

Итак, привязка номера обычного контакта к какому-то интересному названию осуществляется в следующем порядке:

  1. Напрямую указываем объект Pin.
  2. Создаем пользовательскую привязочную функцию.
  3. Выполняем пользовательскую привязку (нужно, чтобы объект можно было использовать в качестве ключа словаря).
  4. Задаем строку, соответствующую номеру платы.
  5. Задаем строку, соответствующую контакту/порту CPU.

Некоторую отладочную информацию о том, как объект привязан к контакту, можно узнать с помощью метода pyb.Pin.debug(True).

Если у контакта включен режим Pin.PULL_UP или Pin.PULL_DOWN, его резистор на 40 кОм будет притянут, соответственно, либо к 3.3 вольтам, либо к «земле» (за исключением контакта Y5, который оснащен резисторами на 11 кОм).

Теперь, когда на GPIO-контакте будет замечен задний фронт, это будет запускать функцию обратного вызова. Внимание: механические кнопки страдают так называемым «дребезгом» – их нажатие или отпускание может привести к нескольким ложным срабатываниям. Более подробно о дребезге, а также о том, как с ним справиться, читайте тут.

Все объекты Pin привязываются к GPIO-контактам через привязывающую функцию.

Конструкторы

Методы класса

Методы

Константы

Класс PinAF – альтернативные функции контакта

В классе Pin реализована программная презентация физического контакта микропроцессора. Один контакт может выполнять несколько функций (GPIO, I2C SDA и т.д.) – их презентация реализуется с помощью класса PinAF.

Пример использования:

x3 = pyb.Pin.board.X3
x3_af = x3.af_list()

В x3_af теперь будет содержаться массив объектов PinAF, доступных на контакте X3.

На PyBoard в x3_af будет содержаться:

[Pin.AF1_TIM2, Pin.AF2_TIM5, Pin.AF3_TIM9, Pin.AF7_USART2]

Обычно каждый контакт самостоятельно настраивает свои альтернативные функции, но иногда одна и та же функция доступна на разных контактах, что вынуждает прибегнуть к использованию дополнительного кода.

Чтобы настроить X3 на использование TIM2_CH3, можно выполнить следующее:

pin = pyb.Pin(pyb.Pin.board.X3, mode=pyb.Pin.AF_PP, af=pyb.Pin.AF1_TIM2)

...или...

pin = pyb.Pin(pyb.Pin.board.X3, mode=pyb.Pin.AF_PP, af=1)

Методы

См.также

Внешние ссылки