Una custom card per Home Assistant progettata specificamente per il mercato elettrico italiano. Non limitarti a vedere i kWh: trasforma i consumi in costi reali includendo ogni singola voce della bolletta italiana.
- Calcolo Reale: Include Materia Prima, Perdite di Rete, Oneri di Sistema, Accise, IVA e Canone TV.
- Supporto Multi-Fascia: Gestione automatica delle fasce orarie F1, F2 e F3.
- Statistiche Avanzate: Confronta i dati storici e analizza la ripartizione dei costi tra quota fissa e variabile.
- Design Flessibile: Nuovo layout Ultra-Compact per dashboard minimaliste e una vista dettagliata per i "power user".
A sinistra la vista principale standard, a destra il dettaglio delle statistiche e della ripartizione costi.
Preview della scheda statistiche
- Editor Visuale Integrato (GUI): Configura tutto facilmente senza toccare una riga di codice.
- Tariffe Monorarie e a Fasce: Supporta sia i contratti a prezzo fisso che quelli indicizzati (PUN) inserendo i relativi sensori.
- Calcolo Completo: Tiene conto di Spread, Costi di Trasporto, Oneri di Sistema, Accise, PCV, Quota Potenza, IVA e Perdite di Rete.
- Finestra Statistiche: Un pop-up integrato che mostra il breakdown completo della bolletta (Imposte, Energia, Trasporto, ecc.) e il confronto con il mese precedente.
- Auto-rilevamento Mese Precedente: Legge in automatico l'attributo
last_perioddei tuoi Utility Meter per dirti quanto hai speso il mese scorso.
Warning
Per una stima accurata dei costi in bolletta, è fondamentale utilizzare sensori di consumo affidabili e inserire le voci di costo nel modo più preciso possibile. Si consiglia di sfruttare la funzione Valore manuale per la sorgente di consumo, inserendo i dati dell'ultima bolletta così da calibrare al meglio le singole voci di costo.
Per sfruttare la card al massimo delle sue potenzialità (specialmente i dati storici e il confronto con il mese scorso), si consiglia di non usare i consumi totali diretti del dispositivo, ma di creare dei sensori mensili, giornalieri, trimestrali ed annuali tramite l'integrazione ufficiale Utility Meter (Contatori) di Home Assistant:
- Vai su Impostazioni -> Dispositivi e Servizi -> Aiutanti -> Crea Aiutante -> Contatore (Utility Meter).
- Crea un sensore con ciclo di azzeramento Mensile (questo sarà il tuo sensore principale).
Nel caso in cui hai un contratto a prezzo variabile, basata sul PUN, ti consiglio di installare l'integrazione Prezzi PUN del mese
Metodo 1: Tramite HACS (In Attesa di approvazione)
- Apri HACS in Home Assistant.
- Vai su Frontend (Interfaccia).
- Clicca sui tre puntini in alto a destra e seleziona Repository personalizzati.
- Incolla l'URL di questo repository
https://github.com/elax46/card-bollettae seleziona come categoria Lovelace. - Clicca su Aggiungi e poi su Scarica.
- Ricarica la pagina del tuo browser.
- Scarica il file
italy-energy-bill-card.js. - Copia il file nella cartella
/config/www/del tuo Home Assistant (creala se non esiste). - Vai in Home Assistant: Impostazioni -> Plance -> Risorse (clicca sui 3 puntini in alto a destra se non lo vedi).
- Aggiungi una risorsa con URL:
/local/italy-energy-bill-card.jse tipo di risorsa: Modulo JavaScript. - Ricarica la pagina.
Il modo più semplice per usare la card è tramite l'interfaccia grafica (Editor Visivo):
- Vai nella tua Dashboard di Home Assistant e clicca su Modifica plancia.
- Clicca su Aggiungi scheda.
- Scorri fino in fondo (o cerca) e seleziona Custom: Card Bolletta.
- Si aprirà l'interfaccia di configurazione:
- Sezione 1: Scegli "Sensore (Reale)" e seleziona il tuo sensore Utility Meter mensile.
- Sezione 2, 3, 4, 5: Compila i campi inserendo i dati del tuo contratto luce (PCV, Spread, Oneri, ecc.). Se hai un costo fisso dell'energia, seleziona "Prezzo Fisso". Se hai il PUN, seleziona "Sensore" e cerca la tua entità del PUN.
- Sezione 6 (Opzionale): Inserisci qui i tuoi Utility Meter Giornalieri, Settimanali, ecc., se vuoi vederli nel pannello delle statistiche.
- Clicca su Salva.
Se preferisci l'editor di codice o vuoi copiare/incollare configurazioni preimpostate, ecco come funziona la configurazione YAML.
type: custom:italy-energy-bill-card
consumo_entity: sensor.monthly_consumption
p1_val: 0.09
quota_fissa_mese: 13.96
title: Costo energia
modo_consumo: ent
consumo_val: 321
perdite_rete: 10
spread: 0.0123
canone_tv: 9
tipo_costo: mono
modo_p1: val
trasporto: 0.018
oneri: 0.0229
accise: 0.0206
pcv: 6.1
fissi_rete: 1.91
contatore_kw: "3"
grid_options:
rows: auto
columns: 12
layout: standard
layout_compatto: true
bonus_enabled: true
bonus_valore_giorno: 0.51| Variabile | Descrizione | Default / Opzioni |
|---|---|---|
title |
Titolo della card | "Costo Energia" |
modo_consumo |
Origine del consumo principale | ent (Sensore) o val (Testuale) |
consumo_entity |
Entity ID del consumo mensile | es. sensor.consumo_mese |
tipo_costo |
Tipo di tariffazione | mono (Monoraria) o fasce (F1/F2/F3) |
modo_p1, p2, p3 |
Origine del prezzo (F1, F2, F3 o Mono) | val (Fisso) o ent (Sensore es. PUN) |
p1_ent, p1_val |
Entity ID o Valore fisso del prezzo | es. sensor.pun o 0.15 |
spread |
Spread aggiuntivo del fornitore (€/kWh) | 0 |
trasporto, oneri, accise |
Costi variabili per singolo kWh (€/kWh) | 0 |
pcv |
Quota fissa Commercializzazione (€/mese) | 0 |
fissi_rete |
Quota fissa Rete/Oneri (€/mese) | 0 |
contatore_kw |
Potenza impegnata contatore | 3 (es. 1.5, 3, 4.5, 6) |
prezzo_kw |
Costo mensile per kW di potenza impegnata | 1.98 |
canone_tv |
Costo mensile canone RAI | 0 (Imposta 9 può variare nel corso degli anni) |
iva |
Aliquota IVA applicata (%) | 10 (o 22) |
perdite_rete |
Perdite di rete applicate alla mat. prima (%) | 10 |
consumo_giornaliero_entity |
(Opzionale) Storico per le statistiche | es. sensor.consumo_oggi |
bonus_enabled |
(Opzionale) Bonus Sociale | es. bonus_enabled: true/false |
bonus_valore_giorno |
(Opzionale) Bonus giornaliero applicato per POD | es. 0.40 per il valore specifico fare riferimento alla tabella sul sito Arera |
La card è progettata per essere dinamica e riflettere la spesa reale accumulata fino al momento esatto in cui la consulti.
A differenza di una bolletta statica, la card aggiorna il calcolo del Bonus Sociale ARERA in modalità "pro-rata" (giorno per giorno). Questo evita di vedere un totale falsato all'inizio del mese e permette di monitorare l'andamento della spesa in tempo reale.
Se la card mostra un valore che sembra non corrispondere alla semplice sottrazione del bonus mensile intero, è perché sta ragionando sulla maturazione giornaliera:
Situazione ipotetica:
- Giorno attuale: 12 del mese X (quindi 12 giorni di bonus maturati).
- Sconto maturato:
$0,51€ \times 12 \text{ giorni} = \mathbf{6,12€}$
Questa logica garantisce che il risparmio cresca proporzionalmente insieme ai tuoi consumi durante tutto l'arco del mese.
Vuoi contribuire al progetto, modificare la grafica o cambiare i calcoli matematici? Ecco come impostare l'ambiente di sviluppo per testare le modifiche in tempo reale (HMR) bypassando i problemi di cache di Home Assistant.
-
Nel terminale avvia il server locale di Vite:
npm run dev
Vite partirà all'indirizzo
http://localhost:3000(o l'IP del tuo computer sulla rete locale). -
Vai nel tuo Home Assistant: Impostazioni -> Plance -> Risorse.
-
Aggiungi (o modifica se già presente) la risorsa della card inserendo l'URL del dev server di Vite. Assicurati di usare l'IP di rete del tuo computer se HA gira su un'altra macchina (es. un Raspberry Pi).
- URL:
http://[INDIRIZZO_IP_DEL_TUO_PC]:3000/italy-energy-bill-card.js - Tipo: Modulo JavaScript
- URL:
Ora, ogni volta che modificherai il file .js e salverai, Vite re-compilerà istantaneamente il codice e Home Assistant aggiornerà la card sulla plancia senza dover svuotare manualmente la cache ogni volta!
Una volta completata la fase di sviluppo puoi esegui il comando di build (npm run build). Questo genererà la cartella dist/ con il file italy-energy-bill-card.js pronto per essere caricato sulla tua istanza HA