Inhaltsverzeichnis

Datenobjekte: Objektreferenz

Datenobjekte: Objektreferenz

erforderliche Eigenschaften werden unterstrichen
Standartwerte sind fett gedruckt

Geräte

Name (de)	Typennummer (Typ:Untertyp)
iLON	2:0	SOAP
WAGO	2:1	HTTP/POST
ICS	2:2	SOAP
MODBUS-TCP	2:10	RAW/TCP
Lokal	2:100
XML-Remote	2:101	HTTP/XML
XMLRPC	2:102	XMLRPC
Module- Handler	2:120
DataServer	2:200

iLON

ab version 1.0.0

Zugriff auf den iLON100 über SOAP.

Lese- und Schreibzugriff
mehrere Datenpunkte können in einem Request verarbeitet werden

Eigenschaften

Eigenschaft	mögliche Werte	Beschreibung
address	IP:Port	IP-Adresse und Port für die Verbindung
version	100e3	iLON100 Version

Datenpunkte

als Trenn-Zeichen bei Strukturen wird ein Whitespace (Leerzeichen oder Tabulator) benutzt

Eigenschaft	mögliche Werte	Beschreibung
address	NVL_oWhzState_200	Name des Datenpunktes im iLON-Webserver
field	number_of_devices	Adressierung eines einzelnen Feldes bei Strukturen
format	UNVT_whzState	Formatvorgabe (wird vom iLON- Modul verwendet)
type	NVL,MOD,…	Datenpunkttyp

WAGO

vorhanden, wird nicht weiter unterstützt…
nur für WAGO 750-841
Zugriff über einzelne HTTP- Requests, jeweils pro Datenpunkt ein Request

Eigenschaften

Eigenschaft	mögliche Werte	Beschreibung
address	IP:Port	IP-Adresse und Port für die Verbindung
user	admin	Benutzername für Administrationszugriff
pass	wago	Paßwort

Datenpunkte

Eigenschaft	mögliche Werte		Beschreibung
address	MW0		Variablenname auf dem WAGO
format	%s,<str_format>		Formatierung des Strings
call	Wert	Bedeutung	spezielle WAGO-Funktion zum Auslesen
	GETTIMEDATE	Uhrzeit
	READPI	Datenpunkt auslesen

ICS

ab version 1.14.0

Zugriff auf den SysMik ICS über SOAP.

Lese- und Schreibzugriff
pro Datenpunkt ein Request

Eigenschaften

Eigenschaft	mögliche Werte	Beschreibung
address	IP:Port	IP-Adresse und Port für die Verbindung

Datenpunkte

Eigenschaft	mögliche Werte	Beschreibung
address	abc1	Name des Datenpunktes im ICS

Lokal

das lokale Gerät, meistens der ePC selber
nur Lesezugriff auf interne Datenpunkte oder Dateien

Eigenschaften

das Gerät besitzt keine Eigenschaften

Datenpunkte

address	sonstige Eigenschaften	Beschreibung
time	format=<date_format>	lokale Systemzeit
hwmon	field=<int>	Hardware-Monitor vom Gerät
uptime		Uptime vom Gerät (Ausgabe von /proc/uptime)
loadavg		Ausgabe von /proc/loadavg
sar		Aufruf von sar, CPU Auslastung in %
rand		Zufallszahl von 0-100

XML- Remote

verfügbar ab 1.10.0

Ermöglicht den Zugriff auf beliebige XML-Daten, welche über HTTP angeboten werden. (Z.B. ein bestimmtes Feld einer beliebigen HMTL- Seite)

Eigenschaften

Eigenschaft	mögliche Werte	Beschreibung
address	HTTP- Adresse	HTTP- URL
method	get	Anfrage- Methode

Datenpunkte

Eigenschaft	mögliche Werte	Beschreibung
address	XPath	Adresse innerhalb der XML-Datei

Beipiele

Außentemperatur über Google

Geräte-Adresse:
address = http://www.google.com/ig/api?weather=Erfurt&hl=EN
Datenpunkt-Adresse:
address = string(//current_conditions/temp_c/@data)

Module-RPC

verfügbar ab 1.18.0

ermöglicht die Erweiterung der Geräteliste über weitere Module, das entsprechende Modul kann verschiedene neue Geräte anbieten, welche über einen Handler unterschieden werden.

Liste der Modul- Datenpunkte

Eigenschaften

Eigenschaft	mögliche Werte	Beschreibung
handler	<handler>	Modul- Handler für getValues und setValues

MODBUS-TCP

verfügbar ab 1.18.0

Eigenschaft	mögliche Werte	Beschreibung
address	IP:Port	IP-Adresse und Port der TCP Verbingung
slave	<int/hex>	Adresse eines Sub-Gerätes (optional, und wird vererbt)
fc	Modbus Function Code	Function Code
read_fc	Modbus Function Code	Function Code, Lesen
write_fc	Modbus Function Code	Function Code, Write

Weiterführende Dokumentation für den Zugriff WAGO/ModBus-TCP

Datenpunkte

Eigenschaft	mögliche Werte	Beschreibung
address	<int/hex>	Adress-Offset
count	<int/hex>	Anzahl der zu Lesenden Register
fc	Modbus Function Code	Function Code
read_fc	Modbus Function Code	Function Code, Lesen
write_fc	Modbus Function Code	Function Code, Write
slave	<int/hex>	Adresse eines Sub-Gerätes (optional, und wird vererbt)
unsigned	<bool>	Datenpunktwerte ohne Vorzeichen

Beispiele

WAGO

Objekt	Eigenschaften
Gerät	address=<ip_host>:502	slave=0x01
Datenpunkt (IO Eingangsklemme 0)	address=0	count=8	fc=0x02
Datenpunkt (IO Ausgangsklemme 0)	address=0	count=8	fc=0x06
Datenpunkt (Eingangsregister 0)	address=0x300		fc=0x06
Datenpunkt (Ausgangsregister 0)	address=0x100		fc=0x04

WAGO (direkter Array-Zugriff)

Objekt	Eigenschaften
Gerät	address=<ip_host>:1024	slave=0x01
Objekt 0	address=0	count=1

ICS

Objekt	Eigenschaften
Gerät	address=<ip_host>	slave=0x01
Datenpunkt 1	address=0	count=1	fc=0x03

Objekte (allgemein)

Eigenschaft	mögliche Werte	Beschreibung	Verfügbarkeit
_inherit	no,<yes/no>	Eigenschaften vererben	~1.30.0-pre2

Datenpunkte (allgemein)

Eigenschaft	mögliche Werte	Beschreibung	Verfügbarkeit
address	<string>	Adresse
t_cache	<int>	Cachen von Lese-Zugriffen erzwingen (1000/s)	> 1.13.0
math	<dp_math>	Datenpunktwert umformen (beim Lesen)	> 1.11.0
write_math	<dp_math>	Datenpunktwert umformen (beim Schreiben)	> 1.81.0
filter	<regex>	Wert über regulären Ausdruck filtern	> 1.10.0
filter_index	<int>	Feld vom regulären Ausdruck	> 1.10.0
remap	<DAVM>	Werte konvertieren	> 1.81.0
peristent	<bool>	Werte speichern und regelmäßig schreiben	> 1.101.0

Reihenfolge der Nachbearbeitungsfunktionen

t_cache
remap
filter
math