Install ESP32 in Arduino IDE: Board, Port and Upload Checks
Install ESP32 support in Arduino IDE, select the correct board, and verify a first upload before connecting sensors. ESP32, ESP32-S3, ESP32-C3 and ESP32-C6 require their own board targets.
Choose hardware for your first ESP32 project
- Touchscreen dashboard: 2.8-inch CYD ESP32-2432S028R — setup and display checks.
- Compact development board: ESP32-S3 Supermini or ESP32-C6 Supermini — choose the exact chip target and check the board pinout.
- Camera replacement: OV2640 or 75mm OV3660 — these are camera modules, not complete ESP32-CAM boards. Check connector, pinout, cable orientation and firmware support.
Check the selected option and package contents before ordering. Sensors, cables, power supplies and programming adapters are separate unless explicitly included.
1. Prepare the board and USB connection
Use a data-capable USB cable. Identify the exact board and USB connector from its documentation. Some boards use native USB; others use a USB-to-UART bridge. Install a driver only for the bridge actually fitted to your board.
2. Install the Espressif board package
- Install Arduino IDE from Arduino.
- Open Preferences and add the stable package URL below to Additional Boards Manager URLs.
- Open Boards Manager, search for esp32 and install the package by Espressif Systems.
- Select the board matching your hardware under Tools > Board, then select its USB/serial port.
https://espressif.github.io/arduino-esp32/package_esp32_index.json
Do not install multiple third-party indexes as a workaround. If downloads fail, check the network and the current installation alternatives in Espressif’s installation guide. A source ZIP alone is not a complete compiler installation.
3. Verify the first upload
Start with File > Examples > WiFi > WiFiScan on a Wi-Fi-capable target. Upload it, then open Serial Monitor at the baud rate used by that example. Confirm that the sketch runs after reset. Blink is another option only after confirming the actual LED pin and whether the board uses an addressable RGB LED. GPIO 2 is not a universal ESP32 LED pin.
4. Troubleshoot connection failures
- No port: check the data cable, connector and board-specific USB/driver instructions.
- “Failed to connect” or “No serial data received”: flashing has not started successfully. Close other serial tools, check the port and enter download mode using the board’s documented BOOT/RESET sequence.
- Upload stops partway: try a lower upload speed and check power stability.
- Upload succeeds but no output: verify the serial baud rate, USB CDC settings where applicable, and reset the board.
For detailed checks use the official esptool troubleshooting guide.
Continue with your board
- ESP32 Arduino setup Wiki
- USB and upload troubleshooting
- ESP32-C3 Supermini
- ESP32-C6 Supermini
- 2.8-inch CYD display setup
Quick decision: which stage is failing?
- Board is missing from the menu: confirm the Espressif package installed successfully, then select the exact target family.
- No USB port appears: compare the operating system's device list before and after connecting. Check the data cable and documented USB connector before changing sketch settings.
- Compilation fails: retain the first compiler error and the core/library versions. Changing the serial port will not fix a compilation error.
- Connecting dots followed by no serial data: check the selected port, close programs using it and use the board-specific download-mode sequence.
- Upload succeeds but Serial Monitor is empty: check the sketch baud rate, runtime USB settings and reset behavior.
For a detailed USB diagnostic, use the USB and upload Wiki. Once a serial test works, choose a small build from the beginner project sequence.
After your first successful upload, Choose a first ESP32 project.
