Cách gỡ lỗi code Arduino, từ lệnh in Serial đến breakpoint
Cơ bản
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
Arduino không có màn hình, nên khi sketch hoạt động sai bạn không thể thấy nó đang nghĩ gì. Uno và Nano cổ điển cũng không thể chạy từng dòng trong Arduino IDE: trình gỡ lỗi của IDE chỉ hỗ trợ một số bo mạch mới hơn, chứ không hỗ trợ các bo AVR mà phần lớn lớp học và bộ kit dùng. Vì vậy hầu hết mọi người gỡ lỗi bằng Serial.print, và nó hiệu quả một khi bạn dùng nó có chủ đích.
Trang này là một phương pháp thu hẹp lỗi, sau đó là ba công cụ: in, vẽ đồ thị, và dừng bo mạch tại một dòng. Mạch phía trên là một Uno với biến trở ở A0 và LED ở chân 9, đủ để minh họa cả ba, kể cả một lỗi thật chỉ xảy ra trên Uno.
Thu nhỏ lỗi trước khi săn nó
Viết ra điều bạn mong đợi và điều đã xảy ra, mỗi thứ một câu. "LED phải sáng dần khi tôi xoay núm, mà nó sáng, rồi tối, rồi lại sáng" là một lỗi có thể kiểm tra; "nó không chạy" thì không.
Sau đó thu nhỏ vấn đề. Kiểm tra dây nối theo số chân trong code trước, vì cách đó bắt được phần lớn lỗi. Đóng chú thích mọi phần không liên quan, hoặc copy phần nghi ngờ sang một sketch mới. Thay đổi mỗi lần một thứ rồi chạy lại. Một lỗi còn sót lại trong mười dòng là lỗi bạn sẽ tìm ra; cùng lỗi đó trong ba trăm dòng chỉ là phỏng đoán.
Serial.print, dùng có chủ đích
Khởi động cổng trong setup() bằng Serial.begin, và trên bo mạch thật đặt Serial Monitor cùng tốc độ baud, nếu không bạn sẽ nhận được ký tự rác. In một dòng gì đó ở cuối setup(). Nếu dòng đó xuất hiện đi xuất hiện lại, bo mạch đang bị reset, thường có nghĩa là một động cơ hoặc servo đang kéo sụt nguồn.
Gắn nhãn cho mọi giá trị, ví dụ button: pressed thay vì một 0 trơ trọi. In khi có gì đó thay đổi, chứ không phải mỗi vòng lặp loop(), vì thế sẽ tràn Serial Monitor nhanh quá không đọc kịp. Và bọc các lệnh in trong một macro, để có thể tắt chúng ở một chỗ thay vì xóa đi gõ lại khi lỗi quay trở lại.
#define DEBUG 1
#if DEBUG
#define DEBUG_PRINT(x) Serial.print(x)
#define DEBUG_PRINTLN(x) Serial.println(x)
#else
#define DEBUG_PRINT(x)
#define DEBUG_PRINTLN(x)
#endif
const int BUTTON_PIN = 2;
int lastState = HIGH;
void setup() {
Serial.begin(115200);
pinMode(BUTTON_PIN, INPUT_PULLUP);
DEBUG_PRINTLN("setup done"); // printed again on every reset
}
void loop() {
int state = digitalRead(BUTTON_PIN);
if (state != lastState) { // print on a change, not on every pass
DEBUG_PRINT("button: ");
DEBUG_PRINTLN(state == LOW ? "pressed" : "released");
lastState = state;
}
}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.
In cũng tốn thời gian
Mỗi ký tự mất khoảng một mili-giây để gửi ở 9600 baud, nên một dòng 20 ký tự tốn khoảng 20 mili-giây. Uno thật giấu 64 byte đầu trong bộ đệm phát, nhưng sketch in mỗi vòng lặp sẽ làm đầy nó nhanh chóng và sau đó phải chờ từng ký tự. Dùng 115200 baud, nhanh gấp mười hai lần, và in ít hơn.
Đây cũng là lý do thêm một lệnh in đôi khi khiến lỗi biến mất. Nếu làm chậm sketch lại mà hết lỗi, thì lỗi liên quan đến thời điểm: đọc nút nhấn quá nhanh, đọc cảm biến trước khi nó sẵn sàng, hoặc một ngắt đua với vòng lặp chính. Đó là một manh mối, không phải cách sửa. Đừng bao giờ in bên trong trình xử lý ngắt; đặt một cờ ở đó và in từ loop().
Một ví dụ mẫu: giá trị trung bình bị âm
Đây là một lỗi thật. Sketch lấy trung bình 64 lần đọc biến trở để làm mượt chúng. Với mạch điều chỉnh độ sáng phía trên và núm ở 100, nó in total:6400 average:100, đúng vậy. Xoay núm về giữa, 512, nó in total:-32768 average:-512. Ở đầu trên, 1023, nó in total:-64 average:-1.
Các lệnh in làm nguyên nhân hiện rõ: tổng bị sai, nên việc lấy trung bình không phải vấn đề. Trên Uno một int là 16 bit và chứa tối đa 32.767, mà 64 lần đọc 1023 cộng lại thành 65.472, nên tổng bị tràn sang âm. Cùng sketch đó chạy đúng trên ESP32, nơi int là 32 bit, đây chính là loại khác biệt khiến một lỗi trông như ngẫu nhiên. Cách sửa là long total = 0;. Nếu không in tổng, bạn sẽ chỉ thấy trung bình sai và nhiều khả năng sẽ tìm sai chỗ.
const int SENSOR_PIN = A0;
void setup() {
Serial.begin(115200);
}
void loop() {
int total = 0; // the bug: make this long
for (int i = 0; i < 64; i++) {
total += analogRead(SENSOR_PIN);
}
Serial.print("total:");
Serial.print(total);
Serial.print(" average:");
Serial.println(total / 64);
delay(250);
}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.
Vẽ đồ thị thay vì đọc số
Một giá trị thay đổi theo thời gian dễ đánh giá hơn khi là một đường. Serial Plotter của Arduino IDE và tab Plot của Mokxi đọc cùng một định dạng: các số trên một dòng ngăn cách bằng dấu cách hoặc dấu phẩy, mỗi số có thể gắn nhãn dạng name:value. Ví dụ mẫu phía trên đã in theo dạng đó rồi, nên mở tab Plot và xoay núm, bạn có thể xem tổng bị gập sang số âm ở điểm giữa.
In một ngưỡng cạnh giá trị đọc, dạng reading:512 threshold:600, vẽ ngưỡng thành một đường nằm phẳng, nên bạn thấy rõ thời điểm một cảm biến vượt qua nó và độ nhiễu của nó gần mép. Điều đó trả lời câu hỏi "sao đèn của tôi chớp tắt chớp sáng lúc chạng vạng" chỉ trong một cái nhìn.
Dừng bo mạch tại một dòng
Trong Mokxi bạn có thể dừng mọi bo mạch bằng một breakpoint, kể cả Uno, vì chip được mô phỏng chứ không nối qua USB. Nhấp vào rãnh bên trái của số dòng, một chấm đỏ xuất hiện; nhấn Chạy, và bo mạch dừng trước khi dòng đó chạy. Cả mạch dừng theo, nên LED giữ nguyên độ sáng và millis() không nhảy khi bạn đang quan sát.
Tab Debug sau đó cho thấy bo mạch dừng ở đâu, các thanh ghi, và danh sách theo dõi cho biến toàn cục. Step over chạy từng dòng một. Danh sách theo dõi chỉ đọc được biến toàn cục, nên khi gỡ lỗi, có thể hữu ích nếu đặt biến bạn quan tâm thành biến toàn cục. Trên ESP32 và ESP8266, Tạm dừng và danh sách theo dõi hoạt động, nhưng breakpoint thì không, vì trình biên dịch trong trình duyệt không build được cho hai chip đó. Ví dụ breakpoint bên dưới hướng dẫn từng bước trên ESP32-C3.
Mở mạch này trong trình soạn thảo. Arduino Uno: một chiết áp và một LED, nối dây như mạch đang chạy ở đầu trang này. Đổi một linh kiện hoặc một giá trị rồi chạy lại.
Mở mạchCâu hỏi
Có thể gỡ lỗi Arduino Uno bằng breakpoint không?
Không bằng trình gỡ lỗi của Arduino IDE, vốn không hỗ trợ các bo mạch AVR. ATmega328P có giao diện gỡ lỗi một dây, debugWIRE, nhưng cần một trình gỡ lỗi phần cứng riêng. Trong Mokxi, breakpoint hoạt động trực tiếp trên Uno được mô phỏng.
Tại sao Serial Monitor của tôi hiện ký tự lỗi?
Trên bo mạch thật, baud rate của monitor không khớp với Serial.begin. Đặt cả hai cùng một số, ví dụ 115200.
Tại sao thêm Serial.print lại làm lỗi biến mất?
In ra làm sketch chậm đi, nên lỗi phụ thuộc vào thời điểm: một lệnh đọc xảy ra quá sớm, thiếu chống rung, hoặc một biến dùng chung với ngắt.
Nên để các lệnh in gỡ lỗi trong sketch hoàn thiện không?
Nên tắt chúng thay vì xóa, dùng một macro DEBUG như ở trên. Khi bật, chúng tốn thời gian và bộ nhớ; khi tắt thì không tốn gì.
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.