# History

- WIP

# URL for reading the datalogger

URL: http://[IP-or-Hostnam]/data/
returns the last x entries from the datalogger

# optional parameters

Parameter "last": how many records should be read, records are ordered desending

parameter "from" and "to": define the start and end records, both parameters must be provided
if "from" is higher than "to" the records will be ordered descending

# examples

retrieve the last records, maximum is defined by the meter

```code
curl http://10.10.10.10/data/
```

response:

Timestamp;Index;Serial;Active Energy Import L123 T1 [Wh];Active Energy Import L123 T2 [Wh];Active Energy Export L123 T1 [Wh];Active Energy Export L123 T2 [Wh];Reactive Energy Import L123 T1 [varh];Reactive Energy Import L123 T2 [varh];Reactive Energy Export L123 T1 [varh];Reactive Energy Export L123 T2 [varh];Active Power L123 [W];Active Power L1 [W];Active Power L2 [W];Active Power L3 [W];Current L123 [mA];Current L1 [mA];Current L2 [mA];Current L3 [mA];Current N [mA];Voltage L1-N [1/10 V];Voltage L2-N [1/10 V];Voltage L3-N [1/10 V];Powerfactor L1 [1/100];Powerfactor L2 [1/100];Powerfactor L3 [1/100];Frequency [1/10 Hz]
2021-04-16T08:45:00Z;2315;0;1731762;0;1602;0;434142;0;40851;0;1214;821;397;-5;9534;5456;2924;1154;608;2326;2319;2304;99;99;-100;500
2021-04-16T08:30:00Z;2314;0;1730961;0;1602;0;434142;0;40851;0;1225;827;399;-1;9221;5678;2380;1161;607;2338;2331;2316;99;99;-45;500
2021-04-16T08:15:00Z;2313;0;1730961;0;1602;0;434142;0;40851;0;1230;839;392;0;9074;5560;2351;1162;585;2306;2300;2284;99;99;-66;500
2021-04-16T08:00:00Z;2312;0;1730160;0;1602;0;434142;0;40851;0;1193;803;396;-5;8833;5301;2369;1162;591;2320;2313;2298;99;99;-88;499

retrieve the first 10 records

```code
curl http://10.10.10.10/data/?from=1&to=10
```

response:

Timestamp;Index;Serial;Active Energy Import L123 T1 [Wh];Active Energy Import L123 T2 [Wh];Active Energy Export L123 T1 [Wh];Active Energy Export L123 T2 [Wh];Reactive Energy Import L123 T1 [varh];Reactive Energy Import L123 T2 [varh];Reactive Energy Export L123 T1 [varh];Reactive Energy Export L123 T2 [varh];Active Power L123 [W];Active Power L1 [W];Active Power L2 [W];Active Power L3 [W];Current L123 [mA];Current L1 [mA];Current L2 [mA];Current L3 [mA];Current N [mA];Voltage L1-N [1/10 V];Voltage L2-N [1/10 V];Voltage L3-N [1/10 V];Powerfactor L1 [1/100];Powerfactor L2 [1/100];Powerfactor L3 [1/100];Frequency [1/10 Hz]
2021-01-01T00:30:00Z;1;0;0;0;0;0;0;0;0;0;1243;849;396;-2;9859;6322;2370;1166;580;2313;2307;2291;99;99;-100;499
2021-01-01T00:45:00Z;2;0;801;0;0;0;0;0;0;0;1307;878;430;-1;10820;6970;2662;1187;580;2312;2305;2290;99;99;-57;499
2021-01-01T01:45:00Z;3;0;801;0;0;0;0;0;0;0;1;0;0;0;3447;1166;1117;1163;579;2342;7;22;33;0;100;499
2021-01-01T02:00:00Z;4;0;801;0;0;0;0;0;0;0;6;6;0;0;3410;1135;1117;1157;599;2310;7;22;94;0;0;499
2021-01-01T02:15:00Z;5;0;801;0;0;0;0;0;0;0;0;0;0;0;3447;1170;1116;1161;572;2309;7;22;0;0;0;499
2021-01-01T02:30:00Z;6;0;801;0;0;0;0;0;0;0;0;0;0;0;3421;1153;1112;1155;574;2326;7;22;-50;0;100;499
2021-01-01T02:45:00Z;7;0;801;0;0;0;0;0;0;0;1;1;0;0;3422;1164;1112;1145;584;2342;7;22;44;0;0;499
2021-01-01T03:00:00Z;8;0;801;0;0;0;0;0;0;0;4;4;0;0;3402;1137;1112;1152;568;2335;7;22;92;0;0;499
2021-01-01T03:15:00Z;9;0;801;0;0;0;0;0;0;0;3;3;0;0;3434;1166;1115;1152;583;2335;7;22;83;0;0;499
2021-01-01T03:30:00Z;10;0;801;0;0;0;0;0;0;0;3;3;0;0;3463;1188;1111;1163;591;2334;7;22;90;0;0;499

