اقرأ زرًا على Raspberry Pi Pico
مبتدئ
أو تصفّح كل الدروس.
- 526قطعة على المنضدة
- 46لوحة تعمل الآن
- 1.00xزمن حقيقي، على كل لوحة
لقراءة زر على Raspberry Pi Pico، وصّله من طرف GPIO إلى GND، وشغّل مقاومة السحب الداخلية للطرف بالدالة pinMode(pin, INPUT_PULLUP)، واقرأه بالدالة digitalRead(): تعني HIGH غير مضغوط، وتعني LOW مضغوطًا. لا حاجة إلى مقاومة.
الدائرة أعلاه هي Pico مع زر ضغط بين GP15 وGND، وLED عبر مقاومة 220 أوم على GP14. أثناء ضغطك الزر، يضيء LED الموجود على اللوحة على GP25، وكذلك الذي على GP14. تعمل في متصفحك على RP2040 مُحاكى، والكود هو C++ بأسلوب Arduino يُترجم لـ Pico حقيقي أيضًا.
ما تحتاجه
- لوحة Raspberry Pi Pico
- زر ضغط (مفتاح لمسي بأربعة أرجل)
- سلكان للتوصيل
- اختياري: LED ومقاومة 220 أوم على GP14، يضيئهما الكود أيضًا
التوصيل
| القطعة والطرف | يتصل بـ | ملاحظة |
|---|---|---|
| الزر، أحد الطرفين | GP15 | الطرف الذي يقرؤه الكود |
| الزر، الرجل المقابلة له | GND | أي طرف GND على Pico |
| LED (اختياري)، عبر مقاومة 220 أوم | GP14 | يضيء مع LED الموجود على اللوحة |
الخطوة 1: وصّل الزر بالأرضي
A four-leg tactile switch is two pairs of legs. The legs in a pair are always joined, and pressing the button joins one pair to the other. Wire one leg to GP15 and a leg on the other side to any GND pin. If the button seems to be pressed all the time, you have used two legs of the same pair: turn it a quarter turn.
هذه هي الدائرة كاملة. الطرف GP15 هو الطرف السفلي في الجهة اليسرى من Pico، وبجانبه طرف GND على بعد أطراف قليلة إلى الأعلى، فعلى المكتب يكفي سلكان قصيران دون لوحة تجارب أصلًا.
الخطوة 2: لماذا INPUT_PULLUP
الطرف المُدخل الذي لا يغذّيه شيء يبقى عائمًا. يلتقط ما حوله ويقرأ HIGH و LOW بشكل عشوائي. العلاج هو مقاومة تشد الطرف إلى مستوى معروف عندما يكون الزر مفتوحًا. تحتوي شريحة RP2040 على واحدة منها داخل كل طرف GPIO، لذلك فإن pinMode(BUTTON, INPUT_PULLUP) يشغّلها ويستقر الطرف عند 3.3 V.
الضغط على الزر يوصل الطرف مباشرة بالأرضي، وهو ما يتغلب على مقاومة الشد الضعيفة، فيقرأ الطرف LOW. فالمنطق هنا معكوس مما قد تتوقعه: LOW يعني مضغوطًا. الكود يعكس ذلك في سطر واحد قبل أن يشغّل مصابيح LED.
الخطوة 3: الكود، بالشرح
الدالة setup() تجعل GP15 مدخلًا مع مقاومة الشد، وتجعل LED الموجود على اللوحة و GP14 مخرجين. الطرف LED_BUILTIN هو GP25 على Pico. الدالة loop() تقرأ الزر وتكتب النتيجة إلى الضوءين معًا، مرارًا وتكرارًا، فيتبع الضوءان إصبعك.
لأن LED يعكس حالة الزر ببساطة، فإن ارتداد التلامس لا يهم هنا: بضع ومضات سريعة لحظة الضغط أقصر من أن تُرى. يصبح الارتداد مهمًا بمجرد أن تعد الضغطات أو تبدّل حالة شيء عند كل ضغطة، وهو ما يشرحه درس إزالة الارتداد.
const int BUTTON = 15;
const int LED = 14;
void setup() {
pinMode(BUTTON, INPUT_PULLUP);
pinMode(LED_BUILTIN, OUTPUT);
pinMode(LED, OUTPUT);
}
void loop() {
int pressed = digitalRead(BUTTON) == LOW ? HIGH : LOW;
digitalWrite(LED_BUILTIN, pressed);
digitalWrite(LED, pressed);
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
الخطوة 4: اجعله يبدّل الحالة
الزر الذي يضيء LED بضغطة ويطفئه بالضغطة التالية يحتاج إلى تغييرين. تذكّر آخر قراءة، وتصرّف فقط عندما تتغير من HIGH إلى LOW، وهي لحظة الضغط. ثم تجاهل الزر لبضع عشرات من المللي ثانية، حتى لا يُحتسب الارتداد ضغطات إضافية.
const int BUTTON = 15;
int last = HIGH;
bool on = false;
void setup() {
pinMode(BUTTON, INPUT_PULLUP);
pinMode(LED_BUILTIN, OUTPUT);
}
void loop() {
int now = digitalRead(BUTTON);
if (last == HIGH && now == LOW) {
on = !on;
digitalWrite(LED_BUILTIN, on ? HIGH : LOW);
delay(30); // let the contacts settle
}
last = now;
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
جرّبه في المحرر
افتح الدائرة في المحرر واستمر بالضغط على الزر بالفأرة: يضيء LED على اللوحة. استبدل الكود بنسخة التبديل أعلاه واضغط «تشغيل» مرة أخرى. ثم أضف LED ومقاومة 220 أوم من GP14 إلى GND وشاهده يتبع LED اللوحة.
لترى ما فائدة مقاومة الشد، شغّل «إظهار المستويات» بـ Shift+L، فيكتب مستوى كل سلك أثناء عمل الدائرة. ثم غيّر INPUT_PULLUP إلى INPUT وشغّلها مرة أخرى. مع تحرير الزر، لا شيء يثبّت الطرف عند أي مستوى بعد الآن: هذا المدخل العائم هو بالضبط ما كانت مقاومة الشد هناك لمنعه.
أخطاء شائعة
توصيل الزر بـ 3V3 بدلًا من GND مع استخدام INPUT_PULLUP. الطرف مشدود إلى الأعلى أصلًا، فلا يغيّر الضغط شيئًا. مع مقاومة الشد، يذهب الزر إلى الأرضي.
استخدام رجلين من الزوج نفسه. إنهما متصلتان داخل الزر، فيقرأ الطرف أن الزر مضغوط طوال الوقت. استخدم رجلين على جهتين متقابلتين.
توقّع HIGH عند الضغط. مع مقاومة الشد، الضغط يعني LOW. إمّا أن تختبر LOW، أو توصل الزر بـ 3V3 وتستخدم INPUT_PULLDOWN، وهي متوفرة أيضًا في RP2040.
استخدام GP25 لـ LED خارجي. الطرف GP25 موصول بـ LED الموجود على اللوحة وليس على الترويسة، لذا يوضع LED الخارجي على طرف آخر، مثل GP14 هنا.
افتح هذه الدائرة في المحرر. Raspberry Pi Pico: زر، موصولة كما تعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة وشغّلها مرة أخرى.
افتح الدائرةالأسئلة
هل أحتاج إلى مقاومة لزر على Pico؟
لا، إن استخدمت INPUT_PULLUP أو INPUT_PULLDOWN. كل طرف GPIO في RP2040 يحتوي على مقاومة شد لأعلى وأخرى لأسفل. مقاومة خارجية 10 k تقوم بالمهمة نفسها ولا تلزم إلا إذا أطفأت المقاومات الداخلية.
أي أطراف Pico يمكنها قراءة زر؟
أي طرف GPIO، من GP0 إلى GP22 ومن GP26 إلى GP28. استخدمنا GP15 هنا لأنه بجانب طرف GND. الأطراف GP23 إلى GP25 و GP29 مستخدمة داخل الوحدة.
هل يمكنني استخدام MicroPython لهذا؟
نعم. اختر MicroPython (main.py) في لوحة البرنامج الثابت على Pico وسيشغّل Mokxi البرنامج الثابت الرسمي لـ MicroPython: Pin(15, Pin.IN, Pin.PULL_UP)، و value() تساوي 0 أثناء الضغط على الزر. الدائرة في هذه الصفحة تعمل بـ C++ بنمط Arduino.
لماذا يسجّل زري عدة ضغطات؟
تلامسات الزر ترتد لبضع مللي ثانية عند انغلاقها. تصرّف فقط عند التغير من HIGH إلى LOW وتجاهل الطرف لوهلة بعدها، كما يفعل كود التبديل أعلاه، أو راجع درس إزالة ارتداد الزر لطريقة لا تستخدم delay().
واصل
ابنِ هذا على أرض الواقع
افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.