Minhas ferramentas ReefTank
Bem-vindo à documentação dos meus projetos para aquários de recife.
- Minhas ferramentas ReefTank
Integrações e cartões Home Assistant
Desde o Home Assistant 2026.11, o HACS faz parte do Home Assistant com o nome Marketplace (Definições > Marketplace). Num Home Assistant mais antigo, os mesmos passos funcionam no HACS.
Integrações
🐠 ha-reefbeat-component
Integração local para o ecossistema Red Sea ReefBeat.
Gerencie seus dispositivos Red Sea ReefBeat localmente (sem cloud): ReefATO+, ReefControl, ReefControl-Power, ReefDose, ReefLed, ReefMat, ReefRun e ReefWave.
⚠️ Este não é um repositório oficial da Red Sea. Uso por sua conta e risco.
Funcionalidades principais:
- Controle 100% local — sem dependência da cloud para a maioria dos dispositivos
- Detecção automática de dispositivos na rede local (com modo manual e suporte a sub-redes)
- Ícones personalizados para todos os dispositivos ReefBeat
- Notificações de atualização de firmware (com Cloud API opcional)
- Modo de atualização de configuração em tempo real
- Regulação da dosagem para a ReefDose: dosagem assistida a partir dos resultados de teste, salmoura regulada pela salinidade
- Modo Poseidon (experimental): um relé local que substitui a maior parte das consultas pelo que os dispositivos enviam, com o histórico das doses e os alarmes dos dispositivos como eventos Home Assistant
- Suporte multilíngue
Dispositivos suportados:
✅ Suportado 🚧 Em curso 🧪 Não testado (pode funcionar) ❌ Ainda não suportado
| Aparelho | 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 | ✅ |
Especificidades do ReefWave: O ReefWave é o único dispositivo ligado à cloud ReefBeat. Três modos de operação estão disponíveis — Cloud, Local e Híbrido — para que escolha o equilíbrio entre controle local total e sincronização com a app móvel ReefBeat.
Instalação: Disponível diretamente no Marketplace — pesquise “redsea” ou “reefbeat”.
🌊 ha-aquamedic-component
Controle de bombas Aqua Medic via Home Assistant através da API cloud Gizwits.
Controle suas bombas Aqua Medic a partir do Home Assistant via API cloud Gizwits (mesmo backend da app oficial Aqua Medic).
Dispositivos suportados:
✅ Suportado 🚧 Em curso 🧪 Não testado (pode funcionar) ❌ Ainda não suportado
| Aparelho | Estado |
|---|---|
| EcoDrift / SmartDrift x.1 / x.3 (de circulação) | ✅ |
| DC Runner x.1 / x.2 / x.3 (bomba de retorno) | ✅ |
| DC Runner (bomba do escumador) | ✅ |
Funcionalidades EcoDrift / SmartDrift:
- Ligar/desligar, tipo de onda (Pulso/Maré), modo alimentação, temporizador, modo controle 0-10V
- Modos de onda: Clássica, Sinusoidal, Aleatória, Fluxo constante
- Ligação: Independente, Master, Slave
- Controle de caudal, frequência e duração de alimentação
- Programa por períodos, até 48 períodos
- Sensores de diagnóstico completos (sobrecorrente, sobretensão, sobreaquecimento, rotor bloqueado, funcionamento a seco, UART)
Funcionalidades DC Runner:
- Ligar/desligar, modo alimentação (pausa 1–60 min), modo controle 0-10V
- Controle de caudal (30–100%)
- Programa por períodos, até 48 períodos
- Sensores de falha de diagnóstico (funcionamento a seco, rotor bloqueado, tensão, sobrecorrente, sobretemperatura, UART)
Instalação: Pesquise «Aqua Medic» em Definições > Marketplace.
🐟 ha-vson-component
Alimentadores automáticos VSON no Home Assistant através da API cloud VSON. O alimentador WP8621 também pode funcionar totalmente local reflashando-o com ESPHome — a mesma placa, sem cloud.
Dispositivos suportados:
✅ Suportado 🚧 Em curso 🧪 Não testado (pode funcionar) ❌ Ainda não suportado
| Aparelho | Modelos | Estado |
|---|---|---|
| WP8621 automatic fish feeder | variants N/E/H/F/B/P/A/C | ✅ |
| Any other VSON device | detected | 🧪 |
🐙 ha-reef-maintenance-component
Acompanhamento de manutenção para equipamento que o Home Assistant não alcança.
Bombas de circulação, bombas de retorno, escumadores, reatores — tudo o que limpa à mão. Uma entrada por marca, um aparelho por equipamento, quatro entidades por tarefa: um botão que regista o trabalho, um número para o intervalo, um interruptor para silenciar os avisos e uma data para retroagir a última intervenção.
Funções principais:
- Predefinições para Tunze, Jebao e equipamento genérico, com os intervalos do fabricante quando publicados
- Uma biblioteca comum de 22 tarefas, traduzida em 8 idiomas
- Retroatividade, para que um equipamento novo não comece em «nunca feito»
- Serviço
reef_maintenance.reset— cole uma etiqueta NFC na bomba e leia-a quando terminar - Mesmo contrato
reef_roledas integrações ligadas: as tarefas aparecem na vista de manutenção do cartão
Instalação: Pesquise “reef-maintenance” em Definições > Marketplace.
🐟 ha-reeftank-component
Uma imagem viva do seu aquário no painel.

