{"id":37,"date":"2026-10-05T14:20:14","date_gmt":"2026-10-05T14:20:14","guid":{"rendered":"https:\/\/sfelectronica.com\/bit\/?p=37"},"modified":"2026-10-05T14:20:14","modified_gmt":"2026-10-05T14:20:14","slug":"sistema-agua-esphome-home-assistant","status":"publish","type":"post","link":"https:\/\/sfelectronica.com\/bit\/sistema-agua-esphome-home-assistant\/","title":{"rendered":"Sistema de \u00c1gua com ESPHome e Home Assistant"},"content":{"rendered":"\n

O WaterSystem<\/strong> transforma o quadro de entrada de \u00e1gua de uma casa num sistema vigiado a tempo inteiro: um ESP32<\/strong> a correr ESPHome<\/strong> mede o caudal instant\u00e2neo e o consumo acumulado, l\u00ea a temperatura da \u00e1gua da rede e a do dep\u00f3sito de AQS com duas sondas Dallas<\/em>, comanda uma v\u00e1lvula motorizada de corte geral<\/strong> com dois rel\u00e9s em interlock e dispara um alarme local se o sensor de inunda\u00e7\u00e3o detetar \u00e1gua no ch\u00e3o. Tudo local, sem nuvem e sem subscri\u00e7\u00f5es.<\/p>\n\n\n\n

\n\n\t
Projeto<\/span>WaterSystem<\/span><\/div>\n\n\t
Hardware<\/span>ESP32 \u00b7 caudal\u00edmetro \u00b7 2\u00d7 DS18B20 \u00b7 v\u00e1lvula motorizada \u00b7 sensor de inunda\u00e7\u00e3o<\/span><\/div>\n\n\t
Firmware<\/span>ESPHome (min. 2024.6.0)<\/span><\/div>\n\n\t
Plataforma<\/span>Home Assistant<\/span><\/div>\n\n\t
Ficheiro<\/span>SistemaAgua.yaml<\/span><\/div>\n\n\t
Rede<\/span>IP est\u00e1tico \u00b7 AP + captive portal<\/span><\/div>\n\n\t
Nuvem<\/span>Nenhuma \u2014 100% local<\/span><\/div>\n\n<\/div>\n\n\n\n
\n\n\t

Neste artigo<\/p>\n\n\t

    \n\n\t\t
  1. Vis\u00e3o geral do sistema<\/a><\/li>\n\n\t\t
  2. Hardware e esquema de liga\u00e7\u00e3o<\/a><\/li>\n\n\t\t
  3. Mapeamento dos GPIO<\/a><\/li>\n\n\t\t
  4. O YAML, bloco a bloco<\/a><\/li>\n\n\t\t
  5. Caudal e consumo acumulado<\/a><\/li>\n\n\t\t
  6. Temperaturas com OneWire<\/a><\/li>\n\n\t\t
  7. V\u00e1lvula de corte com interlock<\/a><\/li>\n\n\t\t
  8. Alarme de inunda\u00e7\u00e3o<\/a><\/li>\n\n\t\t
  9. Rede, gest\u00e3o e atualiza\u00e7\u00f5es<\/a><\/li>\n\n\t\t
  10. Instala\u00e7\u00e3o passo a passo<\/a><\/li>\n\n\t\t
  11. No Home Assistant<\/a><\/li>\n\n\t\t
  12. Diagn\u00f3stico e boas pr\u00e1ticas<\/a><\/li>\n\n\t\t
  13. Conclus\u00e3o<\/a><\/li>\n\n\t<\/ol>\n\n<\/div>\n\n\n\n

    Vis\u00e3o geral do sistema<\/h2>\n\n\n\n

    A ideia \u00e9 simples: em vez de comprar um contador inteligente fechado, instrumenta-se o quadro de entrada de \u00e1gua<\/strong>. O caudal\u00edmetro de impulsos mede o d\u00e9bito instant\u00e2neo, duas sondas DS18B20 leem a temperatura da \u00e1gua da rede e a do dep\u00f3sito de AQS, uma v\u00e1lvula motorizada de esfera corta a \u00e1gua a partir de dois rel\u00e9s e um sensor de humidade vigia o ch\u00e3o. O ESP32 exp\u00f5e tudo ao Home Assistant como sensores, switches e um bin\u00e1rio de alarme.<\/p>\n\n\n\n

      \n\t
    • 2<\/strong>Rel\u00e9s para a v\u00e1lvula motorizada (abre\/fecha)<\/span><\/li>\n\t
    • 2<\/strong>Sondas DS18B20 no mesmo barramento OneWire<\/span><\/li>\n\t
    • 1<\/strong>Caudal\u00edmetro de impulsos com integra\u00e7\u00e3o em L e m\u00b3<\/span><\/li>\n\t
    • 0<\/strong>Servi\u00e7os externos ou depend\u00eancia da nuvem<\/span><\/li>\n<\/ul>\n\n\n\n

      O resultado \u00e9 um sistema h\u00edbrido: a \u00e1gua continua a chegar normalmente, mas passas a ter hist\u00f3rico de consumo, temperatura da rede, temperatura do AQS e um bot\u00e3o de corte geral no telem\u00f3vel \u2014 mais um alarme que dispara se houver fuga.<\/p>\n\n\n\n

      Hardware e esquema de liga\u00e7\u00e3o<\/h2>\n\n\n\n

      Nada de ex\u00f3tico. Tudo cabe numa caixa de embutir junto ao quadro de entrada, alimentado por uma fonte de 5 V:<\/p>\n\n\n\n

        \n\t
      • Placa ESP32<\/strong> \u2014 o YAML usa board: esp32dev<\/code>. O ESP32 \u00e9 obrigat\u00f3rio aqui: o pulse_counter<\/code> exige um contador de hardware.<\/li>\n\t
      • Caudal\u00edmetro de impulsos<\/strong> (tipo YF-B1\/S201, ~396 impulsos\/litro) \u2014 entra no GPIO33 com pull-up.<\/li>\n\t
      • Duas sondas DS18B20<\/strong> \u2014 no barramento OneWire do GPIO4, uma na entrada da rede e outra no dep\u00f3sito de AQS.<\/li>\n\t
      • V\u00e1lvula motorizada de esfera<\/strong> com dois fios de comando (abre\/fecha), acionada por dois rel\u00e9s opto-isolados.<\/li>\n\t
      • Sensor de inunda\u00e7\u00e3o<\/strong> normalmente fechado \u2014 no GPIO26, com dispositivo moisture<\/code>.<\/li>\n\t
      • Buzzer\/ sirene de alarme<\/strong> \u2014 no GPIO27, pulsa em ciclo quando h\u00e1 fuga.<\/li>\n\t
      • Fonte de 5 V DC<\/strong>, caixa de embutir e cabo de liga\u00e7\u00e3o.<\/li>\n<\/ul>\n\n\n\n
        \"Esquema
        Liga\u00e7\u00e3o completa: ESP32 no centro, caudal\u00edmetro e sondas \u00e0 esquerda, rel\u00e9s e v\u00e1lvula \u00e0 direita<\/figcaption><\/figure>\n\n\n\n
        \n\t!<\/span>\n\t

        Nota de hardware:<\/strong> o caudal\u00edmetro trabalha tipicamente entre 3,3 V e 5 V, mas conv\u00e9m confirmar a tens\u00e3o de sa\u00edda do modelo que usares e, se for 5 V, colocar um divisor de tens\u00e3o ou um level shifter antes do GPIO33 \u2014 o ESP32 n\u00e3o tolera 5 V nas entradas.<\/p>\n\t

        Trabalha sempre com o quadro de \u00e1gua fechado e sem press\u00e3o<\/strong> durante a instala\u00e7\u00e3o da v\u00e1lvula. Se a v\u00e1lvula motorizada tiver tempos de curso pr\u00f3prios, respeita-os: n\u00e3o alimentes as duas bobinas em simult\u00e2neo.<\/p>\n<\/div>\n\n\n\n

        Mapeamento dos GPIO<\/h2>\n\n\n\n

        O YAML fixa todos os pinos, com coment\u00e1rios. \u00c9 este o mapa completo:<\/p>\n\n\n\n

        Sinal<\/th>GPIO<\/th>Dire\u00e7\u00e3o<\/th>Fun\u00e7\u00e3o<\/th><\/tr><\/thead>
        Barramento OneWire<\/strong><\/td>GPIO4<\/td>Barramento<\/td>Duas sondas DS18B20 (AQS + Rede)<\/td><\/tr>
        Caudal\u00edmetro<\/strong><\/td>GPIO33<\/td>Entrada (pull-up)<\/td>Impulsos de caudal, 396 imp\/L<\/td><\/tr>
        Abrir V\u00e1lvula<\/strong><\/td>GPIO32<\/td>Sa\u00edda \u2192 rel\u00e9<\/td>Rel\u00e9 relay1<\/code>, interlock com relay2<\/code><\/td><\/tr>
        Fechar V\u00e1lvula<\/strong><\/td>GPIO25<\/td>Sa\u00edda \u2192 rel\u00e9<\/td>Rel\u00e9 relay2<\/code>, interlock com relay1<\/code><\/td><\/tr>
        Alarme \/ Sirene<\/strong><\/td>GPIO27<\/td>Sa\u00edda \u2192 buzzer<\/td>Pulsa enquanto houver fuga<\/td><\/tr>
        Sensor de \u00c1gua<\/strong><\/td>GPIO26<\/td>Entrada (invertida)<\/td>Dete\u00e7\u00e3o de inunda\u00e7\u00e3o (moisture<\/code>)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

        Duas prote\u00e7\u00f5es merecem destaque. A primeira \u00e9 o interlock<\/strong>: os dois rel\u00e9s da v\u00e1lvula partilham o grupo interlock_group [relay1, relay2]<\/code>, pelo que \u00e9 imposs\u00edvel pedir \u00ababrir\u00bb e \u00abfechar\u00bb ao mesmo tempo \u2014 a v\u00e1lvula nunca fica com as duas bobinas energizadas. A segunda \u00e9 a invers\u00e3o<\/strong> do sensor de inunda\u00e7\u00e3o: o contacto \u00e9 normalmente fechado e s\u00f3 abre quando deteta \u00e1gua, por isso inverted: true<\/code> faz com que on<\/code> signifique exatamente \u00abh\u00e1 \u00e1gua no ch\u00e3o\u00bb.<\/p>\n\n\n\n

        \n\tOK<\/span>\n\t

        O sensor de inunda\u00e7\u00e3o tem filtros delayed_on: 100ms<\/code> e delayed_off: 100ms<\/code>. Sem isto, uma gota isolada ou uma vibra\u00e7\u00e3o no contacto dispararia o alarme. Com o filtro, s\u00f3 uma presen\u00e7a de \u00e1gua confirmada durante 100 ms \u00e9 publicada.<\/p>\n<\/div>\n\n\n\n

        O YAML, bloco a bloco<\/h2>\n\n\n\n

        O ficheiro SistemaAgua.yaml<\/code> est\u00e1 estruturado por blocos funcionais. Estes s\u00e3o os excertos que interessam, do caudal\u00edmetro \u00e0 v\u00e1lvula:<\/p>\n\n\n\n

        Caudal e consumo acumulado<\/h3>\n\n\n\n

        O pulse_counter<\/code> l\u00ea os impulsos do caudal\u00edmetro e divide-os pelo fator de calibra\u00e7\u00e3o (396 impulsos por litro, ou 6,6 impulsos por segundo a 1 L\/min, vezes 60). Dois sensores integration<\/code> derivam da\u00ed o total em litros e em metros c\u00fabicos:<\/p>\n\n\n

        sensor:\n  - platform: pulse_counter\n    pin:\n      number: 33<\/span>\n      mode:\n        input: true<\/span>\n        pullup: true<\/span>\n    unit_of_measurement: 'L\/min'<\/span>\n    accuracy_decimals: 2<\/span>\n    id: water_usage\n    name: \"Debito agua instantaneo\"<\/span>\n    update_interval: 5<\/span>s\n    filters:\n      - lambda: return<\/span> (x \/ 396<\/span>); # 396 = 6.6 * 60<\/span>\n\n  - platform: integration\n    name: \"Total em M3\"<\/span>\n    unit_of_measurement: 'm\u00b3'<\/span>\n    accuracy_decimals: 2<\/span>\n    sensor: water_usage\n    device_class: water\n    state_class: total_increasing\n    time_unit: min\n    filters:\n      - lambda: return<\/span> (x \/ 1000<\/span>);\n\n  - platform: integration\n    name: \"Utiliza\u00e7\u00e3o Total\"<\/span>\n    unit_of_measurement: 'L'<\/span>\n    accuracy_decimals: 2<\/span>\n    sensor: water_usage\n    state_class: total_increasing\n    device_class: water\n    time_unit: min<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
        Temperaturas com OneWire<\/h3>\n\n\n\n
        O barramento OneWire no GPIO4 serve duas sondas DS18B20, cada uma identificada pelo seu endere\u00e7o de 64 bits. Uma mede a \u00e1gua que vem da rede p\u00fablica, a outra a \u00e1gua quente do dep\u00f3sito de AQS. Cada sonda tem o seu pr\u00f3prio update_interval<\/code> \u2014 60 s chega para monitoriza\u00e7\u00e3o dom\u00e9stica.<\/p>\n\n\n
        one_wire:\n  - platform: gpio\n    pin: GPIO4\n\nsensor:\n  - platform: dallas_temp\n    address: 0x8400000139764228\n    name: Temperatura AQS\n    id: taqs\n    update_interval: 60s\n\n  - platform: dallas_temp\n    address: 0x90000001396C8F28\n    name: Temperatura Rede\n    id: tin\n    update_interval: 60s<\/code><\/span><\/pre>\n\n\n
        \n\ti<\/span>\n\t
        Endere\u00e7os das sondas:<\/strong> cada DS18B20 tem um endere\u00e7o \u00fanico gravado em f\u00e1brica, vis\u00edvel nos logs do ESPHome quando o barramento arranca. Substitui os valores 0x8400\u2026<\/code> e 0x9000\u2026<\/code> pelos das tuas sondas \u2014 se ficarem trocados, AQS e Rede aparecem invertidos no Home Assistant.<\/p>\n<\/div>\n\n\n\n
        V\u00e1lvula de corte com interlock<\/h3>\n\n\n\n
        A v\u00e1lvula motorizada de esfera tem dois fios de comando. Dois rel\u00e9s bastam: um d\u00e1 o pulso de abertura, o outro o de fecho. O interlock<\/strong> impede que ambos estejam ativos ao mesmo tempo, protegendo o motor da v\u00e1lvula:<\/p>\n\n\n
        switch<\/span>:\n  - platform: gpio\n    pin<\/span>: GPIO32\n    name<\/span>: \"Abrir Valvula\"<\/span>\n    id<\/span>: relay1\n    interlock<\/span>: &interlock_group [relay1, relay2]\n\n  - platform: gpio\n    pin<\/span>: GPIO25\n    name<\/span>: \"Fechar Valvula\"<\/span>\n    id<\/span>: relay2\n    interlock<\/span>: *interlock_group<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
        \n\tOK<\/span>\n\t
        Se a v\u00e1lvula for do tipo on\/off<\/em> simples (s\u00f3 corta ou d\u00e1 passagem, sem posi\u00e7\u00f5es interm\u00e9dias), podes ligar apenas um rel\u00e9 e usar o outro como reserva. O interlock continua a fazer sentido para nunca deixares os dois contactos fechados em simult\u00e2neo.<\/p>\n<\/div>\n\n\n\n
        Alarme de inunda\u00e7\u00e3o<\/h3>\n\n\n\n
        O sensor de humidade \u00e9 um bin\u00e1rio normalmente fechado: em condi\u00e7\u00f5es normais est\u00e1 on<\/code>; quando deteta \u00e1gua, abre. Com inverted: true<\/code>, o Home Assistant passa a ver on<\/code> exatamente quando h\u00e1 fuga \u2014 e o automa\u00e7\u00e3o local dispara a sirene em ciclo, alternando entre on<\/code> e off<\/code> para chamar a aten\u00e7\u00e3o sem ficar sempre a apitar:<\/p>\n\n\n
        switch<\/span>:\n  - platform: gpio\n    pin<\/span>: GPIO27\n    name<\/span>: \"Alarme Inunda\u00e7\u00e3o\"<\/span>\n    id<\/span>: buzinunda\n\nbinary_sensor<\/span>:\n  - platform: gpio\n    pin<\/span>:\n      number: GPIO26\n      inverted<\/span>: true<\/span>\n    name<\/span>: \"Sensor \u00c1gua\"<\/span>\n    device_class<\/span>: moisture\n    id<\/span>: leak\n    filters<\/span>:\n      - delayed_on: 100<\/span>ms\n      - delayed_off: 100<\/span>ms\n    on_press<\/span>:\n      - while<\/span>:\n          condition:\n            binary_sensor.is_on: leak\n          then<\/span>:\n            - switch<\/span>.turn_on: buzinunda\n            - delay: 200<\/span>ms\n            - switch<\/span>.turn_off: buzinunda\n            - delay: 100<\/span>ms\n            - switch<\/span>.turn_on: buzinunda\n            - delay: 200<\/span>ms\n            - switch<\/span>.turn_off: buzinunda\n            - delay: 400<\/span>ms\n    on_release<\/span>:\n      then:\n        - switch<\/span>.turn_off: buzinunda<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
        \n\ti<\/span>\n\t
        Porque \u00e9 que o buzzer pulsa em vez de ficar fixo?<\/strong> Um sinal intermitente \u00e9 mais f\u00e1cil de localizar numa casa grande do que um zumbido cont\u00ednuo, e evita que o buzzer aque\u00e7a se a fuga demorar a ser resolvida. O ciclo 200\/100\/200\/400 ms<\/code> repete-se enquanto o sensor estiver ativo.<\/p>\n<\/div>\n\n\n\n
        Caudal e consumo acumulado<\/h2>\n\n\n\n
        O caudal\u00edmetro usado neste projeto \u00e9 do tipo mais comum nos kits de automa\u00e7\u00e3o: um rotor com \u00edm\u00e3 que gera impulsos proporcionais ao caudal. O fator de calibra\u00e7\u00e3o t\u00edpico \u00e9 6,6 impulsos por segundo por litro\/minuto<\/strong>, ou seja, 396 impulsos por litro. Da\u00ed a f\u00f3rmula x \/ 396<\/code> no filtro do pulse_counter<\/code>.<\/p>\n\n\n\n
        Se o teu modelo tiver um fator diferente (encontra-se muitas vezes no datasheet ou medido com um recipiente graduado), basta substituir 396<\/code> pelo valor correto. A precis\u00e3o do sistema depende inteiramente deste n\u00famero.<\/p>\n\n\n\n
        Os dois sensores de integra\u00e7\u00e3o d\u00e3o-te duas leituras complementares: Utiliza\u00e7\u00e3o Total<\/strong> em litros (\u00fatil para automa\u00e7\u00f5es que comparam consumos di\u00e1rios) e Total em M3<\/strong> em metros c\u00fabicos (\u00fatil para acompanhar a fatura da \u00e1gua). Ambos t\u00eam state_class: total_increasing<\/code>, o que faz o Home Assistant gerar estat\u00edsticas de longo prazo automaticamente.<\/p>\n\n\n\n
        Temperaturas com OneWire<\/h2>\n\n\n\n
        As duas DS18B20 partilham um \u00fanico pino (GPIO4) porque o OneWire \u00e9 um barramento multi-drop: cada sonda responde ao seu endere\u00e7o \u00fanico, e o ESPHome distingue-as sem precisar de pinos separados. Isso simplifica muito a cablagem dentro da caixa de embutir.<\/p>\n\n\n\n
        As aplica\u00e7\u00f5es pr\u00e1ticas s\u00e3o diretas: comparar a temperatura da rede com a do AQS permite ver se o dep\u00f3sito est\u00e1 a ser aquecido corretamente, se o consumo de \u00e1gua quente est\u00e1 a arrefecer o acumulador mais depressa do que o habitual, ou se a \u00e1gua da rede vem anormalmente fria (o que aumenta o trabalho da bomba de calor).<\/p>\n\n\n\n
        V\u00e1lvula de corte com interlock<\/h2>\n\n\n\n
        A v\u00e1lvula motorizada de esfera \u00e9 o atuador central do sistema. Ao contr\u00e1rio de um rel\u00e9 simples, precisa de um pulso de comando<\/strong> para mudar de posi\u00e7\u00e3o: uma bobina faz rodar o motor num sentido (abrir), a outra no sentido oposto (fechar). O interlock do ESPHome garante que os dois rel\u00e9s nunca est\u00e3o fechados ao mesmo tempo \u2014 o que, na pr\u00e1tica, queimaria o motor da v\u00e1lvula em segundos.<\/p>\n\n\n\n
        No Home Assistant, os dois switches aparecem como entidades separadas. Podes us\u00e1-los em automa\u00e7\u00f5es de corte geral (fecha a v\u00e1lvula quando sais de casa), em rotinas de f\u00e9rias, ou em conjunto com o sensor de inunda\u00e7\u00e3o para um corte autom\u00e1tico de emerg\u00eancia.<\/p>\n\n\n\n
        \n\tOK<\/span>\n\t
        Se a tua v\u00e1lvula tiver tempos de curso longos (10\u201320 s), adiciona um on_turn_on<\/code> com delay<\/code> e switch.turn_off<\/code> em cada rel\u00e9, \u00e0 imagem do que se faz no port\u00e3o. Assim o motor nunca fica energizado depois de a v\u00e1lvula chegar ao fim de curso.<\/p>\n<\/div>\n\n\n\n
        Alarme de inunda\u00e7\u00e3o<\/h2>\n\n\n\n
        O sensor de humidade \u00e9 o elemento de seguran\u00e7a do sistema. Fica no ch\u00e3o, junto ao quadro de entrada ou debaixo do dep\u00f3sito de AQS, e deteta a presen\u00e7a de \u00e1gua por condutividade entre dois contactos. O ESPHome exp\u00f5e-no como binary_sensor<\/code> com device_class: moisture<\/code>, o que faz o Home Assistant mostrar o \u00edcone e a cor corretos.<\/p>\n\n\n\n
        Quando o sensor dispara, o buzzer local entra em ciclo intermitente. Esse comportamento \u00e9 definido diretamente no YAML, sem depender do Home Assistant \u2014 o alarme funciona mesmo se a rede Wi-Fi ou o HA estiverem em baixo. No Home Assistant, o bin\u00e1rio fica dispon\u00edvel para notifica\u00e7\u00f5es push, corte autom\u00e1tico da v\u00e1lvula ou registo hist\u00f3rico de eventos.<\/p>\n\n\n\n
        Rede, gest\u00e3o e atualiza\u00e7\u00f5es<\/h2>\n\n\n\n
        A parte de rede segue o padr\u00e3o do projeto do port\u00e3o: nada depende de um servidor de fabricante. O SistemaAgua.yaml<\/code> garante:<\/p>\n\n\n\n
          \n\t
        • IP est\u00e1tico<\/strong> \u2014 o dispositivo vive sempre em 192.168.1.231<\/code>, com gateway e DNS em 192.168.1.254<\/code>.<\/li>\n\t
        • Rede Wi-Fi<\/strong> \u2014 SF_24G<\/code> com as defini\u00e7\u00f5es est\u00e1ticas; se precisares de redund\u00e2ncia, acrescenta redes adicionais como no port\u00e3o.<\/li>\n\t
        • Access Point de emerg\u00eancia<\/strong> \u2014 com ap: {}<\/code> e captive_portal<\/code>, o dispositivo abre o seu pr\u00f3prio Wi-Fi para reconfigura\u00e7\u00e3o.<\/li>\n\t
        • Improv Serial<\/strong> \u2014 provisionamento de Wi-Fi pela porta s\u00e9rie.<\/li>\n\t
        • OTA<\/strong> \u2014 atualiza\u00e7\u00f5es de firmware sem cabo.<\/li>\n\t
        • Web Server<\/strong> \u2014 interface local de consulta e logs.<\/li>\n\t
        • API nativo<\/strong> \u2014 liga\u00e7\u00e3o direta ao Home Assistant, sem MQTT.<\/li>\n<\/ul>\n\n\n
          wifi<\/span>:\n  ap<\/span>: {}\n  ssid<\/span>: SF_24G<\/span>\n  password<\/span>: \"\u2022\u2022\u2022\u2022\u2022\u2022\u2022\u2022\"\n  manual_ip<\/span>:\n    static_ip<\/span>: 192.168<\/span>.1<\/span>.231<\/span>\n    gateway<\/span>: 192.168<\/span>.1<\/span>.254<\/span>\n    subnet<\/span>: 255.255<\/span>.255<\/span>.0<\/span>\n    dns1<\/span>: 192.168<\/span>.1<\/span>.254<\/span>\n\ncaptive_portal<\/span>:\n\nimprov_serial<\/span>:\n\nota<\/span>:\n  -<\/span> platform<\/span>: esphome<\/span>\n\nweb_server<\/span>:<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
          \n\t!<\/span>\n\t
          Antes de publicar o YAML:<\/strong> as palavras-passe do Wi-Fi ficam em texto no ficheiro \u2014 mant\u00e9m o SistemaAgua.yaml<\/code> fora de reposit\u00f3rios p\u00fablicos. Recomenda-se ainda definir api: encryption_key<\/code> para cifrar a liga\u00e7\u00e3o ao Home Assistant e ota: password<\/code> para proteger as atualiza\u00e7\u00f5es. Com IP est\u00e1tico, reserva tamb\u00e9m o endere\u00e7o no router.<\/p>\n<\/div>\n\n\n\n
          Instala\u00e7\u00e3o passo a passo<\/h2>\n\n\n\n
          Do ficheiro em branco ao sistema operacional, em sete passos:<\/p>\n\n\n\n
            \n\t
          1. Liga a fia\u00e7\u00e3o em bancada.<\/strong> Monta ESP32 + caudal\u00edmetro + as duas DS18B20 + sensor de inunda\u00e7\u00e3o numa protoboard e confirma que todos os sensores respondem nos logs do ESPHome.<\/li>\n\t
          2. Descobre os endere\u00e7os das sondas.<\/strong> No arranque, o ESPHome lista os endere\u00e7os OneWire encontrados. Copia-os para o YAML nos campos address<\/code>.<\/li>\n\t
          3. Calibra o caudal\u00edmetro.<\/strong> Deixa correr 10 L de \u00e1gua por um recipiente graduado e compara com o total lido no Home Assistant. Ajusta o fator 396<\/code> se houver desvio.<\/li>\n\t
          4. Grava o firmware.<\/strong> Importa SistemaAgua.yaml<\/code> no ESPHome, corrige as credenciais Wi-Fi e envia via OTA ou USB.<\/li>\n\t
          5. Adiciona ao Home Assistant.<\/strong> O dispositivo aparece em Dispositivos & Servi\u00e7os<\/em>; aceita a liga\u00e7\u00e3o API e as entidades ficam dispon\u00edveis.<\/li>\n\t
          6. Instala no quadro de \u00e1gua.<\/strong> Com o quadro fechado e sem press\u00e3o, monta a v\u00e1lvula motorizada, o caudal\u00edmetro, as sondas e o sensor de inunda\u00e7\u00e3o no ch\u00e3o.<\/li>\n\t
          7. Monta o dashboard e as automa\u00e7\u00f5es.<\/strong> Adiciona os sensores de caudal e temperatura, os dois switches da v\u00e1lvula e o bin\u00e1rio de inunda\u00e7\u00e3o ao painel; cria as automa\u00e7\u00f5es de corte e de alerta.<\/li>\n<\/ol>\n\n\n\n
            No Home Assistant<\/h2>\n\n\n\n
            Depois de pareado, o dispositivo cria um conjunto de entidades pronto a usar. \u00c9 no dashboard que o sistema ganha vida:<\/p>\n\n\n\n
            \n\n\t
            \n\t\t01<\/span>\n\t\t
            Consumo em tempo real<\/h3>\n\t\t
            O sensor D\u00e9bito \u00e1gua instant\u00e2neo<\/strong> mostra o caudal em L\/min, e os totais em litros e m\u00b3 acumulam para estat\u00edsticas de longo prazo \u2014 ideais para gr\u00e1ficos di\u00e1rios, semanais e mensais.<\/p>\n\t<\/div>\n\n\t
            \n\t\t02<\/span>\n\t\t
            Temperaturas AQS e Rede<\/h3>\n\t\t
            As duas DS18B20 aparecem como sensores de temperatura independentes, prontos para gr\u00e1ficos de evolu\u00e7\u00e3o e para automa\u00e7\u00f5es (por exemplo, avisar se o AQS desce abaixo de 40 \u00b0C).<\/p>\n\t<\/div>\n\n\t
            \n\t\t03<\/span>\n\t\t
            Corte geral da \u00e1gua<\/h3>\n\t\t
            Os switches Abrir V\u00e1lvula<\/strong> e Fechar V\u00e1lvula<\/strong> permitem cortar a \u00e1gua da casa a partir do telem\u00f3vel, do Voice Assist ou de uma automa\u00e7\u00e3o de aus\u00eancia.<\/p>\n\t<\/div>\n\n\t
            \n\t\t04<\/span>\n\t\t
            Alarme de inunda\u00e7\u00e3o<\/h3>\n\t\t
            O bin\u00e1rio Sensor \u00c1gua<\/strong> dispara o buzzer local e pode acionar notifica\u00e7\u00f5es push, corte autom\u00e1tico da v\u00e1lvula e registo hist\u00f3rico de eventos.<\/p>\n\t<\/div>\n\n<\/div>\n\n\n\n
            Automa\u00e7\u00f5es que valem a pena<\/h3>\n\n\n\n
            Com os sensores e a v\u00e1lvula expostos, qualquer automa\u00e7\u00e3o \u00e9 poss\u00edvel. Estas tr\u00eas s\u00e3o as mais \u00fateis no dia a dia:<\/p>\n\n\n\n