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

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 con 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:

sudo 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:

Utilizzo

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

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.