MyHOME for Home Assistant¶
Welcome to the official documentation for the MyHOME Home Assistant integration.
This integration connects your BTicino / Legrand MyHOME SCS bus systems via OpenWebNet IP & Serial gateways (such as F454, MH200, MH200N, MH201, MH202, MyHomeServer1, F461, or Legrand 3578 USB) directly into Home Assistant.
🌟 Next-Gen Architecture: v2.0¶
The v2.0 architecture represents a complete modernization of the integration, featuring:
- UI-First Configuration: Streamlined gateway setup, automatic on-wire bus discovery, and device management via Home Assistant's native Config Flow and Options Flow (with backward compatibility for existing
myhome.yamlfiles and SCS groups). - Native Automation Device Triggers: Automate physical CEN (
WHO = 15) and CEN+ (WHO = 25) scenario pushbuttons directly in Home Assistant's automation builder (Short press, Long press, Release, and Rotary Encoder dials). - In-Band Diagnostic Bus Monitor: Real-time Lovelace card (
custom:myhome-bus-card) providing live OpenWebNet frame monitoring, filtering, bus sweeping, and 1-click trace export without consuming extra gateway sockets. - Diffusione Sonora Dynamic Proxy: Stream music from Music Assistant or Spotify into BTicino analog audio matrix amplifier zones (
WHO = 16) with automatic power management and anti-hiss gain staging. - Decoupled OWNd 2.0 Engine: Clean protocol abstraction preventing drift, backed by 1,600+ regression tests with 100% code coverage.
🧭 Navigation & Quick Links¶
-
Step-by-step setup, adding your gateway via Config Flow, and initial bus scan.
-
F454, MyHomeServer1, MH200N, HMAC authentication, keep-alive, and worker tuning.
-
SCS on/off relays, dimmers, DALI DT8 tunable white, and RGB colour modes.
-
Timed-cover positioning model, full-run calibration, and hardware status tracking.
-
Thermoregulation zones, 4-pipe fan-coils, push-driven temperature probes (
WHERE ≥ 100). -
F441/F441M matrix routing, multiroom streaming proxy, and decoder pooling.
-
Physical wall buttons, scenario triggers, and ready-to-use blueprints.
-
Real-time Lovelace bus monitor card, trace capture, and bus sweep utility.
-
Comprehensive resolution guide for Home Assistant Repairs and diagnostic telemetry.
-
Step-by-step roadmap to migrate from legacy v0.9.4 YAML plants to the v2 architecture.
📦 Compatibility Matrix¶
| Hardware Gateway | Protocol Transport | Concurrent Sessions | HMAC Authentication | Recommended Worker Count |
|---|---|---|---|---|
| MyHomeServer1 | TCP (20000) |
4 | Yes | 2 |
| F454 / F455 | TCP (20000) |
2–3 | Optional | 1 |
| MH200N / MH201 / MH202 | TCP (20000) |
1 | No | 1 |
| F452 / F452V / MHServer | TCP (20000) |
1 | No | 1 |
| Legrand 3578 | USB / RS232 Serial | 1 | N/A | 1 |
🛠️ Need Help?¶
- 💬 Join community discussions on the OpenWebNet-HA GitHub Organization.
- 🐛 Report bugs or submit diagnostic traces via GitHub Issues.
- 📖 Inspect OpenWebNet protocol specifications in the WHO Catalog.