Repolode
francescopace

francescopace/espectre

ESP32를 카메라나 마이크 없이 Wi-Fi 신호 변화로 움직임을 감지하는 비공개 로컬 Wi-Fi 모션 센서로 만듭니다.

스타
9,665
포크
733
열린 이슈
14
마지막 커밋
그저께

어떤 프로젝트인가요?

ESPectre는 지원되는 ESP32 보드에서 실행되며, 실내에 이미 존재하는 Wi-Fi 신호의 채널 상태 정보(CSI)를 읽습니다. 누군가 움직이면 신호 경로가 달라지고, 기기는 움직임 여부와 움직임 점수를 실시간으로 보고합니다. 처리는 기기에서 이뤄지므로 클라우드 서비스가 필요 없고, 카메라, 마이크, 웨어러블 기기, 레이더 하드웨어도 필요하지 않습니다.

이 프로젝트는 여러 펌웨어 경로를 제공합니다. MQTT와 Home Assistant MQTT Discovery를 지원하는 Native 프런트엔드, ESPHome 프런트엔드, Matter 점유 센서 프런트엔드, Micro-ESPectre라는 MicroPython 구현이 있습니다. 임베드 가능한 C++ SDK, 로컬 HTTP API, 브라우저 기반 플래싱 및 모니터링 도구, 기기 관리용 호스트 CLI도 포함됩니다.

저장소에는 CSI 데이터셋, 학습된 모델 가중치, 테스트 후 제외한 실험을 기록한 기능 원장, 성능 보고서가 공개되어 있습니다. ESPectre는 무선 환경의 변화만 감지하며 사람을 식별하거나 수를 세지는 않습니다. 코드는 GPLv3 라이선스로 제공되며, 해당되는 구성 요소에는 상용 라이선스도 제공됩니다.

핵심 기능

  • 01ESP32-C6, C5, C3, S3, S2 및 클래식 ESP32 보드에서 Wi-Fi CSI를 이용해 움직임을 감지합니다.
  • 02클라우드 연결 없이 기기에서 모든 처리를 수행합니다.
  • 03ESPHome 또는 MQTT를 통해 Home Assistant와 연동하며, Matter 점유 센서로 표시됩니다.
  • 04맞춤형 펌웨어를 위한 로컬 HTTP API와 임베드 가능한 C++ SDK를 제공합니다.
  • 05브라우저 기반 플래싱, 기기 설정, 실시간 모니터링 기능을 포함합니다.

활용 사례

  • 누군가 방에 들어오면 조명이나 디스플레이를 켭니다.
  • 방 사용 여부에 따라 난방을 조절합니다.
  • 비어 있어야 하는 구역에서 움직임이 감지되면 알림을 보냅니다.
  • 카메라 없이 Home Assistant 구성에 재실 감지 기능을 추가합니다.

빠른 시작

  1. 1

    데스크톱 Chrome 또는 Edge에서 Flash 도구를 엽니다

  2. 2

    지원되는 ESP32를 USB로 연결하고 펌웨어를 선택한 다음 Wi-Fi 설정을 완료합니다

  3. 3

    Monitor를 열어 움직임을 확인하고 감지를 조정합니다

사용 전 알아둘 점

  • 지원되는 ESP32 보드와 2.4GHz Wi-Fi 4 네트워크가 필요합니다. 방마다 보드 한 대를 준비하세요.
  • Matter 컨트롤러 호환성은 아직 제한적이며 충분히 테스트되지 않았습니다.
  • GPLv3 카피레프트가 적용되므로 비공개 소스 펌웨어에는 별도의 상용 라이선스가 필요합니다.

토픽

자주 묻는 질문

espectre은(는) 무엇인가요?
ESP32를 카메라나 마이크 없이 Wi-Fi 신호 변화로 움직임을 감지하는 비공개 로컬 Wi-Fi 모션 센서로 만듭니다. ESPectre는 지원되는 ESP32 보드에서 실행되며, 실내에 이미 존재하는 Wi-Fi 신호의 채널 상태 정보(CSI)를 읽습니다. 누군가 움직이면 신호 경로가 달라지고, 기기는 움직임 여부와 움직임 점수를 실시간으로 보고합니다. 처리는 기기에서 이뤄지므로 클라우드 서비스가 필요 없고, 카메라, 마이크, 웨어러블 기기, 레이더 하드웨어도 필요하지 않습니다.
espectre은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
espectre은(는) GPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
espectre은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. espectre의 마지막 커밋은 2026년 10월 19일입니다.
espectre은(는) 어디에 사용할 수 있나요?
누군가 방에 들어오면 조명이나 디스플레이를 켭니다. 방 사용 여부에 따라 난방을 조절합니다. 비어 있어야 하는 구역에서 움직임이 감지되면 알림을 보냅니다. 카메라 없이 Home Assistant 구성에 재실 감지 기능을 추가합니다.
espectre는 어떻게 설치하나요?
데스크톱 Chrome 또는 Edge에서 Flash 도구를 엽니다 지원되는 ESP32를 USB로 연결하고 펌웨어를 선택한 다음 Wi-Fi 설정을 완료합니다 Monitor를 열어 움직임을 확인하고 감지를 조정합니다
espectre은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/francescopace/espectre

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트