ESPHome ESP8266 الاتصال الفعلي بجهازك

تحديد

• متطلبات النظام: نظام التشغيل Control4 OS 3.3+

زيادةview

دمج الأجهزة القائمة على ESPHome في Control4. ESPHome هو نظام مفتوح المصدر يُحوّل وحدات التحكم الدقيقة الشائعة، مثل ESP8266 وESP32، إلى أجهزة منزلية ذكية من خلال تهيئة YAML بسيطة. يمكن إعداد أجهزة ESPHome ومراقبتها والتحكم فيها باستخدام web متصفح الإنترنت، أو Home Assistant، أو منصات أخرى متوافقة. يتيح لك هذا البرنامج مراقبة أجهزة ESPHome والتحكم بها بسلاسة مباشرةً من نظام Control4.

متطلبات النظام

• نظام التشغيل Control4 OS 3.3+

سمات

• اتصالات الشبكة المحلية لا تتطلب أي خدمات سحابية
• تحديثات في الوقت الفعلي من جميع الكيانات المدعومة التي يعرضها الجهاز
• يدعم الاتصالات المشفرة باستخدام مفتاح تشفير الجهاز
• دعم البرمجة المتغيرة

التوافق

الأجهزة التي تم التحقق منها
سيعمل برنامج التشغيل هذا بشكل عام مع أي جهاز ESPHome، ولكننا قمنا باختباره على نطاق واسع مع الأجهزة التالية:

• راتجدو – دليل التكوين

إذا قمت بتجربة هذا البرنامج على أحد المنتجات المذكورة أعلاه، وكان يعمل، فأخبرنا بذلك!

كيانات ESPHome المدعومة

إعداد المثبت

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

إعداد DriverCentral Cloud
إذا كان لديك بالفعل برنامج تشغيل DriverCentral Cloud بعد تثبيت برنامج التشغيل في مشروعك، يمكنك المتابعة إلى تثبيت برنامج التشغيل.

يعتمد هذا البرنامج على برنامج DriverCentral Cloud لإدارة التراخيص والتحديثات التلقائية. إذا كنت جديدًا في استخدام DriverCentral، يمكنك الرجوع إلى وثائق برنامج التشغيل السحابي لإعداده.

تثبيت برنامج التشغيل

تثبيت وإعداد برنامج التشغيل مشابه لمعظم برامج التشغيل الأخرى المعتمدة على IP. فيما يلي شرح للخطوات الأساسية لتسهيل الأمر عليك.

1. تنزيل أحدث control4-esphome.zip من درايفر سنترال.
2. استخرج وقم بتثبيت esphome.c4z, esphome_light.c4z، و esphome_lock.c4z السائقين.
3. استخدم علامة التبويب "بحث" للعثور على برنامج التشغيل "ESPHome" وإضافته إلى مشروعك.
4. حدد برنامج التشغيل المُضاف حديثًا في علامة تبويب "تصميم النظام". ستلاحظ أن حالة السحابة تعكس حالة الترخيص. إذا اشتريت ترخيصًا، فسيظهر "تم تفعيل الترخيص"، وإلا "قيد التشغيل التجريبي" ومدة التجربة المتبقية.
5. يمكنك تحديث حالة الترخيص عن طريق تحديد برنامج التشغيل "DriverCentral Cloud" في علامة التبويب "تصميم النظام" وتنفيذ إجراء "التحقق من برامج التشغيل".
6. تكوين إعدادات الجهاز مع معلومات الاتصال.
7. بعد لحظات، ستظهر حالة برنامج التشغيل "متصل". إذا لم يتصل برنامج التشغيل، فاضبط خاصية "وضع السجل" على "طباعة" وأعد ضبط حقل عنوان IP لإعادة الاتصال. ثم تحقق من نافذة إخراج Lua لمزيد من المعلومات.
8. بمجرد الاتصال، سيقوم برنامج التشغيل تلقائيًا بإنشاء متغيرات واتصالات لكل نوع كيان مدعوم.
9. للتحكم في الإضاءة و/أو الأقفال، استخدم علامة تبويب "بحث" للعثور على برنامج تشغيل "ESPHome Light" و/أو "ESPHome Lock". أضف نسخة برنامج تشغيل واحدة لكل وحدة إضاءة أو قفل مكشوفة في مشروعك. في علامة تبويب "الاتصالات"، حدد برنامج تشغيل "ESPHome" واربط وحدات الإضاءة أو القفل ببرامج التشغيل المضافة حديثًا.

إعداد برنامج التشغيل

خصائص برنامج التشغيل

إعدادات السحابة

• حالة السحابة
  يعرض حالة ترخيص السحابة DriverCentral.
• التحديثات التلقائية
  يقوم بتشغيل/إيقاف التحديثات التلقائية لسحابة DriverCentral.

إعدادات السائق

• حالة برنامج التشغيل (للقراءة فقط)
  يعرض الحالة الحالية للسائق.
• إصدار برنامج التشغيل (للقراءة فقط)
  يعرض الإصدار الحالي من برنامج التشغيل.
