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:

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:

vacuum.turn_on
vacuum.turn_off
vacuum.start_pause
vacuum.start
vacuum.pause
vacuum.stop
vacuum.return_to_base
vacuum.locate
vacuum.clean_spot
vacuum.fan_speed
vacuum.send_command

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 è:

Piattaforma Home Assistant “MQTT Vacuum” (aspirapolvere MQTT)

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	sì	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	sì	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	sì	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	sì	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	sì	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	sì	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	sì	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	sì	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	sì	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