تعلّم

Arduino millis(): مؤقتات، وعدة أشياء في وقت واحد

أو تصفّح كل الدروس.

  • 526قطعة على المنضدة
  • 46لوحة تعمل الآن
  • 1.00xزمن حقيقي، على كل لوحة
Arduino Uno: ثلاثة مصابيح بثلاث سرعات، بدون delay()مباشر0.000 s 0.00x
اضغط «تشغيل» وراقب المصابيح الثلاثة
ثلاثة مؤقتات في حلقة واحدة، تتم مقارنة كل منها بـ millis() في كل دورة.

تُعيد millis() عدد المللي ثانية المنقضية منذ تشغيل اللوحة، كقيمة unsigned long. وهي لا تنتظر شيئًا. لتنفيذ شيء كل ثانية، تذكّر آخر مرة فعلته فيها، وفي كل دورة من loop() اسأل هل مضت ثانية: if (millis() - previous >= 1000). هذا السطر الواحد هو كيف تنفّذ Arduino عدة أشياء في وقت واحد.

الدائرة أعلاه هي منضدة الكود بثلاثة مصابيح. اضغط «تشغيل». يتبدل المصباح الأحمر كل 200 ms، والأصفر كل 330 ms والأخضر كل 1100 ms، كلها من loop() واحدة دون delay(). تطبع الشاشة التسلسلية "worst pass through loop: 2 ms" كل ثانيتين: ما من دورة لـ loop() استغرقت أطول من ذلك، لذا كل مصباح في موعده.

فيما يلي ما تعيده millis()، ونمط المؤقت، وكود يشغّل ثلاث مهام في وقت واحد، ومقارنة millis() مع delay()، والأخطاء التي تجعل المؤقت ينحرف أو يتوقف أو يصبح سالبًا، كلها منفّذة على Uno.

تريد النسخة خطوة بخطوة؟ الدرس "اسأل عن الوقت، لا تنتظره" يشرح هذا مع نقاط تحقق.

افتح الدرس

ما تعيده millis()

عدّاد بالمللي ثانية منذ التشغيل أو إعادة الضبط، يبدأ من 0. هذا الكود يطبعه مرة كل ثانية وقد طبع 0 و999 و1999 و3000 و3999. العدّاد 0 في بداية setup() لأن اللوحة تبدأ من الصفر في كل مرة.

إنه unsigned long بحجم 32 بت، لذلك يعدّ حتى 4294967295 ثم يعود إلى 0، بعد نحو 49.7 يومًا. صفحة تجاوز millis() تشرح لماذا تنجو عملية الطرح في نمط المؤقت من هذا الالتفاف.

اطبع millis()
void setup() {
  Serial.begin(9600);
}

void loop() {
  Serial.println(millis());
  delay(1000);
}

افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.

مؤقت بـ millis()

هذا هو النمط. يحفظ previous آخر مرة أطلق فيها المؤقت. في كل دورة، يسأل now - previous >= INTERVAL هل مضت الفترة، فإن كان الجواب نعم ينفّذ الكود مهمته ويقدّم previous. أما delay(7) فيمثّل بقية الكود الحقيقي، الذي يستهلك وقتًا أيضًا.

طبع "tick at 1003" و"tick at 2001" و"tick at 3006" و"tick at 4003" و"tick at 5001". قد يتأخر كل تكت بضعة مللي ثانية، لأن الحلقة تنظر كل 7 ms فقط، لكن التأخر لا يتراكم: التكت الخامس لا يزال عند 5001.

مؤقت كل ثانية
const unsigned long INTERVAL = 1000;
unsigned long previous = 0;

void setup() {
  Serial.begin(9600);
}

void loop() {
  unsigned long now = millis();
  if (now - previous >= INTERVAL) {
    previous += INTERVAL;
    Serial.print("tick at ");
    Serial.println(now);
  }
  delay(7);  // stands in for the rest of a busy loop
}

افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.

عدة مهام في وقت واحد

لكل مهمة مؤقّت خاص بها، وloop() يفحصها جميعًا في كل دورة. هذا الكود يجعل الطرف 13 يومض كل 250 ms، ويبدّل حالة مصباح على الطرف 12 عند كل ضغطة زر، ويطبع تقريرًا كل ثانية، وكل ذلك في الوقت نفسه.

ضغطنا الزر ثلاث مرات، كل ضغطة سريعة مدتها 150 ms. طبع "1 s, presses: 1" و"2 s, presses: 3" و"3 s, presses: 3"، وتغيّر المصباح على الطرف 12 عند كل ضغطة، ولم يتوقف الرمش على الطرف 13 ولا للحظة. أضِف مهمة رابعة بالطريقة نفسها: مؤقّت آخر، وif أخرى.

ثلاث مهام، حلقة واحدة
const int BLINK_LED = 13;
const int LAMP = 12;
const int BUTTON = 2;

unsigned long lastBlink = 0;
unsigned long lastChange = 0;
unsigned long lastReport = 0;
int lastReading = HIGH;
bool blinkOn = false;
bool lampOn = false;
int presses = 0;

void setup() {
  Serial.begin(9600);
  pinMode(BLINK_LED, OUTPUT);
  pinMode(LAMP, OUTPUT);
  pinMode(BUTTON, INPUT_PULLUP);
}

