clasa Pin – controlul pinilor I/O¶

Un obiect Pin reprezintă un singur GPIO de pe STM32. Acesta oferă metode pentru a configura modul pinului (intrare, ieșire, funcție alternativă, analogic) și rezistențele de pull, precum și pentru a citi sau a impune nivelul său logic digital. Pentru eșantionare analogică consultați pyb.ADC; pentru enumerarea funcțiilor alternative consultați PinAF.

Toți pinii de pe header sunt predefiniți ca pyb.Pin.board.<name>. Majoritatea camerelor OpenMV Cam bazate pe STM32 expun pinii de pe header-ul I/O P0 … P9; OpenMV Cam N6 expune pini suplimentari, până la P18

p0 = pyb.Pin.board.P0
g = pyb.Pin(pyb.Pin.board.P0, pyb.Pin.IN)

Portul/pinul STM32 subiacent poate fi de asemenea adresat direct prin pyb.Pin.cpu.<name>, denumit cu litera portului urmată de numărul pinului (de exemplu pyb.Pin.cpu.A0). Maparea fiecărui pin de pe header-ul OpenMV la un pin CPU este fixată de placă.

Pinii pot fi de asemenea selectați după nume sub formă de șir:

g = pyb.Pin("P0", pyb.Pin.OUT_PP)

Numele definite de utilizator pot fi adăugate cu Pin.dict()

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

și interogate înapoi:

pin = pyb.Pin("LeftMotorDir")

În mod alternativ, o funcție de mapare personalizată poate fi instalată cu Pin.mapper()

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

pyb.Pin.mapper(MyMapper)

astfel încât un apel la pyb.Pin("LeftMotorDir", pyb.Pin.OUT_PP) transmite "LeftMotorDir" direct către funcția de mapare.

Ordinea următoare determină modul în care un nume este mapat la un pin fizic:

Un obiect Pin este transmis direct.
Funcția de mapare furnizată de utilizator returnează un pin.
Dicționarul furnizat de utilizator conține o cheie corespunzătoare.
Șirul corespunde unui nume de pin al plăcii (P0, P1, …).
Șirul corespunde unui nume de port/pin CPU (A0, B7, …).

Apelați pyb.Pin.debug(True) pentru a afișa informații de diagnosticare despre modul în care fiecare obiect este mapat la un pin.

Constructori¶

class pyb.Pin(id: str | Pin, *args, **kwargs)¶

Creează un nou obiect Pin asociat cu id-ul dat. Dacă sunt furnizate argumente suplimentare, acestea sunt transmise mai departe către Pin.init() pentru a configura pinul.

Metode de clasă¶

classmethod debug(state: bool | None = None) → bool | None¶: Obține sau setează starea de depanare (True sau False pentru pornit sau oprit).

classmethod dict(dict: dict | None = None) → dict | None¶: Obține sau setează dicționarul funcției de mapare a pinilor.

classmethod mapper(fun: Callable[[str], Pin] | None = None) → Callable[[str], Pin] | None¶: Obține sau setează funcția de mapare a pinilor.

Metode¶

init(mode: int, pull: int = Pin.PULL_NONE, *, value: int | None = None, alt: int | str = -1) → None¶

Inițializează pinul:

mode poate fi una dintre:

Pin.IN - configurează pinul pentru intrare;

Pin.OUT_PP - configurează pinul pentru ieșire, cu control push-pull;

Pin.OUT_OD - configurează pinul pentru ieșire, cu control open-drain;

Pin.ALT - configurează pinul pentru funcție alternativă, intrare sau ieșire;

Pin.AF_PP - configurează pinul pentru funcție alternativă, push-pull;

Pin.AF_OD - configurează pinul pentru funcție alternativă, open-drain;

Pin.ANALOG - configurează pinul pentru mod analogic.

pull poate fi una dintre:

Pin.PULL_NONE - fără rezistențe de pull-up sau pull-down;

Pin.PULL_UP - activează rezistența de pull-up;

Pin.PULL_DOWN - activează rezistența de pull-down.

Când un pin are activat modul de pull Pin.PULL_UP sau Pin.PULL_DOWN, acel pin este tras la 3V3, respectiv la GND, printr-o rezistență internă (de obicei zeci de kOhm – consultați caracteristicile electrice din fișa tehnică STM32 pentru camera OpenMV Cam utilizată).

value, dacă nu este None, va seta valoarea de ieșire a portului înainte de a activa pinul.

alt poate fi folosit când modul este Pin.ALT, Pin.AF_PP sau Pin.AF_OD pentru a seta indexul sau numele uneia dintre funcțiile alternative asociate unui pin. Acest argument se numea anterior af, care poate fi încă folosit dacă este necesar.

value(value: Any | None = None) → int | None¶

Obține sau setează nivelul logic digital al pinului:

Fără niciun argument, returnează 0 sau 1 în funcție de nivelul logic al pinului.

Cu value dat, setează nivelul logic al pinului. value poate fi orice se convertește la o valoare booleană. Dacă se convertește la True, pinul este setat pe nivel înalt, altfel este setat pe nivel jos.

__str__() → str¶: Returnează un șir care descrie obiectul pin.

af() → int¶: Returnează funcția alternativă configurată în prezent a pinului. Numărul întreg returnat va corespunde uneia dintre constantele permise pentru argumentul af al funcției init.

af_list() → List[PinAF]¶: Returnează un tablou al funcțiilor alternative disponibile pentru acest pin.

gpio() → int¶: Returnează adresa de bază a blocului GPIO asociat cu acest pin.

mode() → int¶: Returnează modul configurat în prezent al pinului. Numărul întreg returnat va corespunde uneia dintre constantele permise pentru argumentul mode al funcției init.

name() → str¶: Obține numele pinului.

names() → List[str]¶: Returnează numele cpu și board pentru acest pin.

pin() → int¶: Obține numărul pinului.

port() → int¶: Obține portul pinului.

pull() → int¶: Returnează configurația de pull curentă a pinului. Numărul întreg returnat va corespunde uneia dintre constantele permise pentru argumentul pull al funcției init.

Constante¶

IN: int¶: Configurează pinul ca intrare digitală (impedanță înaltă).

OUT_PP: int¶: Configurează pinul ca ieșire digitală cu un driver push-pull.

OUT_OD: int¶: Configurează pinul ca ieșire digitală cu un driver open-drain.

ANALOG: int¶: Configurează pinul ca intrare analogică (de exemplu pentru utilizare cu ADC).

ALT: int¶: Configurează pinul ca funcție alternativă (intrare sau ieșire).

AF_PP: int¶: Configurează pinul ca funcție alternativă cu un driver push-pull.

AF_OD: int¶: Configurează pinul ca funcție alternativă cu un driver open-drain.

PULL_NONE: int¶: Dezactivează atât rezistențele de pull-up, cât și cele de pull-down de pe pin.

PULL_UP: int¶: Activează rezistența internă de pull-up de pe pin.

PULL_DOWN: int¶: Activează rezistența internă de pull-down de pe pin.