Rendere una striscia di LED colorati Wi-Fi compatibile con Apple HomeKit (via Homebridge)

SCOPI DEL PROGETTO:
  • Domotizzare una striscia di LED colorati Wi-Fi serie “Magic Home” in modo da porterli utilizzare con Apple HomeKit e Siri
  • Livello di difficoltà: medio/basso
  • Costo: in base al controller e ai LED implementati
CONCETTI AFFRONTATI:
COMPONENTI SOFTWARE UTILIZZATE:
DISPOSTIVI FISICI UTILIZZATI:
PROGETTO MAGGIORMENTE INDICATO PER:

Apple-200x200

Note e disclaimer
  • qualsiasi modifica all'impianto elettrico dev'essere effettuata da personale qualificato
  • qualsiasi modifica attuata in proprio è a propria responsabilità personale nonché a proprio rischio e pericolo (la presente guida ha puro scopo didattico)
  • qualsiasi modifica attuata in proprio a un dispositivo ne fa decadere la garanzia.

Controller LED RGBW Wifi - con telecomando

Abstract

homebridge-magichome-platform” è un plugin nato per permettere la piena integrazione (via Wi-Fi) dei sistemi di illuminotecnica LED basati sui controller Wi-Fi della linea “Magic Home”.

L’implementazione di tale plugin permette a Homebridge di rendere tali controller compatibile Apple HomeKit.

Questa guida illustra come installare e configurare tale plugin allo scopo sopra descritto.

Installazione

L’installazione, come tutti i plugin – è semplicissima.

Eseguire il seguente comando – su sistemi unix-based (linux, Raspberry ecc.) da terminale, da sistemi windows su prompt dei comandi:

npm install -g --unsafe-perm homebridge-magichome-platform

e attendere il termine della procedura.
Nb. In caso Homebridge sia già in esecuzione come servizio (come descritto nelle nostre guide di installazione), provvedere a interromperlo prima dell’installazione tramite il comando:

sudo systemctl stop homebridge

Configurazione

La configurazione del plugin prevede l’aggiunta al file di configurazione di Homebridge  di una nuova piattaforma chiamata “MagicHome-Platform“, la quale prevede sottoelementi di tipo:

  • lights
  • presetSwitches

Le “lights” rappresentano il/i controller da integrare, mentre “presetSwitches” rappresentano degli switch (interruttori) virtuali che appariranno presso l’app “Casa” e che permetteranno di attivare specifici giochi/effetti di luce (se previsti dal controller).

I giochi/effetti supportati sono:

  • seven_color_cross_fade
  • red_gradual_change
  • green_gradual_change
  • blue_gradual_change
  • yellow_gradual_change
  • cyan_gradual_change
  • purple_gradual_change
  • white_gradual_change
  • red_green_cross_fade
  • red_blue_cross_fade
  • green_blue_cross_fade
  • seven_color_strobe_flash
  • red_strobe_flash
  • green_strobe_flash
  • blue_stobe_flash
  • yellow_strobe_flash
  • cyan_strobe_flash
  • purple_strobe_flash
  • white_strobe_flash
  • seven_color_jumping 

Un esempio di integrazione presso il file config.json di Homebridge è il seguente:

{
	"platforms": [{
		"platform": "MagicHome-Platform",
		"debug": true,
		"lights": [{
				"name": "LED Cucina",
				"ip": "192.168.1.111",
				"setup": "RGBW",
				"purewhite": false,
				"timeout": 10000
			},
			{
				"name": "LED Sala",
				"ip": "DC4F22C5XXXX",
				"setup": "RGBWW",
				"purewhite": true
			}
		],
		"presetSwitches": [{
				"name": "Cucina - Color Strobe Flash (Party)",
				"ips": {
					"192.168.1.111": "255,255,255"
				},
				"preset": "seven_color_strobe_flash",
				"speed": 60
			},
			{
				"name": "Cucina e Sala - Cross Fade (Soothing)",
				"ips": {
					"192.168.1.111": "0,150,255",
					"DC4F22C5XXXX": "102, 255, 102"

				},
				"preset": "seven_color_cross_fade",
				"speed": 40,
				"shouldTurnOff": true
			},
			{
				"name": "Cucina e Sala - Jungle Mood (Soothing)",
				"ips": {
					"192.168.1.111": "0,150,255",
					"DC4F22C5XXXX": "102, 255, 102"
				},
				"preset": "green_gradual_change",
				"speed": 40
			}
		]
	}]
}

Tale integrazione crea presso “Casa”:

  • due luci chiamate “LED Cucina” e “LED Casa“;
  • tre switch per l’attivazione degli effetti chiamati:
    • Cucina – Color Strobe Flash
    • Cucina e Sala – Cross Fade
    • Cucina e Sala – Jungle Mood

LED Cucina” è definito tramite il suo indirizzo IP (192.168.1.111), mentre “LED Casa” tramite il suo indirizzo MAC (DC:4F:22:C5:XX:XX – notare come la configurazione preveda la rimozione dei “:”).

Gli switch contengono al loro interno, oltre alla profilazione dell’effetto da applicare, anche a quale luce facciano riferimento, usando appunto i relativi indirizzi IP e MAC delle rispettive luci come discriminante.

Spiegazione dei campi:

platformIl nome della piattaforma, necessariamente “Magic Home”
debugIndica a Homebridge se elencare nei log eventuali errori. Default: false
lightsdefinisce l’elenco delle luci da integrare:

nameIl nome da associare alla luce presso l’app “Casa”
ipL’indirizzo IP (fisso) o l’indirizzo MAC (eliminando i “:”) del controller da integrare
setupTipologia di controller. Può assumere i valori di “W”, “RGB”, “RGBW” o “RGBWW” in base al tipo di controller e striscia LED in uso
purewhiteIndica al plugin se il controller gestisce un canale di bianco puro. Default: false
timeoutQuanti secondi attendere prima di considerare irraggiungibile il controller. Impostando a 0, si disabilita il timeout
presetSwitchesdefinisce l’elenco degli effetti da integrare e per quali controller:

nameIl nome da associare allo switch presso l’app “Casa”
ipsElenco degli IP/MAC dei controller influenzati dall’attivazione di questo switch, seguito da una tripletta di valori relativi al valore RGB da applicare di default (da 0 a 255). “255, 255, 255” corrisponde al bianco pieno
presetL’effetto da applicare
speedLa velocità di esecuzione dell’effetto

Utilizzo

Una volta eseguito Homebridge appariranno presso casa una serie di luci/interruttori quanti saranno quelli definiti in configurazione:

demo homebridge-magichome-platform

 

Aggiornamento

Per aggiornare il package è sufficiente eseguire il seguente comando:

sudo npm update -g -dev homebridge-magichome-platform

avendo cura, precedentemente, di aver fermato eventuali esecuzioni di Homebridge in corso.


Homebridge Official LOGOATTENZIONE: ricorda che sul nostro community FORUM c'è una sezione ad hoc dedica a Homebridge, per qualsiasi dubbio, domanda, informazione nel merito specifico di queste componenti.

🔻 Clicca QUI per commentare l'articolo. 🔻