Home Assistant è la piattaforma open‑source più diffusa per la domotica domestica. Grazie alla sua architettura modulare è possibile collegare praticamente qualsiasi dispositivo, anche quelli più economici e “fai‑da‑te”. In questo articolo scoprirai, passo dopo passo, come integrare le strisce LED RGB(W) controllate via Wi‑Fi della serie Magic Home / Flux Led, come crearne scenari luminosi e come sfruttare le potenti automazioni di Home Assistant per rendere la tua casa più intelligente, più accogliente e più sicura.

Indice dei contenuti

1. Introduzione al mondo delle strisce LED Wi‑Fi
2. Prerequisiti hardware e software
3. Installazione del controller Magic Home
4. Integrazione in Home Assistant
5. Gestione tramite interfaccia grafica
6. Creazione di automazioni e scenari
7. Script avanzati e notifiche visive
8. Risoluzione problemi più comuni
9. Best practice e consigli di sicurezza
10. Riepilogo rapido

Introduzione al mondo delle strisce LED Wi‑Fi

Negli ultimi cinque anni le strisce LED sono passate da prodotto di nicchia a elemento fondamentale dell’arredamento domestico. Le ragioni sono molteplici:

• Efficienza energetica: consumano pochi watt per metro, ma offrono luminosità paragonabile a lampade tradizionali.
• Flessibilità cromatica: grazie al modello RGB(W) è possibile variare colore, temperatura e intensità con un semplice comando.
• Controllo remoto: i controller Wi‑Fi della serie Magic Home permettono di gestire le luci da smartphone, tablet o assistenti vocali.
• Costo contenuto: un kit completo (controller + striscia) può costare meno di 30 €, rendendolo accessibile anche a chi ha un budget limitato.

Quando questi controller vengono collegati a Home Assistant, si apre un ventaglio di possibilità: sincronizzazione con altri sensori, attivazione di effetti in risposta a eventi (es. allarme, apertura porte), integrazione con scene predefinite e persino utilizzo come segnale visivo per notifiche di sistema.

Prerequisiti hardware e software

Hardware necessario

Software richiesto

• Home Assistant Core (ultima versione stabile).
• App mobile Magic Home (Android o iOS) per la configurazione iniziale del controller.
• Editor di testo (es. VS Code, Nano) per modificare i file YAML di Home Assistant.
• Facoltativo: Node‑RED per flussi visuali avanzati.

Requisiti di rete

Il controller Magic Home comunica tramite protocollo UDP sulla porta 8899. È fondamentale che:

1. Il dispositivo Home Assistant e il controller siano sulla stessa subnet (es. 192.168.1.0/24).
2. Il router non blocchi il traffico UDP sulla porta 8899.
3. Se utilizzi VLAN o firewall, aggiungi una regola di “allow” per quel traffico.

Installazione del controller Magic Home

1. Collegamento fisico

1. Collega l’alimentatore da 12 V all’ingresso +12V del controller.
2. Unisci i cavi di alimentazione della striscia LED ai terminali OUT+ e OUT‑ del controller.
3. Collega i tre (RGB) o quattro (RGBW) cavi di segnale della striscia ai connettori corrispondenti del controller.
4. Verifica che la striscia si accenda brevemente (segno di alimentazione corretta).

2. Configurazione iniziale tramite app

Apri l’app Magic Home e segui questi passaggi:

• Premi il pulsante + Aggiungi dispositivo e scegli Wi‑Fi.
• Metti il controller in modalità “pairing” (di solito tenendo premuto il pulsante per 5 s finché il LED lampeggia).
• Seleziona la rete Wi‑Fi domestica (solo 2.4 GHz, non 5 GHz).
• Inserisci la password e attendi la conferma di connessione.
• Assegna un nome riconoscibile (es. LED_Soggiorno).

Al termine, l’app mostrerà la striscia con i controlli di colore, luminosità e modalità predefinite.

3. Aggiornamento firmware (opzionale ma consigliato)

Nel menu Impostazioni → Firmware verifica la presenza di aggiornamenti. Un firmware più recente migliora la stabilità della connessione UDP e aggiunge nuove modalità di effetto.

Integrazione in Home Assistant

3.1. Aggiungere l’integrazione “Magic Home”

Home Assistant dispone di un’integrazione nativa chiamata “Magic Home (Local Polling)”. Segui questi passaggi:

1. Accedi alla tua interfaccia Home Assistant.
2. Vai su Impostazioni → Dispositivi & Servizi → Aggiungi integrazione.
3. Cerca “Magic Home” e seleziona Magic Home (Local Polling).
4. Inserisci l’indirizzo IP del controller (es. 192.168.1.45) e la porta 8899.
5. Conferma; Home Assistant rileverà il dispositivo e creerà un’entità di tipo light (es. light.led_soggiorno).

