PoolCop et KNX : connecter Pool’nX à PoolCop Cloud avec la clé d’API

Pool’nX relève l’état d’un PoolCop et lui transmet les commandes reçues du bus KNX, par l’intermédiaire de PoolCop Cloud et d’une clé d’API du compte PoolCop. Choisissez le type PoolCop Cloud, enregistrez la clé, puis désignez le PoolCop.

Destiné à l’installateur ou à l’administrateur qui relie un PoolCop à une installation KNX. Pour un contrôleur Klereo, suivez la connexion à Klereo Connect.

Avant de commencer

• La fenêtre Pool’nX de la passerelle est ouverte : voir ouvrir Pool’nX dans Can’nX Cloud.
• Vous avez accès au compte PoolCop de la piscine pour générer une clé d’API sur my.poolcop.com/profile.
• Changer de type de piscine efface toute la configuration enregistrée : identifiants, adresses KNX, options et régulation. Si la Pool’nX est déjà configurée pour un autre type, relevez d’abord ses adresses.

Choisir le type PoolCop Cloud

1. Dans Type de piscine, choisissez PoolCop Cloud.
2. La fenêtre Confirmation affiche Voulez-vous vraiment modifier le type de piscine et Toutes vos données sauvegardées seront supprimées. Cliquez sur Confirmer.
3. Attendez que la fenêtre se recharge avec le type PoolCop Cloud.

Annuler remet le type précédent sans rien modifier.

Le type PoolCop (legacy) utilise une clé d’API Poolcopilot à la place d’une clé PoolCop Cloud. Choisissez-le seulement si vous disposez d’une telle clé ; il n’a pas de liste Piscine selectionnée.

Enregistrer la clé d’API

1. Générez une clé d’API sur la page de profil de votre compte, my.poolcop.com/profile. Avec le type PoolCop Cloud, l’icône d’aide à côté de Clé d’API ouvre cette page.
2. Dans la fenêtre Pool’nX, en face de Authentification, cliquez sur le bouton à l’icône de connexion. La fenêtre Modifier les identifiants s’ouvre.
3. Collez la clé dans Clé d’API.
4. Cliquez sur Enregistrer. Opération réussie ! confirme l’enregistrement et la fenêtre se ferme.

Une clé enregistrée n’est jamais réaffichée : Une clé d’API est déjà enregistrée. Saisissez une nouvelle clé pour la remplacer. Pour changer de clé, collez la nouvelle et enregistrez.

Choisir le PoolCop

1. De retour dans la fenêtre Pool’nX, ouvrez la liste Piscine selectionnée. Chaque entrée indique le nom de la piscine, puis celui du PoolCop, séparés par un chevron.
2. Choisissez le PoolCop. Le choix est enregistré aussitôt, sans autre bouton.

La liste reste vide tant qu’aucune clé n’est enregistrée. Can’nX Cloud la garde en mémoire cinq minutes : un PoolCop ajouté entre-temps au compte peut tarder à apparaître. Une nouvelle clé ou un changement de type la recharge.

Vérifier le résultat

1. Ouvrez Statuts de la piscine avec son bouton à double flèche.
2. Vérifiez que Valeurs en direct est suivi d’un rond vert, que la colonne Valeur se remplit et que Dernière actualisation: indique une date récente.
3. Relevez les unités affichées dans Valeur : ce sont celles du compte PoolCop, par exemple °C ou °F, bar, kPa ou psi.

Associez ensuite les adresses KNX : statuts, puis valeurs propres à PoolCop dans le tableau des statuts et commandes PoolCop.

En cas de problème

Symptôme	Cause et action
Clé d’API PoolCop invalide ou expirée — vérifiez-la dans Authentification	PoolCop Cloud refuse la clé enregistrée. Générez une nouvelle clé sur my.poolcop.com/profile et enregistrez-la dans Authentification.
Une erreur est survenue à l’ouverture de la fenêtre	PoolCop Cloud n’a pas répondu. Patientez quelques secondes, puis rouvrez la fenêtre.
Liste Piscine selectionnée vide	Aucune clé n’est enregistrée, ou le compte ne contient aucun PoolCop. Vérifiez le compte sur my.poolcop.com.
Valeurs en direct suivi de Désactivé(e)	Aucune donnée n’a encore été reçue de la Pool’nX. Vérifiez qu’un PoolCop est choisi et que la passerelle est En ligne sur sa fiche, puis rouvrez la table.

Si le problème persiste, consultez le dépannage Pool’nX ou écrivez à support@can-nx.com avec le nom de la passerelle, le type de piscine et le message affiché. Ne transmettez jamais la clé d’API.

Interface en anglais : Type of pool, Do you really want to change the pool type?, Confirm, Authentification, Modify the login details, Please enter your Poolcop API token, Save, An API key is already saved. Enter a new key to replace it., Selected pool, Invalid or expired PoolCop API key — check it under Authentication.