ESPectre

ESP32를 개인용 로컬 Wi-Fi 모션 센서로 바꿔보세요.

누군가 방 안을 움직이면 Wi-Fi 신호가 방을 통과하는 방식이 달라집니다. ESPectre는 이러한 변화를 읽고 실시간으로 움직임을 보고합니다. 카메라, 마이크, 웨어러블, 전용 레이더 하드웨어가 필요 없습니다. 지원되는 ESP32와 방에 이미 있는 Wi-Fi 네트워크만 있으면 됩니다.

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

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

애플리케이션 및 통합

ESPectre는 움직임을 감지하면 디스플레이나 조명을 켜고, 방의 활동에 따라 난방 및 냉방을 조절하며, 비어 있어야 할 영역에서 움직임이 발생하면 알람이나 알림을 트리거하고, 기타 방 자동화를 구동할 수 있습니다. ESPHome 또는 MQTT를 통해 Home Assistant에 연결되고, 표준 Matter 점유 센서와 로컬 Direct HTTP API를 노출하며, C++ SDK를 통해 맞춤형 ESP32 펌웨어에 임베디드할 수 있습니다.

ESPectre는 기기에서 CSI를 처리하고 모션 상태와 움직임 점수를 보고합니다. 애플리케이션은 원시 센싱 데이터를 클라우드 서비스로 보내지 않고도 반응할 수 있습니다. 보드 하나가 하나의 센싱 영역을 담당합니다. 방 전체 커버리지는 일반적으로 방마다 보드 하나가 필요합니다.

ESPectre는 무선 환경의 변화를 감지합니다. 사람을 식별하거나, 인원을 세거나, 방이 비어 있음을 증명하거나, 안전 인증을 받은 보안, 의료, 응급 시스템을 대체하지 않습니다.

지원 하드웨어

• ESP32-C6, ESP32-C5, ESP32-C3, ESP32-S3, ESP32-S2 및 클래식 ESP32
• 2.4 GHz의 일반 Wi-Fi 4(802.11n) 네트워크

펌웨어 경로 선택

Native, ESPHome, Matter는 시작 시 방별 임계값을 학습하고 나머지 애플리케이션에 더 많은 리소스를 남겨두는 lightweight 감지기와, 저장소에 포함된 훈련된 모델을 실행하는 high_accuracy 감지기 중에서 선택할 수 있습니다. 이들의 동작과 측정된 트레이드오프는 SETUP.md, ALGORITHMS.md 및 성능 보고서에 문서화되어 있습니다.

빠른 시작

가장 빠른 경로는 브라우저를 사용하며 로컬 빌드 환경이 필요 없습니다. 전체 호스팅 워크플로우에는 데스크톱 Chrome 151 이상을 사용하세요. Edge는 브라우저 플래싱을 지원하지만 Device settings 및 Monitor와의 호환성은 보장되지 않습니다:

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

Matter 상태: Matter 프론트엔드는 아직 컨트롤러 생태계 전반에서 검증 중입니다. 컨트롤러가 표준 Matter 점유 센서를 지원할 수는 있지만 현재 펌웨어로 테스트되지 않았을 수 있습니다. 현재 매트릭스는 Matter 컨트롤러 호환성을 참조하세요.

로컬 설정

로컬 빌드, 이 저장소에서 플래싱, 그리고 나머지 운영자 경로는 SETUP.md에서 시작하세요. 저장소 래퍼는 다음을 통해 사용 가능한 워크플로우를 노출합니다:

./espectre --help

문서

데이터셋, 모델 및 검증

ESPectre는 감지기 뒤에 있는 연구 자산과 검증 증거를 공개합니다:

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

존재를 드러낼 수 있는 센서는 블랙박스가 되어서는 안 됩니다. Wi-Fi 센싱은 이미지와 오디오를 피하지만, 모션 및 점유 데이터는 여전히 일상, 수면 또는 외출 여부를 드러낼 수 있습니다. ESPectre는 이러한 위험을 엔지니어링 작업의 일부로 취급합니다:

• 모션 감지는 로컬에서 이루어지며 클라우드 연결이 필요하지 않습니다;
• 원시 CSI 수집은 선택 사항이며 정의된 연구 및 디버깅 요구를 위한 것입니다;
• 보안 및 책임 있는 사용 가이드는 배포 경계, 동의, 데이터 최소화, 오용 신고, 비공개 취약점 신고를 문서화합니다;
• 펌웨어 릴리스에는 빌드별 SBOM, 고지 사항, 라이선스 아카이브가 포함되어 내용을 검사할 수 있습니다;
• 공개 웹사이트와 모든 브라우저 도구는 소스, 개인정보 보호 규칙, 분석 계약, 고정된 브라우저 종속성을 포함하여 docs/web 아래 이 저장소의 일부입니다;
• 프로토콜, 알고리즘, 성능 증거, 한계, 로드맵 결정, 알려진 검증 경계가 공개적으로 문서화되어 있습니다.

ESPectre를 배포할 권리가 있는 공간과 네트워크에서만 사용하세요. 영향을 받는 사람들에게 알리고, 필요한 경우 동의를 얻고, 기기와 데이터에 대한 접근을 보호하고, 적용 가능한 개인정보 보호법을 준수하세요.

감사의 말

• CSI를 ESP-IDF에서 접근 가능하게 만들고 ESPectre를 esp-csi의 커뮤니티 프로젝트로 인정해 준 Espressif에 감사드립니다.
• 메인라인 network.WLAN에 직접 CSI 메서드를 추가한 ESPectre의 CSI 기여를 검토, 테스트, 병합해 준 MicroPython 유지관리자들에게 감사드립니다.

라이선스

ESPectre 자체 코드는 GPLv3로 제공되며, 적격 부분은 별도의 상업적 계약으로도 제공됩니다:

• 펌웨어나 애플리케이션이 해당 소스 코드 공개를 포함한 GPLv3를 준수할 수 있는 경우 GPLv3를 선택하세요. LICENSE를 참조하세요.
• GPLv3 소스 공개 의무 없이 ESPectre를 독점 또는 폐쇄 소스 펌웨어에 임베디드하려면 상업적 라이선스에 대해 LICENSING.md를 참조하세요. 상업적 라이선스는 적격 자료를 다루며 제3자 약관을 대체하지 않습니다. ESPHome C++ 프론트엔드는 GPLv3 전용으로 유지됩니다.

제3자 약관과 빌드별 규정 준수 산출물은 THIRD_PARTY_NOTICES.md에 설명되어 있습니다.