Solución de problemas

El sketch no compila

Cómo leer la pestaña Compilación y las cinco causas más comunes.

Lo que ves: la pestaña Compilación

Está debajo de la tira de archivos en el panel de código. Lista los pasos con sus tiempos y luego la salida del compilador como líneas clicables. Haz clic en una línea y el editor salta a ese archivo, línea y columna.

Los diagnósticos son diagnósticos reales de clang, sin editar. Una posición en tu sketch es una posición en tu sketch: el archivo se compila con su propio nombre, así que los números de línea son tuyos y no los de un envoltorio.

Un error del enlazador no tiene posición. ld.lld: error: undefined symbol: loop() aparece como una línea sin salto, porque no hay a dónde saltar.

1. Un include que falta

La más común, y tiene un síntoma propio: clang se detiene de golpe ante un header faltante. El panel de compilación lo trata como una compilación fallida y muestra el diagnóstico en lugar de reportar un fallo, así que busca la línea file not found.

Solo están los headers de tu propio proyecto, sus bibliotecas y los del runtime. La compilación en sí no tiene red: una biblioteca está en el proyecto antes de que empiece la compilación, o no está en absoluto.

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 (la lista y qué cubre cada una). Un header escrito con mayúsculas distintas, como suele ocurrir en sketches escritos en Windows o 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. Una función que no está en este runtime

El runtime es nuestro: C y C++ independientes con la API de la referencia del lenguaje Arduino. Incluye pinMode, digitalWrite, digitalRead, analogWrite, analogRead, millis, micros, delay, delayMicroseconds, pulseIn, shiftIn, shiftOut, tone, noTone, attachInterrupt, Serial con parseInt y readStringUntil, String, punto flotante y la biblioteca matemática, las pruebas de caracteres, y sprintf con el resto de lo que usan los tutoriales de la biblioteca de C, además de controladores compartidos para las pantallas y la tira WS2812 (la lista).

No es avr-libc, no es el núcleo de Arduino ni ESP-IDF, y ninguno de esos se descarga al compilar. Una llamada que resuelve en un Arduino real puede que aquí no exista (analogRead en una placa cuyo convertidor no está modelado, por ejemplo), y la compilación te lo dirá.

3. El archivo equivocado es main

Un proyecto tiene varios archivos y uno de ellos es donde empieza el compilador. Si renombraste el sketch, revisa que el archivo que esperas que sea el punto de entrada todavía lo sea.

4. Compiló, pero Ejecutar corrió otra cosa

Al presionar Ejecutar pueden pasar tres cosas, y solo una de ellas es una compilación:

  • la placa corre un ejemplo precompilado o un ELF cargado, y no se compila nada;
  • la placa reutiliza la última compilación, porque no cambió ni un byte de los archivos;
  • la placa se compila.

Un ELF que cargaste no se compiló desde estos archivos, así que gana: el campo program de la placa en el panel de propiedades dice ELF cargado mientras esté ahí. Si el simulador lo rechaza, el mensaje ofrece Usar el código en su lugar, que devuelve la placa al código del editor.

5. Compila en el IDE de Arduino, pero no aquí

Dos cosas que el IDE de Arduino hace por un sketch, Mokxi también las hace, así que un sketch copiado de un tutorial no tropieza con ellas.

  • Las funciones pueden llamarse antes de definirse. El IDE de Arduino escribe un prototipo para cada función en las pestañas .ino antes de compilarlas, y Mokxi también, así que loop() puede llamar a una función definida más abajo. Varias pestañas .ino se unen en un solo archivo, la pestaña principal primero, tal como las une el IDE. Una plantilla de función recibe su prototipo con su línea template <typename T> al frente, como la escribe el IDE. Algunas funciones no reciben prototipo: las funciones dentro de una clase o namespace, una plantilla con un argumento de plantilla predeterminado, y una función cuyos tipos de parámetro se declaran más abajo en el sketch. Para esas, una llamada antes de la definición es use of undeclared identifier, y la pestaña Compilación indica en qué línea está la función: mueve la función, o el tipo que usa, arriba del código que la llama, o pon un prototipo de una línea como void blinkTwice(); al inicio.
  • Las advertencias no detienen la compilación. Tus archivos se compilan con -Wall -Wextra, y la pestaña Compilación lista lo que encuentran, pero el sketch se compila y ejecuta igual, como en el IDE. Una variable o parámetro sin usar y una comparación entre con y sin signo (int i < sizeof(pins)) pueden esperar. if (x = HIGH) sí vale la pena corregirlo: un solo = asigna, así que la condición siempre es verdadera, y querías decir ==.

Lo que queda suele ser una biblioteca que Mokxi no incluye, o una función que el entorno de ejecución de esa placa omite: las secciones 1 y 2 de arriba.

Errores de compilación en palabras sencillas recorre los mensajes comunes uno por uno, y Arduino compile errors explained los tiene tanto con las palabras de GCC como con las de clang.

Si la primera compilación se queda trabada

No está trabada, está descargando. El toolchain son unos setenta megabytes de clang y se transmite una sola vez, luego vive en la caché del navegador. Los pasos en la pestaña Compilación dicen dónde está. Una visita de regreso tarda aproximadamente segundo y medio, y editar y ejecutar después de eso toma una fracción de segundo. Si falla la descarga, consulta el editor o el compilador no carga.

¿Sigue atascado?

Compilar en el navegador es el contrato completo: la lista de comandos, las claves de caché y cómo se arma el entorno de ejecución. O escríbenos desde /support con el diagnóstico.