Sửa lỗi "undefined reference to" trong Arduino
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
undefined reference to 'loop' là lỗi linker. Sketch đã biên dịch xong, nhưng linker, bộ phận ghép các phần đã biên dịch thành một chương trình, không tìm thấy code cho một tên mà chương trình dùng. Với setup hoặc loop, nghĩa là sketch không có hàm nào mang đúng tên đó, thường vì nó bị viết thành Loop() hoặc Setup(). Với hàm do bạn tự viết, nghĩa là hàm đã được khai báo nhưng chưa được viết thân hàm, hoặc viết với kiểu tham số khác với phần khai báo. Với hàm thư viện, file .cpp của thư viện không có trong bản build.
Mokxi liên kết bằng linker của LLVM, diễn đạt thành undefined symbol: loop(). Mạch phía trên là một LED nhấp nháy ở chân 13. Mở nó, đổi tên loop thành Loop rồi nhấn Chạy: bản build dừng lại với undefined symbol: loop(), và bảng biên dịch chỉ ra dòng có Loop() kèm thông báo "Arduino gọi loop(), viết đúng như vậy, viết thường."
Thiếu setup() hoặc thiếu loop()
The Arduino core has the program’s real starting point, main(), and it calls setup() once and then loop() forever. So every sketch needs both, even when one of them has nothing to do. Leave one out and nothing is wrong in the sketch itself, which is why the compiler is happy and the linker is not. A sketch with only setup() stopped with undefined symbol: loop(), and the build tab said "The sketch has no loop() function. Every Arduino sketch needs both setup() and loop()." An empty void loop() { } is enough.
Sketch rỗng bị lỗi cả hai: undefined symbol: setup() và undefined symbol: loop(). Bảng biên dịch của Mokxi ghi "sketch.ino trống, nên không có gì để build" thay vì nêu tên hai hàm, và tương tự với một file không được build chút nào, chẳng hạn sketch.py, được nó gọi là Python.
void setup() {
pinMode(13, OUTPUT);
digitalWrite(13, HIGH);
}
void loop() {
}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.
Loop(), Setup() và các cách viết gần đúng khác
The names have to match exactly, lower case included. void Loop() is a perfectly good function that nothing calls, so the sketch compiles and the link fails. In a sketch with void Loop() on line 5, Mokxi’s build tab said "sketch.ino line 5 has Loop(), but Arduino calls loop(), spelled exactly that way in lower case. Rename Loop to loop." The same goes for setUp(), Setup() and void loop1().
void setup() {
pinMode(13, OUTPUT);
}
void Loop() {
digitalWrite(13, HIGH);
}Hàm tự viết: đã khai báo nhưng chưa viết
Một khai báo như void blinkTimes(int count); hứa hẹn rằng hàm tồn tại ở đâu đó. Gọi nó mà không bao giờ viết thân hàm thì liên kết thất bại: undefined symbol: blinkTimes(int) trong Mokxi, undefined reference to 'blinkTimes(int)' từ GCC. Bảng biên dịch của Mokxi ghi "blinkTimes được dùng, nhưng code của nó không nằm trong file nào của bản build."
Cùng lỗi này cũng xảy ra khi thân hàm có nhưng kiểu tham số khác. Với khai báo nhận một int mà hàm được viết là void blinkTimes(byte count), theo C++ sketch có hai hàm khác nhau: hàm được gọi, nhận int và không có thân hàm, và một hàm khác không ai gọi. Liên kết thất bại với cùng lỗi undefined symbol: blinkTimes(int). Hãy để phần khai báo và phần định nghĩa khớp nhau từng chữ một.
void blinkTimes(int count);
void setup() {
pinMode(13, OUTPUT);
blinkTimes(3);
}
void loop() {
}
void blinkTimes(int count) {
for (int i = 0; i < count; i++) {
digitalWrite(13, HIGH);
delay(200);
digitalWrite(13, LOW);
delay(200);
}
}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.
File .h thiếu .cpp, extern, biến static thành viên
Một tab header sensor.h khai báo int readSensor();, mà không có tab .cpp nào viết nó, gây ra undefined symbol: readSensor(). Header là lời hứa còn .cpp là code: hãy thêm tab .cpp, bắt đầu bằng #include <Arduino.h> và #include "sensor.h".
extern int threshold; nói rằng biến này được định nghĩa ở một tệp khác, và nếu không tệp nào định nghĩa nó thì lúc liên kết sẽ lỗi undefined symbol: threshold. Hãy viết int threshold = 500; ở đúng một tệp. Còn static int total; nằm trong một class chỉ là khai báo: lúc liên kết bị lỗi undefined symbol: Counter::total cho đến khi có một dòng bên ngoài class, int Counter::total = 0;, định nghĩa nó.
Một tab .c và extern "C"
Sketch là C++, và C++ thêm kiểu tham số của hàm vào tên mà nó đưa cho linker. Một tab .c được biên dịch như C, thứ không làm vậy. Vì thế một mathutil.c viết int addTwo(int a, int b), kèm mathutil.h chỉ khai báo hàm, sẽ biên dịch sạch sẽ rồi lỗi undefined symbol: addTwo(int, int). Code vẫn nằm đó dưới tên C thuần, còn sketch lại hỏi tên C++. Dòng tiếp theo của linker, >>> referenced by sketch.ino:5, chỉ ra dòng gọi hàm đó, và bảng biên dịch của Mokxi ghi "addTwo được dùng, nhưng code của nó không nằm trong tệp nào của bản build."
Có hai cách sửa, và cả hai đều build được. Đổi tên tab thành mathutil.cpp, để cả hai phía đều là C++, hoặc bọc các khai báo trong header bằng extern "C", như bên dưới, để sketch hỏi tên C. Giữ nguyên các dòng #ifdef __cplusplus: C không có extern "C", và tab .c cũng include cùng header đó.
#pragma once
#ifdef __cplusplus
extern "C" {
#endif
int addTwo(int a, int b);
#ifdef __cplusplus
}
#endifMột thư viện có .cpp không nằm trong bản build
Một thư viện thường gồm một .h và một .cpp. Nếu chỉ chép .h vào sketch, hoặc cài thư viện thủ công sai thư mục, thì mọi lời gọi vào nó đều là undefined reference, dù sketch vẫn biên dịch được. Trong Arduino IDE, hãy cài từ Library Manager hoặc qua Sketch, Include Library, Add .ZIP Library. Trong Mokxi, Add library nhận .zip của thư viện, hoặc cả hai tệp .h và .cpp cùng nhau.
Mở mạch này trong trình soạn thảo. Arduino Uno: nhấp nháy LED, sẵn sàng để hỏng, được nối dây như khi chạy ở đầu trang này. Thay một linh kiện hoặc một giá trị rồi chạy lại.
Mở mạchCâu hỏi
"undefined reference to setup" trong Arduino nghĩa là gì?
Sketch không có hàm setup(), hoặc có nhưng viết sai chính tả, ví dụ Setup(). Mọi sketch đều cần một setup() và một loop() viết thường, kể cả khi một trong hai rỗng.
"undefined reference" có phải lỗi của trình biên dịch không?
Không, đây là lỗi của linker. Code đã biên dịch xong; linker không tìm thấy code cho một tên nào đó để nối vào chương trình. Vì thế dòng mà nó chỉ ra thường không nằm trong sketch của bạn.
"undefined symbol" có phải cùng một lỗi không?
Có. "undefined reference to" là cách nói của linker trong GCC, mà Arduino IDE dùng; Mokxi liên kết bằng linker của LLVM, thứ ghi là "undefined symbol".
Hàm của tôi viết ngay ở đó. Sao vẫn undefined reference?
Có lẽ tham số của nó khác với phần khai báo ở trên, ví dụ byte ở một nơi và int ở nơi kia. C++ coi đó là hai hàm khác nhau. Hãy sửa cho hai dòng khớp nhau.
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.