Neargrid MQTT Driver
La seguente integrazione può essere utilizzata per inviare misurazioni del sito tramite MQTT e ricevere comandi per i diversi tipi di dispositivi installati.
Script demo Python
Contattare SmartgridOne per richiedere uno script demo.
Prerequisiti
Cloud Controller
I siti saranno controllati tramite un Cloud Controller. Si prega di contattare Controller per configurare un nuovo Cloud Controller.
Configurazione del sito
Una volta creato un Cloud Controller, esso conterrà un numero seriale univoco (standard1/rp_one_s/neargrid_ack/<site_filter>/<Controller SN>).
È possibile generare nuovi siti sul Cloud Controller utilizzando filtri sito unici standard1/outbound/neargrid_cmd/<site_filter>/<Controller SN>/.
Queste due variabili devono essere utilizzate nei Topics e nel Corpo MQTT.
Avviso
L'uso di filtri sito identici comporterà errori.
Selezione dei dispositivi
| Device Type | Supported |
|---|---|
| Solar Inverters | ✅ |
| Storage Devices | |
| Heatpumps | |
| Grid & Consumption Meters | |
| EV Chargers | ❌ |
Nota
I dispositivi in un sito non possono essere modificati dopo la creazione.
Credenziali MQTT
SmartgridOne fornirà le credenziali MQTT. Il nome utente MQTT deve essere inserito durante la generazione di un nuovo sito.
Nota
Le credenziali devono essere fornite una sola volta. Un set di credenziali MQTT può essere utilizzato per controllare tutti i siti.
Invio delle misurazioni
Per inviare misurazioni al SmartgridOne Controller, il seguente topic MQTT può essere usato per la pubblicazione: standard1/outbound/neargrid_meas/<site_filter>/<Controller SN>/
I campi opzionali sono indicati in corsivo.
I seguenti campi possono essere inviati per tipo di dispositivo:
-
Storage
- mean_soc_perc
- active_power_W
- today_charged_Wh
- today_discharged_Wh
- energy_stored_Wh
-
Solare
- active_power_W
- today_energy_Wh
-
Pompe di calore
- operation_modes
- I possibili modi di funzionamento sono off, on
- active_power_W
- Uguale alla potenza nominale mentre la pompa di calore è on
- operation_modes
-
Contatori
- active_power_W
- today_imported_energy_Wh
- today_exported_energy_Wh
Il messaggio deve essere strutturato come segue:
{
"time": "<Unix Timestamp>",
"data": {
"state": {
"grid": {
"active_power_W": <Potenza attiva rete in Watt>,
"today_imported_energy_Wh": <Energia importata rete in Watt-ora>,
"today_exported_energy_Wh": <Energia esportata rete in Watt-ora>,
},
"meter": {
"active_power_W": <Potenza attiva rete in Watt>,
"today_imported_energy_Wh": <Energia importata rete in Watt-ora>,
"today_exported_energy_Wh": <Energia esportata rete in Watt-ora>,
},
"storage": {
"energy_stored_Wh": <Energia immagazzinata in Watt-ora>,
"mean_soc_perc": <Percentuale media dello stato di carica>,
"active_power_W": <Potenza attiva in Watt>,
"today_charged_Wh": <Energia caricata oggi in Watt-ora>,
"today_discharged_Wh": <Energia scaricata oggi in Watt-ora>,
},
"solar": {
"active_power_W": <Potenza attiva solare in Watt>,
"today_energy_Wh": <Energia prodotta oggi in Watt-ora>.
},
"heat_pump": {
"active_power_W": <Potenza attiva pompa di calore in Watt>,
"operation_modes": <Modalità di funzionamento della pompa di calore>
}
},
"response_code": <Codice di risposta>
},
"fields": {},
"requestTime": "<Unix Timestamp>",
"time": "<Unix Timestamp>",
"siteNodeId": "<site_filter"
}Conferma di ricezione della misurazione
Quando una misurazione è stata ricevuta con successo, una conferma verrà inviata sul seguente topic: standard1/rp_one_s/neargrid_ack/<site_filter>/<Controller SN>
Questa conferma può essere utilizzata per:
- Verificare che il messaggio della misurazione sia stato ricevuto correttamente.
- Verificare che il messaggio di misurazione contenesse tutti i dati necessari.
Ricezione dei comandi
Per ricevere comandi da SmartgridOne Controller, iscriversi al seguente topic MQTT: standard1/outbound/neargrid_cmd/<site_filter>/<Controller SN>/
La risposta è strutturata come segue:
{
"extraTags": {
"nodeId": "<Controller SN>_site_0"
},
"time": "<Unix Timestamp>",
"fields": {
"solar_policy": "<policy>",
"solar_power_setpoint_w": 5000,
"storage_policy": "<policy>",
"storage_power_setpoint_w": -5000
}
}L'elenco delle politiche che possono essere ricevute si trova qui: List of Potential Policies
