homeassistant skodaconnect
1.2.13
Integrasi ini hanya mendukung SKODA API 'lama' (terkait dengan aplikasi seluler lama yang disebut Skoda Essentials ) dan akan berhenti bekerja ketika Skoda menutup API lama. Ini diumumkan pada tanggal 2 Desember 2024 tetapi tanggal itu telah bergeser di masa lalu.
Jika Anda tidak dapat menggunakan aplikasi Skoda Essentials maka integrasi ini tidak akan berhasil untuk Anda. Ini dilaporkan menjadi kasus untuk akun Skoda yang lebih baru.
Pengembangan integrasi ini pada dasarnya telah sepenuhnya berhenti dan tidak akan diperbarui untuk mendukung aplikasi/API baru.
Integrasi baru sedang dikembangkan untuk bekerja dengan SKODA API 'baru' (terkait dengan aplikasi seluler baru yang disebut myskoda ): https://github.com/skodaconnect/homeassistant-myskoda
Integrasi baru dikembangkan secara aktif dan hanya beberapa model yang (sebagian) didukung saat ini. Tetap saja kami sangat mendorong semua orang untuk mencoba integrasi baru dan memberikan umpan balik melalui masalah gitub atau perselisihan.
Jika Anda baru mengenal asisten rumah, silakan baca dokumentasi asisten rumah terlebih dahulu.
Ini adalah garpu robinostlund/homeassistant-volkswagencarnet yang dimodifikasi untuk mendukung Skoda Connect/Myskoda melalui API Aplikasi Asli (API panggilan langsung ke layanan koneksi VWG)
Integrasi untuk asisten rumah ini akan mengambil data dari server Skoda Connect yang terkait dengan mobil yang diaktifkan Skoda Connect Anda. Skoda Connect tidak pernah mengambil data langsung dari mobil, mobil mengirimkan data yang diperbarui ke server VAG pada acara tertentu seperti kunci/buka kunci, acara pengisian daya, acara klimatisasi dan ketika kendaraan diparkir. Integrasi kemudian akan mengambil data ini dari server. Ketika tindakan kendaraan gagal atau kembali tanpa respons, penyegaran pasukan dapat membantu. Ini akan memicu panggilan "bangun" dari server vag ke mobil. SCAN_Interval adalah seberapa sering integrasi harus mengambil data dari server, jika tidak ada data baru dari mobil maka entitas tidak akan diperbarui.
Proyek ini berisi kode komponen kustom asisten rumah. Itu tergantung pada https://github.com/skodaconnect/skodaconnect yang menyediakan perpustakaan Python yang berinteraksi dengan Skoda API.
Integrasi ini hanya akan bekerja untuk mobil Anda jika Anda memiliki fungsionalitas Skoda Connect/Myškoda. Mobil yang menggunakan aplikasi seluler pihak ketiga lainnya, semi-resmi, seperti "Minskoda" dari ConnectedCars di Denmark tidak akan berfungsi. Perpustakaan yang digunakan untuk komunikasi API direkayasa terbalik dari aplikasi Android Myskoda. Dukungan awal telah ditambahkan untuk SmartLink dan mobil API gaya yang lebih baru, seperti Enyaq IV.
Pengaturan privasi mobil harus diatur untuk "berbagi posisi saya" untuk fungsionalitas penuh integrasi ini. Tanpa pengaturan ini, jika diatur untuk "Gunakan posisi saya", sensor untuk posisi (pelacak perangkat), permintaan yang tersisa dan waktu parkir mungkin tidak berfungsi dengan baik atau sama sekali. Diatur ke pengaturan privasi yang lebih ketat akan membatasi fungsionalitas lebih jauh.
Jika Anda menghadapi masalah di mana integrasi tidak dapat diatur atau jika Anda menerima kesalahan bahwa ada istilah atau EULA yang tidak diterima, itu mungkin karena platform aplikasi seluler Anda. Perpustakaan yang mendasarinya dibangun dengan merekayasa terbalik perilaku aplikasi Android dan dengan demikian menggunakan konfigurasi klien yang sama dengan perangkat Android. Jika Anda hanya menggunakan aplikasi pada perangkat iPhone/iOS, itu mungkin menyebabkan masalah dengan integrasi ini.
Kemungkinan solusi:
Jika ini tidak berhasil untuk Anda dan masalah khusus yang Anda hadapi, buka masalah dan berikan deskripsi masalah rinci sebanyak mungkin dan log debug yang relevan.
Jika Anda menginstal HACS (Home Assistant Community Store), cukup cari Skoda Connect dan instal langsung dari HACS. HACS akan melacak pembaruan dan Anda dapat dengan mudah meningkatkan ke versi terbaru saat rilis baru tersedia.
Jika Anda tidak menginstalnya, lihat di sini: HACS
Klon atau salin repositori dan salin folder 'homeassistant-skodaconnect/custom_component/skodaconnect' ke '[config dir]/custom_components'. Instal Perpustakaan Python yang Diperlukan (Sesuaikan sesuai dengan lingkungan Anda):
pip install skodaconnect Untuk pencatatan debug yang komprehensif, Anda dapat menambahkan ini ke <config dir>/configuration.yaml Anda: Anda:
logger :
default : info
logs :
skodaconnect.connection : debug
skodaconnect.vehicle : debug
custom_components.skodaconnect : debug
custom_components.skodaconnect.climate : debug
custom_components.skodaconnect.lock : debug
custom_components.skodaconnect.device_tracker : debug
custom_components.skodaconnect.switch : debug
custom_components.skodaconnect.binary_sensor : debug
custom_components.skodaconnect.sensor : debugSkodaConnect.Connection: Atur level debug untuk kelas koneksi perpustakaan Skoda Connect. Ini menangani permintaan Get/Set ke API
SkodaConnect.Vehicle: Atur level debug untuk kelas kendaraan dari Perpustakaan Skoda Connect. Satu objek yang dibuat untuk setiap kendaraan di akun dan menyimpan semua data.
Skodaconnect.dashboard: Atur level debug untuk kelas dasbor dari perpustakaan Skoda Connect. Kelas pembungkus antara komponen HASS dan perpustakaan.
custom_components.skodaconnect: atur level debug untuk komponen khusus. Komunikasi antara Hass dan Perpustakaan.
custom_components.skodaconnect.xyz menetapkan level debug untuk jenis entitas individu dalam komponen khusus.
Konfigurasi dalam konfigurasi.YAML sekarang sudah usang dan dapat mengganggu pengaturan integrasi. Untuk mengonfigurasi integrasi, buka konfigurasi di panel samping asisten rumah dan kemudian pilih integrasi. Klik tombol "Tambahkan Integrasi" di sudut kanan bawah dan cari/pilih SkodaConnect. Ikuti langkah -langkah dan masukkan informasi yang diperlukan. Karena bagaimana data disimpan dan ditangani di asisten rumah, akan ada satu integrasi per kendaraan. Siapkan banyak kendaraan dengan menambahkan integrasi beberapa kali.
Opsi integrasi dapat diubah setelah diatur dengan mengklik teks "Configure" pada integrasi. Opsi yang tersedia adalah:
Frekuensi Polling Interval (dalam detik) bahwa server disurvei untuk data yang diperbarui. Beberapa pengguna telah melaporkan tingkat terbatas (HTTP 429) saat menggunakan 60s atau lebih rendah. Disarankan untuk memulai dengan nilai 120 -an atau 180 -an. Lihat #215.
S-Pin S-Pin untuk Kendaraan. Ini opsional dan hanya diperlukan untuk permintaan/tindakan kendaraan tertentu (pemanas tambahan, kunci dll).
Select yang dapat diubah untuk memungkinkan interaksi dengan kendaraan, mulai klimatisasi dll.
Penebangan Debug API Lengkap Mengaktifkan Penebangan Debug Penuh. Ini akan mencetak respon lengkap dari API ke homeassistant.log. Hanya mengaktifkan pemecahan masalah karena akan menghasilkan banyak log.
Sumber Daya untuk Memantau Pilih Sumber Daya mana yang ingin Anda pantau kendaraan.
Konversi jarak/unit Pilih jika Anda ingin mengonversi jarak/unit.
Dalam contoh ini kami mengirimkan pemberitahuan ke perangkat iOS. Aplikasi Android Companion saat ini tidak mendukung konten dinamis dalam pemberitahuan (peta dll.)
Simpan otomatisasi ini di file otomatisasi Anda <config dir>/automations.yaml
Pertama -tama buat input_number, via editor di configuration.yaml atau file konfigurasi yang disertakan lainnya, atau melalui editor GUI Helters. Penting untuk menetapkan nilai minimum ke 10, maksimum hingga 60 dan melangkah ke 10. Kalau tidak, panggilan layanan mungkin tidak berfungsi.
# configuration.yaml
input_number :
pheater_duration :
name : " Pre-heater duration "
initial : 20
min : 10
max : 60
step : 10
unit_of_measurement : minBuat otomatisasi, di YAML atau via GUI Editor. Anda dapat menemukan ID perangkat dengan pergi ke Pengaturan-> Perangkat & Layanan dan kemudian mengklik perangkat untuk kendaraan SkodaConnect. ID perangkat akan ditampilkan di bilah alamat browser web setelah "/config/devices/device/". ID juga dapat ditemukan dengan menggunakan Editor Layanan GUI di bawah Alat Pengembang. Pilih salah satu layanan SkodaConnect dan pilih kendaraan Anda. Ubah ke mode YAML dan salin ID perangkat.
# automations.yaml
- alias : Pre-heater duration
description : " "
trigger :
- platform : state
entity_id : input_number.pheater_duration
condition : []
action :
- service : skodaconnect.set_pheater_duration
data_template :
device_id : <Your Device ID for vehicle>
duration : " {{ (states('input_number.pheater_duration') | float ) | round(0) }} "
mode : singleBerkat @haraldpaulsen estimasi sensor template laju pengisian berdasarkan kapasitas baterai dan waktu yang dilaporkan tersisa. Ganti dengan nama kendaraan Anda dan dengan kapasitas baterai di WH.
template :
- sensor :
- name : " Charge speed guesstimate "
state : >
{% if is_state('switch.skoda_<name>_charging', 'on') %}
{% set battery_capacity = <battery-size-in-kwh> | int %}
{% set charge = { "remaining": states('sensor.skoda_<name>_minimum_charge_level') | int - states('sensor.skoda_<name>_battery_level') | int } %}
{% set timeleft = states('sensor.skoda_<name>_charging_time_left') | int %}
{% set chargeleft = battery_capacity * charge.remaining / 100 %}
{% set chargespeed = chargeleft / (timeleft / 60) %}
{{ chargespeed | round (1) }}
{% else %}
0
{% endif %}
unit_of_measurement : " kW "
state_class : measurementCatatan: Hanya tersedia untuk perangkat iOS karena aplikasi Android Companion belum mendukung ini. Ini mungkin rusak sejak 1.0.30 ketika device_tracker mengubah perilaku.
- id : notify_skoda_position_change
description : Notify when position has been changed
alias : Skoda position changed notification
trigger :
- platform : state
entity_id : device_tracker.kodiaq
condition : template
condition : template
value_template : " {{ trigger.to_state.state != trigger.from_state.state }} "
action :
- service : notify.ios_my_ios_device
data_template :
title : " Kodiaq Position Changed "
message : |
? Skoda Car is now on a new place.
data :
url : /lovelace/car
apns_headers :
' apns-collapse-id ' : ' car_position_state_{{ trigger.entity_id.split(".")[1] }} '
push :
category : map
thread-id : " HA Car Status "
action_data :
latitude : " {{trigger.from_state.attributes.latitude}} "
longitude : " {{trigger.from_state.attributes.longitude}} "
second_latitude : " {{trigger.to_state.attributes.latitude}} "
second_longitude : " {{trigger.to_state.attributes.longitude}} "
shows_traffic : true- id : ' notify_skoda_car_is_unlocked '
alias : Skoda is at home and unlocked
trigger :
- entity_id : binary_sensor.vw_carid_external_power
platform : state
to : ' on '
for : 00:10:00
condition :
- condition : state
entity_id : lock.kodiaq_door_locked
state : unlocked
- condition : state
entity_id : device_tracker.kodiaq
state : home
- condition : time
after : ' 07:00:00 '
before : ' 21:00:00 '
action :
# Notification via push message to smartphone
- service : notify.device
data :
message : " The car is unlocked! "
target :
- device/my_device
# Notification via smart speaker (kitchen)
- service : media_player.volume_set
data :
entity_id : media_player.kitchen
volume_level : ' 0.6 '
- service : tts.google_translate_say
data :
entity_id : media_player.kitchen
message : " My Lord, the car is unlocked. Please attend this this issue at your earliest inconvenience! "
