Kundenanleitung: Gerätedaten und Lizenzaktivierung

PoolStation Logikbaustein für Gira X1 und L1 · Stand: 14. Juli 2026

1. Worum geht es?

Der PoolStation Logikbaustein wird für einen bestimmten Gira X1 oder Gira L1 lizenziert. Damit TerraBytes die Lizenz korrekt ausstellen kann, werden vor der Auslieferung eindeutige Gerätedaten benötigt. Nach der Provisionierung erhältst Du von TerraBytes den Logikbaustein und die zu Deinem Gerät passenden Aktivierungsdaten.

Du brauchst keinen eigenen Zugang zum TerraBytes LicenseServer. Die Lizenz wird durch TerraBytes angelegt und Deinem Gerät zugeordnet.

2. Kurzüberblick

Schritt	Verantwortlich	Ergebnis
1	Kunde/Installateur	Seriennummer und MAC-Adresse des vorgesehenen X1/L1 ermitteln.
2	Kunde	Gerätedaten, Bestellnummer und Kontaktdaten sicher an TerraBytes übermitteln.
3	TerraBytes	Bestellung prüfen und Gerät im LicenseServer provisionieren.
4	LicenseServer	Gerätebindung, Aktivierungscode und gegebenenfalls Offline-Token erzeugen.
5	TerraBytes	Signiertes Installationspaket, Lizenzdaten und Dokumentation ausliefern.
6	Kunde/Installateur	Paket in GPA importieren und die gelieferten Parameter unverändert eintragen.
7	Logikbaustein	Lizenz prüfen und den Status an LicenseStatus ausgeben.

3. Welche Daten muss der Kunde bereitstellen?

Angabe	Pflicht?	Zweck
Bestellnummer	ja	Zuordnung zu Kauf, Lizenz und Supportfall.
Name/Firma des Lizenznehmers	ja	Anzeige und Verwaltung des Lizenzinhabers.
E-Mail-Adresse	ja	Zustellung der Aktivierungsdaten und Kontakt bei Rückfragen.
MAC-Adresse des Gira X1/L1	ja	Primäre technische Gerätebindung der Lizenz.
Seriennummer des Gira X1/L1	empfohlen	Zusätzliche eindeutige Dokumentation und Plausibilitätsprüfung des Geräts.
Gewünschtes Offline-Profil	nur wenn vereinbart	Bestimmt den vorgesehenen Offline-Betrieb; Standard für Privatkunden ist private.

Poolstation-Benutzername und Poolstation-Kennwort werden nicht für die Lizenzausstellung benötigt und dürfen nicht an TerraBytes übermittelt werden. Diese Zugangsdaten trägt der Kunde beziehungsweise Integrator später direkt im eigenen GPA-Projekt ein.

4. So erhältst Du die Seriennummer

Die benötigte Seriennummer ist die Seriennummer des Geräts, auf dem der Logikbaustein ausgeführt wird – also des Gira X1 oder Gira L1. Sie ist nicht die Seriennummer der Poolsteuerung.

Prüfe die folgenden Stellen in dieser Reihenfolge:

1. Geräteaufkleber/Typenschild: Die Seriennummer befindet sich auf dem Geräteetikett des X1/L1. Fotografiere oder übertrage die als Seriennummer beziehungsweise S/N gekennzeichnete Angabe exakt.
2. Originalverpackung oder Installationsunterlagen: Wenn das eingebaute Gerät nicht zugänglich ist, findet sich die Gerätekennzeichnung häufig auf dem Verpackungsaufkleber oder in der Übergabedokumentation des Installateurs.
3. Gira Projekt Assistent (GPA): Öffne das bestehende Projekt und wähle den projektierten X1/L1 aus. Wird in den Geräteeigenschaften eine Seriennummer angezeigt, kann diese übernommen werden. Die genaue Position kann je nach GPA-Version abweichen.
4. Elektro-/KNX-Installateur fragen: Falls Du keinen GPA-Zugang hast oder das Gerät im Verteiler nicht sicher zugänglich ist, sollte der zuständige Fachbetrieb die Kennzeichnung auslesen beziehungsweise am Gerät ablesen.

Vor dem Öffnen eines Verteilers gelten die üblichen elektrotechnischen Sicherheitsregeln. Kunden sollten keine Abdeckungen spannungsführender Bereiche entfernen. Im Zweifel übernimmt das eine Elektrofachkraft.

Nicht mit der Seriennummer verwechseln

Angabe	Warum sie nicht gemeint ist
Gira Device Key / Initial Device Password	Zugangsschlüssel für die Geräteinbetriebnahme, keine Seriennummer. Diesen geheim halten.
GPA-/Gerätekennwort oder Anlagenschlüssel	Sicherheitskennwort des Projekts/Geräts, niemals an TerraBytes senden.
KNX Individualadresse	Busadresse, beispielsweise 1.1.10, nicht die Geräteidentität der Lizenz.
IP-Adresse	Kann sich ändern und wird nicht zur dauerhaften Lizenzbindung verwendet.
Pool-ID	Kennzeichnet einen Pool im Poolstation-Konto, nicht den Gira X1/L1.
Poolstation-Seriennummer	Gehört zur Poolsteuerung, nicht zum ausführenden Gira-Gerät.

5. So erhältst Du die MAC-Adresse

Die MAC-Adresse ist die primäre Kennung für die PoolStation-Lizenz. Sie besteht aus zwölf Hexadezimalzeichen und wird häufig mit Doppelpunkten oder Bindestrichen dargestellt, zum Beispiel AA:BB:CC:DD:EE:FF.

Mögliche Fundstellen sind:

• Geräteaufkleber oder Geräteunterlagen des Gira X1/L1,
• Geräteeigenschaften beziehungsweise Geräteinformationen im GPA,
• Geräteliste des Routers oder DHCP-Servers,
• Netzwerkdokumentation des Elektro-/KNX-Installateurs.

Bei der Router-Suche muss eindeutig der X1/L1 gewählt werden. Die MAC-Adresse eines PCs, Gira S1, WLAN-Access-Points oder der Poolstation ist nicht geeignet. TerraBytes normalisiert die Angabe intern auf zwölf Großbuchstaben/Ziffern ohne Trennzeichen.

6. Was kommt vom TerraBytes LicenseServer?

Der LicenseServer erzeugt beziehungsweise verwaltet bei der Provisionierung folgende Daten. Der Kunde bedient diesen Server nicht selbst.

LicenseServer-Ergebnis	Bedeutung für den Kunden
Gerätebindung	Verknüpft die erworbene PoolStation-Lizenz mit der MAC-Adresse und, sofern angegeben, der Seriennummer.
Aktivierungscode	Wert für den Bausteinparameter ActivationCode; ermöglicht die Online-Lizenzprüfung.
Lizenzstatus	Vom Baustein später als LicenseStatus ausgegeben, zum Beispiel gültig oder abgelehnt.
Lizenznehmer	Wird dem Kundenkonto zugeordnet und am Ausgang LicenseOwner bereitgestellt.
Offline-Token	Signierter Lizenznachweis für einen vereinbarten begrenzten Offline-Betrieb.
Offline-Profil	Zugehörige Profilbezeichnung, üblicherweise private, alternativ nach Vertrag business oder partner.
Updateinformationen	Verfügbare Version, Updatehinweis und gegebenenfalls Download-Adresse für den gewählten Kanal.

Der Aktivierungscode kann serverseitig bereits als verwendet erscheinen. Das ist bei dieser Auslieferungsart korrekt: TerraBytes bindet die Lizenz während der Provisionierung direkt an das gemeldete Gerät. Der Code darf deshalb nicht für ein anderes Gerät verwendet werden.

7. Was liefert TerraBytes an den Kunden?

Nach erfolgreicher Prüfung und Provisionierung erhältst Du:

Lieferbestandteil	Verwendung
Signierte Logic-Node-ZIP-Datei	Wird im Gira Projekt Assistenten importiert. Nicht vor dem Import entpacken.
ActivationCode	Vollständig und ohne zusätzliche Leerzeichen in den gleichnamigen Parameter kopieren.
SerialNumber	Die von Dir gemeldete X1/L1-Seriennummer; in den gleichnamigen Parameter eintragen.
OfflineToken	Nur wenn für Deine Lizenz vorgesehen; vollständig und unverändert kopieren.
OfflineProfile	Passender Wert zum Token, für Privatkunden normalerweise private.
ReleaseChannel	Für reguläre Kundeninstallationen normalerweise stable.
Endanwender-Dokumentation	Installation, Ein-/Ausgänge, Betrieb und Fehlerbehebung.

TerraBytes liefert keine Poolstation-Zugangsdaten. Benutzername und Kennwort stammen aus Deinem eigenen Poolstation-Konto.

