Đọc Serial Monitor trên một bo mạch Arduino
Hoặc xem mọi bài học.
- 526linh kiện trên bàn làm mạch
- 46bo mạch đang chạy
- 1.00xthời gian thực, trên mọi bo mạch
Để đọc những gì bạn gõ vào Serial Monitor, kiểm tra Serial.available() xem đã có dữ liệu tới chưa, rồi gọi Serial.read() để lấy một ký tự. if (Serial.available() > 0) { char c = Serial.read(); } là toàn bộ khuôn mẫu, và nó giúp sketch nhận lệnh từ bàn phím của bạn trong khi vẫn làm tiếp mọi việc khác.
Mạch trên là một Uno có LED ở chân 13, đang chờ ba lệnh. Nhấn Chạy, click vào ô dưới Serial Monitor, gõ o rồi nhấn Enter. Bo mạch trả lời "ok: on" và đèn sáng. Gõ b cho "ok: blink", f cho "ok: off", còn gõ gì khác thì được "unknown command: x" với chữ của bạn thay vào chỗ 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.
Muốn học từng bước? Bài học "Nhận lệnh" sẽ hướng dẫn bạn qua từng điểm kiểm tra.
Mở bài họcavailable() và read()
Serial.available() trả về có bao nhiêu ký tự đã tới và đang chờ. Nó không chờ đợi gì cả. Serial.read() lấy ký tự cũ nhất và trả về, hoặc -1 nếu không có gì; khi chưa gõ gì, sketch của ta in ra -1 và available() là 0. Cả hai lệnh gọi đều không bao giờ chờ, nên phần nhấp nháy trong sketch trên vẫn chạy trong lúc lắng nghe.
Gõ "hi" rồi nhấn Enter, và in mỗi ký tự ra dưới dạng số thay vì chữ, bo mạch in 104 105 10. Đó là mã của h và i, rồi tới số 10, tức ký tự xuống dòng. Serial Monitor của Arduino IDE có menu Line ending quyết định gửi gì sau chữ của bạn; monitor của Mokxi luôn gửi ký tự xuống dòng, giống thiết lập New Line của IDE. Vì vậy sketch trên mới bỏ qua '\n' và '\r' thay vì trả lời "unknown command".
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);
}
}Đọc cả một dòng
Với lệnh dài hơn một ký tự, hãy đọc đến ký tự xuống dòng bằng Serial.readStringUntil('\n'). Nó gom ký tự vào một String cho tới khi gặp ký tự xuống dòng, bỏ ký tự đó đi và trả về phần còn lại. Gõ "hello", sketch bên dưới in "[hello] 5": năm chữ cái, không có ký tự xuống dòng ở cuối.
Nếu chưa có dữ liệu tới, readStringUntil() chờ tối đa một giây cho ký tự tiếp theo rồi bỏ cuộc và trả về những gì có được. Chỉ gọi nó khi available() báo đã có dữ liệu, như bên dưới, thì thời gian chờ không bao giờ quá thời gian một dòng tới.
Khi đã có dòng trong một String, phần còn lại là code bình thường. if (line == "on") so sánh, line.startsWith("speed ") kiểm tra đầu dòng, và line.substring(6).toInt() biến phần còn lại thành số, nên một lệnh như speed 120 chỉ cần chưa tới ba dòng code là đọc xong.
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());
}
}Mở sketch này trong trình soạn codeChỉ riêng phần code: trình soạn code sẽ tự đặt bo mạch và các linh kiện mà nó đọc được từ sketch.
Read a number, and the 0 a second later
Serial.parseInt() bỏ qua mọi thứ không phải chữ số, đọc trọn một số nguyên và trả về dưới dạng long. Đây là cách gõ số vào nhanh nhất, nhưng có một bẫy. Chạy sketch bên dưới, gõ 42 rồi nhấn Enter. Nó in "got 42 at 502", rồi một giây sau lại in "got 0 at 1502", một số bạn chưa từng gõ.
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.
Cách sửa là đọc dòng trước, đổi thành số sau. Với String line = Serial.readStringUntil('\n'); int n = line.toInt(); thì số 42 như trước chỉ in "got 42 at 502" và không có gì thêm. parseInt() vẫn tiện khi có hai số trên một dòng. Gõ "12 30", hai lệnh gọi liên tiếp in "42 at 505", tức tổng, rồi "0 at 2505": ký tự xuống dòng sót lại khởi động một vòng mới, và cả hai lệnh gọi đều chờ đủ một giây của mình.
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());
}
}Mở sketch này trong trình soạn codeChỉ riêng phần code: trình soạn code sẽ tự đặt bo mạch và các linh kiện mà nó đọc được từ sketch.
Mở mạch này trong trình soạn thảo. Bo mạch Arduino Uno: các lệnh từ Serial Monitor, được nối dây khi nó chạy ở đầu trang này. Thay một linh kiện hoặc một giá trị rồi chạy lại.
Câu hỏi
Tại sao Serial.parseInt() trả về 0?
Vì ký tự xuống dòng gửi sau số của bạn vẫn đang chờ. Lần parseInt() tiếp theo sẽ bỏ qua nó, không tìm thấy chữ số nào, chờ hết thời gian chờ một giây và trả về 0. Thay vào đó, hãy đọc cả dòng bằng readStringUntil('\n') và chuyển đổi bằng toInt().
Serial.read() trả về gì khi chưa có gì được gửi?
-1. Hãy kiểm tra Serial.available() trước, và chỉ gọi read() khi nó lớn hơn 0.
Tại sao dữ liệu vào của tôi lại có một ký tự thừa ở cuối?
Serial monitor gửi ký tự kết thúc dòng sau văn bản của bạn: ký tự xuống dòng, ký tự về đầu dòng hoặc cả hai, tùy vào thiết lập Line ending của nó. readStringUntil('\n') bỏ ký tự xuống dòng nhưng giữ lại ký tự về đầu dòng. Hãy gọi trim() trên String để bỏ nó đi.
Serial.read() có chờ dữ liệu vào không?
Không. Nó trả về ngay lập tức, với ký tự kế tiếp hoặc -1. readString(), readStringUntil() và parseInt() thì có chờ, tối đa bằng thời gian chờ do Serial.setTimeout() đặt, là 1000 ms trừ khi bạn thay đổi.
Tôi có thể thử dữ liệu vào serial mà không cần bo mạch không?
Có. Serial monitor của Mokxi gửi những gì bạn gõ đến bo mạch được mô phỏng, kèm theo một ký tự xuống dòng, nên mọi sketch trên trang này chạy trong trình duyệt giống như trên một bo Uno.
Làm cách nào đọc một chuỗi từ serial vào mảng 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".
Tiếp tục nào
Thông tin trên trang này lấy từ đâu
Lắp mạch này ngoài đời
Mở trình soạn thảo, đổi một giá trị và xem con số thay đổi theo. Không cần cài gì, không cần tài khoản.