WT9932C3-TINY Beginner's Guide

1. Setting Up the ESP32-C3 Development Environment

This tutorial mainly explains how to compile the ESP-IDF environment using WSL2 on Windows. The main advantages are as follows:

• Compiling in Ubuntu is more efficient than in Windows
• WSL2 uses Windows resources more efficiently than a virtual machine
• The environment is interoperable with Windows, and file transfer is easier compared to a virtual machine

1.1 Preparation

• One WT9932C3-TINY development board
• USB data cable (Type-A to Type-C)
• Computer (Windows, Linux, or macOS)

1.2 Install WSL2

1. Open Command Prompt or PowerShell as Administrator.

2. Enter the following command:

wsl --install

⚠ Note: You must restart your computer after installation for it to take effect.

3. The system will automatically download and install the required components and install the Ubuntu distribution by default.

4. Install the usbipd tool for mounting Windows development board devices

WSL-USB-GUI
Download WSL-USB-x.x.x.msi and double-click to install.

1.3 Install ESP-IDF

1. Install the following packages:

sudo apt-get update
sudo apt-get install git wget flex bison gperf python3 python3-pip python3-venv cmake ninja-build ccache libffi-dev libssl-dev dfu-util libusb-1.0-0

2. Download ESP-IDF:

mkdir -p ~/esp
cd ~/esp
git clone -b v5.4.2 --recursive https://github.com/espressif/esp-idf.git

3. Install toolchains:

cd ~/esp/esp-idf
export IDF_GITHUB_ASSETS="dl.espressif.com/github_assets"
./install.sh

4. Configure environment variables:

Add the following line to .bashrc and restart the terminal:

alias get_idf='. $HOME/esp/esp-idf/export.sh'

2. Compiling the LED Blink Example

1. Copy the example and enter the blink directory:

cp -r ./esp/esp-idf/examples/blink/ ./
cd blink/

2. Activate the ESP-IDF environment:

get_idf

3. Set the IDF target and configure menuconfig:

idf.py set-target esp32c3
idf.py menuconfig

Set the Blink type to RGB

Set the Blink IO pin to 6

4. Build the blink example:

idf.py build

5. Connect WT9932C3-TINY to your PC using a USB cable, open WSL-USB-GUI, and mount the USB device into WSL.

6. Flash the firmware:

idf.py flash -p /dev/ttyACM0

⚠ Note: If you encounter permission issues, run:
sudo chmod 666 /dev/ttyACM0

3. Result

You will see the onboard LED flashing in white.