Zusammenfassung #

Die GHL API ist ein lokales, offenes Protokoll, mit dem Home- und Gebäudeautomationssysteme Daten von ProfiLux- und Mitras-Geräten auslesen, Sollwerte schreiben und Funktionen wie Futterpause oder Wasserwechsel auslösen können. Dieser Artikel gibt einen kurzen Überblick — die vollständige technische Referenz, die Nutzungsbedingungen und die Möglichkeit, den API-Zugriff zu aktivieren, finden Sie auf der GHL-API-Seite.

Gilt für #

• ProfiLux 4 Serie (inkl. Industrial Line / IL) (min. Firmware 7.31)
• Mitras LX8 Serie
• Mitras LX7 Serie (inkl. Industrial Line / IL) (min. Firmware 1.13)

Übersicht #

Die GHL-API ermöglicht externen Programmen den direkten, lokalen Zugriff auf Ihre ProfiLux- und Mitras-Geräte. Im Großen und Ganzen bietet sie Ihnen folgende Möglichkeiten:

• Gerätedaten auslesen: Sensorwerte (Temperatur, pH, Redox, Leitfähigkeit), KH-Director- und ION-Director-Messwerte, Schaltkanal-Zustände und Laststrom, Füllstände der Dosierpumpen sowie Durchfluss-/Niveau-Sensor-Zustände.
• Sollwerte und Namen schreiben: Zielwerte für Sensoren, KH Director und ION Director ändern sowie die Namen von Sensoren, Schaltkanälen, Dosierpumpen und anderen Ressourcen aktualisieren.
• Funktionen auslösen: Futterpause, Wasserwechsel und Wartungsmodus starten oder stoppen; Licht-Szenarien und Gewitter-Simulation aktivieren.
• Gespeicherter Messverlauf: Zuvor aufgezeichnete Sensorwerte abrufen, nicht nur den aktuellen Messwert.

Funktionsweise #

• Lokale Verbindung: Die API läuft vollständig in Ihrem lokalen Netzwerk über einen einfachen TCP-Port. Es ist kein Cloud-Dienst und kein Konto erforderlich.
• Klartext-Befehle: Es gibt nur zwei Befehlstypen — GET zum Auslesen eines Werts und SET zum Schreiben eines Werts oder Auslösen einer Aktion. Beispiel: GET SENSOR[0] ACTVALUE[0] liefert ACK <24.412>.
• Nur Lesezugriff oder Vollzugriff: Die API ist standardmäßig deaktiviert. Wenn Sie sie auf dem Gerät aktivieren, wählen Sie zwischen reinem Lesezugriff oder vollständigem Lese-/Schreibzugriff.
• Ihre bestehende Regelung läuft weiter: Die API kann Werte auslesen, Sollwerte schreiben und bestimmte Funktionen auslösen — die eigenen Regelkreise des ProfiLux, etwa das temperaturabhängige Schalten einer Heizung, laufen jedoch unabhängig von der API-Verbindung weiterhin direkt auf dem Gerät.

Systemanforderungen #

• Geräte-Firmware: Die ProfiLux 4 Serie benötigt mindestens Firmware 7.31, die Mitras LX7 Serie mindestens Firmware 1.13. Einige neuere Funktionen erfordern eine aktuellere Firmware — die jeweils aktuelle Mindestversion pro Funktion finden Sie auf der GHL-API-Seite.
• Netzwerkmodul-Firmware: Erfordert ein ESP-WiFi-Netzwerkmodul mit Firmware 7141 oder höher. Ist die API trotz korrekter Netzwerkeinstellungen nicht erreichbar, aktualisieren Sie die Firmware des Netzwerkmoduls — siehe Firmwareupdate & Wiederherstellung.
• Lokales Netzwerk: Das Gerät muss in Ihrem lokalen Netzwerk erreichbar sein — siehe Netzwerk (LAN & WiFi) – Einrichtungsanleitung.

Beispiel / Anwendungsfall #

Ein typischer Anwendungsfall ist die Anzeige von Aquariumwerten auf einem Home-Automation-Dashboard neben der übrigen Gebäudetechnik — zum Beispiel Temperatur, pH und KH neben der Heizungs- und Beleuchtungssteuerung, wobei Sensoren und Steckdosen mit denselben Namen beschriftet sind, die in GHL Connect oder GHL Control Center konfiguriert wurden. Fertige Beispiele für Home Assistant und Python finden Sie auf der GHL-API-Seite.