A integração por trás do cartão de aquário do ha-reef-card: a sua foto, a água iluminada pelas suas lâmpadas reais, peixes e corais animados, e os seus dispositivos e entidades. Guarda os aquários, as suas imagens e a sua fauna, e regista as alimentações.
Funções principais:
- Contorne a água, a areia e as rochas na sua própria foto — ou desenhe o aquário com texturas de rocha e areia
- Peixes em cardume, em águas abertas, na areia ou a espreitar da toca, que se escondem atrás das rochas à noite
- Água tingida pelas suas lâmpadas (ReefLED ou qualquer luz), corais a ondular com as bombas
- Alimentações registadas a partir de alimentadores, atalhos ou um serviço; número de peixes e corais como sensores; pH e ORP vigiados face ao histórico do próprio aquário
- Espécies do reeftank-catalog, atualizadas automaticamente
Instalação: Pesquise “ReefTank” em Definições > Marketplace, e instale ha-reef-card para o cartão.
Cartões
🪸 ha-reef-card
Cartão Lovelace personalizado para painéis de recife.
O Reef Card para Home Assistant ajuda-o a gerir o seu aquário de recife diretamente a partir do painel. Combinado com ha-reefbeat-component, deteta e suporta automaticamente os seus dispositivos Red Sea (ReefBeat).
Dispositivos não-Redsea também podem ser suportados — solicite aqui.
Dispositivos suportados:
✅ Suportado 🚧 Em curso 🧪 Não testado (pode funcionar) ❌ Ainda não suportado
| Aparelho | Estado | Pontos fortes |
|---|---|---|
| ReefDose (RSDOSE2/4) | ✅ | Planeamento completo, doseamento manual, escorvamento e calibração, gestão de suplementos, acompanhamento do consumo, regulação da dosagem (assistida, salmoura), histórico das doses |
| ReefMat (RSMAT250/500/1200) | ✅ | Estado do rolo animado, avanço manual/automático/programado, estado do sensor, gráficos semanais e mensais |
| ReefRun (RSRUN) | ✅ | Controlo da velocidade da bomba, editor de programas, gestão da sobre-escumação |
| ReefATO+ | ✅ | Nível de água, sonda de fugas, diagnóstico da bomba, gráfico de consumo, buzzer de fuga |
| ReefControl (RSCONTROLPRO) | ✅ | Sondas com barras de nível, tendências e histórico de 7 dias, calibração guiada pH/EC/ORP/temperatura, portas 12V, ATO, buzzer, régua emparelhada |
| ReefControl (RSCONTROLLITE) | 🧪 | Sondas com barras de nível, tendências e histórico de 7 dias, calibração guiada pH/EC/ORP/temperatura, portas 12V, ATO, buzzer, régua emparelhada |
| ReefControl-Power (RSPOWER6) | ✅ | Controlo por tomada, modos ligado/desligado/programa/sonda, aparelhos associados, sonda de temperatura local ou ligação ReefControl |
| ReefControl-Power (RSPOWER8) | 🧪 | Controlo por tomada, modos ligado/desligado/programa/sonda, aparelhos associados, sonda de temperatura local ou ligação ReefControl |
| ReefLed (G1) | ✅ | Céu com sol e lua, feixe com o programa do dia, cursores intensidade/cor ou branco/azul, editor de programas (kelvin ou branco/azul, nuvens), modo meteorológico, grupos com nascer escalonado, aclimatação |
| ReefLed (G2) | 🧪 | Céu com sol e lua, feixe com o programa do dia, cursores intensidade/cor ou branco/azul, editor de programas (kelvin ou branco/azul, nuvens), modo meteorológico, grupos com nascer escalonado, aclimatação |
| ReefWave (RSWAVE25/45) | ✅ | Vista animada da bomba, velocidade e direção, biblioteca de ondas, editor de programa por faixas horárias, grupos de bombas |
| Aqua Medic EcoDrift / SmartDrift | ✅ | Velocidade da bomba na imagem, falhas, pausa de alimentação, editor de programa por faixas horárias |
| Aqua Medic DC Runner (return, skimmer) | ✅ | Vista de bomba de retorno ou de escumador segundo o papel na integração, velocidade, falhas, editor de programa por faixas horárias |
| Energy Backup (reefbeatEnergyBackup) | ✅ | Fluxos de energia da rede, da bateria e das bombas, desenhados com Power Flow Card Plus |
| VSON fish feeder (hacked, ESPHome) | ✅ | Imagem viva do alimentador, períodos de alimentação, aviso de reserva, alimentar agora |
| Aquarium view (ha-reeftank-component) | ✅ | A foto do seu aquário com dispositivos e entidades em direto, água tingida pelas suas lâmpadas, peixes e corais animados, editor de cena com sete separadores |
Destaques ReefDose:
- Cartão de 6 zonas: config/WiFi, estados, dosagem manual com atalhos, agendamento por cabeça com progresso circular, gestão de suplementos com imagens de marcas, e fila de próximas doses
- Suporte a fluxos de escorva e calibração
- Janelas de regulação da dosagem: dosagem assistida, salmoura com o seu gráfico de salinidade
- Biblioteca de suplementos com imagens para Red Sea, Tropic Marin, Quantum, ATI, Aqua Forest e mais
Destaques ReefMat:
- Cartão de 7 zonas com fundo animado que muda conforme o uso do rolo (0%–100%)
- Info em tempo real do rolo: comprimento restante, média diária, dias restantes estimados
- Controles de avanço manual, automático e agendado
- Exibição do estado do sensor de nível (conectado, desconectado, sujo)
- Gráficos de consumo semanal e mensal
Vista de aquário: um segundo cartão, custom:reef-aquarium-card, mostra uma imagem viva do seu aquário. Precisa de ha-reeftank-component.
Instalação: Disponível diretamente no Marketplace — pesquise “reef-card”.
Configuração: Sem o parâmetro device, o cartão deteta automaticamente todos os dispositivos ReefBeat e permite-lhe escolher. Defina o parâmetro device para forçar um dispositivo específico.
![]() Demo ReefDose |
![]() Demo ReefMat |
![]() Demo ReefRun |
![]() Demo Manutenção |
![]() Demo ReefATO+ |
![]() Demo ReefControl & ReefControl-Power |
![]() Demo ReefLed |
![]() Demo ReefWave |
![]() Demo Aqua Medic |
![]() Demo vista de aquário |
🔌 Infraestrutura
⚡ reefbeatEnergyBackup
Sistema autónomo de backup com bateria para aquários de recife Red Sea.
Mantenha os seus ReefWave, ReefRun e DC Skimmer a funcionar durante cortes de energia com uma bateria LiFePO₄ 24V, um Raspberry Pi e degradação inteligente das bombas.

