PoolCop KNX : statuts, commandes et valeurs à utiliser avec Pool’nX
Pool’nXAdministrateurInstallateur
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 et les commandes KNX. La clé sert aussi au client TCP.
Unités et valeurs codées
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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)
Section intitulée « 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
Section intitulée « Vérifier le résultat »- Envoyez une commande de test, par exemple 1 (exemple) sur l’adresse de Pompe ON / OFF.
- Dans Commandes vers la piscine, vérifiez Valeur et Dernier évènement.
- 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 et le dépannage Pool’nX.
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.