Aquarium und Gebäude auf einem Panel — die Wasserwerte kommen über die GHL API vom ProfiLux
Ihr ProfiLux steuert bereits Ihr Aquarium, Ihr Mitras beleuchtet es. Die GHL API holt den Rest Ihres Automationssystems dazu — lesen Sie aus, was das Gerät misst, ändern Sie Einstellungen und lassen Sie es etwas ausführen.
Was Sie mit der GHL API machen können
- Ihr Aquarium im selben System wie alles andere. Temperatur, pH, Redox und Leitfähigkeit auf demselben Bildschirm, der schon die übrige Gebäudetechnik anzeigt.
- Karbonathärte und Ionenkonzentrationen. KH vom KH Director und fünf Messwerte vom ION Director, darunter Calcium und Magnesium — dieselben Werte, mit denen der ProfiLux regelt.
- Strom und Geräte auf einen Blick. Welche Steckdosen eingeschaltet sind und wie viel Strom jede einzelne zieht.
- Unter den Namen, die Sie vergeben haben. Sensoren, Steckdosen und Dosierpumpen melden die im GHL Control Center oder in GHL Connect vergebenen Bezeichnungen, sodass im Panel „Schaubecken” und „Heizer” steht statt Indexnummern.
- Historie, nicht nur der aktuelle Wert. Der ProfiLux zeichnet seine Messwerte selbst auf, in nichtflüchtigem Speicher. Die API gibt diese gespeicherten Datensätze heraus — Zeitstempel, Werte und Status —, sodass die Historie verfügbar ist, ohne rund um die Uhr abzufragen.
- Warnungen und Alarme, bevor etwas schiefgeht. Messwerte von Niveau- und Strömungssensoren, Sensoralarme und der Füllstand der Dosierbehälter.
- Fütterpause als Teil Ihrer Automation. Starten und beenden Sie sie über einen Wandschalter, ein Dashboard oder per Sprachbefehl.
- Wasserwechsel und Wartung genauso. Beide Modi lassen sich von Ihrem System aus starten und beenden.
- Lichtszenen auf Abruf. Eine von acht gespeicherten Szenen, abgerufen mit einer Überblendzeit Ihrer Wahl — gedämpftes Licht für den Abend oder volle Helligkeit, um genauer hinzusehen. Die Szene bleibt aktiv, bis sie wieder abgeschaltet wird.
- Ein Gewitter auf Abruf. Von der Gebäudeautomation gestartet.
- Sollwerte aus Ihrem eigenen System. Ändern Sie die Solltemperatur, den KH-Wert oder einen Wert des ION Director von Ihrem Dashboard aus.
Einfach – In fünf Minuten ausprobiert
Lokal. Keine Cloud nötig.
Alles läuft in Ihrem eigenen Netzwerk, über einen einfachen TCP-Port oder einen WebSocket. Kein Cloud-Dienst ist beteiligt, keine Daten verlassen Ihr Netzwerk, und nichts hört auf zu funktionieren, weil irgendwo ein Server ausgefallen ist.
Die Steuerung bleibt beim Controller
Die GHL API liest Werte aus und fordert Aktionen an. Sie schaltet keine Ausgänge und ersetzt keinen Regelkreis.
Die Temperaturregelung ist das deutlichste Beispiel. Wird das Wasser zu kalt, schaltet der ProfiLux den Heizer — nicht das Automationssystem, das Sie daran angeschlossen haben. Deshalb bietet die API keinen direkten Zugriff auf Ausgänge: Ein Netzwerkausfall oder ein abgestürzter Server darf niemals dazu führen, dass ein Aquarium unbeheizt bleibt.
Testkonsole im GHL Control Center – ebenfalls in der GHL Connect App verfügbar
Kein SDK. Keine Bibliothek. Kein Konto, keine Registrierung, kein Entwicklerportal.
Die Befehle sind einfache Textzeilen, und es gibt genau zwei davon: GET fragt einen Wert ab, SET schreibt einen oder startet etwas. Alles Weitere ist einfach der Name dessen, was Sie erreichen wollen.
Hier ein vollständiger Austausch. Die erste Zeile fragt beim Controller die aktuelle Temperatur des ersten Sensors ab. Die zweite Zeile ist seine Antwort: 24,412 °C.
GET SENSOR[0] ACTVALUE ACK <24.412>
Mehr ist es nicht. Wer ein Terminal öffnen kann, kann diese API nutzen — und Sie können jeden Befehl im GHL Control Center oder in GHL Connect ausprobieren, bevor Sie eine einzige Zeile Code schreiben.
Die API ist standardmäßig abgeschaltet, und Sie geben sie am Gerät selbst frei — entweder nur zum Lesen oder mit vollem Zugriff. Nichts in Ihrem Netzwerk erreicht Ihr Aquarium, solange Sie es nicht entschieden haben.
Fertige Beispiele für Home Assistant, Python und WebSocket-Clients liegen der Referenz bei.
Welche Geräte
ProfiLux 4, ProfiLux 4.1 und deren Varianten sowie die Leuchten Mitras LX7, Mitras LX8 und Mitras LX7 IL.
Der ProfiLux stellt Sensoren, Sollwerte, Schaltkanäle, Dosierpumpen, Strömungs- und Niveausensoren, KH Director, ION Director und die gespeicherte Messwerthistorie bereit. Der Mitras bietet Zugriff auf seine Beleuchtungskanäle und Tagesverläufe.
Für Systemintegratoren
Die API ist ein dokumentiertes Textprotokoll über einen einfachen TCP-Port oder einen WebSocket. Auf Ihrer Seite wird keine GHL-spezifische Software, kein Treiber und keine Bibliothek benötigt — jedes System, das einen Socket öffnen kann, liest alle Messwerte, alle Gerätezustände und die gespeicherte Historie aus, schreibt Sollwerte und Bezeichnungen und löst Spezialfunktionen wie Fütterpause, Wasserwechsel oder Wartung aus.
Das Gerät lässt sich auch auf reinen Lesezugriff einstellen. Die Gebäudeleittechnik sieht dann alles und kann nichts verändern.
Die GHL API stellen wir kostenlos zur Verfügung, „as is” und ohne Support. Die vollständigen Nutzungsbedingungen sehen Sie, bevor sich die Referenz öffnet. Für die Integration in Ihr System bietet GHL kostenpflichtige Leistungen an.
Bitte beachten: Manche der genannten Features erfordern P4 Firmware V7.52, LX7 Firmware V1.22, GCC V1162 oder die nächste Version der App. Alle Updates werden in den nächsten Tagen veröffentlicht.
Nutzungsbedingungen für die GHL API
Mit dem Setzen des Hakens bestätige ich, dass ich Folgendes gelesen habe und akzeptiere.
Die GHL API wird kostenlos und ohne Gewähr zur Verfügung gestellt. GHL übernimmt keine Zusicherung dafür, dass sie für einen bestimmten Zweck geeignet, fehlerfrei oder unterbrechungsfrei verfügbar ist oder meinen Erwartungen entspricht.
Die Nutzung ist freiwillig und erfolgt auf eigenes Risiko. Ich bin für die Software verantwortlich, die ich anbinde, für die Befehle, die ich sende, und für deren Auswirkungen auf mein Aquarium und die daran angeschlossenen Geräte.
Mir ist bekannt, dass die API ab Werk abgeschaltet ist und ich sie durch eigene Entscheidung freischalte. Für die Sicherheit des Netzwerks, in dem sich mein Gerät befindet, bin ich selbst verantwortlich.
Die API darf nicht als alleiniges Mittel zur Überwachung oder Steuerung lebenserhaltender Funktionen eingesetzt werden. Die Regelung des Aquariums verbleibt bei meinem GHL-Steuergerät.
Soweit gesetzlich zulässig, übernimmt GHL keine Haftung für unmittelbare und mittelbare Schäden, Folgeschäden oder Verluste, die aus der Nutzung der API entstehen — insbesondere nicht für Schäden an Tierbesatz, Pflanzen, Geräten oder Sachwerten, für Datenverlust, entgangenen Gewinn oder sonstige Vermögensschäden. Dies gilt unabhängig vom Rechtsgrund des Anspruchs.
GHL kann die API jederzeit und ohne Ankündigung ändern, einschränken oder einstellen. Befehle können sich in künftigen Firmwareversionen anders verhalten.
Für die Nutzung der API steht kein kostenloser Support zur Verfügung. GHL prüft, empfiehlt und unterstützt keine Software von Drittanbietern.
Zuletzt aktualisiert am: 27. August 2026