Projekt loxHueBridge - Bidirektionale Philips Hue V2 Anbindung

[bausi2k]

Hallo zusammen,

da das Thema "Philips Hue & Loxone" uns alle immer wieder beschäftigt und die Ansprüche an Reaktionszeit und Komfort steigen, habe ich mich in den letzten Wochen an ein neues Projekt gewagt, das ich heute gerne mit euch teilen möchte: die loxHueBridge.

Vorab ein großes Dankeschön: Dieses Projekt wäre ohne die Vorarbeit der Community nicht entstanden. Ein ganz besonderer Dank geht an @Andreas Lackner. Sein PicoC-Skript war jahrelang der Goldstandard für die Hue-Integration und hat mir (und sicher vielen anderen hier) gezeigt, was möglich ist. Seine Arbeit war die Inspiration und das Fundament, auf dem ich aufgebaut habe, um den nächsten technologischen Schritt zur neuen Hue API zu machen. Danke Andreas! 🙏

Warum eine neue Lösung? Mit der Einführung der Philips Hue API V2 hat Signify (Philips) die Art der Kommunikation grundlegend geändert. Anstatt die Bridge ständig zu fragen "Gibt es was Neues?" (Polling), schickt die Bridge nun aktiv Änderungen an uns (Server-Sent Events / Push).

Das bedeutet:

1. Echtzeit: Wenn ihr einen Hue-Dimmer dreht oder ein Bewegungsmelder auslöst, weiß Loxone das im Millisekunden-Bereich.
2. Entlastung: Der Miniserver und die Hue Bridge werden nicht mehr mit HTTP-Abfragen bombardiert.

Was kann die loxHueBridge?

Die Bridge läuft als Docker-Container (z.B. auf einem LoxBerry, Raspberry Pi, Synology NAS oder Unraid) und bietet eine bidirektionale Schnittstelle:

• Loxone ➡️ Hue (HTTP):
  • Schalten, Dimmen, Warmweiß (Smart Aktor Logik) & RGB.
  • Intelligente Umrechnung: Sendet Loxone RGB an eine "nur weiße" Lampe, rechnet die Bridge das automatisch in die passende Farbtemperatur um.
• Hue ➡️ Loxone (UDP):
  • Rückmeldung von Status, Helligkeit, Temperatur und Bewegung in Echtzeit.
  • Unterstützung für Hue Taster und Rotary Switches (z.B. Tap Dial Switch).
  • Batteriewarnung (Anzeige im UI + Übertragung an Loxone).

Features für eine einfache Einrichtung:

Ich habe viel Wert darauf gelegt, dass man kein Programmierer sein muss, um das Ding zum Laufen zu kriegen:

• Setup Wizard: Ein Web-Interface führt euch durch das Pairing mit der Hue Bridge (Knopf drücken -> verbunden).
• Grafisches Mapping: Ihr wählt links den Loxone-Namen und rechts die Hue-Lampe aus. Kein händisches Suchen von UUIDs.
• Smart Import: Die Bridge generiert euch fertige XML-Vorlagen. Ihr müsst die Befehle nicht tippen, sondern importiert einfach die "Virtuellen Ausgänge" und "UDP Eingänge" direkt in die Loxone Config.
• Live Dashboard: Im Browser seht ihr sofort, was eure Sensoren gerade melden (inkl. farbigen Icons, Temperaturwerten, etc.).

Installation:

Das Projekt ist als fertiges Docker Image verfügbar (kein Builden mehr nötig). Eine docker-compose.yml reicht aus:

YAML
services:
loxhuebridge:
image: ghcr.io/bausi2k/loxhuebridge:latest
container_name: loxhuebridge
restart: always
network_mode: "host" # Wichtig für UDP Kommunikation
environment:
- TZ=Europe/Vienna
volumes:
- ./data:/app/data[ 

(Hinweis für Mac/Windows User: Dort funktioniert der host Mode von Docker nicht wie unter Linux, siehe Readme für Workaround).

Wo findet ihr es?

Der Code, die detaillierte Anleitung und das Docker-Setup liegen auf GitHub: 👉 https://github.com/bausi2k/loxhuebridge

Ein Hinweis in eigener Sache: Ich habe das Projekt mit intensiver Unterstützung von KI (#kiassisted) entwickelt und bei mir produktiv im Einsatz (Version 1.0.0). Es läuft stabil, aber Software ist nie fehlerfrei. Ich freue mich über Feedback! Da mir aber die Zeit fehlt, das Projekt als Full-Time-Job zu betreuen, gilt: It's Open Source. Wenn ihr Features vermisst, forked das Repo gerne und baut weiter!

Viel Spaß beim Ausprobieren und "Licht an"! 💡

[bausi2k]

mittlerweile sind wir bei Version 1.4 - einfach im repo die releases anschauen https://github.com/bausi2k/loxhuebridge

[Simon2206]

Vielen Dank für dieses MEGA Stück Software und deine/eure Zeit!

[Alienuser]

Hallo zusammen,

das Projekt und die Idee finde ich grandios. Vielen lieben Dank dafür.

Ich habe folgende technische Frage:
Der Einrichtungsassistent fordert mich auf der Bridge den "Knopf zu drücken". Ich habe schon einen funktionierenden Token, welchen ich gerne verwenden möchte. Ich gehe einfach mal davon aus, dass dein Einrichtungsassistent, nach dem drücken des Knopfes, einen neuen Token von der Bridge bezieht und ihn im Verzeichnis "data" ablegt, richtig?

Kann ich den Einrichtungsassistenz in soweit überspringen, dass ich die Daten selbstständig im entsprechenden Order hinterlege? Wenn ja, wie sieht da die Struktur etc aus? Konnte dahingehend nichts finden.

PS: Ich habe die Frage auch mal in den Issues gestellt. Falls jemand das Projekt lediglich dort verfolgt.

Vielen Dank und einen schönen Tag.

[Alienuser]

Nachdem ich mir den Code angeschaut habe sieht die config.json im Verzeichnis "data" folgendermaßen aus:
{
"bridgeIp": "",
"appKey": "",
"loxoneIp": "",
"loxonePort": 7000,
"transitionTime": 400,
"debug": true
}

[bausi2k]

ich teste lokal am Mac, meine "Produktionsinstanz" ist auf meiner Synology, du kannst problemlos einen 2. Token anfordern, der alte geht nicht verloren.
Man kann auch V1 API und V2 API mischen, die Hue Bridge ist da sehr resistent :-)
Und ja, du kannst den Token auch selber eintragen, ich glaube, wenn der Token vorhanden ist, die IPs eingetragen sind, dann wird der Assistent übersprungen.


Viel Spaß damit