Belajar

Membaca serial monitor di Arduino

Atau lihat semua pelajaran.

  • 526komponen di meja kerja
  • 46board sedang berjalan
  • 1.00xwaktu nyata, di semua board
Arduino Uno: perintah dari serial monitorlive0.000 s 0.00x
Klik untuk membukanya di editor
Ketik o, f atau b di serial monitor lalu tekan Enter: on, off atau blink, dijawab setiap kali.

Untuk membaca apa yang kamu ketik di serial monitor, periksa Serial.available() untuk melihat apakah ada yang masuk, lalu panggil Serial.read() untuk mengambil satu karakter. if (Serial.available() > 0) { char c = Serial.read(); } adalah pola lengkapnya, dan ini memungkinkan sketch menerima perintah dari keyboardmu sambil terus menjalankan yang lain.

Rangkaian di atas adalah Uno dengan LED di pin 13, menunggu tiga perintah. Tekan Jalankan, klik di kotak di bawah serial monitor, ketik o lalu tekan Enter. Ia menjawab "ok: on" dan lampunya menyala. Ketik b untuk "ok: blink", f untuk "ok: off", dan apa pun selain itu untuk "unknown command: x" dengan hurufmu menggantikan 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.

Mau versi langkah demi langkah? Pelajaran "Taking commands" membahas ini dengan checkpoint.

Buka pelajaran

available() dan read()

Serial.available() mengembalikan berapa banyak karakter yang sudah masuk dan menunggu. Ia tidak menunggu apa pun. Serial.read() mengambil yang paling lama dan mengembalikannya, atau -1 jika tidak ada apa-apa; saat belum ada yang diketik, sketch kami mencetak -1 dan available() bernilai 0. Tidak ada satu pun panggilan yang menunggu, jadi blink pada sketch di atas tetap berjalan sambil terus mendengarkan.

Ketik "hi" lalu tekan Enter, dan cetak setiap karakter sebagai angka alih-alih huruf, dan board mencetak 104 105 10. Itu adalah kode untuk h dan i, lalu 10, yaitu newline. Serial monitor Arduino IDE punya menu Line ending yang menentukan apa yang dikirim setelah tulisanmu; monitor Mokxi selalu mengirim newline, sama seperti pengaturan New Line di IDE. Itulah kenapa sketch di atas melewatkan '\n' dan '\r' alih-alih menjawab "unknown command".

firmware/uno/examples/commands (bagian pembacaan dari sketch di atas)
  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);
    }
  }

Baca satu baris penuh

Untuk perintah yang lebih panjang dari satu huruf, baca sampai newline dengan Serial.readStringUntil('\n'). Ia mengumpulkan karakter ke dalam String sampai menemukan newline, membuang newline-nya dan mengembalikan sisanya. Saat diketik "hello", sketch di bawah mencetak "[hello] 5": lima huruf, tanpa newline di akhir.

Jika tidak ada yang masuk, readStringUntil() menunggu hingga satu detik untuk karakter berikutnya, lalu menyerah dan mengembalikan yang sudah ada. Panggil hanya setelah available() bilang ada yang masuk, seperti di bawah, dan tunggunya tidak pernah lebih lama dari waktu yang dibutuhkan satu baris untuk masuk.

Dengan barisnya di dalam String, sisanya adalah kode biasa. if (line == "on") membandingkannya, line.startsWith("speed ") memeriksa awalnya, dan line.substring(6).toInt() mengubah sisanya jadi angka, jadi perintah seperti speed 120 hanya butuh tiga baris untuk dibaca.

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.

Baca sampai newline
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());
  }
}

Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.

Read a number, and the 0 a second later

Serial.parseInt() melewati apa pun yang bukan digit, membaca satu angka utuh dan mengembalikannya sebagai long. Ini cara tercepat mengetik angka, tapi ada jebakannya. Jalankan sketch di bawah, ketik 42 lalu tekan Enter. Ia mencetak "got 42 at 502", lalu sedetik kemudian "got 0 at 1502", angka yang tidak pernah kamu ketik.

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.

Solusinya: baca barisnya dulu lalu ubah jadi angka setelahnya. Dengan String line = Serial.readStringUntil('\n'); int n = line.toInt(); angka 42 yang sama mencetak "got 42 at 502" dan tidak ada lagi. parseInt() tetap berguna untuk dua angka dalam satu baris. Saat diketik "12 30", dua panggilan berturut-turut mencetak "42 at 505", jumlahnya, lalu "0 at 2505": newline yang tersisa memulai putaran baru, dan kedua panggilannya menunggu hingga satu detik penuh.

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());
  }
}

Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.

Buka rangkaian ini di editor. Arduino Uno: perintah dari serial monitor, dirangkai saat berjalan di bagian atas halaman ini. Ubah satu komponen atau nilainya, lalu jalankan lagi.

Pertanyaan

Kenapa Serial.parseInt() mengembalikan 0?

Karena newline yang dikirim setelah angka-mu masih menunggu. parseInt() berikutnya melewatinya, tidak menemukan digit, menunggu timeout satu detiknya, lalu mengembalikan 0. Baca barisnya dengan readStringUntil('\n') dan ubah dengan toInt() saja.

Apa yang dikembalikan Serial.read() saat belum ada yang dikirim?

-1. Periksa Serial.available() dulu, dan panggil read() hanya jika nilainya lebih dari 0.

Kenapa input saya ada karakter tambahan di akhir?

Serial monitor mengirim akhir baris setelah teks kamu: baris baru, carriage return, atau keduanya, tergantung pengaturan Line ending. readStringUntil('\n') menghapus baris baru tapi menyimpan carriage return. Panggil trim() pada String untuk menghapusnya.

Apakah Serial.read() menunggu input?

Tidak. Ia langsung kembali, dengan karakter berikutnya atau -1. readString(), readStringUntil() dan parseInt() memang menunggu, sampai batas waktu yang diatur Serial.setTimeout(), yaitu 1000 ms kecuali kamu mengubahnya.

Bisakah saya menguji input serial tanpa board?

Bisa. Serial monitor Mokxi mengirim apa yang kamu ketik ke board simulasi, diikuti baris baru, jadi setiap sketch di halaman ini berjalan di browser seperti di Uno sungguhan.

Bagaimana cara membaca string dari serial ke array char?

`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".

Rakit versi nyatanya

Buka editor, ubah sebuah nilai, dan lihat angkanya ikut berubah. Tidak ada yang perlu dipasang, dan tidak perlu akun.