easee_hass

PENTING!

Harap tingkatkan ke v0.9.64 atau versi yang lebih baru sesegera mungkin jika Anda menjalankan versi antara v0.9.58 dan v0.9.62! Semua versi integrasi antara v0.9.58 dan v0.9.62 ini mengalami masalah pada penanganan error signalr reconnect yang menyebabkan banyak kegagalan akses ke server Easee signalr. Menginstal versi yang lebih baru akan membantu meningkatkan stabilitas server Easee dan membebaskan sumber daya untuk respons yang lebih cepat. Anda mungkin tidak mengalami masalah apa pun dalam instalasi Anda, tetapi sebenarnya ada banyak masalah. Lihat detail selengkapnya di catatan rilis v0.9.64.

Komponen pengisi daya Easee EV untuk Home Assistant

Komponen khusus untuk mendukung pengisi daya dan equalizer Easee EV.

Sensor status adalah sensor default dan memiliki nilai berikut

 disconnected
awaiting_start
charging
ready_to_charge
completed
error

Beberapa sensor non-umum lainnya seperti Arus dan Tegangan dinonaktifkan secara default (ditampilkan sebagai "tidak tersedia"). Mereka dapat diaktifkan di HA GUI melalui Integrasi->[Easee Name]->Devices->[Easee Equilizer Name] dan di bawah Diagnostic klik Current/Voltage->gear_icon lalu Aktifkan. Masing-masing sensor ini juga memiliki atribut yang berisi nilai seperti arus dan tegangan per fasa. Lihat #271 tentang cara menggunakan atribut ini.

Instalasi

Ada 2 metode berbeda untuk menginstal komponen khusus

instalasi HACS

1. Tambahkan repositori ini dari HACS->Integrations.
2. Mulai ulang Asisten Rumah.
3. Instal komponen dari Pengaturan->Integrasi. Anda mungkin harus menghapus cache browser agar integrasi Easee muncul dalam daftar.

Instalasi Git

1. Pastikan Anda telah menginstal git di mesin Anda.
2. Arahkan ke folder konfigurasi asisten rumah Anda.
3. Buat folder custom_components yang tidak ada, navigasikan ke bawah setelah pembuatan.
4. Jalankan perintah berikut: git clone https://github.com/nordicopen/easee_hass.git easee
5. Jalankan bash links.sh

Pengisi daya/equalizer yang dipantau

Sejak v0.9.47 integrasi hanya mencakup pengisi daya dan equalizer yang telah ditambahkan ke aplikasi resmi Easee, daripada menampilkan semua yang tersedia untuk pengguna yang masuk. Perubahan ini dilakukan karena dalam instalasi yang lebih besar mungkin terdapat 10 atau 100 pengisi daya yang terdaftar, yang dalam banyak kasus tidak masuk akal. Jadi jika Anda tidak melihat semua produk Anda dalam integrasi, buka aplikasi resminya dan pastikan produk tersebut terdaftar di sana terlebih dahulu. Perhatikan juga bahwa jika tidak ada pengisi daya sama sekali yang ditambahkan ke aplikasi, pesan kesalahan "Tidak ada situs yang ditemukan di akun ini" akan ditampilkan saat instalasi.

Konfigurasi

Konfigurasi dilakukan melalui Konfigurasi > Integrasi tempat Anda pertama kali mengonfigurasinya dan kemudian mengatur opsi untuk apa yang ingin Anda pantau.

Menggunakan

Penggunaan dasar integrasi dari UI sudah cukup jelas. Integrasi tersebut mendefinisikan sejumlah layanan yang dapat digunakan mulai dari otomatisasi dan skrip untuk mengontrol pengisi daya dan proses pengisian daya. Layanan yang tersedia dapat ditemukan di Home Assistant di Alat Pengembang->Layanan.

Cara termudah untuk menyiapkan layanan dan parameternya adalah dengan menggunakan editor otomatisasi atau alat pengembang. Namun, Anda juga dapat menulis kode dalam yaml biasa. UI akan menggunakan device_id sebagai target layanan. Ini adalah string acak yang dihasilkan secara internal oleh HA dan sangat tidak ramah pengguna. Untuk menyederhanakan pembuat kode tingkat lanjut dan agar kompatibel dengan versi sebelumnya dari integrasi ini, Anda juga dapat menggunakan charger_id atau Circuit_id sebagai target. Tiga contoh yang akan melakukan hal yang sama:

 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

Untuk detail tentang Easee API, silakan merujuk ke https://developer.easee.cloud/reference

Pencatatan debug

Log debug lengkap dapat diaktifkan dengan memasukkan berikut ini ke dalam configuration.yaml dan memulai ulang Home Assistant

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

Wadah Pengembangan

Salah satu opsi untuk pengembangan adalah dengan menggunakan VS Code Dev Container. Anda harus menginstal Docker.

1. Buka vscode kosong baru
2. Pilih Palet perintah->Kontainer pengembang: Kloning repositori dalam volume kontainer bernama
3. Ikuti petunjuknya
4. Tunggu hingga kontainer dibuat.
5. Tekan Ctrl + Shift + P dan pilih Tasks: Run Task > Run Home Assistant on port 9125 .
6. Tunggu hingga Home Assistant memulai dan buka http://localhost:9125/.
7. Telusuri UI peluncuran pertama Home Assistant.
8. Buka http://localhost:9125/config/integrations, klik Add Integration dan tambahkan integrasi Easee .
9. Untuk melakukan debug, tekan F5 untuk melampirkan ke Home Assistant yang berjalan di kontainer.

Selalu lari

$ make lint

sebelum mendorong perubahan Anda.

Terjemahan

Kami menggunakan Lokalise untuk menangani penyerahan terjemahan. Mereka memberi kami platform luar biasa yang mudah digunakan dan dipelihara.

Untuk membantu terjemahan integrasi Easee klik di sini. Jika Anda diminta untuk login biasanya paling mudah menggunakan "Log in dengan GitHub".

Jika Anda ingin menambahkan bahasa baru, silakan buka terbitan di sini, di repo ini.

Terjemahan ditarik ketika rilis baru integrasi telah disiapkan. Jadi Anda harus menunggu sampai ada rilis baru sampai Anda mencari pembaruan.

Jika Anda ingin menambahkan elemen baru yang memerlukan terjemahan, Anda harus memasukkannya ke /translations/en.json dan mengirimkan PR. Kunci baru akan muncul di Lokalise saat PR digabungkan.

Atribusi, dukungan dan kerjasama

Proyek ini dimulai oleh mendiang Niklas Fondberg, @fondberg. Repositori tersebut telah diwarisi oleh kolaboratornya.

Proyek ini didukung oleh