====== Holley DTZ541======

Der Holley DTZ541 kann nach IEC 62056-21 über die IR-Schnittstelle ausgelesen werden.\\

<note>Es sind schon Zähler dieses Typs aufgetaucht, welche falsch konfiguriert sind und inkorrekte Zeitstempel übertragen. ''"use_local_time": true,'' löst das Problem.</note>
<note important>Das Zählermodell ist auch dafür bekannt das die Sendeleistung der Diode mit dem Alter nachlässt. In dem Fall an den Messstellenbetreiber wenden und um Austausch bitten.</note>

===== Hardware =====

Man benötigt den [[hardware:controllers:ir-schreib-lesekopf|IR-Schreib-Lesekopf]].\\

Der Zähler sendet lastabhängig alle zwei Sekunden unaufgefordert ein [[software:sml|SML]]-Datenpaket. Die Kundenschnittstelle befindet sich rechts neben den zweizeiligen Display und ist mit Metall umgeben, so dass ein Magnet haften bleibt. In der Schnittstellenöffnung sitzt die Sendediode rechts. Gesendet wird mit [[hardware:controllers:ir-schreib-lesekopf#grundlagen|9600bd, 8N1]].\\ 
Außerdem besitzt der Zähler einen Impulsausgang der 500 oder 10000 Imp./kWh liefert. Bei Zählerstillstand, leuchtet die Impulsausgang dauerhaft.

===== Schnittstelle =====
Für den Endverbraucher steht eine frontseitige optische Datenschnittstelle zur Verfügung. Die Schnittstellen arbeiten in „PUSH“ Betrieb und senden pro Sekunde einen Datensatz aus. Ohne PIN-Eingabe bei der Einstellung „INFO OFF“ ist es ein verkürzter Datensatz, sonst enthält der lange Datensatz noch die Information über Leistung, Spannung und Strom. Für den Anschluss eines BAB-Kommunikationsadapters steht die elektrische RS485 Schnittstelle nach EIA-485 mit Klemmen. 27 = +A / 28 = -B. zu Verfügung. Beide Schnittstellen haben eine konstante Datenrate von 9600Baud und einer Zeichenkodierung von 8-N-1. Das Übertragungsprotokoll ist nach SML Spezifikation Version 1.04, enthält aber eine andere Kodierung und ein paar Abeichungen vom der SML Spezifikation. Der aktuelle Stand der libSML kann das Protokoll dieses Zählers (Bj. 2019) decodieren.

^ INFO Schnittstelle ohne PIN-Eingabe ^ INFO Schnittstelle mit PIN-Eingabe oder INFO-on^
| Herstellerkennung | Herstellerkennung |
| Geräteidentifikation | Geräteidentifikation |
| Zählerstand +A, tariflos (nur bei Eintarifzählern)| Zählerstand +A, tariflos (nur bei Eintarifzählern) | 
| Zählerstand +A, Tarif 1 (nur bei Zweitarifzählern)| Zählerstand +A, Tarif 1 (nur bei Zweitarifzählern) | 
| Zählerstand +A, Tarif 2 (nur bei Zweitarifzählern)| Zählerstand +A, Tarif 2 (nur bei Zweitarifzählern) | 
| Zählerstand -A, tariflos (generell)| Zählerstand -A, tariflos (generell) | 
| | Momentane Wirkleistung gesamt mit Vorzeichen | 
| | Spannung L1 | 
| | Spannung L2 | 
| | Spannung L3 |
| | Strom L1 |
| | Strom L2 |
| | Strom L3 |
| | Phasenwinkel U-L2 zu U-L1 |
| | Phasenwinkel U-L3 zu U-L1 |
| | Phasenwinkel I-L1 zu U-L1 |
| | Phasenwinkel I-L2 zu U-L2 |
| | Phasenwinkel I-L3 zu U-L3 |
| | Frequenz |
| Firmware Version | Firmware Version |
| Firmware Checksumme | Firmware Checksumme |
| Fehlerregister | Fehlerregister |
| | |

===== Beispielkonfiguration =====
Eine exemplarische vzlogger.conf:
<code base vzlogger.conf>
{
"retry" : 3,
"verbosity" : 0, // für Debugging auf 15 setzen
"log" : "/var/log/vzlogger/vzlogger.log",
"local" : {
	"enabled" : false,
	"port" : 8081,
	"index" : true,
	"timeout" : 30,
	"buffer" : 600
},

"meters" : [{
	"protocol" : "sml",
	"enabled" : true,
	"device" : "/dev/ttyUSB0",
	"parity" : "8N1",
	"baudrate" : 9600,
	"use_local_time": true,  // manche Zaehler sind falsch konfiguriert und liefern unbrauchbare Zeitstempel
	"aggtime" : -1,
	"aggfixedinterval" : true,
	"channels": [{
		"uuid" : "6836dd20-00d5-11e0-bab1-856ed5f959ae",
		"middleware" : "http://localhost/middleware.php",
		"identifier" : "1-0:1.8.2", // kann bei manchen Zählern auch "1-0:1.8.0" sein (siehe Logfile)
		"aggmode" : "MAX"
		}]
	}
]}
</code>
===== Debugging =====
In älteren Versionen von libsml fehlt ein wichtiger Bugfix für den Holley DTZ541. Auch im Volkszähler Raspi Image (Stand: 29.11.2020) fehlt dieser Bugfix!
<note tip>Im Config File vzlogger.conf **"verbosity" : 15** setzen. Danach vzlogger neu starten: **sudo systemctl restart vzlogger**. Nach abgeschlossenem Debugging Wert auf 0 zurück setzen.</note>
Wenn am device **/dev/ttyUSB0** Daten ankommen, im Logfile **/var/log/vzlogger.log** aber keine Werte sichtbar sind, sollte man man libsml und vzlogger aktualisieren.
<code>
[Nov 29 12:36:31][mtr0] Got 0 new readings from meter:
[Nov 29 12:36:31][chn0] ==> number of tuples: 0
[Nov 29 12:36:31][chn0] JSON request body is null. Nothing to send now.
</code>

libsml kann wie folgt aktualisiert werden.
<code>
cd ~/vzlogger/libs/libsml
git pull
sudo apt-get install uuid-dev uuid-runtime
make
cd ~/vzlogger
./install.sh libsml
</code>

Das Updaten von vzlogger ist hier beschrieben: https://wiki.volkszaehler.org/howto/raspberry_pi_image#updates_der_vz-software