Solução de problemas

O sketch não compila

Como ler a aba Compilação e as cinco causas mais comuns.

O que você vê: a aba Compilação

Ela fica embaixo da faixa de arquivos no painel de código. Lista as etapas com seus tempos e, depois, a saída do compilador em linhas clicáveis. Clique em uma linha e o editor salta para aquele arquivo, linha e coluna.

Os diagnósticos são diagnósticos reais do clang, sem edição. Uma posição no seu sketch é uma posição no seu sketch: o arquivo é compilado com o próprio nome, então os números de linha são os seus, e não os de alguma camada intermediária.

Um erro do linker não tem posição. ld.lld: error: undefined symbol: loop() aparece como uma linha sem salto, porque não há para onde saltar.

1. Um include que falta

A causa mais comum, e ela tem um sintoma próprio: o clang para de vez em um cabeçalho ausente. O painel de compilação trata isso como uma compilação com falha e mostra o diagnóstico em vez de relatar uma queda, então procure a linha file not found.

Só os cabeçalhos do seu próprio projeto, os das bibliotecas dele e os do runtime estão lá. A compilação em si não tem rede: ou a biblioteca está no projeto antes de a compilação começar, ou não está de jeito nenhum.

The runtime's own include the stock libraries tutorials use most, under their usual names: Servo.h, Wire.h, SPI.h, EEPROM.h, LiquidCrystal_I2C.h, Adafruit_GFX.h, Adafruit_SSD1306.h, Adafruit_NeoPixel.h, DHT.h, SoftwareSerial.h and TinyGPS++.h (a lista e o que cada uma cobre). Um cabeçalho escrito com outra caixa, como costuma acontecer em sketches escritos no Windows ou num Mac (servo.h, liquidcrystal_i2c.h), is read as the one Mokxi has. For any other library the Build tab names the Mokxi header that does the same job, or offers Install with the library's name: one tap fetches it from the Arduino Library Manager, with the libraries it depends on, puts it in the project and builds again. The Arduino Library Manager search under the code finds any library in the official index by name, header or what it does. A library that does not list your board installs with a warning, and you can still try it. Your own files go in with Add library.

2. Uma função que não existe neste runtime

O runtime é nosso: C e C++ freestanding com a API da referência da linguagem Arduino. Ele traz pinMode, digitalWrite, digitalRead, analogWrite, analogRead, millis, micros, delay, delayMicroseconds, pulseIn, shiftIn, shiftOut, tone, noTone, attachInterrupt, Serial com parseInt e readStringUntil, String, ponto flutuante e a biblioteca matemática, os testes de caracteres, e sprintf com o resto das bibliotecas C que os tutoriais usam, além de drivers compartilhados para os displays e a fita WS2812 (a lista).

Não é a avr-libc, não é o core do Arduino e não é o ESP-IDF, e nenhum deles é baixado na hora da compilação. Uma chamada que resolve num Arduino real pode ainda não existir aqui (analogRead numa placa cujo conversor não é modelado, por exemplo), e a compilação avisará isso.

3. O arquivo errado é o main

Um projeto tem vários arquivos, e um deles é onde o compilador começa. Se você renomeou o sketch, confira se o arquivo que você espera ser o ponto de entrada ainda é.

4. Compilou, mas Rodar executou outra coisa

Três coisas podem acontecer quando você aperta Rodar, e só uma delas é uma compilação:

  • a placa roda um exemplo pronto ou um ELF enviado, e nada é compilado;
  • a placa reutiliza a última compilação, porque nem um byte dos arquivos mudou;
  • a placa é compilada.

Um ELF que você enviou não foi compilado a partir desses arquivos, então ele vence: o programa da placa no painel de propriedades diz ELF enviado enquanto ele estiver lá. Se o simulador o recusar, a mensagem oferece Usar o código, que devolve a placa ao código do editor.

5. Compila na IDE do Arduino, mas não aqui

Duas coisas que a IDE do Arduino faz por um sketch, o Mokxi também faz, então um sketch copiado de um tutorial não tropeça nelas.

  • Funções podem ser chamadas antes de serem definidas. A IDE do Arduino escreve um protótipo para cada função nas abas .ino antes de compilá-las, e o Mokxi faz o mesmo, então loop() pode chamar uma função definida mais abaixo. Várias abas .ino são unidas num único arquivo, a aba principal primeiro, como a IDE as une. Um template de função recebe seu protótipo com sua linha template <typename T> na frente, como a IDE escreve. Algumas funções não recebem protótipo: funções dentro de uma classe ou namespace, um template com um argumento de template padrão, e uma função cujos tipos de parâmetro são declarados mais abaixo no sketch. Para essas, uma chamada acima da definição dá use of undeclared identifier, e a aba Compilação diz em qual linha está a função: mova a função, ou o tipo que ela usa, para acima do código que a chama, ou coloque um protótipo de uma linha como void blinkTwice(); no topo.
  • Avisos não param a compilação. Seus arquivos são compilados com -Wall -Wextra, e a aba Compilação lista o que eles encontram, mas o sketch ainda compila e roda, como acontece na IDE. Uma variável ou parâmetro sem uso e uma comparação entre com e sem sinal (int i < sizeof(pins)) podem esperar. if (x = HIGH) vale a pena corrigir: um único = atribui, então a condição é sempre verdadeira, e você quis dizer ==.

O que sobra costuma ser uma biblioteca que o Mokxi não traz, ou uma função que o runtime daquela placa deixa de fora: seções 1 e 2 acima.

Erros de compilação em palavras simples percorre as mensagens comuns uma a uma, e Arduino compile errors explained as traz tanto nas palavras do GCC quanto nas do clang.

Se a primeira compilação travar

Não está travando, está baixando. O toolchain tem cerca de setenta megabytes de clang e é baixado em streaming uma vez, depois fica no cache do navegador. Os passos na aba Compilação dizem onde ele está. Uma visita de retorno leva cerca de um segundo e meio, e editar e rodar depois disso leva uma fração de segundo. Se o download falhar, veja o editor ou o compilador não carrega.

Ainda travado

Compilar no navegador é o contrato completo: a lista de comandos, as chaves de cache e como o runtime é montado. Ou escreva para nós em /support com o diagnóstico.