Ugenz Academy/IoT Tutorial

Esp32 Installation And Ide

12 min read2,346 words

Reading progress

Keep learning

ESP32 — Installation and IDE

Now that you understand what ESP32 is and the different ESP32 boards, the next step is learning how to prepare your computer for ESP32 programming.

In this topic, we'll understand:

  1. What an IDE is
  2. Arduino IDE
  3. Installing Arduino IDE
  4. Installing ESP32 board support
  5. Selecting the ESP32 board
  6. Selecting the COM/serial port
  7. Connecting ESP32 to the computer
  8. Uploading a program
  9. Understanding compilation and uploading
  10. Common installation/upload problems

1. What is an IDE?

IDE stands for:

Integrated Development Environment

An IDE is software that gives you tools to:

  • Write code
  • Check/compile code
  • Upload code to the microcontroller
  • View output
  • Debug programs

Instead of using several different programs, an IDE combines these functions into one application.

IDE │ ┌──────────┼──────────┐ ↓ ↓ ↓ Write Compile Upload Code Code Code │ │ │ └──────────┼──────────┘ ↓ ESP32

2. Arduino IDE

For beginners, one of the easiest ways to program an ESP32 is:

Arduino IDE

Arduino IDE was originally created for Arduino boards, but it can also be used to program ESP32 boards after installing the appropriate ESP32 board package.

You can write:

