PoolCop-KNX-Referenz für Pool’nX: Statuswerte, Befehle und DPT
Pool’nXAdministratorInstallateur
Pool’nX mit einem PoolCop: Tabellen Pool Status und Pool Commands, PoolCop Cloud und legacy
Diese Referenztabelle listet die Statuswerte, die ein Pool’nX über PoolCop Cloud von einem PoolCop abfragt, und die Befehle, die es vom KNX-Bus an ihn weiterleitet: angezeigter Name, Schlüssel, DPT, Einheit und codierte Werte für Pumpe, Ventil, Wasserstand und Alarme. Ein letzter Abschnitt fasst den Typ PoolCop (legacy) zusammen.
Für den Installateur, der die KNX-Objekte, die Visualisierung oder die Logik des Pools vorbereitet. Wie Sie die Adressen eingeben, beschreiben die KNX-Statuswerte und die KNX-Befehle. Der Schlüssel dient auch dem TCP-Client.
Einheiten und codierte Werte
Abschnitt betitelt „Einheiten und codierte Werte“Temperaturen, Drücke, Volumen und Durchflüsse werden in den Einheiten des PoolCop-Kontos übertragen, ohne Umrechnung: Die Spalte Value (Wert) zeigt die verwendete Einheit, zum Beispiel °C oder °F, bar, kPa oder psi, m³ oder gal. Prüfen Sie, ob sie der Einheit entspricht, die der DPT des KNX-Objekts erwartet.
Die Zustände von Pumpe, Ventil und Wasserstand sind als Zahl codiert (DPT 5.010). Die Spalte Value zeigt den PoolCop-Begriff, gefolgt von der Zahl, zum Beispiel Speed2 (2).
| Wert | Drehzahlstufe | Ventilstellung | Betriebszustand | Filtermodus | Wasserstand |
|---|---|---|---|---|---|
| 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 | – |
Die Spalte Drehzahlstufe gilt auch für Pump number of speeds (Anzahl der Pumpendrehzahlen); die Spalte Wasserstand gilt für die Wasserstand-Sollwerte.
Auf den KNX-Bus gesendete PoolCop-Cloud-Statuswerte
Abschnitt betitelt „Auf den KNX-Bus gesendete PoolCop-Cloud-Statuswerte“| Name | Schlüssel | DPT | Einheit oder Wert |
|---|---|---|---|
| Water temperature (Wassertemperatur), Air temperature (Lufttemperatur) | tempWater, tempAir | 9.001 | Temperatur in der Einheit des Kontos |
| pH | pH | 9.002 | pH |
| ORP (Redox) | orp | 14.027 | mV |
| Free chlorine (freies Chlor), Free available chlorine (aktives freies Chlor), Total chlorine (Gesamtchlor) | freeChlorine, freeAvailableChlorine, totalChlorine | 9.001 | mg/l |
| Salt (Salz) | salt | 9.001 | g/l |
| Pressure (Druck) | pressure | 9.001 | Druck der Pumpe 1, Einheit des Kontos |
| Battery voltage (Batteriespannung), Mains voltage (Netzspannung) | battery, mainsVoltage | 14.027 | V, 0, wenn nicht geliefert |
| Service mode (Servicemodus), pH dosing (pH-Dosierung), Disinfection dosing (Desinfektionsdosierung) | serviceMode, pHDosing, disinfectionDosing | 1.001 | 1: aktiv |
| Pool connected to the network (Pool mit dem Netzwerk verbunden) | poolConnected | 1.001 | 1: verbunden |
| Pump Status (Pumpenstatus), Pump 2 status (Status Pumpe 2) | pumpStatus, pump2Status | 1.001 | 1: in Betrieb |
| Pump speed (Pumpendrehzahl), Pump 2 speed (Drehzahl Pumpe 2) | pumpSpeed, pump2Speed | 5.010 | 0 bis 8 |
| Pump pressure (Pumpendruck), Pump 2 pressure (Druck Pumpe 2) | pumpPressure, pump2Pressure | 9.001 | Einheit des Kontos |
| Position of the valve (Ventilstellung), Pump 2 valve position (Ventilstellung Pumpe 2) | valvePosition, pump2ValvePosition | 5.010 | 0 bis 5 |
| Pump running status (Betriebszustand der Pumpe), Pump 2 running status (Betriebszustand Pumpe 2) | pumpRunningStatus, pump2RunningStatus | 5.010 | 0 bis 9 |
| Pump forced time remaining (verbleibende Zwangslaufzeit der Pumpe), Pump 2 forced time remaining (verbleibende Zwangslaufzeit Pumpe 2) | pumpForcedRemaining, pump2ForcedRemaining | 7.005 | s |
| Pump number of speeds, Pump 2 number of speeds (Anzahl der Drehzahlen Pumpe 2) | pumpNumberOfSpeeds, pump2NumberOfSpeeds | 5.010 | 0 bis 8 |
| Pump filtration mode (Filtermodus der Pumpe), Pump 2 filtration mode (Filtermodus Pumpe 2) | pumpFiltrationMode, pump2FiltrationMode | 5.010 | 0 bis 9 |
| Water level (Wasserstand) | waterLevel | 5.010 | 0 bis 4 |
| Water level setpoint (Wasserstand-Sollwert), Water level target setpoint (Wasserstand-Zielsollwert) | waterLevelSetPoint, waterLevelTargetSetpoint | 5.010 | 0 bis 4 |
| Water level sensor installed (Wasserstandssensor installiert), Water level on target (Wasserstand erreicht), Water level error (Wasserstandsfehler), Water level refilling (Nachfüllen läuft), Water level measuring (Wasserstandsmessung läuft) | waterLevelInstalled, waterLevelOnTarget, waterLevelOnError, waterLevelRefilling, waterLevelMeasuring | 1.001 | 1: ja |
| Cover installed (Abdeckung installiert), Cover controllable (Abdeckung steuerbar), Cover open (Abdeckung offen), Cover closing (Abdeckung schließt), Cover opening (Abdeckung öffnet), Cover stopped (Abdeckung gestoppt) | coverInstalled, coverControllable, coverOpen, coverClosing, coverOpening, coverStopped | 1.001 | 1: ja |
| Jet stream installed (Gegenstromanlage installiert), Jet stream running (Gegenstromanlage läuft) | jetStreamInstalled, jetStreamRunning | 1.001 | 1: ja |
| Flow meter 1 installed (Durchflussmesser 1 installiert), Flow meter 2 installed (Durchflussmesser 2 installiert) | flow1Installed, flow2Installed | 1.001 | 1: ja |
| Flow rate 1 (Durchfluss 1), Flow rate 2 (Durchfluss 2) | flow1Rate, flow2Rate | 9.001 | Durchfluss in der Einheit des Kontos |
| Input 1 bis Input 12 (Eingang 1 bis 12) | input1 bis input12 | 1.001 | 1: aktiv |
| Auxiliary 1 bis Auxiliary 30 (Zusatzausgang 1 bis 30) | aux1 bis aux30 | 1.001 | 1: in Betrieb |
| pH setpoint (pH-Sollwert), pH low (pH-Untergrenze), pH high (pH-Obergrenze) | pHSetpoint, pHLow, pHHigh | 9.002 | pH |
| ORP setpoint (Redox-Sollwert), ORP low (Redox-Untergrenze), ORP high (Redox-Obergrenze) | orpSetpoint, orpLow, orpHigh | 14.027 | mV |
| FAC setpoint (Sollwert aktives freies Chlor), FAC low (Untergrenze aktives freies Chlor), FAC high (Obergrenze aktives freies Chlor) | FACSetpoint, FACLow, FACHigh | 9.001 | mg/l |
| FC setpoint (Sollwert freies Chlor), TC low (Untergrenze Gesamtchlor), TC high (Obergrenze Gesamtchlor) | FCSetpoint, TCLow, TCHigh | 9.001 | mg/l |
| Heating setpoint (Heizungssollwert) | heatingSetpoint | 9.001 | Temperatur in der Einheit des Kontos |
| Pool volume (Beckenvolumen) | poolVolume | 9.001 | Volumen in der Einheit des Kontos |
| Freeze protection (Frostschutz), ACO installed (ACO installiert), Remnant installed (Remanent installiert) | freezeProtection, acoInstalled, remnantInstalled | 1.001 | 1: ja |
| Electrolyser production (Elektrolyseleistung) | electrolyserProductionPercent | 5.001 | % |
| Last backwash (date) (letzte Rückspülung, Datum), Last refill (date) (letztes Nachfüllen, Datum), Last pH measurement (date) (letzte pH-Messung, Datum) | backwashDate, refillDate, phMeasureDate | 11.001 | Datum |
| pH sensor present (pH-Sensor vorhanden), ORP sensor present (Redox-Sensor vorhanden), Air temperature sensor present (Lufttemperatursensor vorhanden), FAC sensor present (Sensor für aktives freies Chlor vorhanden), Conductivity sensor present (Leitfähigkeitssensor vorhanden), Salt sensor present (Salzsensor vorhanden), Water level sensor present (Wasserstandssensor vorhanden), FC sensor present (Sensor für freies Chlor vorhanden), TC sensor present (Gesamtchlorsensor vorhanden), Flow meter present (Durchflussmesser vorhanden), Energy meter present (Energiezähler vorhanden), Pool cover present (Poolabdeckung vorhanden), Jet stream present (Gegenstromanlage vorhanden) | hasPHSensor, hasORPSensor, hasAirTemperatureSensor, hasFACSensor, hasConductivitySensor, hasSaltSensor, hasWaterLevelSensor, hasFCSensor, hasTCSensor, hasFlowMeter, hasEnergyMeter, hasPoolCover, hasJetStream | 1.001 | 1: vorhanden |
| Alert (Alarm) | alert | 1.001 | 1: mindestens ein Alarm |
| Alert number (Anzahl der Alarme) | alertCount | 5.010 | Anzahl der Alarme |
| Alert 1 bis Alert 5 (Alarm 1 bis 5) | alert1 bis alert5 | 5.010 | nummerierter Alarmcode |
Der Statuswert Heating setpoint übernimmt den Sollwert des ersten Zusatzausgangs, der die Heizung steuert.
Zusatzausgänge und Alarme erkennen
Abschnitt betitelt „Zusatzausgänge und Alarme erkennen“Für Auxiliary 1 bis Auxiliary 30 zeigt die Spalte Value der Statuswerte den Namen des Zusatzausgangs in PoolCop. Bei einem PoolCop mit Modulen für Zusatzausgänge entsprechen Auxiliary 1 bis Auxiliary 15 den Kanälen des ersten Moduls und Auxiliary 16 bis Auxiliary 30 denen des zweiten. Ohne Modul entsprechen Auxiliary 1 bis Auxiliary 16 den Kanälen 1 bis 16.
Alert 1 bis Alert 5 enthalten je eine Zahl pro aktivem Alarm:
| Wert | Alarm |
|---|---|
| 0 | Leerer Platz |
| 1 | PressureLowPump1 |
| 2 | PHLow |
| 3 | FCHigh |
| 100 bis 255 | Anderer PoolCop-Code, anhand seines Namens nummeriert |
Die Spalte Value zeigt den PoolCop-Code, gefolgt von seiner Nummer, zum Beispiel PHLow (2).
Vom KNX-Bus empfangene PoolCop-Cloud-Befehle
Abschnitt betitelt „Vom KNX-Bus empfangene PoolCop-Cloud-Befehle“| Name | Schlüssel | DPT | Zulässige Werte |
|---|---|---|---|
| Pump ON / OFF (Pumpe EIN/AUS), Pump 2 ON / OFF (Pumpe 2 EIN/AUS) | pumpOnOff, pump2OnOff | 1.001 | 1: Ein; 0: Aus |
| Pump speed, Pump 2 speed | pumpSpeed, pump2Speed | 5.010 | 0 bis 8; ein anderer Wert wird nicht übertragen |
| Pump forced (Zwangslauf der Pumpe), Pump 2 forced (Zwangslauf Pumpe 2) | pumpForced, pump2Forced | 5.010 | 0: NotForced; 1: Forced24H; 2: Forced48H; 3: Forced72H; ein anderer Wert wird nicht übertragen |
| Position of the valve, Pump 2 valve position | valvePosition, pump2ValvePosition | 5.010 | 0 bis 5, gemäß der Tabelle der codierten Werte |
| Auxiliary 1 bis Auxiliary 30 | aux1 bis aux30 | 1.001 | 1: Ein; 0: Aus |
| Jet stream on/off (Gegenstromanlage ein/aus) | jetStreamOnOff | 1.001 | 1: Ein; 0: Aus |
| Heating setpoint | setHeatingSetpoint | 9.001 | Heizungssollwert |
| Clear all alarms (alle Alarme löschen) | clearAllAlarms | 1.001 | jedes Telegramm |
Senden Sie für das Ventil nur die Werte 0 bis 5: Ein anderer Wert fordert die Stellung Filter an. Clear all alarms löscht die Alarme bei jedem empfangenen Telegramm, unabhängig von seinem Wert. Jet stream on/off wird nicht übertragen, wenn der PoolCop meldet, dass die Gegenstromanlage nicht installiert ist. Der Befehl Heating setpoint gilt für den ersten Zusatzausgang, der die Heizung steuert.
PoolCop Cloud akzeptiert eine Anfrage pro Sekunde für denselben API-Schlüssel: Pool’nX stellt die Befehle in eine Warteschlange. Danach wartet es, bis der PoolCop sie übernommen hat, bis zu etwa zwei Minuten, und fragt dann die Statuswerte erneut ab. Meldet PoolCop Cloud zu viele Anfragen, sendet Pool’nX den Befehl einmal erneut, 11 Sekunden später.
PoolCop (legacy)
Abschnitt betitelt „PoolCop (legacy)“Der Typ PoolCop (legacy) bietet eine kürzere Tabelle:
- Statuswerte: Wasser- und Lufttemperatur, Pressure (14.066, kPa), pH, ORP, Battery voltage, Water level, Pumpe, Ventil, Auxiliary 1 bis Auxiliary 6, Sollwerte für pH, Redox und Heizung, Auto Add Water (automatisches Nachfüllen), Datumsangaben zur Wartung, Pool connected to the network, Alert, Alert number und Alert 1 bis Alert 5;
- Befehle: Auxiliary 1 bis Auxiliary 6, Pump ON / OFF, Position of the valve, Pump speed und Heating setpoint.
Bei Auxiliary 1 bis Auxiliary 6 und Pump ON / OFF wird der empfangene Wert nicht übertragen: Jedes Telegramm sendet denselben Befehl an den PoolCop. Prüfen Sie den erreichten Zustand in den Statuswerten, die 5 Sekunden nach jedem Befehl erneut abgefragt werden.
Ergebnis prüfen
Abschnitt betitelt „Ergebnis prüfen“- Senden Sie einen Testbefehl, zum Beispiel 1 (Beispiel) auf die Adresse von Pump ON / OFF.
- Prüfen Sie in Pool Commands (Poolbefehle) Value und Last event (letztes Ereignis).
- In Pool Status (Poolstatus) wechselt Pump Status auf 1, sobald der Befehl übernommen wurde.
Bei einer Meldung in Value siehe die KNX-Befehle und die Pool’nX-Fehlerbehebung.
Französische Bezeichnungen: Température de l’eau, Status de la pompe, Vitesse de la pompe, Position de la valve, État de marche de la pompe, Mode de filtration de la pompe, Niveau d’eau, Auxiliaire 1, Nombre d’alerte, Pompe ON / OFF, Forçage pompe, Nage à contre-courant marche/arrêt, Consigne de chauffage und Consigne chauffage, Effacer toutes les alarmes.