ESP32 first steps: a checklist for your new dev board

A new ESP32 board should blink an LED within minutes. When it does not, the cause is almost always one of the points below.
1. Use a data cable
Many USB cables only carry power. If the board lights up but never shows up on your computer, swap the cable before anything else. Keep one known-good data cable at your desk.
2. Install the right driver
Boards with a USB-to-serial chip need a driver on some systems: CP210x or CH340 are the common ones. Boards with native USB (such as the ESP32-S3) usually need none. After installing, a new serial port should appear when you plug the board in.
3. Pick the right board and port
In the Arduino IDE or PlatformIO, select an ESP32 board that matches yours (for example "ESP32 Dev Module") and the new serial port. A wrong board entry is the most common reason for strange upload errors.
4. If the upload hangs on "Connecting..."
Hold the BOOT button while the upload starts, then release it once the transfer begins. Some boards need a tap on EN (reset) afterwards. Also try a lower upload speed.
5. Mind the voltage
ESP32 GPIO pins run at 3.3 V. Do not connect 5 V signals directly to them. Use a level shifter or a voltage divider for 5 V sensors and modules.
6. Pins that need care
- Several pins are connected to the on-board flash on many modules (commonly GPIO 6 to 11). Leave them alone.
- Some pins (such as GPIO 0, 2, 12 and 15 on the original ESP32) are read at boot to decide the boot mode. A strong pull-up or pull-down there can stop the board from starting.
- On the original ESP32, analog readings on the ADC2 pins do not work while Wi-Fi is active. Use ADC1 pins for analog sensors in Wi-Fi projects.
7. Power
USB power is fine for most boards. Wi-Fi transmissions cause short current peaks, so a weak USB port or a very thin cable can make the board reset randomly. If it reboots when Wi-Fi connects, try another port or a powered hub.
Quick test sketch
Blink the on-board LED (check your board's pin number) and print a line to the serial monitor at 115200 baud. If both work, your toolchain is ready and you can move on to Wi-Fi.