Moje narzędzia ReefTank
Witamy w dokumentacji moich projektów do akwariów rafowych.
- Moje narzędzia ReefTank
Integracje i karty Home Assistant
Od Home Assistant 2026.11 HACS jest częścią Home Assistant pod nazwą Marketplace (Ustawienia > Marketplace). W starszym Home Assistant te same kroki działają w HACS.
Integracje
🐠 ha-reefbeat-component
Lokalna integracja dla ekosystemu Red Sea ReefBeat.
Zarządzaj urządzeniami Red Sea ReefBeat lokalnie (bez chmury): ReefATO+, ReefControl, ReefControl-Power, ReefDose, ReefLed, ReefMat, ReefRun i ReefWave.
⚠️ To nie jest oficjalne repozytorium Red Sea. Używasz na własne ryzyko.
Główne funkcje:
- 100% lokalna kontrola — brak zależności od chmury dla większości urządzeń
- Automatyczne wykrywanie urządzeń w sieci lokalnej (z trybem ręcznym i obsługą podsieci)
- Niestandardowe ikony dla wszystkich urządzeń ReefBeat
- Powiadomienia o aktualizacji firmware (z opcjonalnym Cloud API)
- Tryb aktualizacji konfiguracji w czasie rzeczywistym
- Regulacja dozowania dla ReefDose: dozowanie wspomagane na podstawie wyników testów, solanka regulowana według zasolenia
- Tryb Poseidon (eksperymentalny): lokalny przekaźnik, który zastępuje większość odpytywania tym, co wysyłają urządzenia, z historią dawek i alarmami urządzeń jako zdarzeniami Home Assistant
- Obsługa wielu języków
Obsługiwane urządzenia:
✅ Wspierane 🚧 W trakcie 🧪 Nieprzetestowane (może działać) ❌ Jeszcze niewspierane
| Urządzenie | Modele | 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 | ✅ |
Specyfika ReefWave: ReefWave to jedyne urządzenie powiązane z chmurą ReefBeat. Dostępne są trzy tryby pracy — Cloud, Lokalny i Hybrydowy — abyś mógł wybrać równowagę między pełną kontrolą lokalną a synchronizacją z aplikacją mobilną ReefBeat.
Instalacja: Dostępne bezpośrednio w Marketplace — szukaj “redsea” lub “reefbeat”.
🌊 ha-aquamedic-component
Sterowanie pompami Aqua Medic przez Home Assistant za pomocą API chmury Gizwits.
Steruj pompami Aqua Medic z Home Assistant za pomocą API chmury Gizwits (ten sam backend co oficjalna aplikacja Aqua Medic).
Obsługiwane urządzenia:
✅ Wspierane 🚧 W trakcie 🧪 Nieprzetestowane (może działać) ❌ Jeszcze niewspierane
| Urządzenie | Status |
|---|---|
| EcoDrift / SmartDrift x.1 / x.3 (cyrkulacyjna) | ✅ |
| DC Runner x.1 / x.2 / x.3 (pompa obiegowa) | ✅ |
| DC Runner (pompa odpieniacza) | ✅ |
Funkcje EcoDrift / SmartDrift:
- Włączanie/wyłączanie, typ fali (Puls/Przypływ), tryb karmienia, timer, tryb sterowania 0-10V
- Tryby fal: Klasyczna, Sinusoidalna, Losowa, Stały przepływ
- Powiązanie: Niezależne, Master, Slave
- Sterowanie przepływem, częstotliwością i czasem karmienia
- Program przedziałów czasowych, do 48 przedziałów
- Kompletne czujniki diagnostyczne (nadprąd, przepięcie, przegrzanie, zablokowany wirnik, praca na sucho, UART)
Funkcje DC Runner:
- Włączanie/wyłączanie, tryb karmienia (pauza 1–60 min), tryb sterowania 0-10V
- Sterowanie przepływem (30–100%)
- Program przedziałów czasowych, do 48 przedziałów
- Diagnostyczne czujniki usterek (praca na sucho, zablokowany wirnik, napięcie, przetężenie, przegrzanie, UART)
Instalacja: Wyszukaj „Aqua Medic” w Ustawienia > Marketplace.
🐟 ha-vson-component
Automatyczne karmniki VSON w Home Assistant przez chmurowe API VSON. Karmnik WP8621 może też działać w pełni lokalnie po przeflashowaniu go na ESPHome — ta sama płytka, bez chmury.
Obsługiwane urządzenia:
✅ Wspierane 🚧 W trakcie 🧪 Nieprzetestowane (może działać) ❌ Jeszcze niewspierane
| Urządzenie | Modele | Status |
|---|---|---|
| WP8621 automatic fish feeder | variants N/E/H/F/B/P/A/C | ✅ |
| Any other VSON device | detected | 🧪 |
🐙 ha-reef-maintenance-component
Śledzenie konserwacji sprzętu, do którego Home Assistant nie ma dostępu.
Pompy cyrkulacyjne, pompy obiegowe, odpieniacze, reaktory — wszystko, co czyścisz ręcznie. Jeden wpis na markę, jedno urządzenie na sprzęt, cztery encje na zadanie: przycisk rejestrujący wykonanie, liczba dla interwału, przełącznik wyciszający powiadomienia i data do wstecznego wpisania ostatniej obsługi.
Główne funkcje:
- Ustawienia wstępne dla Tunze, Jebao i sprzętu generycznego, z interwałami producenta tam, gdzie są publikowane
- Wspólna biblioteka 22 zadań, przetłumaczona na 8 języków
- Wsteczne datowanie, aby nowy sprzęt nie zaczynał od „nigdy nie wykonano”
- Usługa
reef_maintenance.reset— przyklej tag NFC na pompie i zeskanuj go po zakończeniu - Ten sam kontrakt
reef_roleco integracje podłączone: zadania trafiają do widoku konserwacji karty
Instalacja: Wyszukaj “reef-maintenance” w Ustawienia > Marketplace.
🐟 ha-reeftank-component
Żywy obraz Twojego akwarium na pulpicie.

Integracja stojąca za kartą akwarium z ha-reef-card: Twoje zdjęcie, woda oświetlona prawdziwymi lampami, animowane ryby i koralowce oraz Twoje urządzenia i encje. Przechowuje akwaria, ich zdjęcia i obsadę oraz rejestruje karmienia.
Główne funkcje:
- Obrysuj wodę, piasek i skały na własnym zdjęciu — lub narysuj zbiornik z teksturami skał i piasku
- Ryby w ławicy, w otwartej wodzie, na piasku lub wyglądające z norki, nocą chowające się za skałami
- Woda zabarwiona przez Twoje lampy (ReefLED lub dowolne światło), koralowce falujące z pompami
- Karmienia z karmników, skrótów lub usługi; liczba ryb i koralowców jako sensory; pH i ORP porównywane z własną historią akwarium
- Gatunki z reeftank-catalog, aktualizowane automatycznie
Instalacja: Wyszukaj “ReefTank” w Ustawienia > Marketplace i zainstaluj ha-reef-card dla karty.
Karty
🪸 ha-reef-card
Niestandardowa karta Lovelace dla paneli rafowych.
Reef Card dla Home Assistant pomaga zarządzać akwarium rafowym bezpośrednio z panelu. W połączeniu z ha-reefbeat-component automatycznie wykrywa i obsługuje urządzenia Red Sea (ReefBeat).
Urządzenia innych producentów mogą być również obsługiwane — zgłoś zapotrzebowanie tutaj.
Obsługiwane urządzenia:
✅ Wspierane 🚧 W trakcie 🧪 Nieprzetestowane (może działać) ❌ Jeszcze niewspierane
| Urządzenie | Status | Najważniejsze |
|---|---|---|
| ReefDose (RSDOSE2/4) | ✅ | Pełne harmonogramowanie, dozowanie ręczne, zalewanie i kalibracja, zarządzanie suplementami, śledzenie zużycia, regulacja dozowania (wspomagana, solanka), historia dawek |
| ReefMat (RSMAT250/500/1200) | ✅ | Animowany stan rolki, przesuw ręczny/automatyczny/zaplanowany, stan czujnika, wykresy tygodniowe i miesięczne |
| ReefRun (RSRUN) | ✅ | Sterowanie prędkością pompy, edytor harmonogramów, zarządzanie nadmiernym odpienianiem |
| ReefATO+ | ✅ | Poziom wody, sonda wycieku, diagnostyka pompy, wykres zużycia, buzzer wycieku |
| ReefControl (RSCONTROLPRO) | ✅ | Sondy z paskami poziomu, trendami i historią 7 dni, prowadzona kalibracja pH/EC/ORP/temperatury, porty 12V, ATO, buzzer, sparowana listwa zasilająca |
| ReefControl (RSCONTROLLITE) | 🧪 | Sondy z paskami poziomu, trendami i historią 7 dni, prowadzona kalibracja pH/EC/ORP/temperatury, porty 12V, ATO, buzzer, sparowana listwa zasilająca |
| ReefControl-Power (RSPOWER6) | ✅ | Sterowanie per gniazdo, tryby wł./wył./harmonogram/sonda, powiązane urządzenia, lokalna sonda temperatury lub połączenie z ReefControl |
| ReefControl-Power (RSPOWER8) | 🧪 | Sterowanie per gniazdo, tryby wł./wył./harmonogram/sonda, powiązane urządzenia, lokalna sonda temperatury lub połączenie z ReefControl |
| ReefLed (G1) | ✅ | Niebo ze słońcem i księżycem, wiązka z programem dnia, suwaki intensywność/kolor lub biały/niebieski, edytor programów (kelwiny lub biały/niebieski, chmury), tryb pogodowy, grupy z przesuniętym wschodem, aklimatyzacja |
| ReefLed (G2) | 🧪 | Niebo ze słońcem i księżycem, wiązka z programem dnia, suwaki intensywność/kolor lub biały/niebieski, edytor programów (kelwiny lub biały/niebieski, chmury), tryb pogodowy, grupy z przesuniętym wschodem, aklimatyzacja |
| ReefWave (RSWAVE25/45) | ✅ | Animowany widok pompy, prędkość i kierunek, biblioteka fal, edytor harmonogramu w przedziałach czasu, grupy pomp |
| Aqua Medic EcoDrift / SmartDrift | ✅ | Prędkość pompy na obrazie, usterki, pauza karmienia, edytor programu w przedziałach czasu |
| Aqua Medic DC Runner (return, skimmer) | ✅ | Widok pompy powrotnej lub odpieniacza zgodnie z rolą w integracji, prędkość, usterki, edytor programu w przedziałach czasu |
| Energy Backup (reefbeatEnergyBackup) | ✅ | Przepływy energii sieci, baterii i pomp, rysowane przez Power Flow Card Plus |
| VSON fish feeder (hacked, ESPHome) | ✅ | Żywy obraz karmnika, sloty karmienia, ostrzeżenie o zapasie, nakarm teraz |
| Aquarium view (ha-reeftank-component) | ✅ | Zdjęcie akwarium z urządzeniami i encjami na żywo, woda zabarwiona przez Twoje lampy, animowane ryby i koralowce, edytor sceny z siedmioma zakładkami |
Najważniejsze ReefDose:
- Karta 6-strefowa: config/WiFi, stany, ręczne dozowanie ze skrótami, planowanie na głowicę z kołowym postępem, zarządzanie suplementami z obrazami marek, kolejka nadchodzących dawek
- Obsługa procesów zalewania i kalibracji
- Okna regulacji dozowania: dozowanie wspomagane, solanka z wykresem zasolenia
- Biblioteka suplementów z obrazami dla Red Sea, Tropic Marin, Quantum, ATI, Aqua Forest i innych
Najważniejsze ReefMat:
- Karta 7-strefowa z animowanym tłem zmieniającym się w zależności od zużycia rolki (0%–100%)
- Informacje o rolce w czasie rzeczywistym: pozostała długość, średnia dzienna, szacowane pozostałe dni
- Sterowanie posuwem ręcznym, automatycznym i zaplanowanym
- Wyświetlanie stanu czujnika poziomu (podłączony, odłączony, zabrudzony)
- Wykresy zużycia tygodniowego i miesięcznego
Widok akwarium: druga karta, custom:reef-aquarium-card, pokazuje żywy obraz Twojego akwarium. Wymaga ha-reeftank-component.
Instalacja: Dostępne bezpośrednio w Marketplace — szukaj “reef-card”.
Konfiguracja: Bez parametru device karta automatycznie wykrywa wszystkie urządzenia ReefBeat i pozwala wybrać. Ustaw parametr device, aby wymusić konkretne urządzenie.
![]() Demo ReefDose |
![]() Demo ReefMat |
![]() Demo ReefRun |
![]() Demo Konserwacja |
![]() Demo ReefATO+ |
![]() Demo ReefControl & ReefControl-Power |
![]() Demo ReefLed |
![]() Demo ReefWave |
![]() Demo Aqua Medic |
![]() Demo widoku akwarium |
🔌 Infrastruktura
⚡ reefbeatEnergyBackup
Autonomiczny system zasilania bateryjnego dla akwariów rafowych Red Sea.
Utrzymuj ReefWave, ReefRun i DC Skimmer w ruchu podczas przerw w zasilaniu dzięki baterii LiFePO₄ 24V, Raspberry Pi i inteligentnej redukcji pomp.

Główne funkcje:
- Monitorowanie baterii przez INA226 (I2C) + opcjonalna ładowarka Victron BLE
- Natychmiastowe wykrywanie przerw w zasilaniu przez przekaźnik 230V na GPIO
- Progresywna redukcja pomp — poziomy SoC obliczone z docelowej autonomii
- 3-poziomowy failover sieci — Ethernet → Wi-Fi → autonomiczny hotspot lustrzany
- Failover 4G/LTE — powiadomienia i dostęp do chmury ReefBeat przez modem USB lub tethering
- Powiadomienia push przez ntfy.sh (darmowe, bez konta)
- Integracja Home Assistant — MQTT auto-discovery, encja aktualizacji, blueprint testu baterii
- Watchdog trybu Poseidon — nadzoruje przekaźnik MQTT ha-reefbeat-component i przełącza urządzenia do trybu normalnego, gdy ten przestaje działać
- Auto-aktualizacja — sprawdza GitHub, przycisk “Zainstaluj” w HA
Poziomy sprzętowe:
| Poziom | Co otrzymujesz | Budżet |
|---|---|---|
| 1 — Podstawowy | Bateria + kable, pasywny backup | ~290 € |
| 2 — Normalny (zalecany) | + RPi + INA226 + przekaźnik, monitoring & automatyzacja | ~402 € |
| 3 — Zaawansowany | + Ładowarka Victron BLE, inteligentny wyłącznik, modem 4G | ~664 € |
Instalacja:
curl -sL https://raw.githubusercontent.com/Elwinmage/reefbeatEnergyBackup/main/install.sh | sudo bash
Działa samodzielnie lub jako uzupełnienie ha-reefbeat-component dla w pełni zintegrowanego zarządzania akwarium.
🐬 ha-reef-blueprints
Blueprinty automatyzacji dla całego ekosystemu.
Powiadamia na telefonie o zaległych konserwacjach, znajdowanych przez wspólny atrybut reef_role, dzięki czemu obejmuje wszystkie integracje, oraz o urządzeniach, które przestały odpowiadać. Testuje grzałki pojedynczo i ostrzega, gdy przekaźnik jest wyłączony, a urządzenie nadal pobiera prąd. Osiem języków, jeden przycisk importu na język.
Instalacja: import z repozytorium, jeden przycisk na język.
📐 Modele 3D
ReefRun DC Skimmer
📦 Narzędzie do wirnika odpieniacza DC Red Sea
Demonstracja wideo:
📦 Podwyższenia nóżek odpieniacza DC Red Sea
Podwyższenia nóżek odpieniacza DC Red Sea, do ustawienia jego wysokości w sumpie. Cztery wersje: 80, 70, 60 i 50 mm.
Testy wody
📦 Organizer na testy Red Sea do akwarium rafowego
System przechowywania zestawów testów wody rafowej Red Sea.
💬 Kontakt i wsparcie
- Pytania i propozycje funkcji: otwórz dyskusję w odpowiednim projekcie — ha-reefbeat-component · ha-aquamedic-component · ha-reef-card · ha-reef-maintenance-component · ha-reeftank-component · reeftank-catalog · reefbeatEnergyBackup · ha-reef-blueprints
- Zgłoszenia błędów: otwórz issue w tym samym projekcie, ze szczegółami.
- Wesprzyj projekt:









