Solución de problemas

Errores de compilación en palabras sencillas

Los mensajes del compilador que la gente más encuentra en Mokxi, qué significa cada uno, y qué cambiar.

Lo que ves

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). Cómo funciona la compilación está en código y compilación.

Busca el primer error en la pestaña Compilación de abajo. Corrige primero ese: un error suele causar varios errores después de él.

Llaves, corchetes y punto y coma

  • expected ';' after expression, expected ';' at end of declaration, expected ';' after top level declarator. A una línea le falta su ;. Agrégalo al final de la línea mencionada, o de la línea justo arriba de ella.
  • expected ';' after struct. A struct o class debe terminar con };.
  • expected '}'. A { se abrió y nunca se cerró. El } que falta suele estar al final de loop() o de un if dentro de él. Pon el cursor junto a una llave y el editor muestra su pareja.
  • extraneous closing brace ('}'). Hay un } de más. Bórralo.
  • function definition is not allowed here. La función de arriba nunca se cerró, así que esta empieza dentro de ella. Agrega el } que falta arriba.
  • expected ')'. A ( no está cerrado. Cuenta los corchetes en esa línea.
  • expected '(' after 'if'. C++ necesita paréntesis alrededor de una condición: if (x > 5), no if x > 5.
  • expected function body after function declarator. Un header como void setup() no va seguido de {.

Código fuera de una función

  • expected unqualified-id. Algo fuera de toda función que C++ no puede leer: una palabra suelta, un ``` de código o un "Copy code" pegado junto con el sketch, o una línea que pertenece dentro de setup() o loop(). Borra el texto suelto.
  • a type specifier is required for all declarations, unknown type name 'Serial', while loop outside of a function. Una llamada o un ciclo está fuera de toda función. Muévelo a setup() (una vez) o a loop() (una y otra vez).
  • unknown type name 'cpp'. La primera línea es una etiqueta copiada de un chat o de una página web. Bórrala, junto con cualquier línea "Copy code" y los ``` de código.
  • unknown type name 'from' o 'import'. El archivo es Python, pero el sketch se compila como C++ de Arduino. La pestaña Compilación lo dice primero: "Este sketch es MicroPython, no C++ de Arduino". La Raspberry Pi Pico, la Pico W y las placas ESP32 (DevKit V1, DevKitC, LOLIN32 Lite, ESP32-S3, ESP32-C3 y ESP32-C6) ejecutan MicroPython: elige MicroPython (main.py) en el panel de Firmware de la placa y mueve el código a main.py, o presiona Ejecútalo como MicroPython debajo del error para hacer ambas cosas. Una placa con pestaña de main.py y sin .ino ejecuta MicroPython. En cualquier otra placa, escribe el programa en C++. Consulta MicroPython on the ESP32 y la Pico.
  • invalid preprocessing directive. Una línea empieza con # y una palabra que C++ no conoce: #incude para #include, por ejemplo. Corrige la ortografía.
  • invalid suffix 'https' on integer constant. Texto pegado junto con el código quedó dentro de una línea. Bórralo, o pon // delante de él.

Nombres

  • undefined symbol: setup() o undefined symbol: loop(). Todo sketch necesita ambos void setup() { } y void loop() { }, escritos exactamente así, aunque estén vacíos. Un archivo vacío también recibe este error.
  • use of undeclared identifier 'serial'; did you mean 'Serial'?. Los nombres distinguen mayúsculas de minúsculas. Usa la ortografía que aparece después de "did you mean".
  • use of undeclared identifier 'output'. Las constantes de Arduino van en mayúsculas: OUTPUT, INPUT, INPUT_PULLUP, HIGH, LOW.
  • use of undeclared identifier 'LED_PIN'. El nombre nunca se define, muchas veces porque no se copiaron las primeras líneas de un tutorial. Agrega const int LED_PIN = 13; arriba de setup(). Una variable que dos partes setup() y loop() usan va arriba de ambas.
  • undefined symbol: blinkTwice(). Se llama a una función que nunca se escribió, está escrita diferente, o se escribió dentro de otra función. Escríbela en el nivel superior del sketch.
  • redefinition of 'setup'. Dos sketches pegados en un solo archivo, o setup() en dos pestañas. Conserva un setup() y un loop() y combina sus cuerpos.
  • redefinition of '...' as different kind of symbol. Una variable tiene el nombre de algo que la placa ya tiene. Renombra la variable.
  • cannot combine with previous 'int' declaration specifier. Dos tipos juntos, como int int. Conserva uno.

Llamadas que no encajan

  • no matching function for call to 'pinMode'. pinMode recibe el pin y el modo: pinMode(13, OUTPUT). Un pin entre comillas es texto, no un número.
  • no matching member function for call to 'println'. Serial.println imprime un valor. Imprime cada uno con su propio Serial.print.
  • no member named 'display' in .... Esa biblioteca no tiene ninguna llamada con ese nombre: el sketch fue escrito para otra biblioteca o versión. Bibliotecas integradas en el panel de código lista las llamadas de cada biblioteca.
  • expression is not assignable. Algo que no es una variable está a la izquierda de =, como en digitalRead(2) = HIGH. Para comparar, usa ==.
  • excess elements in array initializer. Hay más valores entre las llaves que el tamaño en los corchetes. Deja los corchetes vacíos: int pins[] = {2, 3, 4};
  • member reference base type 'const char *' is not a structure or union. El texto plano no tiene .length(). Usa strlen(text), o conviértelo en un String.

Archivos y bibliotecas faltantes

  • 'Something.h' file not found. Mokxi no tiene esa biblioteca integrada. La pestaña Compilación indica la integrada que hace el mismo trabajo, u ofrece Instalar del Gestor de bibliotecas de Arduino. Consulta el sketch no compila.

  • 'config.h' file not found, o 'secrets.h', 'arduino_secrets.h', 'credentials.h' (un nombre entre comillas, o un archivo de configuración entre corchetes angulares). El proyecto original tenía ese archivo como su propia pestaña en el IDE de Arduino, a menudo con el nombre y la contraseña del WiFi o un token fuera del código, y no se copió. Agrega un archivo con ese nombre exacto a tu proyecto (el + junto a las pestañas), o presiona Agregar una pestaña secrets.h bajo el error. La nueva pestaña tiene una #define con un marcador para cada configuración que el sketch usa y nunca define (como SECRET_SSID, WIFI_PASSWORD o BOT_TOKEN); un nombre y una contraseña de WiFi empiezan como los de la red simulada, Mokxi-Lab y breadboard. Pon tus propios valores en el resto. Si el proyecto tiene el archivo con otra combinación de mayúsculas (Secrets.h), el botón cambia el #include para que coincida.

  • 'wokwi-api.h' file not found, o la advertencia chip.c is a Wokwi custom chip. Ese código es de un chip personalizado de Wokwi, no parte del sketch de la placa: un chip se compila por su cuenta. Mokxi deja fuera de la compilación de la placa una pestaña así. Para ejecutar el chip, importa el proyecto de nuevo con su <name>.chip.json, o crea uno con Más, Nuevo chip personalizado y pega el código en su .chip.c. Consulta chips personalizados.

  • 'WiFi.h' file not found en una Pico, o 'WiFiS3.h' en una Uno. Esa placa no tiene WiFi. Elige la Pico W, una placa ESP32 o la UNO R4 WiFi.

  • This board has no simulated network in Mokxi de una biblioteca de red como WebSocketsClient.h o PubSubClient.h. Esa placa no tiene WiFi. Elige una placa ESP32, la ESP8266, la Pico W o la UNO R4 WiFi.

  • 'atomic' file not found en una Uno, Nano o Mega. Las placas AVR no tienen la biblioteca estándar de C++, igual que las reales. Usa una variable volatile en su lugar.

  • This code is intended to run on the ESP8266 platform!. Un sketch de Blynk para la ESP8266 en otra placa. Usa BlynkSimpleEsp32.h en una ESP32, o BlynkSimpleWifi.h en una Pico W. Consulta Blynk, simulado.

  • MIDIUSB can only be used with an USB MCU.. MIDIUSB necesita una placa cuyo chip sea su propio dispositivo USB: la Leonardo, la Micro o la Pro Micro. El USB de una Uno es un chip aparte. Elige una de esas tres, o envía los bytes de MIDI por un puerto serie con MIDI.h. No se simula ningún host USB, así que los mensajes MIDI no llegan a ningún lado ni ahí; el monitor serie lo avisa una vez.

  • Un archivo de biblioteca que no se encuentra dentro de una biblioteca que agregaste, como 'OneWire_direct_regtype.h'. El proyecto trae su propia copia de una biblioteca que Mokxi ya tiene, y esa copia es la que se usa. Quítala con la x en su chip en la franja de Bibliotecas bajo el código.

  • enumeration values 'WStype_PING' and 'WStype_PONG' not handled in switch. Es una advertencia, no un error: los ejemplos de la biblioteca WebSockets dejan fuera de su switchalgunos tipos de evento, y el sketch sigue funcionando. Agrega un default: break; para silenciarla. Consulta WiFi, simulated para ver a qué puede llegar aquí el cliente de WebSockets.

Límites de la placa

  • global variables do not fit in the 2 KB SRAM. Arreglos grandes o cadenas largas. Reduce su tamaño, mantén el texto en flash con F("..."), o elige una placa con más memoria, como la Mega 2560 o una ESP32.
  • firmware does not fit in the 32 KB flash. El programa es más grande que la placa. Quita lo que el sketch no necesita, o elige una placa más grande.
  • use of undeclared identifier 'Wire1'. Esta placa tiene un solo bus I2C aquí: usa Wire y dale a cada dispositivo su propia dirección.
  • use of undeclared identifier 'dacWrite'. Solo la ESP32 clásica tiene DAC. Usa analogWrite, o elige la ESP32 DevKit.

¿Sigue atascado?

Presiona ¿Por qué no compila? en Mokxi AI, o escríbenos desde /support con el error y un enlace al proyecto. Consulta también: