clase LED – control portátil del LED integrado en la placa

La clase LED es una envoltura portátil ligera sobre machine.Pin que controla un LED de placa con nombre, ocultando la diferencia de cableado activo en bajo / activo en alto entre placas. Se distribuye como un módulo de Python congelado en el firmware de OpenMV (consulta scripts/libraries/machine.py) y, por tanto, está disponible en todas las placas compatibles con OpenMV, independientemente del puerto.

El LED se controla como un GPIO de encendido/apagado sencillo; no hay control de intensidad por PWM. Para los LED conectados a pines con capacidad de PWM, contrólalos directamente a través de PWM.

Ejemplo de uso:

from machine import LED

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

Constructores

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

Construye un objeto LED vinculado al LED identificado por pin_name. pin_name es o bien una cadena de LED de placa OpenMV ("LED_RED", "LED_GREEN", "LED_BLUE", "LED_IR" – el conjunto exacto depende de la cámara) o un objeto Pin.

El constructor registra si el LED está cableado como activo en bajo o activo en alto (usando boardname() para consultar la convención de nivel activo de la placa actual) de modo que quienes lo llaman siempre pasen niveles lógicos de encendido/apagado sin preocuparse por la polaridad.

Métodos

on() → None

Pone el LED en su estado de encendido.

off() → None

Pone el LED en su estado de apagado.

toggle() → None

Invierte el estado actual del LED.

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

Obtiene o establece el estado del LED.

Sin argumento, devuelve el estado lógico actual (0 = apagado, 1 = encendido).

Con un único argumento v, establece el LED en ese estado. El controlador aplica una operación XOR a v con la convención de nivel activo de la placa, de modo que 1 siempre significa «encendido» independientemente de la polaridad.

boardname() → str

Devuelve la cadena con el nombre de la placa (el prefijo de os.uname().machine antes de " with "). Se usa internamente para elegir la convención de nivel activo correcta para el LED.