I miei strumenti ReefTank
Benvenuto nella documentazione dei miei progetti per acquari di barriera.
- I miei strumenti ReefTank
Integrazioni e schede Home Assistant
Da Home Assistant 2026.11, HACS fa parte di Home Assistant con il nome di Marketplace (Impostazioni > Marketplace). Su un Home Assistant più vecchio, gli stessi passaggi funzionano in HACS.
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
- Regolazione del dosaggio per la ReefDose: dosaggio assistito dai risultati dei test, salamoia regolata sulla salinità
- Modalità Poseidon (sperimentale): un relè locale che sostituisce gran parte delle interrogazioni con ciò che i dispositivi inviano, con la cronologia delle dosi e gli allarmi dei dispositivi come eventi Home Assistant
- 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 nel Marketplace — 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) | ✅ |
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
- Programma a fasce orarie, fino a 48 fasce
- Sensori diagnostici completi (sovracorrente, sovratensione, surriscaldamento, rotore bloccato, marcia a secco, UART)
Funzionalità DC Runner:
- Accensione/spegnimento, modalità alimentazione (pausa 1–60 min), modalità controllo 0-10V
- Controllo portata (30–100%)
- Programma a fasce orarie, fino a 48 fasce
- Sensori di guasto diagnostici (marcia a secco, rotore bloccato, tensione, sovracorrente, sovratemperatura, UART)
Installazione: Cerca «Aqua Medic» in Impostazioni > Marketplace.
🐟 ha-vson-component
Alimentatori automatici VSON in Home Assistant tramite l’API cloud VSON. L’alimentatore WP8621 può anche funzionare totalmente in locale riflashandolo con ESPHome — stessa scheda, senza cloud.
Dispositivi supportati:
✅ Supportato 🚧 In corso 🧪 Non testato (potrebbe funzionare) ❌ Non ancora supportato
| Dispositivo | Modelli | Stato |
|---|---|---|
| WP8621 automatic fish feeder | variants N/E/H/F/B/P/A/C | ✅ |
| Any other VSON device | detected | 🧪 |
🐙 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 22 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: Cercate “reef-maintenance” in Impostazioni > Marketplace.
🐟 ha-reeftank-component
Un’immagine viva del vostro acquario sulla plancia.

L’integrazione dietro la scheda acquario di ha-reef-card: la vostra foto, l’acqua illuminata dalle vostre vere lampade, pesci e coralli animati, e sopra i vostri dispositivi ed entità. Conserva gli acquari, le loro immagini e la loro fauna, e registra le alimentazioni.
Funzioni principali:
- Contornate l’acqua, la sabbia e le rocce sulla vostra foto — o disegnate la vasca con texture di roccia e sabbia
- Pesci in banco, in acque libere, sulla sabbia o che spuntano dalla tana, e di notte si nascondono dietro le rocce
- Acqua tinta dalle vostre lampade (ReefLED o qualsiasi luce), coralli che ondeggiano con le pompe
- Alimentazioni registrate da alimentatori, scorciatoie o un servizio; numero di pesci e coralli come sensori; pH e ORP sorvegliati rispetto alla cronologia della vasca
- Specie dal reeftank-catalog, aggiornate automaticamente
Installazione: Cercate “ReefTank” in Impostazioni > Marketplace, e installate ha-reef-card per la scheda.
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, regolazione del dosaggio (assistito, salamoia), cronologia delle dosi |
| 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, tendenze e storico 7 giorni, calibrazione guidata pH/EC/ORP/temperatura, porte 12V, ATO, buzzer, multipresa associata |
| ReefControl (RSCONTROLLITE) | 🧪 | Sonde con barre di livello, tendenze e storico 7 giorni, 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) | ✅ | Cielo con sole e luna, fascio con il programma del giorno, cursori intensità/colore o bianco/blu, editor dei programmi (kelvin o bianco/blu, nuvole), modalità meteo, gruppi con alba sfalsata, acclimatazione |
| ReefLed (G2) | 🧪 | Cielo con sole e luna, fascio con il programma del giorno, cursori intensità/colore o bianco/blu, editor dei programmi (kelvin o bianco/blu, nuvole), modalità meteo, gruppi con alba sfalsata, acclimatazione |
| ReefWave (RSWAVE25/45) | ✅ | Vista animata della pompa, velocità e direzione, libreria delle onde, editor del programma a fasce orarie, gruppi di pompe |
| Aqua Medic EcoDrift / SmartDrift | ✅ | Velocità della pompa sull’immagine, guasti, pausa alimentazione, editor del programma a fasce orarie |
| Aqua Medic DC Runner (return, skimmer) | ✅ | Vista pompa di risalita o dello schiumatoio secondo il ruolo nell’integrazione, velocità, guasti, editor del programma a fasce orarie |
| Energy Backup (reefbeatEnergyBackup) | ✅ | Flussi di energia di rete, batteria e pompe, disegnati con Power Flow Card Plus |
| VSON fish feeder (hacked, ESPHome) | ✅ | Immagine viva della mangiatoia, fasce di alimentazione, avviso riserva, alimenta ora |
| Aquarium view (ha-reeftank-component) | ✅ | La foto della tua vasca con dispositivi ed entità in tempo reale, acqua tinta dalle tue lampade, pesci e coralli animati, editor di scena a sette schede |
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
- Finestre di regolazione del dosaggio: dosaggio assistito, salamoia con il suo grafico di salinità
- 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
Vista acquario: una seconda card, custom:reef-aquarium-card, mostra un’immagine viva della tua vasca. Richiede ha-reeftank-component.
Installazione: Disponibile direttamente nel Marketplace — 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 |
![]() Demo ReefLed |
![]() Demo ReefWave |
![]() Demo Aqua Medic |
![]() Demo vista acquario |
🔌 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
- Watchdog della modalità Poseidon — sorveglia il relè MQTT di ha-reefbeat-component e riporta i dispositivi in modalità normale quando cade
- 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 | ~664 € |
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 automazione per tutto l’ecosistema.
Vi avvisa sul telefono delle manutenzioni scadute, trovate tramite l’attributo comune reef_role per coprire tutte le integrazioni, e dei dispositivi diventati irraggiungibili. Prova i riscaldatori uno alla volta e vi avvisa quando un relè è spento ma il suo apparecchio consuma ancora. Otto lingue, un pulsante di importazione per lingua.
Installazione: importate dal repository, un pulsante per lingua.
📐 Modelli 3D
ReefRun DC Skimmer
📦 Strumento per girante skimmer DC Red Sea
Dimostrazione video:
📦 Rialzi per i piedini dello skimmer DC Red Sea
Rialzi per i piedini dello schiumatoio DC Red Sea, per regolarne l’altezza nella sump. Quattro versioni: 80, 70, 60 e 50 mm.
Test dell’acqua
📦 Organizer per test di acquario marino Red Sea
Un sistema di contenimento per i kit di test dell’acqua marina Red Sea.
💬 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 · ha-reeftank-component · reeftank-catalog · reefbeatEnergyBackup · ha-reef-blueprints
- Segnalazione bug: aprite una issue sullo stesso progetto, con i dettagli.
- Sostieni il progetto:









