الفئة LED -- تحكم محمول في مؤشر LED المدمج على اللوحة

الفئة LED هي غلاف محمول رقيق حول machine.Pin يتحكم في مؤشر LED مسمّى على اللوحة، ويخفي اختلاف التوصيل بين الفعّال-منخفض / الفعّال-مرتفع بين اللوحات. تُشحن كوحدة Python مجمّدة ضمن برنامج OpenMV الثابت (انظر scripts/libraries/machine.py) وبالتالي فهي متاحة على كل لوحة مدعومة من OpenMV، بصرف النظر عن المنفذ.

يُشغَّل مؤشر LED كـ GPIO بسيط بحالة تشغيل/إيقاف؛ ولا يوجد تحكم في الشدة عبر PWM. بالنسبة لمؤشرات LED الموصّلة بدبابيس قادرة على PWM شغّلها مباشرةً عبر PWM بدلاً من ذلك.

مثال على الاستخدام:

from machine import LED

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

البواني (Constructors)

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

أنشئ كائن LED مرتبطاً بمؤشر LED المحدد بواسطة pin_name. يكون pin_name إما سلسلة LED للوحة OpenMV ("LED_RED" أو "LED_GREEN" أو "LED_BLUE" أو "LED_IR" -- وتعتمد المجموعة الدقيقة على الكاميرا) أو كائن Pin.

يسجّل الباني ما إذا كان مؤشر LED موصّلاً فعّال-منخفض أو فعّال-مرتفع (باستخدام boardname() للبحث عن اصطلاح المستوى الفعّال للوحة الحالية) بحيث يمرّر المستدعون دائماً مستويات تشغيل/إيقاف منطقية دون القلق بشأن القطبية.

الطرق

on() → None

شغّل مؤشر LED إلى حالة التشغيل.

off() → None

اضبط مؤشر LED على حالة الإيقاف.

toggle() → None

اعكس الحالة الحالية لمؤشر LED.

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

احصل على حالة مؤشر LED أو اضبطها.

بدون وسيطة، تُعيد الحالة المنطقية الحالية (0 = إيقاف، 1 = تشغيل).

مع وسيطة v واحدة، اضبط مؤشر LED على تلك الحالة. يجري المشغّل عملية XOR بين v واصطلاح المستوى الفعّال للوحة بحيث يكون 1 دائماً "تشغيل" بصرف النظر عن القطبية.

boardname() → str

أعد سلسلة اسم اللوحة (البادئة في os.uname().machine قبل " with "). تُستخدم داخلياً لاختيار اصطلاح المستوى الفعّال الصحيح لمؤشر LED.