Opsi Konfigurasi

Di Home Assistant, setiap vacuum robot yang berhasil dikonfigurasi disimpan sebagai entri integrasi yang terpisah. Perangkat yang sesuai secara otomatis dibuat dan terhubung dengan entri ini, menampilkan entitas, layanan, dan data peta dari vacuum tersebut. Opsi konfigurasi memberikan akses ke pengaturan per perangkat, memungkinkan perilaku tiap entri integrasi untuk disesuaikan secara independen.

Pengaturan ini dapat diakses segera selama proses pengaturan awal sebagai langkah terakhir setelah menyelesaikan konfigurasi untuk jenis koneksi yang dipilih (tepat sebelum perangkat ditambahkan ke Home Assistant). Pengaturan ini juga dapat diubah kapan saja nanti dari halaman Integrations Home Assistant dengan mengklik tombol Configure yang terletak di kanan atas kartu perangkat.

Kunci Dreame Vacuum Card

Kolom opsional untuk kunci lisensi Kartu Penyedot Debu Dreame. Ketika kunci yang valid dimasukkan, integrasi secara otomatis mengaktifkan kartu kustom yang tertanam dan membuatnya tersedia di antara kartu kustom di dasbor. Jika kunci yang tidak valid dimasukkan, kartu akan tetap dalam mode pratinjau di dasbor.

Dapatkan Kunci DVC

Aktivasi Perangkat Tunggal

Setiap kunci lisensi secara ketat dibatasi untuk satu perangkat saja. Setelah kunci diaktifkan, kunci tersebut secara permanen terikat pada perangkat tersebut dan tidak dapat digunakan untuk mengaktifkan kartu pada perangkat lain.

Catatan

Kolom ini sepenuhnya opsional. Jika dibiarkan kosong, kartu kustom yang tertanam masih dapat ditambahkan ke dasbor tetapi akan beroperasi dalam mode pratinjau. Kunci yang valid selalu dapat diperoleh nanti langsung melalui antarmuka kartu dalam mode pratinjau.

Notifikasi

Pilih kategori notifikasi persisten mana saja yang diizinkan integrasi untuk dibuat pada perangkat ini. Menghapus centang pada sebuah kategori akan menonaktifkannya sepenuhnya, bahkan jika kejadian perangkat yang mendasarinya tetap terjadi.

• Pembersihan Selesai (cleanup_completed): Dihasilkan setiap kali tugas pembersihan berhasil diselesaikan.
• Konsumabel (consumable): Dihasilkan ketika masa pakai konsumabel hampir habis atau ketika suatu komponen memerlukan perawatan.
• Informasi (information): Dihasilkan untuk acara informasi umum dan pembaruan status.
• Peringatan (warning): Dihasilkan ketika perangkat mengalami kesalahan yang dapat dihapus atau masalah kecil.
• Kesalahan (error): Dihasilkan ketika perangkat mengalami kesalahan kritis atau kerusakan perangkat keras.

Lebih lanjut tentang fitur notifikasi

Aplikasi Pendamping

Secara default, notifikasi persisten hanya ditampilkan di dalam dasbor Home Assistant. Mereka tidak dapat dikirim langsung ke Aplikasi Pendamping Home Assistant di perangkat seluler karena diperlukan ID perangkat notifikasi tertentu. Untuk menerima notifikasi push di perangkat seluler, sebuah otomatisasi kustom harus dibuat yang baik mendengarkan acara dari integrasi atau memantau notifikasi persisten yang dihasilkan, dan kemudian meneruskannya ke perangkat seluler tertentu.

Opsi Tampilkan Peta Dukungan Peta

Pengaturan berikut hanya tersedia untuk perangkat yang dikonfigurasi dengan akun cloud (DreameHome, MovaHome, TROUVER, atau Xiaomi Home), karena semuanya bergantung pada data peta:

Kartu Penyedot Debu Dreame

Pengaturan di bawah ini hanya berlaku untuk entitas kamera peta yang dihasilkan. Kartu Penyedot Debu Dreame secara asli menampilkan peta sendiri dan dapat secara independen menimpa Skema Warna dan Set Ikon melalui konfigurasi lanjutan. Opsi Gambar Peta Persegi dan Gambar Peta Resolusi Rendah tidak berpengaruh pada kartu kustom, sehingga mengaktifkan Gambar Peta Resolusi Rendah sangat disarankan untuk menghemat memori.

