PoolStation Logikbaustein für Gira X1 und L1

Endanwender-Dokumentation · Paketversion 1.5.7 · Stand: 12. Juli 2026

1. Produktübersicht

Der PoolStation Logikbaustein bindet einen über die Poolstation-Cloud erreichbaren Pool in den Gira X1 oder Gira L1 ein. Der Baustein liest Wasserwerte, Sollwerte, Wasserfluss, UV-Diagnose, vier Binäreingänge und bis zu vier Relais aus. Die Werte stehen anschließend für Visualisierung, Meldungen und weitere GPA-Logiken zur Verfügung.

Die Abfrage kann automatisch in einem einstellbaren Intervall oder manuell über einen Trigger erfolgen. Bei abgelaufener Sitzung meldet sich der Baustein automatisch erneut an. Eine gültige, an das Gerät gebundene Lizenz ist Voraussetzung für Poolabfragen.

Hinweis: Der Baustein liest und überwacht die Poolstation. Die öffentlich sichtbaren Anschlüsse der Version 1.5.7 enthalten keine Schalt- oder Sollwert-Eingänge.

2. Systemvoraussetzungen

• Gira X1 oder Gira L1 mit einer zur Paketversion kompatiblen Firmware und GPA-Version
• Internetzugang des X1/L1 zu api.poolstation.net und license.terra-bytes.org über HTTPS
• Poolstation-Benutzerkonto mit mindestens einem eingerichteten Pool
• gültige PoolStation-Gerätelizenz
• für die Installation: die signierte Logic-Node-ZIP-Datei

Der Baustein verwendet die nicht öffentlich dokumentierte Poolstation-Cloud-Schnittstelle. Änderungen des Cloud-Anbieters können die Funktion beeinflussen. Die Verfügbarkeit der Cloud und die Aktualität der gelieferten Messwerte liegen außerhalb des Einflusses des Logikbausteins.

3. Installation und Inbetriebnahme

Wie Seriennummer und MAC-Adresse ermittelt werden, welche Aktivierungsdaten vom LicenseServer stammen und was TerraBytes ausliefert, beschreibt die ergänzende Kundenanleitung zu Gerätedaten und Lizenzaktivierung.

1. In GPA das Projekt öffnen und die gelieferte ZIP-Datei als Logikbaustein importieren.
2. Den Baustein PoolStation auf einer Logikseite platzieren.
3. Die Lizenzparameter aus der Auslieferungs- oder Aktivierungsnachricht eintragen.
4. Username und Password mit dem Poolstation-Konto verbinden oder als feste Eingangswerte setzen.
5. Optional PoolId eintragen. Bleibt der Wert leer, verwendet der Baustein den ersten Pool des Kontos.
6. Abfrageintervall und Timeout prüfen. Empfohlen sind 300 Sekunden und 15 Sekunden.
7. Projekt übertragen und die Ausgänge LicenseStatus, Error, ErrorMessage, DeviceOnline und LastUpdated kontrollieren.

Zugangsdaten sollten ausschließlich innerhalb des geschützten GPA-Projekts verwaltet und nicht in Diagnosemeldungen, Screenshots oder Support-Anfragen veröffentlicht werden.

4. Parameter

Parameter werden in den Eigenschaften des Logikbausteins gepflegt und sind nicht als KNX-/Logikanschluss verdrahtbar.

GPA-Name	Typ	Standard	Erforderlich	Beschreibung
ActivationCode	Text	leer	für Online-Aktivierung	Einmalig bereitgestellter Aktivierungscode der Gerätelizenz.
SerialNumber	Text	leer	empfohlen	Seriennummer des lizenzierten X1/L1; wird zusätzlich zur primären MAC-Bindung gespeichert und sollte zur Provisionierung passen.
OfflineToken	Text	leer	optional	Signierter Offline-Lizenznachweis für den Betrieb während einer begrenzten Nichterreichbarkeit des Lizenzservers.
OfflineProfile	Text	private	bei Offline-Token	Offline-Profil. Vorgesehene Werte: private, business, partner; das bereitgestellte Token muss zum Profil passen.
ReleaseChannel	Text	stable	ja	Update-Kanal. Vorgesehene Werte: stable, beta, rc. Für Produktivsysteme wird stable empfohlen.

