تعلّم

مقاطعات Arduino مع attachInterrupt()

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

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

المقاطعة تشغّل دالة من دوالك في اللحظة التي يتغير فيها الطرف، مهما كانت loop() تفعل حينها. على Uno فقط الطرفان 2 و3 قادران على ذلك. اكتب attachInterrupt(digitalPinToInterrupt(2), onPress, FALLING); في setup() وستعمل onPress() في كل مرة يهبط فيها الطرف 2 من HIGH إلى LOW. علّم أي متغير تغيّره الدالة بـvolatile.

الدائرة أعلاه عبارة عن زر على الطرف 2 وLED على الطرف 13، والكود يحصي الضغطات بمقاطعة. اضغط «تشغيل» واضغط الزر مرة واحدة. تطبع الشاشة التسلسلية "presses: 2"، وعندما تفلته "presses: 4". المقاطعة سريعة لدرجة أنها تلتقط كل ارتداد لملامسات الزر، عند الضغط وعند الإفلات.

في الأسفل شرح لكيفية عمل attachInterrupt()، والأنماط الأربعة، ولماذا يحتاج العدّاد إلى volatile، وكيف تزيل ارتداد الزر داخل مقاطعة، وما الغرض الحقيقي من المقاطعات: عدّ نبضات أسرع من أن تتابعها بالاستقصاء.

هل تريد النسخة خطوة بخطوة؟ الدرس «Reading a button, and the bounce» يشرح هذا مع نقاط تحقق.

افتح الدرس

attachInterrupt()، قطعة قطعة

تأخذ attachInterrupt() ثلاثة أشياء. رقم المقاطعة، وهو على Uno يساوي 0 للطرف 2 و1 للطرف 3؛ احصل عليه دائمًا بـdigitalPinToInterrupt(pin) بدلًا من كتابة الرقم يدويًا. الدالة التي ستعمل، وتسمى المعالج أو ISR، وهي لا تأخذ شيئًا ولا تعيد شيئًا. والنمط، الذي يحدد أي تغيّر في الطرف نتفاعل معه.

الكود أدناه هو أصغر كود مفيد. يحصي الحواف الهابطة على الطرف 2 ويطبع العدد مرة كل ثانية. مع زر مثالي لا يرتد، ضغطة واحدة طبعت 0 ثم 1. مع زر المحاكي العادي المرتد، الضغطة والإفلات نفسيهما طبعتا 0 ثم 4.

عدّ الحواف الهابطة على الطرف 2
const int BUTTON = 2;

volatile int presses = 0;

void onPress() {
  presses++;
}

void setup() {
  Serial.begin(9600);
  pinMode(BUTTON, INPUT_PULLUP);
  attachInterrupt(digitalPinToInterrupt(BUTTON), onPress, FALLING);
}

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

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

FALLING وRISING وCHANGE وLOW

FALLING يشغّل المعالج عندما ينتقل الطرف من HIGH إلى LOW، وهو بالنسبة لزر على INPUT_PULLUP لحظة الضغط. RISING هو من LOW إلى HIGH، أي الإفلات. CHANGE كلاهما معًا. LOW يشغّله مرارًا وتكرارًا طالما الطرف منخفض.

ضغطة وإفلات واحدة للزر المرتد عُدّت 4 مع FALLING، و4 مع RISING و8 مع CHANGE، لأن كل ارتداد هبوط وصعود. أما LOW فشغّل دالة المعالجة 16042 مرة خلال ضغطة استمرت عُشر ثانية. LOW مخصص للشرائح التي تُبقي خط الإنذار منخفضًا حتى تُجيبها، وليس للأزرار.

لماذا يجب أن يكون المتغير volatile

المترجم لا يعرف أن معالجًا يمكن أن يعمل بين أي سطرين من loop(). في الكود أدناه، تنتظر setup() في حلقة حتى يصبح pressed صحيحًا. بدون volatile، يقرأ المترجم pressed مرة واحدة، ولا يرى شيئًا في الحلقة يغيّره، فيدور للأبد. ضغطنا الزر: طبع "waiting for the button" ولم يطبع شيئًا بعدها أبدًا.

غيّر السطر الأول إلى volatile bool pressed = false; وطبعت الضغطة نفسها "pressed!". volatile يخبر المترجم أن يقرأ المتغير من جديد كل مرة. كل متغير يشاركه المعالج مع بقية الكود يحتاجه.