3.2. Configurazione manuale via YAML (opzione avanzata)

Se preferisci gestire le integrazioni tramite file di configurazione, aggiungi la seguente sezione al file configuration.yaml:

light: - platform: magic_home name: LED Soggiorno host: 192.168.1.45 port: 8899 transition: 2 effect: true

Parametri chiave:

• name: nome visualizzato nell’interfaccia.
• host: IP del controller.
• port: porta UDP (default 8899).
• transition: tempo in secondi per le variazioni di colore (0 = immediato).
• effect: abilita le modalità “effetto” predefinite (rainbow, flash, ecc.).

Dopo aver salvato, riavvia Home Assistant (Impostazioni → Controlli del server → Riavvia) per rendere effettive le modifiche.

3.3. Verifica delle entità

Una volta integrato, nella sezione Entità troverai:

• light.led_soggiorno – entità principale.
• sensor.led_soggiorno_power – consumo in Watt (se supportato dal firmware).
• binary_sensor.led_soggiorno_online – stato di connessione.

Gestione tramite interfaccia grafica

4.1. Creazione di una card Lovelace

Per controllare la striscia direttamente dalla dashboard, aggiungi una card di tipo Light:

{"type": "light", "entity": "light.led_soggiorno", "name": "LED Soggiorno", "icon": "mdi:string-lights"}

Questa card mostra:

• Accensione/Spegnimento.
• Selettore colore a ruota.
• Slider di luminosità.
• Menu a tendina per le effect predefinite.

4.2. Card “Button” per effetti rapidi

Se desideri attivare rapidamente effetti come “Rainbow” o “Strobe”, usa una card Button con servizio light.turn_on:

{"type": "button", "tap_action": {"action": "call-service", "service": "light.turn_on", "service_data": {"entity_id": "light.led_soggiorno", "effect": "rainbow", "brightness": 200}}, "icon": "mdi:palette", "name": "Rainbow"}

4.3. Card “Entity” per visualizzare stato e consumo

Per monitorare il consumo in tempo reale aggiungi una card Entity che includa il sensore di potenza:

{"type": "entity", "entity": "sensor.led_soggiorno_power", "name": "Consumo LED", "icon": "mdi:flash"}

Creazione di automazioni e scenari

5.1. Automazione base: accensione al tramonto

Home Assistant dispone di sensori di luce ambientale (sun.sun) e di orari. Ecco un’automazione YAML che accende la striscia al tramonto con luce calda (3000 K) e 70 % di luminosità:

automation: - alias: "Accendi LED al tramonto" trigger: - platform: sun event: sunset condition: [] action: - service: light.turn_on target: entity_id: light.led_soggiorno data: brightness_pct: 70 color_temp: 370 # 370 corrisponde a ~2700 K

5.2. Automazione avanzata: notifica visiva per allarme

Supponiamo di avere un sensore di apertura porta (binary_sensor.porta_ingresso) collegato a un allarme. Quando la porta si apre in modalità “Away”, la striscia lampeggia in rosso per 10 secondi.

automation: - alias: "Allarme porta ingresso - LED rosso lampeggiante" trigger: - platform: state entity_id: binary_sensor.porta_ingresso to: "on" condition: - condition: state entity_id: alarm_control_panel.casa state: "armed_away" action: - repeat: count: 10 sequence: - service: light.turn_on target: entity_id: light.led_soggiorno data: rgb_color: [255, 0, 0] brightness: 255 - delay: "00:00:0.5" - service: light.turn_off target: entity_id: light.led_soggiorno - delay: "00:00:0.5"

5.3. Scena “Cinema” con dimming progressivo

Una scena è un insieme di stati predefiniti per più entità. Creiamo una scena “Cinema” che:

1. Abbassa le luci di zona a 10 %.
2. Imposta la striscia LED a colore caldo (2700 K) al 30 % di luminosità.
3. Attiva l’effetto “fade” per una transizione morbida. 

scene: - name: Cinema entities: light.luce_sala: state: on brightness_pct: 10 light.led_soggiorno: state: on brightness_pct: 30 color_temp: 370 transition: 5

Per attivare la scena, usa la card “Scene” di Lovelace o aggiungi un pulsante personalizzato.

5.4. Script “Party Mode” con ciclo di colori

Uno script permette di eseguire più azioni in sequenza. Ecco uno script che cicla tra tre colori (blu, verde, rosso) con effetto “strobe” per 30 secondi:

