تجاوز millis() في Arduino: ماذا يحدث عند الالتفاف، والسطر الوحيد الذي ينجو منه
أو تصفّح كل الدروس.
- 526قطعة على المنضدة
- 46لوحة تعمل الآن
- 1.00xزمن حقيقي، على كل لوحة
millis() يعد المللي ثانية منذ بدء تشغيل اللوحة، في نوع unsigned long. وهو 32 بت على Uno و ESP32 على حد سواء، لذا يرتفع العدد حتى 4294967295 ثم يلتف إلى 0 ويستمر. لا يعيد تشغيل اللوحة، ولا يتوقف، ولا يرمي خطأ. يبدأ ببساطة من الصفر مرة أخرى، وأي كود يقارن الأوقات بطريقة خاطئة ينكسر في تلك اللحظة.
الحل قاعدة واحدة: اطرح دائمًا. اكتب if (millis() - start >= interval)، مع start والنتيجة كنوع unsigned long، فتصبح المقارنة صحيحة قبل الالتفاف وخلاله وبعده. أما مكتوبة كـ if (millis() >= start + interval) فتفشل عند الالتفاف. بقية هذه الصفحة تشرح السبب، باستخدام كود يعمل عبر الالتفاف على Uno محاكاة ويطبع كل قيمة.
الدائرة أعلاه تومض LED بسرعتين من حلقة واحدة دون delay(): الطرف 13 كل 250 ms والطرف 12 كل 400 ms. حلقتها مبنية على ذلك السطر بالضبط، مرة لكل LED.
كم يتبقى حتى يلتف millis()
أكبر قيمة يحملها unsigned long هي 4294967295. أضف واحدًا تحصل على 0: على لوحة Uno المحاكاة، طبع Serial.println(4294967295UL + 1) القيمة 0. وبالمللي ثانية، 4294967296 تساوي 49.71 يومًا، وهي "49.7 يوم" التي تذكرها كل إجابات المنتديات. أي لوحة تعمل سبعة أسابيع ستلتقي بها.
micros() يستخدم نفس نوع 32 بت، لكنه يعد ألف مرة أسرع، لذا يلتف بعد 4294967296 ميكروثانية، أي 71.58 دقيقة. وهذه ليست مجرد مسألة غريبة. أي كود يقيس الأوقات بـ micros() يلتقي بالالتفاف بعد ساعة وقليل من بدئه، وهي مدة تكفي لاجتياز كل اختبار على المنضدة وقصيرة بما يكفي لتفشل في أول ليلة استخدام حقيقي.
الالتفاف، يعمل على لوحة Uno محاكاة
Nobody wants to wait 49.7 days to see a bug, in a simulation or on a desk. So this sketch keeps its own clock: it starts it 296 ms before the wrap, at 4294967000, and steps it forward 100 ms at a time, as millis() would. At each step it asks both questions, "has 1000 ms gone by?" by subtraction and by addition, and prints the answers. The arithmetic is the board’s own: 32-bit unsigned math, run on the simulated ATmega328P.
طبع "t=0 now=4294967000 now-start=0 subtraction: wait, addition: DUE" في سطره الأول. الجمع يقول إن الفترة انتهت بالفعل قبل مرور مللي ثانية واحدة. والسبب أن start + interval يساوي 4294968000، وهي لا تتسع، فالتف إلى 704، وكل قيمة لـ now قبل الالتفاف أكبر من 704.
واصل الطرح العد: 100، 200، 300 مستقيمًا عبر الالتفاف، حيث انتقل now من 4294967200 إلى 4، وأبلغ عن "due" لأول مرة في السطر "t=1000 now=704 now-start=1000 subtraction: DUE, addition: DUE". وهذا بعد 1000 ms بالضبط من البداية. أما الجمع فقال "DUE" حتى الالتفاف و"wait" بعده، صحيحًا بالمصادفة فقط من سطر 1000 ms فصاعدًا. بعيدًا عن الالتفاف يتوافقان، ولهذا تنجح نسخة الجمع في كل اختبار قصير.
void setup() {
Serial.begin(9600);
unsigned long start = 4294967000UL; // 296 ms before the wrap
unsigned long interval = 1000;
for (unsigned long t = 0; t <= 1200; t += 100) {
unsigned long now = start + t; // what millis() would say
Serial.print("t=");
Serial.print(t);
Serial.print(" now=");
Serial.print(now);
Serial.print(" now-start=");
Serial.print(now - start);
Serial.print(now - start >= interval ? " subtraction: DUE" : " subtraction: wait");
Serial.println(now >= start + interval ? ", addition: DUE" : ", addition: wait");
}
}
void loop() {
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
لماذا يكون الطرح صحيحًا دائمًا
Unsigned arithmetic in C and C++ is arithmetic modulo 2 to the 32nd: every result wraps the same way the clock does. When now has wrapped to 704 and start is still 4294967000, the true difference is 1000, and 704 minus 4294967000, wrapped, is 1000. The two wraps cancel. As long as the interval you are measuring is shorter than 49.7 days, now - start is the time that has really gone by.
أما الجمع فلا يحظى بالحظ نفسه. start + interval يلتف وحده، وnow يلتف في لحظة مختلفة، فلمدة من الزمن يكون أحد الطرفين قد التف والآخر لم يلتف بعد، فتجيب المقارنة عن السؤال الخطأ. والمقارنة بموعد نهائي مخزّن، if (millis() > deadline)، هي نفس الخطأ بشكل مختلف.
الطرق الأخرى التي يخطئ بها: النوع الخطأ
عملية الطرح تعمل فقط في unsigned long. خزّن millis() في متغير long بإشارة، وستصبح قيمته سالبة بعد 24.86 يومًا، أي نصف المدى: على لوحة Uno، طبعت (long)4294967000UL القيمة -296. وإن خزّنتها في int على Uno، وهو 16 بت هناك، فسيتعطل الكود بعد 32.767 ثانية: طبعت (int)40000UL القيمة -25536، لذا فالكود الذي يحفظ int start = millis(); يسلك سلوكًا خاطئًا خلال دقيقه الأولى. أما على ESP32 فمتغير int هو 32 بت، وهو ما يخفي الخطأ الثاني لكنه لا يخفي الأول.
استخدم unsigned long لكل متغير يحمل قيمة زمنية، وللفاصل الزمني أيضًا. السطر const unsigned long INTERVAL = 1000; لا يكلف شيئًا ويبقي التعبير كله بالنوع الصحيح.
هل تحتاج أصلًا إلى التعامل مع مشكلة تجاوز المدى؟
ليس إذا كان كل مقارنة عملية طرح في unsigned long. لا حاجة لكشف لحظة الالتفاف، ولا لإعادة ضبط millis() ولا لإعادة تشغيل اللوحة كل بضعة أسابيع؛ فالأكواد التي تفعل ذلك إنما تحاول التغلب على مقارنة كُتبت بطريقة خاطئة. الدالة delay() تقيس انتظارها بهذه الطريقة أصلًا، لذا فاستدعاء delay() الذي يمتد عبر لحظة الالتفاف يعمل بلا مشاكل.
الحد الحقيقي الوحيد هو فاصل زمني أطول من العدّاد نفسه. لا يمكنك قياس 60 يومًا بعملية طرح واحدة من millis(). عدّ شيئًا أبطأ بدلًا من ذلك: أضف واحدًا إلى عدّاد days في كل مرة تمضي فيها 86400000 ms، باستخدام نفس عملية الطرح، أو اقرأ الوقت من وحدة ساعة حقيقية.
افتح هذه الدائرة في المحرر. لوحة Arduino Uno: معدّلان زمنيان، محسوبان بـ millis()، وموصّلة كما تعمل أعلى هذه الصفحة. غيّر قطعة أو قيمة ثم شغّلها مرة أخرى.
الأسئلة
ما القيمة القصوى لـ millis()؟
4294967295، وهي أكبر قيمة لـ unsigned long. وبعدها بمللي ثانية واحدة تصبح 0. على لوحة Uno محاكاة، طبعت 4294967295UL + 1 القيمة 0.
كم يمر من الوقت قبل أن تتجاوز millis() مداها؟
حوالي 49.71 يومًا، أي 4294967296 مللي ثانية. أما micros() فتتجاوز مداها بعد حوالي 71.58 دقيقة.
هل تعيد Arduino تشغيل نفسها عندما تتجاوز millis() مداها؟
لا. تعود القيمة إلى 0 وتستمر في العد، ويواصل الكود عمله. فقط المقارنات المكتوبة على شكل جمع، أو المخزنة في النوع الخطأ، تسوء في تلك اللحظة.
كيف أتجنب مشاكل تجاوز مدى millis()؟
اكتب كل فحص بالصيغة if (millis() - start >= interval)، مع تعريف start و interval بنوع unsigned long. هذا السطر وحده صحيح عبر لحظة الالتفاف، فلا يبقى شيء آخر يتطلب معالجة.
واصل
من أين جاءت الحقائق في هذه الصفحة
ابنِ هذا على أرض الواقع
افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.