مؤقت المراقبة في Arduino، على Uno مع زر يعلّقه
مبتدئ
أو تصفّح كل الدروس.
- 526قطعة على المنضدة
- 46لوحة تعمل الآن
- 1.00xزمن حقيقي، على كل لوحة
مؤقت المراقبة مؤقت مستقل داخل الشريحة يعيد تشغيل اللوحة ما لم يقل الكود "ما زلت حيًّا" في الوقت المناسب. فعّله بـ wdt_enable(WDTO_2S) من <avr/wdt.h> واستدعِ wdt_reset() في loop(). ما دام loop() يعود دورة بعد دورة، لا يحدث شيء. أما إذا علق الكود، في حلقة لا تنتهي أو انتظار حساس لا يجيب أبدًا، فتمر ثانيتان دون إعادة ضبط فيعيد مؤقت المراقبة تشغيله من البداية.
الدائرة أعلاه زر على الطرف 2 و LED على Uno. الصق الكود الأول أدناه فيها واضغط «تشغيل». تطبع الشاشة التسلسلية "started". اضغط الزر فيطبع الكود "stuck!" ويعلق في while (true)، وبعد نحو ثانيتين يطبع "started" من جديد: مؤقت المراقبة أعاد التشغيل.
أدناه ذلك الكود، وما يظهره سبب إعادة التشغيل على Uno، والمُهَل، ولماذا لا يعلق البدء البطيء هنا، ومؤقت المراقبة كمقاطعة بطيئة، كلٌّ منها مشغّل على Uno مع ما طبعه.
كود يعيد تشغيل نفسه
Here is the sketch. setup() turns the watchdog on last, after everything slow is done. loop() pats it first thing every time around. The button stands in for a real hang, a sensor read that waits forever, say: it prints "stuck!" and goes into a loop with no way out, and no more pats. It printed "started", "stuck!" and then "started" again.
إعادة التشغيل هذه إعادة ضبط حقيقية: كل متغير يبدأ من جديد من قيمته الأولى و setup() يعمل مجددًا. مؤقت المراقبة لا يصلح الخطأ الذي علّق الكود. إنه يعيد جهازًا يعمل وحده إلى العمل، وينبغي أن يسجّل الكود إعادة التشغيل أو يعدّها ليمكن العثور على الخطأ.
#include <avr/wdt.h>
void setup() {
Serial.begin(9600);
pinMode(2, INPUT_PULLUP);
Serial.println("started");
wdt_enable(WDTO_2S);
}
void loop() {
wdt_reset();
if (digitalRead(2) == LOW) {
Serial.println("stuck!");
while (true) {
}
}
delay(100);
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
المُهَل
يَعُدّ مؤقت المراقبة على مذبذبه الخاص بتردد 128 kHz، لا على البلورة بتردد 16 MHz، لذا فأوقاته تقريبية ولا تتغير مع تغيّر الساعة. الخيارات هي WDTO_15MS و WDTO_30MS و WDTO_60MS و WDTO_120MS و WDTO_250MS و WDTO_500MS و WDTO_1S و WDTO_2S و WDTO_4S و WDTO_8S؛ و 8 ثوانٍ هي الأطول. اختر واحدة أطول بشكل مريح من أبطأ دورة عادية عبر loop().
A long delay counts as a hang. With a 2 second watchdog, delay(3000) in loop() reset the board before the wait was over: in 7 seconds it printed "started" four times and "done waiting" never. Break long waits into short ones with a wdt_reset() in between, or better, time them with millis().
هل كان ذلك مؤقت المراقبة؟
تحفظ الشريحة سبب آخر إعادة تشغيل في MCUSR، وتُضبط بتة WDRF بعد إعادة تشغيل بواسطة مؤقت المراقبة. الكود أدناه يقرأها أول شيء في setup()، ثم يمسحها، ثم يطبعها. طبع "reset cause: 1" عند التشغيل، وهي إشارة التشغيل، وبعد أن علّقه الزر طبع "reset cause: 0".
التشغيل الثاني يُظهر القيمة 0، وليس 8 كما يفعل مؤقت المراقبة. عند لوحة Uno، إعادة تعيين مؤقت المراقبة لا تظهر: محمّل الإقلاع Optiboot يقرأ السجل MCUSR ويمسحه، ويطفئ مؤقت المراقبة، قبل أن يبدأ الكود الخاص بك، لذلك تجد setup() أن بت WDRF ممسوحًا بالفعل. لوحة Uno في Mokxi تفعل الشيء نفسه. لمعرفة أن مؤقت المراقبة قد أُطلق، احتفظ بعدّادك الخاص، في ذاكرة EEPROM مثلًا، وأضف واحدًا في setup().
#include <avr/wdt.h>
void setup() {
byte cause = MCUSR;
MCUSR = 0;
wdt_disable();
Serial.begin(9600);
pinMode(2, INPUT_PULLUP);
Serial.print("reset cause: ");
Serial.println(cause, HEX);
wdt_enable(WDTO_1S);
}
void loop() {
wdt_reset();
if (digitalRead(2) == LOW) {
while (true) {
}
}
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
حلقة إعادة التعيين اللانهائية
على شريحة مجردة، بعد إعادة تعيين مؤقت المراقبة، وبينما بت WDRF مضبوط، يبقى مؤقت المراقبة يعمل بأقصر مدة له، نحو 16 ميلي ثانية. الكود الذي يبدأ ببطء لا يحصل أبدًا على فرصة ضبط مهلته الخاصة، فتُعاد تهيئة اللوحة كل بضعة ميلي ثانية. على لوحة Uno لا توجد مثل هذه الحلقة: Optiboot يطفئ مؤقت المراقبة قبل بدء الكود. مع delay(100) في setup() قبل wdt_enable(WDTO_1S)، ضغطة واحدة على الزر أعادت تهيئة اللوحة مرة واحدة، وطبع "started" مرتين في المجموع.
محمّل الإقلاع الأقدم على كثير من لوحات Nano لا يطفئ مؤقت المراقبة، وقد تجعل إعادة تعيين مؤقت المراقبة لوحة كهذه عالقة في إعادة التشغيل حتى تُفصل عن الطاقة أو تُثبَّت عليها نسخة أحدث من محمّل الإقلاع. الحل هو الأسطر الثلاثة الأولى من الكود أعلاه: اقرأ MCUSR، امسحه، ثم wdt_disable()، قبل أي شيء آخر.
مؤقت المراقبة كمقاطعة بطيئة
اضبط بت WDIE بدلًا من WDE، فيستدعي مؤقت المراقبة ISR(WDT_vect) بدلًا من إعادة التعيين. الكود أدناه يطلب ثانية واحدة؛ اشتغلت الدالة عند 1024 و2048 و3072 و4096 ميلي ثانية، ثانية واحدة بحسب مذبذب مؤقت المراقبة نفسه. تغيير WDTCSR يتطلب كتابتين متتاليتين، الأولى تضبط WDCE وWDE، كما يطلب ورق البيانات. هذا هو المؤقّت الذي يوقظ كودًا يعمل بالبطارية من السكون، لأنه يستمر في العمل عندما يتوقف كل شيء آخر.
#include <avr/wdt.h>
volatile int barks = 0;
ISR(WDT_vect) {
barks++;
}
void setup() {
Serial.begin(9600);
noInterrupts();
wdt_reset();
WDTCSR = (1 << WDCE) | (1 << WDE);
WDTCSR = (1 << WDIE) | (1 << WDP2) | (1 << WDP1);
interrupts();
}
void loop() {
static int shown = 0;
if (barks != shown) {
shown = barks;
Serial.print("bark ");
Serial.print(shown);
Serial.print(" at ");
Serial.println(millis());
}
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
افتح هذه الدائرة في المحرر. لوحة Arduino Uno: زر على الطرف 2، جاهز لتعليق الكود، موصّل كما يعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة وشغّلها مرة أخرى.
افتح الدائرةالأسئلة
ما هو مؤقّت المراقبة في Arduino؟
مؤقّت منفصل في الشريحة يعيد تهيئة اللوحة ما لم يستدعِ الكود wdt_reset() قبل انتهاء مهلته. إنه يعيد تشغيل كود متوقف عن الاستجابة دون أن يضغط أحد زر إعادة التعيين.
كيف أستخدم مؤقّت المراقبة على لوحة Arduino Uno؟
ضمّن <avr/wdt.h>، واستدعِ wdt_enable(WDTO_2S) في نهاية setup()، واستدعِ wdt_reset() مرة واحدة في كل دورة من loop(). اختر مهلة أطول من أبطأ دورة عادية لـ loop().
لماذا تستمر لوحة Arduino في إعادة التعيين مع مؤقّت المراقبة؟
شيء ما في loop() يستغرق وقتًا أطول من المهلة، غالبًا delay() طويلة، أو، على لوحة ذات محمّل إقلاع أقدم، يبدأ الكود ببطء شديد بعد إعادة تعيين مؤقت المراقبة، عندما تحتفظ الشريحة بمهلة 16 ميلي ثانية حتى يُمسح MCUSR. امسح MCUSR واستدعِ wdt_disable() أول شيء في setup().
ما هي أطول مهلة لمؤقّت المراقبة؟
نحو 8 ثوانٍ، وهي WDTO_8S. لمهلة أطول، استخدم مقاطعة مؤقت المراقبة وعُدّ عدة مقاطعات منها قبل أن تقرر أن الكود عالق.
هل يعمل مؤقّت المراقبة على لوحة Nano؟
الشريحة نفسها، لذا الكود نفسه. لوحات Nano الأقدم تحمل محمّل إقلاع لا يطفئ مؤقت المراقبة بعد إطلاقه، ما قد يُبقي اللوحة تعيد التهيئة حتى يُحرق عليها محمّل إقلاع جديد.
واصل
من أين جاءت الحقائق في هذه الصفحة
ابنِ هذا على أرض الواقع
افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.