retrieve the first 10 records, ordered descending

```code
curl http://10.10.10.10/data/?from=10&to=1
```

response:

Timestamp;Index;Serial;Active Energy Import L123 T1 [Wh];Active Energy Import L123 T2 [Wh];Active Energy Export L123 T1 [Wh];Active Energy Export L123 T2 [Wh];Reactive Energy Import L123 T1 [varh];Reactive Energy Import L123 T2 [varh];Reactive Energy Export L123 T1 [varh];Reactive Energy Export L123 T2 [varh];Active Power L123 [W];Active Power L1 [W];Active Power L2 [W];Active Power L3 [W];Current L123 [mA];Current L1 [mA];Current L2 [mA];Current L3 [mA];Current N [mA];Voltage L1-N [1/10 V];Voltage L2-N [1/10 V];Voltage L3-N [1/10 V];Powerfactor L1 [1/100];Powerfactor L2 [1/100];Powerfactor L3 [1/100];Frequency [1/10 Hz]
2021-01-01T03:30:00Z;10;0;801;0;0;0;0;0;0;0;3;3;0;0;3463;1188;1111;1163;591;2334;7;22;90;0;0;499
2021-01-01T03:15:00Z;9;0;801;0;0;0;0;0;0;0;3;3;0;0;3434;1166;1115;1152;583;2335;7;22;83;0;0;499
2021-01-01T03:00:00Z;8;0;801;0;0;0;0;0;0;0;4;4;0;0;3402;1137;1112;1152;568;2335;7;22;92;0;0;499
2021-01-01T02:45:00Z;7;0;801;0;0;0;0;0;0;0;1;1;0;0;3422;1164;1112;1145;584;2342;7;22;44;0;0;499
2021-01-01T02:30:00Z;6;0;801;0;0;0;0;0;0;0;0;0;0;0;3421;1153;1112;1155;574;2326;7;22;-50;0;100;499
2021-01-01T02:15:00Z;5;0;801;0;0;0;0;0;0;0;0;0;0;0;3447;1170;1116;1161;572;2309;7;22;0;0;0;499
2021-01-01T02:00:00Z;4;0;801;0;0;0;0;0;0;0;6;6;0;0;3410;1135;1117;1157;599;2310;7;22;94;0;0;499
2021-01-01T01:45:00Z;3;0;801;0;0;0;0;0;0;0;1;0;0;0;3447;1166;1117;1163;579;2342;7;22;33;0;100;499
2021-01-01T00:45:00Z;2;0;801;0;0;0;0;0;0;0;1307;878;430;-1;10820;6970;2662;1187;580;2312;2305;2290;99;99;-57;499
2021-01-01T00:30:00Z;1;0;0;0;0;0;0;0;0;0;1243;849;396;-2;9859;6322;2370;1166;580;2313;2307;2291;99;99;-100;499

# description of the csv

the first line of the response is the header consisting of:

|Name|Datatyp|Description|
|----|-------|------|
|Timestamp|string|timezone is UTC
|Index|uint32|number of the record, first record is 1
|Serial|uint32|serial number of the meter
|Active Energy Import L123 T1 [Wh]|uint64|Wh
|Active Energy Import L123 T2 [Wh]|uint64|Wh
|Active Energy Export L123 T1 [Wh]|uint64|Wh
|Active Energy Export L123 T2 [Wh]|uint64|Wh
|Reactive Energy Import L123 T1 [varh]|uint64|varh
|Reactive Energy Import L123 T2 [varh]|uint64|varh
|Reactive Energy Export L123 T1 [varh]|uint64|varh
|Reactive Energy Export L123 T2 [varh]|uint64|varh
|Active Power L123 [W]|int32|W
|Active Power L1 [W]|int32|W
|Active Power L2 [W]|int32|W
|Active Power L3 [W]|int32|W
|Current L123 [mA]|int32|mA
|Current L1 [mA]|int32|mA
|Current L2 [mA]|int32|mA
|Current L3 [mA]|int32|mA
|Current N [mA]|int32|mA
|Voltage L1-N [1/10 V]|int32|V
|Voltage L2-N [1/10 V]|int32|V
|Voltage L3-N [1/10 V]|int32|V
|Powerfactor L1 [1/100]|int8|1/100
|Powerfactor L2 [1/100]|int8|1/100
|Powerfactor L3 [1/100]|int8|1/100
|Frequency [1/10 Hz]|int16|1/10

