Is my board compatible?

Find your ESP32 board and get the right firmware file.

🔐 Verify your download

🔍 Find your chip and USB type

Two things decide your firmware file: the chip (ESP32, ESP32-S3 or ESP32-C3) and, for S3 and C3, the USB type: native USB gives _usb, a USB-to-UART bridge gives _uart.

  1. Install esptool
    pip install esptool
  2. Read the chip

    Plug the board in (if it is not detected, hold BOOT while plugging in), then run:

    esptool chip-id

    With esptool 4.x the command is esptool.py chip_id. If several ports are connected, add --port COM5 (Windows) or --port /dev/ttyUSB0 (Linux).

    Look for the line “Chip is …” (example)
    Chip is ESP32-S3 (QFN56) (revision v0.1)
    Features: WiFi, BLE, Embedded PSRAM 8MB
  3. Read the flash size (optional)
    esptool flash-id

    Look for Detected flash size: 8MB. The firmware needs 4MB or more (esptool 4.x: esptool.py flash_id).

  4. Find the USB type

    pyserial is installed with esptool, so you can list the ports with their USB IDs:

    python -m serial.tools.list_ports -v
    Read the “USB VID:PID=” value (example)
    COM5
        desc: USB Serial Device (COM5)
        hwid: USB VID:PID=303A:1001 ...
    VIDDeviceFirmware
    303AEspressif native USB_usb
    10C4CP210x bridge_uart
    1A86CH340 / CH9102 bridge_uart
    0403FTDI bridge_uart

Then pick your firmware

ChipUSB typeFile suffix
ESP32not needed_esp32.bin
ESP32-S3native USB / bridge_esp32s3_usb.bin / _esp32s3_uart.bin
ESP32-C3native USB / bridge_esp32c3_usb.bin / _esp32c3_uart.bin

Any other chip (for example ESP32-S2 or ESP32-C6) has no firmware yet.