PoolCop und KNX: Pool’nX per API-Schlüssel mit PoolCop Cloud verbinden

Pool’nX fragt den Zustand eines PoolCop ab und leitet die vom KNX-Bus empfangenen Befehle an ihn weiter, über PoolCop Cloud und einen API-Schlüssel des PoolCop-Kontos. Wählen Sie den Typ PoolCop Cloud, speichern Sie den Schlüssel und wählen Sie dann den PoolCop aus.

Für den Installateur oder Administrator, der einen PoolCop mit einer KNX-Installation verbindet. Für eine Klereo-Poolsteuerung folgen Sie der Verbindung mit Klereo Connect.

Bevor Sie beginnen

• Das Fenster Pool’nX des Gateways ist geöffnet: siehe Pool’nX in Can’nX Cloud öffnen.
• Sie haben Zugriff auf das PoolCop-Konto des Pools, um auf my.poolcop.com/profile einen API-Schlüssel zu erzeugen.
• Ein Wechsel des Pooltyps löscht die gesamte gespeicherte Konfiguration: Zugangsdaten, KNX-Adressen, Optionen und Regelung. Ist das Pool’nX bereits für einen anderen Typ konfiguriert, notieren Sie zuerst seine Adressen.

Den Typ PoolCop Cloud wählen

1. Wählen Sie unter Type of pool (Pooltyp) PoolCop Cloud.
2. Das Fenster Confirmation (Bestätigung) zeigt Do you really want to change the pool type? (Möchten Sie den Pooltyp wirklich ändern?) und All your saved data will be deleted (Alle gespeicherten Daten werden gelöscht). Klicken Sie auf Confirm (Bestätigen).
3. Warten Sie, bis das Fenster mit dem Typ PoolCop Cloud neu geladen ist.

Cancel (Abbrechen) stellt den vorherigen Typ wieder her, ohne etwas zu ändern.

Der Typ PoolCop (legacy) verwendet einen Poolcopilot-API-Schlüssel anstelle eines PoolCop-Cloud-Schlüssels. Wählen Sie ihn nur, wenn Sie über einen solchen Schlüssel verfügen; er hat keine Liste Selected pool (ausgewählter Pool).

Den API-Schlüssel speichern

1. Erzeugen Sie auf der Profilseite Ihres Kontos, my.poolcop.com/profile, einen API-Schlüssel. Beim Typ PoolCop Cloud öffnet das Hilfesymbol neben Please enter your Poolcop API token (API-Schlüssel) diese Seite.
2. Klicken Sie im Fenster Pool’nX neben Authentification (Authentifizierung) auf die Schaltfläche mit dem Anmeldesymbol. Das Fenster Modify the login details (Anmeldedaten ändern) öffnet sich.
3. Fügen Sie den Schlüssel in Please enter your Poolcop API token ein.
4. Klicken Sie auf Save (Speichern). Success! (Erfolgreich!) bestätigt das Speichern und das Fenster schließt sich.

Ein gespeicherter Schlüssel wird nie wieder angezeigt: An API key is already saved. Enter a new key to replace it. (Ein API-Schlüssel ist bereits gespeichert. Geben Sie einen neuen Schlüssel ein, um ihn zu ersetzen.) Um den Schlüssel zu wechseln, fügen Sie den neuen ein und speichern Sie.

Den PoolCop auswählen

1. Öffnen Sie zurück im Fenster Pool’nX die Liste Selected pool. Jeder Eintrag zeigt den Namen des Pools und dann den des PoolCop, getrennt durch ein Winkelzeichen.
2. Wählen Sie den PoolCop aus. Die Auswahl wird sofort gespeichert, ohne weitere Schaltfläche.

Die Liste bleibt leer, solange kein Schlüssel gespeichert ist. Can’nX Cloud hält sie fünf Minuten lang im Zwischenspeicher: Ein in der Zwischenzeit zum Konto hinzugefügter PoolCop kann verzögert erscheinen. Ein neuer Schlüssel oder ein Typwechsel lädt sie neu.

Ergebnis prüfen

1. Öffnen Sie Pool Status (Poolstatus) mit der Schaltfläche mit dem Doppelpfeil.
2. Prüfen Sie, dass auf Live values (Live-Werte) ein grüner Punkt folgt, dass sich die Spalte Value (Wert) füllt und dass Last update: (letzte Aktualisierung:) ein aktuelles Datum anzeigt.
3. Notieren Sie die in Value angezeigten Einheiten: Es sind die des PoolCop-Kontos, zum Beispiel °C oder °F, bar, kPa oder psi.

Ordnen Sie anschließend die KNX-Adressen zu: Statuswerte, dann die PoolCop-spezifischen Werte in der Tabelle der PoolCop-Statuswerte und -Befehle.

Fehlerbehebung

Symptom	Ursache und Maßnahme
Invalid or expired PoolCop API key — check it under Authentication (Ungültiger oder abgelaufener PoolCop-API-Schlüssel – prüfen Sie ihn unter Authentifizierung)	PoolCop Cloud lehnt den gespeicherten Schlüssel ab. Erzeugen Sie auf my.poolcop.com/profile einen neuen Schlüssel und speichern Sie ihn unter Authentification.
An error has occurred (Ein Fehler ist aufgetreten) beim Öffnen des Fensters	PoolCop Cloud hat nicht geantwortet. Warten Sie einige Sekunden und öffnen Sie das Fenster dann erneut.
Liste Selected pool leer	Es ist kein Schlüssel gespeichert, oder das Konto enthält keinen PoolCop. Prüfen Sie das Konto auf my.poolcop.com.
Auf Live values folgt disabled (deaktiviert)	Vom Pool’nX wurden noch keine Daten empfangen. Prüfen Sie, ob ein PoolCop ausgewählt ist und ob das Gateway auf seiner Detailseite Online ist, und öffnen Sie die Tabelle dann erneut.

Besteht das Problem weiter, lesen Sie die Pool’nX-Fehlerbehebung oder schreiben Sie an support@can-nx.com und geben Sie den Namen des Gateways, den Pooltyp und die angezeigte Meldung an. Senden Sie niemals den API-Schlüssel mit.

Französische Bezeichnungen: Type de piscine, Voulez-vous vraiment modifier le type de piscine, Confirmer, Authentification, Modifier les identifiants, Clé d’API, Enregistrer, Une clé d’API est déjà enregistrée. Saisissez une nouvelle clé pour la remplacer., Piscine selectionnée, Clé d’API PoolCop invalide ou expirée — vérifiez-la dans Authentification.