Funcionalidades principais:
- Monitorização de bateria via INA226 (I2C) + carregador Victron BLE opcional
- Deteção instantânea de cortes via relé 230V no GPIO
- Degradação progressiva das bombas — níveis SoC calculados a partir de uma autonomia alvo
- Failover de rede 3 níveis — Ethernet → Wi-Fi → hotspot espelho autónomo
- Failover 4G/LTE — notificações e acesso cloud ReefBeat via modem USB ou tethering
- Notificações push via ntfy.sh (gratuito, sem conta)
- Integração Home Assistant — MQTT auto-discovery, entidade de atualização, blueprint de teste de bateria
- Watchdog do modo Poseidon — vigia o relé MQTT do ha-reefbeat-component e devolve os dispositivos ao modo normal quando ele cai
- Auto-atualização — verifica GitHub, botão “Instalar” no HA
Níveis de hardware:
| Nível | O que obtém | Orçamento |
|---|---|---|
| 1 — Básico | Bateria + cabos, backup passivo | ~290 € |
| 2 — Normal (recomendado) | + RPi + INA226 + relé, monitorização & automação | ~402 € |
| 3 — Avançado | + Carregador Victron BLE, disjuntor conectado, modem 4G | ~664 € |
Instalação:
curl -sL https://raw.githubusercontent.com/Elwinmage/reefbeatEnergyBackup/main/install.sh | sudo bash
Funciona sozinho ou como complemento do ha-reefbeat-component para uma gestão de recife totalmente integrada.
🐬 ha-reef-blueprints
Blueprints de automação para todo o ecossistema.
Avisa-o no telemóvel das manutenções em atraso, encontradas pelo atributo comum reef_role para que todas as integrações fiquem cobertas, e dos aparelhos que ficaram inacessíveis. Testa os seus aquecedores um a um e avisa-o quando um relé está desligado mas o aparelho continua a consumir. Oito idiomas, um botão de importação cada.
Instalação: importe do repositório, um botão por idioma.
📐 Modelos 3D
ReefRun DC Skimmer
📦 Ferramenta para rotor de skimmer DC Red Sea
Demonstração em vídeo:
📦 Elevadores dos pés do skimmer DC Red Sea
Elevadores para os pés do escumador DC Red Sea, para ajustar a sua altura na sump. Quatro versões: 80, 70, 60 e 50 mm.
Testes da água
📦 Organizador para testes de aquário de recife Red Sea
Um sistema de arrumação para os kits de teste de água de recife Red Sea.
💬 Contacto e suporte
- Perguntas e pedidos de funcionalidades: abra uma discussão no projeto em causa — ha-reefbeat-component · ha-aquamedic-component · ha-reef-card · ha-reef-maintenance-component · ha-reeftank-component · reeftank-catalog · reefbeatEnergyBackup · ha-reef-blueprints
- Relatórios de erros: abra uma issue nesse mesmo projeto, com os detalhes.
- Apoiar o projeto:









