الدليل ← إعداد البوردة

إعداد البوردة (ملف التعريف)

هذه الصفحة تشرح كل زر وخيار في صفحة «إعداد الجهاز» داخل التطبيق — بطريقة مبسّطة يفهمها أي شخص، حتى لو لأول مرة.

1 ما هي هذه الصفحة؟

كل بوردة (ESP32 / ESP8266) عبارة عن «عقل» فيه عدّة أطراف كهربائية تُسمّى منافذ GPIO. صفحة الإعداد هي المكان الذي تُخبر فيه البوردة بما هو موصّل بكل طرف — مفتاح إضاءة؟ ديمر؟ إضاءة ملوّنة؟ حسّاس حرارة؟ — وعلى أي منفذ.

بعد أن تحفظ، تُكتب هذه التعريفات داخل البوردة وتُقفل بشكل دائم، فتعرف البوردة وظيفتها وتعمل وحدها حتى بدون إنترنت.

🧩
فكّر فيها كـ«قائمة توصيلات»: لكل سطر تقول «النوع» (إيه الموصّل) و«المنفذ» (على أي رِجل في البوردة).

2 كيف تفتح الصفحة

  1. أثناء إضافة جهاز جديد: تظهر تلقائيًا للوحدة الجديدة التي لم تُعرَّف بعد.
  2. لاحقًا: اضغط مطوّلًا على الجهاز ← إعداد الوحدة، أو من شاشة «الجهاز يحتاج إعداد» اضغط إضافة التعريفات.
  3. بالأعلى يمين الصفحة زر ؟ يفتح هذا الشرح في أي وقت.

الصفحة فيها ثلاثة تبويبات بالأعلى:

التبويبماذا يحتوي
القنواتتعريف كل مخرج/مدخل (الأهم — ابدأ من هنا)
الإعداداتسلوك متقدّم للمفاتيح والريليه (اختياري)
العتاداسم المشروع ومنافذ الأزرار والمؤشّرات (اختياري)

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
⚠️
إضاءة RGB تحتاج تحديد ثلاثة منافذ (R وG وB)، والستارة تحتاج منفذين(رفع وخفض). لو نسيت واحدًا سينبّهك التطبيق عند الحفظ.

5 ما هو منفذ GPIO؟

GPIO هو رقم الطرف الكهربائي على البوردة الذي وصّلت إليه السلك. عند توصيل المفتاح أو الحسّاس بالبوردة، تكون قد وصّلته إلى رقم منفذ معيّن — اختر نفس الرقم هنا.

💡
لو استخدمت أحد القوالب الجاهزة فلن تحتاج لمعرفة هذه الأرقام — يختارها التطبيق لك من المنافذ المتاحة. غيّرها فقط إن كانت توصيلتك مختلفة.
🔢
كل منفذ يُستخدم مرّة واحدة فقط. إذا كرّرت نفس الرقم في قناتين سيظهر تنبيه أحمر، ويجب تصحيحه قبل الحفظ.

6 مفتاح الحائط الإضافي (اختياري)

لأي قناة من نوع تشغيل/إيقاف يمكنك إضافة مفتاح حائط فيزيائي — أي مفتاح الإضاءة التقليدي على الحائط — فيتحكّم في نفس الخرج جنبًا إلى جنب مع التطبيق. اختر له منفذ GPIO الخاص به في خانة «مفتاح حائط».

7 تبويب «الإعدادات» (متقدّم)

هذه الخيارات تضبط طريقة عمل المفاتيح والريليه حسب تركيبتك الكهربائية. اتركها كما هي إن لم تكن متأكدًا — القيم الافتراضية تناسب معظم اللوحات.

الإعدادالوظيفةافتراضي
اسم شبكة الإعداداسم نقطة الواي فاي التي تنشئها الوحدة عند الإعدادUNIT
وضع المفاتيحعادي / ثلاثي (تتبّع الحالة الحقيقية) / ضغط (زر لحظي)عادي
معالجة المفاتيحاستطلاع (ثابت، موصى به) / مقاطعات (أسرع)استطلاع
توصيل المفاتيحرفع (Pull-up) / خفض (Pull-down)رفع
وضع المرحّلاتفعّال-مرتفع / فعّال-منخفضفعّال-مرتفع
سلوك مؤشّر الواي فايالحالة (يضيء حسب الاتصال) / صامت (مطفأ)الحالة
توصيل مؤشّرات LEDفعّال-مرتفع / فعّال-منخفضفعّال-مرتفع
توصيل زر الإعدادرفع / خفضرفع
🔧
لو المفاتيح الخارجية لا تعمل صحيحًا: جرّب تغيير وضع المفاتيح أو نوع التوصيل (رفع/خفض). ولو الريليه يعمل بشكل معكوس: غيّر وضع المرحّلات.

8 تبويب «العتاد» (متقدّم)

هنا تحدّد منافذ الأزرار والمؤشّرات والمستقبِلات على البوردة:

العنصرالوظيفة
المشروعاسم وصفي للوحة (مثلًا «غرفة المعيشة»)
زر الإعدادمنفذ زر الدخول لوضع الإعداد
مؤشّر حالة الواي فايلمبة تبيّن حالة الاتصال
مؤشّر الإعداد / السحابةلمبات حالة إضافية (اختياري)
مستقبل RF 433 ميجاهرتزلاستقبال الريموتات والحسّاسات اللاسلكية
مستقبل الأشعّة (IR)لاستقبال أوامر ريموت الأشعّة
📡
حدّد منافذ RF أو IR فقط إذا كانت بوردتك تحتوي على هذه المستقبِلات وتريد استخدام الريموتات.

9 زر الإعداد ومؤشّرات LED

الإجراء على زر الإعدادالنتيجة
ضغطة سريعةإعادة تشغيل الوحدة
استمرار الضغط 3 ثوانٍالدخول لوضع إعداد الواي فاي (مع الحفاظ على التعريفات)
💡
الزر لا يمسح تعريفات البوردة أبدًا. لتغيير ملف التعريف يجب إعادة رفع السوفت وير على البوردة من جديد.
المؤشّرالمعنى
مؤشّر الواي فاي — وميضيبحث عن الشبكة
مؤشّر الواي فاي — ثابتمتّصل
مؤشّر الإعداد/السحابة — وميضفي وضع الإعداد
مؤشّر الإعداد/السحابة — ثابتمتّصل بالخدمة

10 الحفظ والقفل

  1. راجع شريط الملخّص بالأعلى — يبيّن عدد القنوات وأي تعارض في المنافذ.
  2. تأكّد من عدم وجود تنبيه أحمر (منفذ مكرّر، أو RGB/ستارة ناقصة منافذ).
  3. اضغط إنشاء ملف التعريف بالأسفل.
  4. تُرسَل التعريفات إلى البوردة وتظهر القنوات في التطبيق فورًا. ✅
🔒
يُكتب ملف التعريف مرة واحدة ويُقفل. لتغييره لاحقًا يجب إعادة رفع السوفت وير على البوردة (مسح وإعادة برمجة). تأكّد من صحّة الإعداد قبل الحفظ.

? حلّ المشكلات

تنبيه «منفذ GPIO مستخدم أكثر من مرة»؟

اخترت نفس رقم المنفذ في قناتين. غيّر إحداهما إلى رقم آخر متاح حتى يختفي التنبيه الأحمر.

«القناة تحتاج منافذ R وG وB»؟

إضاءة RGB تتطلّب ثلاثة منافذ. أكمل تحديد المنافذ الثلاثة (G وB بعد المنفذ الأساسي).

«الستارة تحتاج منفذي رفع وخفض»؟

حدّد منفذ الرفع ومنفذ الخفض معًا للستارة.

«عيّن نوعًا ومنفذ GPIO لقناة واحدة على الأقل»؟

كل القنوات مضبوطة على «بلا». فعّل قناة واحدة على الأقل بنوع ومنفذ — أو استخدم قالبًا جاهزًا.

أريد تغيير الإعداد بعد الحفظ؟

ملف التعريف مقفول. يجب إعادة رفع السوفت وير على البوردة (مسح الذاكرة + برمجة من جديد) لإعادة الإعداد.

محتاج مساعدة أكثر؟ تواصل مع الدعم الفني ومعك اسم/سيريال الوحدة من صفحة تفاصيل الجهاز.
العودة إلى الدليل