Belajar

Arduino Serial.print() dan println(), baris demi baris

Atau lihat semua pelajaran.

  • 526komponen di meja kerja
  • 46board sedang berjalan
  • 1.00xwaktu nyata, di semua board
Arduino Uno: mencetak ke serial monitorlive0.000 s 0.00x
Klik untuk membukanya di editor
Sebuah sapaan, pi dengan lima angka desimal, waktu berjalan tiap satu detik, dan gema dari apa yang kamu ketik.

Serial.print(x) mengirim x ke serial monitor dan tetap di baris yang sama. Serial.println(x) melakukan hal yang sama lalu mengakhiri baris, sehingga teks berikutnya mulai di baris baru. Panggil Serial.begin(9600) sekali di setup() lebih dulu, dan atur serial monitor ke kecepatan yang sama.

Rangkaian di atas adalah sebuah Uno sendirian, berbicara ke serial monitor. Tekan Jalankan. Ia mencetak "Mokxi Arduino Uno: serial example", lalu "pi to five places is 3.14159", lalu "up 1000 ms", "up 2000 ms" dan seterusnya, sekali per detik. Ketik sebuah huruf ke kotak di bawah monitor dan tekan Enter: huruf A kembali sebagai "you typed: A (0x41)", dan Enter sebagai "you typed: <newline>".

Di bawah ini adalah perbedaan print dan println byte demi byte, cara memilih jumlah angka desimal dan basis angka, cara yang salah untuk mencetak teks dan angka sekaligus, dan berapa biaya waktu mencetak, masing-masing dijalankan di sebuah Uno beserta hasil cetaknya.

Mau versi langkah demi langkah? Pelajaran "Membuat board bicara" memandu hal ini dengan checkpoint.

Buka pelajaran

Sketch-nya

Berikut setup() dari sketch yang berjalan di atas. Serial.begin(115200) membuka port pada 115200 baud. print() menulis "pi to five places is " dan membiarkan baris terbuka, dan println(3.14159265, 5) menambahkan angkanya dengan lima angka desimal lalu mengakhiri baris.

Cetak sebelum Serial.begin() dan tidak ada yang keluar. Kami mencetak "before begin" lebih dulu dan "after begin" kedua, dan hanya "after begin" yang sampai.

firmware/uno/examples/serial (setup() yang berjalan di atas)
void setup() {
  Serial.begin(115200);
  Serial.println("Mokxi Arduino Uno: serial example");
  Serial.print("pi to five places is ");
  Serial.println(3.14159265, 5);
}

print lawan println

Tiga print dan satu println, print("a"), print("b"), println("c"), mencetak "abc" dalam satu baris, dan println berikutnya mulai baris baru. Akhir baris yang ditambahkan println itu dua byte, carriage return dan newline, \r\n. Serial Monitor menyembunyikannya; program yang membaca port, atau board lain, melihat keduanya.

Serial.println() dengan tanda kurung kosong hanya mengakhiri baris, berguna setelah deretan print.

Satu baris dari empat panggilan
void setup() {
  Serial.begin(9600);
  Serial.print("a");
  Serial.print("b");
  Serial.println("c");
  Serial.println("next line");
}

void loop() {
}

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

Angka desimal, HEX dan BIN

Sebuah float dicetak dengan dua angka desimal kecuali kamu mengatur lain. Serial.println(3.14159) mencetak 3.14. Berikan jumlah angka desimal sebagai nilai kedua: println(3.14159, 4) mencetak 3.1416, sudah dibulatkan, dan println(2.0 / 3, 3) mencetak 0.667. Dengan 0 angka desimal ia membulatkan ke bilangan bulat, setengah ke atas: 1.5 mencetak 2 dan 2.5 mencetak 3.

Untuk bilangan bulat, nilai kedua adalah basisnya. println(255, HEX) mencetak FF dan println(5, BIN) mencetak 101, tanpa nol di depan, jadi tambahkan sendiri kalau kamu mau semua delapan bit. Angka negatif dalam HEX menampilkan semua empat byte dari sebuah long: -1 mencetak FFFFFFFF.

Angka desimal dan basis
void setup() {
  Serial.begin(9600);
  Serial.println(3.14159);
  Serial.println(3.14159, 4);
  Serial.println(2.0 / 3, 3);
  Serial.println(1.5, 0);
  Serial.println(2.5, 0);
  Serial.println(255, HEX);
  Serial.println(5, BIN);
  Serial.println(-1, HEX);
}

void loop() {
}

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

Angka, huruf dan write()

print() menentukan cara menampilkan sesuatu dari tipenya. println(65) mencetak 65, println('A') mencetak A, dan sebuah bool mencetak 1. Serial.write(65) berbeda: ia mengirim byte-nya sendiri, dan monitor menampilkan karakter dengan kode itu, yaitu A. Gunakan print() untuk manusia dan write() untuk mengirim byte mentah ke perangkat lain.

print() juga mengembalikan berapa karakter yang dikirim. int n = Serial.print("hello"); memberi 5.