Bei der Inbetriebnahme sind folgende Punkte zu überprüfen:

Ströme je Phase: Positive Richtung?
Bei Minus-Vorzeichen ggf. S1/S2 resp. Ein- und Ausgang tauschen

Wandlerzähler: Korrekte Phasen-Spannung angeschlossen?
Wird am Display mit L123 bestätigt

Bus-System: Korrekte Adresse inkl. Baudrate

Die Geräteserien EMU Allrounder und Professional verfügen über Doppeltarif (HT/NT).
Die Tarifansteuerung erfolgt über die Klemmen 4 und 5 (unter der roten Abdeckung)
Die Tarifumschaltung erfolgt über ein 230V Steuersignal.
Liegt keine Spannung an den Klemmen 4 und 5 an, dann ist Tarif 1 aktiv. Auf dem LCD ist das Symbol T1 oben links sichtbar.
Liegt die Steuerspannung von 230VAC an, schaltet der EMU Allrounder und EMU Professional auf Tarif 2. Auf dem Display ist T2 oben links sichtbar.

Optional ist die Serie EMU Professional mit 4 Tarifen lieferbar.

Das Stromwandlerverhältnis kann am 3-Phasen Energiezähler EMU Professional/Allrounder via Tasten konfiguriert werden.
5/5 bis 20’000/5 A, in 5 A-Schritten
1/1 bis 4’000/1 A, in 1 A-Schritten

Der EMU Professional ist ein Energiezähler welcher über Modbus RTU/ASCII Interface als Modbus-Slave (Server) über 2-Draht RS-485 kommuniziert..
Das Modbusinterface implementiert die Modbus-Implementationsklasse REGULAR. Es wird der Mode RTU und der Mode ASCII (max. 1000ms Interchar. delay) unterstützt.
Die Modbuskonfiguration (Adresse, Baudrate, Mode und Parität) wird über die Tasten am EMU Professional konfiguriert und mittels GetModbusConfiguration-Kommando ausgelesen.

Die Status-LED zeigt folgendes an :

• 1s aus    1s an -> EMU Auslesezyklus ist ok, Modbus hat keine addressierten Anfragen
• dauernd an -> EMU Auslesezyklus ist ok, Modbus hatte (zumindest in den letzten 10s) addressierte Anfragen

Linke Klemme: Data Minus (-)
Rechte Klemme: Data Plus (+)

Der EMU Professional/Allrounder hat eine Rücklaufsperre.
EMU Allrounder: Die Energie wird nur in positiver (Bezug) Richtung erfasst.
EMU Professional: Die Energie wird in negativer (Lieferung) und positiver (Bezug) Richtung erfasst und in separatem Register geschrieben. Der Zählerstand wird nie „heruntergezählt“ resp. verringert.

Die M-Bus Adresse kann am EMU Professional / Allrounder via Tasten oder kostenloser Software (z.B. EMU MB-Connect) konfiguriert werden. Mögliche Baudraten: 300, 600, 1’200, 2’400 (Default), 4’800 und 9’600 Baud.

Die M-Bus Auslesedaten können beim EMU Professional/Allrounder mit der kostenlosen Software EMU MB-Connect konfiguriert werden. So erhalten Sie die gewünschten Messwerte via M-Bus.

Für die Zeitsynchronisation empfehlen wir den NTP Zeitserver der METAS Schweiz.
Hostname: metasntp13.admin.ch
IP Adresse: 162.23.41.10

Die Impulsrate sowie Impulsdauer kann am EMU Professional/Allrounder via Tasten konfiguriert werden.
Mögliche Impulsraten/Dauer:
0.001, 0.01, 0.1, 1, 10, 100, 1’000 oder 10’000 Impulse
4 bis 250 ms in 2ms-Schritten

Die Device IP des EMU Professionals entspricht der letzten 20 Bit der MAC Adresse.