I miei strumenti ReefTank
Benvenuto nella documentazione dei miei progetti per acquari di barriera.
- I miei strumenti ReefTank
Integrazioni e schede Home Assistant
Integrazioni
🐠 ha-reefbeat-component
Integrazione locale per l’ecosistema Red Sea ReefBeat.
Gestisci i tuoi dispositivi Red Sea ReefBeat localmente (senza cloud): ReefATO+, ReefControl, ReefControl-Power, ReefDose, ReefLed, ReefMat, ReefRun e ReefWave.
⚠️ Questo non è un repository ufficiale Red Sea. Uso a proprio rischio.
Funzionalità principali:
- Controllo 100% locale — nessuna dipendenza dal cloud per la maggior parte dei dispositivi
- Rilevamento automatico dei dispositivi sulla rete locale (con modalità manuale e supporto sottoreti)
- Icone personalizzate per tutti i dispositivi ReefBeat
- Notifiche di aggiornamento firmware (con Cloud API opzionale)
- Modalità di aggiornamento configurazione in tempo reale
- Supporto multilingue
Dispositivi supportati:
✅ Supportato 🚧 In corso 🧪 Non testato (potrebbe funzionare) ❌ Non ancora supportato
| Dispositivo | Modelli | Stato |
|---|---|---|
| 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 | ✅ |
Specificità ReefWave: ReefWave è l’unico dispositivo legato al cloud ReefBeat. Tre modalità operative sono disponibili — Cloud, Locale e Ibrida — per scegliere l’equilibrio tra controllo locale completo e sincronizzazione con l’app mobile ReefBeat.
Installazione: Disponibile direttamente in HACS — cerca “redsea” o “reefbeat”.
🌊 ha-aquamedic-component
Controllo delle pompe Aqua Medic tramite Home Assistant via API cloud Gizwits.
Controlla le tue pompe Aqua Medic da Home Assistant tramite l’API cloud Gizwits (stesso backend dell’app ufficiale Aqua Medic).
Dispositivi supportati:
✅ Supportato 🚧 In corso 🧪 Non testato (potrebbe funzionare) ❌ Non ancora supportato
| Dispositivo | Stato |
|---|---|
| EcoDrift / SmartDrift x.1 / x.3 (di movimento) | ✅ |
| DC Runner x.1 / x.2 / x.3 (pompa di risalita) | ✅ |
| DC Runner (pompa dello schiumatoio) | ✅ |
| Reefdoser EVO (pompa dosatrice) | ❌ — Richiedilo |
| T-Controller Twin (controllore di temperatura) | ❌ — Richiedilo |
| Aquarius / Spectrus (illuminazione) | ❌ — Richiedilo |
Funzionalità EcoDrift / SmartDrift:
- Accensione/spegnimento, tipo d’onda (Impulso/Marea), modalità alimentazione, timer, modalità controllo 0-10V
- Modalità onda: Classica, Sinusoidale, Casuale, Flusso costante
- Collegamento: Indipendente, Master, Slave
- Controllo portata, frequenza e durata alimentazione
- Sensori diagnostici completi (sovracorrente, sovratensione, surriscaldamento, rotore bloccato, marcia a secco, UART)
Funzionalità DC Runner:
- Accensione/spegnimento, modalità alimentazione (pausa 10 min), modalità controllo 0-10V
- Controllo portata (30–100%)
- Sensori diagnostici (marcia a secco, rotore bloccato, tensione)
Installazione: In HACS, aggiungi https://github.com/Elwinmage/ha-aquamedic-component come repository personalizzato (Integrazione), poi cerca “Aqua Medic”.
🐙 ha-reef-maintenance-component
Tracciamento della manutenzione per le apparecchiature che Home Assistant non raggiunge.
Pompe di movimento, pompe di risalita, schiumatoi, reattori — tutto ciò che pulite a mano. Una voce per marca, un dispositivo per apparecchiatura, quattro entità per attività: un pulsante che registra il lavoro, un numero per l’intervallo, un interruttore per silenziare gli avvisi e una data per retrodatare l’ultimo intervento.
Funzioni principali:
- Preset per Tunze, Jebao e apparecchiature generiche, con gli intervalli del produttore quando pubblicati
- Una libreria comune di 17 attività, tradotta in 8 lingue
- Retrodatazione, così una nuova apparecchiatura non parte da «mai fatto»
- Servizio
reef_maintenance.reset— attaccate un tag NFC sulla pompa e scansionatelo a lavoro finito - Stesso contratto
reef_roledelle integrazioni connesse: le attività compaiono nella vista manutenzione della scheda
Installazione: In HACS, aggiungete https://github.com/Elwinmage/ha-reef-maintenance-component come repository personalizzato (Integrazione).
Schede
🪸 ha-reef-card
Scheda Lovelace personalizzata per dashboard di barriera.
La Reef Card per Home Assistant ti aiuta a gestire il tuo acquario di barriera direttamente dalla dashboard. Combinata con ha-reefbeat-component, rileva e supporta automaticamente i tuoi dispositivi Red Sea (ReefBeat).
I dispositivi non-Redsea possono essere supportati — richiedilo qui.
Dispositivi supportati:
✅ Supportato 🚧 In corso 🧪 Non testato (potrebbe funzionare) ❌ Non ancora supportato
| Dispositivo | Stato | Punti di forza |
|---|---|---|
| ReefDose (RSDOSE2/4) | ✅ | Pianificazione completa, dosaggio manuale, adescamento e calibrazione, gestione dei supplementi, monitoraggio dei consumi |
| ReefMat (RSMAT250/500/1200) | ✅ | Stato del rotolo animato, avanzamento manuale/automatico/programmato, stato del sensore, grafici settimanali e mensili |
| ReefRun (RSRUN) | ✅ | Controllo della velocità della pompa, editor dei programmi, gestione della sovraschiumazione |
| ReefATO+ | ✅ | Livello dell’acqua, sonda perdite, diagnostica pompa, grafico dei consumi, buzzer perdite |
| ReefControl (RSCONTROLPRO) | ✅ | Sonde con barre di livello e storico 24 h, calibrazione guidata pH/EC/ORP/temperatura, porte 12V, ATO, buzzer, multipresa associata |
| ReefControl (RSCONTROLLITE) | 🧪 | Sonde con barre di livello e storico 24 h, calibrazione guidata pH/EC/ORP/temperatura, porte 12V, ATO, buzzer, multipresa associata |
| ReefControl-Power (RSPOWER6) | ✅ | Controllo per presa, modalità acceso/spento/programma/sonda, dispositivi collegati, sonda di temperatura locale o collegamento ReefControl |
| ReefControl-Power (RSPOWER8) | 🧪 | Controllo per presa, modalità acceso/spento/programma/sonda, dispositivi collegati, sonda di temperatura locale o collegamento ReefControl |
| ReefLed (G1/G2) | 🚧 | Prossimo passo della roadmap |
| ReefWave | ❌ | Vota per la priorità |
| Aqua Medic EcoDrift / SmartDrift | ❌ | Vota per la priorità |
| Aqua Medic DC Runner (return, skimmer) | ❌ | Vota per la priorità |
Punti di forza ReefDose:
- Scheda a 6 zone: config/WiFi, stati, dosaggio manuale con scorciatoie, pianificazione per testina con progresso circolare, gestione integratori con immagini di marca, e coda delle prossime dosi
- Supporto flussi di adescamento e calibrazione
- Libreria integratori con immagini per Red Sea, Tropic Marin, Quantum, ATI, Aqua Forest e altri
Punti di forza ReefMat:
- Scheda a 7 zone con sfondo animato che cambia in base all’utilizzo del rullo (0%–100%)
- Info in tempo reale del rullo: lunghezza residua, media giornaliera, giorni rimanenti stimati
- Controlli di avanzamento manuale, automatico e programmato
- Visualizzazione stato sensore di livello (connesso, disconnesso, sporco)
- Grafici di consumo settimanali e mensili
Installazione: Disponibile direttamente in HACS — cerca “reef-card”.
Configurazione: Senza il parametro device, la scheda rileva automaticamente tutti i dispositivi ReefBeat e ti permette di scegliere. Imposta il parametro device per forzare un dispositivo specifico.
 Demo ReefDose |
 Demo ReefMat |
 Demo ReefRun |
 Demo Manutenzione |
 Demo ReefATO+ |
 Demo ReefControl & ReefControl-Power |