Die Laufzeit prüft die Lizenz beim Start, aktualisiert den Lizenzstatus regelmäßig und sendet einen Geräte-Heartbeat. Ohne gültige Lizenz bleibt die Poolabfrage gesperrt und ErrorMessage meldet „Keine gueltige Lizenz.“

5. Eingänge

Nr.	GPA-Name	Anzeige	Typ	Standard	Einheit/Werte	Funktion
1	Username	Benutzername	Text	leer	E-Mail/Benutzername	Anmeldung am Poolstation-Konto.
2	Password	Kennwort	Text	leer	–	Kennwort des Poolstation-Kontos.
3	PoolId	Pool-ID	Text	leer	ID	Optional. Leer wählt den ersten Pool des Kontos; bei mehreren Pools wird eine feste ID empfohlen.
4	PollIntervalSeconds	Abfrageintervall (s)	Ganzzahl	300	Sekunden; 0 = aus	Zeit zwischen automatischen Abfragen. Nur Werte größer null aktivieren den Timer.
5	TimeoutSeconds	Timeout (s)	Ganzzahl	15	Sekunden	Maximale Dauer je Cloud-Aufruf.
6	IgnoreSslErrors	SSL-Fehler ignorieren	Boolesch	false	false/true	Deaktiviert bei true die Zertifikatsprüfung. Nur vorübergehend zur Diagnose verwenden.
7	Enable	Aktiviert	Boolesch	true	false/true	Aktiviert die automatische Erst- und Intervallabfrage. Bei false bleibt eine manuelle Abfrage über Trigger möglich.
8	Trigger	Auslöser	Boolesch	false	steigende Flanke	Löst sofort eine einzelne Abfrage aus.

Jede Eingangsänderung führt zur Auswertung des Bausteins. Für Trigger sollte deshalb ein Impuls beziehungsweise eine saubere steigende Flanke verwendet werden.

6. Ausgänge

6.1 Wasserwerte und Sollwerte

Nr.	GPA-Name	Anzeige	Typ	Einheit	Bedeutung
1	Temperature	Wassertemperatur	Zahl	°C	Aktuelle Wassertemperatur.
2	SaltConcentration	Salzkonzentration	Zahl	g/l	Aktuell gemeldete Salzkonzentration.
3	CurrentPh	pH aktuell	Zahl	pH	Aktueller pH-Wert.
4	TargetPh	pH Sollwert	Zahl	pH	In der Poolstation hinterlegter pH-Sollwert.
5	CurrentOrp	ORP/Redox aktuell	Zahl	mV	Aktueller Redox-/ORP-Wert.
6	TargetOrp	ORP/Redox Sollwert	Zahl	mV	Hinterlegter Redox-/ORP-Sollwert.
7	CurrentChlorinePpm	Chlor aktuell	Zahl	ppm	Aktueller Chlorwert, sofern vom Gerät geliefert.
8	TargetChlorinePpm	Chlor Sollwert	Zahl	ppm	Hinterlegter Chlor-Sollwert.
9	CurrentElectrolysisPercent	Elektrolyse aktuell	Zahl	%	Aktuell gemeldete Elektrolyseleistung.
10	TargetElectrolysisPercent	Elektrolyse Sollwert	Zahl	%	Hinterlegter Elektrolyse-Sollwert.
11	WaterFlowOk	Wasserfluss OK	Boolesch	–	true, wenn die Poolstation einen ausreichenden Wasserfluss meldet.
12	UvAvailable	UV verfügbar	Boolesch	–	Zeigt an, ob UV-Daten beziehungsweise ein UV-Modul verfügbar sind.

Welche Messwerte tatsächlich vorhanden sind, hängt vom Poolstation-Modell, seiner Ausstattung und der Cloud-Antwort ab. Nicht gelieferte Werte werden nicht künstlich ersetzt.

6.2 Binäreingänge und Relais

Nr.	GPA-Name	Anzeige	Typ	Bedeutung
13–16	BinaryInput1 … BinaryInput4	Binäreingang 1 … 4	Boolesch	Von der Poolstation gemeldeter Zustand der vier Binäreingänge.
17–20	Relay1 … Relay4	Relais 1 … 4	Boolesch	Von der Cloud gemeldeter Schaltzustand der ersten vier Relais; reine Statusausgabe.
31–34	Relay1Name … Relay4Name	Relais 1 Name … 4 Name	Text	In der Poolstation vergebener Relaisname, beispielsweise Pumpe oder Beleuchtung.

