मुख्य कंटेंट तक स्किप करें

Eniris MQTT Driver

Authorization​

  1. Eniris will supply master MQTT credentials

Adding a Device​

Generate a Site​

Contact Eniris Regarding the Integration of a Whitelabeled Driver.

When generating a site, the devices connected to the site must be added.

This includes a battery group, PV group, grid meter and consumption meter.

The nominal power and capacities of these devices MUST be filled in when adding the installation site.

The filter of the site must be entered. This site filter is later used in the MQTT body to uniquely identify the site.

Sending measurements​

To send measurements to the SmartgridOne Controller, the following MQTT topic can be used for publishing: standard1/rp_one_s/<Whitelabel Name>_meas/<Controller SN>

Optional fields are mentioned in italics.

The following fields can be sent per device type:

  • Storage

    • mean_soc_perc
    • active_power_W
    • today_charged_Wh
    • today_discharged_Wh
    • energy_stored_Wh

  • Solar

    • active_power_W
    • today_energy_Wh

  • Heat Pumps

    • operation_modes
      • Possible operation modes are off, on
    • active_power_W
      • Equals nominal power while heat pump is on

  • Meters

    • active_power_W
    • today_imported_energy_Wh
    • today_exported_energy_Wh

The message must be structured as follows:

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

Measurement Acknowledgement​

When a measurement has been successfully received, an acknowledgement will be sent on the following topic: standard1/rp_one_s/<Whitelabel Name>_ack/<Controller SN>

This acknowledgement can be used to:

  1. Verify that the measurement message was received successfully.
  2. Verify that the measurement message contained all necessary data.

Receiving commands​

To receive commands from the SmartgridOne Controller, subscribe to the following MQTT topic: standard1/rp_one_s/<Whitelabel Name>_cmd/<Controller SN>

The response is structured as follows:

{
    "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,
        "heat_pump_policy": "<policy>",
    }
}

The list of policies than can be received is found here: List of Potential Policies

Possible Heat Pump policies are: heating_boost, heating_block, heating_self_control