GitHub Pages Installer

Install BluButton from the browser

Flash the latest validated board-specific install set onto a supported ESP32-family board without opening the terminal.

Loading Pages installer metadata...

Version
Loading...
Published
Loading...
Board
Loading...
Asset
Loading...
Size
Loading...
Use Google Chrome or Microsoft Edge on desktop with HTTPS enabled. Open this page over HTTPS to use Web Serial.

This installer serves a same-origin split install set for the selected board.

Supported hardware

Choose a board profile

Loading board catalog...

Select the board you want to flash. The installer metadata and mirrored bundle switch together.

How it works

Three-minute setup

  1. Connect the ESP32 to your computer with a USB data cable.
  2. Select the correct board profile, then click Install Latest Release.
  3. Select the serial port, choose whether you want a clean erase, then confirm the install and wait for flashing to finish.
  4. After reboot, open any serial monitor at 115200 baud to read the device MAC and generated AES key.

After install

What to expect

  • If no AES key is present yet, BluButton generates one on first boot and persists it in NVS.
  • The serial log is the maintenance surface for the prototype phase: it prints the credentials you need to register the device in BluButtonBridge.
  • A 10-second hold is reserved for local maintenance behavior such as reprinting credentials.
  • The browser installer flashes the mirrored bootloader, partition table, ota-data, and app images at their board-specific offsets.

Notes

Before you flash

  • This page requires HTTPS plus Web Serial browser support.
  • Browser install stays blocked until the mirrored split install set matches the selected release on Pages.
  • The browser path intentionally uses board-specific split images so ordinary reinstalls do not depend on a whole-flash write, while still allowing an explicit clean erase when desired.
  • BluButton is the transmitter project; it intentionally does not expose a web UI on the device in this phase.