Aprender

Como corrigir "undefined reference to" no Arduino

Iniciante

Ou veja todas as aulas.

  • 526componentes na bancada
  • 46placas rodando agora
  • 1.00xtempo real, em todas as placas
Arduino Uno: blink, pronto para quebrarao vivo0.000 s 0.00x
Clique para abrir no editor
Um LED no pino 13 e um sketch funcionando. Abra, renomeie loop para Loop e aperte Rodar para ver o erro do linker.

undefined reference to 'loop' é um erro do linker. O sketch compilou, e então o linker, que junta as partes compiladas em um único programa, não encontrou o código de um nome que o programa usa. Para setup ou loop isso significa que o sketch não tem uma função com exatamente esse nome, muitas vezes porque está escrita Loop() ou Setup(). Para uma função sua, significa que a função foi declarada mas nunca escrita, ou escrita com tipos de parâmetro diferentes dos da declaração. Para uma função de biblioteca, o arquivo .cpp da biblioteca não está na compilação.

O Mokxi faz a ligação com o linker do LLVM, que formula o erro como undefined symbol: loop(). O circuito acima é um LED piscando no pino 13. Abra, renomeie loop para Loop e aperte Rodar: a compilação para com undefined symbol: loop(), e a aba de compilação aponta a linha que tem Loop() e diz "O Arduino chama loop(), escrito exatamente assim, em minúsculas."

Sem setup() ou sem 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.

Um sketch vazio falha com os dois: undefined symbol: setup() e undefined symbol: loop(). A aba de compilação do Mokxi diz "sketch.ino está vazio, então não há nada para compilar" em vez de citar as duas funções, e o mesmo vale para um arquivo que não é compilado, como um sketch.py, que ela chama de Python.

O menor sketch que compila: as duas funções, uma delas vazia
void setup() {
  pinMode(13, OUTPUT);
  digitalWrite(13, HIGH);
}

void loop() {
}

Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.

Loop(), Setup() e outros erros 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().

Quebrado: Loop() com L maiúsculo
void setup() {
  pinMode(13, OUTPUT);
}

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

Função sua: declarada, mas não escrita

Uma declaração como void blinkTimes(int count); promete que a função existe em algum lugar. Chame-a e nunca escreva o corpo, e a ligação falha: undefined symbol: blinkTimes(int) no Mokxi, undefined reference to 'blinkTimes(int)' no GCC. A aba de compilação do Mokxi diz "blinkTimes é usada, mas o código dela não está em nenhum arquivo da compilação."

O mesmo erro acontece quando o corpo existe com tipos de parâmetro diferentes. Com a declaração recebendo um int e a função escrita como void blinkTimes(byte count), o sketch tinha, para o C++, duas funções diferentes: a que foi chamada, que recebe um int e não tem corpo, e outra que ninguém chamou. A ligação falhou com o mesmo undefined symbol: blinkTimes(int). Faça a declaração e a definição coincidirem, palavra por palavra.

A declaração e a definição, coincidindo
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 no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.

Um .h sem .cpp, um extern, um membro static

Uma aba de cabeçalho sensor.h que declara int readSensor();, sem uma aba .cpp que a escreva, deu undefined symbol: readSensor(). O cabeçalho é a promessa e o .cpp é o código: adicione a aba .cpp, começando com #include <Arduino.h> e #include "sensor.h".

extern int threshold; diz que a variável é definida em outro arquivo, e se nenhum arquivo a definir a ligação falha com undefined symbol: threshold. Escreva int threshold = 500; em exatamente um arquivo. E um static int total; dentro de uma classe apenas a declara: a ligação falhou com undefined symbol: Counter::total até que uma linha fora da classe, int Counter::total = 0;, a definisse.

Uma aba .c e extern "C"

Um sketch é C++, e o C++ adiciona ao nome que ele entrega ao linker os tipos dos parâmetros da função. Uma aba .c é compilada como C, que não faz isso. Então um mathutil.c que escreve int addTwo(int a, int b), com um mathutil.h que apenas a declara, compila sem erros e depois falha com undefined symbol: addTwo(int, int). O código está lá com seu nome C simples, e o sketch pede o nome C++. A linha seguinte do linker, >>> referenced by sketch.ino:5, indica a linha que a chama, e a aba de compilação do Mokxi diz "addTwo é usada, mas seu código não está em nenhum arquivo da compilação."

Há duas correções, e ambas compilaram. Renomeie a aba para mathutil.cpp, assim os dois lados são C++, ou envolva as declarações do cabeçalho em extern "C", como abaixo, para que o sketch peça o nome C. Mantenha as linhas #ifdef __cplusplus: C não tem extern "C", e a aba .c inclui o mesmo cabeçalho.

mathutil.h, para um sketch e uma aba .c igualmente
#pragma once

#ifdef __cplusplus
extern "C" {
#endif

int addTwo(int a, int b);

#ifdef __cplusplus
}
#endif

Uma biblioteca cujo .cpp não está na compilação

Uma biblioteca costuma ser um .h e um .cpp. Copiar só o .h para um sketch, ou instalar uma biblioteca manualmente na pasta errada, faz com que toda chamada a ela seja uma referência indefinida, mesmo que o sketch compile. No Arduino IDE, instale-a pelo Gerenciador de Bibliotecas ou com Sketch, Incluir Biblioteca, Adicionar Biblioteca .ZIP. No Mokxi, Adicionar biblioteca aceita o .zip da biblioteca, ou os arquivos .h e .cpp juntos.

Abra este circuito no editor. Arduino Uno: blink, pronto para quebrar, ligado como roda no topo desta página. Troque um componente ou um valor e rode de novo.

Abrir o circuito

Perguntas

O que significa "undefined reference to setup" no Arduino?

O sketch não tem uma função setup(), ou tem uma escrita de forma diferente, como Setup(). Todo sketch precisa de um setup() e um loop() em letras minúsculas, mesmo que um deles fique vazio.

"undefined reference" é um erro do compilador?

Não, é um erro do linker. O código compilou; o linker não conseguiu encontrar o código de um nome para juntar ao programa. Por isso a linha que ele indica muitas vezes nem está no seu sketch.

"undefined symbol" é o mesmo erro?

Sim. "undefined reference to" é a forma usada pelo linker do GCC, que o Arduino IDE usa; o Mokxi liga com o linker do LLVM, que diz "undefined symbol".

Minha função está bem aí. Por que é uma referência indefinida?

Provavelmente os parâmetros dela diferem da declaração no topo, como byte em uma e int na outra. O C++ trata essas como duas funções diferentes. Faça as duas linhas coincidirem.

Monte isto de verdade

Abra o editor, mude um valor e veja o número mudar junto. Nada para instalar, e não precisa de conta.