
espectre snapshot
ESPectre - Wi-Fi 스펙트럼 분석(CSI) 기반의 동작 감지 시스템, Home Assistant 통합 기능 포함.
ESPectre 
ESP32를 프라이빗한 로컬 Wi-Fi 모션 센서로 바꿔 보세요.
누군가 방 안을 움직이면, 그 사람은 방을 통과하는 Wi-Fi 신호의 이동 방식에 변화를 일으킵니다. ESPectre는 이러한 변화를 읽어 실시간으로 모션을 보고합니다. 카메라도, 마이크도, 웨어러블도, 전용 레이더 하드웨어도 필요 없습니다. 지원되는 ESP32와 이미 방에 있는 Wi-Fi 네트워크만 있으면 됩니다.
ESPectre는 바로 플래시할 수 있는 펌웨어, 임베드 가능한 C++ SDK, Arduino 라이브러리, MicroPython 구현, 브라우저 도구, 호스트 CLI, 공개 데이터셋, 공개 모델 가중치, 그리고 감지기를 구축하고 검증하는 데 사용된 연구 워크플로를 하나로 모은 오픈소스 플랫폼입니다.
브라우저에서 플래시하기 · 라이브 도구 보기 · 문서 읽기 · SDK 살펴보기
응용 분야 및 통합
ESPectre를 사용하면 누군가 들어올 때 조명이나 디스플레이를 켜고, 방이 사용 중일 때 난방을 조절하거나, 아무도 없어야 할 곳에서 움직임이 있을 때 경고를 보낼 수 있습니다. Home Assistant(ESPHome 또는 MQTT를 통해)와 함께 작동하며, 표준 Matter 점유 센서로 나타나고, 로컬 HTTP API를 제공하며, C++ SDK 또는 Arduino-ESP32 스케치로 자체 ESP32 펌웨어에 내장할 수 있습니다.
모든 것이 기기에서 실행됩니다. Wi-Fi 채널(채널 상태 정보, 즉 CSI)을 측정하고 모션과 이동 점수를 보고합니다. 클라우드로 전송할 필요가 없습니다. 보드 하나가 하나의 영역을 담당하므로 방마다 보드 하나를 계획하세요.
ESPectre는 무선 환경의 변화를 감지합니다. 사람을 식별하거나, 인원을 세거나, 방이 비어 있음을 증명하거나, 안전 인증을 받은 보안·의료·비상 시스템을 대체하지는 않습니다.
지원 하드웨어
- ESP32-C6, ESP32-C5, ESP32-C3, ESP32-S3, ESP32-S2 및 클래식 ESP32
- 2.4 GHz의 일반 Wi-Fi 4(802.11n) 네트워크
펌웨어 경로 선택
| 경로 | 적합한 용도 | 시작하기 |
|---|---|---|
| Native | 독립형 센서, Home Assistant MQTT Discovery를 포함한 MQTT 통합, 사용자 지정 애플리케이션 | Native 프런트엔드 |
| ESPHome | 네이티브 엔티티, ESPHome 프로비저닝, Device Builder 업데이트를 원하는 Home Assistant 사용자 | ESPHome 프런트엔드 |
| Matter | 점유 센서를 지원하는 Matter 컨트롤러. Google Home, Apple Home, Home Assistant에서 테스트됨 | Matter 프런트엔드 |
| Micro-ESPectre | 로컬 읽기 전용 Direct HTTP 모니터링을 갖춘 MicroPython 기반 경량 센싱 | Micro-ESPectre README |
빠른 시작
가장 빠른 방법은 브라우저만 있으면 됩니다. 데스크톱 Chrome 151 이상을 사용하세요. Edge에서도 플래시할 수 있지만, Device settings와 Monitor는 작동하지 않을 수 있습니다.
- 데스크톱 Chrome 또는 Edge에서 Flash를 엽니다.
- 지원되는 ESP32를 USB로 연결한 다음, 펌웨어와 릴리스 채널을 선택합니다.
- 화면에 표시되는 Wi-Fi 프로비저닝을 완료하거나, 지원되는 컨트롤러로 Matter를 커미셔닝합니다.
- 선택 사항으로, Device settings를 열어 선호하는 액세스 포인트를 고정하거나 MQTT를 설정합니다.
- Monitor를 열어 움직임을 관찰하고, 감지를 조정하고, 기기를 검사합니다.
네트워크에서 기기를 찾으려면 브라우저 도구의 Find devices 또는 ./espectre devices를 사용하세요. 요구 사항과 제한 사항은 검색 참조를 참조하세요.

Matter 상태: 페어링, 점유 업데이트, 자동화는 Google Home, Apple Home, Home Assistant에서 테스트되었습니다. Amazon Alexa와 Samsung SmartThings는 아직 테스트되지 않았습니다. Google Home은 일회성 Developer Console 설정이 필요합니다. 현재 호환성 매트릭스는 Matter 컨트롤러 호환성을 참조하세요.
로컬 설정
이 저장소에서 빌드하고 플래시하려면 설정 가이드부터 시작하세요. 사용 가능한 모든 명령을 보려면 다음을 실행하세요:
./espectre --help
문서
| 주제 | 다루는 내용 | 가이드 |
|---|---|---|
| 설치 및 운영 | 장치 설정, CLI 워크플로, 문제 해결 | 설정 가이드, CLI 레퍼런스, 문제 해결 가이드 |
| 이해 및 통합 | 런타임 아키텍처, CSI 수집, API, 디스커버리, 알고리즘, C++ SDK | 아키텍처 개요, CSI 가이드, API 레퍼런스, 디스커버리 레퍼런스, 알고리즘 레퍼런스, SDK 가이드 |
| 연구 및 방향 | 로드맵, 아키텍처 결정, 릴리스 이력 | 로드맵, ADR 색인, 변경 로그 |
| 프런트엔드 레퍼런스 | 각 펌웨어, Micro-ESPectre, Arduino 라이브러리 가이드 | ESPHome, Native, Matter, Micro, Arduino |
| 기여 | 기여, 릴리스 절차, 프로젝트 논의 | 기여 가이드, 릴리스 가이드, GitHub Discussions |
데이터셋, 모델, 검증
ESPectre는 탐지기 뒤에 있는 연구 자산과 검증 근거를 공개합니다:
| 자산 | 제공 내용 | 시작하기 |
|---|---|---|
| CSI 데이터셋 | 빈 방, 정적 존재, 움직임에 대한 실제 녹음과 dataset_info.json의 카탈로그 및 출처 정보 | 데이터 수집 가이드, Data/ |
| 모델 가중치 | C++ 및 Python의 학습된 가중치와 학습, 내보내기, 검증 워크플로 | ML 학습 가이드 |
| 특징 분석 | 실패한 실험을 포함해 테스트, 채택 또는 기각된 특징 | 특징 분석 |
| 보고서 | 생성된 탐지기 지표와 데이터셋 품질 검사 | 성능 보고서, 데이터셋 품질 보고서 |
| 문헌 | 외부 Wi-Fi 센싱 연구와 ESPectre에 적용 가능한 내용 | 문헌 검토 |