Skip to content

Getting Started & Configuration Overview

This guide walks you through onboarding, configuring, and automating your Legrand / BTicino MyHOME SCS installation with Home Assistant using the v2.0 UI-first architecture.

📋 Prerequisites

Before adding the integration to Home Assistant, ensure:

  1. Network Connectivity: Your OpenWebNet IP gateway (F454, MyHomeServer1, MH200N/201/202, F453AV) is connected to your local network and powered on.
  2. Fixed IP Address: A static IP address or permanent DHCP lease reservation on your local router is strongly recommended.
  3. OpenWebNet Password:
  4. For standard gateways (F454, MH201): Note your numeric (4 or 9 digits) or alphanumeric password configured in MyHOME_Suite or TiMyHome.
  5. For MyHomeServer1: Note the installer password configured via the MyHOME_Up app.
  6. If open LAN authentication is disabled on the gateway, no password is required.
  7. Integration Installed: The MyHOME custom component is installed (see the Installation Guide).

🚀 Step 1: Add the Gateway via Config Flow

In v2, gateway setup is 100% UI-first:

  1. In Home Assistant, navigate to Settings → Devices & Services.
  2. If your gateway is discovered automatically via SSDP or mDNS, click Configure on the discovery card.
  3. If adding manually:
  4. Click Add Integration in the bottom right corner.
  5. Search for MyHOME and select it.
  6. Fill in the connection parameters:
  7. Host: Gateway IP address (e.g. 192.168.1.50).
  8. Port: 20000 (default OpenWebNet port).
  9. Password: Your OpenWebNet or HMAC authentication password.
  10. Click Submit. Home Assistant will establish the command session (*99*0##) and event listening session (*99*1##), verify the gateway hardware identity, and create the gateway device entry.

For full parameter specifications and troubleshooting, see Gateways & Connection Setup.

🔍 Step 2: First Bus Discovery & Device Creation

Once connected:

  • Automatic Bus Scanning: The integration queries the SCS bus across supported subsystems (WHO = 1, 2, 4, 15, 18, 25).
  • Device Registry Linking: Discovered actuators, thermostats, and sensors are automatically grouped and linked to your gateway device via Home Assistant's via_device_id registry model.
  • Non-Destructive Transition: If you have an existing /config/myhome.yaml file from v0.9.4, entity names and physical SCS groups (#G) are read on startup as a compatibility overlay.
  • Organizing Entities: Open Settings → Devices & Services → Entities to customize entity names, assign rooms/areas (e.g. Living Room, Kitchen), and set custom icons.

⚙️ Step 3: Tune Integration Options

Fine-tune runtime parameters by clicking Configure on the MyHOME integration card:

  • Command Worker Concurrency: Number of asynchronous command workers (default: 1). Increase to 2–4 for high-throughput multi-session gateways like F454 or MHS1.
  • Dimmer Transition Mode: Choose between software_stepped (smooth 100-step software stepping managed by Home Assistant) and native (actuator hardware fade ramp).
  • Event Bus Broadcasting: Toggle whether raw bus frames are emitted as myhome_event events to Home Assistant for custom event automations.
  • Dynamic Proxy Decoders: Map network audio decoders (Music Assistant, Squeezelite) to physical F441 matrix source inputs for Diffusione Sonora.

📚 Detailed Subsystem Guides

Explore dedicated guides for each MyHOME subsystem:

Subsystem / Feature OpenWebNet WHO Documentation Guide
Gateways & Hardware Identification WHO = 13 Gateways & Connection Setup • Gateway Identification
Lighting & Dimmers WHO = 1 Lights & Dimmers Guide
Motorized Covers & Shutters WHO = 2 Covers & Shutters Guide
Heating & Climate Control WHO = 4 Climate & Heating Guide
Diffusione Sonora (Sound System) WHO = 16 Sound System / Media Player Guide
Scenario Pushbuttons & Rotary Dials WHO = 15, WHO = 25 CEN & CEN+ Device Triggers Guide
Switches, Relays & Sockets WHO = 1 Switches & Relays Guide
Electrical Energy & Power Meters WHO = 18 Sensors & Energy Guide
Dry Contacts & Motion Detectors WHO = 25, WHO = 1 Binary Sensors & Contacts Guide
Burglar Alarm Central Units WHO = 5 Burglar Alarm Guide
Integration Service Actions All WHOs Services Action Reference
In-Band Bus Monitor All WHOs Lovelace Bus Monitor Card
Troubleshooting & Known Limits All WHOs Troubleshooting Guide • Known Limitations