FEMS App Lese-/Schreibzugriff für Heim-, Gewerbe- und Industriespeicher

1. Einleitung

Sehr geehrte Kundin, sehr geehrter Kunde,

vielen Dank, dass Sie sich für die »FEMS App Lese-/Schreibzugriff für Heim-, Gewerbe- und Industriespeicher« entschieden haben. Gerne können Sie uns Ihre Anregungen mitteilen, damit wir die Qualität unserer Produkte noch weiter verbessern können.

2. Installation der App

Mit der Bestellung der »FEMS App Lese-/Schreibzugriff für Heim-, Gewerbe- und Industriespeicher« haben Sie einen 16-stelligen Lizenzschlüssel erhalten. Mittels diesem Lizenzschlüssel können Sie die App eigenständig im FEMS App Center einlösen.

Eine Anleitung zur Vorgehensweise finden Sie hier.

Die Schnittstelle für den Lesezugriff ist bereits ab Werk inklusive und vorinstalliert.

3. Modbus/TCP - Lese-/Schreibzugriff

Diese Anleitung dient der Beschreibung des Lese-/Schreibzugriffs auf ein FENECON Stromspeichersystem mittels Modbus/TCP API. Zunächst werden Grundlagen zum Protokoll beschrieben. Anschließend wird die Funktionsweise der Schnittstelle erklärt.

3.1. Voraussetzungen

Das auf das Stromspeichersystem zugreifende Gerät (z.B. Notebook/PC) muss direkten Zugriff auf die IP-Adresse des FEMS haben - also z. B. im gleichen physischen Netzwerk angeschlossen sein.

3.2. Grundlagen Modbus/TCP

Das Modbus-Protokoll ist ein Kommunikationsprotokoll, das auf einer Client/Server-Architektur basiert. Es wurde 1979 von Gould-Modicon für die Kommunikation mit seinen speicherprogrammierbaren Steuerungen ins Leben gerufen. In der Industrie hat sich der Modbus zu einem De-facto-Standard entwickelt, da es sich um ein offenes Protokoll handelt. Seit 2007 ist die Version Modbus TCP Teil der Norm IEC 61158.

Wikipedia: Modbus/TCP

Mittels Modbus können ein Client (z. B. ein PC/EMS) und mehrere Server (z. B. Mess- und Regelsysteme, Batteriespeicher, PV-Anlage, Ladestation E-Auto) verbunden werden. Es gibt zwei Versionen: Eine für die serielle Schnittstelle (EIA-232 und EIA-485) und eine für Ethernet. In dieser Anleitung wird die Version für Ethernet beschrieben. Hierbei werden TCP/IP-Pakete verwendet, um die Daten zu übermitteln.

Lese- und Schreibzugriffe sind auf folgende Objekttypen möglich:

Objekttyp

Zugriff

Größe

Funktionscode

Einzelner Ein-/Ausgang „Coil“

Lesen & Schreiben

1-bit

01 / 05 / 15

Einzelner Eingang „Discrete Input“

nur Lesen

1-bit

(analoge) Eingänge „Input Register“

nur Lesen

16-bits

(analoge) Ein-/Ausgänge „Holding Register“

Lesen & Schreiben

16-bits

03 / 06 / 16

3.3. Lesezugriff

Diese App ist im Standard-Lieferumfang enthalten.

Die Modbus-Schnittstelle ist folgendermaßen konfiguriert:

Tabelle 1. Parameter für Lesezugriff
Geräteadresse	IP-Adresse des EMS (z.B. 192.168.0.20)
Port	502
Unit-ID	1
Function-Codes	03 (Read Holding Registers)
	04 (Read Input Registers)

Die Schnittstelle ermöglicht standardmäßig Zugriff auf die Kanäle der Komponente _sum. Der Zugriff auf weitere Komponenten wird projektspezifisch freigegeben - um z. B. ansteuerbare Stromspeichersysteme oder Ladesäulen über die Schnittstelle freizugeben.

3.4. Modbus-Tabelle

Die individuelle Modbus-Tabelle für Ihr System können Sie bequem über das Online-Monitoring als Excel-Datei wie folgt herunterladen:

Abbildung 1. Reiter links oben im Online-Monitoring öffnen

Abbildung 2. Reiter "Einstellungen" öffnen

Abbildung 3. Anlagenprofil öffnen

Abbildung 4. ctrlApiModbusTcp öffnen und auf "Download Protocol" klicken

Die wichtigsten Datenpunkte finden Sie auch hier in der Schnellübersicht:

Address (Adresse)

Name (Name)

Type (Typ)

Value/Description (Wert/Beschreibung)

Unit (Einheit)

Access (Zugang)

Header

Hash of "OpenEMS"

uint16

0x6201

Length of block "_meta"

uint16

199

OpenEMS Version Major

uint16

2020

OpenEMS Version Minor

uint16

OpenEMS Version Patch

uint16

Manufacturer

string16

FENECON GmbH

Manufacturer Model

string16

OpenEMS

Manufacturer Options

string16

Manufacturer Version

string16

Manufacturer Serial Number

string16

Manufacturer EMS Serial Number

string16

Sum

200

Component-ID

string16

_sum

216

Length of block "_sum"

uint16

300

220

Hash of "OpenemsComponent"

uint16

0xb3dc

221

Length of block "OpenemsComponent"

uint16

222

_sum/State

enum16

0:Ok, 1:Info, 2:Warning, 3:Fault

300

Hash of "Sum"

uint16

0x462b

301

Length of block "Sum"

uint16

220

302

_sum/EssSoc

uint16

Percent [%]

303

_sum/EssActivePower

float32

AC-side power of Energy Storage System. Includes excess DC-PV production for hybrid inverters. Negative values for charge; positive for discharge

Watt [W]

305

Reserved

float32

307

Reserved

float32

309

_sum/EssReactivePower

float32

VoltAmpereReactive [var]

311

Reserved

float32

313

Reserved

float32

315

_sum/GridActivePower

float32

Grid exchange power. Negative values for sell-to-grid; positive for buy-from-grid

Watt [W]

317

_sum/GridMinActivePower

float32

Watt [W]

319

_sum/GridMaxActivePower

float32

Watt [W]

321

Reserved

float32

323

Reserved

float32

325

Reserved

float32

327

_sum/ProductionActivePower

float32

Total production; always positive

Watt [W]

329

_sum/ProductionMaxActivePower

float32

Watt [W]

331

_sum/ProductionAcActivePower

float32

Production from AC source

Watt [W]

333

_sum/ProductionMaxAcActivePower

float32

Watt [W]

335

Reserved

float32

337

Reserved

float32

339

_sum/ProductionDcActualPower

float32

Production from DC source

Watt [W]

341

_sum/ProductionMaxDcActualPower

float32

Watt [W]

343

_sum/ConsumptionActivePower

float32

Watt [W]

345

_sum/ConsumptionMaxActivePower

float32

Watt [W]

347

Reserved

float32

349

Reserved

float32

351

_sum/EssActiveChargeEnergy

float64

WattHours [Wh]

355

_sum/EssActiveDischargeEnergy

float64

WattHours [Wh]

359

_sum/GridBuyActiveEnergy

float64

WattHours [Wh]

363

_sum/GridSellActiveEnergy

float64

WattHours [Wh]

367

_sum/ProductionActiveEnergy

float64

WattHours [Wh]

371

_sum/ProductionAcActiveEnergy

float64

WattHours [Wh]

375

_sum/ProductionDcActiveEnergy

float64

WattHours [Wh]

379

_sum/ConsumptionActiveEnergy

float64

WattHours [Wh]

383

_sum/EssDcChargeEnergy

float64

WattHours [Wh]

387

_sum/EssDcDischargeEnergy

float64

WattHours [Wh]

391

_sum/EssActivePowerL1

float32

AC-side power of Energy Storage System on phase L1. Includes excess DC-PV production for hybrid inverters. Negative values for charge; positive for discharge

Watt [W]

393

_sum/EssActivePowerL2