Die Zuordnung richtet sich nach der Reihenfolge, in der die Poolstation-Cloud die Relais liefert. Nach Änderungen in der Poolstation-Konfiguration sollte die Zuordnung erneut geprüft werden.

6.3 Pool, Fehler und Verbindung

Nr.	GPA-Name	Anzeige	Typ	Format/Werte	Bedeutung
21	ResolvedPoolId	Verwendete Pool-ID	Text	ID	Tatsächlich abgefragte ID; besonders hilfreich bei automatischer Auswahl.
22	PoolName	Poolname	Text	–	Von der Cloud gelieferter Poolname.
23	Error	Fehler	Boolesch	false/true	true, wenn die letzte Abfrage oder Lizenzprüfung nicht erfolgreich war.
24	ErrorMessage	Fehlertext	Text	–	Meldung zum letzten Fehler; leer nach erfolgreicher Poolabfrage.
35	DeviceOnline	Gerät verbunden	Boolesch	false/true	true, wenn der Cloud-Zeitstempel der Poolstation höchstens 300 Sekunden alt ist.
36	LastUpdated	Letzter Update (Lokalzeit)	Text	yyyy-MM-dd HH:mm:ss	Letzter Geräte-Zeitstempel in der von der API abgeleiteten lokalen Zeit; leer, wenn nicht verfügbar.

DeviceOnline beschreibt die Aktualität der Poolstation-Daten, nicht nur die Erreichbarkeit des X1 oder des Internets.

6.4 UV-Diagnose

Nr.	GPA-Name	Anzeige	Typ	Bedeutung
25	UvEnabled	UV aktiviert	Boolesch	UV-Status ist am Gerät verfügbar/aktiviert.
26	UvOn	UV-Lampe an	Boolesch	Von der Poolstation gemeldeter UV-Lampenstatus.
27	UvBallastProblem	UV-Vorschaltgerät Problem	Boolesch	Von der API abgeleiteter Status des UV-Vorschaltgeräts.
28	UvFuseProblem	UV-Sicherung Problem	Boolesch	Von der API gemeldeter Sicherungsfehler.
29	CurrentUvTimer	UV-Betriebszähler aktuell	Ganzzahl	Aktueller UV-Betriebszähler; Einheit gemäß Poolstation-Anzeige.
30	TotalUvTimer	UV-Betriebszähler gesamt	Ganzzahl	Gesamt-UV-Betriebszähler; Einheit gemäß Poolstation-Anzeige.

UV-Signale sind modellabhängig. Alarmierungen sollten erst nach einem Vergleich mit der Originalanzeige der Poolstation produktiv geschaltet werden.

6.5 Lizenz und Updates

Nr.	GPA-Name	Typ	Bedeutung
100	LicenseStatus	Text	Aktueller, vom Lizenzsystem gelieferter Lizenzstatus.
101	LicenseOwner	Text	Hinterlegter Lizenznehmer.
102	UpdateAvailable	Boolesch	true, wenn für den gewählten Release-Kanal eine neuere Version gemeldet wird.
103	LatestVersion	Text	Versionsnummer der gemeldeten aktuellen Version.
104	DownloadUrl	Text	Vom Lizenzsystem gelieferte Download-Adresse.
105	OfflineExpiresAt	Text	Ablaufzeitpunkt des aktuell verwendeten Offline-Nachweises, sofern vorhanden.

7. Ablauf der Abfrage

Beim Start initialisiert der Baustein die Lizenzprüfung. Ist die Lizenz gültig und Enable = true, erfolgt einmalig eine sofortige Poolabfrage. Danach wird der Timer jeweils mit PollIntervalSeconds neu gesetzt. Eine steigende Flanke an Trigger führt unabhängig vom Timer zu einer zusätzlichen Abfrage. Bei HTTP-Authentifizierungsfehlern 401 oder 403 versucht der Baustein einmalig eine erneute Anmeldung.

Die Cloud-Abfrage läuft synchron. Sehr große Timeout-Werte können deshalb die Verarbeitung einer Logikseite unnötig lange blockieren. Ein Intervall von 300 Sekunden und ein Timeout von 15 Sekunden sind für den Normalbetrieb vorgesehen; zu kurze Intervalle erhöhen Cloud- und Systemlast ohne zwingenden Aktualitätsgewinn.

