Web Serial API Blocked

navigator.serial is unavailable in this context. Likely causes: (1) missing serial iframe permission, (2) non-Chrome / Edge browser, or (3) an HTTP (non-HTTPS) origin. Open this page directly in Chrome or Edge 89+ over HTTPS to enable flashing.

BX.DISPLAY // FIRMWARE FLASH PORTAL

ESP32-S3 · Web Serial Flashing & Maintenance · Batch 01

Idle
SYSTEM READY: Plug ESP32-S3 via USB-C data cable prior to flashing.
TARGET BUILD VERSION

RESOLVED MANIFEST ENDPOINT

Flash Controls — ESP Web Tools

Loading esp-web-tools@10…

Requires Chrome or Edge 89+ over HTTPS.
If this button is blocked: add https://unpkg.com to the script-src Content Security Policy directive.

Serial Console — 115200 baud
Flash Procedure
  1. 01
    Power Off Device
    Slide the BX.Display power switch to the OFF position.
  2. 02
    Connect USB-C
    Use a USB-C data cable directly to your PC. Chrome or Edge 89+ required.
  3. 03
    Select & Flash
    Choose your firmware build, click INITIALIZE FLASH, and pick the ESP32-S3 serial port from the browser popup.
  4. 04
    Wait for Complete
    Allow ~30 s for the flash cycle to finish. Do not disconnect the cable.
Troubleshooting
Port Not Detected?
Verify your cable supports data transfer — many USB-C cables are power-only. Try a different cable or port. Ensure no other tool (Arduino IDE, PlatformIO) is currently holding the serial port open.
Screen Glitch / Freeze?
Power-cycle the device (OFF → 5 s → ON). If the issue persists, flash v1.0.4-prod — it contains the display driver patch that resolves the framebuffer glitch regression.
Battery Icon Delay?
Expected behavior. The battery gauge initializes only after cell voltage exceeds 4.4 V. Allow up to 60 s after power-on for the indicator to appear.
Install Button Not Visible?
Web Serial API requires Chrome 89+ or Edge 89+. Firefox and Safari are unsupported. If hosted behind a CSP, add https://unpkg.com to the script-src directive.
Target Hardware
Device
BX.Display Batch 01
MCU
ESP32-S3 rev 0.1
Flash Memory
16 MB SPI NOR
Interface
USB-C / UART0
Baud Rate
115200
WiFi
802.11 b/g/n 2.4 GHz
Bluetooth
BLE 5.0
Firmware Host
GitHub Pages