float32

AC-side power of Energy Storage System on phase L2. Includes excess DC-PV production for hybrid inverters. Negative values for charge; positive for discharge

Watt [W]

395

_sum/EssActivePowerL3

float32

AC-side power of Energy Storage System on phase L3. Includes excess DC-PV production for hybrid inverters. Negative values for charge; positive for discharge

Watt [W]

397

_sum/GridActivePowerL1

float32

Grid exchange power on phase L1. Negative values for sell-to-grid; positive for buy-from-grid

Watt [W]

399

_sum/GridActivePowerL2

float32

Grid exchange power on phase L2. Negative values for sell-to-grid; positive for buy-from-grid

Watt [W]

401

_sum/GridActivePowerL3

float32

Grid exchange power on phase L3. Negative values for sell-to-grid; positive for buy-from-grid

Watt [W]

403

_sum/ProductionAcActivePowerL1

float32

Production from AC source on phase L1

Watt [W]

405

_sum/ProductionAcActivePowerL2

float32

Production from AC source on phase L2

Watt [W]

407

_sum/ProductionAcActivePowerL3

float32

Production from AC source on phase L3

Watt [W]

409

_sum/ConsumptionActivePowerL1

float32

Watt [W]

411

_sum/ConsumptionActivePowerL2

float32

Watt [W]

413

_sum/ConsumptionActivePowerL3

float32

Watt [W]

415

_sum/EssDischargePower

float32

Actual AC-side battery discharge power of Energy Storage System. Negative values for charge; positive for discharge

Watt [W]

417

_sum/GridMode

enum16

1:On-Grid, 2:Off-Grid

ess0

500

Component-ID

string16

ess0

516

Length of block "ess0"

uint16

580

520

Hash of "OpenemsComponent"

uint16

0xb3dc

521

Length of block "OpenemsComponent"

uint16

522

ess0/State

enum16

0:Ok, 1:Info, 2:Warning, 3:Fault

600

Hash of "SymmetricEss"

uint16

0x42ee

601

Length of block "SymmetricEss"

uint16

100

602

ess0/Soc

uint16

Percent [%]

603

ess0/GridMode

enum16

1:On-Grid, 2:Off-Grid

604

ess0/ActivePower

float32

Watt [W]

700

Hash of "ManagedSymmetricEss"

uint16

0xa3ed

701

Length of block "ManagedSymmetricEss"

uint16

100

702

ess0/AllowedChargePower

float32

Watt [W]

704

ess0/AllowedDischargePower

float32

Watt [W]

706

ess0/SetActivePowerEquals

float32

Watt [W]

708

ess0/SetReactivePowerEquals

float32

VoltAmpereReactive [var]

710

ess0/SetActivePowerLessOrEquals

float32

Watt [W]

712

ess0/SetReactivePowerLessOrEquals

float32

VoltAmpere [VA]

714

ess0/SetActivePowerGreaterOrEquals

float32

Watt [W]

716

ess0/SetReactivePowerGreaterOrEquals

float32

Watt [W]

800

Hash of "EssSymmetric"

uint16

0x1352

801

Length of block "EssSymmetric"

uint16

300

3.5. Beispiel 1: Lesezugriff Batterieladezustand mit QModMaster

Im Folgenden soll der Lesezugriff auf den Ladezustand (SoC) der Batterie mittels des kostenlosen Tools QModMaster exemplarisch gezeigt werden.

Das Tool kann unter folgendem Link heruntergeladen werden:
Online: https://sourceforge.net/projects/qmodmaster/

Der Wert des Ladezustands ist wie folgt hinterlegt (s. oben):

Tabelle 2. Registeradresse für den Ladezustand der Batterie
Address	Name	Type	Value/Description	Unit	Access
302	_sum/EssSoc	uint16		Percent [%]	RO

Standardmäßig wird in QModbusMaster die Base Address auf 1 gesetzt. Dieser Wert ist auf 0 zu ändern. Anderenfalls sind die Registeradressen aus dem Anlagenprofil um 1 verschoben.

