francescopace/espectreESPectre - Sistema de detecção de movimento baseado na análise do espectro Wi-Fi (CSI), com integração com o Home Assistant.
Transforme um ESP32 em um sensor de movimento Wi-Fi privado e local.
Quando alguém se move por uma sala, altera a forma como os sinais Wi-Fi se propagam por ela. O ESPectre lê essas alterações e reporta movimento em tempo real. Sem câmera, sem microfone, sem dispositivo vestível e sem hardware de radar dedicado: apenas um ESP32 compatível e a rede Wi-Fi já presente na sala.
O ESPectre é uma plataforma de código aberto que reúne firmware pronto para gravação, um SDK C++ incorporável, uma implementação em MicroPython, ferramentas de navegador, uma CLI de host, um conjunto de dados aberto, pesos de modelo abertos e o fluxo de trabalho de pesquisa usado para construir e validar os detectores.
Grave pelo seu navegador · Veja as ferramentas ao vivo · Leia a documentação · Explore o SDK
Use o ESPectre para acender luzes ou um display quando alguém entrar, ajustar o aquecimento quando uma sala estiver em uso, ou enviar um alerta quando houver movimento onde ninguém deveria estar. Ele funciona com o Home Assistant (por meio do ESPHome ou MQTT), aparece como um sensor de ocupação Matter padrão, oferece uma API HTTP local e pode ser integrado ao seu próprio firmware ESP32 com o SDK C++.
Tudo roda no dispositivo: ele mede o canal Wi-Fi (channel state information, ou CSI) e reporta movimento e uma pontuação de movimentação. Nada precisa ir para a nuvem. Uma placa cobre uma área, então planeje uma placa por sala.
O ESPectre detecta alterações no ambiente de rádio. Ele não identifica pessoas, não as conta, não comprova que uma sala está vazia nem substitui um sistema de segurança, médico ou de emergência certificado para segurança.
| Caminho | Melhor para | Comece aqui |
|---|---|---|
| Native | Sensores autônomos, integrações MQTT, incluindo Home Assistant MQTT Discovery, e aplicações personalizadas | Frontend Native |
| ESPHome | Usuários do Home Assistant que querem entidades nativas, provisionamento via ESPHome e atualizações pelo Device Builder | Frontend ESPHome |
| Matter | Controladores Matter com suporte a sensor de ocupação; a validação de controladores ainda é limitada | Frontend Matter |
| Micro-ESPectre | Sensoriamento leve em MicroPython com monitoramento Direct HTTP local e somente leitura | README do Micro-ESPectre |
O caminho mais rápido precisa apenas de um navegador. Use o Chrome para desktop 151 ou posterior; o Edge consegue gravar, mas Device settings e Monitor podem não funcionar nele.
Para encontrar seus dispositivos na rede, use Find devices nas ferramentas de navegador ou ./espectre devices. Consulte a referência de descoberta para requisitos e limites.
Status do Matter: o suporte a Matter ainda está sendo testado com os diferentes ecossistemas de controladores. Um controlador que suporta sensores de ocupação pode ainda não ter sido testado com o ESPectre. Consulte Compatibilidade de controladores Matter para a matriz atual.
Para compilar e gravar a partir deste repositório, comece pelo guia de configuração. Para ver todos os comandos disponíveis, execute:
./espectre --help