Home Assistant Guide

Home Assistant Guide

Glasscalibur runs ESPHome, so Home Assistant talks to it over the native ESPHome API — no configuration.yaml edits, no command_line covers, no curl. The device shows up as a real cover entity, plus entities for every setting and sensor.

Step 1 — get the device on your network

Complete Wi‑Fi Setup first so the device is on the same network as Home Assistant.

Step 2 — add the integration

In most cases Home Assistant auto‑discovers the device:

1. Go to Settings → Devices & Services.
2. Look for a discovered ESPHome device named glasscalibur-XXXXXX and click Configure / Add.

If it isn't auto‑discovered, add it manually:

1. Settings → Devices & Services → Add Integration.
2. Choose ESPHome.
3. Enter the host glasscalibur-XXXXXX.local (or the device's IP address) and port 6053.

"Communication not encrypted" warning

By default this firmware runs the API without an encryption key, so Home Assistant may warn that communication isn't encrypted. The device works normally despite the warning. To remove it, add an encryption key to the firmware and re‑flash — see the firmware README and the api: section of the config. Home Assistant will then prompt you for that key when you add the device.

Step 3 — use it

Once added you get one device with many entities, including:

• cover.glasscalibur — open / close / stop / set position (0–100 %).
• Number entities for speed, acceleration, current (irun), StallGuard, and the schedule.
• Switches for Schedule Enabled, Sun Schedule, Tamper Detection, StallGuard Enabled, etc.
• Sensors for State, Motor Temperature, Wi‑Fi signal, position, and the lifetime trip counters.

Add the cover to your dashboard

1. Open a dashboard and click Edit Dashboard → Add Card.
2. Choose an Entity (or Entities) card and pick cover.glasscalibur.
3. (Optional) In the entity settings, set Show as → Window for a window icon.

Step 4 — automate

Because it's a native cover entity, you can use it in any Home Assistant automation, script, or scene — for example:

• Close the window when an air‑quality sensor reports bad outdoor air.
• Open at sunrise (or use the device's own sun schedule).
• Close when a weather integration forecasts rain.
• Coordinate with your thermostat to cool a room with outside air.

You can build these in the Automations UI or in Node‑RED via the Home Assistant nodes.