Connessione al Broker MQTT

Si prega di fare riferimento alla sezione seguente per scoprire come connettersi al Broker MQTT SmartgridOne: MQTT Broker Connection

Funzionalità VPP

Il VPP è progettato per ricevere un setpoint/strategia per gruppo di dispositivi (ad esempio Solare, Accumulo), e aggregare il setpoint tra i controller collegati 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 standard1/outbound/remoteVppMetrics/warning/{MQTT Username}/{VPP ID}. Inserire qui il VPP ID ricevuto.

Algoritmo di Aggregazione

I setpoint sono aggregati in base alla capacità dei dispositivi ricompresi nei singoli controller.

Argomenti MQTT

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

Argomento in ingresso

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

Topic (deprecato): vpp/{MQTT Username}/{VPP ID}

Questo argomento viene utilizzato dall'utente per inviare un comando aggregato al VPP.

VPP Live

Body:

{
    "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 policy e i setpoint dei componenti possono essere trovate qui: MQTT Components and Policies

VPP Programmato

Body:

{
    "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 policy e i setpoint dei componenti possono essere trovate qui: MQTT Components and Policies

Argomento di Conferma

Topic: standard1/outbound/remoteVppMetrics/warning/{MQTT Username}/{VPP ID}

Topic (deprecato): vpp/{MQTT Username}/{VPP ID}/warning

Dopo che un comando è stato inviato, il VPP risponderà con una conferma, indicando se il comando è stato ricevuto con successo o meno.

Body:

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

Argomento di Feedback

Topic: standard1/outbound/remoteVppMetrics/warning/{MQTT Username}/{VPP ID}

Topic (deprecato): vpp/{MQTT Username}/{VPP ID}/warning

L'argomento Feedback contiene il feedback restituito dai singoli controller.

Body:

{
    "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

Topic: standard1/outbound/remoteVppMetrics/warning/{MQTT Username}/{VPP ID}

Topic (deprecato): vpp/{MQTT Username}/{VPP ID}/warning

Il VPP aggrega il feedback ricevuto da ogni singolo controller.

Body:

{
    "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 di MQTT Feedback Payload Structure. Tuttavia, valori stringa, come strategie eseguite, non possono essere aggregati e quindi non sono inclusi.

Argomento Comandi Inviati

Topic: standard1/outbound/remoteVppMetrics/warning/{MQTT Username}/{VPP ID}

Topic (deprecato): vpp/{MQTT Username}/{VPP ID}/warning

Quando comandi vengono inviati ai controller dal VPP, ciò viene segnalato tramite questo argomento.

Body:

{
    "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

Topic: standard1/outbound/remoteVppMetrics/warning/{MQTT Username}/{VPP ID}

Topic (deprecato): vpp/{MQTT Username}/{VPP ID}/warning

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

Body:

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