Firmware Updates

Firmware Updates

Glasscalibur runs ESPHome. Once a device already has the firmware on it, you can keep it up to date over the air — usually with no computer at all.

Easiest — update from the device (GitHub OTA)

1. Open the web UI: http://glasscalibur-XXXXXX.local.
2. Go to the Diagnostics group.
3. Press Update Firmware (GitHub).

The device downloads the latest release straight from GitHub, flashes itself, and reboots. It needs an internet connection. If no release is available, it just logs an error and keeps running the current firmware — it won't brick itself.

Manual — ESPHome CLI / dashboard

If you build from source (e.g. you changed settings in the YAML), push a new build with ESPHome over the network:

esphome run firmware/esphome/Glasscalibur-esphome.yml

Pick the device's network/OTA target when prompted. You can also use the ESPHome dashboard's Install → Wirelessly option.

First flash (blank board)

A brand‑new chip has no firmware yet, so the first flash must be over USB — there's nothing there to receive an OTA. Two options:

• ESPHome CLI: esphome run firmware/esphome/Glasscalibur-esphome.yml and choose the serial/USB port.
• Browser: open web.esphome.io, connect over USB, and install. (A pre‑built *.factory.bin can be flashed this way without compiling, if one is attached to a release.)

After the first USB flash, all future updates can be done over the air.

For maintainers — cutting a release

The build/release process (bumping the version, compiling the OTA image, naming the release assets so the Update Firmware (GitHub) button finds them, and publishing the GitHub release) is documented in the firmware README:

➡️ firmware/esphome/README.md