Manual de instalação

Um dispositivo lê os três reservatórios. Ele fica ao lado deles, dentro de uma caixa vedada, e fala por Wi-Fi com o roteador — não passa cabo de rede.

Este desenho vale para reservatórios agrupados, com até uns 5 metros de cabo entre a boia mais distante e a caixa. Se algum reservatório ficar dezenas de metros longe, a ligação muda: aí é laço de 12 V com optoacoplador, e não a ligação direta descrita aqui.

São quatro boias por reservatório, a 25%, 50%, 75% e 95% da altura útil, medida a partir do fundo. Altura útil é da saída de água até o nível máximo — não a altura externa da caixa.

Boia é sensor de liga-desliga, não de medida. Quatro boias dão cinco estados, e o painel mostra a faixa (“entre 50% e 75%”), nunca um número fingindo precisão. Por isso a altura de cada uma é uma decisão de projeto: é ela que define o que você vai enxergar.

Prenda a haste de forma que a boia suba e desça livre, longe da entrada de água — o jato faz a boia bater e gerar chaveamento à toa. O firmware já filtra isso com 3 segundos de debounce, mas boia batendo o dia inteiro quebra antes.

Um CAT5e por reservatório atende as quatro boias: quatro fios de sinal e um comum. Deixe folga; cabo esticado arrebenta no primeiro movimento da caixa d’água.

O circuito abaixo é o de uma boia, repetido doze vezes — uma vez por boia, sempre igual. Nada de fonte separada: a boia fecha o pino contra o GND, em 3,3 V.

Achando o pino na placa

Os pinos têm a identificação impressa na lateral de cada furo. A maioria vem como D32, D33, D25 — o D é só prefixo; algumas placas escrevem IO32 ou o número puro, e é tudo o mesmo pino. Os outros dois que você vai usar são 3V3 (ou 3.3V), para o lado de cima dos resistores de 1 kΩ, e GND, para o retorno das boias — a placa tem vários GND e todos servem, são o mesmo ponto.

Ligue uma boia de cada vez e vá riscando. Cada linha é: um fio da boia no pino indicado (junto com o resistor e o capacitor do desenho acima), o outro fio da boia no GND.

5 V, 1 A. Um carregador de celular comum dá conta — o ESP32 consome cerca de 160 mA, com picos de meio ampère quando o Wi-Fi transmite. Ligue pelo conector USB da placa (mais simples) ou pelos pinos 5V e GND.

Se a placa reiniciar sozinha, suspeite do cabo antes de qualquer outra coisa: cabo USB fino e comprido derruba tensão o bastante para disparar o desligamento por subtensão no pico de transmissão. Cabo curto e grosso resolve; se insistir, um capacitor eletrolítico de 470 a 1000 µF entre 5 V e GND, perto da placa, mata o resto.

Caixa IP65 clara e na sombra. Caixa escura fechada no sol de laje passa fácil de 60 °C; o ESP32 aguenta, mas o carregador é o elo fraco. Se a caixa for metálica, o Wi-Fi não sai — aí precisa de antena externa.

Com o programa já gravado na placa, esta parte é toda pelo celular: o próprio aparelho cria uma rede Wi-Fi temporária e mostra a página de configuração nela. Placa nova, comprada agora, precisa antes receber o programa pelo USB — veja o passo 10.

1. No painel, abra Dispositivos e toque em Adicionar dispositivo. Anote o código de 8 caracteres — vale por 30 minutos e serve uma vez só.
2. Energize a placa e espere meio minuto. No Wi-Fi do celular vai aparecer uma rede chamada WaterPulse-seguida de quatro caracteres (são os últimos do número da placa).
3. Conecte nessa rede. Ela é aberta, não tem senha. O celular costuma reclamar que não há internet — é isso mesmo.
4. A página de configuração abre sozinha. Se não abrir, abra o navegador e digite 192.168.4.1.
5. Escolha a rede do local na lista, digite a senha dela e cole o código de pareamento. Toque em Conectar.
6. O aparelho testa a rede na hora. Se a senha estiver errada, a própria página avisa e você corrige sem sair dali. Dando certo, ele grava, reinicia e aparece no painel em menos de um minuto.
7. Cadastre os reservatórios e diga, na tela de canais, qual boia está em qual canal e a que altura ela ficou.

Só aparecem redes de 2,4 GHz na lista: o rádio do aparelho não enxerga 5 GHz. Se a rede da casa for de banda dupla com nome único, pode ser preciso separar as bandas no roteador.

A rede temporária fica no ar por 10 minutos. Se fechar antes de você terminar, o aparelho reinicia e ela volta.

O segredo do dispositivo só trafega uma vez, no pareamento, e fica gravado na memória da placa. Se o código expirar, gere outro — não dá para reusar.

Na tela de canais o painel mostra o estado ao vivo de cada entrada. Suba a boia com a mão, uma de cada vez, e veja o canal correspondente mudar. É o único momento barato de descobrir dois fios trocados.

O sistema também avisa sozinho quando as boias formam uma sequência impossível — uma desligada com outra ligada acima dela. Água é contígua: isso é boia travada, cabo rompido ou canal trocado, e aparece no painel como “dado suspeito”.

A placa queimou ou parou

Os reservatórios, o histórico e os alertas não são da placa: são da instalação. Trocar o hardware não perde nada disso.

1. Grave o firmware. Baixe o pacote abaixo, extraia numa pasta qualquer e ligue a placa no USB do computador. Depois é só clicar em GRAVAR-WINDOWS.bat — no Linux, abrir o terminal na pasta e rodar bash gravar-linux.sh. Ele acha a placa sozinho e grava em cerca de um minuto. Não precisa instalar nada: o gravador vai dentro do pacote.Baixar o gravador — Windows e Linux, 32 MBO download pede login — é a mesma conta que gera o código de pareamento no passo seguinte. Precisa também de cabo USB de dados: cabo só de carregar não serve, e a luz vermelha acende igual nos dois. O pacote traz um LEIA-ME.txt com o passo a passo e o que fazer se der errado.
2. Passe os fios das boias para a placa nova, respeitando a mesma tabela do passo 5 — D32, D33, D25…, na mesma ordem.
3. No painel, em Dispositivos, toque em Adicionar dispositivo e anote o código novo.
4. Energize a placa, conecte no Wi-Fi WaterPulse-… pelo celular e faça o mesmo do passo 8. Daqui em diante não precisa mais de computador.
5. Os doze canais já vêm mapeados. O sistema guarda o mapeamento por modelo de placa e aplica sozinho quando uma placa igual entra sem canais. Confira no diagnóstico ao vivo e pronto.
6. Depois que a nova estiver reportando, remova a antiga da lista de dispositivos.

Mais reservatórios do que cabe numa placa

Uma placa lê 12 boias — três reservatórios de quatro. Para o quarto reservatório, some uma segunda placa: cadastre outro dispositivo no painel, pareie do mesmo jeito e mapeie os canais dele. As duas convivem na mesma organização e aparecem no mesmo painel; cada reservatório continua sendo lido por uma placa só.

Vale também quando o reservatório novo fica longe: acima de uns 80 metros de cabo, uma segunda placa perto dele sai mais barata que o cabo — e some o ponto único de falha. Aí o desenho de ligação muda; veja o item de cabo longo no PRD antes de puxar fio.

A placa reinicia sozinha

Cabo ou fonte. Troque por um cabo curto e grosso antes de mexer em qualquer outra coisa.

Não acha a rede

O ESP32 não enxerga 5 GHz. Confirme que a banda de 2,4 GHz está ligada no roteador — em roteador com nome de rede único, ela pode ter sido desativada.

A rede WaterPulse-… não aparece no celular

Ela só existe quando o aparelho não consegue trabalhar: sem rede configurada, ou depois de três minutos tentando sem sucesso. Se ele já está conectado e funcionando, a rede temporária não sobe — e é assim que tem que ser.

Conectei na WaterPulse-… e a página não abriu

Abra o navegador e digite 192.168.4.1. Alguns celulares só abrem a página sozinhos se você tocar no aviso de “fazer login na rede”. Se o navegador insistir em buscar no Google, digite o endereço com http:// na frente.

A página diz que não conseguiu conectar

Quase sempre é a senha. Depois disso, confira se a rede escolhida é a de 2,4 GHz. Vale tentar aproximar o aparelho do roteador para descartar sinal fraco: a lista mostra o sinal de cada rede em dBm, e abaixo de -80 a conexão é instável.

Uma boia falha de vez em quando

Quase sempre é o resistor de 1 kΩ faltando naquele canal, ou o contato da boia sujo. Confira o resistor primeiro.

O reservatório aparece cheio quando está vazio

A boia é de contato normalmente fechado e foi cadastrada como normalmente aberto (ou o contrário). Corrija no cadastro do sensor, sem mexer no fio.

O painel diz “sem dados”

O dispositivo passou de três intervalos de reporte sem falar. Veja se a fonte está ligada e se o Wi-Fi mudou de senha.

Troquei a placa e o painel diz “sem canal mapeado”

O mapeamento é aplicado sozinho a partir do padrão da organização, mas só quando a placa é do mesmo modelo e ainda não tem canal nenhum. Se ela veio de outro modelo, mapeie na tela de canais uma vez — dali em diante a próxima já nasce pronta.

A luz azul da placa não pisca como o esperado

A vermelha é de energia e fica acesa sempre; não dá para controlar. A azul indica o estado: acesa fixa subindo, pisca rápido no portal, pisca espaçado procurando Wi-Fi, dois piscas quando o servidor recusa, e um pisca curto a cada 3 s quando está tudo certo. Placa com o LED ligado ao contrário mostra o padrão invertido — dá para corrigir na configuração do firmware.