Home

Welcome to the MyHOME Integration Wiki

Important

📢 Official Documentation Moved: The official, version-dependent documentation for MyHOME is now hosted at https://openwebnet-ha.github.io/MyHOME/.

The new documentation platform features multi-version switching (stable / latest), instant full-text search, dark/light themes, and permanent links.

Welcome to the community documentation for the MyHOME for Home Assistant integration!

This integration connects your BTicino / Legrand MyHOME bus and OpenWebNet gateway (such as F454, MH200, MH201, MH202, MyHomeServer1, F461, or Legrand 3578 USB) directly to Home Assistant.

---

🧪 Next-Gen Architecture: v2.0 Beta

Note

Active Beta: The next-generation v2.0 architecture introduces 100% UI-first setup, automatic device discovery, native CEN/CEN+ UI device triggers, an in-band real-time Lovelace bus monitor card, and audio streaming Dynamic Proxy.

• 📖 Visit the v2.0 Beta Documentation Hub for an overview of next-gen features.
• 📚 Branch-versioned configuration guides for v2.0:
  • 🎵 Sound System / Media Player (WHO = 16) ↗
  • 🔘 CEN & CEN+ Scenario Pushbuttons (WHO = 15/25) ↗
  • 🏛️ Gateways & Connection Setup (WHO = 13) ↗
  • 🖥️ Lovelace Bus Monitor Card & Diagnostics ↗
  • 📋 Integration Services Reference ↗

---

🚀 Quick Links

🏗️ Architecture & Anti-Drift Safeguards

• Architecture & Anti-Drift Safeguards: How the decoupled OWNd 2.0 protocol engine and MyHOME v2.0 integration interact, and the 3-pillar sentinel architecture preventing protocol divergence.

🗺️ Project Roadmap & Milestones

• Roadmap & Milestones: Strategic release plan from v2.0 through v2.5 (Gold Quality Seal), architectural priorities, and Community Contributor Hall of Fame.

📜 Protocol Documentation & WHO Registry

• OpenWebNet Protocol & WHO Specifications Archive: Complete reference of all official BTicino WHO codes, document versions, frame syntax, hardware profiles, and community cross-check call.

⚙️ Stable (v0.9.x) Configuration Guides

• General Configuration Overview (v0.9.x YAML)
• Lights Configuration
• Covers & Shutters Configuration
• Switches & Relays Configuration
• Climate & Thermoregulation
• Sensors (Energy, Temperature, etc.)
• Binary Sensors (Dry Contacts, etc.)

🔄 Migration & Transition Tools

• Migrating from SDomotica to MyHOME: Zero-touch migration guide and automated CLI tool to import existing SDomotica setups, preserving entity IDs, dashboards, automations, and history.

💡 Advanced Usage

• Advanced Uses & Scenarios
• Complete Sample Configuration
• Legacy Configuration (Pre-v0.9)