ProCon.IP Poolsteuerung

ioBroker-Adapter zur grundlegenden Unterstützung der ProCon.IP-Schwimmbadsteuereinheit. Es ist für die Integration in Ihre ioBroker-Hausautomation vorgesehen, z. um eine Logik zu erstellen, an der andere Geräte beteiligt sind, oder um einfach mit Ihren bevorzugten Sprachassistenten gekoppelt zu werden.

Aktueller Release
1.9.0
Entwickler
Yannic Labonte
Lizenz
MIT

ioBroker-Adapter für den Pool Digital ProCon.IP Schwimmbadcontroller. Er ist für die Integration in Ihre ioBroker-Hausautomation vorgesehen, z. B. um Logik zu erstellen, die andere Geräte einbezieht, oder um mit Ihrem/Ihren bevorzugten Sprachassistenten gekoppelt zu werden:

  • Sie können den Cloud- oder IoT- Adapter für Alexa (und ich glaube auch für Google Home) verwenden und
  • Yahka- Adapter als Brücke zu Apple HomeKit, um von Siri erreicht werden zu können oder
  • Verwenden Sie den JavaScript- Adapter, um Ihre eigene benutzerdefinierte Logik zu erstellen.

Weitere Informationen finden Sie im Wiki .

Was ist der ProCon.IP-Pool-Controller?

Die ProCon.IP Poolsteuerung ist eine kostengünstige, netzwerkfähige Steuereinheit für private Schwimmbäder. Mit ihren softwaregesteuerten Relais kann sie mehrere Pumpen (für die Poolfilterung und verschiedene Dosierungen) steuern, entweder nach einem Zeitplan oder abhängig von Messwerten eines ihrer zahlreichen Eingangskanäle (z. B. Durchflusssensoren, Dallas 1-Wire-Thermometer, Redox- und pH-Elektroden). Die Relais lassen sich auch bedarfsgesteuert schalten, wodurch sie sich auch zum Ein- und Ausschalten von Beleuchtung (oder anderen Geräten) eignen. Nicht alle Funktionen sind über die API zugänglich. Es gibt lediglich eine dokumentierte API zum Auslesen (Abfragen) von Werten im CSV-Format./GetState.csv Ich erinnere mich, dass es noch eine weitere Funktion zum Ein- und Ausschalten der Relais mit Timer gab. Diese kann ich aber nicht mehr finden. Also, nicht besonders ansprechend, aber funktional: Die ProCon.IP verfügt über zwei native Web-Oberflächen, die analysiert werden können, um eine bestimmte Funktionalität (wie das Schalten der Relais) gewissermaßen zu rekonstruieren.

Weitere Informationen finden Sie unter folgendem Link (leider nur auf Deutsch; ich habe bisher keine englische Dokumentation/Informationen gefunden):

Um es klarzustellen: Ich habe nichts mit der Entwicklung, dem Vertrieb, dem Marketing oder dem Support der Poolsteuerungseinheit zu tun. Ich habe lediglich eine Lösung entwickelt, um diese in ioBroker zu integrieren und so das Haus meiner Eltern etwas smarter zu machen.

Details zum Adapter

Der Adapter verwendet den/GetState.csv Die ProCon.IP-API dient zum Abfragen ihrer Werte, eine weitere – nicht dokumentierte – API arbeitet mit Bitbefehlen zum Schalten der Relais. Letztere wird auch von den ursprünglichen Web-Oberflächen der ProCon.IP verwendet. Daher könnten zukünftige Firmware-Updates die Kompatibilität mit diesem Adapter oder zumindest dessen Relais-Schaltfunktion beeinträchtigen.

Kompatibilität

Der Adapter wurde bisher in Kombination mit der ProCon.IP-Firmware- Revision 1.7.6.a getestet und entwickelt. Er sollte aber auch mit allen früheren/neueren Firmware-Versionen funktionieren.

Entwicklung und Teilhabe

