Repolode
Enviar
francescopace

francescopace/espectre

Transforma um ESP32 em um sensor de movimento Wi-Fi local e privado, que detecta movimentos por meio de alterações nos sinais Wi-Fi, sem câmera nem microfone.

Ver no GitHubSite
Estrelas
9,665
Forks
733
Issues abertas
14
Último commit
anteontem

O que é?

O ESPectre funciona em placas ESP32 compatíveis e lê informações de estado do canal (CSI) dos sinais Wi-Fi já presentes no ambiente. Quando alguém se movimenta, os caminhos do sinal mudam, e o dispositivo informa a presença de movimento e uma pontuação de movimentação em tempo real. O processamento ocorre no próprio dispositivo, sem necessidade de serviço na nuvem, e não são necessários câmera, microfone, dispositivo vestível ou hardware de radar.

O projeto oferece várias opções de firmware: um frontend Native com MQTT e Home Assistant MQTT Discovery, um frontend ESPHome, um frontend de sensor de ocupação Matter e uma implementação em MicroPython chamada Micro-ESPectre. Também inclui um SDK C++ incorporável, uma API HTTP local, ferramentas de gravação de firmware e monitoramento no navegador e uma CLI para gerenciar dispositivos.

O repositório publica um conjunto de dados CSI, pesos de modelos treinados, um registro de recursos com experimentos testados e descartados e relatórios de desempenho. O ESPectre detecta apenas alterações no ambiente de radiofrequência; não identifica nem conta pessoas. O código é licenciado sob GPLv3, e há uma licença comercial disponível para partes elegíveis.

Recursos principais

  • 01Detecta movimento a partir de CSI de Wi-Fi em placas ESP32-C6, C5, C3, S3, S2 e ESP32 clássico.
  • 02Funciona inteiramente no dispositivo, sem exigir conexão com a nuvem.
  • 03Integra-se ao Home Assistant por meio do ESPHome ou MQTT e aparece como um sensor de ocupação Matter.
  • 04Oferece uma API HTTP local e um SDK C++ incorporável para firmware personalizado.
  • 05Inclui ferramentas no navegador para gravar firmware, configurar dispositivos e monitorar a atividade ao vivo.

Casos de uso

  • Acender luzes ou ligar uma tela quando alguém entra em um ambiente.
  • Ajustar o aquecimento conforme o uso do ambiente.
  • Enviar um alerta ao detectar movimento em uma área que deveria estar vazia.
  • Adicionar detecção de presença a uma configuração do Home Assistant sem usar câmeras.

Início rápido

  1. 1

    Abra a ferramenta Flash no Chrome ou Edge para computador

  2. 2

    Conecte um ESP32 compatível via USB, escolha o firmware e conclua a configuração do Wi-Fi

  3. 3

    Abra Monitor para acompanhar o movimento e ajustar a detecção

Antes de usar

  • É necessária uma placa ESP32 compatível e uma rede Wi-Fi 4 de 2,4 GHz; planeje uma placa por cômodo.
  • A compatibilidade com controladores Matter ainda é limitada e não foi totalmente testada.
  • O copyleft da GPLv3 se aplica; portanto, firmware de código fechado requer uma licença comercial separada.

Tópicos

#wifi-sensing#esp32#motion-detection#home-assistant#iot#embedded#matter#esphome#csi#diy

Perguntas frequentes

O que é espectre?
Transforma um ESP32 em um sensor de movimento Wi-Fi local e privado, que detecta movimentos por meio de alterações nos sinais Wi-Fi, sem câmera nem microfone. O ESPectre funciona em placas ESP32 compatíveis e lê informações de estado do canal (CSI) dos sinais Wi-Fi já presentes no ambiente. Quando alguém se movimenta, os caminhos do sinal mudam, e o dispositivo informa a presença de movimento e uma pontuação de movimentação em tempo real. O processamento ocorre no próprio dispositivo, sem necessidade de serviço na nuvem, e não são necessários câmera, microfone, dispositivo vestível ou hardware de radar.
espectre é gratuito? Qual é a licença?
espectre é open source sob a licença GPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
espectre ainda é mantido?
Manutenção ativa. O último commit de espectre foi em 19 de out. de 2026.
Para que posso usar espectre?
Acender luzes ou ligar uma tela quando alguém entra em um ambiente. Ajustar o aquecimento conforme o uso do ambiente. Enviar um alerta ao detectar movimento em uma área que deveria estar vazia. Adicionar detecção de presença a uma configuração do Home Assistant sem usar câmeras.
Como instalar espectre?
Abra a ferramenta Flash no Chrome ou Edge para computador Conecte um ESP32 compatível via USB, escolha o firmware e conclua a configuração do Wi-Fi Abra Monitor para acompanhar o movimento e ajustar a detecção
Onde consigo espectre?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/francescopace/espectre

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados