
ESPectre - نظام كشف الحركة يعتمد على تحليل طيف Wi-Fi (CSI)، مع تكامل Home Assistant.
حوّل لوحة ESP32 إلى مستشعر حركة خاص ومحلي عبر Wi-Fi.
عندما يتحرك شخص في غرفة، فإنه يغيّر طريقة انتقال إشارات Wi-Fi عبرها. يقرأ ESPectre هذه التغييرات ويبلّغ عن الحركة في الوقت الفعلي. لا كاميرا، ولا ميكروفون، ولا جهاز يُلبس، ولا عتاد رادار مخصص: فقط لوحة ESP32 مدعومة وشبكة Wi-Fi الموجودة بالفعل في الغرفة.
ESPectre منصة مفتوحة المصدر تجمع بين برنامج ثابت جاهز للوميض، وSDK بلغة C++ قابل للتضمين، ومكتبة Arduino، وتنفيذ MicroPython، وأدوات للمتصفح، وأداة سطر أوامر للمضيف، ومجموعة بيانات مفتوحة، وأوزان نماذج مفتوحة، وسير عمل البحث المستخدم لبناء الكواشف والتحقق من صحتها.
الوميض من متصفحك · شاهد الأدوات المباشرة · اقرأ الوثائق · استكشف SDK
استخدم ESPectre لتشغيل الأضواء أو شاشة عندما يدخل شخص ما، أو ضبط التدفئة عندما تكون الغرفة قيد الاستخدام، أو إرسال تنبيه عند وجود حركة في مكان لا ينبغي أن يكون فيه أحد. يعمل مع Home Assistant (عبر ESPHome أو MQTT)، ويظهر كمستشعر إشغال Matter قياسي، ويوفر واجهة برمجة تطبيقات HTTP محلية، ويمكن تضمينه في البرنامج الثابت الخاص بلوحة ESP32 باستخدام SDK بلغة C++ أو رسم Arduino-ESP32.
كل شيء يعمل على الجهاز: فهو يقيس قناة Wi-Fi (معلومات حالة القناة، أو CSI) ويبلّغ عن الحركة ودرجة الحركة. لا حاجة لإرسال أي شيء إلى السحابة. تغطي لوحة واحدة منطقة واحدة، لذا خطط للوحة واحدة لكل غرفة.
يكتشف ESPectre التغييرات في البيئة الراديوية. وهو لا يحدد هوية الأشخاص، ولا يعدّهم، ولا يثبت أن الغرفة فارغة، ولا يحل محل نظام أمان أو طبي أو طوارئ معتمد للسلامة.
| المسار | الأنسب لـ | ابدأ من هنا |
|---|---|---|
| Native | المستشعرات المستقلة، وتكاملات MQTT، بما في ذلك Home Assistant MQTT Discovery، والتطبيقات المخصصة | Native frontend |
| ESPHome | مستخدمو Home Assistant الذين يريدون كيانات أصلية، وتزويد ESPHome، وتحديثات Device Builder | ESPHome frontend |
| Matter | وحدات تحكم Matter التي تدعم مستشعر الإشغال؛ تم اختبارها مع Google Home وApple Home وHome Assistant | Matter frontend |
| Micro-ESPectre | استشعار خفيف في MicroPython مع مراقبة Direct HTTP محلية للقراءة فقط | Micro-ESPectre README |
أسرع طريقة لا تحتاج سوى متصفح. استخدم Chrome 151 لسطح المكتب أو أحدث؛ يمكن لـ Edge تنفيذ الوميض، لكن Device settings وMonitor قد لا يعملان فيه.
للعثور على أجهزتك على الشبكة، استخدم Find devices في أدوات المتصفح أو ./espectre devices. راجع مرجع الاكتشاف للاطلاع على المتطلبات والقيود.

حالة Matter: تم اختبار الاقتران وتحديثات الإشغال والأتمتة مع Google Home وApple Home وHome Assistant. لم يتم اختبار Amazon Alexa وSamsung SmartThings بعد. يحتاج Google Home إلى إعداد لمرة واحدة في Developer Console. راجع توافق وحدات تحكم Matter للاطلاع على المصفوفة الحالية.
للبناء والبرمجة من هذا المستودع، ابدأ بـ دليل الإعداد. لعرض جميع الأوامر المتاحة، شغّل:
./espectre --help
| الموضوع | ما يغطيه | الأدلة |
|---|---|---|
| التثبيت والتشغيل | إعداد الجهاز، وسير عمل CLI، واستكشاف الأخطاء وإصلاحها | دليل الإعداد، مرجع CLI، دليل استكشاف الأخطاء وإصلاحها |
| الفهم والتكامل | بنية وقت التشغيل، واكتساب CSI، وواجهة API، والاكتشاف، والخوارزميات، وSDK الخاص بـ C++ | نظرة عامة على البنية، دليل CSI، مرجع API، مرجع الاكتشاف، مرجع الخوارزميات، دليل SDK |
| البحث والتوجه | خارطة الطريق، وقرارات البنية، وسجل الإصدارات | خارطة الطريق، فهرس ADR، سجل التغييرات |
| مرجع الواجهات الأمامية | أدلة لكل برنامج ثابت، وMicro-ESPectre، ومكتبة Arduino | ESPHome، Native، Matter، Micro، Arduino |
| المساهمة | المساهمات، وإجراءات الإصدار، ونقاشات المشروع | دليل المساهمة، دليل الإصدار، GitHub Discussions |
تنشر ESPectre الأصول البحثية وأدلة التحقق التي تستند إليها كواشفها: