easee_hass

مهم!

يرجى الترقية إلى الإصدار v0.9.64 أو الإصدار الأحدث في أقرب وقت ممكن إذا كنت تستخدم إصدارًا بين الإصدار v0.9.58 وv0.9.62! واجهت جميع إصدارات هذا التكامل بين الإصدارين v0.9.58 وv0.9.62 مشكلة في معالجة أخطاء إعادة توصيل الإشارة والتي تتسبب في فشل الكثير من عمليات الوصول إلى خوادم إشارة Easee. سيساعد تثبيت إصدار أحدث على تحسين استقرار خوادم Easee وتحرير الموارد من أجل استجابة أسرع. ربما لم تواجه أية مشكلات في التثبيت الخاص بك، ولكن كان هناك الكثير من المشكلات تحت الغطاء. اطلع على مزيد من التفاصيل في مذكرة إصدار الإصدار 0.9.64.

قم بتخفيف مكون شاحن EV للمساعد المنزلي

مكون مخصص لدعم أجهزة الشحن والمعادلات Easee EV.

مستشعر الحالة هو المستشعر الافتراضي ويحتوي على القيم التالية

 disconnected
awaiting_start
charging
ready_to_charge
completed
error

يتم تعطيل بعض المستشعرات الأخرى غير الشائعة مثل التيار والجهد افتراضيًا (تظهر على أنها "غير متاحة"). يمكن تمكينها في واجهة المستخدم الرسومية HA عبر التكاملات->[الاسم الميسر]->الأجهزة->[اسم المعادل السهل] وتحت التشخيص، انقر على التيار/الجهد->gear_icon ثم قم بتمكينه. يحتوي كل من هذه المستشعرات أيضًا على سمات تحتوي على قيم مثل التيار والجهد لكل مرحلة. راجع رقم 271 حول كيفية استخدام هذه السمات.

تثبيت

هناك طريقتان مختلفتان لتثبيت المكون المخصص

تركيب HACS

1. أضف هذا المستودع من HACS->التكاملات.
2. إعادة تشغيل مساعد المنزل.
3. قم بتثبيت المكون من الإعدادات->التكاملات. قد يتعين عليك مسح ذاكرة التخزين المؤقت للمتصفح لإظهار تكامل Easee في القائمة.

تركيب جيت

1. تأكد من تثبيت git على جهازك.
2. انتقل إلى مجلد تكوين المساعد المنزلي الخاص بك.
3. إنشاء مجلد custom_components غير موجود، انتقل إلى الأسفل فيه بعد الإنشاء.
4. قم بتنفيذ الأمر التالي: git clone https://github.com/nordicopen/easee_hass.git easee
5. قم بتشغيل bash links.sh

أجهزة شحن/معادلات مراقبة

منذ الإصدار 0.9.47، يتضمن التكامل فقط أجهزة الشحن ومعادلات الصوت التي تمت إضافتها إلى تطبيق Easee الرسمي، بدلاً من إظهار كل ما هو متاح للمستخدم الذي قام بتسجيل الدخول. تم إجراء هذا التغيير لأنه في التركيبات الأكبر حجمًا قد يكون هناك 10 أو 100 ثانية من أجهزة الشحن المدرجة، وهو ما لا يكون منطقيًا في معظم الحالات. لذا، إذا لم تتمكن من رؤية جميع منتجاتك في عملية التكامل، فافتح التطبيق الرسمي وتأكد من إدراجها هناك أولاً. لاحظ أيضًا أنه إذا لم تتم إضافة أي أجهزة شحن على الإطلاق إلى التطبيق، فسيتم عرض رسالة الخطأ "لم يتم العثور على مواقع في هذا الحساب" عند التثبيت.

إعدادات

يتم التكوين من خلال Configuration > Integrations حيث تقوم بتكوينه أولاً ثم تعيين الخيارات لما تريد مراقبته.

يستخدم

