برج الإشارة

مقدمة

برج الإشارة هو جهاز يستخدم أضواء ملونة لإظهار حالة الروبوت.

بالنسبة للأمثلة أدناه، سيتم تسمية برج الإشارة المُكوّن signal_tower وسيتم استخدامه في جميع الأمثلة اللاحقة في جميع أنحاء وثائق واجهة برمجة التطبيقات هذه عند الإشارة إلى SignalTower.

فيما يلي قائمة بجميع الطرق المتاحة:

المُهيئون – ضبط ألوان وأنماط إضاءة برج الإشارة.

• set_color – يحدد النمط لواحد أو جميع مصابيح LED الخاصة ببرج الإشارة.

• set_colors – يحدد حالة كل مصباح LED في برج الإشارة.

المنشئون – تهيئة وتكوين برج الإشارة يدويًا.

• SignalTower – إنشاء برج إشارة.

المعدون

set_color

يُحدد الأمر set_color نمط إضاءة واحد أو جميع مصابيح LED الموجودة على برج الإشارة. يمكن استخدام هذه المصابيح لتتبع موقع الروبوت في المشروع أو للإشارة إلى استيفاء شروط معينة.

Usage:
signal_tower.set_color(value, state)

المعلمة	وصف
قيمة	لون الضوء المراد التحكم به: SignalTower.RED SignalTower.GREEN SignalTower.BLUE SignalTower.YELLOW SignalTower.WHITE SignalTower.ALL — تطبيق الإجراء على جميع الألوان.
ولاية	نمط الإضاءة المطلوب تطبيقه: SignalTower.ON SignalTower.OFF SignalTower.BLINK — تومض الأضواء.

# Set the Signal Tower to start blinking the blue LED
signal_tower.set_color(SignalTower.BLUE, SignalTower.BLINK)

set_colors

يُحدد الأمر set_colors حالة كل مصباح LED في برج الإشارة. يمكن استخدام هذه المصابيح لتتبع موقع الروبوت في المشروع أو للإشارة إلى استيفاء شروط معينة.

Usage:
signal_tower.set_colors(r, y, g, b, w)

المعلمة	وصف
ر	حالة الضوء الأحمر: SignalTower.ON SignalTower.OFF SignalTower.BLINK — تومض الأضواء.
y	حالة الضوء الأصفر: SignalTower.ON SignalTower.OFF SignalTower.BLINK — تومض الأضواء.
ز	حالة الضوء الأخضر: SignalTower.ON SignalTower.OFF SignalTower.BLINK — تومض الأضواء.
ب	حالة الضوء الأزرق: SignalTower.ON SignalTower.OFF SignalTower.BLINK — تومض الأضواء.
w	حالة الضوء الأبيض: SignalTower.ON SignalTower.OFF SignalTower.BLINK — تومض الأضواء.

# Turn on all LEDs
signal_tower.set_colors(SignalTower.ON, SignalTower.ON, SignalTower.ON, SignalTower.ON, SignalTower.ON)

# Turn on just the red LED
signal_tower.set_colors(SignalTower.ON, SignalTower.OFF, SignalTower.OFF, SignalTower.OFF, SignalTower.OFF)

المُنشئون

SignalTower

SignalTower يُنشئ برج إشارة.

SignalTower(smartport)

المعلمة	وصف
smartport	المنفذ الذكي الذي يتصل به برج الإشارة، مكتوبًا على النحو التالي: Ports.PORTx حيث x هو رقم المنفذ.

# Construct a Signal Tower "signal_tower" with the
# SignalTower class
signal_tower = SignalTower(Ports.PORT1)