Voltar às atualizações
New releaseAug 18, 2026

espectre snapshot-dev

ESPectre - Sistema de detecção de movimento baseado na análise do espectro Wi-Fi (CSI), com integração com o Home Assistant.

Compartilhar

Componente ESP-IDF Biblioteca Arduino Cobertura C++ Cobertura Python Cobertura Web

ESPectre Logotipo do ESPectre

Transforme um ESP32 em um sensor de movimento Wi-Fi privado e local.

Quando alguém se move por um ambiente, altera a forma como os sinais de Wi-Fi se propagam por ele. 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 que já está no ambiente.

O ESPectre é uma plataforma de código aberto que reúne firmware pronto para gravação, um SDK C++ integrável, uma biblioteca Arduino, 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

Aplicações e integrações

Use o ESPectre para acender luzes ou um display quando alguém entrar, ajustar o aquecimento quando um ambiente estiver em uso ou enviar um alerta quando houver movimento onde não deveria haver ninguém. Ele funciona com o Home Assistant (via ESPHome ou MQTT), aparece como um sensor de ocupação Matter padrão, oferece uma API HTTP local e pode ser incorporado ao seu próprio firmware ESP32 com o SDK C++ ou um sketch Arduino-ESP32.

Tudo é executado 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 ambiente.

O ESPectre detecta alterações no ambiente de rádio. Ele não identifica pessoas, não as conta, não comprova que um ambiente está vazio nem substitui um sistema de segurança, médico ou de emergência certificado.

Hardware compatível

  • ESP32-C6, ESP32-C5, ESP32-C3, ESP32-S3, ESP32-S2 e ESP32 clássico
  • uma rede Wi-Fi 4 (802.11n) normal em 2,4 GHz

Escolha um caminho de firmware

CaminhoIdeal paraComece aqui
NativoSensores autônomos, integrações MQTT, incluindo Home Assistant MQTT Discovery, e aplicações personalizadasFrontend nativo
ESPHomeUsuários do Home Assistant que desejam entidades nativas, provisionamento via ESPHome e atualizações pelo Device BuilderFrontend ESPHome
MatterControladores Matter com suporte a sensor de ocupação; testado com Google Home, Apple Home e Home AssistantFrontend Matter
Micro-ESPectreSensoriamento leve em MicroPython com monitoramento Direct HTTP local e somente leituraREADME do Micro-ESPectre

Início rápido

O caminho mais rápido exige apenas um navegador. Use o Chrome para desktop 151 ou posterior; o Edge consegue gravar, mas as Configurações do dispositivo e o Monitor podem não funcionar nele.

  1. Abra o Flash no Chrome ou Edge para desktop.
  2. Conecte um ESP32 compatível via USB e, em seguida, escolha um firmware e um canal de lançamento.
  3. Conclua o provisionamento de Wi-Fi na tela ou faça a comissão do Matter com um controlador compatível.
  4. Opcionalmente, abra Configurações do dispositivo para fixar um ponto de acesso preferido ou configurar o MQTT.
  5. Abra o Monitor para acompanhar o movimento, ajustar a detecção e inspecionar o dispositivo.

Para encontrar seus dispositivos na rede, use Find devices nas ferramentas do navegador ou ./espectre devices. Consulte a referência de descoberta para requisitos e limites.

ESPectre Monitor

Status do Matter: o emparelhamento, as atualizações de ocupação e as automações são testados com Google Home, Apple Home e Home Assistant. Amazon Alexa e Samsung SmartThings ainda não foram testados. O Google Home requer uma configuração única do Developer Console. Consulte Compatibilidade de controladores Matter para a matriz atual.

Configuração local

Para compilar e gravar o firmware a partir deste repositório, comece pelo guia de configuração. Para ver todos os comandos disponíveis, execute:

./espectre --help

Documentação

Categorias