Aprender

Cómo corregir "undefined reference to" en Arduino

Principiante

O mira todas las lecciones.

  • 526componentes en el banco de trabajo
  • 46placas funcionando ahora
  • 1.00xtiempo real, en todas las placas
Arduino Uno: parpadeo, listo para romperen vivo0.000 s 0.00x
Haz clic para abrirlo en el editor
Un LED en el pin 13 y un sketch que funciona. Ábrelo, renombra loop a Loop, y presiona Ejecutar para ver el error del enlazador.

undefined reference to 'loop' es un error del enlazador. El sketch compiló y luego el enlazador, que une las piezas compiladas en un solo programa, no pudo encontrar el código de un nombre que el programa usa. En el caso de setup o loop significa que el sketch no tiene ninguna función con exactamente ese nombre, a menudo porque está escrita Loop() o Setup(). Para una función tuya significa que la función fue declarada pero nunca escrita, o escrita con tipos de parámetros distintos a los de la declaración. Para una función de una biblioteca, el archivo .cpp de la biblioteca no está en la compilación.

Mokxi enlaza con el enlazador de LLVM, que lo redacta undefined symbol: loop(). El circuito de arriba es un LED parpadeando en el pin 13. Ábrelo, renombra loop a Loop y presiona Ejecutar: la compilación se detiene con undefined symbol: loop(), y la pestaña de compilación señala la línea que tiene Loop() y dice "Arduino llama a loop(), escrito exactamente así, en minúsculas."

Falta setup() o falta 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.

Un sketch vacío falla con ambos: undefined symbol: setup() y undefined symbol: loop(). La pestaña de compilación de Mokxi dice "sketch.ino está vacío, así que no hay nada que compilar" en lugar de nombrar las dos funciones, y lo mismo para un archivo que no se compila en absoluto, como un sketch.py, al que llama Python.

El sketch más pequeño que compila: ambas funciones, una de ellas vacía
void setup() {
  pinMode(13, OUTPUT);
  digitalWrite(13, HIGH);
}

void loop() {
}

Abrir este sketch en el editorSolo el código: el editor coloca la placa y los componentes que puede leer del sketch.

Loop(), Setup() y otros casos parecidos

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

Roto: Loop() con L mayúscula
void setup() {
  pinMode(13, OUTPUT);
}

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

Tu propia función: declarada, pero no escrita

Una declaración como void blinkTimes(int count); promete que la función existe en algún lugar. Llámala y nunca escribas el cuerpo, y el enlazado falla: undefined symbol: blinkTimes(int) en Mokxi, undefined reference to 'blinkTimes(int)' de GCC. La pestaña de compilación de Mokxi dice "blinkTimes se usa, pero su código no está en ningún archivo de la compilación."

El mismo error aparece cuando el cuerpo está con tipos de parámetros distintos. Con la declaración que recibe un int y la función escrita como void blinkTimes(byte count), para C++ el sketch tenía dos funciones diferentes: la que llamaba, que recibe un int y no tiene cuerpo, y otra que nadie llamaba. El enlazado falló con el mismo undefined symbol: blinkTimes(int). Haz que la declaración y la definición coincidan, palabra por palabra.

La declaración y la definición, coincidiendo
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);
  }
}

Abrir este sketch en el editorSolo el código: el editor coloca la placa y los componentes que puede leer del sketch.

Un .h sin .cpp, un extern, un miembro static

Una pestaña de header sensor.h que declara int readSensor();, sin ninguna pestaña .cpp que la escriba, dio undefined symbol: readSensor(). El header es la promesa y el .cpp es el código: agrega la pestaña .cpp, empezando con #include <Arduino.h> y #include "sensor.h".

extern int threshold; indica que la variable está definida en otro archivo, y si ningún archivo la define, el enlazado falla con undefined symbol: threshold. Escribe int threshold = 500; en exactamente un archivo. Y un static int total; dentro de una clase solo la declara: el enlazado falló con undefined symbol: Counter::total hasta que una línea fuera de la clase, int Counter::total = 0;, la definió.

Una pestaña .c y extern "C"

Un sketch es C++, y C++ agrega los tipos de los parámetros de una función al nombre que le entrega al enlazador. Una pestaña .c se compila como C, que no lo hace. Así que un mathutil.c que escribe int addTwo(int a, int b), con un mathutil.h que solo la declara, compila sin errores y luego falla con undefined symbol: addTwo(int, int). El código está ahí con su nombre C sencillo, y el sketch pide el de C++. La línea siguiente del enlazador, >>> referenced by sketch.ino:5, señala la línea que la llama, y la pestaña de compilación de Mokxi dice "addTwo se usa, pero su código no está en ningún archivo de la compilación."

Hay dos soluciones, y ambas compilaron. Renombra la pestaña a mathutil.cpp, para que ambos lados sean C++, o envuelve las declaraciones del header en extern "C", como abajo, para que el sketch pida el nombre de C. Conserva las líneas #ifdef __cplusplus: C no tiene extern "C", y la pestaña .c incluye el mismo header.

mathutil.h, para un sketch y una pestaña .c por igual
#pragma once

#ifdef __cplusplus
extern "C" {
#endif

int addTwo(int a, int b);

#ifdef __cplusplus
}
#endif

Una biblioteca cuyo .cpp no está en la compilación

Una biblioteca suele ser un .h y un .cpp. Si copias solo el .h a un sketch, o instalas una biblioteca a mano en la carpeta equivocada, cada llamada a ella es una referencia sin definir, aunque el sketch compile. En el Arduino IDE, instálala desde el Gestor de bibliotecas o con Sketch, Include Library, Add .ZIP Library. En Mokxi, Agregar biblioteca acepta el .zip de la biblioteca, o sus archivos .h y .cpp juntos.

Abre este circuito en el editor. Arduino Uno: blink, listo para romperse, cableado tal como corre en la parte superior de esta página. Cambia un componente o un valor y ejecútalo de nuevo.

Abrir el circuito

Preguntas

¿Qué significa "undefined reference to setup" en Arduino?

El sketch no tiene una función setup(), o tiene una escrita distinto, como Setup(). Todo sketch necesita un setup() y un loop() en minúsculas, aunque uno esté vacío.

¿"undefined reference" es un error del compilador?

No, es un error del enlazador. El código compiló; el enlazador no pudo encontrar el código de un nombre para unirlo al programa. Por eso la línea que menciona muchas veces ni siquiera está en tu sketch.

¿"undefined symbol" es el mismo error?

Sí. "undefined reference to" es el texto del enlazador de GCC, que usa el Arduino IDE; Mokxi enlaza con el enlazador de LLVM, que dice "undefined symbol".

Mi función está justo ahí. ¿Por qué es una referencia sin definir?

Probablemente sus parámetros difieren de la declaración de arriba, por ejemplo byte en una y int en la otra. C++ las trata como dos funciones distintas. Haz que las dos líneas coincidan.

Ármalo en la vida real

Abre el editor, cambia un valor y mira cómo cambia el número con él. Nada que instalar y sin necesidad de cuenta.