class LED – 이식 가능한 온보드 LED 제어

LED 클래스는 machine.Pin 위에 얇게 감싼 이식 가능한 래퍼로, 이름이 지정된 보드 LED를 구동하며 보드 간의 액티브 로우/액티브 하이 배선 차이를 숨깁니다. OpenMV 펌웨어에 의해 고정된(frozen) Python 모듈로 제공되므로(scripts/libraries/machine.py 참조), 포트에 관계없이 모든 OpenMV 지원 보드에서 사용할 수 있습니다.

LED는 단순한 온/오프 GPIO로 구동되며, PWM 강도 제어는 없습니다. PWM 지원 핀에 연결된 LED의 경우 PWM을 통해 직접 구동하세요.

사용 예제:

from machine import LED

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

생성자

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

pin_name으로 식별되는 LED에 바인딩된 LED 객체를 생성합니다. pin_name은 OpenMV 보드 LED 문자열("LED_RED", "LED_GREEN", "LED_BLUE", "LED_IR" – 정확한 집합은 카메라에 따라 다름)이거나 Pin 객체입니다.

생성자는 (현재 보드의 액티브 레벨 규칙을 조회하기 위해 boardname()을 사용하여) LED가 액티브 로우로 배선되었는지 액티브 하이로 배선되었는지를 기록하므로, 호출자는 극성을 신경 쓰지 않고 항상 논리적인 온/오프 레벨을 전달할 수 있습니다.

메서드

on() → None

LED를 켜짐 상태로 구동합니다.

off() → None

LED를 꺼짐 상태로 구동합니다.

toggle() → None

LED의 현재 상태를 반전시킵니다.

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

LED 상태를 가져오거나 설정합니다.

인수가 없으면 현재 논리 상태(0 = 꺼짐, 1 = 켜짐)를 반환합니다.

단일 v 인수를 사용하면 LED를 해당 상태로 설정합니다. 드라이버는 v를 보드의 액티브 레벨 규칙과 XOR 연산하므로 극성에 관계없이 1은 항상 “켜짐”입니다.

boardname() → str

보드 이름 문자열(os.uname().machine에서 " with " 앞부분의 접두사)을 반환합니다. LED에 맞는 액티브 레벨 규칙을 선택하기 위해 내부적으로 사용됩니다.