تعلّم

قراءة الشاشة التسلسلية على لوحة Arduino

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

  • 526قطعة على المنضدة
  • 46لوحة تعمل الآن
  • 1.00xزمن حقيقي، على كل لوحة
Arduino Uno: أوامر من الشاشة التسلسليةمباشر0.000 s 0.00x
اضغط لفتحه في المحرر
اكتب o أو f أو b في الشاشة التسلسلية واضغط Enter: تشغيل أو إيقاف أو وميض، مع رد في كل مرة.

لقراءة ما تكتبه في الشاشة التسلسلية، تحقّق من Serial.available() لترى إن كان قد وصل شيء، ثم استدعِ Serial.read() لأخذ محرف واحد. النمط كله هو if (Serial.available() > 0) { char c = Serial.read(); }، ويتيح للكود تلقّي أوامر من لوحة المفاتيح بينما يواصل كل شيء آخر.

الدائرة أعلاه لوحة Uno عليها LED على الطرف 13، تنتظر ثلاثة أوامر. اضغط «تشغيل»، وانقر داخل الصندوق أسفل الشاشة التسلسلية، واكتب o ثم اضغط Enter. سيرد بـ "ok: on" وسيضيء المصباح. اكتب b لـ "ok: blink"، و f لـ "ok: off"، وأي شيء آخر لـ "unknown command: x" مع حرفك مكان x.

Below is what Serial.read() really hands you, reading a whole line, reading a number, and the one bug everyone meets with parseInt(): the extra 0 that turns up a second after the number you typed.

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

افتح الدرس

available() و read()

Serial.available() يعيد عدد المحارف التي وصلت وتنتظر. لا ينتظر شيئًا. Serial.read() يأخذ أقدمها ويعيده، أو ‎-1‎ إن لم يكن هناك شيء؛ فبدون كتابة أي شيء، طبع الكود ‎-1‎ و available() بقيمة 0. لا يستغرق أي من النداءين وقتًا في الانتظار، لذا يستمر الوميض في الكود أعلاه أثناء الاستماع.

اكتب "hi" واضغط Enter، واطبع كل محرف كرقم بدلًا من حرف، فطبع الكود 104 105 10. هذه شفرات h و i، ثم 10 وهو محرف السطر الجديد. الشاشة التسلسلية في Arduino IDE فيها قائمة Line ending تحدد ما يُرسل بعد نصك؛ شاشة Mokxi ترسل دائمًا سطرًا جديدًا، مثل إعداد New Line في IDE. لهذا يتخطى الكود أعلاه '\n' و '\r' بدلًا من الرد بـ "unknown command".

firmware/uno/examples/commands (نصف القراءة من الكود أعلاه)
  while (Serial.available() > 0) {
    int c = Serial.read();
    if (c == '\n' || c == '\r') continue;
    if (c == 'o') {
      mode = ON;
      Serial.println("ok: on");
    } else if (c == 'f') {
      mode = OFF;
      Serial.println("ok: off");
    } else if (c == 'b') {
      mode = BLINK;
      Serial.println("ok: blink");
    } else {
      Serial.print("unknown command: ");
      Serial.println((char)c);
    }
  }

اقرأ سطرًا كاملًا

للأوامر الأطول من حرف واحد، اقرأ حتى السطر الجديد باستخدام Serial.readStringUntil('\n'). يجمع المحارف في String حتى يرى سطرًا جديدًا، ثم يزيله ويعيد الباقي. عند كتابة "hello"، طبع الكود أدناه "[hello] 5": خمسة أحرف، بلا سطر جديد في النهاية.

إن لم يصل شيء، ينتظر readStringUntil() المحرف التالي حتى ثانية واحدة ثم يستسلم ويعيد ما لديه. استدعِه فقط عندما يقول available() إن هناك شيئًا ما، كما أدناه، فلن يتجاوز الانتظار وقت وصول السطر أبدًا.

مع السطر داخل String، يكون الباقي كودًا عاديًا. if (line == "on") يقارنه، و line.startsWith("speed ") يفحص بدايته، و line.substring(6).toInt() يحوّل الباقي إلى رقم، فأمر مثل speed 120 لا يحتاج أكثر من ثلاثة أسطر لقراءته.