• مستوى السجل [ فادح | خطأ | تحذير | معلومات | تصحيح | تتبع | فائق ] يُحدد مستوى التسجيل. الافتراضي هو معلومات.
• وضع السجل [ إيقاف | طباعة | سجل | الطباعة والتسجيل ] يُحدد وضع التسجيل. الوضع الافتراضي هو عن.

إعدادات الجهاز

عنوان IP
تعيين عنوان IP للجهاز (على سبيل المثال 192.168.1.30يُسمح بأسماء النطاقات طالما يُمكن لوحدة التحكم الوصول إليها وتحويلها إلى عنوان IP. لا يُدعم HTTPS.

ملحوظة: إذا كنت تستخدم عنوان IP، فيجب عليك التأكد من أنه لن يتغير عن طريق تعيين عنوان IP ثابت أو إنشاء حجز DHCP.

ميناء
يُعيّن منفذ الجهاز. المنفذ الافتراضي لأجهزة ESPHome هو 6053.

• وضع المصادقة [ لا شيء | كلمة المرور | مفتاح التشفير ]
• حدد طريقة المصادقة للاتصال بجهاز ESPHome.

لا أحد: لا يتطلب أي مصادقة.

كلمة المرور: استخدم كلمة مرور للمصادقة (انظر أدناه).

مفتاح التشفير: استخدم مفتاح التشفير للاتصال الآمن (انظر أدناه).

• كلمة المرور
  يُعرض فقط إذا تم ضبط وضع المصادقة على كلمة مرور. يُعيّن كلمة مرور الجهاز. يجب أن تتطابق هذه الكلمة مع كلمة المرور المُعدّة على جهاز ESPHome.
• مفتاح التشفير
  يُعرض فقط إذا تم ضبط وضع المصادقة على مفتاح التشفير. يُعيّن مفتاح تشفير الجهاز للاتصال الآمن. يجب أن يتطابق هذا المفتاح مع مفتاح التشفير المُهيأ على جهاز ESPHome.

معلومات الجهاز

• الاسم (للقراءة فقط)
  يعرض اسم جهاز ESPHome المتصل.
• النموذج (للقراءة فقط)
  يعرض طراز جهاز ESPHome المتصل.
• الشركة المصنعة (للقراءة فقط)
  يعرض الشركة المصنعة لجهاز ESPHome المتصل.
• عنوان MAC (للقراءة فقط)
  يعرض عنوان MAC لجهاز ESPHome المتصل.
• إصدار البرنامج الثابت (للقراءة فقط)
  يعرض إصدار البرنامج الثابت لجهاز ESPHome المتصل.

إجراءات السائق

إعادة تعيين الاتصالات والمتغيرات

تحذير: سيؤدي هذا إلى إعادة تعيين كافة ارتباطات الاتصال وحذف أي برمجة مرتبطة بالمتغيرات.

إعادة ضبط اتصالات ومتغيرات برنامج التشغيل. هذا مفيد إذا غيّرت جهاز ESPHome المتصل، أو إذا كانت هناك اتصالات أو متغيرات قديمة.

دليل تكوين ratgdo

يوفر هذا الدليل إرشادات حول تكوين برنامج تشغيل ESPHome للعمل مع أجهزة ratgdo للتحكم في باب المرآب عبر مرحلات في Control4 Composer Pro.

إضافة برنامج تشغيل وحدة التحكم في التتابع
قم بإضافة برنامج تشغيل وحدة التحكم المطلوبة إلى مشروع Control4 الخاص بك في Composer Pro.

خصائص وحدة التحكم في التتابع
يعرض جهاز ratgdo كيان "غطاء" في ESPHome، والذي يتم تعيينه إلى وظيفة وحدة التحكم في التتابع في Control4.

عدد المرحلات
يستخدم جهاز ratgdo إعدادًا متعدد المرحلات للتحكم في باب المرآب. في برنامج Composer Pro، يجب ضبط إعدادات المرحلات كما يلي:

• ضبط على 2 مرحلات (فتح/إغلاق) أو 3 مرحلات (فتح/إغلاق/إيقاف)
  • يستخدم جهاز ratgdo أوامر منفصلة لفتح وإغلاق باب المرآب
  • إذا كان برنامج ratgdo لديك يدعم أمر "الإيقاف"، فقم بتكوينه لثلاثة مرحلات لتفعيل وظيفة الإيقاف. إذا لم تكن متأكدًا، يمكنك مراجعة اتصالات ratgdo في Composer Pro لمعرفة ما إذا كان مرحل "باب الإيقاف" متاحًا.

تكوين المرحل

• تم ضبطه على نبض
  • يستخدم ratgdo نبضات لحظية لتشغيل فتاحة باب المرآب، على غرار الضغط على زر الحائط

وقت النبض

• اضبط جميع أوقات نبضات التتابع على 500 (تقصير)
  • هذه هي المدة التي سيتم فيها تنشيط التتابع

مرحل عكسي

• تعيين جميع خصائص التتابع العكسي إلى لا (تقصير)

اتصل بـ Debounce

• تعيين جميع أوقات إلغاء الارتداد الخاصة بجهات الاتصال إلى 250 (تقصير)
  • يساعد هذا في منع التذبذب الخاطئ لأجهزة استشعار حالة باب المرآب

عكس جهة الاتصال

• تعيين جميع خصائص الاتصال العكسية إلى لا (تقصير)

Exampخصائص le
للإشارة، هنا مثالampعرض خصائص وحدة التحكم في التتابع في Composer Pro:

توصيلات وحدة التحكم في التتابع

المرحلات

• يفتح: الاتصال بمرحل "الباب المفتوح" الخاص بـ ratgdo
• يغلق: الاتصال بمرحل "إغلاق الباب" الخاص بـ ratgdo
• توقف: قم بالاتصال بمرحل "Stop Door" الخاص بـ ratgdo، إذا كان متاحًا

الاتصال بالمجسات

• جهة اتصال مغلقة: الاتصال بجهة الاتصال "الباب مغلق" الخاصة بـ ratgdo
• جهة الاتصال المفتوحة: الاتصال بجهة اتصال "الباب مفتوح" الخاصة بـ ratgdo

Exampاتصالات لو
للإشارة، هنا مثالampنظرة على كيفية ظهور الاتصالات في Composer Pro:

برمجة
يمكنك إنشاء البرمجة في Control4 لـ:

• فتح/إغلاق باب المرآب بناءً على الأحداث
• مراقبة حالة باب المرآب
• إعداد إشعارات لتغييرات حالة باب المرآب
• إنشاء أزرار مخصصة على شاشات اللمس وأجهزة التحكم عن بعد

Example: إنشاء تنبيه لا يزال مفتوحًا

استخدام خاصية "وقت الاستمرار في العمل" من برنامج تشغيل وحدة التحكم في التتابع:

1. اضبط "وقت البقاء مفتوحًا" على المدة المطلوبة (على سبيل المثال، 10 دقائق)
2. إنشاء قاعدة برمجة يتم تشغيلها عند تشغيل حدث "لا يزال مفتوحًا"
3. إضافة إجراءات لإرسال الإشعارات أو تنفيذ مهام أخرى

كيانات إضافية
بناءً على جهاز ratgdo والبرامج الثابتة وإمكانياته، قد تظهر كيانات إضافية يعرضها برنامج تشغيل ESPHome. قد تأتي هذه الكيانات على شكل اتصالات إضافية أو متغيرات برنامج تشغيل.

يرجى الرجوع إلى وثائق ratgdo للحصول على مزيد من المعلومات حول الكيانات المحددة: https://ratgdo.github.io/esphome-ratgdo/webui_documentation.html

معلومات المطور
حقوق الطبع والنشر © 2025 Finite Labs LLC
جميع المعلومات الواردة هنا هي، وتظل، ملكًا لشركة Finite Labs LLC ومورديها، إن وُجدوا. المفاهيم الفكرية والتقنية الواردة هنا هي ملكية خاصة لشركة Finite Labs LLC ومورديها، إن وُجدوا.
قد تكون شركة Finite Labs LLC ومورديها مشمولين ببراءات اختراع أمريكية وأجنبية، وبراءات اختراع قيد التطوير، ومحمية بموجب قانون الأسرار التجارية أو حقوق النشر. يُمنع منعًا باتًا نشر هذه المعلومات أو إعادة إنتاج هذه المواد إلا بعد الحصول على إذن كتابي مسبق من شركة Finite Labs LLC. للحصول على أحدث المعلومات، يُرجى زيارة https://drivercentral.io/platforms/control4-drivers/utility/esphome

يدعم
إذا كانت لديك أي أسئلة أو مشكلات تتعلق بدمج هذا البرنامج مع Control4 أو ESPHome، فيمكنك الاتصال بنا على driver-support@finitelabs.com أو اتصل بنا/أرسل لنا رسالة نصية على الرقم +1 949-371-5805.

سجل التغييرات

الإصدار 20250715 – 2025-07-14

• مُثَبَّت: تم إصلاح الخطأ الذي يتسبب في عدم اكتشاف الكيانات عند الاتصال

الإصدار 20250714 – 2025-07-14

• تمت الإضافة: تمت إضافة دعم للاتصالات المشفرة باستخدام تشفير الجهاز

الإصدار 20250619 – 2025-06-19

• تمت الإضافة :تمت إضافة وثائق خاصة بـ ratgdo

الإصدار 20250606 – 2025-06-06

• تمت الإضافة :الإصدار الأولي

التعليمات

ما هي الأجهزة المتوافقة مع هذا التعريف؟

هذا البرنامج متوافق مع جميع أجهزة ESPHome، وقد أُجريت عليه اختبارات مكثفة على أجهزة ratgdo. إذا جربته على أي جهاز آخر ونجح، يُرجى إبلاغنا للتحقق.

المستندات / الموارد

ESPHome ESP8266 الاتصال الفعلي بجهازك [بي دي اف] دليل المستخدم ESP8266، ESP32، ESP8266 الاتصال الفعلي بجهازك، ESP8266، الاتصال الفعلي بجهازك، الاتصال بجهازك، بجهازك، جهازك

مراجع

• دليل المستخدم