Mis herramientas ReefTank
Bienvenido a la documentación de mis proyectos para acuarios de arrecife.
- Mis herramientas ReefTank
Integraciones y tarjetas Home Assistant
Integraciones
🐠 ha-reefbeat-component
Integración local para el ecosistema Red Sea ReefBeat.
Gestiona tus dispositivos Red Sea ReefBeat localmente (sin cloud): ReefATO+, ReefControl, ReefControl-Power, ReefDose, ReefLed, ReefMat, ReefRun y ReefWave.
⚠️ Este no es un repositorio oficial de Red Sea. Uso bajo tu propia responsabilidad.
Funciones principales:
- Control 100% local — sin dependencia del cloud para la mayoría de dispositivos
- Detección automática de dispositivos en la red local (con modo manual y soporte de subredes)
- Iconos personalizados para todos los dispositivos ReefBeat
- Notificaciones de actualización de firmware (con Cloud API opcional)
- Modo de actualización en tiempo real de la configuración
- Soporte multilingüe
Dispositivos soportados:
✅ Soportado 🚧 En curso 🧪 Sin probar (puede funcionar) ❌ Aún no soportado
| Dispositivo | Modelos | Estado |
|---|---|---|
| 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 | ✅ |
Particularidades de ReefWave: ReefWave es el único dispositivo vinculado al cloud de ReefBeat. Tres modos de operación están disponibles — Cloud, Local e Híbrido — para que elijas el equilibrio entre control local total y sincronización con la app móvil ReefBeat.
Instalación: Disponible directamente en HACS — busca “redsea” o “reefbeat”.
🌊 ha-aquamedic-component
Control de bombas Aqua Medic vía Home Assistant mediante la API cloud Gizwits.
Controla tus bombas Aqua Medic desde Home Assistant vía la API cloud Gizwits (mismo backend que la app oficial de Aqua Medic).
Dispositivos soportados:
✅ Soportado 🚧 En curso 🧪 Sin probar (puede funcionar) ❌ Aún no soportado
| Dispositivo | Estado |
|---|---|
| EcoDrift / SmartDrift x.1 / x.3 (de movimiento) | ✅ |
| DC Runner x.1 / x.2 / x.3 (bomba de retorno) | ✅ |
| DC Runner (bomba de skimmer) | ✅ |
| Reefdoser EVO (bomba dosificadora) | ❌ — Solicitarlo |
| T-Controller Twin (controlador de temperatura) | ❌ — Solicitarlo |
| Aquarius / Spectrus (iluminación) | ❌ — Solicitarlo |
Funciones EcoDrift / SmartDrift:
- Encendido/apagado, tipo de onda (Pulso/Marea), modo alimentación, temporizador, modo control 0-10V
- Modos de onda: Clásico, Sinusoidal, Aleatorio, Flujo constante
- Enlace: Independiente, Maestro, Esclavo
- Control de caudal, frecuencia y duración de alimentación
- Sensores de diagnóstico completos (sobrecorriente, sobretensión, sobretemperatura, rotor bloqueado, marcha en seco, UART)
Funciones DC Runner:
- Encendido/apagado, modo alimentación (pausa 10 min), modo control 0-10V
- Control de caudal (30–100%)
- Sensores de diagnóstico (marcha en seco, rotor bloqueado, tensión)
Instalación: En HACS, añade https://github.com/Elwinmage/ha-aquamedic-component como repositorio personalizado (Integración), luego busca “Aqua Medic”.
🐙 ha-reef-maintenance-component
Seguimiento de mantenimiento para equipos que Home Assistant no alcanza.
Bombas de movimiento, bombas de retorno, skimmers, reactores — todo lo que limpia a mano. Una entrada por marca, un dispositivo por equipo, cuatro entidades por tarea: un botón que registra el trabajo, un número para el intervalo, un interruptor para silenciar los avisos y una fecha para retrodatar la última intervención.
Funciones principales:
- Preajustes para Tunze, Jebao y equipos genéricos, con los intervalos del fabricante cuando los publica
- Una biblioteca común de 17 tareas, traducida a 8 idiomas
- Retrodatación, para que un equipo nuevo no empiece en «nunca hecho»
- Servicio
reef_maintenance.reset— pegue una etiqueta NFC en la bomba y escanéela al terminar - Mismo contrato
reef_roleque las integraciones conectadas: las tareas aparecen en la vista de mantenimiento de la tarjeta
Instalación: En HACS, añada https://github.com/Elwinmage/ha-reef-maintenance-component como repositorio personalizado (Integración).
Tarjetas
🪸 ha-reef-card
Tarjeta Lovelace personalizada para paneles de arrecife.
La Reef Card para Home Assistant te ayuda a gestionar tu acuario de arrecife directamente desde tu panel. Combinada con ha-reefbeat-component, detecta y soporta automáticamente tus dispositivos Red Sea (ReefBeat).
Los dispositivos no-Redsea también pueden ser soportados — solicítalo aquí.
Dispositivos soportados:
✅ Soportado 🚧 En curso 🧪 Sin probar (puede funcionar) ❌ Aún no soportado
| Dispositivo | Estado | Puntos fuertes |
|---|---|---|
| ReefDose (RSDOSE2/4) | ✅ | Planificación completa, dosificación manual, cebado y calibración, gestión de suplementos, seguimiento de uso |
| ReefMat (RSMAT250/500/1200) | ✅ | Estado del rollo animado, avance manual/automático/programado, estado del sensor, gráficos semanales y mensuales |
| ReefRun (RSRUN) | ✅ | Control de velocidad de bomba, editor de programas, gestión del sobreespumado |
| ReefATO+ | ✅ | Nivel de agua, sonda de fugas, diagnóstico de bomba, gráfico de consumo, zumbador de fuga |
| ReefControl (RSCONTROLPRO) | ✅ | Sondas con barras de nivel e historial de 24 h, calibración guiada pH/EC/ORP/temperatura, puertos 12V, ATO, zumbador, regleta emparejada |
| ReefControl (RSCONTROLLITE) | 🧪 | Sondas con barras de nivel e historial de 24 h, calibración guiada pH/EC/ORP/temperatura, puertos 12V, ATO, zumbador, regleta emparejada |
| ReefControl-Power (RSPOWER6) | ✅ | Control por toma, modos encendido/apagado/programa/sonda, dispositivos vinculados, sonda de temperatura local o enlace ReefControl |
| ReefControl-Power (RSPOWER8) | 🧪 | Control por toma, modos encendido/apagado/programa/sonda, dispositivos vinculados, sonda de temperatura local o enlace ReefControl |
| ReefLed (G1/G2) | 🚧 | Próximo paso de la hoja de ruta |
| ReefWave | ❌ | Votar por prioridad |
| Aqua Medic EcoDrift / SmartDrift | ❌ | Votar por prioridad |
| Aqua Medic DC Runner (return, skimmer) | ❌ | Votar por prioridad |
Destacados ReefDose:
- Tarjeta de 6 zonas: config/WiFi, estados, dosificación manual con atajos, planificación por cabezal con progreso circular, gestión de suplementos con imágenes de marcas, y cola de próximas dosis
- Soporte de flujos de cebado y calibración
- Biblioteca de suplementos con imágenes para Red Sea, Tropic Marin, Quantum, ATI, Aqua Forest y más
Destacados ReefMat:
- Tarjeta de 7 zonas con fondo animado que cambia según el uso del rollo (0%–100%)
- Info en tiempo real del rollo: longitud restante, media diaria, días restantes estimados
- Controles de avance manual, automático y programado
- Visualización del estado del sensor de nivel (conectado, desconectado, sucio)
- Gráficos de consumo semanal y mensal
Instalación: Disponible directamente en HACS — busca “reef-card”.
Configuración: Sin el parámetro device, la tarjeta detecta automáticamente todos los dispositivos ReefBeat y te permite elegir. Establece el parámetro device para forzar un dispositivo específico.
 Demo ReefDose |
 Demo ReefMat |
 Demo ReefRun |
 Demo Mantenimiento |
 Demo ReefATO+ |
 Demo ReefControl & ReefControl-Power |
