تعلّم

Arduino digitalRead()، على زر وLED

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

  • 526قطعة على المنضدة
  • 46لوحة تعمل الآن
  • 1.00xزمن حقيقي، على كل لوحة
Arduino Uno: زر على الطرف 2 يشغّل LED على الطرف 13مباشر0.000 s 0.00x
اضغط «تشغيل» ثم اضغط الزر مع الاستمرار
INPUT_PULLUP يُبقي الطرف 2 عند 5 V؛ والزر يسحبه إلى الأرضي، وdigitalRead يقرأ LOW.

digitalRead(pin) ينظر إلى الجهد على الطرف ويعيد HIGH (1) أو LOW (0). اضبط الطرف أولًا باستخدام pinMode(pin, INPUT_PULLUP) ووصّل زرًا من الطرف إلى الأرضي، فيقرأ HIGH حتى يُضغط الزر وLOW طوال بقائه مضغوطًا. هذا هو كل ما في قراءة زر.

الدائرة أعلاه هي ذلك بالضبط: زر على الطرف 2 وLED على الطرف 13 في لوحة Uno. اضغط «تشغيل» ثم اضغط الزر مع الاستمرار. يبقى الطرف 2 عند 5 فولت حتى يسحبه الزر إلى 0 فولت، فيرى digitalRead() قيمة LOW، ويضيء الLED. اتركه فينطفئ.

فيما يلي سبب أهمية مقاومة السحب، وما يقرأه الطرف الذي لا شيء متصل به، والجهد الذي يتحوّل عنده LOW إلى HIGH، ولماذا قد تُقرأ الضغطة الواحدة آلاف المرات، كل ذلك مجرّب على Uno في Mokxi مع ما طبعه.

تريد النسخة خطوة بخطوة؟ الدرس «قراءة طرف ومقاومة السحب» يشرح ذلك مع نقاط تحقق.

افتح الدرس

الكود: pinMode ثم digitalRead

هذا هو الكود الذي يعمل أعلاه. pinMode(BUTTON_PIN, INPUT_PULLUP) يجعل الطرف 2 مدخلًا ويشغّل مقاومة داخل الشريحة تسحبه إلى 5 V. في loop()، يكون digitalRead(BUTTON_PIN) == LOW صحيحًا أثناء ضغط الزر، ويتبع LED ذلك.

لهذا تُقرأ الضغطة كـ LOW، وهو ما يفاجئ الجميع في المرة الأولى. الزر يصل الطرف بالأرضي؛ والمقاومة الساحبة هي ما تجعله يقرأ HIGH بقية الوقت. إن كنت تفضّل التفكير بصيغة "المضغوط صحيح"، اكتب bool pressed = digitalRead(2) == LOW; مرة واحدة واستخدم pressed من بعدها.

firmware/uno/examples/button (الكود الذي يعمل أعلاه)
const int BUTTON_PIN = 2;

void setup() {
  pinMode(BUTTON_PIN, INPUT_PULLUP);
  pinMode(LED_BUILTIN, OUTPUT);
}

void loop() {
  bool pressed = digitalRead(BUTTON_PIN) == LOW;
  digitalWrite(LED_BUILTIN, pressed ? HIGH : LOW);
  delay(5);
}

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

الطرف الذي لا شيء عليه يقرأ تشويشًا

مع pinMode(2, INPUT) البسيط ولا شيء يسحب الطرف في أي اتجاه، يصبح الطرف عائمًا، وأي شحنة شاردة قريبة تقرر ما يقرأه. عشرون قراءة، بين كل واحدة وأخرى 10 ms، طبعت 00111111010100110100. اللوحة الحقيقية تفعل الشيء نفسه، وزر موصول بلا مقاومة إطلاقًا يتصرف هكذا كلما لم يكن مضغوطًا: ضغطات عشوائية لم يفعلها أحد.

شغّل مقاومة السحب لأعلى فتطبع القراءات العشرون نفسها 11111111111111111111. استخدم INPUT_PULLUP مع الزر الموصول بالأرضي كما في الأعلى، أو INPUT مع مقاومتك الخاصة، 10 k من الطرف إلى 5 فولت أو إلى الأرضي. صفحة مقاومة السحب ترسم الطريقتين.

عائم، ثم مسحوب للأعلى
void setup() {
  Serial.begin(9600);
  pinMode(2, INPUT);
  for (int i = 0; i < 20; i++) {
    Serial.print(digitalRead(2));
    delay(10);
  }
  Serial.println();
  pinMode(2, INPUT_PULLUP);
  for (int i = 0; i < 20; i++) {
    Serial.print(digitalRead(2));
    delay(10);
  }
  Serial.println();
}

void loop() {
}

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

ما يُحتسب HIGH

الطرف الرقمي يجيب بنعم أو لا، لكن الجهد عليه قد يكون أي شيء من 0 إلى 5 فولت. ورقة بيانات ATmega328P تضمن LOW تحت 1.5 فولت وHIGH فوق 3 فولت على لوحة Uno بجهد 5 فولت، وتترك ما بينهما للشريحة. وضعنا مقاومة متغيرة على الطرف 2 وA0 وأدرناها ببطء نزولًا ثم صعودًا. في النزول، تحوّل الطرف إلى LOW عند 2184 mV؛ وفي الصعود لم يعد HIGH إلا عند 2619 mV.

