Skip to content

Einrichtung Mapping

Herr Klaus edited this page May 4, 2026 · 7 revisions

Einrichtung & Mapping

Nach dem Start ist die Bridge unter http://<IP-DES-SERVERS>:8555 erreichbar.

1. Der Setup Wizard

Beim ersten Aufruf begrüßt dich der Assistent:

  1. Suchen: Die Bridge sucht im Netzwerk nach deiner Hue Bridge.
  2. Koppeln: Du musst den großen runden Knopf auf der Hue Bridge drücken.
  3. Loxone: Gib die IP deines Miniservers und den UDP-Port (Standard 7000) ein.

2. Das Dashboard

Hier verknüpfst du deine Loxone-Logik mit den Hue-Geräten.

Neue Verbindung erstellen

  1. Gib links einen eindeutigen Namen ein (z.B. kueche oder bwm_flur). Dieser Name wird später in Loxone verwendet.
  2. Wähle rechts das Hue Gerät aus.
  3. Klicke auf Speichern.

Tabs & Funktionen

  • 💡 Lichter: Übersicht aller Lampen.
    • Gruppierung: Eingeschaltet 💡 / Ausgeschaltet 🌑.
    • Sync: Aktiviere die Checkbox Sync, wenn Statusänderungen (z.B. durch Alexa) aktiv an Loxone gemeldet werden sollen.
  • 📡 Sensoren: Übersicht deiner Sensoren.
    • Gruppierung: 🚪 Türkontakte / 🏃 Bewegungsmelder / 📡 Sonstige.
  • 🔘 Schalter: Übersicht deiner Taster und Dimmer.
  • ⚙️ System: Einstellungen, Backup & Logs.
  • 🩺 Diagnose (Erweitert in V2.3): Umfassender Gesundheitscheck deiner Installation in drei Sektionen:
    1. 📋 Geräte & Batterien: Alle gemappten Geräte im Überblick. Leere Batterien (≤ 10 %) werden rot hervorgehoben.
    2. 🌐 Bridge & Zigbee: Zeigt den Verbindungsstatus (connected / connectivity_issue) jedes einzelnen Geräts sowie Bridge-Details.
    3. 🎭 Lampen-Fähigkeiten: Tabelle, die zeigt, welche Lampe Dimmen, Farbe oder Weißtöne unterstützt und welche Effekte möglich sind.

3. System & Wartung (Tab ⚙️)

Wartung & Backup (Neu in V2.0)

Hier kannst du deine Installation sichern und verwalten:

  • 📜 Logs herunterladen: Lädt das Systemprotokoll als Textdatei (letzte 10.000 Einträge).
  • 🔄 Server Neustart: Startet den Prozess sauber neu.
  • 💾 Backup erstellen: Lädt eine JSON-Datei herunter, die deine Config und alle Mappings enthält.
  • 📂 Backup wiederherstellen: Spielt ein Backup ein (überschreibt aktuelle Einstellungen).

Einstellungen

  • Übergangszeit (Fade): Standard-Dauer für Lichtübergänge (Standard: 400ms).
  • Befehls-Drosselung (Queue): Mindestzeit zwischen zwei Hue-Befehlen (Standard: 100ms). Erhöhe dies bei "429 Rate Limit" Fehlern.
  • MQTT: Konfiguration für externe Broker (Home Assistant etc.).

💡 Der "Alles" Befehl

Die Namen all und alles sind reserviert.

  • Nativ (Neu in V2.3): Ein Befehl an /all/0 (oder /all/1) nutzt die native bridge_home Funktion der Hue Bridge. Das gesamte Haus wird nahezu zeitgleich geschaltet.
  • Sequentiell (Fallback): Falls die native Funktion nicht verfügbar ist, schaltet die Bridge automatisch alle gemappten Lichter nacheinander mit 100ms Verzögerung aus.

Weiter geht's hier