آلات الحالات على Arduino، مع لعبة يمكنك أن تلعبها
أو تصفّح كل الدروس.
- 526قطعة على المنضدة
- 46لوحة تعمل الآن
- 1.00xزمن حقيقي، على كل لوحة
عاجلًا أو آجلًا، على كل كود أن ينفّذ الأشياء بالترتيب مع الاستمرار في التفاعل مع العالم: انتظار زر، ثم انتظار وقت عشوائي، ثم إضاءة مصباح، ثم قياس الوقت الذي تستغرقه لتضغط مرة أخرى. إذا كتبت ذلك بـ delay() وجمل if متداخلة، ستحصل على برنامج يصعب متابعته وأصمّ تجاه المدخلات نصف الوقت. آلة الحالات هي الحل القياسي، ولا تحتاج إلى أكثر من enum ومتغيّر واحد.
الدائرة أعلاه هي لعبة ردّ فعل على Uno بزر على الطرف 2 وثلاثة مصابيح. للبرنامج أربع حالات: READY (المصباح الأحمر على الطرف 13 مضاء، انتظار ضغطتك)، ARMED (الكل مطفأ، انتظار وقت عشوائي بين 0.7 و2 ثانية)، RUNNING (المصباح الأصفر على الطرف 12 مضاء، والساعة تعدّ) وDONE (المصباح الأخضر على الطرف 11 يُظهر أن الجولة انتهت). اضغط «تشغيل»، اضغط الزر مرة واحدة، وانتظر الأصفر.
تريد النسخة خطوة بخطوة؟ الدرس «متغيّر واحد يقول أين أنت» يشرح هذا مع نقاط تحقق.
افتح الدرسما تخبرك به الشاشة التسلسلية
يطبع الكود كل تغيير في الحالة، فتصبح الشاشة التسلسلية سجلًّا للآلة. جولة لعبناها طبعت: "state: READY"، ثم "state: ARMED"، ثم "state: RUNNING"، ثم "reaction: 861 ms"، ثم "state: READY". وإذا ضغطت أثناء ARMED تحصل على "too early"، وتمضي مباشرة إلى DONE، ثم تعود إلى READY بعد 1.2 ثانية.
هذا السجل هو أول سبب لكتابة الكود بهذه الطريقة. عندما يحدث خطأ تعرف بالضبط في أي حالة كان البرنامج وما الذي نقله إلى الحالة التالية، بدلًا من التخمين أي من خمس جمل if متداخلة كانت صحيحة.
شكل الكود
سمِّ الحالات بـ enum، واحفظ الحالة الحالية في متغيّر، وأعطِ كل حالة كتلة واحدة تقول ما تفعله وما الذي ينقلها إلى ما بعدها. دالة مساعدة، enter()، تغيّر الحالة وتسجّل الوقت، فيعرف كل حالة كم مضى على نشاطها دون أن تحتفظ بمؤقّت خاص بها.
انظر إلى ما هو غير موجود. لا يوجد delay() في أي مكان. كل تمريرة عبر loop() تقرأ الزر وتفحص الحالة وتعود خلال ميكروثوانٍ، فيُقرأ الزر آلاف المرات في الثانية في كل حالة. أما الانتظار فيتم بمقارنة millis() بوقت دخول الحالة، وهو النمط نفسه الذي تستخدمه صفحة الوميض بلا تأخير مع مصباحي LED.
enum State { READY, ARMED, RUNNING, DONE };
State state = READY;
unsigned long enteredAt = 0;
static void enter(State next) {
state = next;
enteredAt = millis();
}
// in loop(), after reading the button into justPressed:
if (state == READY) {
if (justPressed) {
waitMs = random(700, 2000);
enter(ARMED);
}
} else if (state == ARMED) {
if (justPressed) {
enter(DONE); // too early
} else if (now - enteredAt >= waitMs) {
enter(RUNNING);
}
} else if (state == RUNNING) {
if (justPressed) {
Serial.println(now - enteredAt); // the reaction time
enter(DONE);
}
} else { // DONE
if (now - enteredAt >= 1200) enter(READY);
}أحداث، لا مستويات
تتفاعل الآلة مع justPressed، التي تكون صحيحة لتمريرة واحدة بالضبط عبر loop() عندما ينتقل الزر من مرفوع إلى مضغوط. لو تفاعلت مع «الزر مضغوط» بدلًا من ذلك، لَعُدَّت ضغطة واحدة مستمرة لربع ثانية مئات المرات، ولَمشت الآلة مباشرة عبر READY وARMED إلى بداية زائفة. كشف الحافة، مع معالجة ارتداد مدتها 25 ميلي ثانية حتى لا يُحتسب ارتداد التلامس كضغطات إضافية، هو ما يجعل الضغطة الواحدة حدثًا واحدًا.
هذا أشيع خطأ في آلات الحالات على منضدة حقيقية: انتقال مدفوع بمستوى حيث كان يلزم حدث. إذا بدت حالة كأنها تُتخطى، افحص ما الذي ينقل الآلة إلى ما بعدها.
ارسمها قبل أن تكتبها
قبل كتابة آلة حالات، ارسمها: دائرة واحدة لكل حالة وسهم واحد لكل انتقال، مكتوب عليه الحدث الذي يسببه. في هذه اللعبة: أربع دوائر وخمسة أسهم: من READY إلى ARMED عند ضغطة، ومن ARMED إلى RUNNING عندما ينتهي الانتظار العشوائي، ومن ARMED إلى DONE عند ضغطة (مبكرة جدًا)، ومن RUNNING إلى DONE عند ضغطة، ومن DONE إلى READY بعد 1.2 ثانية. إن لم تستطع رسم سهم لشيء يجب على البرنامج فعله، فالتصميم ينقصه حالة أو حدث، ومن الأرخص بكثير اكتشاف ذلك على الورق.
يصبح الرسم أيضًا قائمة اختباراتك. كل سهم حالة يجب تجربتها مرة. في المحاكي يمكنك قطع الخمسة كلها في أقل من دقيقة: اضغط مرة وانتظر، اضغط مرتين بسرعة، اضغط مرة ثم مرة أخرى عندما يضيء الأصفر. مشاهدة السجل التسلسلي يطبع كل انتقال أثناء فعل ذلك هو الاختبار كاملًا. من الأخطاء التي تظهر بهذه الطريقة نسيان استدعاء enter() (فيصبح enteredAt قديمًا وتنتهي الحالة المؤقّتة فورًا) ووجود حالة بلا مخرج.
قارنها بكود يحجب التنفيذ
مثال إشارة المرور في المعرض يشغّل معبر المشاة بالطريقة الأخرى: تسلسل مباشر للأضواء مع delay() بينها. وهو يعمل، لكن فقط لأن زر الطلب على مقاطعة؛ بدونه كانت الضغطة أثناء delay() ستضيع. افتحه بالزر أدناه واقرأ الكودين جنبًا إلى جنب.
إعادة كتابة المعبر كآلة حالات (GREEN وAMBER وWALK وFLASHING) تلغي الحاجة إلى المقاطعة، وإضافة قاعدة جديدة، مثل «أبقِ الأخضر مضيئًا ثلاث ثوانٍ على الأقل»، تصبح شرطًا إضافيًا واحدًا في كتلة واحدة بدلًا من إعادة هيكلة الحلقة كلها.
افتح هذه الدائرة في المحرر. Arduino Uno: لعبة ردّ فعل بأربع حالات، موصّلة كما تعمل أعلى هذه الصفحة. غيّر قطعة أو قيمة وشغّلها مرة أخرى.
الأسئلة
هل أستخدم switch أم if وelse if؟
كلاهما يعمل. switch على متغيّر الحالة شائعة وتجعل المترجم يحذّرك من قيمة enum نسيت التعامل معها، ما دمت تتذكّر وضع break في نهاية كل حالة. المثال يستخدم if وelse if لأنها تُقرأ بوضوح في كود قصير.
كيف أضيف حالة جديدة؟
أضف اسمًا إلى الـ enum، وأضف كتلة له، وأضف الانتقالات إليه ومنه. لا شيء آخر في البرنامج يحتاج إلى تغيير، وهذه هي فكرة هذا النمط.
هل يمكن لآلة حالات أن تعمل جنبًا إلى جنب مع كود آخر؟
نعم، ما دام لا شيء داخل loop() يعمل بشكل مانع. يمكن أن تعمل عدة آلات جنبًا إلى جنب، كل واحدة بمتغير حالتها الخاص، لأن كل واحدة لا تنجز سوى قدر قليل من العمل في كل دورة.
أين أنفّذ شيئًا ما مرة واحدة عند بدء حالة؟
في الانتقال، قبل استدعاء enter() أو بعده مباشرة. المثال يختار مدة الانتظار العشوائية لحظة الدخول إلى ARMED، فتُختار المدة مرة واحدة في كل جولة بدلًا من كل دورة.
واصل
ابنِ هذا على أرض الواقع
افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.