Creare un sensore del prezzo del gas (PSBIL_BUY) in Home Assistant

In questa guida cerco di spiegare passo-passo (diciamo per principianti) come recuperare le informazioni relative a prezzo del gas (nel caso specifico il valore PSBIL_BUY) reperibili sul sito del GME (GME - Gestore dei Mercati Energetici SpA (mercatoelettrico.org)), che normalmente non sono reperibili automaticamente.
Questi dati sono disponibili e "facilmente" consultabili per una persona, ma diventa difficile farlo automaticamente per via delle conferme e dei flag che è necessario "spuntare" per poter acedere alla pagina dei dati.
Come sempre cercherò di scrivere un articolo come piace a me: inserirò le informazioni necessarie senza dilungarmi troppo, senza continue ripetizioni (in stile SEO) e andando al punto, ma inserendo le informazioni che è necessario sapere (per capire cosa si sta facendo).

Come prima cosa, naturalmente, dovete avere un’installazione di Home Assistant funzionante e correttamente configurata.

1. Configurazione tipo (HW/SW)

Nel mio caso mi trovo nella seguente situazione (cioè, se avete la mia stessa configurazione e seguite la guida, vi garantisco che funziona):

• Raspberry Pi 4 – 8 GB
• Home Assistant 2022.12.8
• Supervisor 2022.11.2
• Operating System 9.4

2. Prerequisiti

 Come già detto dovete avere:

• Installazione di Home Assistant (qualunque tipologia) funzionante

3. Breve introduzione/spiegazione

Faccio una piccola premessa per spiegare che dato andiamo a prendere e cosa significa. Se non avete una bolletta a prezzo dell'energia fisso (purtroppo ad oggi penso che nessuno abbia più possibilità di avere un contratto del genere), il prezzo della materia prima risulta variabile, e calcolato secondo 2 "indici" o "criteri":

• PSV - che significa "Punto di Scambio Virtuale" e si basa fondamentalmente su vendite e acquisti fatti tra la rete nazionale e l'estero
• PSBIL - che corrisponde alla media aritmetica (a livello mensile) dei prezzi di sbilanciamento di acquisto

A seconda del vostro gestore, potrebbe essere applicato un indice piuttosto che l'altro. nel mio caso il mio gestore usa il PSBIL, per cui sono andato a recuperare questo dato specifico.

Ora, il calcolo di questo valore è piuttosto complicato, e soprattutto si appoggia a dati che non sono reperibili se non dal GME. Inoltre il costo mensile si può sapere solo una volta che il mese è concluso (media aritmetica dei valori giornalieri), e per ogni giorno non basta prendere il prezzo medio ponderato, ma (se c'è) bisogna prendere il prezzo massimo di acquisto SRG.

Capite quindi che è un problema insormontabile.

Abbiamo perciò 2 possibilità:

• Prendere il PSBIL_buy del mese precedente (facilmente fattibile con un sensore scrape), che però ha un grosso vantaggio in caso di prezzi molto aleatori come in questo periodo: sarà molto poco preciso.
• Prendere il valore giornaliero, contando sul fatto che il nostro consumo giornaliero sia in qualche modo simile tra un giorno e l'altro, e quindi a fine mese avremmo una valorizzazione simile a quella della bolletta.

Un metodo migliore sarebbe quello di aggiornare una media mensile, andando a cambiare i dati della plancia Energia, ma non credo sia fattibile ad ora.

Per cui ho deciso di adottare il secondo metodo, cioè di prendere il dato giornaliero e confidare nella maggiore accuratezza teorica.

4. Reperire i dati

Per sapere che dati prendere, c'è da girare un po' sul sito del GME e impazzire cercando di capire quali siano i valori da utilizzare. Dopo molti scervellamenti e calcoli sono riuscito a trovare questa pagina, che fa al caso nostro: GME - Esiti dei mercati - - Dati funzionali alla      determinazione del prezzo     di sbilanciamento (mercatoelettrico.org)

Qui sorge un altro problema: da HA direttamente non si riesce ad arrivare a recuperare questi dati. Vediamo come ho "risolto" la cosa.

5. Il Proxy

Per ovviare al problema ho prima di tutto verificato (grazie a Postman) che fosse possibile simulare la navigazione tramite browser sul sito del GME. Infatti in caso contrario non sarebbe stato possibile farlo in alcun modo.

Un volta appurata la fattibilità della cosa, si trattava di scegliere una strada:

• fare un'integrazione di HA che recupera i dati
• creare una sorta di "proxy" che prenda i dati dal sito del GME e li "converta" in JSON, per usarli con un sensore REST

La prima strada (nel mio caso specifico) presentava qualche "contro": non conosco python, me lo sarei dovuto studiare (e non ne ho il tempo); non ho mai creato un'integrazione di HA, quindi mi sarei dovuto studiare come realizzarne una; il debug è rognoso.

La seconda strada, d'altronde, per me ha diversi punti a favore: possedevo già uno spazio in hosting con DB, supporto ASP.NET/Classic e PHP; ne ho già fatti e so come realizzarli (conosco diversi metodi per farlo); il debug è molto comodo.

Tutto ciò per dire che la decisione è stata quasi obbligata, ed ho realizzato un sistema che giornalmente recupera le informazioni dal GME, le salva in un database e le rende fruibili in JSON tramite un URL: https://www.andreafumi.it/Utilities/GMEDataParser.ashx?type=gas

Vediamo ora come inserire il sensore in HA.

6. Aggiungere i sensori in HA

Come già detto altre volte, do per scontato che abbiate un editor testuale installato e configurato in HA (File editor o Filebrowser) e che quindi li sappiate usare. Se avete anche abilitato la cartella Packages, vi consiglio di creare un file .yaml dedicato ai sensori dei costi dell'energia (per pulizia e ordine io preferisco fare così).

Andiamo quindi ad aggiungere al file configuration.yaml (o ad un altro file *.yaml nella cartella Packages) il seguente codice:

rest:
  - resource: https://www.andreafumi.it/Utilities/GMEDataParser.ashx?type=gas
    scan_interval: 3600
    headers:
      Content-Type: application/json
    sensor:
      - name: PSBIL_BUY Gas Yesterday
        unit_of_measurement: €
        value_template: "{{ value_json.PrezzoGiornalieroM3 }}"

che si occuperà di richiedere (con frequenza oraria) il costo aggiornato dell'energia (riferito al giorno precedente).

Andiamo quindi in "Strumenti per sviluppatori"

Clicchiamo su "VERIFICA CONFIGURAZIONE" (per accertarci di aver indentato tutto correttamente

Quindi clicchiamo su "ENTITA' REST E SERVIZI DI NOTIFICA REST" per far caricare il nostro nuovo sensore.

A questo punto spostiamoci sul tab "STATI"

Filtriamo per il nome del nostro sensore e verifichiamo che sia stato caricato correttamente

Ora, questo valore è già corretto, ma non è quello che vedremo in bolletta. Infatti oltre a questo costo puro, ci sono i ricarichi applicati dal gestore, le spese di trasporto, le accise, le tasse, ecc.

Perciò normalmente creo un altro sensore che va ad applicare i ricarichi al costo dell'energia, in modo da avere un costo stimato della bolletta il più realistico possibile.

Aggiungiamo al file configuration.yaml (o ad un altro file *.yaml nella cartella Packages) il seguente codice:

sensor:    
  - platform: template
    sensors:
      psbil_buy_actual_daily:
        friendly_name: "PSBIL_BUY actual daily"
        unit_of_measurement: EUR/m³
        value_template:  >
            {{ (float(states('sensor.psbil_buy_gas_yesterday')) * 1.02688993 + 0.045 + 0.055133 + 0.16047282 + 0.17 + 0.0309874) * 1.05 }}

ATTENZIONE! questi sono i dati del mio contratto, nel vostro caso potrebbero essere diversi. Controllate sull'ultima bolletta i vostri costi.

Torniamo su "Strumenti per sviluppatori"

Verifichiamo di nuovo la correttezza della configurazione

Infine su "ENTITA' MODELLO" per caricare il nuovo sensore.

Poi andiamo sul tab "STATI"

e controlliamo che il sensore sia valorizzato correttamente

FINE!

Adesso possiamo usare "sensor.psbil_buy_actual_daily" come entità di costo del gas nella plancia Energia!