Skema warna

Memilih palet warna yang digunakan saat menghasilkan gambar peta.

• Dreame Light (dreame_light): Tema resmi aplikasi Dreame.
• Dreame Dark (dreame_dark): Tema gelap eksklusif untuk integrasi dreame_vacuum.
• Mijia Light (mijia_light): Tema terang resmi aplikasi Xiaomi Mi Home.
• Mijia Dark (mijia_dark): Tema gelap resmi aplikasi Xiaomi Mi Home.
• Grayscale (grayscale): Tema peta monokrom tanpa warna.
• Transparent (transparent): Menghasilkan lantai, dinding, dan isi ruangan sepenuhnya transparan, berguna untuk menempatkan peta di atas latar belakang kustom.

Lihat skema warna yang tersedia di Dukungan Peta

Kumpulan Ikon

Memilih gaya ikon yang digunakan untuk penanda peta seperti robot, pengisi daya, dan furnitur, sesuai dengan set ikon dari Aplikasi resmi.

• Dreame (dreame): Set ikon aplikasi Dreame resmi.
• Dreame Lama (dreame_old): Set ikon aplikasi Dreame versi lama.
• Mijia (mijia): Set ikon aplikasi Xiaomi Mi Home resmi.
• Material (material): Ikon Material Design bawaan Home Assistant.

Objek Peta tersembunyi

Memilih elemen peta mana yang dikecualikan dari gambar peta yang dihasilkan. Ini berguna untuk menyederhanakan peta atau menyembunyikan informasi yang tidak diperlukan untuk dashboard tertentu.

Objek yang tersedia

• Warna Ruangan (color): Isian warna berbeda untuk setiap ruangan.
• Ikon Ruangan (icon): Ikon ruangan berdasarkan jenisnya.
• Nama Ruangan (name): Label teks untuk nama ruangan.
• Latar Nama Ruangan (name_background): Latar berbentuk pil di belakang nama ruangan dengan warna terkait.
• Urutan Ruangan (order): Lencana bernomor yang menunjukkan urutan pembersihan.
• Tingkat Hisap Ruangan (suction_level): Ikon yang menunjukkan tingkat hisap yang dikonfigurasi untuk ruangan.
• Volume Air Ruangan (water_volume): Ikon yang menunjukkan volume air yang dikonfigurasi untuk ruangan.
• Jumlah Pembersihan Ruangan (cleaning_times): Lencana yang menunjukkan berapa kali ruangan akan dibersihkan.
• Mode Pembersihan Ruangan (cleaning_mode): Ikon yang menunjukkan mode pembersihan yang dikonfigurasi untuk ruangan (menyapu, mengepel, atau keduanya). (Hanya pada perangkat yang didukung)
• Mode Mengepel Ruangan (mopping_mode): Ikon yang menunjukkan tipe kain pel yang dikonfigurasi untuk ruangan. (Hanya pada perangkat yang didukung)
• Jalur (path): Jalur yang menunjukkan area yang sudah dibersihkan oleh robot.
• Zona Terlarang (no_go): Zona yang dibatasi.
• Zona Tanpa Pel (no_mop): Zona mengepel yang dibatasi.
• Dinding Virtual (virtual_wall): Dinding virtual yang ditambahkan untuk mencegah robot melewati.
• Ambang Virtual (pathway): Ambang yang ditentukan yang harus dilalui robot dengan hati-hati. (Hanya pada perangkat yang didukung)
• Area Aktif (active_area): Kotak batas yang digambar saat pembersihan zona.
• Titik Aktif (active_point): Titik pembersihan lokal yang menunjukkan area 1,5m².
• Ikon Pengisi Daya (charger): Ikon stasiun dasar.
• Ikon Robot (robot): Ikon yang mewakili robot itu sendiri.
• Arah Pembersihan (cleaning_direction): Panah yang menunjukkan arah pembersihan robot saat ini.
• Hambatan AI (obstacle): Ikon hambatan yang terdeteksi AI seperti sepatu dan kabel. (Hanya pada perangkat yang didukung)
• Hewan Peliharaan (pet): Hambatan yang terdeteksi sebagai hewan peliharaan. (Hanya pada perangkat yang didukung)
• Area Karpet (carpet): Tekstur karpet. (Hanya pada perangkat yang didukung)
• Material Lantai (material): Tekstur material lantai ruangan, seperti kayu atau ubin. (Hanya pada perangkat yang didukung)
• Area Rendah (low_lying_area): Area rendah di mana robot memasuki dengan menurunkan pemindai LiDAR-nya. (Hanya pada perangkat yang didukung)
• Perabotan (furniture): Perabotan 3D atau 2D. (Hanya pada perangkat yang didukung)
• Rampa (ramp): Rampa yang ditempatkan di lingkungan. (Hanya pada perangkat yang didukung)
• Tirai (curtain): Tirai. (Hanya pada perangkat yang didukung)
• Titik Patroli (cruise_point): Pergi ke titik operasi. (Hanya pada perangkat yang didukung)

