Skip to content

๐Ÿ›œ ESPectre ๐Ÿ‘ป - Motion detection system based on Wi-Fi spectre analysis (CSI) for Arduino Framework

License

Notifications You must be signed in to change notification settings

GitBruno/espectre

 
 

Repository files navigation

๐Ÿ›œ ESPectre Arduino Framework Fork ๐Ÿ‘ป

Motion detection system based on Wi-Fi spectre analysis (CSI)


๐Ÿ”ง Arduino Framework Fork

This is a fork of ESPectre adapted for Arduino Framework integration.

Key Differences from Upstream:

  • โœ… Arduino Framework Compatible: Component library files work with Arduino/PlatformIO projects
  • โœ… No Standalone Operation: Designed to be embedded in larger Arduino applications (no app_main())
  • โœ… No External Dependencies Required: No Home Assistant or MQTT broker needed when integrated
  • โœ… Component Library: Provides segmentation, CSI processing, and traffic generation as reusable modules

Upstream Repository: francescopace/espectre
Integration Example: This repo allows ESPectre motion detection through a web interface without external MQTT infrastructure.

Note: If you want standalone ESPectre with Home Assistant integration, use the upstream repository. This fork is for developers who want to embed ESPectre functionality into their own Arduino-based projects.


๐Ÿ”ง Integration with PlatformIO

Simply add to your platformio.ini:

[env:your_board]
platform = espressif32
board = esp32-s3-devkitc-1  ; or esp32-c6-devkitc-1
framework = arduino

; Add ESPectre library
lib_deps = 
    https://github.com/GitBruno/espectre.git#main
    ; ... your other libraries

; Force include stdbool.h for ESPectre compatibility (recommended)
build_flags = 
    -include stdbool.h

That's it! The library is Arduino-ready by default:

  • โœ… All C files include <stdbool.h> (required by Arduino toolchain)
  • โœ… No espectre.c with app_main() conflict (removed from repo)
  • โœ… No test files (removed from repo)
  • โœ… No build scripts needed (everything pre-configured)

๐Ÿ“ฐ Featured Article: Read the complete story behind ESPectre on Medium ๐Ÿ‡ฎ๐Ÿ‡น Italian, ๐Ÿ‡ฌ๐Ÿ‡ง English

โš ๏ธ Disclaimer: This is an experimental project for educational and research purposes. The author assumes no responsibility for misuse or damage resulting from the use of this system. Use responsibly and in compliance with applicable laws.


About

๐Ÿ›œ ESPectre ๐Ÿ‘ป - Motion detection system based on Wi-Fi spectre analysis (CSI) for Arduino Framework

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • HTML 47.9%
  • C 46.1%
  • Python 5.9%
  • CMake 0.1%