Getting Started with an ESP32 Dev Kit

This is a quick beginner guide for setting up an ESP32 development board, installing the required software, and uploading your first program. This follows the familiar Arduino workflow used by many makers and hobbyists.

Step 1Install the USB drivers for your ESP32 board. Step 2Download and install the Arduino IDE. Step 3Add the ESP32 board package in Arduino IDE. Step 4Select your board and serial port. Step 5Load a Blink sketch and upload it. Step 6Troubleshoot if the board does not upload.

Step 1

Install the USB Drivers

Most ESP32 dev boards use a USB-to-serial chip such as the CP2102 or CH340. Your computer will need the proper driver installed before it can communicate with the board over USB.

Silicon Labs CP210x driver for CP2102-based boards
WCH CH340 driver for CH340-based boards

After downloading the driver, run the installer and restart your computer if needed. Once complete, plug the ESP32 into your computer with a USB cable and check whether the board appears in the device manager or serial port list.

Step 2

Download and Install Arduino IDE

Arduino IDE is the easiest way to write sketches and program an ESP32. Download the latest version from the official Arduino website.

Arduino IDE download page

Install Arduino IDE and launch it once the install is complete. If prompted, accept the default options unless you know you need a custom setup.

Step 3

Add the ESP32 Board Package

To program an ESP32 in Arduino IDE, you must add the ESP32 board package from Espressif.

Add the board manager URL

Open Arduino IDE and go to File > Preferences.

In the Additional Boards Manager URLs field, paste:

https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json

Then click OK.

Install the package

Next, open Tools > Board > Boards Manager. Search for “ESP32,” then install the package labeled “esp32 by Espressif Systems.”

This may take a few minutes, depending on your internet speed.

Step 4

Select the Board and Port

Once the package is installed, select the correct board from the menu:

Tools > Board > ESP32 Arduino > ESP32 Dev Module

Then choose the matching COM or serial port:

Tools > Port > select the port associated with your ESP32

Tip If the board does not appear in the port list, the driver may not be installed correctly or the USB cable may be charging-only.

Step 5

Load the Blink Example and Upload It

Open the built-in Blink example:

File > Examples > 01.Basics > Blink

The sketch should compile and upload to the board. After the upload completes, the built-in LED on the ESP32 will begin blinking on and off.

Upload steps Connect your ESP32 to the USB cable, select the correct board and port, and click the Upload button in the Arduino IDE.

Step 6

Troubleshooting Upload Problems

If your sketch does not upload, try the following:

Press and hold the BOOT button while uploading, then release it when the upload begins.
Try a different USB cable or USB port.
Make sure the correct serial port is selected.
Verify that the installer finished successfully and that the board package is installed.

On many boards, the BOOT button is the easiest fix when the upload fails or the board appears stuck in reset mode.

Success

If the Blink sketch uploads and the LED starts flashing, your ESP32 setup is working correctly.

From here, you can begin building more advanced projects with sensors, displays, Wi-Fi, and internet-connected devices.