void setup() { // setup code } void loop() { // repeated code }

and upload it to the ESP32.


3. What Happens When You Upload Code?

Suppose you write:

void setup() { pinMode(2, OUTPUT); } void loop() { digitalWrite(2, HIGH); }

When you click Upload, several things happen.

Your Code ↓ Arduino IDE ↓ Compiler ↓ Machine Code / Firmware ↓ USB / Serial Connection ↓ ESP32 ↓ Flash Memory ↓ ESP32 Executes Program

The ESP32 doesn't directly execute the C/C++ source code you typed.

The code is first compiled into machine-readable firmware.


4. Install Arduino IDE

Download Arduino IDE from the official Arduino website.

Arduino IDE Downloads

Arduino IDE is available for operating systems such as:

  • Windows
  • Linux
  • macOS

If you're using Linux, choose the appropriate Linux version for your distribution/architecture.


5. Install ESP32 Board Support

After installing Arduino IDE, it initially knows about Arduino boards, but it may not know how to compile programs for ESP32.

Therefore, we need to install the ESP32 board package.

This is commonly done through:

Boards Manager

The process is conceptually:

Arduino IDE ↓ Preferences ↓ Additional Boards Manager URLs ↓ ESP32 package URL ↓ Boards Manager ↓ Install ESP32 platform

6. ESP32 Board Package

The ESP32 Arduino platform is maintained by Espressif and the community around the Arduino-ESP32 project.

The official Arduino-ESP32 documentation is:

Arduino-ESP32 Documentation

This package gives Arduino IDE the information and tools needed to:

  • Compile ESP32 programs
  • Recognize ESP32 board definitions
  • Upload firmware
  • Use ESP32 libraries
  • Access ESP32 hardware features

7. Adding the ESP32 Board Manager URL

In Arduino IDE, open:

File → Preferences

Look for:

Additional boards manager URLs

The exact interface can vary slightly between Arduino IDE versions.

You add the official ESP32 package URL there.

Then open:

Tools → Board → Boards Manager

Search for:

esp32

You should find the ESP32 platform provided by Espressif Systems.

Install it.


8. Why Do We Need a Board Package?

Imagine Arduino IDE doesn't know what an ESP32 is.

You write:

digitalWrite(2, HIGH);

The IDE needs to know:

  • Which CPU architecture is being used?
  • How should the code be compiled?
  • What memory layout does the chip use?
  • How should firmware be packaged?
  • How should it communicate with the board?
  • Which ESP32-specific libraries are available?

The board package provides this information.

So:

Arduino IDE + ESP32 Board Package = ESP32 Development Environment

9. Connect ESP32 to Your Computer

Use a USB cable.

Computer │ │ USB ↓ ESP32 Board

But there is an important point:

Not every USB cable supports data.

Some cheap USB cables are charge-only cables.

If you use a charge-only cable:

ESP32 ←── USB ──→ Computer Power ✅ Data ❌

The ESP32 may turn on, but the computer may not detect it correctly.

Therefore, use a known-good USB data cable.


10. USB-to-Serial Chip

Many ESP32 development boards contain a USB-to-serial interface.

Common chips include:

  • CP210x
  • CH340/CH34x
  • FTDI on some boards

Conceptually:

Computer │ USB ↓ USB-to-Serial │ ↓ ESP32

This interface helps the computer communicate with the ESP32 for programming and serial communication.

Some newer boards, especially certain ESP32-S2/S3 designs, can provide native USB functionality instead.


11. COM Port / Serial Port

After connecting the ESP32, your computer usually creates a serial device.

On Windows it may appear as:

COM3 COM5 COM6 COM7 ...

On Linux it may appear as something like:

/dev/ttyUSB0 /dev/ttyUSB1

or:

/dev/ttyACM0

The exact device depends on your board and USB interface.


12. Selecting the Board

After installing ESP32 support, go to:

Tools → Board

You will see many ESP32 board options.

Choose the one corresponding to your hardware.

For example, if you're using a common ESP32 development board, you may use an appropriate ESP32 Dev Module option when applicable.

But don't blindly select a board just because it contains the word ESP32.

Remember:

ESP32 ├── Original ESP32 ├── ESP32-S2 ├── ESP32-S3 ├── ESP32-C3 ├── ESP32-C6 └── ESP32-H2

The correct board selection depends on your actual hardware.


13. Selecting the Port

Next select:

Tools → Port

You may see something like:

COM6

Select the port belonging to your ESP32.

A useful method is:

Before connecting ESP32

Check the available ports.

COM3 COM5

Connect ESP32

Check again:

COM3 COM5 COM7

The newly appearing port is likely your ESP32.

This is a simple way to identify it.


14. Your First ESP32 Program

Let's start with a very simple program.

void setup() { Serial.begin(115200); } void loop() { Serial.println("Hello ESP32!"); delay(1000); }

This doesn't control an LED yet.

Instead, it sends:

Hello ESP32!

to the computer every second.


15. Understanding the Code

setup()

void setup() { Serial.begin(115200); }

setup() executes once when the ESP32 starts.

Serial.begin()

Serial.begin(115200);

This starts serial communication at:

115200 baud

We'll study serial communication in much more detail later.


loop()

void loop() { Serial.println("Hello ESP32!"); delay(1000); }

The loop() function repeats continuously.

So the ESP32 effectively does:

Print ↓ Wait 1 second ↓ Print ↓ Wait 1 second ↓ Print ↓ ...

16. Compile the Program

Before uploading, Arduino IDE needs to compile the program.

Click:

Verify / Compile

The IDE checks your code.

If everything is correct:

Compilation successful

If there is an error:

Compilation error

For example:

void setup() { Serial.begin(115200)

If you forget:

;

or:

}

the compiler may report an error.


17. Compile vs Upload

These are two different operations.

Compile

Converts your source code into firmware.

C/C++ Code ↓ Compiler ↓ Firmware

Upload

Transfers the compiled firmware to the ESP32.

Firmware ↓ USB ↓ ESP32 ↓ Flash Memory

So:

Compile = prepare the program

Upload = send the program to ESP32


18. Uploading the Program

After selecting:

  • Correct board
  • Correct port

click:

Upload

The process generally looks like:

Compiling... ↓ Connecting... ↓ Writing... ↓ Verifying... ↓ Done

The ESP32 then starts executing your program.


19. What is Flash Memory?

ESP32 has non-volatile flash memory.

Your uploaded firmware is stored there.

That means your program generally remains after you disconnect the USB cable and power the board again.

Conceptually:

Computer ↓ USB ↓ ESP32 ↓ Flash Memory ↓ Program stored

When ESP32 restarts:

Power ON ↓ ESP32 starts ↓ Reads firmware ↓ Runs program

20. Serial Monitor

Now open:

Tools → Serial Monitor

or use the Serial Monitor button/interface in your Arduino IDE version.

Set the baud rate to:

115200

You should see:

Hello ESP32! Hello ESP32! Hello ESP32! Hello ESP32!

This is extremely useful for debugging.

For example:

Serial.println("Sensor initialized"); Serial.println("WiFi connected"); Serial.println("Motion detected");

You can watch what your ESP32 is doing.


21. Why Serial Monitor Is Important

Suppose your sensor isn't working.

Without debugging:

Sensor not working ❓

With serial messages:

Starting... Sensor initialized Reading sensor... Temperature = 28.4 Humidity = 62

Now you can identify where the problem occurs.

Later, you'll study Serial Monitor and Debugging as a dedicated topic.


22. Boot Mode and the BOOT Button

Many ESP32 development boards have a button labeled:

BOOT

or:

IO0

and another button commonly labeled:

EN

or:

RST

The exact behavior depends on the board.

The BOOT button is commonly involved in putting the ESP32 into its download/programming mode.

Normally, modern development boards automatically handle this during upload.

But sometimes you may see:

Connecting...

and the upload doesn't proceed.

On some boards, manually holding BOOT during the connection stage can help.


23. EN / Reset Button

The EN button commonly resets the ESP32.

Conceptually:

Press EN ↓ ESP32 Reset ↓ Program starts again

For example, if your program prints:

Starting...

pressing EN will generally restart the program.


24. Common Installation Problems

Problem 1 — ESP32 board doesn't appear

Possible causes:

  • ESP32 board package not installed
  • Wrong board selected
  • Arduino IDE issue

Solution:

Boards Manager ↓ Search ESP32 ↓ Install/update ESP32 platform

Problem 2 — Port doesn't appear

Possible causes:

  • Charge-only USB cable
  • USB driver problem
  • USB cable problem
  • USB port problem
  • Board problem

Try:

Different USB cable ↓ Different USB port ↓ Check Device Manager / system devices ↓ Check USB-serial driver

Problem 3 — Upload gets stuck at connecting

You might see something similar to:

Connecting....

Possible causes include:

  • Wrong board selected
  • Wrong port
  • USB communication issue
  • Board not entering download mode
  • BOOT button may need to be used manually on some boards

Problem 4 — Wrong COM port

You might accidentally select:

COM6

when the ESP32 is actually:

COM7

Always identify the port after connecting the board.


Problem 5 — Serial Monitor shows garbage characters

For example:

������

This often happens when the Serial Monitor baud rate doesn't match the program.

If your code has:

Serial.begin(115200);

set Serial Monitor to:

115200

25. Basic ESP32 Development Workflow

From now on, you'll repeatedly use this workflow:

Write Code ↓ Select Board ↓ Select Port ↓ Compile ↓ Upload ↓ ESP32 Runs ↓ Serial Monitor ↓ Debug ↓ Modify Code ↓ Upload ↺

This cycle is fundamental to ESP32 development.


26. Arduino IDE Interface — What You Need to Know

You don't need to memorize every menu immediately.

The most important parts are:

Arduino IDE │ ├── Sketch Editor │ └── Write code │ ├── Verify │ └── Compile │ ├── Upload │ └── Send program to ESP32 │ ├── Board Selection │ └── Choose ESP32 board │ ├── Port Selection │ └── Choose ESP32 connection │ └── Serial Monitor └── View ESP32 messages

27. Arduino IDE vs ESP-IDF

Arduino IDE is not the only way to program ESP32.

Another important development framework is:

ESP-IDF — Espressif IoT Development Framework

A simplified comparison:

Arduino IDEESP-IDF
Easier for beginnersMore advanced
Simple APIsLower-level control
Huge Arduino library ecosystemOfficial Espressif framework
Fast prototypingProfessional/advanced development
Easy learning curveSteeper learning curve

For your current ESP32 learning roadmap, Arduino IDE is a good starting point.

Once you understand ESP32 fundamentals, learning ESP-IDF can be valuable.


28. One Important Safety Rule

Before connecting sensors, relays, motors, or other hardware:

Always check voltage levels and the ESP32 board's specifications.

ESP32 GPIOs are generally 3.3 V logic.

Don't blindly connect:

5V signal → ESP32 GPIO

because the correct interface depends on the specific device and board.

For motors and high-current devices, don't power them directly from an ESP32 GPIO.

Instead:

ESP32 ↓ Motor Driver / Relay Driver ↓ External Power ↓ Motor / Load

29. Complete Mental Picture

You can now understand the entire programming environment like this:

COMPUTER │ Arduino IDE │ ┌────────┴────────┐ │ │ Compile Upload │ │ └────────┬────────┘ │ USB │ ESP32 BOARD │ ┌──────┴──────┐ │ │ Flash Memory GPIO │ │ Program Sensors │ Motors │ Relay │ LEDs

And when debugging:

ESP32 │ │ Serial ↓ Computer ↓ Serial Monitor ↓ You see what ESP32 is doing

Key Points to Remember

  1. IDE = Integrated Development Environment.
  2. Arduino IDE can be used to program ESP32.
  3. ESP32 board support must be installed in Arduino IDE.
  4. The correct board must be selected.
  5. The correct serial/COM port must be selected.
  6. Use a USB data cable, not a charge-only cable.
  7. Compile converts your code into firmware.
  8. Upload transfers firmware to the ESP32.
  9. The firmware is stored in flash memory.
  10. Serial Monitor helps you see messages and debug your program.
  11. BOOT and EN buttons can be useful when programming or resetting some boards.
  12. Always check the exact board and voltage specifications before connecting hardware.

The complete idea:

Write → Compile → Upload → Run → Monitor → Debug → Repeat

Keep learning. Keep building. Keep growing.

© 2026 Ugenz Academy