المتغير الأكبر من بايت واحد، مثل int أو unsigned long، يحتاج خطوة إضافية. ينقل Uno بايتًا واحدًا في كل مرة، فيمكن للمعالج تغييره في منتصف قراءته في loop(). انسخه والمقاطعات متوقفة، كما يفعل عدّاد النبضات في الأسفل: noInterrupts(); copy = count; interrupts();.

علامة بدون volatile
const int BUTTON = 2;

bool pressed = false;  // needs to be volatile

void onPress() {
  pressed = true;
}

void setup() {
  Serial.begin(9600);
  pinMode(BUTTON, INPUT_PULLUP);
  attachInterrupt(digitalPinToInterrupt(BUTTON), onPress, FALLING);
  Serial.println("waiting for the button");
  while (!pressed) {
  }
  Serial.println("pressed!");
}

void loop() {
}

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

إزالة ارتداد زر باستخدام مقاطعة

لا يستطيع المعالج انتظار استقرار الارتداد، لأنه لا يعمل أي شيء آخر أثناء انتظاره. لذا دعه يسجل الوقت، ودع loop() تقرر. المعالج أدناه يسجل فقط أن حافة حدثت ومتى. تنتظر loop() هدوءًا لمدة 50 ms ثم تتحقق مما إذا كان الزر ما يزال مضغوطًا.

ثلاث ضغطات طبعت "press 1" و"press 2" و"press 3" ولا شيء غير ذلك، حتى مع ضبط الزر على أسوأ ارتداد له. العدّاد البسيط أعلاه عدّ 14 لنفس الضغطات الثلاث.

زر مقاطعة، مع إزالة الارتداد
const int BUTTON = 2;
const unsigned long QUIET_MS = 50;

volatile bool edge = false;
volatile unsigned long lastEdge = 0;
int presses = 0;

void onEdge() {
  edge = true;
  lastEdge = millis();
}

void setup() {
  Serial.begin(9600);
  pinMode(BUTTON, INPUT_PULLUP);
  attachInterrupt(digitalPinToInterrupt(BUTTON), onEdge, FALLING);
}

void loop() {
  noInterrupts();
  bool seen = edge;
  unsigned long when = lastEdge;
  interrupts();
  if (seen && millis() - when > QUIET_MS) {
    edge = false;
    if (digitalRead(BUTTON) == LOW) {
      presses++;
      Serial.print("press ");
      Serial.println(presses);
    }
  }
}

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

الغرض من المقاطعات: النبضات السريعة

الزر بطيء بما يكفي لمتابعته بالاستقصاء. المقاطعات تستحق مكانها مع الإشارات الأسرع من أن تُراقب من داخل loop(): حساس تدفق، أو مشفّر دوار، أو مخرج سرعة مروحة. هنا يولّد الطرف 9 إشارة اختبار بتردد 490 Hz باستخدام analogWrite()، موصولة بالطرف 2. التقطت المقاطعة كل حافة: طبعت "490 pulses in the last second"، ثم 490 مجددًا، ثم 491، لأن الحواف تقع على جانبي كل ثانية.

حلقة تفحص الطرف 2 بـdigitalRead() ثم تستدعي delay(5) عدّت 92 نبضة في الثانية من نفس السلك، لأن الطرف صعد وهبط عدة مرات خلال كل delay. المقاطعة لا تعبأ بما تفعله loop().

عدّ إشارة بتردد 490 Hz
volatile unsigned long pulses = 0;

void onPulse() {
  pulses++;
}

void setup() {
  Serial.begin(9600);
  pinMode(9, OUTPUT);
  analogWrite(9, 128);  // a 490 Hz test signal, wired to pin 2
  attachInterrupt(digitalPinToInterrupt(2), onPulse, RISING);
}

void loop() {
  delay(1000);
  noInterrupts();
  unsigned long counted = pulses;
  pulses = 0;
  interrupts();
  Serial.print(counted);
  Serial.println(" pulses in the last second");
}

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

أبقِ المعالج قصيرًا

أثناء تشغيل دالة معالجة المقاطعة، تنتظر بقية المقاطعات، بما فيها مقاطعة المؤقّت التي تحرّك millis(). هذه الدالة تقرأ millis()، وتنتظر 5 ms بمشاهدة micros()، ثم تقرأ millis() مرة أخرى. وقد طَبَعت "millis() before: 299" ثم "millis() 5 ms later: 299": توقّف الزمن تمامًا طوال تلك المدة.

