Öğren

Arduino'da "undefined reference to" hatasını düzeltmek

Başlangıç

Ya da tüm dersleri gör.

  • 526parça tezgahta
  • 46kart şu an çalışıyor
  • 1.00xgerçek zamanlı, her kartta
Arduino Uno: blink, kırılmaya hazırcanlı0.000 s 0.00x
Düzenleyicide açmak için tıkla
Pin 13'te bir LED ve çalışan bir kod. Aç, loop adını Loop yap ve bağlayıcı hatasını görmek için Çalıştır'a bas.

undefined reference to 'loop' bir bağlayıcı hatasıdır. Kod derlendi, sonra derlenen parçaları tek bir programa birleştiren bağlayıcı, programın kullandığı bir adın kodunu bulamadı. setup veya loop için bu, kodda tam olarak o adda bir fonksiyon olmadığı anlamına gelir, genellikle Loop() veya Setup() şeklinde yazıldığı için olur. Kendi fonksiyonun için bu, fonksiyonun bildirildiği ama hiç yazılmadığı ya da bildirimden farklı parametre türleriyle yazıldığı anlamına gelir. Bir kütüphane fonksiyonu için, kütüphanenin .cpp dosyası derlemede yok demektir.

Mokxi, LLVM'nin bağlayıcısıyla bağlar ve bu da bunu undefined symbol: loop() diye ifade eder. Yukarıdaki devre pin 13'te yanıp sönen bir LED. Aç, loop adını Loop yap ve Çalıştır'a bas: derleme undefined symbol: loop() ile durur ve Derleme sekmesi Loop() içeren satırı gösterip "Arduino loop() işlevini çağırır, tam olarak bu biçimde, küçük harflerle yazılır." der.

setup() ya da loop() yok

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.

Boş bir kod ikisiyle de başarısız olur: undefined symbol: setup() ve undefined symbol: loop(). Mokxi'nin Derleme sekmesi iki işlevi adlandırmak yerine "sketch.ino boş, bu yüzden derlenecek bir şey yok" der ve hiç derlenmeyen bir dosya için de aynısını söyler; örneğin Python dediği bir sketch.py için.

Derlenen en küçük kod: iki işlev de var, biri boş
void setup() {
  pinMode(13, OUTPUT);
  digitalWrite(13, HIGH);
}

void loop() {
}

Bu kodu düzenleyicide açSadece kod: düzenleyici, kartı ve koddan okuyabildiği parçaları yerleştirir.

Loop(), Setup() ve benzeri yakın hatalar

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().

Bozuk: Büyük L'li Loop()
void setup() {
  pinMode(13, OUTPUT);
}

void Loop() {
  digitalWrite(13, HIGH);
}

Kendi işlevin: bildirilmiş ama yazılmamış

void blinkTimes(int count); gibi bir bildirim, işlevin bir yerde var olduğunu vaat eder. Çağır ama gövdesini hiç yazma, bağlama başarısız olur: Mokxi'de undefined symbol: blinkTimes(int), GCC'de undefined reference to 'blinkTimes(int)'. Mokxi'nin Derleme sekmesi "blinkTimes kullanılıyor ama kodu derlemedeki hiçbir dosyada yok." der.

Gövde farklı parametre türleriyle oradayken de aynı hata gelir. Bildirim int alırken işlev void blinkTimes(byte count) olarak yazıldığında, C++ kodda iki farklı işlev görmüştü: çağrılan, int alan ve gövdesi olmayan işlev ile kimsenin çağırmadığı bir başka işlev. Bağlama aynı undefined symbol: blinkTimes(int) ile başarısız oldu. Bildirim ile tanımı, sözü sözüne eşleşecek şekilde yaz.

Bildirim ve tanım, eşleşiyor
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);
  }
}

Bu kodu düzenleyicide açSadece kod: düzenleyici, kartı ve koddan okuyabildiği parçaları yerleştirir.

.cpp'si olmayan bir .h, bir extern, bir statik üye

int readSensor(); bildiren ve onu yazan hiçbir .cpp sekmesi olmayan bir sensor.h başlık sekmesi undefined symbol: readSensor() hatası verdi. Başlık dosyası vaattir, .cpp ise koddur: .cpp sekmesini ekle, başına #include <Arduino.h> ve #include "sensor.h" gelsin.

