Registerbeschreibung
Im folgenden wird erklärt, wie Sie mittels Reglertyp und Firmware-Version des Reglers die korrekte Registerbeschreibung finden und was Sie bei der Anwendung einer Registerbeschreibung beachten müssen.
Reglertypen und Firmware-Versionen
Die Registerbeschreibungen sind nach Reglertypen sowie Firmware-Versionen strukturiert. Um die korrekte Beschreibung zu finden, wählen Sie bitte zunächst den entsprechenden Reglertyp aus. Wählen Sie nun unter “Verfügbare Versionen” die Version der Registerbeschreibung nach folgendem Verfahren aus. Die angezeigten Versionen beschreiben die Register ab der jeweils angegebenen Firmware-Version. Eine Beschreibung ist damit für alle Firmware-Versionen größer oder gleich der ausgewählten Version gültig, bis diese durch eine neue Version ersetzt wird.
Beispiel
Zur Verfügung stehen die Versionen:
- v0.00
- v1.73
- v1.96
Wenn Ihr Regler eine Firmware-Version v1.81 hat, dann nutzen Sie bitte die Beschreibung in Version v1.73. Nutzen Sie die Beschreibung in der höchsten Version v1.96 erst, wenn die Firmware-Version Ihres Reglers mind. v1.96 ist.
Verfügbarkeit von Werten
Die Registerbeschreibung zeigt alle Datenpunkte, welche von dem jeweiligen Reglertypen maximal erfasst werden können. Ob sich in dem angegebenen Register der entsprechende Wert befindet, ist davon abhängig, ob z.B. der entsprechende Temperaturfühler angeschlossen ist und durch den Fühlerscan erkannt wurde. Ebenso kann die Konfiguration des Reglers eine Auswirkung darauf haben, ob ein Wert zur Verfügung steht oder nicht.
Grenzen zwischen Registern
In der Beschreibung ist die Grenze zwischen zwei Aktualisierungsraten durch eine dicke Linie markiert. Sie können die Werte mehrerer Register gleichzeitig abfragen. Lesen Sie jedoch mit einer Abfrage niemals über eine der dicken Linien hinweg, da ansonsten eine ILLEGAL_DATA_ADDRESS Exception ausgelöst wird.
Lücken in den Registern
Die in der Beschreibung angegebenen Register sind nicht immer fortlaufend nummeriert. So kann z.B. auf das Register 1306 und 1307 das Register 1312 folgenden. Es ist erlaubt über diese Lücken zu lesen, hierbei wird kein Fehler ausgelöst. Beachten Sie jedoch, dass der fachliche Wert aller nicht belegten und beschriebenen Register undefiniert ist.
Eigenschaften eines Registers
Neben den Eigenschaften Register, Bezeichnung, Einheit und Aktualisierungsrate gibt es weitere Eigenschaften, welche nicht in allen Punkten selbsterklärend sind. Daher werden diese Eigenschaften im folgenden genauer erläutert. Es ist wichtig diese Erläuterungen zu beachten, um fachlich korrekte Werte zu erhalten.
Datentyp
- Bit: Eine boolscher Status EIN/AUS bzw. JA/NEIN.
- Signed INT16: Ein vorzeichenbehafteter 16-Bit Wert.
- Unsigned INT16: Ein vorzeichenloser 16-Bit Wert.
- Unsigned INT8 ⚠: Ein vorzeichenloser 8-Bit Wert, in diesem Fall darf nur das LSB ausgewertet werden (s.u.).
Bei Unsigned INT8 ist zu beachten, dass Sie nur das LSB dieses 16-Bit Registers auswerten dürfen. Hierzu müssen Sie die Bitmaske 0x00ff und den Registerwert mit einem logischen UND verknüpfen.
wert = register_wert & 0x00ff;
Faktor
Sofern ein Faktor angegeben ist, handelt es sich bei dem Registerwert um eine Festkommazahl. Sie müssen den Faktor mit dem Registerwert multiplizieren, um den fachlichen Wert zu erhalten. Wenn dieses Feld mit "N/A" gekennzeichnet ist, dann ist keine Multiplikation notwendig, der Wert kann direkt verwendet werden (Gleichbedeutend zu Faktor = 1).
wert = register_wert * faktor
Wert für ungültig
Sofern der Wert für ungültig angegeben ist, bedeutet dies das der Datenpunkt diesen Wert annimmt, wenn der Regler den fachlichen Wert z.B. aufgrund eines Fühlerbruchs nicht erfassen kann. Wenn dieses Feld mit "N/A" gekennzeichnet ist, dann gibt es keinen Wert für ungültig. Bitte beachten Sie, dass der Wert für ungültig vor Berücksichtigung des Faktors angegeben ist, sich also auf den Register-Wert bezieht.