Solução de problemas

Erros de compilação em palavras simples

As mensagens do compilador que as pessoas mais encontram no Mokxi, o que cada uma significa, e o que mudar.

O que você vê

The Build tab under the code shows the compiler's own words. Click a line and the editor jumps to it. The line it names is where the compiler noticed, which is sometimes one line after the real mistake. Mokxi AI's Why won't this compile? and Fix it explain and fix the one in front of you (Mokxi AI). Como a compilação funciona está em código e compilação.

Encontre o primeiro erro na aba Compilação abaixo. Corrija esse primeiro: um erro costuma causar vários erros depois dele.

Chaves, colchetes e ponto e vírgula

  • expected ';' after expression, expected ';' at end of declaration, expected ';' after top level declarator. Está faltando o ;. Adicione-o no fim da linha indicada, ou da linha logo acima.
  • expected ';' after struct. A struct ou class deve terminar com };.
  • expected '}'. A { foi aberto e nunca fechado. O } que falta está geralmente no fim de loop() ou de um if dentro dele. Coloque o cursor ao lado de uma chave e o editor mostra seu par.
  • extraneous closing brace ('}'). Um } a mais. Apague-o.
  • function definition is not allowed here. A função acima nunca foi fechada, então esta começa dentro dela. Adicione o } que falta acima.
  • expected ')'. A ( não está fechado. Conte os colchetes nessa linha.
  • expected '(' after 'if'. O C++ exige colchetes em volta de uma condição: if (x > 5), e não if x > 5.
  • expected function body after function declarator. Um cabeçalho como void setup() não vem seguido de {.

Código fora de uma função

  • expected unqualified-id. Algo fora de todas as funções que o C++ não consegue ler: uma palavra solta, uma ``` cerca ou um "Copy code" colado junto com o sketch, ou uma linha que pertence a setup() ou loop(). Apague o texto solto.
  • a type specifier is required for all declarations, unknown type name 'Serial', while loop outside of a function. Uma chamada ou um loop está fora de todas as funções. Mova para setup() (uma vez) ou loop() (repetidamente).
  • unknown type name 'cpp'. A primeira linha é um rótulo copiado de um chat ou de uma página da web. Apague-o, junto com qualquer linha "Copy code" e as ``` cercas.
  • unknown type name 'from' ou 'import'. O arquivo é Python, e o sketch é compilado como C++ do Arduino. A aba Compilação avisa isso primeiro: "Este sketch é MicroPython, não C++ do Arduino". O Raspberry Pi Pico, o Pico W e as placas ESP32 (DevKit V1, DevKitC, LOLIN32 Lite, ESP32-S3, ESP32-C3 e ESP32-C6) executam MicroPython: escolha MicroPython (main.py) no painel Firmware da placa e mova o código para main.py, ou aperte Rodar como MicroPython abaixo do erro para fazer as duas coisas. Uma placa com a aba main.py e sem .ino executa MicroPython. Em qualquer outra placa, escreva o programa em C++. Veja MicroPython on the ESP32 e a Pico.
  • invalid preprocessing directive. Uma linha começa com # e uma palavra que o C++ não conhece: #incude para #include, por exemplo. Corrija a grafia.
  • invalid suffix 'https' on integer constant. Um texto colado junto com o código acabou dentro de uma linha. Apague-o, ou coloque // na frente dele.

Nomes

  • undefined symbol: setup() ou undefined symbol: loop(). Todo sketch precisa de ambos void setup() { } e void loop() { }, escritos exatamente assim, mesmo quando vazios. Um arquivo vazio também recebe este erro.
  • use of undeclared identifier 'serial'; did you mean 'Serial'?. Os nomes diferenciam maiúsculas de minúsculas. Use a grafia sugerida em "você quis dizer".
  • use of undeclared identifier 'output'. As constantes do Arduino são escritas em maiúsculas: OUTPUT, INPUT, INPUT_PULLUP, HIGH, LOW.
  • use of undeclared identifier 'LED_PIN'. O nome nunca é definido, muitas vezes porque as primeiras linhas de um tutorial não foram copiadas. Adicione const int LED_PIN = 13; acima de setup(). Uma variável usada por ambos setup() e loop() vai acima dos dois.
  • undefined symbol: blinkTwice(). Uma função é chamada mas nunca foi escrita, está escrita de outro jeito, ou foi escrita dentro de outra função. Escreva-a no nível principal do sketch.
  • redefinition of 'setup'. Dois sketches colados em um arquivo, ou setup() em duas abas. Mantenha um setup() e um loop() e junte os corpos deles.
  • redefinition of '...' as different kind of symbol. Uma variável tem o nome de algo que a placa já tem. Renomeie a variável.
  • cannot combine with previous 'int' declaration specifier. Dois tipos juntos, como int int. Mantenha um.

Chamadas que não encaixam

  • no matching function for call to 'pinMode'. pinMode recebe o pino e o modo: pinMode(13, OUTPUT). Um pino entre aspas é texto, não um número.
  • no matching member function for call to 'println'. Serial.println imprime um valor. Imprima cada um com seu próprio Serial.print.
  • no member named 'display' in .... Essa biblioteca não tem nenhuma chamada com esse nome: o sketch foi escrito para outra biblioteca ou versão. Bibliotecas incluídas no painel de código lista as chamadas de cada biblioteca.
  • expression is not assignable. Algo que não é uma variável está à esquerda de =, como em digitalRead(2) = HIGH. Para comparar, use ==.
  • excess elements in array initializer. Mais valores entre as chaves do que o tamanho entre os colchetes. Deixe os colchetes vazios: int pins[] = {2, 3, 4};
  • member reference base type 'const char *' is not a structure or union. Texto puro não tem .length(). Use strlen(text), ou transforme em String.

Arquivos e bibliotecas ausentes

  • 'Something.h' file not found. O Mokxi não tem essa biblioteca incluída. A aba Compilação indica a biblioteca incluída que faz o mesmo papel, ou oferece Instalar do Gerenciador de Bibliotecas do Arduino. Veja o sketch não compila.

  • 'config.h' file not found, ou 'secrets.h', 'arduino_secrets.h', 'credentials.h' (um nome entre aspas, ou um arquivo de configuração entre sinais de menor e maior). O projeto original tinha esse arquivo como uma aba própria no IDE do Arduino, muitas vezes com o nome e a senha do WiFi ou um token mantidos fora do código, e ele não foi copiado junto. Adicione um arquivo com esse nome exato ao seu projeto (o + ao lado das abas), ou aperte Adicionar uma aba secrets.h abaixo do erro. A nova aba tem um #define com um valor de exemplo para cada configuração que o sketch usa e nunca define (como SECRET_SSID, WIFI_PASSWORD ou BOT_TOKEN); um nome e uma senha de WiFi começam como os da rede simulada, Mokxi-Lab e breadboard. Coloque seus próprios valores nos demais. Se o projeto tem o arquivo com outra capitalização (Secrets.h), o botão muda o #include para corresponder.

  • 'wokwi-api.h' file not found, ou o aviso chip.c is a Wokwi custom chip. Esse código é de um chip personalizado do Wokwi, não faz parte do sketch da placa: um chip é compilado separadamente. O Mokxi deixa uma aba assim fora da compilação da placa. Para rodar o chip, importe o projeto de novo com o <name>.chip.json, ou crie um com Mais, Novo chip personalizado e cole o código no .chip.c. Veja chips personalizados.

  • 'WiFi.h' file not found em uma Pico, ou 'WiFiS3.h' em uma Uno. Essa placa não tem WiFi. Escolha a Pico W, uma placa ESP32 ou a UNO R4 WiFi.

  • This board has no simulated network in Mokxi de uma biblioteca de rede como WebSocketsClient.h ou PubSubClient.h. Essa placa não tem WiFi. Escolha uma placa ESP32, a ESP8266, a Pico W ou a UNO R4 WiFi.

  • 'atomic' file not found em uma Uno, Nano ou Mega. As placas AVR não têm a biblioteca padrão de C++, como nas reais. Use uma variável volatile no lugar.

  • This code is intended to run on the ESP8266 platform!. Um sketch Blynk para o ESP8266 em outra placa. Use BlynkSimpleEsp32.h em um ESP32, ou BlynkSimpleWifi.h em uma Pico W. Veja Blynk, simulado.

  • MIDIUSB can only be used with an USB MCU.. A MIDIUSB precisa de uma placa cujo chip é o próprio dispositivo USB: a Leonardo, a Micro ou a Pro Micro. O USB de uma Uno é um chip separado. Escolha uma dessas três, ou envie bytes MIDI por uma porta serial com MIDI.h. Nenhum host USB é simulado, então as mensagens MIDI não vão a lugar nenhum mesmo ali; o monitor serial avisa isso uma vez.

  • Um arquivo de biblioteca não encontrado dentro de uma biblioteca que você adicionou, como 'OneWire_direct_regtype.h'. O projeto traz sua própria cópia de uma biblioteca que o Mokxi já tem, e essa cópia prevalece. Remova-a com o x no chip dela na faixa Bibliotecas abaixo do código.

  • enumeration values 'WStype_PING' and 'WStype_PONG' not handled in switch. É um aviso, não um erro: os exemplos da biblioteca WebSockets deixam alguns tipos de evento fora do switch, e o sketch ainda roda. Adicione um default: break; para silenciá-lo. Veja WiFi, simulated para saber o que o cliente WebSockets pode acessar aqui.

Limites da placa

  • global variables do not fit in the 2 KB SRAM. Arrays grandes ou strings longas. Reduza-os, mantenha o texto na flash com F("..."), ou escolha uma placa com mais memória, como a Mega 2560 ou um ESP32.
  • firmware does not fit in the 32 KB flash. O programa é maior do que a placa. Remova o que o sketch não precisa, ou escolha uma placa maior.
  • use of undeclared identifier 'Wire1'. Esta placa tem um barramento I2C aqui: use Wire e dê a cada dispositivo seu próprio endereço.
  • use of undeclared identifier 'dacWrite'. Só o ESP32 clássico tem DAC. Use analogWrite, ou escolha o ESP32 DevKit.

Ainda travado

Aperte Por que não compila? no Mokxi AI, ou escreva para nós a partir de /support com o erro e um link para o projeto. Veja também: