Irrigazione smart con “My garden Irrigation” per Home Assistant

Oggi voglio proporre un ottimo “programmino” chiamato My garden irrigation realizzato dall’ utente klogg facente parte del forum di home-assistant.io che permette di integrare ad Home Assistant un’interfaccia grafica per il vostro sistema di irrigazione smart.

UPDATE 29/07/2020: Aggiornato lo script: necessario HA versione 0.113.2 o superiore

UPDATE LUGLIO 2021: Aggiornato lo script: necessario HA versione 2021.7 o superiore

Lo seguo già da più di un anno, quando aveva iniziato a sviluppare la versione 1 (di cui nel mio piccolo sono riuscito a dare qualche contributo o suggerimento), che era veramente funzionale… ma con l’arrivo della versione 2 è stato fatto un salto di qualità veramente impressionante!

Se con la versione 1 era comunque necessario mettere mano a un po’ di codice per integrare i vostri switch delle elettrovalvole (il sistema era creato per lavorare con 4 elettrovalvole), con questa versione possiamo dire che con un copia-incolla delle cartelle del package, siamo “quasi” pronti a partire senza modificare il codice originale! Inoltre è possibile aggiungere tutte le elettrovalvole che si vogliono (e dargli un nome a piacere), quindi si tratta di un sistema di irrigazione veramente funzionale e ben progettato!

Considerando che questa è una versione BETA, funziona a meraviglia ed ogni giorno vengono apportate migliorie a tutto lo script.

Nel momento della stesura della guida infatti è prevista (dando una sbirciatina al codice) la possibilità di traduzione di tutte le voci che trovate… che probabilmente verrà aggiunta nelle prossime versioni.

Ma partiamo subito e andiamo a vedere come integrare il tutto ad Home Assistant.

Per prima cosa assicuriamoci che Home Assistant sia aggiornato alla versione 2021.7 o superiore.

Per il progetto è necessario possedere delle elettrovalvole collegate a dei relè smart per beneficiare di tutto il sistema.

Non le avete ancora? Allora vi consiglio la mia precedente guida per tasmotare un Sonoff 4CH PRO R2 da utilizzare appunto per il vostro impianto di irrigazione smart: trovate lo schema di collegamento qui.

Nell’esempio più avanti farò uso delle mie 7 elettrovalvole che ho inserito in Home Assistant nella sezione switch.

Tali switch utilizzano la piattaforma mqtt in quanto trattasi di 2 Sonoff 4CH PRO R2 tasmotati (3 canali utilizzati per il giardino di fronte, 4 per il giardino dietro):

switch:
  #irrigazione giardino fronte SX
  - platform: mqtt
    name: elettrovalvola_fronte_1
    state_topic: "stat/sonoff4ch_pro_irrig_fronte/POWER1"
    command_topic: "cmnd/sonoff4ch_pro_irrig_fronte/POWER1"
    qos: 1
    payload_on: "ON"
    payload_off: "OFF"
    retain: false

  #irrigazione giardino fronte DX + vasi balcone
  - platform: mqtt
    name: elettrovalvola_fronte_2
    state_topic: "stat/sonoff4ch_pro_irrig_fronte/POWER2"
    command_topic: "cmnd/sonoff4ch_pro_irrig_fronte/POWER2"
    qos: 1
    payload_on: "ON"
    payload_off: "OFF"
    retain: false

  #irrigazione vasi fronte SX
  - platform: mqtt
    name: elettrovalvola_fronte_3
    state_topic: "stat/sonoff4ch_pro_irrig_fronte/POWER3"
    command_topic: "cmnd/sonoff4ch_pro_irrig_fronte/POWER3"
    qos: 1
    payload_on: "ON"
    payload_off: "OFF"
    retain: false

  #irrigazione striscia lamponi
  - platform: mqtt
    name: elettrovalvola_retro_1
    state_topic: "stat/sonoff4ch_pro_irrig_retro/POWER1"
    command_topic: "cmnd/sonoff4ch_pro_irrig_retro/POWER1"
    qos: 1
    payload_on: "ON"
    payload_off: "OFF"
    retain: false

  #irrigazione striscia giardino
  - platform: mqtt
    name: elettrovalvola_retro_2
    state_topic: "stat/sonoff4ch_pro_irrig_retro/POWER2"
    command_topic: "cmnd/sonoff4ch_pro_irrig_retro/POWER2"
    qos: 1
    payload_on: "ON"
    payload_off: "OFF"
    retain: false

  #irrigazione quadrato giardino
  - platform: mqtt
    name: elettrovalvola_retro_3
    state_topic: "stat/sonoff4ch_pro_irrig_retro/POWER3"
    command_topic: "cmnd/sonoff4ch_pro_irrig_retro/POWER3"
    qos: 1
    payload_on: "ON"
    payload_off: "OFF"
    retain: false

  #irrigazione orto
  - platform: mqtt
    name: elettrovalvola_retro_4
    state_topic: "stat/sonoff4ch_pro_irrig_retro/POWER4"
    command_topic: "cmnd/sonoff4ch_pro_irrig_retro/POWER4"
    qos: 1
    payload_on: "ON"
    payload_off: "OFF"
    retain: false

A questo punto potete scaricare il pacchetto dall’indirizzo https://github.com/kloggy/HA-Irrigation-Version2 dove troverete sempre la versione aggiornata, con anche accorgimenti per abilitare eventuali notifiche telegram, grafici, sensori smartweather e darksky (che non verranno trattati in questa guida). Ma se siete curiosi date un occhio qui.

Scompattiamo lo zip del repository github sul nostro PC e teniamolo li mentre facciamo altre operazioni.

Per il corretto funzionamento è necessario installare il componente HACS e alcuni custom-components aggiuntivi.

Per installare HACS vi rimando a questa guida.

Una volta che avete HACS funzionante è necessario integrare questi custom components elencati:

• browser_mod (https://github.com/thomasloven/hass-browser_mod)
• lovelace_gen (https://github.com/thomasloven/hass-lovelace_gen)
• card-mod (https://github.com/thomasloven/lovelace-card-mod)
• hui-element (https://github.com/thomasloven/lovelace-hui-element)
• button-card (https://github.com/custom-cards/button-card)
• config-template-card (https://github.com/iantrich/config-template-card)
• mini-graph-card (https://github.com/kalkih/mini-graph-card)
• layout-card (https://github.com/thomasloven/lovelace-layout-card)
• state-switch (https://github.com/thomasloven/lovelace-state-switch)
• time-picker-card (https://github.com/GeorgeSG/lovelace-time-picker-card)

Per i primi 2 cioè browser_mod e lovelace_gen è necessario apportare modifiche anche al configuration.yaml quindi vi invito a seguire la guida ufficiale di ogni componente.

Successivamente dobbiamo accertarci che nel nostro configuration.yaml sia presente:

homeassistant:
  packages: !include_dir_named packages

packages infatti sarà la cartella dove andremo a mettere tutti gli script di “My garden irrigation”. Se non esiste, creiamola nella root, dove si trova configuration.yaml

Ora andiamo ad aprire la cartella precedentemente scompattata sul nostro PC e cerchiamo all’interno la cartella denominata lovelace e copiamola nella root, dove si trova il configuration.yaml

Identifichiamo sempre nella cartella scompattata prima, anche la cartella package e copiamone il contenuto nella cartella packages (creata prima se non esisteva già).

NOTA BENE: se avete già installato in precedenza “My garden irrigation” e volete effettuare un semplice aggiornamento del pacchetto, è necessario rimuovere tutti i vecchi file della cartella lovelace e del contenuto di package (stando attenti a non cancellare altri file che non centrano con questo pacchetto) e incollare quelli nuovi.

Lo script di irrigazione fa uso delle scene: se il vostro file configuration.yaml utilizza l’opzione default_config: (di solito si trova all’inizio del file) non dovrete fare altro. In caso contrario se non utilizzate tale opzione, è necessario inserire nel file semplicemente la scringa:

scene:

Ora è necessario indicare un sensore di tipo time da qualche parte nel vostro Home Assistant. Perchè non è stato implementato già nel package di My garden irrigation? Semplicemente perchè è un sensore molto usato da altri componenti quindi la creazione di un duplicato manderebbe in errore la configurazione.

Quindi nel caso non lo abbiate ancora, create da qualche parte nella sezione sensors:

- platform: time_date
  display_options:
    - 'time'
    - 'date'

(ho aggiunto anche date anche se non necessario qui)

Io ho deciso di mettere tutti i sensori “comuni” nel file sensors.yaml e integrarlo in configuration.yaml tramite:

sensor: !include sensors.yaml

Ora quello che andremo a fare è creare una dashboard dedicata a My garden irrigation in quanto il package necessità che lovelace sia impostato in modalità yaml.

Siccome molti preferiscono utilizzare la più semplice modalità storage, le ultime versioni di Home Assistant (>0.107) ci vengono incontro grazie alla possibilità di creazione più dashboard in parallelo in modalità mixed mode.

Sempre nella root creiamo un file chiamato irrigazione.yaml e copiamoci dentro:

title: Irrigazione
views:
  - !include lovelace/view_garden_version2.yaml

Ora modifichiamo il file configuration.yaml in modo da avere la dashboard principale in modalità storage, e quella dedicata a My garden irrigation in modalità yaml:

lovelace_gen:

lovelace:
  mode: storage
  dashboards:
    lovelace-irrigazione:
      mode: yaml
      title: Irrigazione
      icon: mdi:flower
      show_in_sidebar: true
      filename: irrigazione.yaml

Notare che lovelace_gen: (necessario per il componente lovelace_gen) è indicato prima del blocco lovelace:

La configurazione precedente come detto fa in modo di utilizzare la modalità storage come principale.

Ora andiamo ad integrare 2 fonts utilizzati. Tali fonts devono essere inseriti sotto la voce resources insieme a tutti gli altri custom components di HACS nel caso stiate utilizzando la dashboard principale in modalità yaml:

(notare il percorso /hacsfiles/… in quanto sto utilizzando hassio)

lovelace:
  mode: yaml
  resources:
    - type: module
      url: browser_mod.js
    - type: module
      url: /hacsfiles/mini-graph-card/mini-graph-card-bundle.js
    - type: module
      url: /hacsfiles/lovelace-card-mod/card-mod.js
    - type: module
      url: /hacsfiles/button-card/button-card.js
    - type: module
      url: /hacsfiles/config-template-card/config-template-card.js
    - type: module
      url: /hacsfiles/lovelace-layout-card/layout-card.js
    - type: module
      url: /hacsfiles/lovelace-state-switch/state-switch.js
    - type: module
      url: /hacsfiles/lovelace-hui-element/hui-element.js
    - type: module
      url: /hacsfiles/lovelace-time-picker-card/time-picker-card.js
    - url: https://fonts.googleapis.com/css?family=Oswald
      type: css
    - url: https://fonts.googleapis.com/css?family=Dosis
      type: css

Altrimenti i fonts, nel caso siate in modalità principale di storage, saranno integrati tramite pannello apposito: andiamo nel menu Impostazioni -> Cruscotti lovelace e spostiamoci nella tab Risorse.

Utilizziamo il tasto + in basso a destra per aggiungere le 2 risorse font compilando l’URL e il tipo di risorsa: Foglio di stile.

Tutte le altre risorse che vedere (moduli) sono compilate in automatico se vi trovate nella modalità storage, quando integrate un nuovo custom component tramite HACS.

Ora, opzionale, se volete utilizzare il tema scuro come da esempi sopra, è necessario installare tramite HACS il tema dark_teal: https://github.com/aFFekopp/dark_teal e aggiungere al configuration.yaml (se non già presente):

frontend:
  themes: !include_dir_merge_named themes

Ora possiamo riavviare Home Assistant.

Una volta riavviato possiamo cambiare il tema dal menu con il vostro nome e scegliere dark_teal:

Il riavvio di Home Assistant, se avete fatto tutto come si deve, farà apparire una nuova voce di menu chiamata Irrigazione

Appena entrate vi troverete il sistema giustamente spento. Cliccate per attivarlo:

Vi si presenterà questa schermata. Andiamo quindi subito a dire al sistema quante elettrovalvole (zone) vogliamo usare cliccando su Number of Zones. Si aprirà un popup, selezionare il numero e premere INVIO.

Si creeranno quindi N zone di default con nome fittizio. Cliccare sul nome di ogni zona per darle un nome e uno switch da comandare. Nota bene: includere anche il suffisso switch. a Switch Name. esempio: switch.elettrovalvola_fronte_2

Ora nella colonna centrale possiamo dare un nome ai cicli (che sono 2 + 1 manuale). Di default sono chiamati MORNING CYCLE, AFTERNOON CYCLE e MANUAL CYCLE.

Per rinominarli selezionare la scheda apposita dalla prima riga e cliccare quindi sul nome (che ho indicato in rosso). Confermare sempre con INVIO.

Da ogni schermata quindi è anche possibile specificare per ogni zona la durata da 0 a 60 minuti (utilizzando lo slider a pallino), i giorni della settimana (oppure tutto il giorno) e ovviamente lo Start time.

Ogni ciclo inoltre ha le proprie impostazioni di durata/inizio/giorni indipendente dagli altri.

Siamo pronti ora per fare un test. Spostiamoci nella scheda MANUAL CYCLE e facciamo partire un ciclo di prova (magari impostando tutte le zone a 1 minuto) per essere certi del funzionamento:

Vedrete a sinistra la zona irrigata in tempo reale con il tempo residuo.

Complimenti, il vostro sistema di irrigazione smart è pronto e funzionante!

Come premesso il progetto è ancora in beta, ma complemente funzionante e promette nuove funzionalità come traduzioni, bugfix, aggiunta del pulsetime per dispositivi tasmotati, check di sensori di pioggia esterni come questo e molto altro quindi mettete questa pagina tra i preferiti perchè sarà aggiornata se necessario.

Chi vuole sperimentare e utilizzare funzioni avanzate come integrazione di Darksky o altri sensori meteo per aggiustamento durate, integrazione con notifiche telegram e quant’altro è invitato a seguire il thread ufficiale qui e sbirciare le altre impostazioni in Settings.