WiFi Setup

Wi‑Fi Setup

Glasscalibur runs ESPHome and ships without any Wi‑Fi credentials baked in, so each device is provisioned to your own network the first time it powers up. Nothing is stored in the cloud.

Your device's name: every unit has a unique name, glasscalibur-XXXXXX, where XXXXXX is the last three bytes of its MAC address. It's printed on the USB serial log at boot and is used as both the setup hotspot name and the .local hostname. Wherever you see XXXXXX below, use your device's value.

2.4 GHz only. Connect Glasscalibur to a 2.4 GHz network, not 5 GHz. If your router broadcasts both under one name, it will pick 2.4 GHz automatically.

Step 1 — Power on

Plug in a 12 V, 3 A+ supply (2.1 mm × 5.5 mm barrel plug). The device needs 12 V power to run — there's no battery.

Step 2 — Join the device to your network

Use either method:

Option A — captive‑portal hotspot (no computer needed)

1. On a phone or laptop, open your Wi‑Fi network list and connect to glasscalibur-XXXXXX (it has no password).
2. A captive portal should pop up automatically. If it doesn't, open a browser and go to http://192.168.4.1.
3. Choose your home 2.4 GHz network, enter its password, and save.
4. The device reboots and joins your network; the glasscalibur-XXXXXX hotspot disappears. Reconnect your phone/laptop to your normal Wi‑Fi.

Option B — Improv over USB (web.esphome.io)

1. Connect the device to a computer with a USB‑C cable.
2. Open web.esphome.io in Chrome or Edge, click Connect, and choose the serial port.
3. Use Configure Wi‑Fi to send your network name and password directly over USB. No hotspot needed.

Credentials are saved to flash and survive reboots and firmware updates.

Step 3 — Open the control panel

Once it's on your network, open the web UI in any browser on the same network:

http://glasscalibur-XXXXXX.local

If .local (mDNS) doesn't resolve on your device/OS, find the unit's IP address instead — for example:

• Log in to your router and look for a device named glasscalibur-XXXXXX in the DHCP/clients list.
• Scan the network with Angry IP Scanner or the iOS app Network Analyzer.

Then browse to http://<that-ip-address>.

See the Web UI Guide for a tour of the control panel.

Resetting Wi‑Fi

To move the device to a different network (or clear a bad password), press and hold the Wi‑Fi Reset button for 3–10 seconds. The device erases its saved credentials and reboots into setup mode, broadcasting the glasscalibur-XXXXXX hotspot again so you can repeat Step 2.

A long hold is required on purpose, so an accidental tap can't knock the device offline.