Unduh ha duke energy gateway - Unduh Kode Sumber ha duke energy gateway

ha duke energy gateway

Pembangun Kekuatan

v0.1.7

Unduh

Penting - Tercerahkan

Duke Energy menutup program percontohan Gateway pada akhir Juni 2023. Integrasi ini telah berhenti berfungsi dan sudah usang.

Gerbang Energi Duke

Ini adalah integrasi khusus untuk asisten rumah. Ini menarik penggunaan energi real-time dari Duke Energy melalui program percontohan Duke Energy Gateway.

Integrasi ini memanfaatkan Perpustakaan pyduke-energy , juga ditulis oleh saya, untuk menarik data. API ini sangat tidak resmi dan mungkin berhenti bekerja kapan saja (lihat Penafian).

Prasyarat! (Tolong baca)

Anda diharuskan memiliki gateway Duke Energy yang terhubung ke smartmeter Anda agar ini berfungsi. Ini adalah perangkat yang terpisah dari meteran pintar Anda dan disediakan oleh program hanya undangan saat ini. Jika Anda tidak tahu apa ini, maka Anda mungkin tidak memilikinya. Integrasi ini tidak mendukung metode lain untuk mengambil data (lihat Persyaratan Gateway).

Sensor

Komponen ini akan mengatur entitas berikut:

`sensor.duke_energy_current_usage_w`

Mewakili penggunaan daya real-time di watts.
Data ini didorong dari perangkat gateway setiap 1-3 detik. Catatan: Ini menghasilkan banyak data. Jika interval pembaruan ini terlalu sering untuk Anda, Anda dapat mengkonfigurasi interval pelambatan dalam hitungan detik (lihat konfigurasi di bawah).
Perhatikan bahwa karena ini adalah penggunaan daya, tidak dapat digunakan apa adanya untuk dasbor energi asisten rumah. Sebagai gantinya, Anda dapat menggunakan sensor sensor.duke_energy_usage_today_kwh , atau Anda perlu memberi makan sensor waktu-nyata ini melalui integrasi integral Riemann Sum.
Atribut tambahan tersedia yang berisi ID meter dan ID gateway.

`sensor.duke_energy_usage_today_kwh`

Mewakili konsumsi energi saat ini dalam kilowatt-jam (dari 0:00 waktu setempat hingga 23:59 waktu setempat, lalu mengatur ulang).
Data ini disurvei setiap 60 detik, tetapi data mungkin ditunda hingga 15 menit karena keterlambatan dalam Duke Energy melaporkannya (lihat batasan dalam repo pyduke-energy .).
Ini dapat digunakan apa adanya untuk dasbor konsumsi energi asisten rumah.
Atribut tambahan tersedia yang berisi ID meter, ID gateway, dan cap waktu pengukuran terakhir.

Instalasi

Instalasi HACS

Tambahkan sebagai repositori khusus di bawah Pengaturan di HACS: mjmeli/ha-duke-energy-gateway dan pilih Integration sebagai kategori.
Cari "Duke Energy Gateway" di HACS dan integrasi sekarang harus dikembalikan sebagai hasil pencarian. Klik di atasnya, klik tombol "Unduh", dan berjalan melalui petunjuk untuk mengunduh.
Mulai ulang asisten rumah
Di ha ui buka "pengaturan" -> "perangkat dan layanan", pastikan Anda berada di tab Integrasi, lalu klik "+" dan cari "Duke Energy Gateway". Ini akan memungkinkan Anda mengaturnya.

Instalasi Manual

Menggunakan alat pilihan buka direktori (folder) untuk konfigurasi HA Anda (di mana Anda menemukan configuration.yaml ).
Jika Anda tidak memiliki direktori (folder) custom_components di sana, Anda perlu membuatnya.
Di direktori custom_components (folder) Buat folder baru yang disebut duke_energy_gateway .
Unduh semua file dari custom_components/duke_energy_gateway/ Directory (folder) di repositori ini.
Tempatkan file yang Anda unduh di direktori baru (folder) yang Anda buat.
Mulai ulang asisten rumah
Di ha ui buka "pengaturan" -> "perangkat dan layanan", pastikan Anda berada di tab Integrasi, lalu klik "+" dan cari "Duke Energy Gateway". Ini akan memungkinkan Anda mengaturnya.

Konfigurasi

Konfigurasi akan dilakukan di UI. Awalnya, Anda perlu memberikan data berikut:

Data	Keterangan
`email`	Email login Anda ke Duke Energy.
`password`	Kata sandi login Anda ke Duke Energy.

Setelah integrasi diatur, Anda akan dapat melakukan konfigurasi lebih lanjut dengan mengklik "Konfigurasi" pada halaman Integrasi. Ini akan memungkinkan Anda untuk memodifikasi opsi berikut:

Data	Keterangan
`Real-time Usage Update Interval (sec)`	Secara default, sensor penggunaan waktu-nyata akan diperbarui kapan saja pembacaan masuk. Jika data ini terlalu sering, Anda dapat mengonfigurasi nilai ini untuk membatasi data. Saat diatur ke Integer `X` positif, sensor hanya akan diperbarui setiap `X` detik. Dengan kata lain, jika diatur ke 30, Anda akan mendapatkan penggunaan real-time baru setiap ~ 30 detik.

Pemilihan meter

Aliran konfigurasi akan secara otomatis mencoba mengidentifikasi gateway dan smartmeter Anda. Saat ini, hanya satu yang didukung per akun. Yang pertama diidentifikasi akan digunakan. Jika seseorang tidak dapat ditemukan, proses konfigurasi harus gagal.

Jika pemilihan meteran Anda gagal, langkah pertama adalah memungkinkan logging untuk komponen (lihat logging). Jika ini tidak memberikan wawasan tentang masalah tersebut, silakan buka masalah GitHub.

Logging

Jika Anda mengalami masalah apa pun dan ingin melihat ke log, integrasi ini menyediakan logging verbose di tingkat debug. Itu dapat diaktifkan dengan menambahkan yang berikut ke file configuration.yaml Anda.

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

Perkembangan

Saya sarankan menggunakan wadah dev untuk pengembangan dengan membuka dalam kode Visual Studio dengan code . dan mengklik opsi untuk membuka kembali dengan Container Dev. Dalam VS Code, Anda dapat menjalankan tugas "Run Home Assistant di port 9123" dan kemudian mengaksesnya melalui http: // localhost: 9123.

Jika Anda ingin menginstal secara manual, Anda dapat menginstal dependensi DEV dengan pip install -r requirements_dev.txt .

Sebelum berkomitmen, jalankan pre-commit run --all-files .

Bekerja dengan dalam Versi `pyduke-energy` Pengembangan

Jika Anda sedang berupaya menerapkan perubahan baru dari pyduke-energy tetapi tidak ingin merilis versi perpustakaan itu, Anda dapat mengatur lingkungan pengembangan Anda untuk menginstal dari cabang yang bekerja jauh.

Perbarui requirements_dev.txt untuk menggantikan main di git+https://github.com/mjmeli/pyduke-energy@main dengan cabang kerja Anda dan perbarui nama pengguna jika Anda memiliki garpu (misalnya git+https://github.com/notmjmeli/pyduke-energy@new-feature-dev-branch
Hapus instal Versi pyduke-energy Lokal: pip uninstall -y pyduke-energy
Run Run Instalasi Persyaratan: pip install -r requirements_dev.txt