espectre snapshot-dev
ESPectre - वाई-फाई स्पेक्ट्रम विश्लेषण (CSI) पर आधारित गति पहचान प्रणाली, होम असिस्टेंट एकीकरण के साथ।
ESPectre 
ESP32 को एक निजी, स्थानीय वाई-फाई मोशन सेंसर में बदलें।
जब कोई व्यक्ति किसी कमरे में चलता है, तो वे उस कमरे से गुजरने वाले वाई-फाई सिग्नल के तरीके को बदल देते हैं। ESPectre उन परिवर्तनों को पढ़ता है और वास्तविक समय में गति की रिपोर्ट करता है। कोई कैमरा नहीं, कोई माइक्रोफोन नहीं, कोई पहनने योग्य उपकरण नहीं, और कोई समर्पित रडार हार्डवेयर नहीं: बस एक समर्थित ESP32 और कमरे में पहले से मौजूद वाई-फाई नेटवर्क।
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 पर एक सामान्य वाई-फाई 4 (802.11n) नेटवर्क
फर्मवेयर पथ चुनें
| पथ | किसके लिए सर्वोत्तम | यहाँ से शुरू करें |
|---|---|---|
| नेटिव | स्टैंडअलोन सेंसर, MQTT एकीकरण, जिसमें Home Assistant MQTT Discovery शामिल है, और कस्टम एप्लिकेशन | नेटिव फ्रंटएंड |
| ESPHome | Home Assistant उपयोगकर्ता जो नेटिव एंटिटी, ESPHome प्रोविज़निंग, और Device Builder अपडेट चाहते हैं | ESPHome फ्रंटएंड |
| Matter | अधिभोग-सेंसर समर्थन वाले Matter नियंत्रक; नियंत्रक सत्यापन अभी भी सीमित है | Matter फ्रंटएंड |
| Micro-ESPectre | स्थानीय, केवल-पढ़ने योग्य Direct HTTP निगरानी के साथ MicroPython में हल्का सेंसिंग | Micro-ESPectre README |
नेटिव, ESPHome, और Matter एक lightweight डिटेक्टर के बीच चयन कर सकते हैं, जो स्टार्टअप पर एक कमरे-विशिष्ट थ्रेशोल्ड सीखता है और बाकी एप्लिकेशन के लिए अधिक संसाधन छोड़ता है, और एक high_accuracy डिटेक्टर, जो रिपॉजिटरी में शामिल प्रशिक्षित मॉडल चलाता है। उनका व्यवहार और मापे गए ट्रेड-ऑफ SETUP.md, ALGORITHMS.md, और प्रदर्शन रिपोर्ट में प्रलेखित हैं।
त्वरित प्रारंभ
सबसे तेज़ पथ ब्राउज़र का उपयोग करता है और किसी स्थानीय बिल्ड वातावरण की आवश्यकता नहीं होती। पूर्ण होस्टेड वर्कफ़्लो के लिए डेस्कटॉप Chrome 151 या बाद का उपयोग करें। Edge ब्राउज़र फ्लैशिंग का समर्थन करता है, लेकिन Device settings और Monitor के साथ संगतता की गारंटी नहीं है:
- डेस्कटॉप Chrome या Edge में Flash खोलें।
- USB के माध्यम से एक समर्थित ESP32 कनेक्ट करें, फिर एक फर्मवेयर और रिलीज़ चैनल चुनें।
- ऑन-स्क्रीन वाई-फाई प्रोविज़निंग पूरा करें, या समर्थित नियंत्रक के साथ Matter कमीशन करें।
- वैकल्पिक रूप से, पसंदीदा एक्सेस पॉइंट पिन करने या MQTT सेट करने के लिए Device settings खोलें।
- गति देखने, डिटेक्शन ट्यून करने और डिवाइस का निरीक्षण करने के लिए Monitor खोलें।
Matter स्थिति: Matter फ्रंटएंड अभी भी नियंत्रक पारिस्थितिकी तंत्रों में मान्य किया जा रहा है। एक नियंत्रक वर्तमान फर्मवेयर के साथ परीक्षण किए बिना मानक Matter अधिभोग सेंसर का समर्थन कर सकता है। वर्तमान मैट्रिक्स के लिए Matter नियंत्रक संगतता देखें।
स्थानीय सेटअप
स्थानीय बिल्ड, इस रिपॉजिटरी से फ्लैशिंग, और ऑपरेटर पथ के बाकी हिस्सों के लिए, SETUP.md से शुरू करें। रिपॉजिटरी रैपर उपलब्ध वर्कफ़्लो को निम्न के माध्यम से उजागर करता है:
./espectre --help
दस्तावेज़ीकरण
| विषय | यह क्या कवर करता है | गाइड |
|---|---|---|
| इंस्टॉल और संचालित करें | डिवाइस सेटअप, CLI वर्कफ़्लो, और डिटेक्टर ट्यूनिंग | SETUP.md, CLI.md, TUNING.md |
| समझें और एकीकृत करें | रनटाइम आर्किटेक्चर, API, डिस्कवरी, एल्गोरिदम, और C++ SDK | ARCHITECTURE.md, API.md, DISCOVERY.md, ALGORITHMS.md, SDK.md |
| संग्रह और प्रशिक्षण | CSI संग्रह, मॉडल प्रशिक्षण, फीचर इतिहास, प्रदर्शन, और साहित्य | ML_DATA_COLLECTION.md, ML_TRAINING.md, FEATURES.md, प्रदर्शन रिपोर्ट, LITERATURE.md |
| शोध और दिशा | रोडमैप, आर्किटेक्चर निर्णय, और रिलीज़ इतिहास | ROADMAP.md, ADR सूचकांक, CHANGELOG.md |
| फ्रंटएंड संदर्भ | ESPHome, नेटिव, Matter, और Micro-ESPectre के लिए फर्मवेयर-पथ README | ESPHome, नेटिव, Matter, Micro |
| योगदान | योगदान कैसे करें और परियोजना पर कहाँ चर्चा करें | CONTRIBUTING.md, GitHub Discussions |
डेटासेट, मॉडल, और सत्यापन
ESPectre अपने डिटेक्टरों के पीछे शोध संपत्तियों और सत्यापन साक्ष्य प्रकाशित करता है:
| संपत्ति | यह आपको क्या देती है | यहाँ से शुरू करें |
|---|---|---|
| CSI डेटासेट | खाली कमरों, स्थिर उपस्थिति, और गति के लिए वास्तविक रिकॉर्डिंग, dataset_info.json में कैटलॉग और उत्पत्ति के साथ | data/ |
| मॉडल वेट्स | C++ और Python में प्रशिक्षित वेट्स, साथ ही प्रशिक्षण, निर्यात, और सत्यापन वर्कफ़्लो | ML_TRAINING.md |
| फीचर लेजर | परीक्षण किए गए, बढ़ावा दिए गए, या अस्वीकार किए गए फीचर, जिनमें असफल प्रयोग शामिल हैं | FEATURES.md |
| एल्गोरिदम और रिपोर्ट | डिटेक्टर व्यवहार, उत्पन्न प्रदर्शन रिपोर्ट, और डेटासेट गुणवत्ता रिपोर्ट | ALGORITHMS.md |
| साहित्य और दिशा | बाहरी शोध, आर्किटेक्चर निर्णय रिकॉर्ड, और सार्वजनिक रोडमैप | LITERATURE.md |
सुरक्षा, गोपनीयता, और पारदर्शिता
एक सेंसर जो उपस्थिति प्रकट कर सकता है, उसे ब्लैक बॉक्स नहीं होना चाहिए। वाई-फाई सेंसिंग छवियों और ऑडियो से बचता है, लेकिन गति और अधिभोग डेटा अभी भी दिनचर्या, नींद, या घर से अनुपस्थिति प्रकट कर सकता है। ESPectre उस जोखिम को इंजीनियरिंग कार्य के हिस्से के रूप में मानता है:
- गति का पता लगाना स्थानीय है, और क्लाउड कनेक्टिविटी आवश्यक नहीं है;
- कच्चा CSI संग्रह वैकल्पिक है और परिभाषित शोध और डिबगिंग आवश्यकताओं के लिए अभिप्रेत है;
- सुरक्षा और जिम्मेदार-उपयोग गाइड परिनियोजन सीमाओं, सहमति, डेटा न्यूनीकरण, दुरुपयोग रिपोर्टिंग, और निजी भेद्यता रिपोर्टिंग का दस्तावेजीकरण करता है;
- फर्मवेयर रिलीज़ में बिल्ड-विशिष्ट SBOM, सूचनाएं, और लाइसेंस संग्रह शामिल हैं ताकि उनकी सामग्री का निरीक्षण किया जा सके;
- सार्वजनिक वेबसाइट और हर ब्राउज़र टूल इस रिपॉजिटरी का हिस्सा हैं docs/web के अंतर्गत, जिसमें उनका स्रोत, गोपनीयता नियम, एनालिटिक्स अनुबंध, और पिन किए गए ब्राउज़र निर्भरताएं शामिल हैं;
- प्रोटोकॉल, एल्गोरिदम, प्रदर्शन साक्ष्य, सीमाएं, रोडमैप निर्णय, और ज्ञात सत्यापन सीमाएं सार्वजनिक रूप से प्रलेखित हैं।
ESPectre का उपयोग केवल उन स्थानों और नेटवर्कों में करें जहां आपको इसे परिनियोजित करने का अधिकार है। प्रभावित लोगों को सूचित करें, जहां आवश्यक हो सहमति प्राप्त करें, डिवाइस और उसके डेटा तक पहुंच की सुरक्षा करें, और लागू गोपनीयता कानूनों का पालन करें।
आभार
- Espressif को धन्यवाद कि उन्होंने ESP-IDF में CSI को सुलभ बनाया और ESPectre को esp-csi में समुदाय परियोजना के रूप में मान्यता दी।
- MicroPython अनुरक्षकों को धन्यवाद कि उन्होंने ESPectre के CSI योगदान की समीक्षा, परीक्षण, और विलय किया, जिसने मुख्यधारा
network.WLANमें प्रत्यक्ष CSI विधियां जोड़ीं।
लाइसेंस
ESPectre प्रथम-पक्ष कोड GPLv3 के अंतर्गत उपलब्ध है, और पात्र भाग एक अलग वाणिज्यिक समझौते के अंतर्गत भी उपलब्ध हैं:
- GPLv3 चुनें जब आपका फर्मवेयर या एप्लिकेशन GPLv3 का अनुपालन कर सकता है, जिसमें संबंधित स्रोत उपलब्ध कराना शामिल है। LICENSE देखें।
- यदि आप GPLv3 स्रोत-प्रकटीकरण दायित्वों के बिना ESPectre को मालिकाना या बंद-स्रोत फर्मवेयर में एम्बेड करना चाहते हैं, तो वाणिज्यिक लाइसेंसिंग के लिए LICENSING.md देखें। वाणिज्यिक लाइसेंस पात्र सामग्री को कवर करता है और तृतीय-पक्ष शर्तों को प्रतिस्थापित नहीं करता; ESPHome C++ फ्रंटएंड केवल-GPLv3 बना रहता है।
तृतीय-पक्ष शर्तें और बिल्ड-विशिष्ट अनुपालन कलाकृतियां THIRD_PARTY_NOTICES.md में वर्णित हैं।