classe LED – controlo portátil do LED integrado

A classe LED é um invólucro portátil simples em torno de machine.Pin que controla um LED de placa com nome, ocultando a diferença de ligação ativo-baixo / ativo-alto entre placas. É fornecida como módulo Python congelado pelo firmware OpenMV (ver scripts/libraries/machine.py) e está portanto disponível em todas as placas suportadas por OpenMV, independentemente do port.

O LED é controlado como um GPIO simples de ligar/desligar; não existe controlo de intensidade por PWM. Para LEDs ligados a pinos com capacidade PWM, controle-os diretamente através de PWM.

Exemplo de utilização:

from machine import LED

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

Construtores

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

Constrói um objeto LED associado ao LED identificado por pin_name. pin_name é uma cadeia de caracteres de LED de placa OpenMV ("LED_RED", "LED_GREEN", "LED_BLUE", "LED_IR" – o conjunto exato depende da câmara) ou um objeto Pin.

O construtor regista se o LED está ligado ativo-baixo ou ativo-alto (utilizando boardname() para consultar a convenção de nível ativo da placa atual) para que os chamadores passem sempre níveis lógicos de ligar/desligar sem se preocuparem com a polaridade.

Métodos

on() → None

Coloca o LED no estado ligado.

off() → None

Coloca o LED no estado desligado.

toggle() → None

Inverte o estado atual do LED.

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

Obtém ou define o estado do LED.

Sem argumento, retorna o estado lógico atual (0 = desligado, 1 = ligado).

Com um único argumento v, define o LED para esse estado. O controlador efetua XOR de v com a convenção de nível ativo da placa, de modo que 1 é sempre «ligado» independentemente da polaridade.

boardname() → str

Retorna a cadeia de caracteres do nome da placa (o prefixo de os.uname().machine antes de " with "). Utilizado internamente para escolher a convenção de nível ativo correta para o LED.