Groups und Items

Groups

Liste der Sub-Devices eines Gerätes. Zb. hat ein Umrichter mehrere Subdevices.

Battery, Netz, PV, House zb. Für den Energiemanager. Aber auch noch Netz-Import, Netz-Export als Zählerdevice oder Batter-Ladung, Entladung.

Die ID wird dann bei den Items diesen als Liste zugewiesen. Dh. ein Item kann auch zu mehreren Gruppen zugewiesen werden. Auch kann der Wert für unterschiedliche Gruppen auch andere Werte haben. Zb. ALIAS=POWER ist Battery_Ladung anders als Netz-Import usw.. Oder Battery-Entladung. Der ALIAS ist dann identisch. Der Name und ID des Items unterschiedlich.

Die Reihenfolge der Funktionen bestimmt die Abarbeitungsfolge.

Beispiel:

*GROUP	ID	ALIAS	NAME
	0	GRID	GRID
	1	BATTERY	BATTERY
	2	PV	PV
	3	HOUSE	HOUSE
	4	GRID_IMPORT	GRID_IMPORT
	5	GRID_EXPORT	GRID_EXPORT
	6	BATTERY_CHARGE	BATTERY_CHARGE
	7	BATTERY_DISCHARGE	BATTERY_DISCHARGE

Items

Liste der Items

ALIAS: Definierter ALIAS für GERÄTE-ZUWEISUNG
NAME: Name welcher im Steuerungssystem erscheint
ID: Eindeutige ID 0..254
VISBILITY: HIDDEN,VISIBLE(Standard=VISIBLE)
UNIT: Einheit
GROUP: siehe Gruppen. List der Gruppen mit , getrennt. zB. 0,1,2,3
TYPE: Leer = STANDARD Wert aus Formula
ARRAY = Nur bei REST JSON anwendbar. RFORMULA beinhaltet den Namen der direkten Array -Variable.
Bei Abfrage über das Control wird der Wert des übergebenen Indexes zurückgegeben.
STRING = Nur bei REST anwendbar. RFORMULA beinhaltet den Namen der direkten Variable.
RFORMULA: DATA.arrayvar
getSetDeviceItem(…,DATA.arrayvar,10,…)
liefert DATA.arrayvar[10] zurück.
DEFAULT: Defaultwert
WFORMULA: Berechungsformel welche beim Schreiben/Ändern der Variable aus dem Steuerungssystem ausgeführt wird
RFORMULA: Berechungsformel welche zyklisch ausgeführt wird
POLLING: Abfrage/Berechnungsintervall in ms

Beispiel:

*ITEM	ALIAS	NAME	VISIBILITY	ID	UNIT	TYPE	DEFAULT	WFORMULA	RFORMULA	POLLING
	DEVICE	Device		0					„X.0:=D02.0.WORD;“	3000
	DEVICE_VER_(B/P)	Device ver. (B/P)		1			12		„X.1:=D04.0.WORD;“	3000
	PRESSURE_EXHAUST_CHNL	Exhaust chnl pressure		5	Pa				„X.5:=D12.0.WORD;“	3000
	FLOW_SETPOINT_[M3/H]	Setpoint flow		6	m^3/h				„X.6:=D13.0.WORD;“	3000
	PRESSURE_IMB_OK	Pressure imbalance ok		7					„X.7:=D16.0.WORD;“	3000
	PRESSURE_FIXED_IMB	Fixed press imbalance		8	m^3/h				„X.8:=D22.0.INT;“	3000
	FLOW_SUPPLY_CUR	Current supply flow		9	m^3/h				„X.9:=D28.0.WORD;“	3000
	FLOW_EXHAUST_CUR	Current exhaust flow		10	m^3/h				„X.10:=D29.0.WORD;“	3000
	BYPASS_FLAP_POS	Bypass flap pos		11					„X.11:=D30.0.WORD;“	3000
	BYPASS_FLAP_FUNC	Bypass flap func		12					„X.12:=D31.0.WORD;“	3000
	PREHEAT_REG_STATUS	Preheat reg status		13					„X.13:=D37.0.WORD;“	3000
	POWER_PREHEAT_REG	Preheat reg power		14					„X.14:=D38.0.WORD;“	3000
	ERROR_CODE_CUR	Current error code		15					„X.15:=D39.0.WORD;“	3000
	FILTER_DISPLAY	Filter display		16					„X.16:=D40.0.WORD;“	3000
	GROUND_HEAT_MODE	Ground heat mode		17					„X.17:=D41.0.WORD;“	3000
	TEMP_GROUND_MIN	Min ground heat temp		18	°C/10				„X.18:=D47.0.INT;“	3000
	TEMP_GROUND_MAX	Max ground heat temp		19	°C/10				„X.19:=D53.0.INT;“	3000
	CO2_SENSOR_NUM	CO2 sensor # (max4)		20					„X.20:=D59.0.WORD;“	3000
	CO2_SENSOR_VALUE	CO2 sensor value		21	ppm				„X.21:=D60.0.WORD;“	3000
	MODBUS_SLAVE_ADDR	Modbus slave addr		30				„W00.0.WORD:=X.30.WORD; W00.F:=1;“		3000

Maskierung

Bei den Items und Groups kann in der Spalte MASK ein String definiert werden.
Dieser wird bei exportieren verglichen mit der Variable je Slave.

$.ITEMMASK.

Damit kann man eine Filter definieren mit dem dann bei der IO-Auswahl im OS nur die passenden ITEMS je Slave angezeigt werden, bzw. auch in der Gatewayfunktion und Stationsliste.

$.ITEMMASK == MASK

Type

Die Datentypen Einträge in der Spalte TYPE bei den Items werden für die Gateway-Funktion verwendet zur Datenkonvertierung.

bool

byte

word

dword

lword

usint

uint

udint

ulint

sint

int

dint

lint

real

lreal

string

time

STRING und ARRAY bleiben Ausnahmen für die COMPLEX-ABFRAGE.