Nanogreen è un fornitore ceco di energia verde che offre elettricità a prezzi spot di mercato. Questo template collega TapHome all’API clienti di Nanogreen (moje.nanogreen.cz) tramite HTTPS, scaricando i prezzi spot orari di oggi e gli indicatori correlati. Non è necessario hardware fisico — il template è un servizio dati puro che interroga l’API ogni 5 minuti.
Il template fornisce 37 dispositivi: 24 sensori di prezzo orario, 6 indicatori dell’ora più economica (per finestre temporali fuori picco, in picco e per l’intera giornata), 6 sensori binari per il controllo in tempo reale “è questa l’N-esima ora più economica” e un sensore del prezzo di mercato in tempo reale.
Configurazione
Durante l’importazione del template, inserisci l’endpoint API di Nanogreen (moje.nanogreen.cz) come host. Il template comunica tramite HTTPS (porta 443). Non è richiesta alcuna chiave API o autenticazione — i dati sui prezzi sono accessibili pubblicamente.
Capacità dei dispositivi
Prezzi orari (24 sensori)
Il template espone un sensore per ogni ora del giorno (0:00–1:00 fino a 23:00–0:00). Ogni sensore legge il valore corrispondente dall’array todayHourlyPrices nella risposta API. I prezzi sono in CZK/kWh.
Questi sensori si aggiornano ad ogni ciclo di interrogazione (5 minuti). In pratica, i prezzi giornalieri vengono pubblicati una volta al giorno, quindi i valori rimangono stabili per tutta la giornata.
Indicatori dell’ora più economica (6 sensori)
Sei sensori identificano l’ora più economica e la seconda più economica in tre finestre temporali:
- Off-Peak Cheapest Hour / Off-Peak 2nd Cheapest Hour — ore più economiche al di fuori del periodo di picco energetico
- Peak Cheapest Hour / Peak 2nd Cheapest Hour — ore più economiche durante il periodo di picco energetico
- All-Day Cheapest Hour / All-Day 2nd Cheapest Hour — ore più economiche nell’arco dell’intera giornata
Ogni sensore restituisce un indice orario (0–23). Ad esempio, un valore di 3 significa che l’ora 3:00–4:00 è la più economica in quella finestra.
Sensori binari (6 sensori)
Sei sensori binari (on/off) indicano se l’ora corrente è tra le più economiche della giornata:
- Is Cheapest Hour? — vero se l’ora corrente è la più economica
- Is 2nd Cheapest Hour? — vero se l’ora corrente è la 2ª più economica
- Is 3rd Cheapest Hour? — vero se l’ora corrente è la 3ª più economica
- Is 4th Cheapest Hour? — vero se l’ora corrente è la 4ª più economica
- Is 5th Cheapest Hour? — vero se l’ora corrente è la 5ª più economica
- Is 6th Cheapest Hour? — vero se l’ora corrente è la 6ª più economica
Questi sensori sono implementati come contatti reed (PacketParserReedContact) che convertono la risposta booleana dell’API in valori 0/1. Sono lo strumento principale per l’automazione — usali come condizioni nelle smart rules per attivare azioni durante le ore più economiche.
Prezzo di mercato attuale (1 sensore)
Il sensore Current Spot Price legge il prezzo di mercato dell’elettricità in tempo reale dall’OTE (operatore del mercato elettrico ceco), convertito in CZK tramite il tasso di cambio CNB (Banca Nazionale Ceca). Questo valore riflette il prezzo all’ingrosso in tempo reale in CZK/kWh.
Esempi di automazione
Far funzionare gli elettrodomestici durante le ore più economiche
Usa i sensori binari come condizioni in una smart rule. Ad esempio, per riscaldare uno scaldabagno solo durante le 3 ore più economiche della giornata:
- Crea una smart rule con la condizione: Is Cheapest Hour? = ON OPPURE Is 2nd Cheapest Hour? = ON OPPURE Is 3rd Cheapest Hour? = ON
- Imposta l’azione per accendere il relè dello scaldabagno
- Lo scaldabagno funziona solo quando l’elettricità è al prezzo più basso
Automazione con soglia di prezzo
Usa il sensore Current Spot Price con una condizione numerica. Ad esempio, accendi una pompa di calore solo quando il prezzo spot scende sotto una soglia (es. 2,00 CZK/kWh).
Risoluzione dei problemi
I prezzi mostrano zero o NaN
- Verifica che l’API Nanogreen sia raggiungibile — apri
https://moje.nanogreen.cz/api/prices/dailyin un browser - Controlla che la TapHome CCU abbia accesso a internet (l’API è un servizio cloud, non un dispositivo locale)
- I prezzi per il giorno successivo vengono tipicamente pubblicati nel pomeriggio — se interrogati troppo presto, alcuni campi potrebbero non essere ancora disponibili
I sensori binari non si aggiornano
I sensori binari confrontano l’ora corrente con la classifica dei prezzi della giornata. Si aggiornano ad ogni ciclo di interrogazione (5 minuti). Se un sensore rimane nello stato sbagliato, verifica che i sensori dei prezzi orari contengano dati validi per la giornata odierna.
Questo template richiede una connessione internet attiva sulla TapHome CCU. A differenza dei template per dispositivi locali (Shelly, Modbus), l’integrazione Nanogreen comunica con un’API cloud esterna. Assicurati che il tuo firewall di rete consenta il traffico HTTPS in uscita verso
moje.nanogreen.cz.