ESPectre

ESP32를 개인 정보를 보호하는 로컬 Wi-Fi 모션 센서로 바꿔 보세요.

누군가 방을 지나가면 방 안에서 Wi-Fi 신호가 이동하는 방식이 바뀝니다. ESPectre는 이러한 변화를 읽고 실시간으로 모션을 보고합니다. 카메라도, 마이크도, 웨어러블도, 전용 레이더 하드웨어도 필요하지 않습니다. 지원되는 ESP32와 이미 방에 있는 Wi-Fi 네트워크만 있으면 됩니다.

ESPectre는 바로 플래시할 수 있는 펌웨어, 임베드 가능한 C++ SDK, MicroPython 구현, 브라우저 도구, 호스트 CLI, 공개 데이터셋, 공개 모델 가중치, 그리고 감지기를 구축하고 검증하는 데 사용된 연구 워크플로를 하나로 모은 오픈소스 플랫폼입니다.

브라우저에서 플래시하기 · 라이브 도구 보기 · 문서 읽기 · SDK 살펴보기

응용 및 통합

ESPectre를 사용하면 누군가 들어올 때 조명이나 디스플레이를 켜고, 방이 사용 중일 때 난방을 조절하고, 아무도 없어야 할 곳에서 움직임이 있을 때 알림을 보낼 수 있습니다. Home Assistant(ESPHome 또는 MQTT를 통해)와 함께 작동하며, 표준 Matter 점유 센서로 나타나고, 로컬 HTTP API를 제공하며, C++ SDK로 자체 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 컨트롤러. 컨트롤러 검증은 아직 제한적임	Matter 프런트엔드
Micro-ESPectre	로컬 읽기 전용 Direct HTTP 모니터링을 사용하는 MicroPython의 경량 센싱	Micro-ESPectre README

빠른 시작

가장 빠른 방법은 브라우저만 있으면 됩니다. 데스크톱 Chrome 151 이상을 사용하세요. Edge에서도 플래시할 수 있지만, Device settings와 Monitor는 Edge에서 작동하지 않을 수 있습니다.

데스크톱 Chrome 또는 Edge에서 Flash를 엽니다.
지원되는 ESP32를 USB로 연결한 다음, 펌웨어와 릴리스 채널을 선택합니다.
화면에 표시되는 Wi-Fi 프로비저닝을 완료하거나, 지원되는 컨트롤러로 Matter를 커미셔닝합니다.
선택적으로 Device settings를 열어 선호하는 액세스 포인트를 고정하거나 MQTT를 설정합니다.
Monitor를 열어 모션을 관찰하고, 감지를 튜닝하고, 기기를 검사합니다.

네트워크에서 기기를 찾으려면 브라우저 도구의 Find devices 또는 ./espectre devices를 사용하세요. 요구 사항과 제한은 검색 참조를 참조하세요.

ESPectre Monitor

Matter 상태: Matter 지원은 아직 다양한 컨트롤러 생태계에서 테스트 중입니다. 점유 센서를 지원하는 컨트롤러가 아직 ESPectre와 함께 테스트되지 않았을 수 있습니다. 현재 매트릭스는 Matter 컨트롤러 호환성을 참조하세요.

로컬 설정

이 저장소에서 빌드하고 플래시하려면 설정 가이드부터 시작하세요. 사용 가능한 모든 명령을 보려면 다음을 실행하세요:

./espectre --help

문서

주제	다루는 내용	가이드
설치 및 운영	기기 설정, CLI 워크플로, 문제 해결	설정 가이드, CLI 참조, 문제 해결 가이드
이해 및 통합	런타임 아키텍처, CSI 수집, API, 검색, 알고리즘, C++ SDK	아키텍처 개요, CSI 가이드, API 참조, 검색 참조, 알고리즘 참조, SDK 가이드
수집 및 학습	CSI 수집, 모델 학습, 피처 이력, 성능, 문헌	데이터 수집 가이드, ML 학습 가이드, 피처 원장, 성능 보고서, 문헌 검토
연구 및 방향	로드맵, 아키텍처 결정, 릴리스 이력	로드맵, ADR 색인, 변경 로그
프런트엔드 참조	각 펌웨어에 대한 가이드: ESPHome, Native, Matter, Micro-ESPectre	ESPHome, Native, Matter, Micro
기여	기여, 릴리스 절차, 프로젝트 논의	기여 가이드, 릴리스 가이드, GitHub Discussions

데이터셋, 모델, 검증

ESPectre는 감지기의 기반이 되는 연구 자산과 검증 증거를 공개합니다:

espectre

인기