Scholt MQTT Driver

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

Script demo Python

Questo codice di test esegue un semplice lavoro di invio continuo di misurazioni fittizie a un'installazione e di ricezione di comandi:

Si prega di scaricare il file qui sotto nel proprio IDE Python preferito. Compilare il numero di serie, il filtro del sito e le credenziali MQTT e quindi eseguire lo script:

Requisiti

Cloud Controller

I siti saranno controllati tramite un Cloud Controller. Si prega di contattare Eniris per impostare 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 del sito <site_filter>.

Queste due variabili devono essere utilizzate nei Temi e nel Corpo MQTT.

warning

L'uso di filtri del sito identici porterà a errori.

Selezione dei dispositivi

Device Type	Supportato
Inverter Solari	✅
Dispositivi di Storage
Pompe di Calore
Contatori di Rete & Consumo
Caricatori per VE	❌

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 al momento della generazione di un nuovo sito.

informazioni

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

Invio delle misurazioni

Per inviare le misurazioni al SmartgridOne Controller, può essere utilizzato il seguente tema MQTT per la pubblicazione: standard1/outbound/scholt_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
    • Le modalità di funzionamento possibili sono off, on
  • active_power_W
    • Uguale alla potenza nominale mentre 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": <Grid Active Power in Watts>,
                "today_imported_energy_Wh": <Grid Imported Energy in Watt-hours>,
                "today_exported_energy_Wh": <Grid Exported Energy in Watt-hours>
            },
            "meter": {
                "active_power_W": <Grid Active Power in Watts>,
                "today_imported_energy_Wh": <Grid Imported Energy in Watt-hours>,
                "today_exported_energy_Wh": <Grid Exported Energy in Watt-hours>
            },
            "storage": {
                "energy_stored_Wh": <Energy Stored in Watt-hours>,
                "mean_soc_perc": <Mean State of Charge Percentage>,
                "active_power_W": <Active Power in Watts>,
                "today_charged_Wh": <Energy Charged on the Current Today in Watt-hours>,
                "today_discharged_Wh": <Energy Discharged on the Current Today in Watt-hours>
            },
            "solar": {
                "active_power_W": <Solar Active Power in Watts>,
                "today_energy_Wh": <Energy Produced Today in Watt-hours>
            },
            "heat_pump": {
                "active_power_W": <Heat Pump Active Power in Watts>,
                "operation_modes": <Heat Pump Operation Mode>
            }
        },
        "response_code": <Response Code>
    },
    "fields": {},
    "requestTime": "<Unix Timestamp>",
    "time": "<Unix Timestamp>",
    "siteNodeId": "<site_filter>"
}

Conferma delle misurazioni

Quando una misurazione è stata ricevuta con successo, una conferma sarà inviata sul seguente tema: standard1/rp_one_s/scholt_ack/<site_filter>/<Controller SN>

Questa conferma può essere utilizzata per:

1. Verificare che il messaggio di misurazione sia stato ricevuto correttamente.
2. Verificare che il messaggio di misurazione contenesse tutti i dati necessari.

Ricezione dei comandi

Per ricevere comandi dal SmartgridOne Controller, iscriversi al seguente tema MQTT: standard1/outbound/scholt_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