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

التوثيق