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 num sensor de movimento Wi-Fi privado e local.
Quando alguém se move numa 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âmara, 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 open-source que reúne firmware pronto a gravar, um SDK C++ integrável, uma implementação MicroPython, ferramentas de browser, uma CLI de host, um conjunto de dados aberto, pesos de modelos abertos e o fluxo de trabalho de investigação usado para construir e validar os detetores.
Gravar a partir do browser · Ver as ferramentas ao vivo · Ler a documentação · Explorar o SDK
Use o ESPectre para acender luzes ou um ecrã quando alguém entra, ajustar o aquecimento quando uma sala está ocupada, ou enviar um alerta quando há movimento onde não deveria haver ninguém. Funciona com o Home Assistant (através do ESPHome ou MQTT), aparece como um sensor de ocupação Matter padrão, oferece uma API HTTP local e pode ser integrado no seu próprio firmware ESP32 com o SDK C++.
Tudo corre no dispositivo: mede o canal Wi-Fi (channel state information, ou CSI) e reporta movimento e uma pontuação de movimento. Nada precisa de ir para a cloud. Uma placa cobre uma área, por isso conte com uma placa por sala.
O ESPectre deteta alterações no ambiente de rádio. Não identifica pessoas, não as conta, não prova que uma sala está vazia, nem substitui um sistema de segurança, médico ou de emergência certificado para esse efeito.
| Caminho | Melhor para | Comece aqui |
|---|---|---|
| Native | Sensores autónomos, integrações MQTT, incluindo Home Assistant MQTT Discovery, e aplicações personalizadas | Frontend Native |
| ESPHome | Utilizadores do Home Assistant que querem entidades nativas, aprovisionamento ESPHome e atualizações via Device Builder | Frontend ESPHome |
| Matter | Controladores Matter com suporte para sensores de ocupação; a validação de controladores ainda é limitada | Frontend Matter |
| Micro-ESPectre | Deteção leve em MicroPython com monitorização Direct HTTP local e só de leitura | README do Micro-ESPectre |
A forma mais rápida precisa apenas de um browser. Use o Chrome 151 ou posterior no desktop; o Edge consegue gravar, mas as Device settings e o Monitor podem não funcionar nele.
Para encontrar os seus dispositivos na rede, use Find devices nas ferramentas de browser ou ./espectre devices. Consulte a referência de descoberta para requisitos e limites.
Estado do Matter: o suporte Matter ainda está a ser 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 a 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