classe LED – controle portátil do LED embutido na placa

A classe LED é um invólucro portátil e leve em torno de machine.Pin que controla um LED nomeado da placa, ocultando a diferença de fiação ativa em nível baixo / ativa em nível alto entre as placas. Ela é fornecida como um módulo Python congelado pelo firmware OpenMV (veja scripts/libraries/machine.py) e, portanto, está disponível em todas as placas suportadas pela OpenMV, independentemente da porta.

O LED é controlado como um simples GPIO liga/desliga; não há controle de intensidade por PWM. Para LEDs conectados a pinos com capacidade de PWM, controle-os diretamente via PWM.

Exemplo de uso:

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 vinculado ao LED identificado por pin_name. pin_name é uma string de LED de placa OpenMV ("LED_RED", "LED_GREEN", "LED_BLUE", "LED_IR" – o conjunto exato depende da câmera) ou um objeto Pin.

O construtor registra se o LED é conectado como ativo em nível baixo ou ativo em nível alto (usando boardname() para consultar a convenção de nível ativo da placa atual), de modo que os chamadores sempre passem níveis lógicos liga/desliga sem se preocupar com a polaridade.

Métodos

on() → None

Coloca o LED em seu estado ligado.

off() → None

Coloca o LED em seu 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 driver aplica 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 string do nome da placa (o prefixo de os.uname().machine antes de " with "). Usado internamente para escolher a convenção de nível ativo correta para o LED.