O painel permanece disponível em modo somente leitura.
Gerenciar Usuários
Usuários cadastrados
Usuário
Papel
Último login
Ações
carregando...
Gerenciar Placas
Aprove placas novas para que apareçam no painel. Remover apaga os dados da placa no servidor (definitivo).
carregando...
Acesso Admin
Digite a senha para acessar as configurações
> system.logs
Carregando dados...
📖
Guia do Usuário
Aquantis Manager — V10.54
📊
O que é o Aquantis?
O Aquantis Manager é um painel de monitoramento e controle de um sistema de abastecimento de água residencial. Ele se comunica em tempo real com um controlador ESP32 via protocolo MQTT, exibindo o nível dos reservatórios e permitindo o controle da bomba d'água.
🗂
Layout da Interface
◀
Barra Lateral Esquerda
Relógio em tempo real, previsão do tempo local, janela de operação (horários permitidos), botão de reset de alarme e configuração de meta de consumo.
▣
Área Central
Card do Reservatório Superior com nível visual + Cisterna abaixo. Card da Bomba com status, telemetria e botão de controle manual. Gráfico histórico de consumo.
▶
Barra Lateral Direita
Log do sistema em tempo real, mostrando todos os eventos registrados pelo ESP32.
▲
Barra Superior (Topbar)
Indicador de conexão MQTT (verde = conectado, vermelho = desconectado), badge de tipo de rede (ETH/WIFI), botão de ajuda e acesso ao painel Admin.
💡 Dica: A interface atualiza automaticamente ao receber dados do ESP32 via MQTT. Não é necessário recarregar a página.
🪣
Reservatório Superior
Tanque elevado que abastece a residência por gravidade. O nível é medido por sensores de boia (4 sensores), representados pelos pontos na base do card.
💧
Indicador Visual
A barra de água sobe conforme o nível aumenta. As linhas internas indicam 25%, 50%, 75% e 100% da capacidade (2.000 litros).
🟢
Pontos de Sensor
Os 4 pontos na base do card indicam os sensores de boia ativos. Cada ponto aceso = 500L. Todos acesos = tanque cheio (2.000L).
📏
Sensor Linear (4-20mA)
Como alternativa às 4 bóias, o reservatório pode usar um sensor de nível hidrostático (TL-163 via módulo N43IC04), que mede o nível de forma contínua. Nesse modo o card mostra o nível em porcentagem exata (não em degraus de 25%), e a calibração "mA vazio / mA cheio" é feita na aba Sensores.
🌊
Animação de Fluxo
Quando a bomba está ativa, o tanque exibe uma animação de fluxo subindo, indicando que está sendo abastecido.
💧
Cisterna
Reservatório subterrâneo que armazena a água vinda da rua. A bomba retira água da cisterna para encher o reservatório superior.
📊
Nível em %
Exibe a porcentagem de água disponível. O nível é medido em intervalos de 25% pelo sensor do ESP32.
⚠️
Alerta Crítico
Quando a cisterna está vazia ou sem água da rua, aparece o badge "Crítico" em vermelho e a barra fica vermelha. O sistema pode enviar alerta no WhatsApp (configurável no Admin).
⚙️
Status da Bomba
🟢
Bombeando
Ícone verde girando + texto "Bombeando...". A bomba está transferindo água da cisterna para o reservatório superior.
⚫
Desligada
Ícone neutro, sem animação. A bomba está parada, aguardando o nível do tanque cair (modo AUTO) ou comando manual.
🟡
Manutenção
Ícone âmbar. O modo manutenção está ativo — sensores de proteção ignorados. Use apenas para testes e manutenção física.
🔴
Alarme
Cabeçalho pisca em vermelho. Uma condição crítica foi detectada. Use "Resetar Alarme" na barra lateral para normalizar após resolver o problema.
📈
Telemetria da Bomba
Quando dados elétricos são enviados pelo ESP32, o painel exibe métricas em tempo real:
⚡
Tensão (V)
Tensão de alimentação da bomba. Fica em âmbar se abaixo de 200V (tensão baixa).
〰
Frequência (Hz)
Frequência da rede elétrica. Normal: 60Hz no Brasil.
⟳
RPM
Rotações por minuto do motor da bomba enquanto em funcionamento.
↤
Corrente (A)
Corrente elétrica consumida pela bomba. Fica em âmbar se acima de 15A (sobrecarga).
⏱
Histórico de Operação (Estatísticas)
Tempo Ligado (U0-25): horas que o inversor ficou na energia. Tempo de Motor (U0-26): minutos que o motor efetivamente rodou. Consumo Total (P7-14): energia consumida em kWh (contador acumulado do inversor, 0–65535 kWh). A barra de progresso indica o uso acumulado do motor.
📉
Histórico de Consumo
O gráfico exibe o volume de água movimentado por período. Use as abas para alternar a visualização:
HojeSemanaMêsAno
Rua Água recebida da rua (entrada na cisterna) | Bomba Água bombeada para o reservatório superior
🤖
Modo Automático
No modo AUTO (configurado no Admin), o ESP32 liga e desliga a bomba automaticamente com base nos sensores do reservatório superior:
⬆️
Ligar automático
Quando o nível do reservatório cai abaixo do sensor mínimo e há água na cisterna.
⬇️
Desligar automático
Quando o reservatório atinge o nível máximo (todos os sensores ativos) ou quando a cisterna esvazia.
🕐
Janela de Operação
Define os horários e dias da semana em que o modo automático pode funcionar. Fora da janela, o sistema trava em modo MANUAL.
🕐
Horário
Configure início e fim do período permitido. Ex: 07:00 às 18:00.
📅
Dias da Semana
Selecione quais dias a bomba pode operar automaticamente. Clique nos círculos com as iniciais dos dias.
⚠️ Atenção: Fora do horário ou dias configurados, o botão de controle manual exibe "Fora do Horário" e fica bloqueado.
👆
Controle Manual
Quando em modo MANUAL, o botão de controle aparece no card da Bomba:
🔵
Ligar Bomba
Clique para ligar a bomba manualmente. O botão fica desabilitado por alguns segundos aguardando confirmação do ESP32.
🔴
Desligar Bomba
Clique para desligar quando a bomba estiver ligada manualmente.
🔔
Sistema de Alertas WhatsApp
O sistema envia mensagens via WhatsApp para os admins cadastrados quando eventos importantes ocorrem. Configure no painel Admin:
🔴
Cisterna Vazia
Disparado quando não há água na cisterna ou a água da rua está ausente. Indica risco de a bomba rodar seca.
🔴
Falta de Fluxo
Disparado quando a bomba está ligada mas não há fluxo de água detectado pelo sensor de vazão.
🟡
Modo Manual
Notifica quando o sistema entra em modo manual (fora da janela de operação ou por comando do usuário).
🟡
Modo Manutenção
Notifica quando o modo manutenção é ativado — alertando que o sistema está sem proteções.
🚨
Modo Alarme
O modo alarme é ativado automaticamente pelo ESP32 em situações críticas. Quando ativo:
🚨
Indicação Visual
O cabeçalho pisca em vermelho com o texto "⚠ SISTEMA EM ALARME". O botão de controle mostra "Bloqueado — Reset necessário".
🔔
Resetar Alarme
Após resolver o problema físico, clique em "Resetar Alarme" na barra lateral esquerda para normalizar o sistema.
🌱
Meta de Consumo
Configure uma meta diária de litros na barra lateral. Quando o consumo total do dia ultrapassar o limite, o sistema envia a mensagem de alerta configurada para os admins.
☀️
Previsão do Tempo
O painel exibe automaticamente as condições climáticas atuais e a previsão para os próximos 7 dias, usando sua localização real (via GPS do navegador) ou Rio de Janeiro como padrão.
🌡️
Temperatura e Sensação
Temperatura atual em °C e sensação térmica real.
💧
Umidade e Chuva
Percentual de umidade do ar e probabilidade de chuva na hora atual.
📅
Previsão Semanal
7 dias com ícone do tempo, probabilidade de chuva, temperatura máxima e mínima. Atualiza a cada 30 minutos.
💡 A previsão é útil para antecipar o enchimento do reservatório antes de dias de chuva intensa, evitando overflow.
📡
Conexão MQTT
O painel se conecta ao broker MQTT rodando no mesmo servidor. O ícone no canto superior esquerdo indica o status:
🟢
cloud_done — Conectado
Comunicação ativa com o ESP32. Dados atualizando em tempo real.
🔴
cloud_off — Desconectado
Sem comunicação. O sistema tenta reconectar automaticamente a cada 5 segundos.
⚠ Códigos de Falha do Inversor (Série 9600)
Quando o "Código de Falha" no card do inversor for diferente de 0, consulte a tabela. Corrija a causa e use o botão ↻ Resetar falha no card. Err16 = Falha de comunicação é a proteção de segurança (ESP/cabo sem Modbus).
Código
Significado
Err01
Proteção da unidade inversora
Err02
Sobrecorrente durante a aceleração
Err03
Sobrecorrente durante a desaceleração
Err04
Sobrecorrente em velocidade constante
Err05
Sobretensão durante a aceleração
Err06
Sobretensão durante a desaceleração
Err07
Sobretensão em velocidade constante
Err08
Falha na fonte de alimentação de controle
Err09
Subtensão / Sob tensão
Err10
Sobrecarga do inversor CA
Err11
Sobrecarga do motor
Err12
Perda de fase de entrada de energia
Err13
Perda de fase de saída de energia
Err14
Superaquecimento do módulo
Err15
Falha de equipamento externo
Err16
Falha de comunicação (proteção de segurança)
Err17
Falha do contator
Err18
Falha de detecção de corrente
Err19
Falha no autoajuste do motor
Err20
Falha do codificador / PG
Err21
Falha de leitura e gravação da EEPROM
Err22
Falha de hardware do inversor CA
Err23
Curto-circuito à terra
Err26
Tempo de execução acumulado alcançado
Err27
Falha 1 definida pelo usuário
Err28
Falha 2 definida pelo usuário
Err29
Tempo acumulado de inicialização alcançado
Err30
Carga se tornando 0
Err31
Feedback PID perdido durante a execução
Err40
Falha no limite de corrente pulso a pulso
Err41
Falha de comutação do motor durante o funcionamento
Err42
Desvio de velocidade muito grande
Err43
Excesso de velocidade do motor
Err45
Superaquecimento do motor
Err51
Falha na posição inicial
Err52
Falha de realimentação de velocidade
Documentação Técnica
Sistema V10.54 (Painel imediato em modo leitura)
Aquantisv10.54
wifiETH
cloud_off
⚠ ESP32 SEM CONEXÃO — nenhum dado recebido há ?s. As informações abaixo podem estar desatualizadas.
0 placa(s)
Reservatório Superior
--L
75%
50%
25%
100%
--%
Cisterna
--%
⚠ Crítico
Controle da Bomba ▦—
settings_suggest
Aguardando...
Motor 1CV
AUTO
⚡Tensão (DC)
--V
〰Frequência
--Hz
🎯Setpoint
--Hz
⟳RPM
--rpm
⤴Corrente
--A
💧Vazão da Bomba
--L/min
ℹ️Status do Inversor (Diagnóstico Avançado)
Modo de Controle
--
Modbus OK
Código de Falha
--
0 = Sem Erros
Tempo Energia (U0-25)
--h
Ligado na Tomada
Tempo Motor (U0-26)
--min
Motor Rodando
Consumo Total (P7-14)
--kWh
Energia Acumulada
Histórico Geral
Rua (Entrada)
0 L
0 L/min (Vazão)
Bomba (Saída)
0 L
Total Bombeado Hoje
admin_panel_settings
Configuração Geral ▦—
Controles operacionais e alertas
Controle Operacional
Modo Automático
Modo Manutenção
Ignora sensores de proteção
Atualizar Firmware (OTA)
Versão atual do firmware: —
Escolha o arquivo .bin; o ESP32 baixa do servidor e se grava. A bomba fica desligada durante a gravação e a placa reinicia ao final.
Personalizar Alertas
Cisterna Vazia
Falta de Fluxo
Modo Manual
Modo Manutenção
Contatos Admin
Admin 1
Admin 2
Admin 3
Sistema
Senha do Painel
Calibração de Fluxo (pulsos/L · entrada e bomba)
Suavização da vazão (entrada)
0.05 = bem suave/lento · 1.0 = instantâneo (sem filtro). Padrão 0.30.
IP Atual: --
Configuração do ESP32 (CLP)
Capacidade Caixa (L)
Liga Bomba Em
Usa Cisterna
Mínimo Cisterna
Atraso Partida (s)
Tempo Seco (s)
Confirma Cheio (s)
Confirma Vazio (s)
Filtro Marola (s)
Debug Serial
Fator Bomba
Fator Entrada
Cadastro de Placas (barramento)
Registre aqui cada placa física do barramento (uma vez só). Depois, em Funções Lógicas,
você escolhe a placa pelo nome e quais canais usar para cada função. Direção e polaridade
de cada canal vivem aqui no cadastro.
Adicionar placa (tipo)
Funções Lógicas
Para cada função do sistema, escolha qual placa cadastrada e qual canal a atende.
Os níveis (caixa/cisterna) aceitam um canal por faixa (25/50/75/100%).
Estado das Entradas (ao vivo)
Mostra o valor atual de cada canal das placas cadastradas — independente da tecnologia (RS-485, I2C, pulso).
Para digitais: LED verde quando o canal está ativo. Para analógicos: valor bruto. Para pulso: rate (Hz/L·min).
Proteções
A bomba é protegida por tempo e por volume até o próximo nível (ambos aprendidos
automaticamente a cada enchimento). Se a bomba ligar e o nível não subir dentro do esperado
— ar na tubulação, conexão rompida, filtro entupido — o sistema para e alarma até o operador
resetar. O nível é a verdade; o sensor de fluxo é só referência.
Margem de tempo (%)
100 = para se passar de 2× o tempo aprendido da fatia sem o nível subir
Tol. volumétrica normal (%)
Tol. volumétrica crítica (%)
⚠ Ao trocar a bomba (vazão diferente), use "Reaprender" para o sistema recalibrar o tempo
e o volume de cada fatia. Até reaprender, a proteção de tempo usa a média das fatias já conhecidas.
Barramento RS-485
Velocidade única para todo o barramento RS-485. O teto é limitado automaticamente
pelo dispositivo cadastrado mais lento .
Controle de direção — atual: --
Velocidade RS-485 — atual: --
⚠ A troca de velocidade exige a bomba desligada. O ESP32 regrava o PD-00 do inversor
(preservando os outros dígitos), troca a própria serial e confirma — se o inversor não responder
no novo baud, tudo é revertido. Se ainda assim a comunicação cair, o auto-scan recupera sozinho.
Controle de direção (DE):Automático = o transistor da placa cuida (modo testado,
até 38400 — o padrão). Manual = o hardware do UART comanda o DE pelo GPIO5, necessário p/
57600/115200 (use só se, na sua placa, o GPIO5 não brigar com o transistor — teste a 9600 antes).
Sensor de nível RS-485 (R4DIF08): é reconfigurado junto (reg 0x00FF) e reiniciado
automaticamente pelo relé (a alimentação dele passa pelo contato NF) — ele limita o
barramento a 19200. Se ficar mudo por 30s, o firmware também o reinicia sozinho.
Instalou um sensor novo (fábrica = 9600) num barramento que já roda em outra velocidade?
Sincronizar varre todos os endereços/velocidades e manda só para as placas
"atrasadas" o comando de adotar o baud atual — sem trocar a velocidade do barramento
e sem tocar nas placas que já estão certas.
Inversor (RS-485 / Modbus)
Tipo de Controle
Slave ID (Modbus)
Frequência Alvo (Hz)
Freq. Máxima P0-10 (Hz)
Parâmetros Avançados do Inversor
Estas configurações vivem dentro do inversor e são gravadas via Modbus. Cada campo tem
a explicação do que faz logo abaixo do nome. Deixe em branco o que não quiser alterar.
⚠ Valores são escritos direto no inversor — confira antes de salvar. Use "Ler do inversor" para ver os valores atuais.
Rede & Identidade
⚠ Cuidado: um SSID/senha de WiFi errados deixam o ESP32 inacessível remotamente (ele cai em modo AP local e só dá pra reconfigurar fisicamente). Alterar o device_id REINICIA a placa. Deixe em branco o que não quiser mudar.
Device ID (assinatura MQTT)
Servidor MQTT (host)
Usuário MQTT
Senha MQTT
Rede WiFi (SSID)
Senha WiFi
Senha do AP de config (min 8)
PIN resgate (controle)
Senha do AP: usada no Wi-Fi de configuração "AGUACINOY_CONFIG" (quando a rede cai). PIN resgate:
exigido para LIGAR/DESLIGAR a bomba pela página de resgate (HTTP local) quando o servidor está fora — vazio
deixa o controle aberto na LAN (como hoje). A leitura de status nunca exige PIN.
GPIOs Disponíveis
Marque quais GPIOs do ESP32 estão fisicamente livres nesta placa (não estão reservadas
para RS-485, I2C, SPI/SD, OLED, PCF, relés etc.). Só estes pinos aparecerão como opção para
medidores de fluxo (pulso) e outros sensores que ocupam GPIO direto.
⚠ Marcar um pino reservado pode travar a placa.