Abbildung 5. Einstellungen

Unter Modbus TCP Settings müssen Slave IP und TCP Port richtig konfiguriert sein.

Abbildung 6. Modbus TCP Einstellungen

Da es sich um einen unit16 handelt, muss ein 16-bit Wort, also ein Register, ausgelesen werden. Nach Setzen der Werte auf den Menüpunkt "Read/Write" klicken. Der gelesene Wert erscheint unten.

Abbildung 7. Wert lesen

Der Abgleich mit dem Online-Monitoring bestätigt die Korrektheit des gelesenen Wertes.

Abbildung 8. Vergleich mit Online-Monitoring

Die Durchführung anderer Leseoperationen erfolgt analog.

3.6. Schreibzugriff

Diese App ist nicht im Standard-Lieferumfang enthalten. Sie kann jedoch nachträglich jederzeit nachgerüstet werden.

Die Modbus-Schnittstelle ist folgendermaßen konfiguriert:

Tabelle 3. Parameter für Schreibzugriff
Geräteadresse	IP-Adresse des EMS (z.B. 192.168.0.20)
Port	502
Unit-ID	1
Function-Codes	03 (Read Holding Registers)
	04 (Read Input Registers)
	06 (Write Single Holding Register)
	16 (Write Multiple Holding Registers)

3.7. Beispiel 2: Schreibzugriff auf EssActivePower mit QModMaster

Im Folgenden soll der Schreibzugriff für das Setzen der EssActivePower mittels des kostenlosen Tools QModMaster exemplarisch gezeigt werden. Hierdurch kann die Funktion des Controller Fix Active Power Symmetric simuliert werden.

Der Wert ist wie folgt hinterlegt (s. oben):

Tabelle 4. Registeradresse für das Setzen der *EssActivePower* des Speichers
Address	Name	Type	Value/Description	Unit	Access
706	ess0/SetActivePowerEquals	float32		Watt [W]	WO

Zusätzlich zur Überprüfung der Base Address auf 0 muss sichergestellt werden, dass unter Endian die Einstellung Big ausgewählt ist.

Abbildung 9. Einstellungen

Da es sich um einen float32 handelt, müssen zwei 16-bit Wörter, also zwei Register, geschrieben werden. In diesem Beispiel soll der Speicher mit 4000 (4E+03) Watt entladen werden. Der Wert kann direkt als Dezimalzahl in das Register eingegeben werden, wobei das Data Format Float zu wählen ist. Nach Setzen des Wertes auf den Menüpunkt "Read/Write" klicken, um die Schreiboperation durchzuführen.

Abbildung 10. Wert schreiben

Der Abgleich mit dem Online-Monitoring bestätigt die Korrektheit des geschriebenen Wertes.

Abbildung 11. Vergleich mit Online-Monitoring

Die Schreiboperation wird nur für die Dauer des Api-Timeout durchgeführt. Diese beträgt in der Standardkonfiguration 60 Sekunden, kann aber durch den Service angepasst werden.

Die Durchführung anderer Schreiboperationen erfolgt analog.

4. REST/JSON - Lese-/Schreibzugriff

Diese Anleitung dient der Beschreibung des Lese-/Schreibzugriffs auf ein FENECON Stromspeichersystem mittels REST/JSON API. Anschließend wird die Funktionsweise der Schnittstelle erklärt.

4.1. Voraussetzungen

Das auf das Stromspeichersystem zugreifende Gerät (z.B. Notebook/PC) muss direkten Zugriff auf die IP-Adresse des FEMS haben - also z. B. im gleichen physischen Netzwerk angeschlossen sein.

4.2. Grundlagen REST/JSON

Die REST/JSON Schnittstelle ermöglicht den Zugriff auf das FEMS im lokalen Netzwerk über eine an REST angelehnte Schnittstelle.

4.3. Lesezugriff

Diese App stellt eine an REST angelehnte Schnittstelle zur Verfügung, mit der Datenpunkte im System ausgelesen werden können.

Diese App ist im Standard-Lieferumfang des FEMS enthalten.

