ha duke energy gateway

مهم - تم إهماله

أغلق Duke Energy برنامج Gateway Pilot في نهاية يونيو 2023. لقد توقف هذا التكامل عن العمل ويتم إهماله.

بوابة ديوك للطاقة

هذا تكامل مخصص لمساعد المنزل. إنه يسحب استخدام الطاقة في الوقت الفعلي من Duke Energy عبر برنامج Duke Energy Gateway Pilot.

يستفيد هذا التكامل من مكتبة pyduke-energy ، التي كتبها أيضًا ، لسحب البيانات. واجهة برمجة التطبيقات هذه غير رسمية للغاية وقد تتوقف عن العمل في أي وقت (انظر إخلاء المسئولية).

المتطلبات المسبقة! (الرجاء القراءة)

يطلب منك أن يكون لديك بوابة Duke Energy متصلة بمقياس SmartMeter حتى يعمل هذا. هذا جهاز منفصل عن عدادك الذكي ويتم توفيره بواسطة برنامج دعوة فقط في الوقت الحالي. إذا كنت لا تعرف ما هذا ، فمن المحتمل ألا يكون لديك. لا يدعم هذا التكامل أي طريقة أخرى لاسترداد البيانات (انظر متطلبات البوابة).

أجهزة استشعار

سيقوم هذا المكون بإعداد الكيانات التالية:

sensor.duke_energy_current_usage_w

• يمثل استخدام القوة في الوقت الحقيقي في واتس.
• يتم دفع هذه البيانات من جهاز البوابة كل 1-3 ثوان. ملاحظة: هذا ينتج الكثير من البيانات. إذا كان فاصل التحديث هذا متكررًا جدًا بالنسبة لك ، فيمكنك تكوين فاصل خنق في ثوانٍ (انظر التكوين أدناه).
• لاحظ أنه نظرًا لأن هذا هو استخدام الطاقة ، فلا يمكن استخدامه كما هو الحال بالنسبة للوحة معلومات Home Assistant Energy. بدلاً من ذلك ، يمكنك استخدام مستشعر sensor.duke_energy_usage_today_kwh ، أو تحتاج إلى إطعام هذا المستشعر في الوقت الحقيقي من خلال تكامل المبلغ Riemann Sum.
• تتوفر سمات إضافية تحتوي على معرف العداد ومعرف البوابة.

sensor.duke_energy_usage_today_kwh

• يمثل استهلاك الطاقة اليوم في كيلووات ساعة (من الساعة 0:00 بالتوقيت المحلي إلى 23:59 بالتوقيت المحلي ، ثم إعادة ضبط).
• يتم استطلاع هذه البيانات كل 60 ثانية ، ولكن قد يتم تأخير البيانات حتى 15 دقيقة بسبب التأخير في Duke Energy الإبلاغ عنها (انظر القيود في pyduke-energy Repo.).
• يمكن استخدام هذا كما هو الحال بالنسبة للوحة معلومات استهلاك الطاقة المساعد للمنزل.
• تتوفر سمات إضافية تحتوي على معرف العداد ، معرف البوابة ، وخط الطابع الزمني للقياس الأخير.

تثبيت

تثبيت HACS

1. أضف كمستودع مخصص ضمن الإعدادات في HACS: mjmeli/ha-duke-energy-gateway واختر Integration كفئة.
2. ابحث عن "Duke Energy Gateway" في HACS ويجب الآن إعادة التكامل كنتيجة بحث. انقر فوقه ، انقر فوق الزر "تنزيل" ، والمشي عبر المطالبات للتنزيل.
3. أعد تشغيل مساعد المنزل
4. في HA UI ، انتقل إلى "الإعدادات" -> "الأجهزة والخدمات" ، تأكد من وجودك في علامة التبويب Integrations ، ثم انقر فوق "+" والبحث عن "Duke Energy Gateway". هذا سوف يتيح لك إعداده.

التثبيت اليدوي

1. باستخدام أداة الاختيار افتح الدليل (المجلد) لتكوين HA (حيث تجد configuration.yaml ).
2. إذا لم يكن لديك دليل custom_components (المجلد) هناك ، فأنت بحاجة إلى إنشائه.
3. في دليل custom_components (المجلد) ، قم بإنشاء مجلد جديد يسمى duke_energy_gateway .
4. قم بتنزيل جميع الملفات من custom_components/duke_energy_gateway/ directory (المجلد) في هذا المستودع.
5. ضع الملفات التي قمت بتنزيلها في الدليل الجديد (المجلد) الذي أنشأته.
6. أعد تشغيل مساعد المنزل
7. في HA UI ، انتقل إلى "الإعدادات" -> "الأجهزة والخدمات" ، تأكد من وجودك في علامة التبويب Integrations ، ثم انقر فوق "+" والبحث عن "Duke Energy Gateway". هذا سوف يتيح لك إعداده.

