Windows Environment Setup — VSCode + ESP-IDF 6.0.2

1. Overview

ESP-IDF (Espressif IoT Development Framework) is the official development framework provided by Espressif for ESP32 series chips. It is based on FreeRTOS and includes drivers, protocol stacks, build systems, and toolchains.

This tutorial sets up the ESP32-S3 development environment on Windows, consisting of two steps:

1. Install ESP-IDF framework — Install v6.0.2 online via EIM (ESP-IDF Installation Manager)

2. Install VSCode extension — Enable VSCode to detect the installed ESP-IDF and provide GUI-based compilation/flashing/monitoring

ESP-IDF v6.0+ uses EIM uniformly as the installer. Whether using GUI mode or command-line mode, EIM handles the downloading and management of the framework and toolchains under the hood. The VSCode extension also has built-in EIM entry points.

2. Prerequisites

2.1 Hardware Requirements

2.2 Downloads Required

ESP-IDF framework and toolchains do not need manual download — EIM pulls and installs them automatically online.

3. Install CH340 Driver

The ESP32-S3 development board communicates with the computer via a USB-to-serial chip. Most development boards use the CH340 series chip, but Windows does not include its driver by default, so manual installation is required.

3.1 Check if Driver is Already Installed

1. Connect the development board to your computer using a USB data cable

2. Right-click Start Menu → Device Manager → Expand Ports (COM & LPT)

3. Observe the list:

3.2 Download Driver

WCH Official Download Page → Download the latest version CH340SER.EXE (compatible with CH340 series).

You can also search for "WCH CH340 driver" to access the official website. The development board in this tutorial uses CH340K, and the installer is approximately 300KB.

3.3 Installation Steps

1. Double-click CH341SER.EXE

2. Click INSTALL

3. After installation completes, you will see "Driver install success!"

4. Re-plug the development board's USB cable

3.4 Verification

Go back to Device Manager → Ports (COM & LPT), and you should see:

xxxxxxxxxx
USB-SERIAL CH340 (COM3)

Note down the port number (e.g., COM3), as you will need to select it during compilation and flashing.

4. Install VSCode

If VSCode is already installed, skip to Chapter 4.

1. Double-click VSCodeUserSetup-x64-1.130.0.exe

2. Check "I accept the agreement" and click "Next".

   

3. Click "Browse" to select your installation path, then click Next.

   

4. Click "Next".

   

5. Check additional shortcuts, then click "Next".

   

6. Click "Install".

   

7. After installation completes, click "Finish".

   

   

8. Launch VSCode

5. Install ESP-IDF Extension + EIM

5.1 Install ESP-IDF Extension

1. Open VSCode

   

2. Click the Extensions icon on the left sidebar (or Ctrl + Shift + X)

   

3. Search for "ESP-IDF"

4. Select "Espressif IDF" (publisher: Espressif) and click Install

   After installation, the ESP-IDF icon will appear in the left activity bar.

   

5. Download the following plugin the same way.

   

5.2 Launch EIM Installer Through Extension

The ESP-IDF extension has a built-in entry point for EIM (ESP-IDF Installation Manager):

1. Open the ESP-IDF Installation Manager using the ESP-IDF plugin.

   

2. Select GitHub, and the extension will start downloading and launching the EIM installer interface

   

   

   

3. Use the EIM GUI to install ESP-IDF v6.0.2. We will choose Custom Installation

   

4. After entering, Prerequisites Check and Python Sanity Check will run. Once completed, you can Select Target.

   

5. Select IDF version.

   

   If you find a newer version is available, you can select Show old stable versions to check historical stable versions.

6. Select Mirror

   

7. Select Features

   

8. Select Tools

   

9. Select installation path

   

10. Then install and wait for the installation to complete.

6. Open Example and Create Your First Project

6.1 Open the Official hello_world Example

1. Select File → Open Folder

   

2. Navigate to the ESP-IDF installation folder (espidf) → 6.0.2 → esp-idf → examples → get-started → hello_world

   

3. We can see the project architecture/file structure

   

6.2 Create a Project

1. Click the in the bottom left corner to select the corresponding ESP-IDF environment.

2. Open the ESP-IDF Installation Manager using the ESP-IDF plugin, and select New Project Wizard.

2. Select the corresponding ESP-IDF environment.

3. Select template.

   ①ESP-IDF Examples are ready-to-use Demos for learning and referencing functional code. They focus on single-function demonstrations and serve as references for how to use a particular peripheral/protocol. ②ESP-IDF Templates are blank standardized project scaffolds for creating new formal projects, providing the most basic and standardized project skeleton without business functionality. (This document primarily focuses on creating blank templates)

4. Create a New Project.

5. Configure the new project settings ①Project Name

   ②Enter Project directory

   ③Choose ESP-IDF Target (IDF_TARGET)

   ④Choose ESP-IDF Board

   ⑤Choose serial port

6.3 Project File Structure

xxxxxxxxxx
blink/
├── CMakeLists.txt          # Top-level build file
├── main/
│   ├── CMakeLists.txt      # main component build file
│   └── blink_example_main.c
├── sdkconfig               # Project configuration (generated by Kconfig)
└── ...

6.4 Set Target Chip

Click the in the bottom toolbar → Select esp32s3

ESP-IDF will regenerate sdkconfig to adapt to ESP32-S3.

7. Build, Flash, and Monitor

7.1 Connect Hardware

1. Connect the ESP32-S3 development board to your computer using a USB data cable

2. Open Device Manager → Expand Ports (COM & LPT)

3. Confirm a new serial port appears (e.g., COM3) and remember the port number

   Common USB-to-Serial Chips	Driver Source
   CP2102 / CP2104	Silicon Labs CP210x driver
   CH340 / CH343	WCH official driver
   CH9102	WCH official driver
   FT232	FTDI driver

   If a yellow exclamation mark appears, install the corresponding driver.

7.2 Select Serial Port

Click the serial port selection area on VSCode's bottom status bar → Select the corresponding COM port.

The bottom status bar should display:

xxxxxxxxxx
[ESP-IDF]  esp32s3  |  COM3  |  ...

7.3 Build

Click the Build icon on the bottom toolbar.

Initial build takes approximately 2~5 minutes, while incremental builds take only a few seconds. The end of the output should display:

xxxxxxxxxx
Project build complete.

7.4 Flash

Click the Flash icon on the bottom toolbar.

After flashing completes, the chip will automatically reset and the program will start running.

7.5 Serial Monitor

Click the Monitor icon on the bottom toolbar.

You can view the chip's serial log output in the OUTPUT panel.

One-Click Operation: The Build, Flash and Monitor icon on the bottom toolbar can sequentially complete build + flash + monitor.

8. Troubleshooting