script: party_mode: alias: "Party Mode" sequence: - repeat: count: 30 sequence: - service: light.turn_on target: entity_id: light.led_soggiorno data: rgb_color: [0, 0, 255] # Blu effect: "strobe" brightness: 255 - delay: "00:00:1" - service: light.turn_on target: entity_id: light.led_soggiorno data: rgb_color: [0, 255, 0] # Verde effect: "strobe" brightness: 255 - delay: "00:00:1" - service: light.turn_on target: entity_id: light.led_soggiorno data: rgb_color: [255, 0, 0] # Rosso effect: "strobe" brightness: 255 - delay: "00:00:1"

Script avanzati e notifiche visive

6.1. Notifica di aggiornamento Home Assistant

Quando Home Assistant rilascia un nuovo aggiornamento, è utile ricevere una notifica visiva. Lo script seguente accende la striscia in giallo per 5 secondi, poi torna allo stato precedente.

script: ha_update_notify: alias: "Notifica Aggiornamento HA" sequence: - service: light.turn_on target: entity_id: light.led_soggiorno data: rgb_color: [255, 255, 0] # Giallo brightness: 255 - delay: "00:00:5" - service: light.turn_off target: entity_id: light.led_soggiorno

6.2. Integrazione con sensore di temperatura

Supponiamo di avere un sensore di temperatura (sensor.soggiorno_temperature) e vogliamo che il colore della striscia vari dal blu (freddo) al rosso (caldo) in base al valore.

automation: - alias: "Colore LED in base alla temperatura" trigger: - platform: state entity_id: sensor.soggiorno_temperature action: - service: light.turn_on target: entity_id: light.led_soggiorno data_template: rgb_color: > {% set temp = states('sensor.soggiorno_temperature')|float %} {% if temp < 18 %} [0,0,255] {# Blu #} {% elif temp < 24 %} [0,255,0] {# Verde #} {% else %} [255,0,0] {# Rosso #} {% endif %}

6.3. Integrazione con assistente vocale (Google Home / Alexa)

Home Assistant espone tutti i servizi come “entità” compatibili con gli assistenti vocali. Dopo aver configurato l’integrazione Google Assistant o Alexa, potrai dire:

• “Hey Google, accendi le luci del soggiorno”.
• “Alexa, imposta le luci del soggiorno al colore viola”.

Il risultato è identico a quello ottenuto tramite UI o automazioni.

Risoluzione problemi più comuni

7.1. Il controller non appare in Home Assistant

• Verifica IP: usa ping 192.168.1.45 dal server Home Assistant per confermare la raggiungibilità.
• Porta UDP bloccata: controlla le impostazioni del router; apri la porta 8899 in entrata/uscita.
• Firmware obsoleto: aggiorna tramite l’app Magic Home.
• Conflitto di rete: assicurati che non ci siano più controller con lo stesso IP (DHCP statico consigliato).

7.2. L’effetto “rainbow” non funziona

Alcuni firmware più vecchi non supportano tutti gli effetti. Prova a:

1. Aggiornare il firmware.
2. Verificare che il parametro effect: true sia presente nella configurazione YAML.
3. Utilizzare il servizio light.turn_on con effect: "rainbow" invece della UI.

7.3. La striscia lampeggia al riavvio di Home Assistant

Questo comportamento è normale se la configurazione prevede transition o effect al boot. Per evitarlo, aggiungi una automazione di “startup” che spegne la luce:

automation: - alias: "Spegni LED al riavvio" trigger: - platform: homeassistant event: start action: - service: light.turn_off target: entity_id: light.led_soggiorno

7.4. Consumo energetico non corretto

Il sensore di potenza è disponibile solo su firmware recenti. Se il valore è “0” o “unavailable”:

• Controlla la versione del firmware (minimo 1.5.0).
• Verifica che il controller sia configurato per inviare dati di potenza (opzione “Power reporting” nell’app).
• Se il problema persiste, riavvia il controller tenendo premuto il pulsante per 10 s.

Best practice e consigli di sicurezza

Consigli pratici per l’installazione

• Gestione del calore: le strisce LED di 5 m possono generare calore; posizionale su superfici ventilate o usa profili in alluminio.
• Protezione da umidità: per ambienti esterni scegli strisce con grado di protezione IP65 e assicurati che il controller sia in una scatola impermeabile.
• Cablaggio ordinato: utilizza fascette e canaline per nascondere i cavi, evitando interferenze elettromagnetiche.
• Test preliminare: prima di fissare la striscia, verifica il corretto funzionamento di tutti i colori e gli effetti.

Riepilogo rapido

Seguendo questi passaggi potrai trasformare semplici strisce LED in un vero centro di comando luminoso, integrato con tutta la tua domotica. Che tu voglia creare atmosfere accoglienti, segnalare eventi di sicurezza o semplicemente aggiungere un tocco di colore alla tua casa, Home Assistant ti offre la flessibilità necessaria per realizzare ogni idea.

Buona configurazione e buona illuminazione!