---
title: "Pool’nX : lire et piloter la piscine depuis un client TCP (port 50000)"
description: Autorisez l’adresse IP d’un superviseur ou d’un automate dans Pool’nX, puis lisez les statuts et envoyez des commandes de piscine en TCP, port 50000.
canonical: https://wiki.can-nx.com/guides/pool-tcp-client/
language: fr
product: Pool’nX
audience:
  - administrateur
  - installateur
context: "Pool’nX sur le réseau local : Options, Adresse IP du client TCP, port 50000"
---

# Pool’nX : lire et piloter la piscine depuis un client TCP (port 50000)

Contexte : Pool’nX sur le réseau local : Options, Adresse IP du client TCP, port 50000

En plus du bus KNX, Pool’nX expose les statuts et les commandes de la piscine sur un serveur TCP, port 50000 de son réseau local. Un superviseur, un automate ou un système domotique autorisé lit les valeurs et envoie des commandes avec des messages texte courts.

Destiné à l’intégrateur qui relie la piscine à un système non KNX. Pour le bus KNX, suivez [les statuts KNX](https://wiki.can-nx.com/guides/pool-knx-status/) et [les commandes KNX](https://wiki.can-nx.com/guides/pool-knx-commands/).

## Avant de commencer

- Notez l’adresse IP de la Pool’nX, affichée en **Adresse IP locale** sur sa fiche Can’nX Cloud, et l’adresse IP du client sur le même réseau.
- Le client doit joindre la Pool’nX avec cette adresse IP, sans traduction d’adresse entre les deux.

## Autoriser le client

1. Dans la fenêtre **Pool'nX**, ouvrez **Options** avec le bouton à l’icône d’engrenage.
2. Dans **Adresse IP du client TCP**, saisissez l’adresse IP du client, par exemple **192.168.1.50** (exemple).
3. Activez l’interrupteur de la ligne.
4. Cliquez sur **Enregistrer**. **Opération réussie !** confirme l’enregistrement.

Une connexion venant d’une autre adresse, ou interrupteur désactivé, reçoit un message commençant par **Connection Refused**, puis est fermée.

## Échanger avec Pool’nX

Connectez le client en TCP au port 50000 de la Pool’nX. Chaque message est un texte terminé par deux astérisques.

| Sens | Message | Effet |
| --- | --- | --- |
| Pool’nX vers client | `clé:valeur**`, par exemple `tempWater:27.5**` (exemple) | Une valeur de statut par message |
| Client vers Pool’nX | `requestUpdate**` | Relit le contrôleur et renvoie tous les statuts |
| Client vers Pool’nX | `clé:valeur**`, par exemple `aux1:1**` (exemple) | Envoie la commande correspondante au contrôleur |

- À la connexion, Pool’nX relit le contrôleur et envoie tous les statuts qui ont une valeur.
- Pool’nX envoie ensuite les statuts à chaque relevé, que leur ligne soit cochée **Active** ou non dans la table KNX.
- Les messages partent un par un, toutes les 50 millisecondes environ.
- La valeur d’une commande est lue comme un nombre entier : la partie décimale est ignorée.
- Envoyez un seul message à la fois : plusieurs messages collés dans un même envoi ne sont pas reconnus.

Les clés et les valeurs acceptées sont celles des tableaux [Klereo](https://wiki.can-nx.com/guides/pool-klereo-knx/) et [PoolCop](https://wiki.can-nx.com/guides/pool-poolcop-knx/).

## Vérifier le résultat

1. Connectez un outil de test TCP depuis l’adresse IP autorisée : les statuts arrivent sous la forme `clé:valeur**`.
2. Envoyez `requestUpdate**` : les statuts sont renvoyés.
3. Envoyez une commande de test, puis vérifiez **Dernier évènement** dans **Commandes vers la piscine** et l’état dans **Statuts de la piscine**.

## En cas de problème

| Symptôme | Cause et action |
| --- | --- |
| Message **Connection Refused**, puis fermeture | L’adresse IP vue par la Pool’nX n’est pas celle autorisée, ou l’interrupteur est désactivé. Corrigez **Adresse IP du client TCP** et enregistrez. |
| Connexion impossible | Vérifiez l’adresse IP locale de la Pool’nX, le port 50000 et le réseau entre les deux appareils. |
| Commande sans effet | Vérifiez la clé, la valeur et le terminateur `**`. Une valeur hors de la liste du contrôleur n’est pas transmise. |

Voir aussi [le dépannage Pool’nX](https://wiki.can-nx.com/guides/pool-help/).

Interface en anglais : **Options**, **IP addresses of TCP clients**, **Save**.