void loop() {
  unsigned long now = millis();

  // Task 1: blink pin 13 every 250 ms.
  if (now - lastBlink >= 250) {
    lastBlink = now;
    blinkOn = !blinkOn;
    digitalWrite(BLINK_LED, blinkOn ? HIGH : LOW);
  }

  // Task 2: each press flips the lamp on pin 12.
  int reading = digitalRead(BUTTON);
  if (reading != lastReading && now - lastChange > 50) {
    lastChange = now;
    lastReading = reading;
    if (reading == LOW) {
      presses++;
      lampOn = !lampOn;
      digitalWrite(LAMP, lampOn ? HIGH : LOW);
    }
  }

  // Task 3: report once a second.
  if (now - lastReport >= 1000) {
    lastReport = now;
    Serial.print(now / 1000);
    Serial.print(" s, presses: ");
    Serial.println(presses);
  }
}

افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.

millis() مقابل delay()

هذا هو الوميض والزر نفسهما مكتوبين بـ delay(). يقضي الكود كل وقته داخل delay()، لذا لا يقرأ الزر إلا للحظة واحدة كل ثانية. الضغطات الثلاث نفسها البالغة 150 ms طُبعت "pressed" مرة واحدة. اثنتان من الثلاث مرّتا أثناء انتظار الكود.

delay() مناسب عندما يكون على اللوحة شيء واحد تفعله. وبمجرد أن يصبح لديها شيئان، انتقل إلى millis().

الشيء نفسه، مع delay()
const int BUTTON = 2;

void setup() {
  Serial.begin(9600);
  pinMode(13, OUTPUT);
  pinMode(BUTTON, INPUT_PULLUP);
}

void loop() {
  digitalWrite(13, HIGH);
  delay(500);
  digitalWrite(13, LOW);
  delay(500);
  if (digitalRead(BUTTON) == LOW) {
    Serial.println("pressed");
  }
}

افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.

لماذا تقفز millis() بمقدار 2 أحيانًا

المؤقّت الكامن خلف millis() ينبض كل 1024 µs، لا كل 1000. لذا تتأخر millis() بـ 24 µs في كل نبضة، وكل 41 أو 42 نبضة تعوّض ذلك بإضافة 2 دفعة واحدة. هذا الكود يرصد ذلك في أول 200 ms وقد طبع "41 -> 43" و"84 -> 86" و"126 -> 128" و"169 -> 171". ولوحة Uno حقيقية تفعل الشيء نفسه تمامًا.

لهذا السبب تستطيع منضدة الكود أعلاه أن تُبلغ عن أسوأ دورة بمقدار 2 ms: الدورة التي تصادف قفزة ترى الساعة تتقدم بمقدار 2. ولهذا السبب أيضًا يجب أن يختبر المؤقّت >= ولا يجوز أبدًا ==. فاختبار القيمة 42 بالضبط لن يكون صحيحًا أبدًا.

ارصد قفزة millis()
void setup() {
  Serial.begin(9600);
  unsigned long last = millis();
  while (millis() < 200) {
    unsigned long now = millis();
    if (now - last > 1) {
      Serial.print(last);
      Serial.print(" -> ");
      Serial.println(now);
    }
    last = now;
  }
}

void loop() {
}

افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.

أخطاء شائعة

تخزين millis() في متغير int. فمتغير int على Uno يصل فقط إلى 32767. الكود أدناه طبع 0، 7999، 16000، 23999، 32000، ثم -25536 عند 40 ثانية، وأي مؤقّت مبني عليه ينهار. استخدم unsigned long.

كتابة previous = now بدلًا من previous += INTERVAL. كل نبضة تتأخر قليلًا، ومع = now تتراكم التأخيرات: المؤقّت نفسه طبع 1003، 2009، 3013، 4018 و5022. استخدم += عندما يجب أن تبقى النبضات على الإيقاع، و= now فقط عندما ينبغي لنبضة متأخرة أن تدفع التالية إلى الوراء.

اختبار millis() == target. قد تتخطى millis() قيمة، فقد لا يكون الاختبار صحيحًا أبدًا. اختبر >= على الفرق.

الجمع بدلًا من الطرح. if (millis() >= previous + INTERVAL) يفشل عندما تلتف millis()؛ أما millis() - previous >= INTERVAL فلا.

delay() مخفي في مكان ما. delay() واحد في أي مهمة يعطّل بقية المهام جميعًا.

millis() في متغير int
void setup() {
  Serial.begin(9600);
}

void loop() {
  int now = millis();  // should be unsigned long
  Serial.println(now);
  delay(8000);
}

افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.

افتح هذه الدائرة في المحرر. Arduino Uno: ثلاثة مصابيح بثلاث سرعات، بلا delay()، موصّلة كما تعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة وشغّلها مرة أخرى.

الأسئلة

ماذا تفعل millis() في Arduino؟

تُعيد عدد المللي ثانية منذ تشغيل اللوحة، كقيمة unsigned long. وهي لا توقف أي شيء، لذا فهي طريقة الكود في حساب الوقت وهو يقوم بأعمال أخرى.

كيف أشغّل عدة مهام مع millis()؟

أعطِ كل مهمة متغير unsigned long خاصًا بها لآخر مرة عملت فيها، وفي loop() افحص كل واحدة بـ if (millis() - last >= interval). وأبقِ delay() خارج الحلقة.

ما الفرق بين millis() و delay()؟

delay() يوقف الكود حتى ينتهي الوقت. أما millis() فتُبلغ عن الوقت فقط وتدع الكود يكمل. مع delay()، التُقطت واحدة فقط من ثلاث ضغطات زر سريعة هنا؛ ومع millis()، التُقطت الثلاث جميعًا.

لماذا يصبح مؤقّت millis() سالبًا؟

إنه مخزّن في متغير int، وينقلب إلى قيمة سالبة بعد 32767 ms: هنا يصبح -25536 عند 40 ثانية. استخدم unsigned long مع millis() ومع كل وقت يُحسب منه.

المصادر

من أين جاءت الحقائق في هذه الصفحة

ابنِ هذا على أرض الواقع

افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.