Sobre o projeto

PadSpan HA é uma integração do Home Assistant que fornece rastreamento de presença por sala via Bluetooth Low Energy (BLE), indo além da simples detecção de casa/fora. Ele atualiza as localizações dos dispositivos a cada 5 segundos e oferece plantas interativas, visualizações 3D de vários andares, um sistema completo de calibração e 19 visualizações dedicadas. Os principais recursos incluem: - **Rastreamento de Presença**: Rastreamento por sala com suavização RSSI filtrada por Kalman, detecção de casa/fora, modo de acompanhamento com alertas por e-mail e rastreamento simultâneo de vários dispositivos. - **Identidade do Dispositivo**: Identidade estável do dispositivo (padspan_id) que sobrevive à rotação de MAC e a mudanças de UUID do iBeacon, com resolução O(1) a partir de chaves voláteis. - **Plantas e Mapas**: Faça upload de plantas arquitetônicas, desenhe limites de salas, posicione scanners e visualize mapas 2D/3D com zoom/pan. - **Calibração**: Coleta de fingerprint por caminhada, correspondência k-NN, ajuste de path-loss por OLS, mapas de calor de cobertura e validação cruzada. - **Inteligência Multi-Andar**: Aprendizado de transição de andar, atenuação entre andares e penalidades externas. - **Rastreamento de Telefone e Relógio**: Configuração guiada para Android (iBeacon do HA Companion App), iPhone/iPad/Apple Watch (IRK via irk-capture), Tile/Chipolo (automático), AirTag/SmartTag (probabilístico via MAC Rotation Bridging). - **Gerenciamento de Scanners**: Descoberta automática de proxies Bluetooth do HA, proxies Bermuda e nós ESPresense via MQTT; testado com mais de 20 placas ESP32. - **Alertas e Automação**: Alertas por e-mail, entidades do HA (sensores de área, sensores de distância, rastreadores de dispositivos, sensores binários) e API WebSocket. - **Análises**: Insights (tempo na sala, contagens de entrada), Busy Times (ocupação da sala por hora) e Locate (orientação). - **Atlas Device Map**: Posicione e controle dispositivos reais (luzes, fechaduras, sensores) em um mapa isométrico, com controle WLED, portas/janelas como barreiras de RF e efeitos visuais Automorph. - **UI e Experiência**: Painel imersivo Pure Live, 19 visualizações, assistente de integração, hub de treinamento com 16 tutoriais, modo de exemplo e 11 idiomas. Edições: PadSpan HA (gratuito, GPL v3), PadSpan Pro (chave de licença desbloqueia recursos restritos), PadSpan Bright (listagem HACS separada e mais leve apenas para o Atlas), PadSpan Bright Pro. Instalação via HACS ou manual. Requer Home Assistant 2024.1+ e pelo menos um scanner BLE. Inclui relatório de uso opcional com controles de privacidade.