🔌 Infraestructura
⚡ reefbeatEnergyBackup
Sistema autónomo de respaldo con batería para acuarios de arrecife Red Sea.
Mantén tus ReefWave, ReefRun y DC Skimmer funcionando durante cortes de luz con una batería LiFePO₄ 24V, una Raspberry Pi y degradación inteligente de bombas.
Funciones principales:
- Monitoreo de batería vía INA226 (I2C) + cargador Victron BLE opcional
- Detección instantánea de cortes mediante relé 230V en GPIO
- Degradación progresiva de bombas — niveles SoC calculados desde una autonomía objetivo
- Failover de red 3 niveles — Ethernet → Wi-Fi → hotspot espejo autónomo
- Failover 4G/LTE — notificaciones y acceso cloud ReefBeat vía módem USB o tethering
- Notificaciones push vía ntfy.sh (gratis, sin cuenta)
- Integración Home Assistant — auto-discovery MQTT, entidad de actualización, blueprint de test
- Auto-actualización — verifica GitHub, botón “Instalar” en HA
Niveles de hardware:
| Nivel | Lo que obtienes | Presupuesto |
|---|---|---|
| 1 — Básico | Batería + cables, respaldo pasivo | ~290 € |
| 2 — Normal (recomendado) | + RPi + INA226 + relé, monitoreo & automatización | ~402 € |
| 3 — Avanzado | + Cargador Victron BLE, disyuntor conectado, módem 4G | ~627 € |
Instalación:
curl -sL https://raw.githubusercontent.com/Elwinmage/reefbeatEnergyBackup/main/install.sh | sudo bash
Funciona independientemente o como complemento de ha-reefbeat-component para una gestión de arrecife completamente integrada.
🐬 ha-reef-blueprints
Blueprints de notificación para todo el ecosistema.
Le avisa en el móvil de los mantenimientos vencidos, encontrados por el atributo común reef_role de modo que todas las integraciones quedan cubiertas, y de los dispositivos que dejaron de responder. Ocho idiomas, un botón de importación cada uno.
Instalación: importe desde el repositorio, un botón por idioma.
📐 Modelos 3D
ReefRun DC Skimmer
📦 Herramienta para impulsor de skimmer DC Red Sea
Demostración en video:
💬 Contacto y soporte
- Preguntas y peticiones de funciones: abra una discusión en el proyecto correspondiente — ha-reefbeat-component · ha-aquamedic-component · ha-reef-card · ha-reef-maintenance-component · reefbeatEnergyBackup
- Informes de errores: abra una issue en ese mismo proyecto, con los detalles.
- Apoyar el proyecto:
