Skip to content

Web UI Guide

Daniel Frenkel edited this page Nov 6, 2026 · 2 revisions

Web UI Guide

Glasscalibur serves a full control panel from the device itself — no app, no account, and no Home Assistant required. Open it in any browser on the same network:

http://glasscalibur-XXXXXX.local

(XXXXXX is your device's MAC suffix — see Wi‑Fi Setup.)

The page is organized into collapsible groups:

Control

  • Calibration Notice — Not calibrated - run Calibrate until a calibration has succeeded, then Calibrated.
  • Glasscalibur — the cover control. Use the open/close/stop buttons or drag the position slider (0 % = closed, 100 % = open).
  • State — live status: IDLE, OPENING, CLOSING, or TAMPERED.
  • Button 1 — shows the state of the on‑device button.
  • Child Lock — Button 1 on the unit ignores presses; the web UI, Home Assistant, the API and schedules keep working.
  • Obstruction — an event, fired once each time a stall detector stops a move.
  • Thermal Alert — an event for the motor temperature: a warning, a lockout, and the lockout clearing (see Motor & Stall Tuning).

Motion Tuning

  • Speed — Slow, Medium or Fast (1200, 2600 or 5500 steps/s). Until a calibration has succeeded, every move runs at Fast; after one, moves run at the speed it was calibrated at.
  • Speed Lock — why the running speed differs from the setting, or Not locked.
  • Acceleration — how quickly the motor ramps up to speed (steps/s²).
  • Motor Current — the motor run current in mA, up to 600. Auto‑Calibrate sets it to the lowest current that moves your window reliably.

See Motor & Stall Tuning.

Calibration

  • Auto‑Calibrate — starts calibration.
  • Calibration Status — the result of the last calibration; it ends in STALE after a speed change.

Stall Detection

  • Vibration Stall Detection — the accelerometer stall check. A calibration turns it on. It can't be switched off while StallGuard is off.
  • Vibration Threshold — its sensitivity, in g. A calibration sets it.
  • Vibration Stall Samples — how many loud samples stop the motor (2–60, default 5).

Tamper

  • Tamper Detection — arm/disarm the anti‑tamper alarm.
  • Tamper Threshold — how much movement (in g) trips it.
  • Tamper Detected — current alarm state.
  • Set Tamper Baseline / Clear Tamper Alert — calibrate and dismiss.

See Security & Tamper.

Schedule

  • Schedule Enabled — master on/off for all scheduling.
  • Sun Schedule — switch between fixed times and sunrise/sunset.
  • Open Time / Close Time — fixed daily times.
  • Latitude / Longitude / Sun Open Offset / Sun Close Offset — sunrise/sunset configuration.
  • Timezone — POSIX timezone string.

See Scheduling.

Diagnostics

  • Fault — None, or the active limit‑switch faults.
  • Open Limit Switch / Close Limit Switch — live end‑stop state.
  • Firmware Version, Board, Update Firmware (GitHub), Restart
  • Motor Temperature, ESP Internal Temperature
  • Thermal Lockout — on while the motor's thermal lockout holds.
  • Open stroke — the learned open travel in mm (unknown until learned).
  • StallGuard calibrated — on once a calibration has succeeded.
  • WiFi Reset — the state of the Wi‑Fi / Calibrate button.
  • WiFi Signal, IP Address, Connected SSID, MAC Address, Uptime
  • Accel X / Y / Z — live accelerometer readings (useful for tuning)
  • Lifetime counters: StallGuard Trips, Vibration Stall Trips, Tamper Trips (with reset buttons)

StallGuard (advanced)

  • StallGuard Enabled — the TMC2209 stall reaction (on by default). It can't be switched off while Vibration Stall Detection is off.
  • SGTHRS (stall threshold) / TCOOLTHRS — set by calibration.
  • SG_RESULT / TSTEP — live readouts.
  • IRUN value — the raw motor current register (up to 19); Motor Current shows the same setting in mA.
  • StallGuard Auto‑Tune (off by default) and Auto‑Tune Adjustments.
  • Speed — the raw speed in steps/s.

Physical buttons

The device has two buttons:

Button Action
Button 1 — one click (≤ 1 s) Ends a running calibration. Otherwise: if alarming → silence & clear; if moving → stop; if idle → close the cover.
Button 1 — double click Open the cover.
Wi‑Fi / Calibrate — 7 quick presses Start Auto‑Calibrate.
Wi‑Fi / Calibrate — hold 3–10 s Clear the saved Wi‑Fi and reboot into setup mode.

With Child Lock on, Button 1 ignores presses, except to end a running calibration.

Clone this wiki locally