Componente Home Assistant “Vacuum” (aspirapolvere)

3 minuti di lettura
Produttore: Home Assistant Community
Disponibilità: incluso nell’HUB personale Home Assistant
Categoria: software
Tipologia: componente Home Assistant
Difficoltà di implementazione: bassa

Il componente “Vacuum” di Home Assistant permette di definire in configurazione una o più entità volte al controllo e al monitoraggio di robot per la pulizia domestica.

Integrare un robot aspirapolvere in domotica personale ha il grande vantaggio di poterne automatizzare il comportamento: banalmente, abilita la comodità di dimenticarsene (del robot) e far sì che esso entri automaticamente in azione quando si esce di casa (giusto per portare un esempio).

Per abilitare tale componente è sufficiente indicare un nuovo blocco in configurazione, “vacuum“, tipo il seguente:

#Esempio di integrazione
vacuum:
  platform: xiaomi_miio
  name: Living room
  host: 192.168.1.2

Il che dà origine a un’entità similare alla seguente:

Home Assistant - Vacuum

Le piattaforme collegate a questo componente sono diverse, oltre cinquanta: sono elencate presso la pagina del componente (colonna di destra) presso il sito di Home Assistant.

Servizi del componente

I servizi disponibili associati a questo componente sono:

N.b. Non tutti i sopracitati servizi – illustrati a seguire in dettaglio – sono disponibili per tutte le piattaforme collegate al componente.

Una piattaforma figlia del presente componente e utilizzata per alcuni progetti di inDomus è:

vacuum.turn_on

Avvia il processo di pulizia. Per le piattaforme Xiaomi Vacuum e Neato utilizzare al suo posto vacuum.start.

Attributo Opzionale Descrizione
entity_id Stringa o lista di stringhe che indicato al servizio a quale entity (di tipo “vacuum”) è orientato il servizio. Se omesso, si orienta verso tutti le entity “vacuum” presenti in configurazione.

Esempio di automazione:

automation:
  trigger:
    platform: time
    at: "07:15:00"
  action:
    - service: vacuum.turn_on
      data:
        entity_id: climate.mio_robot

vacuum.turn_off

Interrompe il processo di pulizia. Per le piattaforme Xiaomi Vacuum e Neato utilizzare al suo posto vacuum.stop.

Attributo Opzionale Descrizione
entity_id Stringa o lista di stringhe che indicato al servizio a quale entity (di tipo “vacuum”) è orientato il servizio. Se omesso, si orienta verso tutti le entity “vacuum” presenti in configurazione.

Esempio di automazione:

automation:
  trigger:
    platform: time
    at: "07:15:00"
  action:
    - service: vacuum.turn_off
      data:
        entity_id: climate.mio_robot

vacuum.start_pause

Avvia/interrompe/riprende il processo di pulizia.

Attributo Opzionale Descrizione
entity_id Stringa o lista di stringhe che indicato al servizio a quale entity (di tipo “vacuum”) è orientato il servizio. Se omesso, si orienta verso tutti le entity “vacuum” presenti in configurazione.

vacuum.start

Avvia il processo di pulizia.

Attributo Opzionale Descrizione
entity_id Stringa o lista di stringhe che indicato al servizio a quale entity (di tipo “vacuum”) è orientato il servizio. Se omesso, si orienta verso tutti le entity “vacuum” presenti in configurazione.

vacuum.pause

Interrompe (mettendolo in pausa) il processo di pulizia.

Attributo Opzionale Descrizione
entity_id Stringa o lista di stringhe che indicato al servizio a quale entity (di tipo “vacuum”) è orientato il servizio. Se omesso, si orienta verso tutti le entity “vacuum” presenti in configurazione.

vacuum.stop

Interrompe il processo di pulizia.

Attributo Opzionale Descrizione
entity_id Stringa o lista di stringhe che indicato al servizio a quale entity (di tipo “vacuum”) è orientato il servizio. Se omesso, si orienta verso tutti le entity “vacuum” presenti in configurazione.

vacuum.return_to_base

Impone al robot di rientrare alla base di ricarica.

Attributo Opzionale Descrizione
entity_id Stringa o lista di stringhe che indicato al servizio a quale entity (di tipo “vacuum”) è orientato il servizio. Se omesso, si orienta verso tutti le entity “vacuum” presenti in configurazione.

vacuum.locate

Localizza il robot.

Attributo Opzionale Descrizione
entity_id Stringa o lista di stringhe che indicato al servizio a quale entity (di tipo “vacuum”) è orientato il servizio. Se omesso, si orienta verso tutti le entity “vacuum” presenti in configurazione.

vacuum.clean_spot

Avvia il processo di pulizia su di un punto specifico preimpostato.

Attributo Opzionale Descrizione
entity_id Stringa o lista di stringhe che indicato al servizio a quale entity (di tipo “vacuum”) è orientato il servizio. Se omesso, si orienta verso tutti le entity “vacuum” presenti in configurazione.

vacuum.set_fan_speed

Avvia/interrompe/riprende il processo di pulizia.

Attributo Opzionale Descrizione
entity_id Stringa o lista di stringhe che indicato al servizio a quale entity (di tipo “vacuum”) è orientato il servizio. Se omesso, si orienta verso tutti le entity “vacuum” presenti in configurazione.
fan_speed no Permette di regolare la velocità di aspirazione, ovviamente se la piattaforma di integrazione lo supporta. Si regola in percentuale (0-100%) oppure tramite stringa (eg. “medium”).

vacuum.send_command

Invia comandi specifici previsti per la piattaforma d’ingrazione.

Attributo Opzionale Descrizione
entity_id Stringa o lista di stringhe che indicato al servizio a quale entity (di tipo “vacuum”) è orientato il servizio. Se omesso, si orienta verso tutti le entity “vacuum” presenti in configurazione.
command no Comando da eseguire.
params Eventuali parametri da inviare assieme al comando.


Home Assistant Official Logo ATTENZIONE: ricorda che sul nostro community FORUM c'è una sezione ad hoc dedica a Home Assistant, per qualsiasi dubbio, domanda, informazione nel merito specifico di queste componenti.


Telegram News Channel