---
title: "PoolCop KNX : statuts, commandes et valeurs à utiliser avec Pool’nX"
description: "Tableau PoolCop pour KNX : mesures, pompes, vanne, niveau d’eau, auxiliaires, alarmes et commandes PoolCop Cloud, avec DPT, unités et valeurs codées."
canonical: https://wiki.can-nx.com/guides/pool-poolcop-knx/
language: fr
product: Pool’nX
audience:
  - administrateur
  - installateur
context: "Pool’nX avec un PoolCop : tables Statuts de la piscine et Commandes vers la piscine, PoolCop Cloud et legacy"
---

# PoolCop KNX : statuts, commandes et valeurs à utiliser avec Pool’nX

Contexte : Pool’nX avec un PoolCop : tables Statuts de la piscine et Commandes vers la piscine, PoolCop Cloud et legacy

Ce tableau de référence liste les statuts qu’une Pool’nX relève sur un PoolCop par PoolCop Cloud et les commandes qu’elle lui transmet depuis le bus KNX : nom affiché, clé, DPT, unité et valeurs codées de la pompe, de la vanne, du niveau d’eau et des alarmes. Une dernière section résume le type PoolCop (legacy).

Destiné à l’installateur qui prépare les objets KNX, la visualisation ou la logique de la piscine. La procédure de saisie des adresses est décrite dans [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/). La clé sert aussi au [client TCP](https://wiki.can-nx.com/guides/pool-tcp-client/).

## Unités et valeurs codées

Les températures, pressions, volumes et débits sont transmis dans les unités du compte PoolCop, sans conversion : la colonne **Valeur** affiche l’unité utilisée, par exemple °C ou °F, bar, kPa ou psi, m³ ou gal. Vérifiez qu’elle correspond à l’unité attendue par le DPT de l’objet KNX.

Les états de la pompe, de la vanne et du niveau d’eau sont codés en nombre (DPT 5.010). La colonne **Valeur** affiche le terme PoolCop suivi du nombre, par exemple **Speed2 (2)**.

| Valeur | Vitesse | Position de la valve | État de marche | Mode de filtration | Niveau d’eau |
| --- | --- | --- | --- | --- | --- |
| 0 | None | Filter | Stopped | Stop | Faulty |
| 1 | Speed1 | Waste | FreezeProtection | Timer | Low |
| 2 | Speed2 | Closed | ForcedMode | EcoPlus | Normal |
| 3 | Speed3 | Backwash | EcoPlusMode | Volume | High |
| 4 | Speed4 | Bypass | TimerMode | Continuous | VeryHigh |
| 5 | Speed5 | Rinse | Manual | Forced24H | – |
| 6 | Speed6 | – | Paused | Forced48H | – |
| 7 | Speed7 | – | ExternalRequest | Forced72H | – |
| 8 | Speed8 | – | WaterLevelManagement | Mode24H | – |
| 9 | – | – | Mode24H | NoPump | – |

La colonne Vitesse vaut aussi pour **Nombre de vitesses de la pompe** ; la colonne Niveau d’eau, pour les consignes de niveau d’eau.

## Statuts PoolCop Cloud envoyés sur le bus KNX

| Nom | Clé | DPT | Unité ou valeur |
| --- | --- | --- | --- |
| **Température de l'eau**, **Température de l'air** | `tempWater`, `tempAir` | 9.001 | température du compte |
| **pH** | `pH` | 9.002 | pH |
| **Redox** | `orp` | 14.027 | mV |
| **Chlore libre**, **Chlore libre actif**, **Chlore total** | `freeChlorine`, `freeAvailableChlorine`, `totalChlorine` | 9.001 | mg/l |
| **Sel** | `salt` | 9.001 | g/l |
| **Pression** | `pressure` | 9.001 | pression de la pompe 1, unité du compte |
| **Tension batterie**, **Tension secteur** | `battery`, `mainsVoltage` | 14.027 | V, 0 si non fournie |
| **Mode service**, **Dosage pH**, **Dosage désinfectant** | `serviceMode`, `pHDosing`, `disinfectionDosing` | 1.001 | 1 : actif |
| **Piscine connectée au reseau** | `poolConnected` | 1.001 | 1 : connectée |
| **Status de la pompe**, **Status de la pompe 2** | `pumpStatus`, `pump2Status` | 1.001 | 1 : en marche |
| **Vitesse de la pompe**, **Vitesse de la pompe 2** | `pumpSpeed`, `pump2Speed` | 5.010 | 0 à 8 |
| **Pression de la pompe**, **Pression de la pompe 2** | `pumpPressure`, `pump2Pressure` | 9.001 | unité du compte |
| **Position de la valve**, **Position de la valve 2** | `valvePosition`, `pump2ValvePosition` | 5.010 | 0 à 5 |
| **État de marche de la pompe**, **État de marche de la pompe 2** | `pumpRunningStatus`, `pump2RunningStatus` | 5.010 | 0 à 9 |
| **Forçage pompe restant**, **Forçage pompe 2 restant** | `pumpForcedRemaining`, `pump2ForcedRemaining` | 7.005 | s |
| **Nombre de vitesses de la pompe**, **Nombre de vitesses de la pompe 2** | `pumpNumberOfSpeeds`, `pump2NumberOfSpeeds` | 5.010 | 0 à 8 |
| **Mode de filtration de la pompe**, **Mode de filtration de la pompe 2** | `pumpFiltrationMode`, `pump2FiltrationMode` | 5.010 | 0 à 9 |
| **Niveau d'eau** | `waterLevel` | 5.010 | 0 à 4 |
| **Consigne de niveau d'eau**, **Consigne cible niveau d'eau** | `waterLevelSetPoint`, `waterLevelTargetSetpoint` | 5.010 | 0 à 4 |
| **Capteur de niveau d'eau installé**, **Niveau d'eau atteint**, **Erreur de niveau d'eau**, **Remplissage en cours**, **Mesure du niveau d'eau en cours** | `waterLevelInstalled`, `waterLevelOnTarget`, `waterLevelOnError`, `waterLevelRefilling`, `waterLevelMeasuring` | 1.001 | 1 : oui |
| **Couverture installée**, **Couverture pilotable**, **Couverture ouverte**, **Couverture en fermeture**, **Couverture en ouverture**, **Couverture arrêtée** | `coverInstalled`, `coverControllable`, `coverOpen`, `coverClosing`, `coverOpening`, `coverStopped` | 1.001 | 1 : oui |
| **Nage à contre-courant installée**, **Nage à contre-courant en marche** | `jetStreamInstalled`, `jetStreamRunning` | 1.001 | 1 : oui |
| **Débitmètre 1 installé**, **Débitmètre 2 installé** | `flow1Installed`, `flow2Installed` | 1.001 | 1 : oui |
| **Débit 1**, **Débit 2** | `flow1Rate`, `flow2Rate` | 9.001 | débit du compte |
| **Entrée 1** à **Entrée 12** | `input1` à `input12` | 1.001 | 1 : active |
| **Auxiliaire 1** à **Auxiliaire 30** | `aux1` à `aux30` | 1.001 | 1 : en marche |
| **Consigne du pH**, **Seuil bas pH**, **Seuil haut pH** | `pHSetpoint`, `pHLow`, `pHHigh` | 9.002 | pH |
| **Consigne Redox**, **Seuil bas Redox**, **Seuil haut Redox** | `orpSetpoint`, `orpLow`, `orpHigh` | 14.027 | mV |
| **Consigne chlore libre actif**, **Seuil bas chlore libre actif**, **Seuil haut chlore libre actif** | `FACSetpoint`, `FACLow`, `FACHigh` | 9.001 | mg/l |
| **Consigne chlore libre**, **Seuil bas chlore total**, **Seuil haut chlore total** | `FCSetpoint`, `TCLow`, `TCHigh` | 9.001 | mg/l |
| **Consigne de chauffage** | `heatingSetpoint` | 9.001 | température du compte |
| **Volume du bassin** | `poolVolume` | 9.001 | volume du compte |
| **Protection antigel**, **ACO installé**, **Rémanent installé** | `freezeProtection`, `acoInstalled`, `remnantInstalled` | 1.001 | 1 : oui |
| **Production électrolyseur** | `electrolyserProductionPercent` | 5.001 | % |
| **Dernier Contre-lavage (date)**, **Remplissage (date)**, **Dernière mesure pH (date)** | `backwashDate`, `refillDate`, `phMeasureDate` | 11.001 | date |
| **Capteur pH présent**, **Capteur Redox présent**, **Capteur température air présent**, **Capteur chlore libre actif présent**, **Capteur de conductivité présent**, **Capteur de sel présent**, **Capteur de niveau d'eau présent**, **Capteur chlore libre présent**, **Capteur chlore total présent**, **Débitmètre présent**, **Compteur d'énergie présent**, **Couverture présente**, **Nage à contre-courant présente** | `hasPHSensor`, `hasORPSensor`, `hasAirTemperatureSensor`, `hasFACSensor`, `hasConductivitySensor`, `hasSaltSensor`, `hasWaterLevelSensor`, `hasFCSensor`, `hasTCSensor`, `hasFlowMeter`, `hasEnergyMeter`, `hasPoolCover`, `hasJetStream` | 1.001 | 1 : présent |
| **Alerte** | `alert` | 1.001 | 1 : au moins une alarme |
| **Nombre d'alerte** | `alertCount` | 5.010 | nombre d’alarmes |
| **Alerte 1** à **Alerte 5** | `alert1` à `alert5` | 5.010 | code d’alarme numéroté |

**Consigne de chauffage** reprend la consigne du premier auxiliaire qui commande le chauffage.

## Repérer les auxiliaires et les alarmes

Pour **Auxiliaire 1** à **Auxiliaire 30**, la colonne **Valeur** des statuts affiche le nom de l’auxiliaire dans PoolCop. Sur un PoolCop équipé de modules d’auxiliaires, **Auxiliaire 1** à **Auxiliaire 15** correspondent aux voies du premier module et **Auxiliaire 16** à **Auxiliaire 30** à celles du second. Sans module, **Auxiliaire 1** à **Auxiliaire 16** correspondent aux voies 1 à 16.

**Alerte 1** à **Alerte 5** portent un nombre par alarme active :

| Valeur | Alarme |
| --- | --- |
| 0 | Emplacement vide |
| 1 | PressureLowPump1 |
| 2 | PHLow |
| 3 | FCHigh |
| 100 à 255 | Autre code PoolCop, numéroté à partir de son nom |

La colonne **Valeur** affiche le code PoolCop suivi de son numéro, par exemple **PHLow (2)**.

## Commandes PoolCop Cloud reçues du bus KNX

| Nom | Clé | DPT | Valeurs acceptées |
| --- | --- | --- | --- |
| **Pompe ON / OFF**, **Pompe 2 ON / OFF** | `pumpOnOff`, `pump2OnOff` | 1.001 | 1 : marche ; 0 : arrêt |
| **Vitesse de la pompe**, **Vitesse de la pompe 2** | `pumpSpeed`, `pump2Speed` | 5.010 | 0 à 8 ; une autre valeur n’est pas transmise |
| **Forçage pompe**, **Forçage pompe 2** | `pumpForced`, `pump2Forced` | 5.010 | 0 : NotForced ; 1 : Forced24H ; 2 : Forced48H ; 3 : Forced72H ; une autre valeur n’est pas transmise |
| **Position de la valve**, **Position de la valve 2** | `valvePosition`, `pump2ValvePosition` | 5.010 | 0 à 5, selon le tableau des valeurs codées |
| **Auxiliaire 1** à **Auxiliaire 30** | `aux1` à `aux30` | 1.001 | 1 : marche ; 0 : arrêt |
| **Nage à contre-courant marche/arrêt** | `jetStreamOnOff` | 1.001 | 1 : marche ; 0 : arrêt |
| **Consigne chauffage** | `setHeatingSetpoint` | 9.001 | consigne de chauffage |
| **Effacer toutes les alarmes** | `clearAllAlarms` | 1.001 | tout télégramme |

N’envoyez que les valeurs 0 à 5 pour la vanne : une autre valeur demande la position **Filter**. **Effacer toutes les alarmes** efface les alarmes à chaque télégramme reçu, quelle que soit sa valeur. **Nage à contre-courant marche/arrêt** n’est pas transmise si le PoolCop indique qu’elle n’est pas installée. **Consigne chauffage** s’applique au premier auxiliaire qui commande le chauffage.

PoolCop Cloud accepte une requête par seconde pour une même clé d’API : Pool’nX met les commandes en file d’attente. Elle attend ensuite leur prise en compte par le PoolCop, jusqu’à deux minutes environ, puis relit les statuts. Si PoolCop Cloud signale trop de requêtes, Pool’nX renvoie la commande une fois, 11 secondes plus tard.

## PoolCop (legacy)

Le type **PoolCop (legacy)** propose une table plus courte :

- statuts : températures de l’eau et de l’air, **Pression** (14.066, kPa), **pH**, **Redox**, **Tension batterie**, **Niveau d'eau**, pompe, vanne, **Auxiliaire 1** à **Auxiliaire 6**, consignes pH, Redox et chauffage, **Ajout auto. eau**, dates d’entretien, **Piscine connectée au reseau**, **Alerte**, **Nombre d'alerte** et **Alerte 1** à **Alerte 5** ;
- commandes : **Auxiliaire 1** à **Auxiliaire 6**, **Pompe ON / OFF**, **Position de la valve**, **Vitesse de la pompe** et **Consigne chauffage**.

Pour **Auxiliaire 1** à **Auxiliaire 6** et **Pompe ON / OFF**, la valeur reçue n’est pas transmise : chaque télégramme envoie la même commande au PoolCop. Vérifiez l’état obtenu dans les statuts, relus 5 secondes après chaque commande.

## Vérifier le résultat

1. Envoyez une commande de test, par exemple **1** (exemple) sur l’adresse de **Pompe ON / OFF**.
2. Dans **Commandes vers la piscine**, vérifiez **Valeur** et **Dernier évènement**.
3. Dans **Statuts de la piscine**, **Status de la pompe** passe à 1 une fois la commande prise en compte.

En cas de message dans **Valeur**, voir [les commandes KNX](https://wiki.can-nx.com/guides/pool-knx-commands/) et [le dépannage Pool’nX](https://wiki.can-nx.com/guides/pool-help/).

Interface en anglais : **Water temperature**, **Pump Status**, **Pump speed**, **Position of the valve**, **Pump running status**, **Pump filtration mode**, **Water level**, **Auxiliary 1**, **Alert number**, **Pump ON / OFF**, **Pump forced**, **Jet stream on/off**, **Heating setpoint**, **Clear all alarms**.