TomTuT Pool Dosing Card

Custom Lovelace Dashboard Card fuer die TomTuT Pool Dosing Integration (Beniferro Gen2 Dosieranlage). Zeigt pH-Wert, Redox-Wert, Pumpenstatus, Firmware-Version und Wasserfluss mit Animationen an.

Disclaimer: Dieses Projekt ist nicht affiliiert mit Beniferro, Poolsana oder deren Tochtergesellschaften. Nutzung auf eigene Verantwortung.

---

---

Features

• pH- und Redox-Werte — Live-Anzeige der aktuellen Messwerte direkt auf der Card
• Animierter Wasserfluss — Animierte Wellendarstellung mit konfigurierbarer Geschwindigkeit und Richtung
• Animierte Pumpen — Drei Pumpen-Stile: Pfeil, Ventilator, Punkte-Rad — drehen wenn die Pumpe laeuft
• Firmware-Anzeige / Freitextfeld — Zeigt die Firmware-Version oder einen eigenen Text an
• Smarte Steckdose — Optionales Ein/Aus-Icon fuer eine verknuepfte Steckdose direkt in der Card
• Zwei Anlagentypen — Vordefinierte Layouts fuer Typ 1 und Typ 2 (Beniferro Gen2)
• Zwei Bildvarianten — Transparent (dunkel) oder weisser Hintergrund
• Visueller Editor — Kompletter GUI-Editor mit Live-Vorschau, keine YAML-Kenntnisse noetig
• Vollstaendig anpassbar — Positionen, Groessen und Farben aller Elemente individuell einstellbar

---

Voraussetzungen

• Home Assistant 2024.1.0 oder neuer
• HACS installiert
• TomTuT Pool Dosing Integration installiert und konfiguriert

Wichtig: Die Integration muss zuerst installiert sein — sie stellt die Sensoren bereit, die diese Card anzeigt.

---

Installation

Via HACS (empfohlen)

1. HACS in Home Assistant oeffnen
2. Frontend → Drei-Punkte-Menue → Benutzerdefinierte Repositories
3. Repository hinzufuegen: https://github.com/TomTuTHub/tomtut-pool-dosing-card — Kategorie: Dashboard
4. Nach TomTuT Pool Dosing Card suchen und Herunterladen
5. Browser neu laden

Manuelle Installation

1. tomtut-pool-dosing-card.js vom neuesten Release herunterladen
2. Nach config/www/community/tomtut-pool-dosing-card/ in der Home Assistant Instanz kopieren
3. In HA: Einstellungen → Dashboards → Ressourcen → Ressource hinzufuegen:
   • URL: /local/community/tomtut-pool-dosing-card/tomtut-pool-dosing-card.js
   • Ressourcentyp: JavaScript-Modul
4. Browser neu laden

---

Konfiguration

Die Card im Dashboard-Editor hinzufuegen: Karte hinzufuegen → TomTuT Pool Dosing auswaehlen. Der visuelle Editor oeffnet sich automatisch.

Grundeinstellungen

Option	Pflicht	Beschreibung
entity_prefix	Ja	Entity-Praefix deiner Dosieranlage
model	Nein	Anlagentyp: type1 (Standard) oder type2
image_variant	Nein	Bildvariante: dark (Transparent) oder light (Weiss)
plug_entity	Nein	Entity-ID einer smarten Steckdose (z.B. switch.dosieranlage)

Entity-Praefix ermitteln

Der Praefix ist sensor. gefolgt vom Namen deiner Dosieranlage in Home Assistant. Leerzeichen werden zu Unterstrichen, alles klein.

Beispiel: Heisst deine Anlage Meine Pool Dosieranlage, dann ist der Praefix: sensor.meine_pool_dosieranlage

YAML-Beispiel (manuelle Konfiguration)

type: custom:tomtut-pool-dosing-card
entity_prefix: sensor.tomtut_pool_dosieranlage
model: type1
image_variant: dark
plug_entity: switch.dosieranlage

Erweiterte Einstellungen

Im visuellen Editor unter Erweiterte Einstellungen koennen alle Positionen, Groessen und Farben der einzelnen Elemente angepasst werden:

• Wasserfluss — Geschwindigkeit, Richtung, Position, Hoehe, Breite
• Pumpen — Position, Groesse, Drehgeschwindigkeit, Symbol-Stil
• Firmware/Freitext — Position, Groesse, Farbe, Hintergrund-Box
• Messwerte — Position, Groesse, Farbe, Labels, Hintergrund-Box
• Steckdose — Position

---

Verwendete Entities

Die Card nutzt folgende Entities der Integration:

Entity	Beschreibung
sensor.*_ph	pH-Wert
sensor.*_redox	Redox-Wert (mV)
sensor.*_firmware_version	Firmware-Version der Anlage
sensor.*_flow	Wasserdurchfluss-Status
binary_sensor.*_ph_pumpe	pH-Dosierpumpe aktiv
binary_sensor.*_redox_pumpe	Redox-Dosierpumpe aktiv

---

Support & Issues

Bugs und Feature-Requests bitte hier melden: https://github.com/TomTuTHub/tomtut-pool-dosing-card/issues

---

Lizenz

MIT License — siehe LICENSE fuer Details.

---

Ueber den Autor

Ich bin ausgebildeter Fachinformatiker fuer Systemintegration mit langjaeehriger IT-Erfahrung. Frueher war es der MCSE — heute ist es Vibe Coding. Diese Card wurde mit Hilfe von Claude gebaut. Ohne KI-Unterstuetzung haette ich das nebenbei nie in dieser Form hinbekommen. Der Code wurde von mir getestet und laeuft in meinem eigenen Produktiv-Setup.

Mehr auf thomasbase.de und YouTube @TomTuT.

---

Das war TomTuT, bleib hart am Gas.