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
.inoantes de compilá-las, e o Mokxi faz o mesmo, entãoloop()pode chamar uma função definida mais abaixo. Várias abas.inosã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 linhatemplate <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 comovoid 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.