Die Basis-Adresse für die REST-Zugriffe lautet http://<BENUTZER>:<PASSWORT>@<IP>:80/rest

http ist das Protokoll
<BENUTZER> ist der Benutzername. Da die Authentifizierung lediglich über das Passwort erfolgt, kann hier ein beliebiger Wert (z. B. "x") angegeben werden
<PASSWORT> ist das Passwort des Benutzers. Der Standard "Gast"-Benutzer im FEMS hat das Passwort "user"
<IP> ist die IP-Adresse des FEMS
80 ist der Port für die REST/JSON-Api (optional)

Wenn Ihr FEMS also die lokale IP-Adresse '192.168.0.23' hat, lautet die Basis-Adresse für REST-Zugriffe http://x:user@192.168.0.23:80/rest

Aus Sicherheitsgründen werden Simple Authentication Requests nicht unterstützt, da bei dieser Variante Passwörter über die URL übertragen werden. Für REST Calls muss explizit Header Authentication verwendet werden. Eine Abfrage direkt über den Browser (ohne Erweiterung) ist folglich nicht möglich. In diesem Fall erscheint eine Fehlermeldung, vgl. Abbildung Fehlermeldung bei Simple Authentication Requests. Für eine Abfrage im Browser, nutzen Sie bitte die Erweiterung Talend API Tester wie hier beschrieben.

Abbildung 12. Fehlermeldung bei Simple Authentication Requests

4.3.1. /channel Endpunkt

Der /channel Endpunkt ermöglicht den Zugriff auf einzelne Datenpunkte, sogenannte "Channels", im System.

Die vollständige Adresse des Endpunkts lautet:

http://x:<PASSWORT>@<IP>:80/rest/channel/<KOMPONENTE>/<KANAL>

<KOMPONENTE> ist die ID der Komponente
<KANAL> ist die ID des Kanals

4.3.2. Datenpunkte

Die folgenden Datenpunkte können ausgelesen werden:

Datenpunkt

Beschreibung

Einheit

_sum/State

Zustand des Systems (0: Ok, 1:Info, 2:Warning, 3:Fault)

_sum/EssSoc

Ladezustand des Speichers

Prozent [%]

_sum/EssActivePower

Wirkleistung des Speichers

Watt [W]

_sum/GridActivePower

Wirkleistung am Netzanschlusspunkt

Watt [W]

_sum/ProductionActivePower

Wirkleistung Erzeuger

Watt [W]

_sum/ProductionAcActivePower

Wirkleistung AC Erzeuger

Watt [W]

_sum/ProductionDcActualPower

Wirkleistung DC Erzeuger

Watt [W]

_sum/ConsumptionActivePower

Wirkleistung Verbraucher

Watt [W]

_sum/EssActiveChargeEnergy

Energie Speicherbeladung

WattHours [Wh]

_sum/EssActiveDischargeEnergy

Energie Speicherentladung

WattHours [Wh]

_sum/GridBuyActiveEnergy

Energie Netzbezug

WattHours [Wh]

_sum/GridSellActiveEnergy

Energie Netzeinspeisung

WattHours [Wh]

_sum/ProductionActiveEnergy

Energie Erzeugung

WattHours [Wh]

_sum/ProductionAcActiveEnergy

Energie AC Erzeugung

WattHours [Wh]

_sum/ProductionDcActiveEnergy

Energie DC Erzeugung

WattHours [Wh]

_sum/ConsumptionActiveEnergy

Energie Verbraucher

WattHours [Wh]

_sum/EssActivePowerL1

Wirkleistung Phase 1 Speicher

Watt [W]

_sum/EssActivePowerL2

Wirkleistung Phase 2 Speicher

Watt [W]

_sum/EssActivePowerL3

Wirkleistung Phase 3 Speicher

Watt [W]

_sum/GridActivePowerL1

Wirkleistung Phase 1 Netz

Watt [W]

_sum/GridActivePowerL2

Wirkleistung Phase 2 Netz

Watt [W]

_sum/GridActivePowerL3

Wirkleistung Phase 3 Netz

