الدليل ← إعداد البوردة
إعداد البوردة (ملف التعريف)
هذه الصفحة تشرح كل زر وخيار في صفحة «إعداد الجهاز» داخل التطبيق — بطريقة مبسّطة يفهمها أي شخص، حتى لو لأول مرة.
1 ما هي هذه الصفحة؟
كل بوردة (ESP32 / ESP8266) عبارة عن «عقل» فيه عدّة أطراف كهربائية تُسمّى منافذ GPIO. صفحة الإعداد هي المكان الذي تُخبر فيه البوردة بما هو موصّل بكل طرف — مفتاح إضاءة؟ ديمر؟ إضاءة ملوّنة؟ حسّاس حرارة؟ — وعلى أي منفذ.
بعد أن تحفظ، تُكتب هذه التعريفات داخل البوردة وتُقفل بشكل دائم، فتعرف البوردة وظيفتها وتعمل وحدها حتى بدون إنترنت.
2 كيف تفتح الصفحة
- أثناء إضافة جهاز جديد: تظهر تلقائيًا للوحدة الجديدة التي لم تُعرَّف بعد.
- لاحقًا: اضغط مطوّلًا على الجهاز ← إعداد الوحدة، أو من شاشة «الجهاز يحتاج إعداد» اضغط إضافة التعريفات.
- بالأعلى يمين الصفحة زر ؟ يفتح هذا الشرح في أي وقت.
الصفحة فيها ثلاثة تبويبات بالأعلى:
| التبويب | ماذا يحتوي |
|---|---|
| القنوات | تعريف كل مخرج/مدخل (الأهم — ابدأ من هنا) |
| الإعدادات | سلوك متقدّم للمفاتيح والريليه (اختياري) |
| العتاد | اسم المشروع ومنافذ الأزرار والمؤشّرات (اختياري) |
3 البداية السريعة بالقوالب الجاهزة
أسهل طريقة: في أعلى تبويب القنوات ستجد صفًّا من القوالب الجاهزة. اضغط واحدًا فقط، فيملأ التطبيق القنوات نيابةً عنك ويختار المنافذ تلقائيًا.
| القالب | يناسب |
|---|---|
| مفتاح واحد | إضاءة أو جهاز واحد |
| مفتاحان / 4 / 6 مفاتيح | لوحات المفاتيح المتعددة |
| إضاءة معتّمة (ديمر) | إضاءة قابلة للتعتيم |
| إضاءة RGB | إضاءة ملوّنة (3 منافذ) |
| ستارة | ستارة/شتر كهربائي (فتح وغلق) |
| حسّاس حرارة | حسّاس حرارة ورطوبة DHT |
| مفاتيح + حسّاس | 3 مفاتيح مع حسّاس حرارة |
4 القنوات وأنواعها
كل قناة (سطر) لها: اسم تختاره، ونوع يحدّد ما هو الموصّل، ومنفذ GPIO واحد أو أكثر. اختر النوع «بلا» لأي قناة غير مستخدمة.
| النوع | الاستخدام | عدد المنافذ |
|---|---|---|
| تشغيل/إيقاف | مفتاح إضاءة أو جهاز عادي (ريليه) | 1 |
| باهت (ديمر) | إضاءة قابلة للتعتيم | 1 |
| مروحة | مروحة بسرعات | 1 |
| إضاءة RGB | إضاءة ملوّنة (أحمر/أخضر/أزرق) | 3 (R + G + B) |
| شريط RGB | شريط LED ملوّن (WS2812) + عدد اللمبات | 1 (منفذ البيانات) |
| ستارة | ستارة/شتر — رفع وخفض | 2 (رفع + خفض) |
| حرارة/رطوبة (DHT) | حسّاس حرارة ورطوبة | 1 |
| تناظري | قراءة حسّاس تناظري (قيمة متغيّرة) | 1 |
| رقمي | مدخل رقمي (باب/حركة: مفتوح/مغلق) | 1 |
5 ما هو منفذ GPIO؟
GPIO هو رقم الطرف الكهربائي على البوردة الذي وصّلت إليه السلك. عند توصيل المفتاح أو الحسّاس بالبوردة، تكون قد وصّلته إلى رقم منفذ معيّن — اختر نفس الرقم هنا.
6 مفتاح الحائط الإضافي (اختياري)
لأي قناة من نوع تشغيل/إيقاف يمكنك إضافة مفتاح حائط فيزيائي — أي مفتاح الإضاءة التقليدي على الحائط — فيتحكّم في نفس الخرج جنبًا إلى جنب مع التطبيق. اختر له منفذ GPIO الخاص به في خانة «مفتاح حائط».
7 تبويب «الإعدادات» (متقدّم)
هذه الخيارات تضبط طريقة عمل المفاتيح والريليه حسب تركيبتك الكهربائية. اتركها كما هي إن لم تكن متأكدًا — القيم الافتراضية تناسب معظم اللوحات.
| الإعداد | الوظيفة | افتراضي |
|---|---|---|
| اسم شبكة الإعداد | اسم نقطة الواي فاي التي تنشئها الوحدة عند الإعداد | UNIT |
| وضع المفاتيح | عادي / ثلاثي (تتبّع الحالة الحقيقية) / ضغط (زر لحظي) | عادي |
| معالجة المفاتيح | استطلاع (ثابت، موصى به) / مقاطعات (أسرع) | استطلاع |
| توصيل المفاتيح | رفع (Pull-up) / خفض (Pull-down) | رفع |
| وضع المرحّلات | فعّال-مرتفع / فعّال-منخفض | فعّال-مرتفع |
| سلوك مؤشّر الواي فاي | الحالة (يضيء حسب الاتصال) / صامت (مطفأ) | الحالة |
| توصيل مؤشّرات LED | فعّال-مرتفع / فعّال-منخفض | فعّال-مرتفع |
| توصيل زر الإعداد | رفع / خفض | رفع |
8 تبويب «العتاد» (متقدّم)
هنا تحدّد منافذ الأزرار والمؤشّرات والمستقبِلات على البوردة:
| العنصر | الوظيفة |
|---|---|
| المشروع | اسم وصفي للوحة (مثلًا «غرفة المعيشة») |
| زر الإعداد | منفذ زر الدخول لوضع الإعداد |
| مؤشّر حالة الواي فاي | لمبة تبيّن حالة الاتصال |
| مؤشّر الإعداد / السحابة | لمبات حالة إضافية (اختياري) |
| مستقبل RF 433 ميجاهرتز | لاستقبال الريموتات والحسّاسات اللاسلكية |
| مستقبل الأشعّة (IR) | لاستقبال أوامر ريموت الأشعّة |
10 الحفظ والقفل
- راجع شريط الملخّص بالأعلى — يبيّن عدد القنوات وأي تعارض في المنافذ.
- تأكّد من عدم وجود تنبيه أحمر (منفذ مكرّر، أو RGB/ستارة ناقصة منافذ).
- اضغط إنشاء ملف التعريف بالأسفل.
- تُرسَل التعريفات إلى البوردة وتظهر القنوات في التطبيق فورًا. ✅
? حلّ المشكلات
تنبيه «منفذ GPIO مستخدم أكثر من مرة»؟
اخترت نفس رقم المنفذ في قناتين. غيّر إحداهما إلى رقم آخر متاح حتى يختفي التنبيه الأحمر.
«القناة تحتاج منافذ R وG وB»؟
إضاءة RGB تتطلّب ثلاثة منافذ. أكمل تحديد المنافذ الثلاثة (G وB بعد المنفذ الأساسي).
«الستارة تحتاج منفذي رفع وخفض»؟
حدّد منفذ الرفع ومنفذ الخفض معًا للستارة.
«عيّن نوعًا ومنفذ GPIO لقناة واحدة على الأقل»؟
كل القنوات مضبوطة على «بلا». فعّل قناة واحدة على الأقل بنوع ومنفذ — أو استخدم قالبًا جاهزًا.
أريد تغيير الإعداد بعد الحفظ؟
ملف التعريف مقفول. يجب إعادة رفع السوفت وير على البوردة (مسح الذاكرة + برمجة من جديد) لإعادة الإعداد.