هذه الفجوة مقصودة. الطرف الذي يتبدّل عند جهد واحد بالضبط سيتذبذب ذهابًا وإيابًا مع إشارة تتغيّر ببطء، أما مع فجوة فيغيّر رأيه مرة واحدة. كما تخبرك أن قيمة HIGH لحساس 3.3 V، أي أعلى من 3 V بوضوح، تُقرأ HIGH على لوحة Uno بجهد 5 V، وأن إشارة ضعيفة بجهد 2 V مسألة حظ. لأي شيء بينهما، اقرأه باستخدام analogRead().

حيث يغيّر الطرف رأيه
void setup() {
  Serial.begin(9600);
  pinMode(2, INPUT);
}

void loop() {
  static int last = -1;
  int v = digitalRead(2);
  if (v != last) {
    last = v;
    long mv = analogRead(A0) * 5000L / 1023;
    Serial.print(mv);
    Serial.print(" mV -> ");
    Serial.println(v);
  }
  delay(2);
}

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

ضغطة واحدة، وقراءات بالآلاف

تعمل loop() أسرع بكثير من الإصبع. ضغطنا على الزر لمدة نصف ثانية وأحصينا: نحو 47,800 دورة من loop() رأته LOW. الكود الذي يضيف إلى النقاط كلما كان الطرف LOW يضيف نحو 47,800 نقطة لضغطة واحدة. لإحصاء الضغطات، احفظ القراءة السابقة وتصرّف فقط عندما تتغيّر من HIGH إلى LOW.

حتى هذا أحصى 4 ضغطات بدلًا من ضغطتنا الواحدة. تلامسات الزر ترتدّ لبضع أجزاء من الألف من الثانية عند الإغلاق والفتح، وزر Mokxi يرتدّ كما يفعل الزر الحقيقي، لذلك رأى الكود الطرف يصبح LOW أربع مرات منفصلة. تشرح صفحة إزالة ارتداد الزر كيفية انتظار زوال الارتداد باستخدام millis().

المستويات مقابل الضغطات
const int BUTTON = 2;
long held = 0;
int presses = 0;
int last = HIGH;

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

void loop() {
  int now = digitalRead(BUTTON);
  if (now == LOW) held++;
  if (now == LOW && last == HIGH) presses++;
  last = now;
  if (millis() >= 1500) {
    Serial.print("loops that saw LOW: ");
    Serial.println(held);
    Serial.print("presses: ");
    Serial.println(presses);
    while (true) {
    }
  }
}

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

أطراف الإخراج، والأطراف التناظرية، وعلامة = خاطئة

تعمل digitalRead() على أي طرف. على الطرف المضبوط على OUTPUT، تقرأ آخر قيمة كتبتها: بعد digitalWrite(13, HIGH) طبع 1، وبعد LOW طبع 0. هذه طريقة سريعة لتبديل حالة طرف، digitalWrite(13, !digitalRead(13));. الأطراف التناظرية في لوحة Uno هي أطراف رقمية أيضًا: A0 الموصولة بـ 5 V طبع 1، وA1 الموصولة بالأرضي طبع 0.

HIGH وLOW هما ببساطة 1 و0، وSerial.println(digitalRead(2)) يطبع الرقم. استخدم علامتي يساوي للمقارنة. أما if (digitalRead(2) = HIGH) فيوقف البناء: مترجم clang في Mokxi يقول expression is not assignable، ومترجم GCC في Arduino IDE يقول lvalue required as left operand of assignment.

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

الأسئلة

لماذا يرجع digitalRead قيمة LOW عند الضغط على الزر؟

لأن الزر يوصل الطرف بالأرضي، بينما INPUT_PULLUP يبقيه عند 5 V في بقية الوقت. عند الضغط تكون القيمة LOW، وعند الإفلات تكون HIGH. قارن مع LOW، أو اكتب bool pressed = digitalRead(pin) == LOW;.

لماذا تتغيّر قراءة digitalRead عشوائيًا؟

الطرف عائم: لا شيء يبقيه HIGH أو LOW. استخدم pinMode(pin, INPUT_PULLUP) مع الزر الموصول بالأرضي، أو أضف مقاومة 10 k من الطرف إلى 5 V أو الأرضي.

هل يمكن استخدام digitalRead على طرف تناظري؟

نعم. على لوحة Uno، الأطراف A0 إلى A5 أطراف رقمية أيضًا، وdigitalRead(A0) يرجع HIGH أو LOW. (على Nano، الطرفان A6 وA7 تناظريان فقط.)

ما الجهد الذي يراه digitalRead كـ HIGH؟

على لوحة Uno بجهد 5 V، أي شيء فوق 3 V مضمون أنه HIGH وأي شيء تحت 1.5 V مضمون أنه LOW. بينهما، يحتفظ الطرف بآخر إجابة له لفترة: في اختبارنا نزل إلى LOW عند نحو 2.2 V وصعد إلى HIGH مجددًا عند نحو 2.6 V.

هل أحتاج إلى pinMode قبل digitalRead؟

تبدأ الأطراف كمدخلات، لذا يعمل digitalRead بدونه، لكن الطرف يكون عائمًا. استدعِ pinMode(pin, INPUT_PULLUP) أو pinMode(pin, INPUT) في setup() ليكون واضحًا ما وظيفة الطرف وكيفية تثبيته.

المصادر

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

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

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