Scholt MQTT Driver

Følgende integration kan bruges til at sende lokalitetsmålinger via MQTT og modtage kommandoer til de forskellige installerede enhedstyper.

Python demo script

Denne testkode udfører en simpel opgave med kontinuerligt at sende dummy-målinger til en installation og modtage kommandoer:

Download venligst filen nedenfor i din foretrukne Python IDE. Udfyld dit serienummer, lokalitetsfilter og MQTT-legitimationsoplysninger og kør scriptet:

Forudsætninger

Cloud Controller

Lokaliteterne vil blive styret via en Cloud Controller. Kontakt venligst EMS for at opsætte en ny Cloud Controller

Lokalitet Opsætning

Når en Cloud Controller er oprettet, vil den indeholde et unikt serienummer (standard1/rp_one_s/scholt_ack/<site_filter>/<Controller SN>).

Nye lokaliteter kan genereres på Cloud Controlleren ved brug af unikke lokalitetsfiltre standard1/outbound/scholt_cmd/<site_filter>/<Controller SN>/

Disse to variabler skal bruges i MQTT Topics og i Bodys.

Enhedsvalg

MQTT-legitimationsoplysninger

Sofar leverer MQTT-legitimationsoplysninger. MQTT-brugernavnet skal indtastes ved oprettelse af en ny lokalitet.

Afsendelse af målinger

For at sende målinger til Sofar EMS kan følgende MQTT-topic bruges til publicering: standard1/outbound/scholt_meas/<site_filter>/<Controller SN>/

Valgfrie felter er angivet med kursiv.

Følgende felter kan sendes pr. enhedstype:

• 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
    • Mulige driftsformer er off, on
  • active_power_W
    • Svarende til nominel effekt når varmepumpen er on

• Meters

  • active_power_W
  • today_imported_energy_Wh
  • today_exported_energy_Wh

Beskeden skal struktureres som følger:

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

Bekræftelse af måling

Når en måling er modtaget uden fejl, vil der blive sendt en bekræftelse på følgende topic: standard1/rp_one_s/scholt_ack/<site_filter>/<Controller SN>

Denne bekræftelse kan bruges til at:

1. Verificere at målingsbeskeden er modtaget korrekt.
2. Verificere at målingsbeskeden indeholdt alle nødvendige data.

Modtagelse af kommandoer

For at modtage kommandoer fra Sofar EMS, abonner på følgende MQTT topic: standard1/outbound/scholt_cmd/<site_filter>/<Controller SN>/

Svaret er struktureret som følger:

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

Listen over politikker, der kan modtages, findes her: List of Potential Policies