Sie können mich gerne kontaktieren, wenn Sie an der Entwicklung, Übersetzung oder Dokumentation dieses Adapters mitwirken möchten.

Nützliche Links für den Ansatz werden sein

Lokales Testen mit Entwicklungsserver

Für praktische Tests mit einem echten ProCon.IP-Controller verwenden Sie@iobroker/dev-server Es startet eine temporäre lokale ioBroker-Instanz (js-Controller + Admin-UI) und führt diesen Adapter aus Ihrem lokalen Build aus:

npm i -g @iobroker/dev-server   # once, globally
npm run dev:setup               # creates the local .dev-server/ profile (git-ignored)
npm run dev                     # builds, runs, admin UI at http://localhost:8081

Konfigurieren Sie die Instanz mit Ihrer Controller-URL in der Admin-Benutzeroberfläche.npm run dev Der Adapter wird bei Änderungen am Quellcode neu erstellt und geladen.

Spende

Wenn Sie diesen Adapter unterstützen oder sich bedanken möchten, können Sie Folgendes tun:

Buy Me A Coffee

Changelog

1.9.0 (2026-08-23)

  • DMX512 lighting support (opt-in). Enable "DMX512 channels" in the adapter settings to expose the controller's 16 DMX channels as writable 0–255 dimmer states (dmx.CH01dmx.CH16).
  • Self-healing object definitions. Objects are now updated on upgrade (via extendObject, versioned), so improved roles/types reach existing installations — while your custom object names are preserved.
  • Fewer redundant events. State values are written only when they actually change, and relay/dosage/timer commands are acknowledged immediately once the controller confirms them.
  • Subscriptions are narrowed to the writable command states, and the boolean status flags now use the indicator role.
  • Large internal refactor for testability: the monolithic adapter was split into a thin shell plus focused, unit-tested modules with a CI coverage gate. No functional change from this part.

1.8.1 (2026-08-22)

  • Fixed relay and DMX switching, which had silently stopped working since 1.8.0's move to the ProCon.IP 2.x library: the controller accepted a write with 200 OK but ignored it. Updated the library to 2.1.1, which sends the exact HTTP request format the controller's firmware requires. Reads were never affected.
  • Resilient startup: the adapter now comes up and keeps polling until the controller becomes reachable, instead of staying inactive when the controller was offline at boot time.
  • Fixed a corner case in the forced-update handling that could keep a relay flagged for updates.
  • Aligned the admin configuration defaults with the adapter's effective runtime defaults and fixed a help-text typo.
  • Maintenance: fixed the unit-test runner so tests actually execute, trimmed the CI test matrix, bumped CI actions (checkout/codeql), and pinned @types/node to the supported Node baseline.

1.8.0 (2026-08-22)

  • Raised the minimum Node.js version to 22 (Node 20 is end-of-life).
  • Updated the ProCon.IP library to 2.x, replacing its axios HTTP client with a leaner implementation and typed error handling.
  • Updated all dependencies and shrank the security-advisory backlog.
  • Internal cleanup: migrated off the deprecated setStateAsync API to setState.
  • Maintenance: adopted npm Trusted Publishing (OIDC), modernized the CI workflow, grouped Dependabot updates, and applied the latest ioBroker repository-checker fixes.

1.7.0 (2025-09-20)

  • Satisfy latest requirements demanded by the ioBroker-Bot.
  • Raise minimum required js-controller version to 7.0.7.
  • Raise minimum required admin version to 7.6.17.
  • Remove calls to deprecated methods.
  • Minor code cleanup.
  • Dependency updates.

1.6.0 (2024-09-08)

  • Fix versioning according to prior changes in requirements (should have happened with v1.5.5).
    • Raise minimum required js-controller version to 5.0.19.
    • Raise minimum required node version to 20.
  • Dependency updates.

License

The MIT License (MIT)

Copyright (c) 2019-2026 Yannic Labonte yannic.labonte@gmail.com