Moje narzędzia ReefTank
Witamy w dokumentacji moich projektów do akwariów rafowych.
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+, 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:
| Urządzenie | Modele | Status |
|---|---|---|
| ReefATO+ | RSATO+ | ✅ Przetestowane |
| ReefDose | RSDOSE2, RSDOSE4 | ✅ Przetestowane |
| ReefLed | G1 (RSLED50/90/160), G2 (RSLED60/115/170) | ✅ Przetestowane |
| ReefMat | RSMAT250, RSMAT500, RSMAT1200 | ✅ Przetestowane |
| ReefRun | RSRUN | ✅ Przetestowane |
| ReefWave | RSWAVE25, RSWAVE45 | ✅ / ☑️ |
| ReefControl | RSSENSE | ❌ Jeszcze nie — skontaktuj się |
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”.
⚡ 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-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:
| Urządzenie | Status |
|---|---|
| EcoDrift / SmartDrift x.1 / x.3 (falownik) | ✅ Obsługiwane |
| DC Runner x.1 / x.2 / x.3 (pompa zwrotna) | 🧪 Nieprzetestowane |
| Reefdoser EVO (pompa dozująca) | ❌ Jeszcze nie — skontaktuj się |
| T-Controller Twin (sterownik temperatury) | ❌ Jeszcze nie — skontaktuj się |
| Aquarius / Spectrus (oświetlenie) | ❌ Jeszcze nie — skontaktuj się |
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”.
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:
| Urządzenie | Status | Najważniejsze |
|---|---|---|
| ReefDose (RSDOSE2/4) | ✅ Wdrożone | Pełne planowanie, ręczne dozowanie, zalewanie/kalibracja, zarządzanie suplementami, śledzenie zużycia |
| ReefMat (RSMAT250/500/1200) | ✅ Wdrożone | Animowany stan rolki, posuw ręczny/auto/zaplanowany, stan czujnika, wykresy tygodniowe/miesięczne |
| ReefRun (RSRUN) | ☑️ W trakcie | Sterowanie prędkością pompy, zarządzanie nadmiernym pienieniem |
| ReefATO+ | ❌ Planowane | Głosuj na priorytet |
| ReefLed (G1/G2) | ❌ Planowane | Głosuj na priorytet |
| ReefWave | ❌ Planowane | Gł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 |
📐 Modele 3D
ReefRun DC Skimmer
📦 Narzędzie do wirnika odpieniacza DC Red Sea
💬 Kontakt i wsparcie
- Pytania i prośby o funkcje: Użyj zakładki Discussions każdego projektu
- Zgłaszanie błędów: Otwórz Issue ze szczegółami
- Wesprzyj projekt:
