Opzioni di Configurazione

In Home Assistant, ogni aspirapolvere robot configurato correttamente viene memorizzato come una voce di integrazione distinta. Un dispositivo corrispondente viene creato automaticamente e collegato a questa voce, esponendo le entità, i servizi e i dati della mappa dell'aspirapolvere. Le opzioni di configurazione consentono l'accesso alle impostazioni per dispositivo, permettendo di personalizzare indipendentemente il comportamento di ogni voce di integrazione.

Queste impostazioni possono essere accessibili immediatamente durante il processo di configurazione iniziale come passaggio finale dopo aver completato la configurazione per il tipo di connessione selezionato (subito prima che il dispositivo venga aggiunto a Home Assistant). Possono anche essere modificate in qualsiasi momento successivamente dalla pagina Integrazioni di Home Assistant cliccando sul pulsante Configura situato in alto a destra sulla scheda del dispositivo.

Chiave Dreame Vacuum Card

Un campo opzionale per una chiave di licenza Scheda Aspirapolvere Dreame. Quando viene inserita una chiave valida, l'integrazione attiva automaticamente la scheda personalizzata incorporata e la rende disponibile tra le schede personalizzate nella dashboard. Se viene inserita una chiave non valida, la scheda rimarrà in modalità anteprima nella dashboard.

Ottieni chiave DVC

Attivazione su singolo dispositivo

Ogni chiave di licenza è strettamente limitata a un singolo dispositivo. Una volta attivata, la chiave è permanentemente legata a quel dispositivo specifico e non può essere utilizzata per attivare la scheda su altri dispositivi.

Nota

Questo campo è completamente opzionale. Se lasciato vuoto, la scheda personalizzata incorporata può comunque essere aggiunta a una dashboard, ma funzionerà in modalità anteprima. Una chiave valida può essere sempre acquisita successivamente direttamente tramite l'interfaccia della scheda in modalità anteprima.

Notifiche

Seleziona quali categorie di notifiche persistenti l'integrazione è autorizzata a creare per questo dispositivo. Deselezionare una categoria la disabilita completamente, anche se l'evento del dispositivo sottostante si verifica comunque.

• Pulizia Completata (cleanup_completed): Generato ogni volta che un compito di pulizia viene completato con successo.
• Consumabile (consumable): Generato quando la durata di un consumabile sta per terminare o quando un componente richiede manutenzione.
• Informazioni (information): Generato per eventi informativi generali e aggiornamenti di stato.
• Avviso (warning): Generato quando il dispositivo rileva errori risolvibili o problemi minori.
• Errore (error): Generato quando il dispositivo riscontra un guasto critico o un errore hardware.

Maggiori informazioni sulla funzione di notifiche

App Companion

Per impostazione predefinita, le notifiche persistenti vengono visualizzate solo all'interno della dashboard di Home Assistant. Non possono essere inviate direttamente all'app Home Assistant Companion su un dispositivo mobile perché è necessario un ID dispositivo di notifica specifico. Per ricevere notifiche push su un dispositivo mobile, deve essere creato un automazione personalizzata che ascolti eventi dell'integrazione o monitori le notifiche persistenti generate, e poi le inoltri al dispositivo mobile specifico.

Opzioni di Visualizzazione della Mappa Supporto Mappa

Le seguenti impostazioni sono disponibili solo per dispositivi configurati con un account cloud (DreameHome, MovaHome, TROUVER o Xiaomi Home), poiché dipendono tutte dai dati della mappa:

Scheda Aspirapolvere Dreame

Le impostazioni qui sotto si applicano solo all'entità della fotocamera della mappa generata. Il Scheda Aspirapolvere Dreame visualizza nativamente la propria mappa e può sovrascrivere indipendentemente lo Schema Colori e il Set di Icone tramite il suo configurazione avanzata. Le opzioni Immagine della Mappa Quadrata e Immagine della Mappa a Bassa Risoluzione non hanno effetto sulla scheda personalizzata, quindi è altamente consigliato abilitare Immagine della Mappa a Bassa Risoluzione per risparmiare memoria.

Schema colori

Seleziona la palette di colori utilizzata durante la generazione dell'immagine della mappa.

• Dreame Chiaro (dreame_light): Tema dell'app ufficiale Dreame.
• Dreame Scuro (dreame_dark): Tema scuro esclusivo dell'integrazione dreame_vacuum.
• Mijia Chiaro (mijia_light): Tema chiaro dell'app ufficiale Xiaomi Mi Home.
• Mijia Scuro (mijia_dark): Tema scuro dell'app ufficiale Xiaomi Mi Home.
• Scala di Grigi (grayscale): Tema della mappa monocromatico e senza colori.
• Trasparente (transparent): Genera pavimento, muri e riempimenti delle stanze completamente trasparenti, utile per sovrapporre la mappa a uno sfondo personalizzato.

Vedi gli schemi di colori disponibili in Supporto Mappa

Set icone

Seleziona lo stile delle icone utilizzato per i segnaposto sulla mappa come il robot, il caricatore e i mobili, corrispondente ai set di icone delle App ufficiali.

• Dreame (dreame): Set di icone dell'app ufficiale Dreame.
• Dreame Old (dreame_old): Set di icone dell'app Dreame legacy.
• Mijia (mijia): Set di icone dell'app ufficiale Xiaomi Mi Home.
• Material (material): Icone Material Design integrate di Home Assistant.

Elementi della mappa da nascondere

Seleziona quali elementi della mappa sono esclusi dall'immagine della mappa generata. Questo è utile per semplificare la mappa o nascondere informazioni non necessarie per un particolare cruscotto.

Oggetti disponibili

• Colori delle Stanze (color): Riempimento di colore distintivo per ogni stanza.
• Icone delle Stanze (icon): Icona della stanza basata sul suo tipo.
• Nomi delle Stanze (name): Etichette di testo per i nomi delle stanze.
• Sfondo del Nome della Stanza (name_background): Sfondo a forma di pillola dietro i nomi delle stanze con il colore ad esso associato.
• Ordine della Stanza (order): I distintivi numerati che indicano la sequenza di pulizia.
• Livello di Aspirazione della Stanza (suction_level): L'icona che indica il livello di aspirazione configurato della stanza.
• Volume dell'Acqua della Stanza (water_volume): L'icona che indica il volume d'acqua configurato della stanza.
• Volte di Pulizia della Stanza (cleaning_times): Il distintivo che indica quante volte la stanza sarà pulita.
• Modalità di Pulizia della Stanza (cleaning_mode): L'icona che indica la modalità di pulizia configurata della stanza (aspirazione, lavaggio o entrambe). (Solo su dispositivi supportati)
• Modalità di Lavaggio della Stanza (mopping_mode): L'icona che indica il tipo di panno configurato per il lavaggio della stanza. (Solo su dispositivi supportati)
• Percorso (path): Il percorso che mostra dove il robot ha pulito.
• Zone Vietate (no_go): Zone limitate.
• Zone senza Lavaggio (no_mop): Zone di lavaggio vietato.
• Muri Virtuali (virtual_wall): Un muro virtuale aggiunto per impedire al robot di attraversarlo.
• Soglie Virtuali (pathway): Soglie definite che il robot deve attraversare con attenzione. (Solo su dispositivi supportati)
• Aree Attive (active_area): La cornice tracciata durante la pulizia della zona.
• Punti Attivi (active_point): Punti di pulizia spot che mostrano un'area di 1,5 m².
• Icona del Caricatore (charger): L'icona della base di ricarica.
• Icona del Robot (robot): L'icona che rappresenta il robot stesso.
• Direzione di Pulizia (cleaning_direction): La freccia che indica la direzione in cui il robot sta pulendo.
• Ostacolo AI (obstacle): Icone di ostacoli rilevati dall'AI come scarpe e fili. (Solo su dispositivi supportati)
• Animale Domestico (pet): Ostacoli rilevati come animale domestico. (Solo su dispositivi supportati)
• Area Tappeto (carpet): Texture del tappeto. (Solo su dispositivi supportati)
• Materiale del Pavimento (material): La texture del materiale del pavimento della stanza, come legno o piastrelle. (Solo su dispositivi supportati)
• Aree Depresse (low_lying_area): Aree basse dove il robot entra abbassando il suo scanner LiDAR. (Solo su dispositivi supportati)
• Arredi (furniture): Arredi 3D o 2D. (Solo su dispositivi supportati)
• Rampa (ramp): Rampe posizionate nell'ambiente. (Solo su dispositivi supportati)
• Tenda (curtain): Tende. (Solo su dispositivi supportati)
• Punti di Crociera (cruise_point): Vai ai punti di operazione. (Solo su dispositivi supportati)

Immagine della Mappa Quadrata

Forza l'immagine della mappa generata dalla telecamera ad avere un rapporto d'aspetto quadrato 1:1 invece della cornice naturale della mappa, il che può essere utile per layout di cruscotti che richiedono un'immagine quadrata.

Immagine della Mappa a Bassa Risoluzione

Genera l'immagine della mappa dalla telecamera a risoluzione ridotta per diminuire l'uso di memoria e velocizzare gli aggiornamenti.

Vincoli di Memoria

La generazione di mappe di grandi dimensioni può richiedere una quantità significativa di memoria. Se Home Assistant si blocca e si riavvia quando si naviga nella pagina del dispositivo o si accede all'entità della telecamera della mappa, è molto probabile che sia dovuto a memoria insufficiente. L'attivazione di questa opzione di solito risolve il problema.

Nota

L'attivazione di questa opzione disabilita anche l'entità della telecamera Saved WiFi Map, poiché non è disponibile a bassa risoluzione.

Preferisci il Cloud

Disponibile solo per dispositivi configurati con un account Xiaomi Home. Questa impostazione consente di aggiornare la preferenza selezionata originariamente durante il passaggio di configurazione iniziale.

• Quando abilitato: Forza tutta la comunicazione attraverso il cloud. Questo è necessario per dispositivi più recenti in cui Xiaomi ha disabilitato le capacità di accesso locale, o quando il dispositivo e Home Assistant risiedono su sottoreti diverse.
• Quando disabilitato (Consigliato per configurazioni supportate): L'integrazione stabilisce una connessione locale diretta con il dispositivo (pur gestendo automaticamente il rinnovo del token e dell'IP dal cloud). Questo mantiene tutte le comunicazioni (eccetto i dati della mappa) completamente locali.

Verifica della disponibilità dell'API locale

Questa opzione offre un modo molto utile per testare la connettività locale. Per garantire che la configurazione iniziale del dispositivo abbia successo senza errori, Preferisci il Cloud può rimanere abilitato durante il processo di configurazione. Una volta che il dispositivo è stato aggiunto con successo a Home Assistant, questa opzione può essere disabilitata qui per controllare se il dispositivo supporta effettivamente l'API locale. Se il dispositivo diventa non disponibile dopo la disabilitazione, è sufficiente riabilitarla per tornare alla connessione tramite cloud.

YAML Per Riferimento

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