classe LED – contrôle portable des LED embarquées

La classe LED est une fine enveloppe portable autour de machine.Pin qui pilote une LED nommée de la carte, masquant la différence de câblage actif-bas / actif-haut entre les cartes. Elle est livrée sous forme de module Python figé par le micrologiciel OpenMV (voir scripts/libraries/machine.py) et est donc disponible sur toutes les cartes prises en charge par OpenMV, quel que soit le port.

La LED est pilotée comme un simple GPIO marche/arrêt ; il n’y a pas de contrôle d’intensité par PWM. Pour les LED câblées sur des broches compatibles PWM, pilotez-les directement via PWM.

Exemple d’utilisation:

from machine import LED

red = LED("LED_RED")
red.on()
red.toggle()
red.off()

Constructeurs

class machine.LED(pin_name: str | Pin) → LED

Construit un objet LED lié à la LED identifiée par pin_name. pin_name est soit une chaîne de LED de carte OpenMV ("LED_RED", "LED_GREEN", "LED_BLUE", "LED_IR" – l’ensemble exact dépend de la caméra), soit un objet Pin.

Le constructeur enregistre si la LED est câblée en actif-bas ou en actif-haut (en utilisant boardname() pour rechercher la convention de niveau actif de la carte courante), de sorte que les appelants passent toujours des niveaux logiques marche/arrêt sans se soucier de la polarité.

Méthodes

on() → None

Met la LED à l’état allumé.

off() → None

Met la LED à l’état éteint.

toggle() → None

Inverse l’état actuel de la LED.

value(v: int | None = None, /) → int | None

Obtient ou définit l’état de la LED.

Sans argument, retourne l’état logique actuel (0 = éteint, 1 = allumé).

Avec un seul argument v, met la LED à cet état. Le pilote effectue un OU exclusif de v avec la convention de niveau actif de la carte, de sorte que 1 correspond toujours à « allumé » quelle que soit la polarité.

boardname() → str

Retourne la chaîne de nom de la carte (le préfixe de os.uname().machine avant " with "). Utilisé en interne pour choisir la bonne convention de niveau actif pour la LED.