Watt [W]

_sum/ProductionAcActivePowerL1

Wirkleistung Phase 1 Erzeuger

Watt [W]

_sum/ProductionAcActivePowerL2

Wirkleistung Phase 2 Erzeuger

Watt [W]

_sum/ProductionAcActivePowerL3

Wirkleistung Phase 3 Erzeuger

Watt [W]

_sum/ConsumptionActivePowerL1

Wirkleistung Phase 1 Verbraucher

Watt [W]

_sum/ConsumptionActivePowerL2

Wirkleistung Phase 2 Verbraucher

Watt [W]

_sum/ConsumptionActivePowerL3

Wirkleistung Phase 3 Verbraucher

Watt [W]

4.3.3. Beispiel 1 - Abfrage des Ladezustands: cURL

Das Kommandozeilen-Programm cURL ist sowohl unter Windows und Linux vorinstalliert.

Um den Ladezustand des Stromspeichers auszulesen, senden Sie einen GET-Request an die Adresse: http://x:user@192.168.0.23:80/rest/channel/_sum/EssSoc

Sie erhalten eine Antwort im JSON-Format:

Windows

Der folgende Befehl speichert die Antwort im JSON-Format in die Datei out.json

>curl -o out.json http://x:user@192.168.0.23:80/rest/channel/_sum/EssSoc

Um den Inhalt der Datei auszugeben, nutzen Sie:

>type out.json

Ausgabe:

{"address":"_sum/EssSoc","type":"INTEGER","accessMode":"RO","text":"","unit":"%","value":99}

Den Wert des Ladezustands finden Sie unter value. Im Beispiel oben beträgt er 99 %.

Linux

Der folgende Befehl speichert die Antwort im JSON-Format in die Datei out.json

$curl -o out.json http://x:user@192.168.0.23:80/rest/channel/_sum/EssSoc

Um den Inhalt der Datei auszugeben, nutzen Sie:

>cat out.json

Ausgabe:

{"address":"_sum/EssSoc","type":"INTEGER","accessMode":"RO","text":"","unit":"%","value":99}

Den Wert des Ladezustands finden Sie unter value. Im Beispiel oben beträgt er 99 %.

4.3.4. Beispiel 2 - Abfrage des Ladezustands: Python

Python Versionen für Windows und Linux erhalten Sie hier: https://www.python.org/downloads/

Um den Ladezustand des Stromspeichers auszulesen, muss ebenfalls ein GET-Request an die Adresse:
http://x:user@192.168.0.23:80/rest/channel/_sum/EssSoc gesendet werden.

Hierfür kann die requests Bibliothek genutzt werden, die zu Beginn importiert werden muss:

import requests

url == 'http://192.168.0.23:80/rest/channel/_sum/EssSoc'

user == 'x'
password == 'user'

session == requests.Session()
session.auth == (user, password)

response == session.get(url)
response.raise_for_status()

Der Befehl liefert eine Antwort im JSON-Format. Diese kann mit dem folgenden Befehl ausgegeben werden:

print(response.text)

Ausgabe:

{"address":"_sum/EssSoc","type":"INTEGER","accessMode":"RO","text":"","unit":"%","value":99}

Den Wert des Ladezustands finden Sie unter value. Im Beispiel oben beträgt er 99 %.

4.3.5. Beispiel 3 - Abfrage des Ladezustands: Talend API Tester

Talend API Tester ist eine Erweiterung für Google Chrome, die es ermöglicht, REST APIs zu testen.

Zunächst muss ein Authorization Header hinzugefügt werden:

Talend API Tester Authentication

Anschließend kann der GET-Request ausgeführt werden.

Den Wert des Ladezustands finden Sie unter value. Im Beispiel oben beträgt er 99 %.

4.4. Schreibzugriff

Diese App stellt eine an REST angelehnte Schnittstelle zur Verfügung, mit der Datenpunkte im System beschrieben werden können.

Diese App ist nicht im Standard-Lieferumfang des FEMS enthalten. Sie kann jedoch nachträglich jederzeit nachgerüstet werden. Kontaktieren Sie uns hierfür!

