Mis herramientas ReefTank
Bienvenido a la documentación de mis proyectos para acuarios de arrecife.
- Mis herramientas ReefTank
Integraciones y tarjetas Home Assistant
Desde Home Assistant 2026.11, HACS forma parte de Home Assistant con el nombre de Marketplace (Ajustes > Marketplace). En un Home Assistant más antiguo, los mismos pasos funcionan en HACS.
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
- Regulación de dosificación para la ReefDose: dosificación asistida a partir de sus resultados de test, salmuera regulada según la salinidad
- Modo Poseidon (experimental): un relé local que sustituye la mayor parte de las consultas por lo que envían los dispositivos, con el historial de dosis y las alarmas de los dispositivos como eventos de Home Assistant
- 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 el Marketplace — 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) | ✅ |
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
- Programa por franjas, hasta 48 franjas
- Sensores de diagnóstico completos (sobrecorriente, sobretensión, sobretemperatura, rotor bloqueado, marcha en seco, UART)
Funciones DC Runner:
- Encendido/apagado, modo alimentación (pausa 1–60 min), modo control 0-10V
- Control de caudal (30–100%)
- Programa por franjas, hasta 48 franjas
- Sensores de fallo de diagnóstico (marcha en seco, rotor bloqueado, tensión, sobrecorriente, sobretemperatura, UART)
Instalación: Busque «Aqua Medic» en Ajustes > Marketplace.
🐟 ha-vson-component
Comederos automáticos VSON en Home Assistant a través de la API cloud VSON. El comedero WP8621 también puede funcionar totalmente en local reflasheándolo con ESPHome — la misma placa, sin cloud.
Dispositivos soportados:
✅ Soportado 🚧 En curso 🧪 Sin probar (puede funcionar) ❌ Aún no soportado
| Dispositivo | Modelos | Estado |
|---|---|---|
| WP8621 automatic fish feeder | variants N/E/H/F/B/P/A/C | ✅ |
| Any other VSON device | detected | 🧪 |
🐙 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 22 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: Busque “reef-maintenance” en Ajustes > Marketplace.
🐟 ha-reeftank-component
Una imagen viva de su acuario en el panel.

La integración detrás de la tarjeta de acuario de ha-reef-card: su foto, el agua iluminada por sus lámparas reales, peces y corales animados, y sus dispositivos y entidades encima. Guarda los acuarios, sus imágenes y su fauna, y registra las alimentaciones.
Funciones principales:
- Contornee el agua, la arena y las rocas en su propia foto — o dibuje el acuario con texturas de roca y arena
- Peces en cardumen, en aguas abiertas, sobre la arena o asomando de su madriguera, que se esconden tras las rocas de noche
- Agua teñida por sus lámparas (ReefLED o cualquier luz), corales que se mecen con las bombas
- Alimentaciones registradas desde comederos, atajos o un servicio; número de peces y corales como sensores; pH y ORP vigilados frente al propio historial del acuario
- Especies del reeftank-catalog, actualizadas automáticamente
Instalación: Busque “ReefTank” en Ajustes > Marketplace, e instale ha-reef-card para la tarjeta.
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, regulación de dosificación (asistida, salmuera), historial de dosis |
| 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, tendencias e historial de 7 días, calibración guiada pH/EC/ORP/temperatura, puertos 12V, ATO, zumbador, regleta emparejada |
| ReefControl (RSCONTROLLITE) | 🧪 | Sondas con barras de nivel, tendencias e historial de 7 días, 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) | ✅ | Cielo con sol y luna, haz con el programa del día, deslizadores intensidad/color o blanco/azul, editor de programas (kelvin o blanco/azul, nubes), modo meteorológico, grupos con amanecer escalonado, aclimatación |
| ReefLed (G2) | 🧪 | Cielo con sol y luna, haz con el programa del día, deslizadores intensidad/color o blanco/azul, editor de programas (kelvin o blanco/azul, nubes), modo meteorológico, grupos con amanecer escalonado, aclimatación |
| ReefWave (RSWAVE25/45) | ✅ | Vista animada de la bomba, velocidad y dirección, biblioteca de olas, editor de programa por franjas, grupos de bombas |
| Aqua Medic EcoDrift / SmartDrift | ✅ | Velocidad de la bomba en la imagen, fallos, pausa de alimentación, editor de programa por franjas |
| Aqua Medic DC Runner (return, skimmer) | ✅ | Vista de bomba de retorno o de skimmer según el rol de la integración, velocidad, fallos, editor de programa por franjas |
| Energy Backup (reefbeatEnergyBackup) | ✅ | Flujos de energía de la red, la batería y las bombas, dibujados con Power Flow Card Plus |
| VSON fish feeder (hacked, ESPHome) | ✅ | Imagen viva del comedero, franjas de alimentación, aviso de reserva, alimentar ahora |
| Aquarium view (ha-reeftank-component) | ✅ | La foto de su acuario con dispositivos y entidades en vivo, agua teñida por sus lámparas, peces y corales animados, editor de escena de siete pestañas |
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
- Diálogos de regulación de dosificación: dosificación asistida, salmuera con su gráfico de salinidad
- 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
Vista de acuario: una segunda tarjeta, custom:reef-aquarium-card, muestra una imagen viva de su acuario. Necesita ha-reeftank-component.
Instalación: Disponible directamente en el Marketplace — 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 |
![]() Demo ReefLed |
![]() Demo ReefWave |
![]() Demo Aqua Medic |
![]() Demo vista de acuario |
🔌 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
- Watchdog del modo Poseidon — vigila el relé MQTT de ha-reefbeat-component y devuelve los dispositivos al modo normal cuando cae
- 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 | ~664 € |
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 automatización para todo el ecosistema.
Le avisa en el móvil de los mantenimientos vencidos, encontrados por el atributo común reef_role para cubrir todas las integraciones, y de los dispositivos que dejaron de responder. Prueba sus calentadores uno a uno y le avisa cuando un relé está apagado pero su aparato sigue consumiendo. Ocho idiomas, un botón de importación por idioma.
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:
📦 Elevadores de patas para skimmer DC Red Sea
Elevadores para las patas del skimmer DC Red Sea, para ajustar su altura en el sump. Cuatro versiones: 80, 70, 60 y 50 mm.
Tests del agua
📦 Organizador para tests de acuario de arrecife Red Sea
Un sistema de almacenamiento para los kits de test de agua de arrecife Red Sea.
💬 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 · ha-reeftank-component · reeftank-catalog · reefbeatEnergyBackup · ha-reef-blueprints
- Informes de errores: abra una issue en ese mismo proyecto, con los detalles.
- Apoyar el proyecto:









