ESPectre

حوّل ESP32 إلى مستشعر حركة خاص ومحلي عبر Wi-Fi.

عندما يتحرك شخص في غرفة، فإنه يغيّر طريقة انتقال إشارات Wi-Fi عبرها. يقرأ ESPectre هذه التغييرات ويبلّغ عن الحركة في الوقت الفعلي. لا كاميرا، ولا ميكروفون، ولا جهاز يُلبس، ولا عتاد رادار مخصص: فقط ESP32 مدعوم وشبكة Wi-Fi الموجودة بالفعل في الغرفة.

ESPectre منصة مفتوحة المصدر تجمع بين برنامج ثابت جاهز للتفليش، وSDK بلغة C++ قابل للتضمين، وتنفيذ بلغة MicroPython، وأدوات للمتصفح، وواجهة سطر أوامر للمضيف، ومجموعة بيانات مفتوحة، وأوزان نماذج مفتوحة، وسير العمل البحثي المستخدم لبناء الكواشف والتحقق منها.

فلّش من متصفحك · شاهد الأدوات المباشرة · اقرأ الوثائق · استكشف SDK

التطبيقات والتكاملات

استخدم ESPectre لتشغيل الأضواء أو شاشة عند دخول شخص ما، أو ضبط التدفئة عند استخدام غرفة، أو إرسال تنبيه عند وجود حركة في مكان لا ينبغي أن يكون فيه أحد. يعمل مع Home Assistant (عبر ESPHome أو MQTT)، ويظهر كمستشعر إشغال Matter قياسي، ويوفر واجهة HTTP محلية، ويمكن دمجه في البرنامج الثابت الخاص بك على ESP32 باستخدام SDK بلغة C++.

كل شيء يعمل على الجهاز نفسه: فهو يقيس قناة Wi-Fi (معلومات حالة القناة، أو CSI) ويبلّغ عن الحركة ودرجة الحركة. لا حاجة لإرسال أي شيء إلى السحابة. تغطي لوحة واحدة منطقة واحدة، لذا خطط للوحة واحدة لكل غرفة.

يكتشف ESPectre التغييرات في البيئة الراديوية. وهو لا يتعرّف على الأشخاص، ولا يعدّهم، ولا يثبت أن غرفة فارغة، ولا يحل محل نظام أمني أو طبي أو طارئ معتمد للسلامة.

العتاد المدعوم

• ESP32-C6 وESP32-C5 وESP32-C3 وESP32-S3 وESP32-S2 وESP32 الكلاسيكي
• شبكة Wi-Fi 4 (802.11n) عادية على نطاق 2.4 GHz

اختر مسار البرنامج الثابت

المسار	الأنسب لـ	ابدأ من هنا
Native	المستشعرات المستقلة، وتكاملات MQTT، بما في ذلك Home Assistant MQTT Discovery، والتطبيقات المخصصة	واجهة Native
ESPHome	مستخدمو Home Assistant الذين يريدون كيانات أصلية، وتزويد ESPHome، وتحديثات Device Builder	واجهة ESPHome
Matter	وحدات تحكم Matter التي تدعم مستشعرات الإشغال؛ لا يزال التحقق من الوحدات محدودًا	واجهة Matter
Micro-ESPectre	استشعار خفيف في MicroPython مع مراقبة محلية للقراءة فقط عبر Direct HTTP	Micro-ESPectre README

البدء السريع

أسرع طريقة لا تحتاج سوى متصفح. استخدم Chrome 151 أو أحدث على سطح المكتب؛ يمكن لـ Edge التفليش، لكن Device settings وMonitor قد لا يعملان فيه.

1. افتح Flash في Chrome أو Edge على سطح المكتب.
2. وصّل ESP32 مدعومًا عبر USB، ثم اختر برنامجًا ثابتًا وقناة إصدار.
3. أكمل تزويد Wi-Fi على الشاشة، أو قم بتهيئة Matter باستخدام وحدة تحكم مدعومة.
4. اختياريًا، افتح Device settings لتثبيت نقطة وصول مفضلة أو إعداد MQTT.
5. افتح Monitor لمراقبة الحركة وضبط الكشف وفحص الجهاز.

للعثور على أجهزتك على الشبكة، استخدم Find devices في أدوات المتصفح أو ./espectre devices. راجع مرجع الاكتشاف للمتطلبات والحدود.

حالة Matter: لا يزال دعم Matter قيد الاختبار مع مختلف أنظمة وحدات التحكم. قد تكون وحدة تحكم تدعم مستشعرات الإشغال لم تُختبر بعد مع ESPectre. راجع توافق وحدات تحكم Matter للمصفوفة الحالية.

الإعداد المحلي

للبناء والتفليش من هذا المستودع، ابدأ بـدليل الإعداد. لرؤية جميع الأوامر المتاحة، شغّل:

./espectre --help

الوثائق