Moje narzędzia ReefTank
Witamy w dokumentacji moich projektów do akwariów rafowych.
- Moje narzędzia ReefTank
Integracje i karty Home Assistant
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
- 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 HACS — 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) | ✅ |
| Reefdoser EVO (pompa dozująca) | ❌ — Poproś o to |
| T-Controller Twin (sterownik temperatury) | ❌ — Poproś o to |
| Aquarius / Spectrus (oświetlenie) | ❌ — Poproś o to |
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
- Kompletne czujniki diagnostyczne (nadprąd, przepięcie, przegrzanie, zablokowany wirnik, praca na sucho, UART)
Funkcje DC Runner:
- Włączanie/wyłączanie, tryb karmienia (pauza 10 min), tryb sterowania 0-10V
- Sterowanie przepływem (30–100%)
- Czujniki diagnostyczne (praca na sucho, zablokowany wirnik, napięcie)
Instalacja: W HACS dodaj https://github.com/Elwinmage/ha-aquamedic-component jako niestandardowe repozytorium (Integracja), następnie szukaj “Aqua Medic”.
🐙 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 17 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: W HACS dodaj https://github.com/Elwinmage/ha-reef-maintenance-component jako niestandardowe repozytorium (Integracja).
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 |
| 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 i historią 24 h, prowadzona kalibracja pH/EC/ORP/temperatury, porty 12V, ATO, buzzer, sparowana listwa zasilająca |
| ReefControl (RSCONTROLLITE) | 🧪 | Sondy z paskami poziomu i historią 24 h, 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/G2) | 🚧 | Następny krok w planie rozwoju |
| ReefWave | ❌ | Zagłosuj na priorytet |
| Aqua Medic EcoDrift / SmartDrift | ❌ | Zagłosuj na priorytet |
| Aqua Medic DC Runner (return, skimmer) | ❌ | Zagłosuj na priorytet |
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
- 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
Instalacja: Dostępne bezpośrednio w HACS — 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 |
🔌 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
- 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 | ~627 € |
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 powiadomień dla całego ekosystemu.
Powiadamia na telefonie o zaległych konserwacjach, znajdowanych przez wspólny atrybut reef_role, dzięki czemu objęte są wszystkie integracje, oraz o urządzeniach, które przestały odpowiadać. Osiem języków, po jednym przycisku importu.
Instalacja: import z repozytorium, jeden przycisk na język.
📐 Modele 3D
ReefRun DC Skimmer
📦 Narzędzie do wirnika odpieniacza DC Red Sea
Demonstracja wideo:
💬 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 · reefbeatEnergyBackup
- Zgłoszenia błędów: otwórz issue w tym samym projekcie, ze szczegółami.
- Wesprzyj projekt:
