وثائق eWeLinkHome Assistant
تعرّف على كيفية ربط أجهزة eWeLink بـ Home Assistant باستخدام الإضافة الرسمية eWeLink Smart Home.
أولاً: الميزات
- تدعم الإضافة الرسمية حالياً مفاتيح ومقابس eWeLink. سيتم دعم المزيد من أجهزة eWeLink في الإصدارات القادمة.
- دعم وضع Sonoff DIY.
- الأولوية للتحكم في الأجهزة عبر الشبكة المحلية. إذا كان الجهاز لا يدعم وضع LAN أو غير متصل بالشبكة المحلية، يمكنك التحكم في الجهاز عبر السحابة.
- مزامنة فورية لحالة الجهاز ومعلومات التكوين. يمكن تعديل اسم الجهاز والتكوين لاحقاً.
- يدعم فقط Home Assistant المثبّت عبر HassOS و Supervisor.
ثانياً: المتطلبات المسبقة
إنشاء رموز وصول طويلة الأمد
تقوم إضافة eWeLink بربط أجهزة eWeLink المدعومة من خلال استدعاء REST API و WebSocket API الخاصة بـ Home Assistant. يتطلب ذلك رمز وصول طويل الأمد.
سجّل الدخول إلى وحدة تحكم Home Assistant Lovelace (عادةً يكون العنوان http://homeassistant.local:8123/)، انقر على اسم المستخدم في أسفل الشريط الجانبي للدخول إلى ملف المستخدم، ابحث عن خيار «رموز الوصول طويلة الأمد» في أسفل الصفحة وانقر على إنشاء رمز. أدخل اسماً للرمز في مربع الحوار (يُوصى باستخدام eWeLink_HA_AddOn) وانقر على موافق. انسخ الرمز الذي تم إنشاؤه واحفظه في مكان آمن.
ثالثاً: التثبيت
سجّل الدخول إلى وحدة تحكم Home Assistant Lovelace (عادةً يكون العنوان http://homeassistant.local:8123/)، انقر على Supervisor في الشريط الجانبي لفتح لوحة تحكم HassOS، وانتقل إلى علامة التبويب Add-on Store. انقر على النقاط الثلاث العمودية في الزاوية العلوية اليمنى، واختر Repositories من القائمة المنبثقة، وأدخل عنوان الإضافة الرسمية لـ eWeLink: https://github.com/CoolKit-Technologies/ha-addon في مربع حوار «إدارة مستودعات الإضافات»، ثم انقر على ADD. بعد إغلاق مربع الحوار، ستتمكن من رؤية إضافة eWeLink المضافة حديثاً في صفحة Add-on Store.
انقر على بطاقة eWeLink Smart Home لفتح صفحة معلومات الإضافة، انقر على INSTALL وانتظر حتى تكتمل عملية التثبيت. عند الانتهاء، لا تنقر على START فوراً، بل انتقل إلى Configuration، وأدخل رمز الوصول طويل الأمد وانقر على Save. ثم عد إلى علامة التبويب Information وانقر على START لتفعيل إضافة «eWeLink Smart Home».
للوصول السريع إلى إضافة eWeLink Smart Home، يمكنك تفعيل خيار Show in sidebar (إظهار في الشريط الجانبي).
يجب تغيير home_assistant_url إذا كنت تستخدم Docker أو إصدارات أخرى من Home Assistant غير Home Assistant OS.
رابعاً: التكوين
التحكم في أجهزة eWeLink DIY
تحكم في أجهزة eWeLink DIY عبر الشبكة المحلية أو سجّل الدخول إلى حساب eWeLink للتحكم في جميع أجهزة eWeLink المدعومة.
سجّل الدخول إلى وحدة تحكم Home Assistant Lovelace (عادةً يكون العنوان http://homeassistant.local:8123/)، انقر على Supervisor في الشريط الجانبي لفتح لوحة تحكم HassOS، ثم انقر على بطاقة eWeLink Smart Home للدخول إلى صفحة معلومات الإضافة. انقر على OPEN WEB UI، ستعرض صفحة واجهة الويب الخاصة بـ eWeLink Smart Home جميع أجهزة DIY على الشبكة المحلية المكتشفة عبر mDNS. يمكنك أيضاً النقر على زر Login في الزاوية العلوية اليسرى وتسجيل الدخول إلى حساب eWeLink لربط جميع الأجهزة المدعومة.
حالياً، يدعم الإصدار التجريبي المفاتيح والمقابس فقط، وسيتم دعم المزيد من أنواع الأجهزة قريباً.
إعداد المشاهد والأتمتة
الأجهزة المتصلة عبر REST API و WebSocket API الخاصة بـ Home Assistant يمكن تعيينها فقط ككيانات وليس كأجهزة، مما يجعل من المستحيل التحكم مباشرة في الأجهزة عبر مشاهد وأتمتة Home Assistant.
لحل هذه المشكلة، تحتاج إلى تفعيل الوضع المتقدم (وحدة تحكم Lovelace > الملف الشخصي > Advanced Mode).
لاستخدام أجهزة eWeLink المدعومة في الأتمتة، تحتاج أولاً إلى إنشاء مشهد يحتوي على أجهزتك، ثم اختيار تفعيل السيناريو في الإجراء > نوع الإجراء في الأتمتة.
