WT9932S31-TINY Getting Started Guide
Update history
| Date | Version | Author | Update content |
|---|---|---|---|
| 2026-11-04 | 1.0.0 | Iris | Initial document creation |
1. Tutorial Goals
This guide is intended for first-time WT9932S31-TINY users. It walks through the complete process of becoming familiar with the board, preparing the development environment, obtaining WT_BSP, and building, flashing, and verifying the blink example.
WT9932S31-TINY is a compact development board based on the WT0132S31-S1 module and powered by Espressif's ESP32-S31. The chip features a dual-core RISC-V processor running at up to 320 MHz and supports 2.4 GHz Wi-Fi 6, Bluetooth Low Energy, Bluetooth Classic, Zigbee, and Thread. The 54 × 28 mm board includes a DVP camera connector, a 4-bit TF card slot, a WS2812 RGB LED, and breadboard-friendly GPIO headers.
The board provides two USB Type-C connectors:
| Connector | Marking / Reference | Main use |
|---|---|---|
| FUSB Type-C | FUSB |
Full-speed USB 2.0 for power, firmware flashing, and JTAG debugging, with a theoretical maximum of 12 Mbps |
| HUSB Type-C | HUSB |
High-speed USB 2.0 interface with a theoretical maximum of 480 Mbps; it can also power the board |
All flashing and serial connections in this guide use
FUSB. When both USB connectors are attached, the board prioritizes power fromFUSB.
2. Preparation
2.1 Hardware
- One
WT9932S31-TINYdevelopment board. - One USB Type-C cable that supports data transfer.
- One FPC antenna. Connect the antenna correctly before using wireless features.
- A Windows, Linux, or macOS computer.
- Optional accessories:
- A MicroSD card for data storage.
- A
WTDK-CAM-2145camera for image capture.
If the board is powered from a computer USB port, the port should be able to provide at least
5V@1A. Insufficient power may prevent the board from starting correctly.
2.2 Firmware
Only one merged firmware image needs to be flashed to WT9932S31-TINY:
| Firmware | Target chip |
|---|---|
WT9932S31-TINY · wt9932s31-tiny-factory-gc2145-sd-recording-off-20261022 |
ESP32-S31 |
2.3 Flashing Methods
Choose either of the following methods:
- Use the Wireless-Tag Online Flashing Tool. The browser can connect to the device, erase flash, program firmware, and display serial logs.
- Use Espressif's Flash Download Tool. This method is suitable for Windows users.
3. Flashing with the Online Tool
Download the Firmware Package
Open the Wireless-Tag Online Tools. The landing page is shown below:
Select Online Flashing → Official Firmware in the area shown below:
Click Download Firmware Package. The downloaded file is named wt9932s31-tiny-factory-gc2145-sd-recording-off-20261022-Online.zip.
Do not extract the downloaded package. Load the ZIP file directly in the online flashing tool.
Flashing Steps
- Connect the USB Type-C end of the data cable to
FUSBand the other end to the computer. Open the online tool, then click the button to connect a device as shown below.
A dialog listing one or more devices appears after you click
Connect Device. If you are unsure which COM port belongs to this board, disconnect other devices or unplug and reconnect the board to identify it.
- Select the device's COM port and click
Connect. Check the log area at the bottom of the page for the successful connection message.
- After the device connects, click
Load Firmware Package. In the file dialog, selectwt9932s31-tiny-factory-gc2145-sd-recording-off-20261022-Online.zip.
- Click
Start Flashing. A confirmation dialog appears at the top; clickOKto begin programming.
- Wait for the flashing-complete message.
The firmware is now installed. Disconnect the Type-C cable from the board before proceeding to functional verification.
4. Build the blink Example
4.1 Enter the Example Directory
After each WT_BSP update, build the minimal blink example first to confirm that ESP-IDF, the BSP, and the board-selection tool all work correctly:
cd ~/work/WT_BSP/examples/get-started/blink
4.2 Select the Board
Run the board-selection command provided by WT_BSP:
idf.py set-board
The command lists the boards supported by the current example. Find:
7: WT9932S31-TINY (esp32s31)
Enter 7 and press Enter. A successful selection produces output similar to:
Selected WT9932S31-TINY (esp32s31)
Done
set-boardselects the target chip and generates the board presets used by the current project. Unless you understand every operation performed byset-board, do not runidf.py set-targetafterward, because it may overwrite these settings.
4.3 Build the Example
After selecting the board, run:
idf.py build
Once the build succeeds, proceed to flashing and testing. Other WT_BSP examples use the same board-selection and build workflow.
5. Flashing and Testing
5.1 Hardware Connection
- If wireless features will be used, connect the FPC antenna correctly first.
- Connect the board's
FUSBport to the computer with a USB Type-C data cable. - Confirm that the board is powered and identify its serial port on the computer.
An inserted MicroSD card may cover the power indicator. If the indicator is not visible from above, inspect it from the side of the board.
5.2 Flash the Example
From the blink example directory, run:
idf.py -p <COM> flash
Replace <COM> with the board's actual serial port, such as COM5 on Windows or the corresponding serial device on Linux or WSL.
If the serial port repeatedly appears and disappears after connecting FUSB, or its status is unstable in the flashing tool, enter download mode manually:
- Hold the
BOOTbutton. - Press and release
RESET/ENonce. - Release
BOOT. - Run the flashing command again.
5.3 Verify Operation
After flashing, the board automatically runs the blink example. Normal behavior is:
- The onboard RGB LED changes color approximately once per second.
- Startup information appears in the serial log.
To view logs with the ESP-IDF serial monitor, run:
idf.py -p <COM> monitor
Timestamps and version numbers may vary, but the log should contain key messages similar to:
boot.esp32s31: SPI Flash Size : 16MB
cpu_start: cpu freq: 320000000 Hz
app_init: Project name: blink
blink: Initializing Wireless-Tag BSP
If the RGB LED continues to cycle and the serial log does not show repeated resets or obvious errors, the basic environment, board selection, build, and flashing workflow have been verified.
5.4 Troubleshooting
| Symptom | Suggested action |
|---|---|
| Serial port not found | Confirm that the cable supports data transfer and is connected to FUSB |
| Serial port repeatedly appears and disappears | Hold BOOT, press RESET/EN, release BOOT, and flash again |
| Wrong board or target chip | Run idf.py set-board again and select 7: WT9932S31-TINY (esp32s31) |
| Unstable startup | Use a good-quality cable and confirm that the USB port can supply at least 5V@1A |
| Power LED is not visible after inserting a MicroSD card | The card may cover the indicator; inspect the board from the side |
6. Next Steps
After verifying the blink example, try other examples in WT_BSP and develop applications using the DVP camera, TF card, wireless connectivity, and GPIO features.