إعدادات

سيتم التكوين في واجهة المستخدم. في البداية ، ستحتاج إلى توفير البيانات التالية:

بيانات	وصف
email	بريدك الإلكتروني تسجيل الدخول إلى Duke Energy.
password	كلمة مرور تسجيل الدخول إلى Duke Energy.

بعد إعداد التكامل ، ستتمكن من القيام بمزيد من التكوين عن طريق النقر فوق "تكوين" على صفحة التكامل. سيتيح لك ذلك تعديل الخيارات التالية:

بيانات	وصف
Real-time Usage Update Interval (sec)	بشكل افتراضي ، سيتم تحديث مستشعر الاستخدام في الوقت الفعلي في أي وقت تأتي فيه القراءة. إذا كانت هذه البيانات متكررة للغاية ، فيمكنك تكوين هذه القيمة لخنق البيانات. عند ضبط عدد صحيح إيجابي X ، سيتم تحديث المستشعر إلا مرة واحدة كل ثواني X بمعنى آخر ، إذا تم ضبطها على 30 ، فستحصل على استخدام جديد في الوقت الفعلي كل 30 ثانية.

اختيار متر

سيحاول تدفق التكوين تلقائيًا تحديد البوابة ومقير SmartMeter. في الوقت الحالي ، يتم دعم واحد فقط لكل حساب. سيتم استخدام أول واحد تم تحديده. إذا كان لا يمكن العثور على المرء ، فيجب أن تفشل عملية التكوين.

إذا فشل اختيار العداد الخاص بك ، فيجب أن تكون الخطوة الأولى هي تمكين التسجيل للمكون (انظر التسجيل). إذا كان هذا لا يعطي نظرة ثاقبة للمشكلة ، فيرجى فتح مشكلة github.

قطع الأشجار

إذا واجهت أي مشكلات وترغب في النظر في السجلات ، فإن هذا التكامل يوفر تسجيلًا مطولاً على مستوى التصحيح. يمكن تمكين ذلك عن طريق إضافة ما يلي إلى ملف configuration.yaml الخاص بك.

 logger :
  default : info
  logs :
    custom_components.duke_energy_gateway : debug
    pyduke_energy.client : debug
    pyduke_energy.realtime : debug 

تطوير

أقترح استخدام حاوية Dev للتطوير عن طريق فتح في Visual Studio Code مع code . والنقر على خيار إعادة فتح مع حاوية DEV. في VS Code ، يمكنك تشغيل المهمة "Run Home Assistant على المنفذ 9123" ثم الوصول إليها عبر http: // localhost: 9123.

إذا كنت ترغب في التثبيت يدويًا ، فيمكنك تثبيت Dev تبعيات مع pip install -r requirements_dev.txt .

قبل الارتباط ، قم بتشغيل pre-commit run --all-files .

العمل مع إصدارات pyduke-energy

إذا كنت تعمل على تنفيذ تغييرات جديدة من pyduke-energy ولكنك لا ترغب في إصدار إصدار من تلك المكتبة ، فيمكنك إعداد بيئة التطوير الخاصة بك للتثبيت من فرع عمل عن بُعد.

1. تحديث requirements_dev.txt لاستبدال main في git+https://github.com/mjmeli/pyduke-energy@main مع فرع العمل الخاص بك وتحديث اسم المستخدم إذا كان لديك شوكة (على سبيل المثال git+https://github.com/notmjmeli/pyduke-energy@new-feature-dev-branch
2. قم بإلغاء التثبيت نسخة مخزولة محليًا من pyduke-energy : pip uninstall -y pyduke-energy
3. إعادة تشغيل متطلبات إعادة تشغيل: pip install -r requirements_dev.txt

المساهمات مرحب بها!

إذا كنت تريد المساهمة في هذا ، فيرجى قراءة إرشادات المساهمة

الاعتمادات

تم إنشاء هذا المشروع من قالب CookieCutter المخصص لـ oncleben31.

تم أخذ قالب الرمز بشكل أساسي من قالب integration_blueprint من @ludeeus

---