SimpleReadArray

SimpleReadArray (FB)

FUNCTION_BLOCK SimpleReadArray

Auslösung der Übertragung von Modbus-Daten

Die Datenübertragung wird ausgelöst, falls mindestens eine der nachfolgend beschriebenen Bedingungen erfüllt ist:

Voraussetzung: Es ist ein geeignetes Array am Eingang ‘InputArray’ angeschlossen. Dies wird durch den Ausgang ‘xInputArrayValid’ ( = TRUE ) signalisiert.

1. nach einem Flankenwechsel am Eingang ‘xUpdateActual’ ( FALSE >> TRUE ) ( einmalig )

2. nach Ablauf der Zeitdauer ‘tTimeUpdateActual’ ( ‘tTimeUpdateActual’ > 0 ) ( zyklisch )

3. nach einer Änderung des Arrays am Eingang ‘InputArray’ ( Datentyp, Grösse ) ( einmalig )

4. nach einer Änderung wesentlicher Parameter ( ‘byUnitId’, ‘wRegisterAddr’, ‘eFunctionCode’ ) ( einmalig )

5. nach einem Flankenwechsel am Eingang ‘xEn’ ( FALSE >> TRUE ) ( einmalig )

6. nach jedem Kaltstart ( einmalig )

Nach dem Abschluss der Datenübertragung wird das Ergebnis signalisiert ( ‘xDataValid’ = TRUE / FALSE ) und die übertragenen Daten im Array ‘InputArray’ abgelegt.

Hinweis: Der Datentyp des Arrays am Eingang ‘InputArray’ kann Stand 07.07.2023 nicht erkannt und ausgewertet werden ( CDS-43675 Compiler, AnyType: Extension for Arrays needed ) In der ToolTipp-Hilfe zum Eingang ‘InputArray’ werden die möglichen Array-Datentypen in Abhängigkeit vom gewählten Function-Code angezeigt.

InOut:

Scope	Name	Type	Initial	Comment
Input	xEn	BOOL	TRUE	Freigabe / Sperrung der Kommunikation ( TRUE = Freigabe )
Input	byUnitId	BYTE	0	Modbus-Adresse des Geräts
Input	InputArray	__SYSTEM.AnyType		Eingang für das Array ( FC01/02: ARRAY OF BOOL, ARRAY OF BYTE ) ( FC03/04: ARRAY OF INT, ARRAY OF UINT, ARRAY OF WORD )
Input	xUpdateActual	BOOL	FALSE	Aktualisierung der Istwerte ( bei jeder ansteigenden Flanke )
Input	xResError	BOOL	FALSE	Reinitialisierung der Ausgänge ‘eErrorCodeCom’ bzw. ‘eErrorCodeDev’ auf den fehlerfreien Zustand ( bei jeder ansteigenden Flanke )
Inout	ModbusClient	ModbusClientBase		Client des Geräts
Output	eFunctionCodeFb	ReadFunctionCodes	ReadFunctionCodes.FC01_ReadCoils	Rückmeldung - Modbus-Function-Code für das Modbus-Telegramm
Output	wRegisterAddrFb	WORD	0	Rückmeldung - Startadresse des Registers für das Modbus- Telegramm
Output	diInputArrayNumb	DINT	0	Anzahl der Arrayelemente am Eingang ‘InputArray’ in Abhängigkeit vom Modbus-Function-Code
Output	xInputArrayValid	BOOL	FALSE	Gültigkeit des Arrays am Eingang ‘InputArray’ ( Datentyp, Grösse ) ( FALSE = nicht gültig, TRUE = gültig )
Output	xDataValid	BOOL	FALSE	Gültigkeit der Daten im Array ‘InputArray’ ( FALSE = nicht gültig, TRUE = gültig )
Output	xAlarm	BOOL	FALSE	Sammelstörung ( TRUE = Störung )
Output	xAlarmCom	BOOL	FALSE	Sammelstörung - Kommunikation ( TRUE = Störung )
Output	eErrorCodeCom	ModbusErrorCode	ModbusErrorCode.NO_ERROR	Fehlercode - Kommunikation ( 0 = kein Fehler )
Output	eErrorCodeDev	SIMPLE_READ_ARRAY_ERROR_CODE	SIMPLE_READ_ARRAY_ERROR_CODE.NO_ERROR	Fehlercode - Gerät ( 0 = kein Fehler )
Output	xBusy	BOOL	FALSE	Kommunikationsanzeige ( TRUE = Kommunikation )
Input Const	eFunctionCode	ReadFunctionCodes	ReadFunctionCodes.FC03_ReadHoldingRegisters	Modbus-Function-Code für das Modbus-Telegramm
Input Const	wRegisterAddr	WORD		Startadresse des Registers für das Modbus-Telegramm
Input Const	tTimeUpdateActual	TIME	TIME#3s0ms	Updateintervall für die Vorgänge, die durch den Eingang ‘xUpdateActual’ beeinflusst werden