업데이트로 돌아가기
New releaseSep 13, 2026

espectre snapshot

ESPectre - Wi-Fi 스펙트럼 분석(CSI) 기반의 동작 감지 시스템, Home Assistant 통합 기능 포함.

공유

ESP-IDF component Arduino library C++ coverage Python coverage Web coverage

ESPectre ESPectre logo

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는 작동하지 않을 수 있습니다.

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

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

ESPectre Monitor

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에 적용 가능한 내용문헌 검토

보안, 개인정보 보호, 투명성

카테고리