يجب أن يكون الاستخدام الأساسي لعمليات التكامل من واجهة المستخدم واضحًا بذاته. يحدد التكامل عددًا من الخدمات التي يمكن استخدامها من عمليات التشغيل الآلي والبرامج النصية للتحكم في الشاحن وعملية الشحن. يمكن العثور على الخدمات المتاحة في Home Assistant في أدوات المطور->الخدمات.

أسهل طريقة لإعداد الخدمات ومعلماتها هي استخدام محرر التشغيل الآلي أو أدوات المطور. ومع ذلك، يمكنك أيضًا كتابة الكود بلغة yaml البسيطة. ستستخدم واجهة المستخدم Device_id كهدف للخدمات. هذه سلسلة عشوائية تم إنشاؤها داخليًا بواسطة HA وهي ليست سهلة الاستخدام للغاية. للتبسيط بالنسبة للمبرمجين المتشددين وللتوافق مع الإصدارات السابقة من هذا التكامل، يمكنك أيضًا استخدام charger_id أو Circuit_id كأهداف. ثلاثة أمثلة من شأنها أن تفعل الشيء نفسه:

 service : easee.set_circuit_dynamic_limit
data :
  device_id : b40f1f45d28b0891
  current_p1 : 10 

 service : easee.set_circuit_dynamic_limit
data :
  charger_id : EVK1234
  current_p1 : 10 

 service : easee.set_circuit_dynamic_limit
data :
  circuit_id : 30456
  current_p1 : 10

للحصول على تفاصيل حول Easee API، يرجى الرجوع إلى https://developer.easee.cloud/reference

تسجيل التصحيح

يمكن تمكين سجل التصحيح الكامل عن طريق إدخال ما يلي في configuration.yaml yaml وإعادة تشغيل Home Assistant

 logger :
  default : info
  logs :
    pyeasee : debug
    custom_components.easee : debug 

حاوية التطوير

أحد خيارات التطوير هو استخدام VS Code Dev Container. تحتاج إلى تثبيت Docker.

1. افتح رمز vscode فارغًا جديدًا
2. حدد لوحة الأوامر->حاويات التطوير: استنساخ المستودع في وحدة تخزين الحاوية المسماة
3. اتبع المطالبات
4. انتظر حتى يتم بناء الحاوية.
5. اضغط على Ctrl + Shift + P وحدد Tasks: Run Task > Run Home Assistant on port 9125 .
6. انتظر حتى يبدأ Home Assistant وانتقل إلى http://localhost:9125/.
7. قم بالتجول عبر واجهة المستخدم الأولى لـ Home Assistant.
8. انتقل إلى http://localhost:9125/config/integrations، وانقر فوق Add Integration وأضف تكامل Easee .
9. لتصحيح الأخطاء، اضغط على F5 لتوصيله بـ Home Assistant الذي يعمل في الحاوية.

تشغيل دائما

$ make lint

قبل دفع التغييرات الخاصة بك.

ترجمة

نحن نستخدم Lokalise للتعامل مع تقديم الترجمات. إنها توفر لنا منصة مذهلة سهلة الاستخدام والصيانة.

للمساعدة في ترجمة تكامل Easee انقر هنا. إذا طُلب منك تسجيل الدخول، فمن الأسهل عادة استخدام "تسجيل الدخول باستخدام GitHub".

إذا كنت تريد إضافة لغة جديدة، يرجى فتح مشكلة هنا في هذا الريبو.

يتم سحب الترجمات عند إعداد إصدار جديد من التكامل. لذلك يجب عليك الانتظار حتى يكون هناك إصدار جديد حتى تبحث عن تحديثاتك.

إذا كنت تريد إضافة عناصر جديدة تحتاج إلى ترجمة، فيجب عليك إدخالها في /translations/en.json وإرسال بيان العلاقات العامة. ستظهر المفاتيح الجديدة في Lokalise عند دمج العلاقات العامة.

الإسناد والدعم والتعاون

بدأ هذا المشروع من قبل الراحل نيكلاس فوندبيرج، @fondberg. لقد ورث المستودع من قبل المتعاونين معه.

المشروع مدعوم من