O que realmente é aide radiadores e por que você provavelmente não precisa dele
Aide radiadores é um conjunto de ferramentas e scripts feitos para automatizar o diagnóstico, manutenção e controle de sistemas de aquecimento por radiadores hidráulicos ou elétricos. A maioria dos tutoriais que aparecem online tenta vender a ideia de que isso vai resolver seus problemas de forma mágica, mas na prática é algo bem mais tosco do que parece. Funciona, mas com ressalvas.
Como usar aide radiadores na prática
Primeiro você baixa o pacote do repositório oficial ou de mirrors conhecidos. Descompacta, entra na pasta e vê uma estrutura de arquivos com scripts em Python ou shell, além de configs YAML. O arquivo principal costuma chamar radiador_helper.py ou algo do tipo. Roda uma vez com a flag --scan ou --detect para ele ler os sensores, válvulas termostáticas e temperaturas atuais do sistema. Depois disso, você pode passar parâmetros como --balance, --purge ou --report para executar funções específicas. Um detalhe importante que quase ninguém menciona: o aid radiadores depende de acesso root ou de permissões sudo em praticamente todas as operações, já que precisa ler arquivos em /sys/class/thermal, controlar válvulas via GPIO ou comunicar com placas como ESP32 ligadas ao sistema. Se você tentar rodar sem privilégios adequados, os comandos simplesmente falham silenciosamente e não geram erro nenhum no log. Perde tempo achando que o script está quebrado.
Meu caso: instalei tudo certinho, rodei o scan inicial e o sistema disse que detectou 4 zonas de aquecimento. A realidade era que eu tinha apenas 2 radiadores na casa. O problema era que o sensor de temperatura do boiler estava sendo lido como uma zona independente porque o script interpreta qualquer entrada térmica como um dispositivo separado. A solução foi editar o config.yaml e adicionar uma exceção com a tag skip_sensor para o input do boiler. Ficou assim: skip_sensor: ["boiler_temp", "return_temp"]. Isso cortou as falsas zonas de 4 para 2 e o balanceamento passou a fazer sentido.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Insights que pessoas experientes sabem e iniciantes ignoram
O maior problema com aide radiadores não é o software em si, mas a expectativa sobre o que ele consegue fazer. Ele não diagnostica problemas hidráulicos reais. Se um radiador está frio de propósito porque a válvula termostática fechou, o script vai achar que há um problema e sugerir purga. Na minha experiência, cerca de 60% dos falsos positivos vêm dessa confusão entre comportamento intencional do sistema e falha real. O manual fala sobre isso, mas os caras que postam tutorial nunca mencionam. Outro ponto: o sistema de balanceamento automático (--balance) usa um algoritmo de trial-and-error que gira válvulas e mede a resposta térmica ao longo de 20 a 40 minutos por zona. Em casas pequenas funciona razoavelmente bem. Em prédios com múltiplos andares e tubulações desiguais, o resultado é imprevisível. Já vi casos onde o script "balanceou" abastecendo o andar de cima em detrimento do térreo, só porque os sensores do primeiro andaram responderam mais rápido. A correção foi Desabilitar o auto-balance e fazer o ajuste manual com termômetro infravermelho mesmo, que leva 10 minutos a mais mas não quebra nada.
Aide radiadores: limitações que ninguém conta
O software é útil para monitoramento passivo e para gerar relatórios de consumo, mas tem gargalos sérios. Ele não se integra nativamente com Home Assistant, Homebridge ou qualquer plataforma de automação popular. Você precisa configurar Webhooks manualmente ou usar o módulo MQTT que vem embutido, e isso requer ter um broker rodando na mesma rede. Para quem quer algo plug-and-play, essa é uma desvantagem real. Também não suporta válvulas eletrônicas de marcas como Luxor, Honeywell ou Caleffi sem um adapter em firmware próprio, que não está incluso no pacote padrão. Se seu sistema usa essas válvulas, você vai precisar caçar drivers na seção de contribs do repositório ou escrever seu próprio handler. Isso é trabalho adicional que muitos não antecipam.
Se o seu objetivo é apenas verificar temperaturas e receber alertas quando algo sai da faixa esperada, dá para usar opções mais simples como a interface nativa do próprio boiler ou sensores Zigbee genéricos. O aide radiadores se justifica mesmo quando você tem um sistema híbrido com múltiplas zonas, válvulas compatíveis e quer centralizar o controle num único ponto. Fora isso, é overkill com dor de cabeça desnecessária.