extern int threshold;, değişkenin başka bir dosyada tanımlı olduğunu söyler ve onu hiçbir dosya tanımlamazsa bağlama işlemi undefined symbol: threshold hatasıyla başarısız olur. int threshold = 500; satırını tam olarak bir dosyaya yazın. Ayrıca bir sınıfın içindeki static int total; yalnızca bildirim yapar: bağlama, sınıfın dışındaki int Counter::total = 0; satırı onu tanımlayana kadar undefined symbol: Counter::total hatasıyla başarısız oldu.

Bir .c sekmesi ve extern "C"

Kod dosyası C++'tır ve C++, bağlayıcıya verdiği isme fonksiyonun parametre türlerini ekler. Bir .c sekmesi C olarak derlenir, C bunu yapmaz. Bu yüzden int addTwo(int a, int b) yazan bir mathutil.c ve onu yalnızca bildiren bir mathutil.h sorunsuz derlenir, sonra undefined symbol: addTwo(int, int) hatasıyla başarısız olur. Kod oradadır, düz C adıyla; kod dosyası ise C++ adını ister. Bağlayıcının bir sonraki satırı, >>> referenced by sketch.ino:5, onu çağıran satırı gösterir ve Mokxi'nin Derleme sekmesi "addTwo kullanılıyor ama kodu derlemedeki hiçbir dosyada yok" der.

İki çözüm var ve ikisi de derlendi. Sekmeyi mathutil.cpp olarak yeniden adlandır, böylece iki taraf da C++ olur; ya da aşağıdaki gibi başlık dosyasındaki bildirimleri extern "C" içine al, böylece kod dosyası C adını ister. #ifdef __cplusplus satırlarını koru: C'de extern "C" yoktur ve .c sekmesi aynı başlık dosyasını içerir.

mathutil.h, kod dosyası ve .c sekmesi için ortak
#pragma once

#ifdef __cplusplus
extern "C" {
#endif

int addTwo(int a, int b);

#ifdef __cplusplus
}
#endif

.cpp dosyası derlemeye dahil olmayan bir kütüphane

Bir kütüphane genellikle bir .h ve bir .cpp dosyasından oluşur. Yalnızca .h dosyasını bir koda kopyalarsanız ya da kütüphaneyi elle yanlış klasöre kurarsanız, kod derlense bile kütüphaneye yapılan her çağrı tanımsız referans olur. Arduino IDE'de Kütüphane Yöneticisi'nden ya da Sketch, Include Library, Add .ZIP Library yoluyla kurun. Mokxi'de Add library, kütüphanenin .zip dosyasını ya da .h ve .cpp dosyalarını birlikte alır.

Bu devreyi düzenleyicide aç. Arduino Uno: blink, bozmaya hazır, bu sayfanın üstünde çalıştığı haliyle kablolandı. Bir parçayı veya değeri değiştir ve yeniden çalıştır.

Devreyi aç

Sorular

Arduino'da "undefined reference to setup" ne anlama gelir?

Kodda setup() fonksiyonu yoktur ya da Setup() gibi farklı yazılmıştır. Her kodun, biri boş olsa bile, küçük harflerle yazılmış bir setup() ve bir loop() fonksiyonuna ihtiyacı vardır.

"Undefined reference" bir derleyici hatası mı?

Hayır, bir bağlayıcı hatası. Kod derlendi; bağlayıcı, programa katmak için bir adın kodunu bulamadı. Bu yüzden adını verdiği satır genellikle senin kodunda hiç yoktur.

"Undefined symbol" aynı hata mı?

Evet. "undefined reference to", Arduino IDE'nin kullandığı GCC bağlayıcısının ifadesidir; Mokxi, "undefined symbol" diyen LLVM bağlayıcısıyla bağlar.

Fonksiyonum hemen orada. Neden tanımsız referans oluyor?

Parametreleri muhtemelen en üstteki bildirimden farklı, örneğin birinde byte, diğerinde int. C++ bunları iki farklı fonksiyon sayar. İki satırı eşleştir.

Bunu gerçekten kur

Düzenleyiciyi aç, bir değeri değiştir ve sayının onunla birlikte değiştiğini izle. Kurulacak bir şey yok, hesaba da gerek yok.