Aprender

Arreglar "No such file or directory" en Arduino

Principiante

O mira todas las lecciones.

  • 526componentes en el banco de trabajo
  • 46placas funcionando ahora
  • 1.00xtiempo real, en todas las placas
Arduino Uno: un DHT11 en el pin 2, listo para romperseen vivo0.000 s 0.00x
Haz clic para abrirlo en el editor
Imprime la temperatura y la humedad cada dos segundos. Ábrelo, escribe mal DHT.h y presiona Ejecutar para ver el error.

fatal error: DHT.h: No such file or directory significa que una línea de #include nombra un archivo de header que el compilador no puede encontrar en ninguna carpeta donde busca. Normalmente la biblioteca que lo proporciona no está instalada, o el nombre en el #include está escrito distinto al del archivo. Instala la biblioteca, o corrige el nombre, y el error desaparece. El error es fatal, así que la compilación se detiene en el primer header que falta y no dice nada de las líneas posteriores.

Mokxi compila con clang, que lo redacta 'DHT.h' file not found. El circuito de arriba es un DHT11 en el pin 2 de un Uno, y su sketch empieza con #include <DHT.h>; presiona Ejecutar e imprime "temperature 22 C, humidity 45 %" cada dos segundos. Ábrelo, cambia la línea a #include <DTH.h> y presiona Ejecutar: la compilación se detiene con 'DTH.h' file not found, y el panel de compilación dice que DTH.h no es una de las bibliotecas integradas de Mokxi y ofrece buscarla en el Gestor de bibliotecas de Arduino.

La biblioteca no está instalada

Un header viene de una biblioteca, y la biblioteca tiene que estar instalada antes de que un sketch pueda incluirla. En el Arduino IDE, abre el Gestor de bibliotecas (Sketch, Include Library, Manage Libraries), busca el nombre del header o del componente, e instala la biblioteca que usaba el tutorial. DHT.h es la "DHT sensor library" de Adafruit, que también necesita "Adafruit Unified Sensor"; el Gestor de bibliotecas ofrece instalar ambas.

Mokxi tiene las bibliotecas comunes integradas con sus nombres habituales, así que DHT.h, Servo.h, LiquidCrystal_I2C.h, Adafruit_SSD1306.h, ArduinoJson.h, FastLED.h y Keypad.h se compilan igual que en un Uno. Bibliotecas integradas, en el panel de código, las enumera todas. Para un header que no tiene, la pestaña de compilación dice "Instálala desde el Gestor de bibliotecas de Arduino (Instalar, o la búsqueda del Gestor de bibliotecas de Arduino debajo del código), o usa Agregar biblioteca para subir su .zip o sus archivos .h y .cpp".

Como el error es fatal, un sketch que incluye dos headers faltantes reporta solo el primero. Un sketch con #include <NoSuchLib.h> y #include <OtherLib.h> se detuvo con un error, sobre NoSuchLib.h; instala esa biblioteca y aparecerá el siguiente.

El nombre está escrito distinto al del archivo

El #include debe nombrar el archivo, no la biblioteca. La biblioteca "LiquidCrystal I2C" tiene el header LiquidCrystal_I2C.h, con guion bajo: #include <LiquidCrystal I2C.h> no se encuentra, y tampoco #include <LiquidCrystal_I2C> sin el .h. Abre el ejemplo propio de la biblioteca (Archivo, Ejemplos en el IDE) y copia su línea de #include.

Las mayúsculas dependen de la computadora. En Linux, los nombres de archivo distinguen mayúsculas de minúsculas y servo.h no es Servo.h; Windows y macOS normalmente encuentran el archivo de cualquier forma, por eso un sketch puede compilar en una computadora y fallar en otra. Mokxi encuentra servo.h, dht.h y wire.h como Servo.h, DHT.h y Wire.h, pero escríbelos como lo hace la biblioteca, para que el sketch compile en todas partes.

El header pertenece a otra placa

