📡

ESP32 Firmware Flash

Flash your ESP32 scanners directly in the browser — no tools, no installation. Just plug in a USB cable and go.

⚡ Install Firmware

Connect your ESP32 via USB to your computer and click the button. The chip type (ESP32 / ESP32-S3) is detected automatically.

—
🔌
⚠️ Browser not compatible Web Serial is only supported by Google Chrome and Microsoft Edge (desktop). Safari, Firefox and mobile browsers are not supported.

Chip type is detected automatically (ESP32 / ESP32-S3).

ESP32 (WROOM) ESP32-S3 Improv WiFi ✓
⚠️ First Install vs. Update For first install, keep "Erase flash" enabled — this cleans up NVS storage. For a firmware-only update (keep settings), uncheck the option. Already installed scanners can also be updated OTA via the admin panel.

📋 Guide

Get your BLE scanner ready in 4 steps.

1

Connect USB

Connect the ESP32 to your computer via USB cable. Some boards require holding the BOOT button while plugging in.

2

Flash Firmware

Click "Install Firmware" above, select the serial port (e.g. CP2102 or CH340) and wait for the flash process to complete (~60 seconds).

3

Configure WiFi

After flashing, Improv WiFi configuration starts automatically right here in the browser — just enter your SSID and password.
If the dialog doesn't appear: The ESP32 opens a WiFi hotspot:
SSID: ESP32-BLE-Setup | Password: 12345678
Connect and open 192.168.4.1 for manual configuration.

4

Register in Admin Panel

Once the scanner is on your WiFi, it appears automatically in the BLE Presence admin panel under ESP32 Clients. There you can name it and assign it to a room.

🔧 Supported Hardware

Tested ESP32 boards for BLE Presence scanners.

Board Chip Free RAM Notes
ESP32 DevKit / WROOM ESP32 ~60 KB Budget option
ESP32-D1 Mini ESP32 ~60 KB Compact form factor
ESP32-S3 DevKit ⭐ ESP32-S3 ~90 KB Recommended — more RAM
Xiao ESP32-S3 ⭐ ESP32-S3 ~90 KB Very compact
💡 Recommendation ESP32-S3 is the best choice — more free RAM means more stable BLE scanning with NimBLE. For small enclosures, the Xiao ESP32-S3 is ideal.

❓ FAQ

?

No serial port visible?

Check USB drivers: Most ESP32 boards use CP2102 or CH340 chips. Download drivers from the manufacturer if needed. On macOS/Linux they are usually pre-installed.

?

Flash fails?

Hold the BOOT button while plugging in the USB cable. Alternatively: Try a different USB cable (some are charge-only without data lines).

?

Update instead of first install?

Already installed scanners can be updated OTA (Over-The-Air) via the admin panel — no USB cable needed. This page is only for first-time installation.

🖥️ Serial Monitor

View live log from ESP32 — useful for diagnostics and verification after flashing.

Click "Connect" and select the serial port…