Sửa lỗi "No such file or directory" trong Arduino
Cơ bản
Hoặc xem mọi bài học.
- 526linh kiện trên bàn làm mạch
- 46bo mạch đang chạy
- 1.00xthời gian thực, trên mọi bo mạch
fatal error: DHT.h: No such file or directory nghĩa là một dòng #include nêu tên một tệp header mà trình biên dịch không tìm thấy trong bất kỳ thư mục nào nó tìm. Thường là thư viện cung cấp header chưa được cài, hoặc tên trong #include viết khác với tên tệp. Cài thư viện, hoặc sửa tên, là lỗi hết. Lỗi này là lỗi nặng, nên bản build dừng ở header thiếu đầu tiên và không nói gì về các dòng phía sau.
Mokxi biên dịch bằng clang, vốn diễn đạt lỗi này là 'DHT.h' file not found. Mạch phía trên là một DHT11 gắn vào chân 2 của Uno, và sketch của nó bắt đầu bằng #include <DHT.h>; nhấn Chạy và nó sẽ in "temperature 22 C, humidity 45 %" mỗi hai giây. Hãy mở nó, đổi dòng đó thành #include <DTH.h> rồi nhấn Chạy: build dừng với lỗi 'DTH.h' file not found, và bảng biên dịch báo rằng DTH.h không nằm trong số các thư viện có sẵn của Mokxi, đồng thời gợi ý tìm nó trong Arduino Library Manager.
Thư viện chưa được cài
Một header đến từ một thư viện, và thư viện phải được cài đặt trước thì sketch mới include được. Trong Arduino IDE, mở Library Manager (Sketch, Include Library, Manage Libraries), tìm theo tên header hoặc theo linh kiện, rồi cài thư viện mà bài hướng dẫn đã dùng. DHT.h thuộc thư viện "DHT sensor library" của Adafruit, thư viện này còn cần cả "Adafruit Unified Sensor"; Library Manager sẽ gợi ý cài cả hai.
Mokxi đã tích hợp sẵn các thư viện phổ biến dưới tên quen thuộc của chúng, nên DHT.h, Servo.h, LiquidCrystal_I2C.h, Adafruit_SSD1306.h, ArduinoJson.h, FastLED.h và Keypad.h đều biên dịch được y như trên một bo Uno. Mục Thư viện tích hợp sẵn, trong khung code, liệt kê đầy đủ từng thư viện. Với một tệp header mà Mokxi không có, bảng biên dịch sẽ ghi "Install it from the Arduino Library Manager (Install, or the Arduino Library Manager search under the code), or use Add library to upload its .zip or its .h and .cpp files".
Vì lỗi này là lỗi nghiêm trọng, một sketch include hai header bị thiếu thì chỉ báo lỗi của header đầu tiên. Một sketch có #include <NoSuchLib.h> và #include <OtherLib.h> đã dừng với một lỗi duy nhất, về NoSuchLib.h; cài thư viện đó xong thì lỗi tiếp theo mới xuất hiện.
Tên viết khác với tên tệp
#include phải nêu đúng tên tệp, chứ không phải tên thư viện. Thư viện "LiquidCrystal I2C" có header là LiquidCrystal_I2C.h, với dấu gạch dưới: #include <LiquidCrystal I2C.h> sẽ không tìm thấy, và #include <LiquidCrystal_I2C> thiếu .h cũng không tìm thấy. Hãy mở ví dụ mẫu của chính thư viện (File, Examples trong IDE) và chép dòng #include của nó.
Chữ hoa hay chữ thường tùy thuộc vào máy tính. Trên Linux, tên tệp phân biệt chữ hoa chữ thường nên servo.h khác với Servo.h; Windows và macOS thường tìm được tệp dù viết kiểu nào, đó là lý do một sketch có thể biên dịch được trên máy này mà lại lỗi trên máy khác. Mokxi nhận servo.h, dht.h và wire.h như Servo.h, DHT.h và Wire.h, nhưng bạn hãy viết đúng theo cách thư viện viết, để sketch biên dịch được ở mọi nơi.
Header thuộc về bo mạch khác
Một số header đi kèm với core của một bo mạch chứ không phải với một thư viện, và chỉ tồn tại trên bo mạch đó. WiFi.h và HTTPClient.h thuộc về các bo mạch ESP32, ESP8266WiFi.h thuộc ESP8266, còn avr/io.h thuộc các chip AVR của Uno, Nano và Mega. Include một header như vậy trên bo mạch không có nó thì sẽ không tìm thấy, dù có cài bao nhiêu thư viện đi nữa. Trong Arduino IDE, hãy chọn đúng bo mạch mà sketch được viết cho (Tools, Board), sau khi thêm board package của nó trong Boards Manager.
Trong Mokxi, bo mạch trong mạch chính là bo mạch mà code được biên dịch cho, và bảng biên dịch nêu rõ các bo mạch mà một header dành cho. #include <WiFi.h> trên một bo Uno trả lời là WiFi.h "cần một bo mạch có Wi-Fi, và bo Arduino Uno không có, trên bo thật cũng vậy", rồi liệt kê các bo mạch mà Mokxi mô phỏng được Wi-Fi và nơi để chuyển đổi. Một vài header dừng bản biên dịch với thông báo riêng của chúng: ESP8266WiFi.h trên một bo Uno nói "Bo mạch này không có mạng được mô phỏng trong Mokxi", và SoftwareSerial.h trên một ESP32-C3 nói nó "dành cho các bo AVR (Uno, Nano, Pro Mini, Mega, Leonardo, Pro Micro), ESP8266, ESP32 và ESP32-S3 trong Mokxi".
Nháy kép hay ngoặc nhọn
#include <DHT.h>, với ngoặc nhọn, tìm trong các thư viện đã cài và trong core. #include "config.h", với nháy kép, tìm trong thư mục riêng của sketch trước rồi đến các nơi đó. Nháy kép dành cho một tệp là một tab của sketch, chẳng hạn config.h hay arduino_secrets.h mà một số ví dụ dùng để lưu cài đặt. Khi tab đó không được sao chép cùng sketch, lệnh include sẽ lỗi, và bảng biên dịch của Mokxi nói "Dự án này không có tệp tên là config.h" và "Thêm một tệp tên config.h vào dự án của bạn", kèm nút Thêm tab config.h để tạo tệp đó.
Một thư viện đặt trong nháy kép vẫn chạy, vì việc tìm kiếm tiếp tục sang các thư viện: #include "Servo.h" đã biên dịch được trên một bo Uno. Ngoặc nhọn cho thư viện và nháy kép cho tab của riêng bạn là cách viết thông thường, và nó cho người đọc tiếp theo biết chỗ nào để tìm.
Không tìm thấy Arduino.h ngoài Arduino IDE
fatal error: Arduino.h: No such file or directory trong PlatformIO hay ESPHome có nghĩa là dự án không được thiết lập để biên dịch với Arduino core. Trong PlatformIO, dòng framework = arduino trong platformio.ini là thứ đưa nó vào. Trong Arduino IDE và trong Mokxi thì core luôn có sẵn.
Mở mạch này trong trình soạn thảo. Arduino Uno: một DHT11 ở chân 2, sẵn sàng hỏng, được nối dây như khi chạy ở đầu trang này. Đổi một linh kiện hay một giá trị rồi chạy lại.
Mở mạchCâu hỏi
Làm sao sửa lỗi "DHT.h: No such file or directory"?
Cài "DHT sensor library" của Adafruit từ Library Manager, và cài "Adafruit Unified Sensor" khi IDE hỏi. Trong Mokxi, DHT.h có sẵn.
Làm sao sửa lỗi "LiquidCrystal_I2C.h: No such file or directory"?
Cài một thư viện LiquidCrystal I2C từ Library Manager, và kiểm tra rằng #include được viết đúng là LiquidCrystal_I2C.h, với dấu gạch dưới và đuôi .h. Trong Mokxi nó có sẵn.
"file not found" có phải là cùng một lỗi không?
Có. Đó là cách diễn đạt của clang; GCC, thứ mà Arduino IDE dùng, nói "No such file or directory". Mokxi biên dịch bằng clang, nên bảng biên dịch của nó hiện lời của clang.
Vì sao nó chỉ báo lỗi một header khi thiếu cả hai?
Thiếu một header là lỗi nghiêm trọng, nên bản biên dịch dừng ở đó. Sửa cái đó, biên dịch lại, rồi cái tiếp theo sẽ hiện ra.
Tiếp tục nào
Lắp mạch này ngoài đời
Mở trình soạn thảo, đổi một giá trị và xem con số thay đổi theo. Không cần cài gì, không cần tài khoản.