Meine ReefTank-Werkzeuge
Willkommen zur Dokumentation meiner Riffaquarium-Projekte.
- Meine ReefTank-Werkzeuge
Home Assistant Integrationen und Karten
Seit Home Assistant 2026.11 ist HACS als Marketplace Teil von Home Assistant (Einstellungen > Marketplace). Bei einem älteren Home Assistant funktionieren dieselben Schritte in HACS.
Integrationen
🐠 ha-reefbeat-component
Lokale Integration für das Red Sea ReefBeat-Ökosystem.
Verwalten Sie Ihre Red Sea ReefBeat-Geräte lokal (kein Cloud erforderlich): ReefATO+, ReefControl, ReefControl-Power, ReefDose, ReefLed, ReefMat, ReefRun und ReefWave.
⚠️ Dies ist kein offizielles Red Sea Repository. Nutzung auf eigene Gefahr.
Hauptfunktionen:
- 100% lokale Steuerung — keine Cloud-Abhängigkeit für die meisten Geräte
- Automatische Geräteerkennung im lokalen Netzwerk (mit manuellem Modus und Subnetz-Unterstützung)
- Benutzerdefinierte Icons für alle ReefBeat-Geräte
- Firmware-Update-Benachrichtigungen (mit optionaler Cloud API)
- Live-Konfigurationsaktualisierung für Echtzeit-Überwachung
- Dosierregelung für die ReefDose: assistierte Dosierung anhand Ihrer Testergebnisse, auf die Salinität geregelte Salzlösung
- Poseidon-Modus (experimentell): ein lokales Relais, das den Großteil der Abfragen durch das ersetzt, was die Geräte senden, mit dem Dosierverlauf und den Gerätealarmen als Home-Assistant-Ereignisse
- Mehrsprachige Unterstützung
Unterstützte Geräte:
✅ Unterstützt 🚧 In Arbeit 🧪 Ungetestet (könnte funktionieren) ❌ Noch nicht unterstützt
| Gerät | Modelle | Status |
|---|---|---|
| ReefATO+ | RSATO+ | ✅ |
| ReefControl | RSCONTROLPRO | ✅ |
| ReefControl | RSCONTROLLITE | 🧪 |
| ReefControl-Power | RSPOWER6 | ✅ |
| ReefControl-Power | RSPOWER8 | 🧪 |
| ReefDose | RSDOSE2, RSDOSE4 | ✅ |
| ReefLed | G1 (RSLED50/90/160), G2 (RSLED60/115) | ✅ |
| ReefLed | G2 (RSLED170) | 🧪 |
| ReefMat | RSMAT250, RSMAT500, RSMAT1200 | ✅ |
| ReefRun | RSRUN | ✅ |
| ReefWave | RSWAVE25, RSWAVE45 | ✅ |
ReefWave-Besonderheiten: ReefWave ist das einzige Gerät, das an die ReefBeat-Cloud gebunden ist. Drei Betriebsmodi stehen zur Verfügung — Cloud, Lokal und Hybrid — damit Sie die Balance zwischen voller lokaler Steuerung und Synchronisation mit der ReefBeat-App wählen können.
Installation: Direkt im Marketplace verfügbar — suchen Sie nach “redsea” oder “reefbeat”.
🌊 ha-aquamedic-component
Steuerung von Aqua Medic Pumpen über Home Assistant mittels der Gizwits Cloud API.
Steuern Sie Ihre Aqua Medic Pumpen über Home Assistant mittels der Gizwits Cloud API (dasselbe Backend wie die offizielle Aqua Medic App).
Unterstützte Geräte:
✅ Unterstützt 🚧 In Arbeit 🧪 Ungetestet (könnte funktionieren) ❌ Noch nicht unterstützt
| Gerät | Status |
|---|---|
| EcoDrift / SmartDrift x.1 / x.3 (Strömungspumpe) | ✅ |
| DC Runner x.1 / x.2 / x.3 (Rückförderpumpe) | ✅ |
| DC Runner (Abschäumerpumpe) | ✅ |
EcoDrift / SmartDrift Funktionen:
- Ein/Aus, Wellentyp (Puls/Gezeiten), Fütterungsmodus, Timer, 0-10V Steuerungsmodus
- Wellenmodi: Klassisch, Sinus, Zufällig, Konstanter Fluss
- Kopplung: Unabhängig, Master, Slave
- Durchfluss-, Frequenz- und Fütterungsdauer-Steuerung
- Zeitfensterprogramm, bis zu 48 Zeitfenster
- Vollständige Diagnose-Fehlersensoren (Überstrom, Überspannung, Übertemperatur, blockierter Rotor, Trockenlauf, UART)
DC Runner Funktionen:
- Ein/Aus, Fütterungsmodus (1–60 Min. Pause), 0-10V Steuerungsmodus
- Durchflusssteuerung (30–100%)
- Zeitfensterprogramm, bis zu 48 Zeitfenster
- Diagnose-Fehlersensoren (Trockenlauf, blockierter Rotor, Spannung, Überstrom, Übertemperatur, UART)
Installation: Suchen Sie in Einstellungen > Marketplace nach „Aqua Medic“.
🐟 ha-vson-component
VSON-Futterautomaten in Home Assistant über die VSON-Cloud-API. Der WP8621 kann auch vollständig lokal laufen, indem man ihn mit ESPHome neu flasht — gleiche Platine, keine Cloud.
Unterstützte Geräte:
✅ Unterstützt 🚧 In Arbeit 🧪 Ungetestet (könnte funktionieren) ❌ Noch nicht unterstützt
| Gerät | Modelle | Status |
|---|---|---|
| WP8621 automatic fish feeder | variants N/E/H/F/B/P/A/C | ✅ |
| Any other VSON device | detected | 🧪 |
🐙 ha-reef-maintenance-component
Wartungsverfolgung für Geräte, die Home Assistant nicht erreicht.
Strömungspumpen, Rückförderpumpen, Abschäumer, Reaktoren — alles, was Sie von Hand warten. Ein Eintrag pro Marke, ein Gerät pro Ausrüstung, vier Entitäten pro Aufgabe: eine Schaltfläche, die die Arbeit protokolliert, eine Zahl für das Intervall, ein Schalter zum Stummschalten der Hinweise und ein Datum, um die letzte Wartung rückwirkend einzutragen.
Hauptfunktionen:
- Voreinstellungen für Tunze, Jebao und generische Geräte, mit Herstellerintervallen wo veröffentlicht
- Eine gemeinsame Bibliothek mit 22 Aufgaben, in 8 Sprachen übersetzt
- Rückdatierung, damit ein neues Gerät nicht bei „nie gemacht” beginnt
- Dienst
reef_maintenance.reset— NFC-Tag an die Pumpe kleben und nach getaner Arbeit scannen - Gleicher
reef_role-Vertrag wie die verbundenen Integrationen: die Aufgaben erscheinen in der Wartungsansicht der Karte
Installation: Suchen Sie in Einstellungen > Marketplace nach “reef-maintenance”.
🐟 ha-reeftank-component
Ein lebendiges Bild Ihres Aquariums auf dem Dashboard.

