### مستشعر واحد أو متعدد المستشعرات```
┌─────────┐  ┌─────────┐  ┌─────────┐
│ ESP32   │  │ ESP32   │  │ ESP32   │
│ Room 1  │  │ Room 2  │  │ Room 3  │
└────┬────┘  └────┬────┘  └────┬────┘
     │            │            │
     └────────────┴────────────┘
                  │
                  │ ESPHome Native API
                  ▼
         ┌────────────────────┐
         │   Home Assistant   │
         │   (Auto-discovery) │
         └────────────────────┘

**دورة الابتكار**: يتم تطوير الميزات والخوارزميات الجديدة أولاً والتحقق من صحتها في Micro-ESPectre (Python)، ثم نقلها إلى ESPectre (C++) بمجرد إثبات فعاليتها.

---

## التطور المستقبلي

بينما يركز ESPectre v2.x على **كشف الحركة** (MVS + اختيار الناقل الفرعي التلقائي)، يستكشف المشروع قدرات التعلم الآلي للتطبيقات المتقدمة:

| القدرة | الحالة | الوصف |
|------------|--------|-------------|
| **كاشف ML** | تجريبي | شبكة عصبية (MLP 9→32→16→1)|
| **التعرف على الإيماءات** | مخطط له | كشف إيماءات اليد (السحب، الدفع، الدائرة) للتحكم في المنزل الذكي |
| **التعرف على النشاط البشري** | مخطط له | تحديد الأنشطة (الجلوس، المشي، السقوط) |
| **عد الأشخاص** | مخطط له | تقدير عدد الأشخاص في الغرفة |
| **تحديد المواقع ثلاثي الأبعاد** | بحث | تحديد المواقع الداخلية (دقة 30-50 سم) عبر مصفوفة هوائيات متماسكة الطور |

يتوفر كاشف ML بالفعل مع `detection_algorithm: ml` في تكوين YAML الخاص بك. للحصول على تفاصيل الخوارزمية، راجع [ALGORITHMS.md](https://github.com/francescopace/espectre/blob/HEAD/micro-espectre/ALGORITHMS.md#ml-neural-network-detector) و`PERFORMANCE.md` للمقاييس الحالية  
تم توثيق البنية التحتية لجمع البيانات وتدريب ML في [ML_DATA_COLLECTION.md](https://github.com/francescopace/espectre/blob/HEAD/micro-espectre/ML_DATA_COLLECTION.md).

انظر [ROADMAP.md](https://github.com/francescopace/espectre/blob/HEAD/ROADMAP.md) للحصول على خطط مفصلة وجداول زمنية وكيفية المساهمة.

---

## التوثيق

### ESPectre (الإنتاج)

| المستند | الوصف |
|----------|-------------|
| [مقدمة](https://github.com/francescopace/espectre/blob/HEAD/README.md) | (هذا الملف) نظرة عامة على المشروع، بداية سريعة، الأسئلة الشائعة |
| [دليل الإعداد](https://github.com/francescopace/espectre/blob/HEAD/SETUP.md) | التثبيت والتكوين مع ESPHome |
| [دليل الضبط](https://github.com/francescopace/espectre/blob/HEAD/TUNING.md) | ضبط المعاملات للكشف الأمثل |
| [الأداء](https://github.com/francescopace/espectre/blob/HEAD/PERFORMANCE.md) | المعايير، مصفوفة الارتباك، درجة F1 |
| [اللعبة](https://github.com/francescopace/espectre/blob/HEAD/docs/game/README.md) | لعبة متصفح، واجهة برمجة تطبيقات البث عبر USB، ضبط العتبة التفاعلي |
| [مجموعة الاختبار](https://github.com/francescopace/espectre/blob/HEAD/test/README.md) | توثيق اختبار PlatformIO Unity |

### Micro-ESPectre (البحث والتطوير)

| المستند | الوصف |
|----------|-------------|
| [مقدمة](https://github.com/francescopace/espectre/blob/HEAD/micro-espectre/README.md) | نظرة عامة على منصة البحث والتطوير، واجهة سطر الأوامر، MQTT، مراقب الويب |
| [الخوارزميات](https://github.com/francescopace/espectre/blob/HEAD/micro-espectre/ALGORITHMS.md) | توثيق علمي لـ MVS، معايرة NBVI، مرشح Hampel |
| [أدوات التحليل](https://github.com/francescopace/espectre/blob/HEAD/micro-espectre/tools/README.md) | نصوص تحليل CSI وتحسينها |
| [جمع بيانات ML](https://github.com/francescopace/espectre/blob/HEAD/micro-espectre/ML_DATA_COLLECTION.md) | بناء مجموعات بيانات مصنفة للتعلم الآلي |
| [المراجع](https://github.com/francescopace/espectre/blob/HEAD/micro-espectre/README.md#المراجع) | الأوراق الأكاديمية وموارد البحث |

### المشروع

| المستند | الوصف |
|----------|-------------|
| [خارطة الطريق](https://github.com/francescopace/espectre/blob/HEAD/ROADMAP.md) | رؤية المشروع وخطط ML |
| [المساهمة](https://github.com/francescopace/espectre/blob/HEAD/CONTRIBUTING.md) | كيفية المساهمة (كود، بيانات، وثائق) |
| [سجل التغييرات](https://github.com/francescopace/espectre/blob/HEAD/CHANGELOG.md) | تاريخ الإصدار وملاحظات الإصدار |
| [الأمان](https://github.com/francescopace/espectre/blob/HEAD/SECURITY.md) | سياسة الأمان والإبلاغ عن الثغرات |
| [مدونة قواعد السلوك](https://github.com/francescopace/espectre/blob/HEAD/CODE_OF_CONDUCT.md) | إرشادات المجتمع |

---

## وسائل الإعلام

| المقالات | العنوان |
|-------------|-------|
| Medium | [كيف حولت واي-فاي الخاص بي إلى حساس حركة - الجزء 1](https://medium.com/@francesco.pace/how-i-turned-my-wi-fi-into-a-motion-sensor-61a631a9b4ec?sk=c7f79130d78b0545fce4a228a6a79af3&utm_source=github&utm_medium=readme&utm_campaign=espectre) |
| Medium | [كيف حولت واي-فاي الخاص بي إلى حساس حركة - الجزء 2](https://medium.com/@francesco.pace/how-i-turned-my-wi-fi-into-a-motion-sensor-part-2-62038130e530?sk=7c8b6f11cf3fcb8d279648016ebff72a&utm_source=github&utm_medium=readme&utm_campaign=espectre) |
| IoT For All | [كيف حولت واي-فاي الخاص بي إلى حساس حركة](https://www.iotforall.com/wifi-motion-sensor-iot) |
| Hackaday | [اصنع حساس شخص خاص بك يعتمد على ESP32، لا حاجة لأجهزة خاصة](https://hackaday.com/2026/01/28/make-your-own-esp32-based-person-sensor-no-special-hardware-needed/) |
| Adafruit Learn | [كاشف البشر ESPectre لـ Feather](https://learn.adafruit.com/espectre-human-detector-for-feather) |
| Seeed Studio Wiki | [نشر Espectre على سلسلة Seeed Studio XIAO ESP32 مع ESPHome](https://wiki.seeedstudio.com/xiao-esp32--series-espresense/) |

| المدونة | المناقشة |
|----------|------------|
| Home Assistant | [ESPectre - كشف الحركة عبر واي-فاي لـ Home Assistant](https://community.home-assistant.io/t/espectre-wi-fi-motion-detection-for-home-assistant/961251) |

| الفيديوهات | الفيديو |
|---------|-------|
| @GithubAwesome | [ESPectre](https://www.youtube.com/shorts/iQ_DPHLn8ms) |

| البودكاست | الحلقة |
|-------------|---------|
| Hackaday | [حلقة البودكاست 355: كاشفات الأشخاص، أجهزة الاتصال اللاسلكي، الهواتف الذكية المفتوحة...](https://hackaday.com/2026/01/30/hackaday-podcast-episode-355-person-detectors-walkie-talkies-open-smartphones-and-a-wifi-traffic-light/) |

---

## المشاريع ذات الصلة

- [radio-presence-scanner](https://github.com/francescopace/radio-presence-scanner): مشروع مكمل لكشف الوجود يركز على ملاحظات الراديو BLE من أجهزة المضيف (Python)، مع لوحة تحكم HTTP اختيارية.
- [micropython-esp32-csi](https://github.com/francescopace/micropython-esp32-csi): فرع MicroPython مخصص يعرض واجهات برمجة تطبيقات ESP32 CSI، يُستخدم كأساس للبرامج الثابتة للنمذجة السريعة لـ CSI في سير عمل Micro-ESPectre.

---

## الشكر والتقدير

يستفيد ESPectre من قدرات CSI الأصلية للواي-فاي لرقاقات ESP32. الشكر لـ [Espressif](https://www.espressif.com/) على جعل CSI متاحًا في إطار ESP-IDF وعلى الاعتراف بـ ESPectre كمشروع [مجتمعي](https://github.com/espressif/esp-csi#6-related-resources) في مستودع [esp-csi](https://github.com/espressif/esp-csi) الخاص بهم.

---

## الترخيص

تم إصدار هذا المشروع بموجب **رخصة GNU العامة العامة الإصدار 3.0 (GPLv3)**.

تضمن GPLv3 ما يلي:
- يبقى البرنامج حرًا ومفتوح المصدر
- يمكن لأي شخص استخدامه ودراسته وتعديله وتوزيعه
- يجب مشاركة التعديلات بموجب نفس الترخيص
- يحمي حقوق المستخدم النهائي وحرية البرمجيات

انظر [LICENSE](https://github.com/francescopace/espectre/blob/HEAD/LICENSE) لنص الترخيص الكامل.

يتم تقديم المساهمات بموجب GPLv3 ويجب أن تتضمن تذييل DCO
`Signed-off-by` في كل إيداع (`git commit -s`).

## المؤلف

**Francesco Pace**  
البريد الإلكتروني: [[email protected]](mailto:[email protected])  
LinkedIn: [linkedin.com/in/francescopace](https://www.linkedin.com/in/francescopace/)

إذا وجدت ESPectre مفيدًا وتريد دعم تطويره، يمكنك شراء قهوة لي. إنه اختياري تمامًا.
أعمل على هذا المشروع لأنني شغوف به. تساعدني المساهمات في شراء أجهزة جديدة لتوسيع قائمة الأجهزة المختبرة والمدعومة، وتخصيص المزيد من الوقت للميزات الجديدة.

<a href="https://www.buymeacoffee.com/espectre" target="_blank"><img src="https://assets.kitploit.com/production/public/readmes/9574/a7e8174c892355a24fbaec083cbef385d097a0b488fd4823dbbb0061643bb5e2.png" alt="اشتر لي قهوة" style="height: 60px !important;width: 217px !important;" ></a>