Einbindung 3rd party Messung zu eFriends Cube – eFriends Energy GmbH

eFriends Watch+/Cube muss per DHCP eine IP Adresse im lokalen Netzwerk zugewiesen bekommen, die am DHCP Server fixiert wird
Erreichbarkeit der Messeinheit zur eFriends Watch+/Cube muss kundenseitig gegeben sein (gleiches Subnet, Routing möglich, etc.)
Ein API Key zur Integration (pro Cube spezifisch) wurde in der App unter API Manager vergeben.

Technische Umsetzung

Messeinheit schickt im 5 Sekunden Takt die momentanen Leistungswerte an die eFriends Watch+/Cube per HTTP POST Request.

Request Type: POST

HTTP-Header:

object

{11}

 
power1Watt

:
-1000

 
power2Watt

:
-234

 
power3Watt

:
-0.5

 
powerTotal

:
-1234.5

 
current1Ampere

:
4.342

 
current2Ampere

:
1

 
current3Ampere

:
0.002

 
voltage1Volt

:
231.1

 
voltage2Volt

:
234.2

 
voltage3Volt

:
230.1

 
dataSource

:
Third-party Meter Type and Integrator

Feld	Beschreibung	Beispiel
power1Watt, power2Watt, power3Watt	Aktueller Leistungswert in Watt; Datenformat: float, Komma = Punkt Vorzeichen: Einspeisung = positiver Wert, Bezug (Verbrauch) = negativer Wert	-1000 ... bedeutet: 1000 Watt Verbrauch 500 ... bedeutet: 500 Watt Überschuss
powerTotal	Summe der Leistungswerte über die 3 Phasen (d.h. power1Watt + power2Watt + power3Watt) in Watt; Datenformat: float, Komma = Punkt Vorzeichen: Einspeisung = positiver Wert, Bezug (Verbrauch) = negativer Wert	-1234.5 ... bedeutet: 1234.5Watt Verbrauch 1234.5 ... bedeutet: 1234.5 Watt Überschuss
current1Ampere, current2Ampere, current3Ampere	Aktueller Strommessungswert in Ampere; Datenformat: float, Komma = Punkt Vorzeichen: immer positiv	4.342 ... bedeutet: 4.342 Ampere
voltage1Volt, voltage2Volt, voltage3Volt	Aktueller Spannungsmessungswert in Volt; Datenformat: float, Komma = Punkt Vorzeichen: immer positiv	231.1 ... bedeutet: 231.1 Volt
dataSource	frei vergebbare Bezeichnung der Messeinheit mit Info zum Integrator Notwendig, damit festgehalten wird, wer für den Messwert verantwortlich ist	z.B. "Loxone by Fa. XYZ" oder "SmartFox by Fa. ABC"

curl --location --request POST 'http://192.168.1.101/v3/MeterDataAPI/MeterData' \

--header 'apiKey: 0d8a7fb3-8675-489c-8cfc-96b4e4bd67a2' \

--header 'Content-Type: application/json' \

--data-raw '{

"powerTotal": -1234.500,

"power1Watt": -1000,

"power2Watt": -234,

"power3Watt": -0.5,

"current1Ampere": 4.342,

"current2Ampere": 1,

"current3Ampere": 0.002,

"voltage1Volt": 231.1,

"voltage2Volt": 234.2,

"voltage3Volt": 230.1,

"dataSource": "Loxone Meter by IntegratorXYZ"

}'

Im Gutfall kommt als Response HTTP 200, sowie eine JSON Antwort retour:

 
object

{1}

 
bSuccess

:
true