مقاطعات ESP32 مع attachInterrupt
أو تصفّح كل الدروس.
- 526قطعة على المنضدة
- 46لوحة تعمل الآن
- 1.00xزمن حقيقي، على كل لوحة
An interrupt lets an ESP32 notice a pin change the moment it happens, whatever loop() is busy with. You write a short function, mark it IRAM_ATTR, and hand it to attachInterrupt() with the pin and the edge to watch. Every GPIO on an ESP32 can trigger one. The two things that go wrong are the button, which bounces, and the variable the handler shares with loop(), which has to be volatile.
الدائرة أعلاه عبارة عن لوحة ESP32 DevKit مع زر يوصّل GPIO 15 بالأرضي. في الأسفل، عدّاد على هذا الطرف ضُغط ثلاث مرات، مع ارتداد الزر معطّلًا، ثم عند الإعداد المعتاد، ثم في أسوأ حالاته، وأخيرًا إزالة الارتداد التي أعادت القراءات الثلاث جميعها إلى 3.
attachInterrupt و IRAM_ATTR و volatile
pinMode(15, INPUT_PULLUP) يُبقي الطرف مرتفعًا حتى يسحبه الزر إلى المستوى المنخفض، وattachInterrupt(digitalPinToInterrupt(15), onPress, FALLING) يشغّل onPress() عند كل انتقال من المرتفع إلى المنخفض. المعالج لا يزيد إلا واحدًا على العدّاد، بينما loop() يتولى الطباعة. على ESP32، digitalPinToInterrupt(15) هو ببساطة 15، لكن كتابته بهذه الصورة تحافظ على إمكانية تشغيل الكود على Uno.
IRAM_ATTR يضع المعالج في ذاكرة RAM الداخلية. على لوحة ESP32 حقيقية تعمل معظم الأكواد من ذاكرة flash عبر ذاكرة تخزين مؤقت، وتُعطّل هذه الذاكرة أثناء الكتابة إلى flash، كما يفعل Preferences أو WiFi. معالج تُرك في flash واشتغل في تلك اللحظة يُسقط اللوحة. في Mokxi تعمل كل الأكواد من RAM أصلًا، لذا لا يغيّر هذا المؤشر شيئًا هنا، لكن اكتبه في كل مرة.
volatile يخبر المترجم بأن المتغير قد يتغيّر من دون علمه. حلقة تنتظر بـwhile (presses == 0) { } على متغير int عادي لم تنتهِ أبدًا هنا رغم ثلاث ضغطات: المترجم قرأ المتغير مرة واحدة واحتفظ بالنسخة. مع volatile int presses طبعت الحلقة نفسها "pressed" عند الضغطة الأولى.
volatile int presses = 0;
void IRAM_ATTR onPress() {
presses++;
}
void setup() {
Serial.begin(115200);
pinMode(15, INPUT_PULLUP);
attachInterrupt(digitalPinToInterrupt(15), onPress, FALLING);
}
void loop() {
static int shown = 0;
if (presses != shown) {
shown = presses;
Serial.print("presses: ");
Serial.println(shown);
}
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
لماذا تُحسب الضغطة الواحدة أكثر من مرة
الزر الضاغط لا يغلق مرة واحدة. تلامساته ترتد لبضع أجزاء من الألف من الثانية عند التلامس وعند الانفصال أيضًا، والمقاطعة سريعة بما يكفي لالتقاط كل ارتداد. الزر في Mokxi يرتد كما يفعل زر حقيقي، مع إعداد يحدد شدة الارتداد. عند الضغط ثلاث مرات، عدّد الكود أعلاه 3 مع تعطيل الارتداد، و14 عند الإعداد المعتاد، و46 في أسوأ الحالات.
The usual fix in tutorials is a time check: ignore a FALLING edge within 50 milliseconds of the last one counted. It counted 6 for 3 presses, at both settings. The press is counted once, but the release bounces too, and some of its edges fall. They come 200 milliseconds after the press, long after the 50 are up.
إزالة ارتداد تحسب واحدة لكل ضغطة
The handler below watches both edges with CHANGE and reads the pin each time. When it reads HIGH it notes the time; when it reads LOW it counts a press only if the pin had been high for more than 30 milliseconds. A bounce during the press or the release never stays high that long, and a real press always follows a long high. It counted 3 for 3 presses with bounce off, typical and worst.
أبقِ المعالج قصيرًا هكذا. لا Serial.print() ولا delay() ولا أي شيء ينتظر: على لوحة ESP32 حقيقية، المعالج الذي يعمل طويلًا يفعّل حارس المقاطعات فيُعاد تشغيل اللوحة. عيّن علمًا أو عدّادًا، ودع loop() يقوم بالجزء البطيء. detachInterrupt(15) يوقف مراقبة الطرف؛ الكود الذي استدعاه مرة واحدة عند وصول العداد إلى 2 بقي عند 2 خلال الضغطة الثالثة.
volatile int presses = 0;
volatile unsigned long highSince = 0;
void IRAM_ATTR onEdge() {
unsigned long now = millis();
if (digitalRead(15) == HIGH) {
highSince = now;
} else if (now - highSince > 30) {
presses++;
}
}
void setup() {
Serial.begin(115200);
pinMode(15, INPUT_PULLUP);
attachInterrupt(digitalPinToInterrupt(15), onEdge, CHANGE);
}
void loop() {
static int shown = 0;
if (presses != shown) {
shown = presses;
Serial.print("presses: ");
Serial.println(shown);
}
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
أطراف المقاطعات في ESP32، والأطراف التي تحتاج مقاومة
كل أطراف GPIO يمكن أن تعمل مقاطعات، لكن الطرف الذي لا شيء يمسك به مرتفعًا أو منخفضًا يطفو، والطرف الطافي يُحدث مقاطعات بسبب التشويش. مع pinMode(15, INPUT) بدلًا من INPUT_PULLUP والزر غير مضغوط، قرأ الطرف 0 ووصل العداد إلى 141 في ثانيتين، بينها ثلاث ضغطات حقيقية.
GPIO 34 إلى 39 للإدخال فقط وليس فيها مقاومة سحب داخلية إطلاقًا، لذا INPUT_PULLUP عليها لا يفعل شيئًا. الزر نفسه على GPIO 34 مع INPUT_PULLUP عدّ 142. مع مقاومة 10 k من GPIO 34 إلى 3.3 V قرأ الطرف 1 في حالة السكون وعدّ الضغطات الثلاث، 3. استخدم تلك الأطراف للمقاطعات فقط مع مقاومة، أو مع حساس يقود مخرجه في الاتجاهين.
For several buttons with one handler, attachInterruptArg(pin, handler, &data, FALLING) passes a pointer to the handler; with a struct for the button it counted 3 for 3 presses. Avoid GPIO 6 to 11, which are the flash, and the strapping pins 0, 2, 5, 12 and 15 for anything held low at power on. GPIO 15 is fine for a button that is open at boot.
افتح هذه الدائرة في المحرر. ESP32 DevKit: زر على GPIO 15، موصّل كما يعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة وشغّلها مرة أخرى.
الأسئلة
ما أطراف ESP32 التي يمكن استخدامها للمقاطعات؟
كل أطراف GPIO. أطراف GPIO 34 إلى 39 بلا مقاومة سحب داخلية، لذا تحتاج مقاومة أو حساسًا يقود الطرف، وأطراف GPIO 6 إلى 11 هي ذاكرة الفلاش.
لماذا لا يعمل attachInterrupt على ESP32 الخاص بي؟
غالبًا ما يكون السبب أن الطرف عائم (لا يوجد INPUT_PULLUP أو مقاومة)، أو أن المتغير المشترك غير معرّف كـ volatile، أو أن الطرف من 34 إلى 39 بدون مقاومة رفع، أو أن المعالج يطبع أو يستخدم تأخيرًا.
ماذا تفعل IRAM_ATTR على ESP32؟
تضع المعالج في ذاكرة RAM الداخلية، حتى يعمل أثناء إيقاف ذاكرة التخزين المؤقت للفلاش عند الكتابة في الفلاش. بدونها، إذا انطلق المعالج في تلك اللحظة تعطّلت اللوحة.
كيف أزيل ارتداد الزر في مقاطعة على ESP32؟
راقب CHANGE، وسجّل اللحظة التي يرتفع فيها الطرف، واحتسب القيمة المنخفضة فقط بعد بقائه مرتفعًا نحو 30 ms. الفجوة العادية البالغة 50 ms بعد FALLING لا تزال تحسب ارتداد الإفلات.
هل يمكن استخدام Serial.print في مقاطعة على ESP32؟
لا. الطباعة تنتظر UART، والمعالج البطيء قد يشغّل كلب المراقبة للمقاطعات. عيّن متغيرًا في المعالج واطبعه من loop().
واصل
ابنِ هذا على أرض الواقع
افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.