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
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
- 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 HACS — 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) | ✅ |
| Reefdoser EVO (bomba doseadora) | ❌ — Peça-o |
| T-Controller Twin (controlador de temperatura) | ❌ — Peça-o |
| Aquarius / Spectrus (iluminação) | ❌ — Peça-o |
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
- Sensores de diagnóstico completos (sobrecorrente, sobretensão, sobreaquecimento, rotor bloqueado, funcionamento a seco, UART)
Funcionalidades DC Runner:
- Ligar/desligar, modo alimentação (pausa 10 min), modo controle 0-10V
- Controle de caudal (30–100%)
- Sensores de diagnóstico (funcionamento a seco, rotor bloqueado, tensão)
Instalação: No HACS, adicione https://github.com/Elwinmage/ha-aquamedic-component como repositório personalizado (Integração), depois pesquise “Aqua Medic”.
🐙 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 17 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: No HACS, adicione https://github.com/Elwinmage/ha-reef-maintenance-component como repositório personalizado (Integraçã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 |
| 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 e histórico de 24 h, calibração guiada pH/EC/ORP/temperatura, portas 12V, ATO, buzzer, régua emparelhada |
| ReefControl (RSCONTROLLITE) | 🧪 | Sondas com barras de nível e histórico de 24 h, 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/G2) | 🚧 | Próximo passo do roteiro |
| ReefWave | ❌ | Votar na prioridade |
| Aqua Medic EcoDrift / SmartDrift | ❌ | Votar na prioridade |
| Aqua Medic DC Runner (return, skimmer) | ❌ | Votar na prioridade |
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
- 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
Instalação: Disponível diretamente no HACS — 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 |
🔌 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
- 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 | ~627 € |
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 notificaçã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. 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:
💬 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 · reefbeatEnergyBackup
- Relatórios de erros: abra uma issue nesse mesmo projeto, com os detalhes.
- Apoiar o projeto:
