Текущая версия от 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" будет напрямую передан привязочной функции.

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

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

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

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

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

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

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

pyb.Pin(id, ...)

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

Методы

Константы

Класс 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)

Методы

См.также

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

↑ docs.micropython.org - class Pin – control I/O pins

[1] s.micropython.org - class Pin – control I/O pins

[1]

@@ Строка 11: / Строка 11: @@
 Все контакты платы предварительно определены в pyb.Pin.board.Name:
-<syntaxhighlight lang="python" enclose="div">
+<syntaxhighlight lang="python">
 x1_pin = pyb.Pin.board.X1
@@ Строка 17: / Строка 17: @@
 </syntaxhighlight>
-Контакты CPU, соответствующие контактам платы, заданы в pyb.Pin.cpu.Name. Название CPU-контакта состоит из буквы порта, после которой идет номер контакта. На PYBv1.0 pyb.Pin.board.X1 и pyb.Pin.cpu.A0 – это один и тот же контакт.
+Контакты [[CPU]], соответствующие контактам платы, заданы в ''pyb.Pin.cpu.Name''. Название CPU-контакта состоит из буквы порта, после которой идет номер контакта. На ''PYBv1.0 pyb.Pin.board.X1'' и ''pyb.Pin.cpu.A0'' – это один и тот же контакт.
 Также можно использовать строки:
-<syntaxhighlight lang="python" enclose="div">
+<syntaxhighlight lang="python">
 g = pyb.Pin('X1', pyb.Pin.OUT_PP)
 </syntaxhighlight>
@@ Строка 27: / Строка 27: @@
 Кроме того, пользователи могут задавать собственные названия контактов...
-<syntaxhighlight lang="python" enclose="div">
+<syntaxhighlight lang="python">
 MyMapperDict = { 'LeftMotorDir' : pyb.Pin.cpu.C12 }
 pyb.Pin.dict(MyMapperDict)
@@ Строка 35: / Строка 35: @@
 ...и запрашивать привязочные данные:
-<syntaxhighlight lang="python" enclose="div">
+<syntaxhighlight lang="python">
 pin = pyb.Pin("LeftMotorDir")
 </syntaxhighlight>
@@ Строка 41: / Строка 41: @@
 Также пользователь может создать собственную привязочную функцию:
-<syntaxhighlight lang="python" enclose="div">
+<syntaxhighlight lang="python">
 def MyMapper(pin_name):
     if pin_name == "LeftMotorDir":
@@ Строка 49: / Строка 49: @@
 </syntaxhighlight>
-Таким образом, если вызвать pyb.Pin("LeftMotorDir", pyb.Pin.OUT_PP), то контакт "LeftMotorDir" будет напрямую передан привязочной функции.
+Таким образом, если вызвать ''pyb.Pin("LeftMotorDir", pyb.Pin.OUT_PP)'', то контакт ''"LeftMotorDir"'' будет напрямую передан привязочной функции.
 Итак, привязка номера обычного контакта к какому-то интересному названию осуществляется в следующем порядке:
-# Напрямую указываем объект Pin.
+# Напрямую указываем объект ''Pin''.
 # Создаем пользовательскую привязочную функцию.
 # Выполняем пользовательскую привязку (нужно, чтобы объект можно было использовать в качестве ключа словаря).
@@ Строка 60: / Строка 60: @@
 Некоторую отладочную информацию о том, как объект привязан к контакту, можно узнать с помощью метода pyb.Pin.debug(True).
-Если у контакта включен режим Pin.PULL_UP или Pin.PULL_DOWN, его резистор на 40 кОм будет притянут, соответственно, либо к 3.3 вольтам, либо к «земле» (за исключением контакта Y5, который оснащен резисторами на 11 кОм).
+Если у контакта включен режим [[MicroPython:Библиотеки/pyb/Класс Pin/Pin.PULL_UP|Pin.PULL_UP]] или [[MicroPython:Библиотеки/pyb/Класс Pin/Pin.PULL_DOWN|Pin.PULL_DOWN]], его [[резистор]] на [[40 кОм]] будет притянут, соответственно, либо к ''3.3 вольтам'', либо к ''«земле»'' (за исключением контакта ''Y5'', который оснащен [[резистор]]ами на [[11 кОм]]).
-Теперь, когда на GPIO-контакте будет замечен задний фронт, это будет запускать функцию обратного вызова. Внимание: механические кнопки страдают так называемым «дребезгом» – их нажатие или отпускание может привести к нескольким ложным срабатываниям. Более подробно о дребезге, а также о том, как с ним справиться, читайте [http://www.eng.utah.edu/~cs5780/debouncing.pdf тут].
-Все объекты Pin привязываются к GPIO-контактам через привязывающую функцию.
+Теперь, когда на GPIO-контакте будет замечен задний фронт, это будет запускать функцию обратного вызова. Внимание: механические кнопки страдают так называемым ''«дребезгом»'' – их нажатие или отпускание может привести к нескольким ложным срабатываниям. Более подробно о дребезге, а также о том, как с ним справиться, читайте [http://www.eng.utah.edu/~cs5780/debouncing.pdf тут].
+Все объекты ''Pin'' привязываются к GPIO-контактам через привязывающую функцию.
 == Конструкторы ==
-* Класс pyb.Pin(id, ...) – создает новый объект Pin, привязанный к идентификатору id. Если задать здесь дополнительные аргументы, они будут использованы для инициализации объекта Pin. Читайте о них в описании метода init().
+* [[MicroPython:Библиотеки/pyb/Класс Pin/pyb.Pin()|pyb.Pin(id, ...)]]
 == Методы класса ==
-* Pin.debug([state]) – задает или считывает то, включен ли режим отладки или нет (чтобы включить отладку, задайте True, а чтобы выключить – False).
+* [[MicroPython:Библиотеки/pyb/Класс Pin/Pin.debug()|Pin.debug([state])]]
-* Pin.dict([dict]) – задает или считывает словарь для привязки контактов.
+* [[MicroPython:Библиотеки/pyb/Класс Pin/Pin.dict()|Pin.dict([dict])]]
-* Pin.mapper([fun]) – задает или считывает привязочную функцию.
+* [[MicroPython:Библиотеки/pyb/Класс Pin/Pin.mapper()|Pin.mapper([fun])]]
 == Методы ==
-* Pin.init(mode, pull=Pin.PULL_NONE, af=- 1) – инициализирует контакт:
+* [[MicroPython:Библиотеки/pyb/Класс Pin/Pin.init()|Pin.init(mode, pull=Pin.PULL_NONE, af=- 1)]]
-o	В аргументе mode может быть следующее:
+* [[MicroPython:Библиотеки/pyb/Класс Pin/Pin.value()|Pin.value([value])]]
-	Pin.IN – делает контакт входящим.
+* [[MicroPython:Библиотеки/pyb/Класс Pin/Pin.__str__()|Pin.__str__()]]
-	Pin.OUT_PP – делает контакт выходящим (обычный активный выход).
+* [[MicroPython:Библиотеки/pyb/Класс Pin/Pin.af()|Pin.af()]]
-	Pin.OUT_OD – делает контакт выходящим (выход с открытым стоком).
+* [[MicroPython:Библиотеки/pyb/Класс Pin/Pin.af_list()|Pin.af_list()]]
-	Pin.AF_PP – контакт будет выполнять альтернативную функцию (обычный активный выход).
+* [[MicroPython:Библиотеки/pyb/Класс Pin/Pin.gpio()|Pin.gpio()]]
-	Pin.AF_OD – контакт будет выполнять альтернативную функцию (выход с открытым стоком).
+* [[MicroPython:Библиотеки/pyb/Класс Pin/Pin.mode()|Pin.mode()]]
-	Pin.ANALOG – делает контакт аналоговым.
+* [[MicroPython:Библиотеки/pyb/Класс Pin/Pin.name()|Pin.name()]]
-o	В аргументе pull может быть следующее:
+* [[MicroPython:Библиотеки/pyb/Класс Pin/Pin.names()|Pin.names()]]
-	Pin.PULL_NONE – без подтягивающих/стягивающих резисторов.
+* [[MicroPython:Библиотеки/pyb/Класс Pin/Pin.pin()|Pin.pin()]]
-	Pin.PULL_UP – включает подтягивающий резистор.
+* [[MicroPython:Библиотеки/pyb/Класс Pin/Pin.port()|Pin.port()]]
-	Pin.PULL_DOWN – включает стягивающий резистор.
+* [[MicroPython:Библиотеки/pyb/Класс Pin/Pin.pull()|Pin.pull()]]
-Если задан режим Pin.AF_PP или Pin.AF_OD, то в аргументе af можно задать индекс или название одной из альтернативных функций, связанных с этим контактом.
-Возвращает None.
-* Pin.value([value]) – задает или считывает цифровой логический уровень контакта. Если не задать аргумент value, тот метод вернет «0» или «1» в зависимости от того, какой логический уровень в данный момент имеется на контакте. Если аргумент value будет задан, это задаст логический уровень на контакте. В value можно задать любое значение, которое можно преобразовать в булево значение. И если оно будет преобразовано в True, контакт получит высокий логический уровень, а если в False, то низкий.
-* Pin.__str__() – возвращает строку, описывающую объект Pin.
-* Pin.af() – возвращает альтернативную функцию контакта, заданную в данный момент. Возвращаемое целое число будет соответствовать одной из констант для аргумента af в методе init().
-* Pin.af_list() – возвращает массив альтернативных функций, доступных на этом контакте.
-* Pin.gpio() – возвращает базовый адрес GPIO-блока, связанного с контактом.
-* Pin.mode() – возвращает режим, в котором в данный момент работает контакт. Возвращаемое целое число будет соответствовать одной из констант для аргумента mode в методе init().
-* Pin.name() – считывает название контакта.
-* Pin.names() – возвращает процессорное и платовое названия контакта.
-* Pin.pin() – считывает номер контакта.
-* Pin.port() – считывает порт контакта.
-* Pin.pull() – возвращает резисторный режим, который в данный момент задан на контакте. Возвращаемое целое число будет соответствовать одной из констант для аргумента pull в методе init().
 == Константы ==
-* Pin.AF_OD – инициализирует контакт в режиме альтернативной функции (выход с активным стоком).
+* [[MicroPython:Библиотеки/pyb/Класс Pin/Pin.AF_OD|Pin.AF_OD]]
-* Pin.AF_PP – инициализирует контакт в режиме альтернативной функции (обычный активный выход).
+* [[MicroPython:Библиотеки/pyb/Класс Pin/Pin.AF_PP|Pin.AF_PP]]
-* Pin.ANALOG – инициализирует контакт в аналоговым режиме.
+* [[MicroPython:Библиотеки/pyb/Класс Pin/Pin.ANALOG|Pin.ANALOG]]
-* Pin.IN – инициализирует контакт во входящем режиме.
+* [[MicroPython:Библиотеки/pyb/Класс Pin/Pin.IN|Pin.IN]]
-* Pin.OUT_OD – инициализирует контакт в выходящем режиме (выход с открытым стоком).
+* [[MicroPython:Библиотеки/pyb/Класс Pin/Pin.OUT_OD|Pin.OUT_OD]]
-* Pin.OUT_PP – инициализирует контакт в выходящем режиме (обычный активный выход).
+* [[MicroPython:Библиотеки/pyb/Класс Pin/Pin.OUT_PP|Pin.OUT_PP]]
-* Pin.PULL_DOWN – включает на контакте стягивающий резистор.
+* [[MicroPython:Библиотеки/pyb/Класс Pin/Pin.PULL_DOWN|Pin.PULL_DOWN]]
-* Pin.PULL_NONE – на контакте не будет включено ни подтягивающего, ни стягивающего резистора.
+* [[MicroPython:Библиотеки/pyb/Класс Pin/Pin.PULL_NONE|Pin.PULL_NONE]]
-* Pin.PULL_UP – включает на контакте подтягивающий резистор.
+* [[MicroPython:Библиотеки/pyb/Класс Pin/Pin.PULL_UP|Pin.PULL_UP]]
 == Класс PinAF – альтернативные функции контакта ==
-В классе Pin реализована программная презентация физического контакта микропроцессора. Один контакт может выполнять несколько функций (GPIO, I2C SDA и т.д.) – их презентация реализуется с помощью класса PinAF.
+В классе ''Pin'' реализована программная презентация физического контакта [[микропроцессор]]а. Один контакт может выполнять несколько функций ([[GPIO]], [[I2C]] [[SDA]] и т.д.) – их презентация реализуется с помощью класса PinAF.
 Пример использования:
-<syntaxhighlight lang="python" enclose="div">
+<syntaxhighlight lang="python">
 x3 = pyb.Pin.board.X3
 x3_af = x3.af_list()
 </syntaxhighlight>
-В x3_af теперь будет содержаться массив объектов PinAF, доступных на контакте X3.
+В ''x3_af'' теперь будет содержаться массив объектов ''PinAF'', доступных на контакте X3.
-На 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]
 </syntaxhighlight>
@@ Строка 136: / Строка 124: @@
 Обычно каждый контакт самостоятельно настраивает свои альтернативные функции, но иногда одна и та же функция доступна на разных контактах, что вынуждает прибегнуть к использованию дополнительного кода.
-Чтобы настроить 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)
 </syntaxhighlight>
@@ Строка 144: / Строка 132: @@
 ...или...
-<syntaxhighlight lang="python" enclose="div">
+<syntaxhighlight lang="python">
 pin = pyb.Pin(pyb.Pin.board.X3, mode=pyb.Pin.AF_PP, af=1)
 </syntaxhighlight>
@@ Строка 150: / Строка 138: @@
 ===Методы===
-* pinaf.__str__() – возвращает строку, описывающую альтернативную функцию.
+* [[MicroPython:Библиотеки/pyb/Класс Pin/Класс PinAF/pinaf.__str__()|pinaf.__str__()]]
-* pinaf.index() – возвращает индекс альтернативной функции.
+* [[MicroPython:Библиотеки/pyb/Класс Pin/Класс PinAF/pinaf.index()|pinaf.index()]]
-* pinaf.name() – возвращает название альтернативной функции.
+* [[MicroPython:Библиотеки/pyb/Класс Pin/Класс PinAF/pinaf.name()|pinaf.name()]]
-* pinaf.reg() – возвращает базовый регистр, связанный с периферийным устройством, которое использует эту альтернативную функцию. К примеру, если альтернативная функция – это TIM2_CH3, то эта функция вернет stm.TIM2.
+* [[MicroPython:Библиотеки/pyb/Класс Pin/Класс PinAF/pinaf.reg()|pinaf.reg()]]
-<syntaxhighlight lang="python" enclose="div">
 =См.также=

Партнерские ресурсы
Криптовалюты	Обмен криптовалют - www.bestchange.ru Криптовалютная биржа CoinEx Криптовалютная биржа Binance HIVE OS - операционная система для майнинга e4pool - Мультивалютный пул для майнинга.
Магазины	AliExpress — глобальная виртуальная (в Интернете) торговая площадка, предоставляющая возможность покупать товары производителей из КНР; computeruniverse.net - Интернет-магазин компьютеров(Промо код 5 Евро на первую покупку:FWWC3ZKQ);
Хостинг	DigitalOcean - американский провайдер облачных инфраструктур, с главным офисом в Нью-Йорке и с центрами обработки данных по всему миру;
Разное	Викиум - Онлайн-тренажер для мозга Like Центр - Центр поддержки и развития предпринимательства. Gamersbay - лучший магазин по бустингу для World of Warcraft. Ноотропы OmniMind N°1 - Усиливает мозговую активность. Повышает мотивацию. Улучшает память. Санкт-Петербургская школа телевидения - это федеральная сеть образовательных центров, которая имеет филиалы в 37 городах России. Lingualeo.com — интерактивный онлайн-сервис для изучения и практики английского языка в увлекательной игровой форме. Junyschool (Джунискул) – международная школа программирования и дизайна для детей и подростков от 5 до 17 лет, где ученики осваивают компьютерную грамотность, развивают алгоритмическое и креативное мышление, изучают основы программирования и компьютерной графики, создают собственные проекты: игры, сайты, программы, приложения, анимации, 3D-модели, монтируют видео. Умназия - Интерактивные онлайн-курсы и тренажеры для развития мышления детей 6-13 лет SkillBox - это один из лидеров российского рынка онлайн-образования. Среди партнеров Skillbox ведущий разработчик сервисного дизайна AIC, медиа-компания Yoola, первое и самое крупное русскоязычное аналитическое агентство Tagline, онлайн-школа дизайна и иллюстрации Bang! Bang! Education, оператор PR-рынка PACO, студия рисования Draw&Go, агентство performance-маркетинга Ingate, scrum-студия Sibirix, имидж-лаборатория Персона. «Нетология» — это университет по подготовке и дополнительному обучению специалистов в области интернет-маркетинга, управления проектами и продуктами, дизайна, Data Science и разработки. В рамках Нетологии студенты получают ценные теоретические знания от лучших экспертов Рунета, выполняют практические задания на отработку полученных навыков, общаются с экспертами и единомышленниками. Познакомиться со всеми продуктами подробнее можно на сайте https://netology.ru, линейка курсов и профессий постоянно обновляется. StudyBay Brazil – это онлайн биржа для португалоговорящих студентов и авторов! Студент получает уникальную работу любого уровня сложности и больше свободного времени, в то время как у автора появляется дополнительный заработок и бесценный опыт. Автор24 — самая большая в России площадка по написанию учебных работ: контрольные и курсовые работы, дипломы, рефераты, решение задач, отчеты по практике, а так же любой другой вид работы. Сервис сотрудничает с более 70 000 авторов. Более 1 000 000 работ уже выполнено. StudyBay – это онлайн биржа для англоязычных студентов и авторов! Студент получает уникальную работу любого уровня сложности и больше свободного времени, в то время как у автора появляется дополнительный заработок и бесценный опыт.

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

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

Содержание

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

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

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

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

Методы

Константы

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

Методы

См.также

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

Навигация

Действия на странице

Действия на странице

Персональные инструменты

Навигация

Поиск

Инструменты

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

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

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

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

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

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

Методы

Константы

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

Методы

См.также

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

Навигация

Поиск

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