Die Integration hinter der Aquariumkarte von ha-reef-card: Ihr Foto, das Wasser beleuchtet von Ihren echten Lampen, animierte Fische und Korallen und Ihre Geräte und Entitäten darauf. Sie speichert die Aquarien, ihre Bilder und ihren Besatz und protokolliert die Fütterungen.
Hauptfunktionen:
- Wasser, Sand und Steine auf Ihrem eigenen Foto umranden — oder das Becken mit Stein- und Sandtexturen zeichnen
- Fische im Schwarm, im Freiwasser, auf dem Sand oder aus ihrer Höhle schauend, die sich nachts hinter den Steinen verstecken
- Wasser in der Farbe Ihrer Lampen (ReefLED oder jedes Licht), Korallen, die sich mit den Pumpen wiegen
- Fütterungen von Futterautomaten, Kurzbefehlen oder einem Dienst; Fisch- und Korallenzahl als Sensoren; pH und ORP werden mit dem eigenen Verlauf des Beckens verglichen
- Arten aus dem reeftank-catalog, automatisch aktuell gehalten
Installation: Suchen Sie in Einstellungen > Marketplace nach “ReefTank” und installieren Sie ha-reef-card für die Karte.
Karten
🪸 ha-reef-card
Benutzerdefinierte Lovelace-Karte für Riff-Dashboards.
Die Reef Card für Home Assistant hilft Ihnen, Ihr Riffaquarium direkt vom Dashboard aus zu verwalten. In Kombination mit ha-reefbeat-component erkennt und unterstützt sie automatisch Ihre Red Sea (ReefBeat) Geräte.
Nicht-Redsea-Geräte können ebenfalls unterstützt werden — hier anfragen.
Unterstützte Geräte:
✅ Unterstützt 🚧 In Arbeit 🧪 Ungetestet (könnte funktionieren) ❌ Noch nicht unterstützt
| Gerät | Status | Highlights |
|---|---|---|
| ReefDose (RSDOSE2/4) | ✅ | Vollständige Planung, manuelle Dosierung, Entlüften und Kalibrieren, Zusatzstoffverwaltung, Verbrauchsverfolgung, Dosierregelung (assistiert, Salzlösung), Dosierverlauf |
| ReefMat (RSMAT250/500/1200) | ✅ | Animierter Rollenstatus, manueller/automatischer/geplanter Vorschub, Sensorstatus, Wochen- und Monatsgrafiken |
| ReefRun (RSRUN) | ✅ | Pumpendrehzahl, Zeitplan-Editor, Überschäumen-Verwaltung |
| ReefATO+ | ✅ | Wasserstand, Lecksonde, Pumpendiagnose, Verbrauchsdiagramm, Leck-Summer |
| ReefControl (RSCONTROLPRO) | ✅ | Sonden mit Pegelbalken, Trends und 7-Tage-Verlauf, geführte pH/EC/ORP/Temperatur-Kalibrierung, 12V-Ports, ATO, Summer, gekoppelte Steckdosenleiste |
| ReefControl (RSCONTROLLITE) | 🧪 | Sonden mit Pegelbalken, Trends und 7-Tage-Verlauf, geführte pH/EC/ORP/Temperatur-Kalibrierung, 12V-Ports, ATO, Summer, gekoppelte Steckdosenleiste |
| ReefControl-Power (RSPOWER6) | ✅ | Steuerung pro Steckdose, Modi Ein/Aus/Zeitplan/Sonde, verknüpfte Geräte, lokale Temperatursonde oder ReefControl-Verbindung |
| ReefControl-Power (RSPOWER8) | 🧪 | Steuerung pro Steckdose, Modi Ein/Aus/Zeitplan/Sonde, verknüpfte Geräte, lokale Temperatursonde oder ReefControl-Verbindung |
| ReefLed (G1) | ✅ | Himmel mit Sonne und Mond, Lichtkegel mit dem Tagesprogramm, Regler für Intensität/Farbe oder Weiß/Blau, Programm-Editor (Kelvin oder Weiß/Blau, Wolken), Wettermodus, Gruppen mit versetztem Sonnenaufgang, Akklimatisierung |
| ReefLed (G2) | 🧪 | Himmel mit Sonne und Mond, Lichtkegel mit dem Tagesprogramm, Regler für Intensität/Farbe oder Weiß/Blau, Programm-Editor (Kelvin oder Weiß/Blau, Wolken), Wettermodus, Gruppen mit versetztem Sonnenaufgang, Akklimatisierung |
| ReefWave (RSWAVE25/45) | ✅ | Animierte Pumpenansicht, Geschwindigkeit und Richtung, Wellenbibliothek, Zeitplan-Editor mit Zeitfenstern, Pumpengruppen |
| Aqua Medic EcoDrift / SmartDrift | ✅ | Pumpendrehzahl im Bild, Störungen, Fütterungspause, Zeitfenster-Programm-Editor |
| Aqua Medic DC Runner (return, skimmer) | ✅ | Ansicht als Förder- oder Abschäumerpumpe je nach Rolle in der Integration, Drehzahl, Störungen, Zeitfenster-Programm-Editor |
| Energy Backup (reefbeatEnergyBackup) | ✅ | Energieflüsse von Netz, Batterie und Pumpen, gezeichnet mit Power Flow Card Plus |
| VSON fish feeder (hacked, ESPHome) | ✅ | Lebendiges Bild des Automaten, Fütterungsplätze, Vorratswarnung, Jetzt füttern |
| Aquarium view (ha-reeftank-component) | ✅ | Das Foto Ihres Beckens mit Live-Geräten und -Entitäten, vom Licht Ihrer Lampen getöntes Wasser, animierte Fische und Korallen, Szeneneditor mit sieben Reitern |
ReefDose-Highlights:
- 6-Zonen-Karte: Config/WiFi, Zustände, manuales Dosieren mit Shortcuts, Kopfplanung mit kreisförmigem Fortschritt, Supplement-Verwaltung mit Markenbildern und Warteschlange für bevorstehende Dosen
- Unterstützung von Priming- und Kalibrierungsabläufen
- Dialoge der Dosierregelung: assistierte Dosierung, Salzlösung mit Salinitätsdiagramm
- Supplement-Bibliothek mit Bildern für Red Sea, Tropic Marin, Quantum, ATI, Aqua Forest und mehr
ReefMat-Highlights:
- 7-Zonen-Karte mit animiertem Hintergrund, der sich je nach Rollenverbrauch ändert (0%–100%)
- Echtzeit-Rolleninfo: Restlänge, Tagesdurchschnitt, geschätzte verbleibende Tage
- Manuelle, automatische und geplante Vorschubsteuerung
- Anzeige des Füllstandsensorstatus (verbunden, getrennt, verschmutzt)
- Wochen- und Monatsverbrauchsdiagramme
Aquarienansicht: Eine zweite Karte, custom:reef-aquarium-card, zeigt ein lebendiges Bild Ihres Beckens. Sie benötigt ha-reeftank-component.
Installation: Direkt im Marketplace verfügbar — suchen Sie nach “reef-card”.
Konfiguration: Ohne den Parameter device erkennt die Karte automatisch alle ReefBeat-Geräte und lässt Sie wählen. Setzen Sie den Parameter device, um ein bestimmtes Gerät zu erzwingen.
![]() ReefDose-Demo |
![]() ReefMat-Demo |
![]() ReefRun-Demo |
![]() Wartungs-Demo |
![]() ReefATO+-Demo |
![]() ReefControl- & ReefControl-Power-Demo |
![]() ReefLed-Demo |
![]() ReefWave-Demo |
![]() Aqua-Medic-Demo |
![]() Aquarienansicht-Demo |
🔌 Infrastruktur
⚡ reefbeatEnergyBackup
Autonomes Batterie-Backup-System für Red Sea Riffaquarien.
Halten Sie Ihre ReefWave, ReefRun und DC Skimmer bei Stromausfällen mit einer 24V LiFePO₄-Batterie, einem Raspberry Pi und intelligenter Pumpen-Drosselung am Laufen.

