Montar uma casa inteligente é um processo iterativo — você começa com dois dispositivos e acaba com quarenta. O problema é que depois de dois anos acumulando equipamentos, roteadores e automações, muito pouco está documentado. Você esquece onde instalou o hub Zigbee, qual senha o Home Assistant está usando, qual versão de firmware tem a câmera da garagem, ou o que acontece se o modem reiniciar. Documentar a smart home não é burocracia — é o que transforma uma coleção de dispositivos em um sistema que outra pessoa pode entender (ou que você mesmo vai agradecer daqui a 18 meses).
O que documentar e por quê
Mapa de dispositivos por cômodo: Uma lista simples com nome do dispositivo, marca, modelo, localização física, protocolo (Wi-Fi, Zigbee, Z-Wave) e a plataforma que o controla. Quando um sensor para de funcionar, você sabe exatamente o que é, onde está e como diagnosticar.
Topologia de rede: Quais hubs e bridges existem, onde estão fisicamente, o endereço IP fixo de cada um (configure IPs estáticos), a senha do Wi-Fi de dispositivos e o nome das redes. Quando o roteador é trocado ou o IP muda, você sabe o que vai quebrar e como corrigir.
Credenciais e logins: Usuário e senha de cada plataforma (WordPress, Home Assistant, app de cada marca), token de APIs usadas (Telegram bot, IFTTT, etc.), e chaves de aplicação do WordPress se você usar automação de conteúdo. Guarde isso em um gerenciador de senhas, não num arquivo txt na área de trabalho.
Automações ativas e o que fazem: Uma lista das rotinas configuradas com uma linha descrevendo o trigger e a ação. “Rotina Chegada: geofencing < 200m → luzes sala 80% + AC 24°C + música ambiente." Quando algo para de funcionar, você sabe o que deveria estar acontecendo.
Formatos práticos para documentar
Notion ou Obsidian: Ideais para criar um “wiki da casa” com páginas por cômodo, links entre dispositivos e automações, e histórico de manutenção. O Notion tem templates prontos para inventário de dispositivos. O Obsidian é local-first, sem dependência de nuvem.
Planilha simples: Para quem não quer aprender nova ferramenta — uma planilha com abas por categoria (dispositivos, redes, credenciais, automações) resolve 80% do problema com zero curva de aprendizado.
Home Assistant Dashboard de documentação: Para quem usa HA, um painel de “sobre a casa” com as informações técnicas acessíveis direto na interface de automação é a documentação mais próxima de onde você vai precisar dela.
Planta baixa com dispositivos marcados
Uma imagem da planta da casa (pode ser um esboço feito no Google Slides ou Canva) com os dispositivos marcados por tipo é mais útil do que qualquer lista quando você precisa entender a cobertura de uma câmera, a posição de um sensor de presença ou por que o sinal Zigbee não chega num cômodo específico. Não precisa ser bonita — precisa estar atualizada.
Manutenção da documentação
A documentação que não é atualizada é pior que nenhuma documentação — você consulta informação errada e perde tempo. A forma mais simples de mantê-la atual é ter uma rotina mensal de 15 minutos: verificar se houve mudanças, atualizar o que mudou, e testar se as automações críticas ainda funcionam. Coloque no calendário como tarefa recorrente.
Para entender como o Home Assistant organiza a gestão de dispositivos, veja Home Assistant: guia completo para começar. Para criar um inventário de dispositivos Zigbee, confira Zigbee: o que é e por que usar na casa inteligente.
Fonte: O Home Assistant Docs tem a estrutura de configuração em YAML e o sistema de etiquetas (labels) para organização de dispositivos — base para quem quer documentar diretamente na plataforma.