If your sketch compares a line with == and it never matches on a real board, check the IDE’s Line ending menu. With Both NL & CR it sends a carriage return before the newline, and that carriage return stays on the end of the line. We sent "on" that way: the line was 3 characters long and line == "on" was false. After line.trim(); it was 2 characters and true. Mokxi’s monitor sends no carriage return, so this one only shows up on the bench, which is a good reason to call trim() anyway.

اقرأ حتى السطر الجديد
void setup() {
  Serial.begin(9600);
}

void loop() {
  if (Serial.available() > 0) {
    String line = Serial.readStringUntil('\n');
    Serial.print("[");
    Serial.print(line);
    Serial.print("] ");
    Serial.println(line.length());
  }
}

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

Read a number, and the 0 a second later

Serial.parseInt() يتخطى كل ما ليس رقمًا، ويقرأ رقمًا كاملًا ويعيده كـ long. إنه أسرع طريقة لكتابة رقم، وفيه فخ. شغّل الكود أدناه، واكتب 42 واضغط Enter. طبع "got 42 at 502"، ثم بعد ثانية "got 0 at 1502"، رقم لم تكتبه قط.

Here is why. parseInt() stops at the first character that is not a digit and leaves it waiting, so the newline is still there. Next time round, available() is 1, so parseInt() runs again, skips the newline, finds nothing more, waits its one-second timeout and returns 0. Call Serial.setTimeout(50); in setup() and the 0 arrives sooner, at 552 ms, but it still arrives.

الحل هو قراءة السطر أولًا وتحويله إلى رقم ثانيًا. مع String line = Serial.readStringUntil('\n'); int n = line.toInt(); طبع الرقم 42 نفسه "got 42 at 502" ولا شيء غير ذلك. يبقى parseInt() مفيدًا لرقمين في سطر واحد. عند كتابة "12 30"، طبع نداءان متتاليان "42 at 505"، وهو المجموع، ثم "0 at 2505": السطر الجديد المتبقي بدأ دورة أخرى، وانتظر كل من نداءيه ثانيته كاملة.

parseInt() and its extra 0
void setup() {
  Serial.begin(9600);
}

void loop() {
  if (Serial.available() > 0) {
    int n = Serial.parseInt();
    Serial.print("got ");
    Serial.print(n);
    Serial.print(" at ");
    Serial.println(millis());
  }
}

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

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

الأسئلة

لماذا تُرجع Serial.parseInt() القيمة 0؟

لأن السطر الجديد المُرسَل بعد رقمك لا يزال في الانتظار. استدعاء parseInt() التالي يتخطاه، فلا يجد أرقامًا، وينتظر حتى تنتهي مهلة الثانية الواحدة ثم يُرجع 0. اقرأ السطر باستخدام readStringUntil('\n') وحوّله باستخدام toInt() بدلًا من ذلك.

ماذا تُرجع Serial.read() عندما لم يُرسَل شيء؟

القيمة 1-. تحقّق أولًا من Serial.available()، ولا تستدعِ read() إلا عندما تكون أكبر من 0.

لماذا يحتوي مُدخالي على محرف إضافي في النهاية؟

الشاشة التسلسلية تُرسل نهاية سطر بعد نصك: سطرًا جديدًا أو إرجاع حرف أو كليهما، حسب إعداد Line ending لديها. readStringUntil('\n') يزيل السطر الجديد لكنه يُبقي إرجاع الحرف. استدعِ trim() على النص String لإزالته.

هل تنتظر Serial.read() وصول مُدخلات؟

لا. تُرجع فورًا، مع المحرف التالي أو القيمة 1-. أما readString() و readStringUntil() و parseInt() فتنتظر، حتى انتهاء المهلة المحددة بـ Serial.setTimeout()، وهي 1000 ms ما لم تُغيّرها.

هل يمكنني اختبار المُدخل التسلسلي دون لوحة؟

نعم. الشاشة التسلسلية في Mokxi تُرسل ما تكتبه إلى اللوحة المحاكاة، يتبعه سطر جديد، لذلك فإن كل كود في هذه الصفحة يعمل في المتصفح كما يعمل على لوحة Uno.

كيف أقرأ نصًا من المنفذ التسلسلي إلى مصفوفة أحرف؟

`int n = Serial.readBytesUntil('\n', buf, sizeof(buf) - 1);` copies everything up to the newline into buf and returns how many characters it copied. It does not end the text with a zero, so write `buf[n] = 0;` next. Typed hello, the sketch printed "got 5 bytes: hello".

المصادر

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

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

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