Installazione e Utilizzo

Questa guida spiega come far funzionare la Scheda Dreame Vacuum sulla dashboard di Home Assistant. Copre i prerequisiti per l'integrazione, i passaggi per aggiungere la scheda alle dashboard esistenti e le istruzioni per configurare la modalità Panel consigliata. La modalità Panel offre la migliore esperienza possibile utilizzando l'intero schermo, risultando particolarmente efficace su tablet e monitor desktop.

---

La Scheda Dreame Vacuum è strettamente integrata come parte fondamentale del Integrazione Dreame Vacuum con Home Assistant. Non è una scheda indipendente installabile separatamente.

Per utilizzare questa scheda, deve essere installata la versione dell'integrazione dreame_vacuum v2.0.0 o superiore, che include la scheda integrata.

Prerequisito

Se l'integrazione Dreame Vacuum è già installata, questo passaggio può essere ignorato in sicurezza.

Se non è ancora installato, il modo più semplice per ottenerlo è tramite HACS. L'integrazione Dreame Vacuum può essere cercata sotto HACS > Integrations e la versione v2.0.0 o superiore può essere scaricata. Home Assistant deve essere riavviato dopo il download. Una volta configurata l'integrazione, la scheda sarà automaticamente disponibile per i dashboard.

Ottimizzazione delle entità

La scheda è progettata per funzionare utilizzando solo le entità vacuum, sensor.cleaning_history, sensor.cruising_history e camera.map. Ottiene tutto ciò di cui ha bisogno direttamente da queste quattro entità principali. Di conseguenza, tutte le altre entità della pagina del dispositivo, comprese le entità delle mappe salvate, possono essere disattivate in sicurezza per mantenere pulito Home Assistant.

Per ridurre ulteriormente il carico sull'istanza di Home Assistant disattivando la generazione di immagini lato server, l'entità camera.map può essere disabilitata e l'entità camera.map_data abilitata al suo posto. La scheda rileverà automaticamente questa condizione e mostrerà tutte le mappe direttamente nel browser. Come minimo indispensabile, la scheda può funzionare con solo l'entità vacuum abilitata. Sebbene la mappa non verrà disegnata in questo stato, tutte le funzionalità non correlate alla mappa, come le impostazioni di pulizia, le azioni della base e i controlli di base, rimarranno pienamente accessibili e utilizzabili.

Aggiungere la Scheda al Tuo Cruscotto

Per aggiungere la Scheda Aspirapolvere Dreame al cruscotto di Home Assistant:

1. Aprire Home Assistant e navigare al cruscotto desiderato.
2. Fare clic sull'icona Modifica Cruscotto () in alto a destra.
3. Fare clic sul pulsante Aggiungi Scheda () in basso a destra.
4. Nella selezione delle schede, cercare e selezionare Personalizzata: Scheda Aspirapolvere Dreame.
5. Nell'editor delle schede, è selezionato il Dreame Vacuum Entity, come vacuum.l10s_gen2.
6. Viene cliccato Salva per aggiungere la scheda alla dashboard.

Utilizzo della Modalità Pannello (Consigliata)

Per la migliore esperienza utente, soprattutto dato l'ampio editor della mappa e le funzionalità della Scheda Dreame Vacuum, è altamente consigliato utilizzare la Modalità Pannello di Home Assistant. La Modalità Pannello permette a una singola scheda di occupare l'intero schermo di una vista della dashboard.

La scheda rileva automaticamente quando viene posizionata in una vista a pannello e rimuove il colore di sfondo e i bordi esterni per integrarsi perfettamente con il tema della dashboard. Inoltre, tutti gli elementi dell'interfaccia interna sono completamente consapevoli della modalità pannello e adattano i loro layout per utilizzare lo spazio schermo espanso.

Configurazione Vista a Pannello per Singola Scheda

1. Il cruscotto desiderato viene aperto e viene cliccata l'icona Modifica Cruscotto () in alto a destra.
2. Viene cliccata l'icona Aggiungi Vista () accanto alle schede delle viste del cruscotto in alto.
3. Nella finestra di dialogo "Aggiungi Vista", Pannello, viene selezionata l'opzione a scheda singola sotto il menu a tendina Layout.
4. Viene fornito un Titolo opzionale, come "Aspirapolvere", e un Icona, come mdi:robot-vacuum.
5. Viene cliccato Salva.
6. Fare clic sul pulsante Aggiungi Scheda () in basso a destra.
7. Nella selezione delle schede, cercare e selezionare Personalizzata: Scheda Aspirapolvere Dreame.
8. Nell'editor delle schede, è selezionato il Dreame Vacuum Entity, come vacuum.l10s_gen2.
9. Viene cliccato Salva per aggiungere la scheda alla dashboard.

Navigazione Nativa del Browser

Quando viene utilizzata in Modalità Pannello o quando è l'unica scheda in una vista, la scheda gestisce nativamente la navigazione del browser. Il pulsante Indietro fisico del dispositivo o i gesti di scorrimento possono essere utilizzati per chiudere finestre di dialogo, annullare menu o tornare indietro, agendo esattamente come il pulsante indietro della scheda stessa. Questo è particolarmente utile sui dispositivi mobili. Per mantenere un'esperienza utente stabile, la scheda intercetta solo le azioni "indietro" e non gestisce la navigazione "avanti".