8. Welche Werte werden in GPA eingetragen?

Den PoolStation-Baustein auf dem Logikblatt markieren und die gelieferten Lizenzparameter in den Eigenschaften eintragen:

GPA-Parameter	Quelle	Beispiel/Hinweis
ActivationCode	TerraBytes/LicenseServer	Genau wie geliefert übernehmen.
SerialNumber	Kundengerät, von TerraBytes bestätigt	Seriennummer des ausführenden X1/L1.
OfflineToken	TerraBytes/LicenseServer	Optional; vollständiger Token ohne Kürzung oder Zeilenverlust.
OfflineProfile	TerraBytes	Muss zum Offline-Token passen; meist private.
ReleaseChannel	TerraBytes	Normalerweise stable.

Danach werden die fachlichen Eingänge eingerichtet:

Eingang	Quelle
Username	Benutzername/E-Mail Deines Poolstation-Kontos.
Password	Kennwort Deines Poolstation-Kontos.
PoolId	Optional; bei mehreren Pools die gewünschte Pool-ID.

Nach dem Übertragen des Projekts zuerst LicenseStatus, LicenseOwner, Error und ErrorMessage prüfen. Bei gültiger Lizenz und korrekten Poolstation-Zugangsdaten startet anschließend die Poolabfrage.

9. Was darf nicht verändert oder weitergegeben werden?

• Aktivierungscode und Offline-Token nicht öffentlich posten oder an Dritte weitergeben.
• Offline-Token nicht bearbeiten, formatieren oder kürzen.
• Gerätekennwort, Gira Device Key, Initial Device Password und Anlagenschlüssel niemals an TerraBytes übermitteln.
• Poolstation-Kennwort nicht in Support-E-Mails oder Screenshots zeigen.
• Das Installationspaket und die Lizenzdaten nur für das lizenzierte Gerät verwenden.

10. Gerätewechsel

Eine bestehende Lizenz darf nicht eigenständig durch Eintragen derselben Aktivierungsdaten auf einen neuen X1/L1 übertragen werden. Bei Austausch, Defekt oder Migration vor der Installation Kontakt zu TerraBytes aufnehmen und folgende Daten angeben:

• Bestellnummer und Lizenznehmer,
• bisherige MAC-Adresse und Seriennummer, soweit vorhanden,
• neue MAC-Adresse und Seriennummer,
• Grund des Gerätewechsels.

TerraBytes prüft die Berechtigung, hebt gegebenenfalls die alte Bindung auf und stellt neue Aktivierungsdaten bereit. Erst danach darf der Baustein auf dem Ersatzgerät aktiviert werden.

11. Checkliste vor der Supportanfrage

Prüfung	Erledigt
Paket unverändert als ZIP in GPA importiert	☐
Aktivierungscode vollständig eingetragen	☐
Seriennummer gehört zum verwendeten X1/L1	☐
Offline-Token und Profil stimmen mit der Lieferung überein	☐
Release-Kanal steht auf dem gelieferten Wert, normalerweise stable	☐
X1/L1 hat Internetzugang	☐
Poolstation-Anmeldung mit denselben Zugangsdaten funktioniert	☐
LicenseStatus und ErrorMessage notiert	☐

Für eine Supportanfrage genügen Bestellnummer, Paketversion, X1/L1-Modell, die letzten Zeichen der MAC-Adresse, LicenseStatus, ErrorMessage und der ungefähre Fehlerzeitpunkt. Keine Kennwörter, Device Keys oder vollständigen Offline-Token mitsenden.

12. Zuständigkeiten auf einen Blick

Thema	Kunde/Installateur	TerraBytes	LicenseServer
Richtige X1/L1-Gerätedaten ermitteln	✓	prüft Plausibilität	–
Poolstation-Konto und Zugangsdaten	✓	–	–
Lizenz anlegen und Gerät zuordnen	–	✓	speichert Bindung
Aktivierungscode/Offline-Token erzeugen	–	veranlasst und übermittelt	✓
Signiertes Softwarepaket liefern	–	✓	–
GPA-Projektierung und Projektübertragung	✓	unterstützt bei Produktfragen	–
Gerätewechsel freigeben	meldet Wechsel	✓	aktualisiert Bindung

Poolstation und Gira sind Marken ihrer jeweiligen Inhaber. Der PoolStation Logikbaustein ist eine eigenständige Softwareerweiterung von TerraBytes.