Gambar Peta Persegi

Memaksa gambar kamera peta yang dihasilkan menjadi rasio aspek persegi 1:1 alih-alih batas alami peta, yang bisa berguna untuk tata letak dasbor yang mengharapkan gambar persegi.

Gambar Peta Resolusi Rendah

Menghasilkan gambar kamera peta dengan resolusi yang dikurangi untuk menurunkan penggunaan memori dan mempercepat pembaruan.

Keterbatasan Memori

Menghasilkan peta besar dapat memerlukan jumlah memori yang signifikan. Jika Home Assistant mengalami crash dan melakukan restart saat menavigasi ke halaman perangkat atau saat mengakses entitas kamera peta, kemungkinan besar disebabkan oleh memori yang tidak cukup. Mengaktifkan opsi ini biasanya akan menyelesaikan masalah.

Catatan

Mengaktifkan opsi ini juga menonaktifkan entitas kamera Saved WiFi Map, karena tidak tersedia dalam resolusi rendah.

Pilih Cloud

Hanya tersedia untuk perangkat yang dikonfigurasi dengan akun Xiaomi Home. Pengaturan ini memungkinkan memperbarui preferensi yang awalnya dipilih selama langkah konfigurasi awal.

• Saat diaktifkan: Memaksa semua komunikasi melalui cloud. Ini diperlukan untuk perangkat terbaru di mana Xiaomi telah menonaktifkan kemampuan akses lokal, atau ketika perangkat dan Home Assistant berada di subnet yang berbeda.
• Saat dinonaktifkan (Disarankan untuk pengaturan yang didukung): Integrasi ini membangun koneksi lokal langsung dengan perangkat (sambil tetap secara otomatis menangani pembaruan token dan IP dari cloud). Ini menjaga semua komunikasi (kecuali data peta) sepenuhnya lokal.

Menguji Ketersediaan API Lokal

Opsi ini menyediakan cara yang sangat berguna untuk menguji konektivitas lokal. Untuk memastikan pengaturan awal perangkat berhasil tanpa kesalahan, Prefer Cloud dapat tetap diaktifkan selama alur konfigurasi. Setelah perangkat berhasil ditambahkan ke Home Assistant, opsi ini dapat dinonaktifkan di sini untuk memeriksa apakah perangkat benar-benar mendukung API lokal. Jika perangkat menjadi tidak tersedia setelah menonaktifkannya, cukup aktifkan kembali untuk kembali ke koneksi cloud.

YAML Untuk Referensi

dreame_vacuum:
  # Local connection
  host: 192.168.1.100
  token: b2a1c3d4e5f6a7b8c9d0e1f2a3b4c5d6

  # Cloud connection
  username: your@email.com
  password: your_password
  country: de
  prefer_cloud: true # Only available on Xiaomi Home

  # Options available regardless of connection type
  dvc_key: 123e4567-e89b-42d3-a456-426614174000
  notify:
    - information
    - warning
    - error

  # Options available only with map support (Cloud)
  color_scheme: dreame_dark
  icon_set: dreame_old
  hidden_map_objects:
    - name_background
    - name
    - order
  square: true
  low_resolution: true