Algunos headers vienen con el núcleo de una placa, no con una biblioteca, y existen solo para esa placa. WiFi.h y HTTPClient.h pertenecen a las placas ESP32, ESP8266WiFi.h al ESP8266, y avr/io.h a los chips AVR del Uno, el Nano y el Mega. Incluye uno en una placa que no lo tiene y no se encontrará, sin importar cuántas bibliotecas estén instaladas. En el IDE de Arduino, elige la placa para la que se escribió el sketch (Herramientas, Placa), después de agregar su paquete de placas en el Gestor de placas.

En Mokxi la placa que está en el circuito es la placa para la que se compila el código, y la pestaña Compilación indica para qué placas es un header. #include <WiFi.h> en un Uno decía que WiFi.h "necesita una placa con Wi-Fi, y la Arduino Uno no tiene, tampoco en la placa real", y luego nombraba las placas en las que Mokxi simula Wi-Fi y dónde cambiar. Algunos headers detienen la compilación con su propio mensaje: ESP8266WiFi.h en un Uno dice "Esta placa no tiene red simulada en Mokxi", y SoftwareSerial.h en un ESP32-C3 dice que "es para las placas AVR (Uno, Nano, Pro Mini, Mega, Leonardo, Pro Micro), la ESP8266, la ESP32 y la ESP32-S3 en Mokxi".

Comillas o corchetes angulares

#include <DHT.h>, con corchetes angulares, busca en las bibliotecas instaladas y en el núcleo. #include "config.h", con comillas, busca primero en la propia carpeta del sketch y luego en los mismos lugares. Las comillas son para un archivo que es una pestaña del sketch, como el config.h o el arduino_secrets.h donde algunos ejemplos guardan sus ajustes. Cuando esa pestaña no se copió junto con el sketch, el include falla, y la pestaña Compilación de Mokxi dice "Este proyecto no tiene un archivo llamado config.h" y "Agrega un archivo llamado config.h a tu proyecto", con un botón de pestaña Agregar un config.h que lo crea.

Una biblioteca entre comillas también funciona, porque la búsqueda continúa con las bibliotecas: #include "Servo.h" compiló en un Uno. Corchetes angulares para las bibliotecas y comillas para tus propias pestañas es el estilo habitual, y le indica al siguiente lector dónde buscar.

Arduino.h no se encuentra fuera del IDE de Arduino

fatal error: Arduino.h: No such file or directory en PlatformIO o ESPHome significa que el proyecto no está configurado para compilar con el núcleo de Arduino. En PlatformIO, la línea framework = arduino en platformio.ini es lo que lo trae. En el IDE de Arduino y en Mokxi el núcleo siempre está presente.

Abre este circuito en el editor. Arduino Uno: un DHT11 en el pin 2, listo para romperse, cableado como se ejecuta al inicio de esta página. Cambia un componente o un valor y ejecútalo de nuevo.

Abrir el circuito

Preguntas

¿Cómo corrijo "DHT.h: No such file or directory"?

Instala la "DHT sensor library" de Adafruit desde el Gestor de bibliotecas, y "Adafruit Unified Sensor" cuando el IDE lo pida. En Mokxi, DHT.h está integrado.

¿Cómo corrijo "LiquidCrystal_I2C.h: No such file or directory"?

Instala una biblioteca LiquidCrystal I2C desde el Gestor de bibliotecas, y verifica que el #include esté escrito LiquidCrystal_I2C.h, con el guion bajo y el .h. En Mokxi está integrado.

¿Es "file not found" el mismo error?

Sí. Es la redacción de clang; GCC, que usa el IDE de Arduino, dice "No such file or directory". Mokxi compila con clang, así que su pestaña Compilación muestra las palabras de clang.

¿Por qué solo se queja de un header cuando faltan dos?

Un header que falta es un error fatal, así que la compilación se detiene ahí. Corrige ese, compila de nuevo, y aparecerá el siguiente.

Ármalo en la vida real

Abre el editor, cambia un valor y mira cómo cambia el número con él. Nada que instalar y sin necesidad de cuenta.