WT9932S31-TINY Getting Started Guide

  • WT9932S31-TINY
  • ESP32-S31
  • WT_BSP
  • blink
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 from FUSB.

2. Preparation

2.1 Hardware

  • One WT9932S31-TINY development 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-2145 camera 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:

Wireless-Tag Online Flashing Tool home page

Select Online Flashing → Official Firmware in the area shown below:

Official firmware area in the online flashing tool

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

  1. Connect the USB Type-C end of the data cable to FUSB and 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.

Serial device selection dialog in the online flashing tool
  1. Select the device's COM port and click Connect. Check the log area at the bottom of the page for the successful connection message.
ESP32-S31 connection success log
  1. After the device connects, click Load Firmware Package. In the file dialog, select wt9932s31-tiny-factory-gc2145-sd-recording-off-20261022-Online.zip.
Load the WT9932S31-TINY firmware package
  1. Click Start Flashing. A confirmation dialog appears at the top; click OK to begin programming.
Confirm WT9932S31-TINY firmware flashing
  1. Wait for the flashing-complete message.
WT9932S31-TINY firmware flashing completed

The firmware is now installed. Disconnect the Type-C cable from the board before proceeding to functional verification.

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-board selects the target chip and generates the board presets used by the current project. Unless you understand every operation performed by set-board, do not run idf.py set-target afterward, 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

  1. If wireless features will be used, connect the FPC antenna correctly first.
  2. Connect the board's FUSB port to the computer with a USB Type-C data cable.
  3. 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:

  1. Hold the BOOT button.
  2. Press and release RESET/EN once.
  3. Release BOOT.
  4. 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.