How To: LED Matrix (AWTRIX) Integration in HomeKit / Shortcuts

Die Integration erfolgt dabei über Node-Red, HomeKit, Siri – für die Anzeige des aktuellen TV Senders & Programms (über VU+ Zero 4K SAT Box*), Musik Erkennung (durch Shazam, Kurzbefehl daher etwas zeitverzögert) sowie die Anzeige der nächsten Müllleerung / Abfuhrkalender (eingebunden über den Kalender des Smartphones, auch für mit Meetings möglich)

Finde es echt genial, dass dies endlich für mich funktioniert. Vielleicht ist dies auch für euch eine Inspiration.

Auswahl LED Matrix

Im ersten Schritt steht ganz klar die Entscheidung, wie möchte man Informationen / Daten auf einer LED Matrix visualisieren. Dabei bin ich auf das DIY Projekt AWTRIX gestoßen.
(siehe hierzu Software Installation des Controllers sowie Host bspw. auf einem Raspberry PI Zero W – für mich aktuell ausreichend)

Nach dem die LED Matrix läuft, geht es an die weitere Installation eines Node-Red Servers, in unserem Beispiel wieder auf einem Raspberry PI Zero W. Dies ermöglicht uns, dass wir eine visuelle Schnittstelle und auch die MQTT Kommunikation in Richtung der LED Matrix aufbauen.

Node-Red: Ausgabe auf AWTRIX

Um eine Anzeige auf AWTRIX aus Node-Red zu realisieren, kann man sich folgendem Code-Schnipsel bedienen.

msg.payload = {"name":"test","force":true,"icon":638,"text":"Happy Birthday","color":[51,204,51]};
msg.headers = {"content-type": "application/json"};
return msg;

In meinem aktuellen Setup greife ich u.a. auf eine VU+ Zero 4K SAT Box* zu. Um diese mittels Node-Red zu integrieren, bediene ich mich der Installation des Node-Red Enigma2 Subflow. Dieser Flow muss hierzu einfach nach Node-Red „kopiert“ werden. Am Besten nutzt man die entsprechende json-Datei als Download. (weiterführende Infos findet ihr bspw. auch im Homematic Forum).

Für meine Zwecke habe ich den Subflow etwas modifiziert. Dieser kann ebenfalls als json-Datei direkt in Node-Red importiert werden. Nach dem erfolgreichen Import einfach mittels deploy den Flow implementieren, und mittels Klick auf den send Knoten das Ganze einmal testen.

Die Ansteuerung zur AWTRIX erfolgt mittels einer Funktion:

msg.payload = {"name":"test","force":true,"icon":1064,"repeat":2,"text":""+msg.payload+"","color":[51,204,51]};
return msg;

Um die Anzeige auf AWTRIX zu vervollständigen, muss man mittels http request den Knoten bearbeiten. Natürlich ist hier die jeweilige URL der AWTRIX anzugeben, in der Form: http://192.168.178.48:7000/api/v3/notify

Die Sendernamen und Programmtitel werden über die Output-Knoten Channel – e2servicename und Eventname des Subflow Instance Enigma2 Receiver ausgelesen.

Für den Fall, dass das SAT TV ausgeschaltet ist, bediene ich mich einer weiteren Funktion:

var tv_off = "TV ist aus";

if (msg.payload == ": ")  {
    msg.payload = tv_off;
    return msg;
}
else {
    return msg;
}

Homebridge inklusive MQTT (optional)

Da wir bei der hier vorgestellten Integration über das Netzprotokoll MQTT gehen, bedarf es der Installation einer Homebridge Instanz sowie des entsprechenden PlugIns. Eine sehr gute Anleitung zur Installation von Homebridge auf einem Raspberry PI findet ihr u.a. auf smartapfel.de. Habt ihr Homebridge erfolgreich aufgesetzt, solltet ihr das PlugIn homebridge-mqtt mit installieren.