Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 17 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
# Glasscalibur — automatic window opener

Glasscalibur opens and closes horizontal sliding windows with a small stepper motor,
a lead screw and a sliding ram. It runs [ESPHome](https://esphome.io) on an ESP32‑C6, so you can
Glasscalibur opens and closes horizontal sliding windows, and single‑ and double‑hung
windows (one unit mounted at the center of the sash), with a small stepper motor, a lead
screw and a sliding ram. It runs [ESPHome](https://esphome.io) on an ESP32‑C6, so you can
control it from a web browser on your network with no app or cloud account, pair it
with Home Assistant, put it on a schedule, or drive it from anything that can send
an HTTP request.
Expand Down Expand Up @@ -73,11 +74,23 @@ All of these come from the firmware in [`firmware/`](firmware):
- **In the kit:** the unit; two mounts with VHB pads and optional screws; three
140.5 mm extension tubes; three 30 mm connector rods; final rods A (150 mm) and
B (180 mm); two M10 jam nuts; the egress nut; the 24 V adapter.
- **Fit:** 21.1–37.6 in (535–956 mm) between the jamb and sash mount faces with the
window closed, using one to three extension tubes.
- **Windows:** horizontal sliding, single‑hung and double‑hung. On a hung window, mount
one unit at the center of the sash.
- **Fit:** 20.5–36.9 in (519–939 mm) between the frame and sash surfaces where the
mounts go, measured along the direction the window slides, with the window closed.
The span sets the parts (table below).
- **Power:** use only the supplied 24 V DC adapter. USB powers the board for flashing
but can't run the motor.

| Span (mm) | Extension tubes | Final rod |
|---|---|---|
| 519–628 | 1 | A (150 mm) |
| 629–658 | 1 | B (180 mm) |
| 659–769 | 2 | A |
| 770–799 | 2 | B |
| 800–909 | 3 | A |
| 910–939 | 3 | B |

1. Mount the unit with its two end mounts (VHB tape; an optional screw in each).
2. Join it to your Wi‑Fi (see [first setup](firmware/README.md#first-setup)).
3. Run **Auto‑Calibrate** once. Until a calibration succeeds, the speed is locked
Expand Down
29 changes: 29 additions & 0 deletions tools/regression-gate/predictions/2026-11-docs-fit-window-types.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
# Docs: window types and the corrected fit

Ruling 44, 2026-11-11. Registered before any edit. Base: origin/main d707dc5. Branch
docs/fit-window-types. Docs only (README.md, plus the wiki's Home and Installation Guide pushed
separately); nothing under `firmware/` changes. Merges once CI is green.

## Changes
1. Window types: Glasscalibur also works on single-hung and double-hung windows, with one unit
mounted at the center of the sash. Added to the README's opening line and its install
overview, and to the wiki's Home and Installation Guide (which said horizontal sliding only).
The two photo captions stay: the photos show a horizontal sliding window.
2. Fit, from the corrected v1.8 model (head 351.06 mm mount face to mount face, plus 1.1 mm VHB per
side): 20.5-36.9 in (519-939 mm) between the frame and sash surfaces where the mounts go,
measured along the direction the window slides, window closed. Replaces 21.1-37.6 in
(535-956 mm), which used the September head length (369.8 mm).
3. Parts by span (README install overview and the wiki Installation Guide): 519-628 mm one tube +
rod A (150 mm); 629-658 one tube + rod B (180 mm); 659-769 two tubes + A; 770-799 two tubes + B;
800-909 three tubes + A; 910-939 three tubes + B.

## Checks
N1 The fit line in the README and the wiki reads 20.5-36.9 in (519-939 mm) with the measurement
definition; the chart's spans are contiguous from 519 to 939 mm; each inch value is its mm value
rounded inward to 0.1 in (519 -> 20.5, 939 -> 36.9). Sabotage: a chart with a gap, or an inch
value rounded outward (20.4), is flagged.
O1 No old fit number (21.1, 37.6, 535, 956, 369.8) remains in README.md, hardware/README.md or the
wiki (the predictions files are records and keep theirs). Sabotage: a planted old number is found.
D1 Links resolve; the entity reference is unchanged (66 rows).
W The push gate passes on the diff, the commits, the messages and the PR text; the wiki push passes
the same scans.
Loading