notes/ESP32/frameworks/arduino-cli/FQBN esp32.md

I can see you're encountering an error while trying to compile code for an ESP32 development board using the Arduino CLI. The error message indicates that the FQBN (Fully Qualified Board Name) "esp32:esp32:esp32-dev-kit1" was not found.

Let me help you resolve this issue:

To fix the "Invalid FQBN: board esp32:esp32:esp32-dev-kit1 not found" error when using arduino-cli:

1. The error occurs because the FQBN (Fully Qualified Board Name) you're using is incorrect. The correct format for ESP32 boards is typically esp32:esp32:[board-name].

2. First, make sure you have the ESP32 core installed:

   arduino-cli core update-index
   arduino-cli core install esp32:esp32
   

3. To see all available ESP32 boards and their correct FQBNs:

   arduino-cli board listall esp32
   

4. The correct FQBN for ESP32 Dev Kit is likely esp32:esp32:esp32 or esp32:esp32:esp32dev (not esp32-dev-kit1).

5. Your corrected command should look like:

   arduino-cli compile --fqbn esp32:esp32:esp32dev --port /dev/cu.usbserial-0001
   

If you're still having issues, check that:

• You're using a proper USB data cable (not just a charging cable)
• You have the correct USB-to-UART bridge drivers installed (CP210x, CH340, or FTDI depending on your board)
• The board is properly powered and connected

For ESP32 boards with upload issues, you may need to hold the BOOT button while initiating the upload until you see "Connecting..." in the output. ¹

---

1. https://randomnerdtutorials.com/esp32-troubleshooting-guide/ ↩︎