لذا داخل دالة المعالجة، لا تستدعِ delay()، ولا تنتظر شيئًا، وأبقِ Serial.print() خارجها. طباعة سطر واحد قصير تعمل، لكن مع زر يرتدّ طَبَعت الضغطة الواحدة "pressed" أربع مرات. اضبط متغيّرًا منطقيًا أو أضف إلى عدّاد، وأنجز الباقي في loop().

millis() داخل دالة معالجة
volatile unsigned long before = 0;
volatile unsigned long after = 0;
volatile bool done = false;

void onPress() {
  before = millis();
  unsigned long start = micros();
  while (micros() - start < 5000) {
  }
  after = millis();
  done = true;
}

void setup() {
  Serial.begin(9600);
  pinMode(2, INPUT_PULLUP);
  attachInterrupt(digitalPinToInterrupt(2), onPress, FALLING);
  while (!done) {
  }
  Serial.print("millis() before: ");
  Serial.println(before);
  Serial.print("millis() 5 ms later: ");
  Serial.println(after);
}

void loop() {
}

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

أخطاء شائعة

كتابة رقم الطرف كرقم للمقاطعة. الدالة attachInterrupt(2, onPress, FALLING) تطلب المقاطعة رقم 2، وهي غير موجودة في Uno، فلا يحدث شيء: عدّادنا سجّل 0. اكتب digitalPinToInterrupt(2).

استخدام طرف لا يدعم المقاطعات. في Uno يعمل الطرفان 2 و3 فقط؛ digitalPinToInterrupt(4) تعطي -1، وزر على الطرف 4 عدّ 0. أما الطرف 3 فقد عدّ العدد نفسه، وهو 4، الذي عدّه الطرف 2.

حذف volatile. الحلقة التي تنتظر المتغيّر المنطقي لن ترى تغيّره أبدًا.

عدّ نقرات زر بدون معالجة الارتداد. كل ارتداد هو حافة، والضغطة الواحدة قد تُحسب 4.

إنجاز أمور كثيرة جدًا داخل دالة المعالجة. لا delay()، ولا طباعة طويلة، ولا انتظار.

افتح هذه الدائرة في المحرر. Arduino Uno: عدّ نقرات زر باستخدام مقاطعة، موصّلة كما هي في الأعلى من هذه الصفحة. غيّر قطعة أو قيمة واضغط «تشغيل» مرة أخرى.

الأسئلة

ما الأطراف التي تدعم المقاطعات على Arduino Uno؟

الطرفان 2 و3 فقط، وهما المقاطعتان 0 و1. استخدم digitalPinToInterrupt(pin) للحصول على الرقم. أما Mega فلديها ست (2 و3 و18 و19 و20 و21)، ومعظم أطراف ESP32 تدعم واحدة.

لماذا نستخدم volatile مع المقاطعات؟

بدونها قد يُبقي المترجم المتغيّر في مسجّل ولا يقرأ أبدًا القيمة الجديدة التي كتبتها دالة المعالجة. هنا حلقة كانت تنتظر متغيّرًا منطقيًا بدون volatile ولم تنتهِ أبدًا.

هل يمكنني استخدام delay() داخل مقاطعة؟

لا. أثناء تشغيل دالة المعالجة تتأجّل مقاطعة المؤقّت التي تحرّك millis(): بقي millis() ثابتًا 5 ms داخل إحداها هنا. اضبط متغيّرًا منطقيًا في دالة المعالجة وانتظر في loop().

لماذا تحسب مقاطعتي ضغطة الزر الواحدة عدة مرات؟

تلامسات الزر ترتدّ، والمقاطعة سريعة بما يكفي لرؤية كل ارتداد: ضغطة وتحرير واحدة عُدّتا 4 هنا. دع دالة المعالجة تسجّل الوقت وعالج الارتداد في loop().

ما الفرق بين RISING وFALLING وCHANGE؟

FALLING تتفاعل عندما ينتقل الطرف من HIGH إلى LOW، وRISING من LOW إلى HIGH، وCHANGE مع كليهما. لزر على INPUT_PULLUP، الضغطة هي FALLING.

المصادر

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

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

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