🔌 Infrastruttura
⚡ reefbeatEnergyBackup
Sistema autonomo di backup a batteria per acquari di barriera Red Sea.
Mantieni ReefWave, ReefRun e DC Skimmer in funzione durante le interruzioni di corrente con una batteria LiFePO₄ 24V, un Raspberry Pi e una riduzione intelligente delle pompe.
Funzionalità principali:
- Monitoraggio batteria via INA226 (I2C) + caricabatterie Victron BLE opzionale
- Rilevamento istantaneo delle interruzioni tramite relè 230V su GPIO
- Riduzione progressiva delle pompe — livelli SoC calcolati da un’autonomia target
- Failover rete a 3 livelli — Ethernet → Wi-Fi → hotspot mirror autonomo
- Failover 4G/LTE — notifiche e accesso cloud ReefBeat via modem USB o tethering
- Notifiche push via ntfy.sh (gratuito, senza account)
- Integrazione Home Assistant — auto-discovery MQTT, entità aggiornamento, blueprint test batteria
- Auto-aggiornamento — controlla GitHub, pulsante “Installa” in HA
Livelli hardware:
| Livello | Cosa ottieni | Budget |
|---|---|---|
| 1 — Base | Batteria + cavi, backup passivo | ~290 € |
| 2 — Normale (consigliato) | + RPi + INA226 + relè, monitoraggio & automazione | ~402 € |
| 3 — Avanzato | + Caricabatterie Victron BLE, interruttore smart, modem 4G | ~627 € |
Installazione:
curl -sL https://raw.githubusercontent.com/Elwinmage/reefbeatEnergyBackup/main/install.sh | sudo bash
Funziona autonomamente o come complemento a ha-reefbeat-component per una gestione completa dell’acquario.
🐬 ha-reef-blueprints
Blueprint di notifica per tutto l’ecosistema.
Vi avvisa sul telefono delle manutenzioni scadute, trovate tramite l’attributo comune reef_role così che ogni integrazione sia coperta, e dei dispositivi diventati irraggiungibili. Otto lingue, un pulsante di importazione ciascuna.
Installazione: importate dal repository, un pulsante per lingua.
📐 Modelli 3D
ReefRun DC Skimmer
📦 Strumento per girante skimmer DC Red Sea
Dimostrazione video:
💬 Contatti e supporto
- Domande e richieste di funzionalità: aprite una discussione sul progetto interessato — ha-reefbeat-component · ha-aquamedic-component · ha-reef-card · ha-reef-maintenance-component · reefbeatEnergyBackup
- Segnalazione bug: aprite una issue sullo stesso progetto, con i dettagli.
- Sostieni il progetto:
