Driver MQTT di Neargrid

L'integrazione seguente può essere utilizzata per inviare misurazioni del sito via MQTT e ricevere comandi per i diversi tipi di dispositivi installati.

Script di demo Python

Contatta Eniris per richiedere uno script dimostrativo.

Prerequisiti

Cloud Controller

I siti saranno controllati tramite un Cloud Controller. Si prega di contattare Eniris per configurare un nuovo Cloud Controller.

Configurazione del Sito

Una volta creato un Cloud Controller, conterrà un numero di serie unico (<Controller SN>).

Nuovi siti possono essere generati sul Cloud Controller utilizzando filtri unici per sito <site_filter>.

Queste due variabili devono essere utilizzate nei Topics e nel Body MQTT.

warning

Utilizzare filtri per sito identici porterà a errori.

Selezione del Dispositivo

Device Type	Supportato
Inverter Solari	✅
Dispositivi di Stoccaggio
Pompe di Calore
Contatori di Rete e Consumo
Caricatori EV	❌

informazioni

I dispositivi in un sito non possono essere modificati dopo la creazione.

Credenziali MQTT

Eniris fornirà le credenziali MQTT. Il nome utente MQTT deve essere inserito quando si genera un nuovo sito.

informazioni

Le credenziali devono essere fornite solo una volta. Un insieme di credenziali MQTT può essere utilizzato per controllare tutti i siti.

Invio di misurazioni

Per inviare misurazioni al SmartgridOne Controller, si può utilizzare il seguente topic MQTT 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:

• Stoccaggio

  • 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
    • Le modalità operative possibili sono off, on
  • active_power_W
    • Corrisponde alla potenza nominale quando la pompa di calore è on

• 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 della Rete in Watt>,
                "today_imported_energy_Wh": <Energia Importata dalla Rete in Wattora>,
                "today_exported_energy_Wh": <Energia Esportata dalla Rete in Wattora>,
            },
            "meter": {
                "active_power_W": <Potenza Attiva del Contatore in Watt>,
                "today_imported_energy_Wh": <Energia Importata dal Contatore in Wattora>,
                "today_exported_energy_Wh": <Energia Esportata dal Contatore in Wattora>,
            },
            "storage": {
                "energy_stored_Wh": <Energia Stoccata in Wattora>,
                "mean_soc_perc": <Percentuale Media di Stato di Carica>,
                "active_power_W": <Potenza Attiva in Watt>,
                "today_charged_Wh": <Energia Caricata Oggi in Wattora>,
                "today_discharged_Wh": <Energia Scaricata Oggi in Wattora>,
            },
            "solar": {
                "active_power_W": <Potenza Attiva Solare in Watt>,
                "today_energy_Wh": <Energia Prodotta Oggi in Wattora>.
            },
            "heat_pump": {
                "active_power_W": <Potenza Attiva della Pompa di Calore in Watt>,
                "operation_modes": <Modalità Operativa della Pompa di Calore>
            }
        },
        "response_code": <Codice di Risposta>
    },
    "fields": {},
    "requestTime": "<Unix Timestamp>",
    "time": "<Unix Timestamp>",
    "siteNodeId": "<site_filter"
}

Riconoscimento della Misurazione

Quando una misurazione è stata ricevuta con successo, un riconoscimento sarà inviato sul seguente topic: standard1/rp_one_s/neargrid_ack/<site_filter>/<Controller SN>

Questo riconoscimento può essere utilizzato per:

1. Verificare che il messaggio di misurazione sia stato ricevuto con successo.
2. Verificare che il messaggio di misurazione contenga tutti i dati necessari.

Ricezione di comandi

Per ricevere comandi dal 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: Elenco delle Politiche Potenziali