8. Typische Logiken

• Visualisierung von Temperatur, pH, Redox, Chlor und Elektrolyseleistung
• Warnung, wenn WaterFlowOk = false oder DeviceOnline = false
• Störmeldung aus Error und ErrorMessage
• Wartungshinweis aus UV-Zählern und UV-Fehlerausgängen
• Klartextanzeige der Relais über die Kombination aus RelayXName und RelayX
• Update-Hinweis aus UpdateAvailable, LatestVersion und DownloadUrl

Für Alarmierungen empfiehlt sich eine Verzögerung oder Mehrfachprüfung, damit ein einzelner kurzzeitiger Cloud- oder Netzwerkfehler keine unnötige Meldung auslöst.

9. Fehlerbehebung

Symptom	Wahrscheinliche Ursache	Maßnahme
„Keine gueltige Lizenz.“	Lizenz fehlt, ist abgelaufen oder passt nicht zum Gerät.	Seriennummer, Aktivierungscode/Offline-Token und LicenseStatus prüfen; Lizenzgeber kontaktieren.
„Keine Anmeldedaten vorhanden.“	Benutzername oder Kennwort leer.	Beide Eingänge belegen und Projekt erneut übertragen.
Login/Authentifizierung fehlgeschlagen	Zugangsdaten falsch, Konto gesperrt oder Cloud-Sitzung abgewiesen.	Anmeldung in der Poolstation-App/Weboberfläche testen und Zugangsdaten neu setzen.
„Account besitzt keine Pools.“	Im Konto ist kein Pool sichtbar.	Poolstation-Konto und Berechtigungen prüfen.
Abfrage läuft in Timeout	Internet/DNS/Cloud gestört oder Timeout zu klein.	Netzwerkzugang prüfen; Timeout maßvoll erhöhen.
DeviceOnline = false, aber keine Bausteinfehlermeldung	Cloud liefert alte oder keine Gerätedaten.	Poolstation selbst, Netzwerk der Poolstation und LastUpdated prüfen.
Einzelne Werte fehlen	Wert wird vom Modell oder von der Cloud nicht geliefert.	Ausstattung und Originalanzeige vergleichen; fehlende Ausgänge in der Logik berücksichtigen.
Zertifikatsfehler	Uhrzeit, Zertifikatskette oder Firmwareproblem.	Systemzeit und Firmware prüfen. IgnoreSslErrors nur kurzfristig und auf eigenes Risiko aktivieren.
Falscher Pool	Leere PoolId wählt den ersten Pool.	ResolvedPoolId ablesen und gewünschte ID fest in PoolId eintragen.

10. Datenschutz, Sicherheit und Supportangaben

Für den Betrieb werden Poolstation-Zugangsdaten sowie geräte- und lizenzbezogene Informationen verarbeitet. Der X1/L1 kommuniziert dazu mit der Poolstation-Cloud und dem TerraBytes-Lizenzdienst. Zugangsdaten und Offline-Token sind vertraulich zu behandeln.

Bei einer Supportanfrage helfen folgende Angaben: Paketversion, X1/L1-Firmware, GPA-Version, LicenseStatus, ErrorMessage, ResolvedPoolId, LastUpdated und der ungefähre Fehlerzeitpunkt. Kennwort, vollständigen Aktivierungscode und Offline-Token niemals mitsenden.

11. Technische Produktdaten

Merkmal	Wert
Produkt	PoolStation Logikbaustein
Plattform	Gira X1 / Gira L1
Paketversion	1.5.7 laut Manifest
Lizenzmodell	Gerätegebundene Lizenz
Produktcode	Poolstation
Pool-Datenquelle	Poolstation-Cloud
Transport	HTTPS, curl-basierter Client
Betriebsart	Lesend/überwachend
Automatische Abfrage	Standard 300 Sekunden
Manuelle Abfrage	steigende Flanke an Trigger
Online-Bewertung	letzter Gerätewert maximal 300 Sekunden alt

Poolstation und Gira sind Marken ihrer jeweiligen Inhaber. Dieses Produkt ist eine eigenständige Softwareerweiterung; aus der Nennung der Systeme folgt keine Herstellerpartnerschaft.