Hauptfunktionen:
- Batterieüberwachung via INA226 (I2C) + optionaler Victron BLE Lader
- Sofortige Ausfallserkennung via 230V-Relais am GPIO
- Progressive Pumpendrosselung — SoC-basierte Stufen berechnet aus einer Zielautonomie
- 3-stufiges Netzwerk-Failover — Ethernet → Wi-Fi → autonomer Mirror-Hotspot
- 4G LTE Failover — Benachrichtigungen und ReefBeat-Cloud-Zugang über USB-Modem oder Smartphone-Tethering
- Push-Benachrichtigungen via ntfy.sh (kostenlos, kein Konto erforderlich)
- Home Assistant Integration — MQTT Auto-Discovery, Update-Entity, Batterie-Test-Blueprint
- Poseidon-Watchdog — überwacht das MQTT-Relais von ha-reefbeat-component und schaltet die Geräte in den Normalmodus zurück, wenn es ausfällt
- Auto-Update — prüft GitHub auf neue Versionen, HA Update-Entity mit “Installieren”-Button
Hardware-Stufen:
| Stufe | Was Sie bekommen | Budget |
|---|---|---|
| 1 — Basis | Batterie + Kabel, passives Backup | ~290 € |
| 2 — Normal (empfohlen) | + RPi + INA226 + Relais, volles Monitoring & Automatisierung | ~402 € |
| 3 — Erweitert | + Victron BLE Lader, Smart-Schutzschalter, 4G-Modem | ~664 € |
Installation:
curl -sL https://raw.githubusercontent.com/Elwinmage/reefbeatEnergyBackup/main/install.sh | sudo bash
Funktioniert eigenständig oder als Ergänzung zu ha-reefbeat-component für ein vollständig integriertes Riff-Management-Setup.
🐬 ha-reef-blueprints
Automatisierungs-Blueprints für das gesamte Ökosystem.
Benachrichtigt Sie auf dem Telefon über überfällige Wartungen, gefunden über das gemeinsame Attribut reef_role, sodass jede Integration abgedeckt ist, und über nicht mehr erreichbare Geräte. Testet Ihre Heizer einzeln und warnt Sie, wenn ein Relais aus ist, sein Gerät aber noch Strom zieht. Acht Sprachen, je eine Import-Schaltfläche.
Installation: Import aus dem Repository, eine Schaltfläche je Sprache.
📐 3D-Modelle
ReefRun DC Skimmer
📦 Red Sea DC Skimmer Impeller-Werkzeug
Videodemonstration:
📦 Fußerhöhungen für den Red Sea DC Skimmer
Erhöhungen für die Füße des Red Sea DC Abschäumers, um seine Höhe im Technikbecken einzustellen. Vier Versionen: 80, 70, 60 und 50 mm.
Wassertests
📦 Organizer für Red Sea Riffaquarium-Tests
Ein Aufbewahrungssystem für die Red Sea Wassertests fürs Riffaquarium.
💬 Kontakt & Support
- Fragen und Funktionswünsche: eröffnen Sie eine Diskussion im betreffenden Projekt — ha-reefbeat-component · ha-aquamedic-component · ha-reef-card · ha-reef-maintenance-component · ha-reeftank-component · reeftank-catalog · reefbeatEnergyBackup · ha-reef-blueprints
- Fehlerberichte: eröffnen Sie ein Issue im selben Projekt, mit den Details.
- Projekt unterstützen:









