Connessione al Broker MQTT

Fare riferimento alla sezione seguente per scoprire come connettersi al Broker MQTT SmartgridOne: MQTT Broker Connection

Funzionalità VPP

Il VPP è progettato per ricevere un singolo setpoint/strategia per gruppo di dispositivi (ad esempio Solare, Accumulo) e aggregare il setpoint tra i controller connessi al VPP.

Mentre il Protocollo Live MQTT invierebbe un comando a un singolo controller, il VPP consente all'utente di inviare un comando a un gruppo di controller.

Aggiunta di Controller al VPP

Quando si aggiunge il Segnale MQTT SmartgridOne, viene mostrato un campo vpp/{MQTT Username}/{VPP ID}/warning. Inserire qui il VPP ID ricevuto.

Algoritmo di Aggregazione

I setpoint sono aggregati in base alla capacità dei dispositivi gestiti dai singoli controller.

Argomenti MQTT

Una volta completata la configurazione iniziale, verranno forniti un VPP ID e un Nome Utente MQTT (e password).

Argomento di Ricezione

Argomento: vpp/{MQTT Username}/{VPP ID}

Questo argomento è usato dall'utente per inviare un comando aggregato al VPP.

VPP Live

Corpo:

{
    "msg_id": <Incremental message id>(int),
    "vpp_id": <VPP ID>(str)
    "time": "<Unix Timestamp>(int)",
    "fields": {
        "<Component Policy>": "<Policy Type>",
        "<Component Power Setpoint>": <Setpoint in watts>
    }
}

Le politiche dei componenti e i setpoint si trovano qui: MQTT Components and Policies

VPP Programmato

Corpo:

{
    "msg_id": <Incremental message id>(int),
    "vpp_id": <VPP ID>(str)
    "time": "<Unix Timestamp>(int)",
    "message_type": "<Type of message>(str)",
    "fields": {
        "<Component Policy>": "<Policy Type>",
        "<Component Power Setpoint>": <Setpoint in watts>
    }
}

Le politiche dei componenti e i setpoint si trovano qui: MQTT Components and Policies

Argomento di Conferma

Argomento: vpp/{MQTT Username}/{VPP ID}/warning

Dopo l'invio di un comando, il VPP risponde con un riconoscimento, indicando se il comando è stato ricevuto con successo o meno.

Corpo:

{
    "payload": {
        "fields": {
            "responseCode": <Success/Failure Code>(int),
            "ack": <Acknowledgement Message>(str)
        },
        "target": <VPP ID>(str)
    },
    "message_type": <Type of Message>(str)
}

Argomento di Feedback

Argomento: vpp/{MQTT Username}/{VPP ID}/warning

L'argomento di feedback contiene la risposta restituita dai singoli controller.

Corpo:

{
    "payload": {
        "updated_on": <Unix Timestamp of the data>(str)
        "feedback_dict": {
            <Feedback Dict>(dict)
        },
        "target": <Site Node ID>(str)
    },
    "message_type": <Type of Message>(str)
}

La struttura del dizionario feedback può essere trovata qui: MQTT Feedback Payload Structure

Argomento di Feedback Aggregato

Argomento: vpp/{MQTT Username}/{VPP ID}/warning

Il VPP aggrega il feedback ricevuto da ciascun controller individuale.

Corpo:

{
    "payload": {
        "updated_on": <Unix Timestamp of the data>(str)
        "feedback_dict": {
            <Aggregated Feedback Dict>(dict)
        },
    },
    "message_type": <Type of Message>(str)
}

Il dizionario di feedback aggregato ha una struttura simile a quella della MQTT Feedback Payload Structure. Tuttavia, i valori stringa, come le strategie eseguite, non possono essere aggregati e pertanto non sono inclusi.

Argomento dei Comandi Inviati

Argomento: vpp/{MQTT Username}/{VPP ID}/warning

Quando i comandi sono inviati ai controller dal VPP, ciò viene riportato usando questo argomento.

Corpo:

{
    "payload": {
        "aggregated": {
            <Component Name>(str): <CommandPower Value>(float)...
        },
        "dispatched_commands": [
            <List of individual commands sent to the controllers>
        ],
    },
    "message_type": <Type of Message>(str)
}

La struttura del payload dei singoli comandi inviati può essere trovata qui: MQTT Feedback Payload Structure.

Argomento di Avviso

Argomento: vpp/{MQTT Username}/{VPP ID}/warning

Se si verifica un errore o un avviso nel VPP, un messaggio sarà inviato su questo argomento MQTT.

Corpo:

{
    "payload": {
        "fields": {
            <Field Dictionary>(dict)
        },
        "target": <VPP ID>(str)
    },
    "message_type": <Type of Message>(str)
}