Die Verwendung des Schreibzugriffs ist nicht über den Gast-Zugang möglich. Stattdessen ist ein gesonderter Kundenzugang notwendig. Hierfür ist das Passwort "owner" zu verwenden. Der Nutzername kann wie beim Lesezugriff beliebig gewählt werden.

Sämtliche Schreibzugriffe müssen als POST-Requests gesendet werden.

4.4.1. Timeout

Diese App verfügt über einen konfigurierbaren Timeout. Im Standard ist dieser auf 60 Sekunden konfiguriert. Er sorgt dafür, dass ein Vorgabewert 60 Sekunden lang aktiv bleibt. Sobald ein neuer Vorgabewert geschrieben wird, wird der neue Wert verwendet. Erfolgt kein neuer Vorgabewert innerhalb von 60 Sekunden, fällt die Steuerung auf den nachrangig priorisierten Controller zurück - z. B. Vorgabe einer "0"-Leistung oder Eigenverbrauchsoptimierung.

4.4.2. /channel Endpunkt

Über den Endpunkt /channel wird der Zugriff auf einzelne Datenpunkte, sogenannte "Channels", im System ermöglicht.

Die vollständige Adresse des Endpunkts lautet:

http://x:<PASSWORT>@<IP>:80/rest/channel/<KOMPONENTE>/<KANAL>

<KOMPONENTE> ist die ID der Komponente.
<KANAL> ist die ID des Kanals

4.4.3. Datenpunkte

Die folgenden Datenpunkte können beschrieben werden:

Datenpunkt

Beschreibung

Einheit

ess0/SetActivePowerEquals

Wirkleistungsvorgabe

Watt [W]

ess0/SetReactivePowerEquals

Blindleistungsvorgabe

VoltAmpereReactive [VAR]

ess0/SetActivePowerLessOrEquals

(Maximale) Wirkleistungsvorgabe

Watt [W]

ess0/SetReactivePowerLessOrEquals

(Maximale) Blindleistungsvorgabe

VoltAmpereReactive [VAR]

ess0/SetActivePowerGreaterOrEquals

(Minimale) Wirkleistungsvorgabe

Watt [W]

ess0/SetReactivePowerGreaterOrEquals

(Minimale) Wirkleistungsvorgabe

VoltAmpereReactive [VAR]

Mehr Informationen zum Channel SetActivePowerEquals und anderen Channels zur Leistungsvorgabe finden Sie im Glossar

4.4.4. Beispiel 1 - Wirkleistungsvorgabe: Python

Um z. B. dem ersten Stromspeichersystem (bzw. Stromspeicher-Cluster) eine Entladeleistung von 5 kW vorzugeben, senden Sie einen POST-Request an die Adresse http://192.168.0.23:80/rest/channel/ess0/SetActivePowerEquals mit der Leistungsvorgabe im JSON Format

{
  "value": 5000
}

Eine Entladung des Speichers wird durch einen positiven, eine Beladung durch einen negativen Wert umgesetzt.

Hierfür kann die requests Bibliothek genutzt werden, die zu Beginn importiert werden muss:

import requests

url == 'http://192.168.0.23:80/rest/channel/ess0/SetActivePowerEquals'

user == 'x'
password == 'owner'

session == requests.Session()
session.auth == (user, password)

data == {"value": 5000}

response == session.post(url, json == data)
response.raise_for_status()

Die korrekte Durchführung des Requests kann über einen anschließenden GET-Request oder das Online-Monitoring (s. unten) überprüft werden.

4.4.5. Beispiel 2 - Wirkleistungsvorgabe: Talend API Tester

Talend API Tester ist eine Erweiterung für Google Chrome, die es ermöglicht, REST APIs zu testen.

Zunächst muss ein Authorization Header hinzugefügt werden:

Anschließend kann der POST-Request ausgeführt werden.

Die korrekte Durchführung des requests kann über einen anschließenden GET-Request oder das Online-Monitoring (s. unten) überprüft werden.