# 🚀 دليل البدء السريع - نظام IoT

## خطوات التشغيل الكاملة (5 دقائق)

### 📋 المتطلبات
- ✅ ESP8266 (NodeMCU أو Wemos D1 Mini)
- ✅ Arduino IDE مثبت
- ✅ كابل USB
- ✅ شبكة WiFi

---

## الخطوة 1️⃣: إصلاح قاعدة البيانات

افتح في المتصفح:
```
http://localhost/KL/backend/database/fix_iot_system.php
```

انتظر حتى ترى: **🎉 اكتمل الإصلاح بنجاح!**

---

## الخطوة 2️⃣: إضافة جهاز ESP

1. افتح لوحة التحكم:
   ```
   http://localhost/KL/backend/admin/iot/index.php
   ```

2. اضغط **"إدارة الأجهزة"**

3. اضغط **"إضافة جهاز"**

4. أدخل البيانات:
   ```
   معرف الجهاز: ESP01
   اسم الجهاز: جهاز غرفة النوم
   عنوان IP: 192.168.1.100
   المنفذ: 80
   الحالة: offline
   ```

5. اضغط **"حفظ الجهاز"**

---

## الخطوة 3️⃣: إضافة بينات (Pins)

1. اضغط **"إدارة البينات"**

2. اختر الجهاز: **ESP01**

3. اضغط **"إضافة Pin"**

4. أدخل البيانات:
   ```
   GPIO Pin: GPIO5 (D1)
   اسم Pin: إضاءة غرفة النوم
   نوع Pin: Relay
   الموقع: غرفة النوم
   الأيقونة: اختر 💡 لمبة
   ```

5. اضغط **"حفظ Pin"**

6. كرر لإضافة المزيد من البينات

---

## الخطوة 4️⃣: الحصول على كود Arduino

1. اضغط **"كود Arduino"** من لوحة التحكم

2. اختر الجهاز: **ESP01**

3. اضغط **"نسخ الكود"** أو **"تحميل ملف .ino"**

---

## الخطوة 5️⃣: رفع الكود على ESP

### أ) تثبيت مكتبات ESP8266

1. افتح **Arduino IDE**

2. اذهب إلى: **File → Preferences**

3. في **Additional Board Manager URLs** أضف:
   ```
   http://arduino.esp8266.com/stable/package_esp8266com_index.json
   ```

4. اذهب إلى: **Tools → Board → Boards Manager**

5. ابحث عن: **esp8266**

6. اضغط **Install** على **ESP8266 by ESP8266 Community**

### ب) تعديل الكود

1. الصق الكود في Arduino IDE

2. عدّل إعدادات WiFi (السطور 8-9):
   ```cpp
   const char* ssid = "اسم_شبكة_الواي_فاي";
   const char* password = "كلمة_المرور";
   ```

3. احفظ الملف: **File → Save As** → `ESP01_IoT_Control.ino`

### ج) رفع الكود

1. وصّل ESP بالكمبيوتر عبر USB

2. اختر اللوحة: **Tools → Board → NodeMCU 1.0 (ESP-12E Module)**

3. اختر المنفذ: **Tools → Port → COM3** (أو المنفذ المتاح)

4. اضغط **Upload** (السهم →)

5. انتظر حتى ترى: **Done uploading**

---

## الخطوة 6️⃣: التحكم في البينات

1. افتح **Serial Monitor** في Arduino IDE

2. اضبط Baud Rate على: **115200**

3. ستظهر رسالة:
   ```
   WiFi connected!
   IP Address: 192.168.1.XXX
   ```

4. انسخ عنوان IP هذا

5. ارجع للمتصفح → **إدارة الأجهزة**

6. عدّل الجهاز وضع عنوان IP الصحيح

7. اذهب إلى **"التحكم المباشر"**

8. اختر الجهاز

9. اضغط أزرار التشغيل/الإيقاف 🎉

---

## 🎯 نصائح مهمة

### ✅ إذا لم يتصل ESP بالـ WiFi:
- تأكد من اسم الشبكة وكلمة المرور صحيحة
- تأكد من أن الشبكة 2.4GHz (ESP8266 لا يدعم 5GHz)
- جرب إعادة تشغيل ESP

### ✅ إذا لم تعمل أزرار التحكم:
- تأكد من عنوان IP صحيح
- تأكد من أن ESP والكمبيوتر على نفس الشبكة
- افحص Serial Monitor للأخطاء

### ✅ لإضافة المزيد من البينات:
- اذهب إلى "إدارة البينات"
- أضف بينات جديدة
- احصل على الكود الجديد من "كود Arduino"
- ارفعه على ESP مرة أخرى

---

## 🔌 GPIO Pins الموصى بها

| GPIO | D Pin | الاستخدام |
|------|-------|-----------|
| GPIO5 | D1 | ✅ ممتاز للريلاي |
| GPIO4 | D2 | ✅ ممتاز للريلاي |
| GPIO14 | D5 | ✅ ممتاز للريلاي |
| GPIO12 | D6 | ✅ ممتاز للريلاي |
| GPIO13 | D7 | ✅ ممتاز للريلاي |
| GPIO2 | D4 | ⚠️ LED مدمج |
| GPIO0 | D3 | ⚠️ استخدم بحذر |
| GPIO15 | D8 | ⚠️ استخدم بحذر |

---

## 📊 مثال عملي كامل

### السيناريو: التحكم في 3 أجهزة

#### الجهاز 1: غرفة النوم
- GPIO5 → إضاءة غرفة النوم 💡
- GPIO4 → مروحة غرفة النوم 🌀

#### الجهاز 2: غرفة المعيشة
- GPIO5 → إضاءة غرفة المعيشة 💡
- GPIO4 → تلفاز 📺
- GPIO14 → مكيف ❄️

#### الجهاز 3: الحديقة
- GPIO5 → إضاءة الحديقة 💡
- GPIO4 → مضخة الماء 💧

---

## 🆘 الدعم

### الملفات المرجعية:
- `IOT-SYSTEM-GUIDE.md` - دليل شامل
- `ARDUINO-LIBRARIES-GUIDE.md` - مكتبات Arduino
- `RELAY-WIRING-GUIDE.md` - توصيل الريلاي

### روابط مفيدة:
- [ESP8266 Arduino Core](https://github.com/esp8266/Arduino)
- [NodeMCU Documentation](https://nodemcu.readthedocs.io/)

---

## ✅ قائمة التحقق

- [ ] تم تشغيل `fix_iot_system.php`
- [ ] تم إضافة جهاز ESP
- [ ] تم إضافة بينات
- [ ] تم الحصول على كود Arduino
- [ ] تم تثبيت مكتبات ESP8266
- [ ] تم تعديل إعدادات WiFi
- [ ] تم رفع الكود على ESP
- [ ] ESP متصل بالـ WiFi
- [ ] تم تحديث عنوان IP
- [ ] أزرار التحكم تعمل ✨

---

**مبروك! 🎉 نظام IoT الخاص بك يعمل الآن!**

---

**آخر تحديث:** نوفمبر 2025  
**الإصدار:** 1.0.0