Teks dan angka dalam satu baris

Cara cepat yang tidak berhasil: Serial.println("Temp: " + t); dengan t bernilai 21 mencetak beberapa simbol aneh. Menambahkan angka ke teks dalam tanda kutip berarti menggeser posisi di teks, bukan menggabungkan, dan 21 huruf ke depan sudah melewati akhir "Temp: ". Clang memberi peringatan: adding 'int' to a string does not append to the string. Cara sederhananya adalah dua panggilan, Serial.print("Temp: "); lalu Serial.println(t);, dan "Temp: " + String(t) juga berhasil; keduanya mencetak "Temp: 21".

Orang yang paham C langsung memakai sprintf(). Ia berhasil untuk bilangan bulat: "%02d:%02d" dengan 7 dan 5 mencetak 07:05. Di sebuah Uno ia tidak mendukung float: %f mencetak "t=?", karena printf kecil milik Uno tidak menyertakan float. Gunakan dtostrf(t, 6, 2, buf), yang mencetak " 21.50", atau cetak float-nya sendirian. Dan %d untuk int: diberi long bernilai 100000 ia mencetak -31072, dengan peringatan; gunakan %ld untuk long.

sprintf di sebuah Uno
void setup() {
  Serial.begin(9600);
  char buf[40];
  float t = 21.5;
  sprintf(buf, "t=%f", t);
  Serial.println(buf);
  dtostrf(t, 6, 2, buf);
  Serial.println(buf);
  sprintf(buf, "%02d:%02d", 7, 5);
  Serial.println(buf);
  long big = 100000;
  sprintf(buf, "%d", big);
  Serial.println(buf);
  sprintf(buf, "%ld", big);
  Serial.println(buf);
}

void loop() {
}

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

Biaya mencetak, dan F()

Mencetak butuh waktu, ditentukan oleh baud rate. Pada 9600 baud satu karakter butuh sekitar satu milidetik untuk dikirim. Uno menyimpan antrian 64 byte, jadi baris pendek masuk antrian dan sketch lanjut berjalan, tapi baris panjang menunggu ruang. Baris 100 karakter butuh 38504 mikrodetik untuk dicetak pada 9600 baud, dan 3168 pada 115200. Sketch yang banyak mencetak di 9600 menghabiskan sebagian besar waktunya untuk mencetak; gunakan 115200 kecuali ada yang lain yang menentukan kecepatannya.

Di sebuah Uno, setiap teks dalam tanda kutip di sebuah sketch juga disalin ke 2048 byte RAM saat mulai. Bungkus teks tetap dalam F(), seperti Serial.println(F("from flash"));, dan ia dibaca dari flash, yang ruangnya jauh lebih besar. Ia mencetak "from flash" sama persis seperti sebelumnya. Untuk sketch dengan banyak pesan, ini adalah RAM termudah untuk didapatkan kembali.

Jika monitor menampilkan omong kosong alih-alih kata, kecepatannya tidak cocok dengan Serial.begin(). Halaman omong kosong serial monitor memuat itu dan penyebab lainnya.

Buka rangkaian ini di editor. Arduino Uno: mencetak ke Serial Monitor, dirangkai seperti saat dijalankan di bagian atas halaman ini. Ubah komponen atau nilainya dan jalankan lagi.

Pertanyaan

Apa bedanya Serial.print dan Serial.println?

print() mengirim teksnya dan tetap di baris yang sama. println() mengirimnya lalu carriage return dan newline, sehingga teks berikutnya mulai di baris baru.

Bagaimana mencetak float dengan lebih banyak angka desimal?

Berikan jumlah angka desimal setelah nilainya: Serial.println(3.14159, 4) mencetak 3.1416. Tanpa itu float dicetak dengan dua angka desimal.

Bagaimana mencetak teks dan variabel dalam baris yang sama?

Gunakan dua panggilan: Serial.print("Temp: "); lalu Serial.println(t);. Atau gabungkan sebagai String, "Temp: " + String(t). Menulis "Temp: " + t tanpa String() mencetak sebagian teks atau sampah.

Kenapa sprintf mencetak tanda tanya untuk float di Arduino?

Printf milik Uno dibangun tanpa dukungan float, jadi %f mencetak ?. Konversi float-nya dengan dtostrf() lebih dulu, atau cetak dengan Serial.print(t, 2).

Kenapa serial monitor saya tidak menampilkan apa pun?

Periksa bahwa Serial.begin() berjalan sebelum print pertama dan bahwa monitor diatur ke baud rate yang sama. Apa pun yang dicetak sebelum Serial.begin() hilang.

Bagaimana mencetak angka dalam HEX dengan nol di depan?

`Serial.println(10, HEX)` mencetak "A" dan `Serial.println(255, HEX)` mencetak "FF": print() membuang nol di depan. Untuk satu byte, cetak nolnya sendiri kalau nilainya di bawah 0x10. `if (b < 0x10) Serial.print("0");` sebelum `Serial.println(b, HEX);` mencetak "0A".

Rakit versi nyatanya

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