ClientReadProperties_NameValueUnitDescription
ClientReadProperties_NameValueUnitDescription (FB)
ClientReadProperties_NameValueUnitDescription (FB)FUNCTION_BLOCK ClientReadProperties_NameValueUnitDescription
Kurzbeschreibung
Aktualisierung von vier festgelegten Eigenschaften eines BACNET-Objekts ( Lesender Zugriff ) Typische Anwendung: Abfrage der Eigenschaften eines ANALOG-INPUT-Objekts via BACNET
Darstellung
Schnittstellen
Eingänge
xEn
BOOL
TRUE
Freigabe / Sperrung der Kommunikation ( TRUE = Freigabe )
itfServer
BACnet.IBACnetServer
Interface-Variable für die Referenzierung des Servers
xUpdateActual
BOOL
FALSE
Aktualisierung der Istwerte ( bei jeder ansteigenden Flanke )
xResError
BOOL
FALSE
Rücksetzung des Fehlerausgänge ‘eErrorCodeCom’ und ‘eRepyErrorCode.XXX’ ( bei jeder ansteigenden Flanke )
Ausgänge
dwDeviceID_Fb
DWORD
0
Nummer des BACnet - Zielgerät ( Bereich: 0 - 4194302 ) - Rückmeldung
eObjectType_Fb
BACnet.CmpBACnet.IEC_BACnet_Object_Type
Typ des Objekts - Rückmeldung
dwObjectInstance_Fb
DWORD
0
Nummer des Objekts ( Bereich: 0 - 4194303 ) - Rückmeldung
sObjectName
STRING
Name des Objekts
sValueOutput
STRING
‘’
Anzeige des Ausgangs für den Istwert ( PRESENT_VALUE ) des Objekts
xValidValue
BOOL
FALSE
Status der Gültigkeit des Istwerts ( PRESENT_VALUE ) ( TRUE = Istwert gültig )
rValue
REAL
Istwert der Eigenschaft im Format REAL ( Gleitkommazahl gemaess IEEE754 - 32 Bit )
xValue
REAL
Istwert der Eigenschaft im Format BOOL
sValue
STRING
Istwert der Eigenschaft im Format STRING ( Zeichenkette )
diValue
DINT
Istwert der Eigenschaft im Format DINT ( Ganzzahl mit Vorzeichen )
udiValue
UDINT
Istwert der Eigenschaft im Format UDINT ( Ganzzahl ohne Vorzeichen )
byValue
BYTE
Istwert der Eigenschaft im Format BYTE ( Ganzzahl 0 - 255 )
lrValue
LREAL
Istwert der Eigenschaft im Format LREAL ( Gleitkommazahl gemaess IEEE754 - 64 Bit )
sObjectUnit
STRING
Einheit für den Istwert ( PRESENT_VALUE ) des Objekts
sObjectDescription
STRING
Beschreibung des Objekts
xRegToServer
BOOL
FALSE
Status der Registrierung am BACnet-Server ( TRUE = erfolgreiche Registrierung )
xConfigObject
BOOL
FALSE
Status der Konfiguration des Objekts ( TRUE = erfolgreiche Konfiguration )
eState
BACnet.CmpBACnet.IEC_BACNET_STATUS
Status der Kommunikation
eErrorCodeCom
BACnet.CmpBACnet.IEC_BACNET_STATUS
Aktuellster Kommunikationsfehler
eErrorCodeDevice
BACnet.CmpBACnet.IEC_BACNET_ERROR_CODE
Aktuellster vom BACnet - Zielgerät ( BACnet-Server ) übertragener Gerätefehler
eReplyErrorCode
TYPE_OF_REPLY_ERROR_CODE
Aktuellster Kommunikationsfehler in der Antwort auf eine eigene Anfrage
xAlarm
BOOL
FALSE
Sammelstörung ( TRUE = Störung )
xAlarmCom
BOOL
FALSE
Sammelstörung - Kommunikation ( TRUE = Störung )
xBusy
BOOL
Kommunikationsanzeige ( TRUE = Kommunikation )
Sollwerte / Parameter
tTimeUpdateActual
TIME
T#3s
Updateintervall für die Vorgänge, die durch den Eingang ‘xUpdateActual’ beeinflusst werden ( 0 = kein automatisches Update, > 0 zyklisches Update )
dwDeviceID
DWORD
Nummer des BACnet - Zielgerät ( Bereich: 0 - 4194302 )
eObjectType
BACnet.CmpBACnet.IEC_BACnet_Object_Type
BACnet.CmpBACnet.IEC_BACnet_Object_Type.OBJ_ANALOG_INPUT
Typ des Objekts
dwObjectInstance
DWORD
Nummer des Objekts ( Bereich: 0 - 4194303 )
Funktionsbeschreibung
Allgemeines
Dieser Funktionsbaustein überträgt vier vordefinierte Eigenschaften eines Objekts per BACNET-Kummunikation ( lesender Zugriff ). Es werden die Eigenschaften OBJECT_NAME, PRESENT_VALUE, UNITS sowie DESCRIPTION ( soweit möglich ) gelesen. Die Auswahl des zu lesenden Objekts erfolgt über die Parameter dwDeviceID, eObjectType und dwObjectInstance. Die Gültigkeit des Istwerts ( PRESENT_VALUE) nach einer Übertragung wird am Ausgang ‘xValidValue’ signalisiert. Der Ausgang mit dem Istwert ( PRESENT_VALUE ) wird nach einer erfolgreichen Übertragung am Ausgang ‘sValueOutput’ dargestellt. \
Freigabe / Sperrung der Kommunikation
Die Freigabe / Sperrung der Kommunikation erfolgt über den Eingang ‘xEn’ ( Default = TRUE = Freigabe ). Bei jeder ansteigenden Flanke am Eingang ‘xEn’ wird eine Übertragung des Istwerts mit den aktuellen Einstellungen ausgelöst. Im gesperrten Zustand nehmen die Ausgänge vordefinierte Zustände ein, gleichzeitig erfolgt eine Abmeldung vom Server. \
Auslösung einer Übertragung
Die Übertragung des Istwerts der Eigenschaft kann wie folgt ausgelöst ( Voraussetzung: xRegToServer = TRUE ) \
jede ansteigende Flanke am Eingang ‘xEn’
jede ansteigende Flanke am Eingang ‘xUpdateActual’
zyklisch im Intervall ‘tTimeUpdateAvtual’ ( Default: T#3s )
einmalig nach jedem Download
einmalig nach jeder Änderung der Konfiguration \
Konfiguration des BACNET-Objekts
Das BACNET-Objekt wird durch die folgenden Parameter eindeutig festgelegt: \
Geräteadresse ‘dwDeviceID’
Objektadresse ‘dwObjectInstance’
Objekttyp ‘eObjectType’\
Rückmeldung der aktuellen Parameter
An den Ausgängen mi dem Index ‘_Fb’ stehen die aktuellen Einstellwerte der BACNET-Parameter zu Anzeigezwecken zur Verfügung.\
Ausgang ‘sValueOutput’
An diesem Ausgang steht nach einer erfolgreichen Übertragung der Name der Ausgangsvariablen zur Verfügung, die den gültigen Istwert ( PRESENT_VALUE ) enthält.\
Ausgang ‘xValidValue’
An diesem Ausgang steht nach einer erfolgreichen Übertragung die Gültigkeit des Istwerts ( PRESENT_VALUE ) zur Verfügung.\
Ausgänge für den aktuellen Istwert des Objekts
In Abhängigkeit von der Gültigkeit des Istwerts ( xValidValue = TRUE ) und dem Namen der Ausgangsvariablen ( sValueOutput ) steht am entsprechenden Ausgang der Istwert zur Verfügung.\
Ausgang ‘xRegToServer’
An diesem Ausgang steht permanent der Status der internen Verbindung zum BACNET-Server zur Verfügung. Der erfolgreiche Verbindungsaufbau zum Server ist dabei Voraussetzung zur Übertragung des Sollwerts.\
Ausgang ‘xConfigObject’
An diesem Ausgang steht permanent der Status der erfolgreichen Konfiguration des BACNET-Objekts zur Verfügung.\
Anzeige von Störungen
Die Anzeige von Störungen erfolgt am Sammelausgang ‘xAlarm’ ( = TRUE ). Er beinhaltet die aktuellen Zustände der Kommunikationsfehler ( xAlarmCom ) und die Gerätefehler ( xAlarmDevice ). Die Kommunikationsstörungen werden ( Zeitverzögerung: gc_Parameters.gc_tOnDelayxAlarmCom, Default = 60s ) am Ausgang xAlarmCom dargestellt. Die Gerätestörungen werden unverzögert am Ausgang xAlarmDevice dargestellt. Am Ausgang ‘eErrorCodeCom’ steht im Falle eines Kommunikationsfehlers ein erklärender Text für die Ursache zur Verfügung. Es wird dort stets die Ursache des letzten Kommunikationsfehlers angezeigt. Am Ausgang ‘eErrorCodeDevice’ steht im Falle eines Gerätefehlers ein erklärender Text für die Ursache zur Verfügung. Es wird dort stets die Ursache des letzten Kommunikationsfehlers angezeigt und aktuelisiert. Am Ausgang ‘eReplyErrorCode’ steht im Falle eines Fehlers im Antworttelegramm ein erklärender Text für die Ursache zur Verfügung.\
Ausgang ‘xBusy’
Dieser Ausgang signalisiert die aktive Übertragung des Istwerts ( = TRUE ).\
CODESYS
InOut:
Input
xEn
BOOL
TRUE
Freigabe / Sperrung der Kommunikation ( TRUE = Freigabe )
Input
itfServer
BACnet.IBACnetServer
Interface-Variable für die Referenzierung des Servers
Input
xUpdateActual
BOOL
FALSE
Aktualisierung der Istwerte ( bei jeder ansteigenden Flanke )
Input
xResError
BOOL
FALSE
Rücksetzung des Ausgang ‘eError’ ( bei jeder ansteigenden Flanke )
Output
dwDeviceID_Fb
DWORD
Nummer des BACnet - Zielgerät ( Bereich: 0 - 4194302 ) - Rückmeldung
Output
eObjectType_Fb
BACnet.CmpBACnet.IEC_BACnet_Object_Type
Typ des Objekts - Rückmeldung
Output
dwObjectInstance_Fb
DWORD
Nummer des Objekts ( Bereich: 0 - 4194303 ) - Rückmeldung
Output
sObjectName
STRING
Name des Objekts
Output
sValueOutput
STRING
‘’
Anzeige des Ausgangs für den Istwert der Eigenschaft
Output
xValidValue
BOOL
FALSE
Status der Gültigkeit des Istwerts einer Eigenschaft ( FALSE = Istwert ungültig )
Output
rValue
REAL
Istwert der Eigenschaft im Format REAL ( Gleitkommazahl gemaess IEEE754 - 32 Bit )
Output
xValue
BOOL
Istwert der Eigenschaft im Format BOOL
Output
sValue
STRING(255)
Istwert der Eigenschaft im Format STRING ( Zeichenkette )
Output
diValue
DINT
Istwert der Eigenschaft im Format DINT ( Ganzzahl mit Vorzeichen )
Output
udiValue
UDINT
Istwert der Eigenschaft im Format UDINT ( Ganzzahl ohne Vorzeichen )
Output
byValue
BYTE
Istwert der Eigenschaft im Format BYTE ( Ganzzahl 0 - 255 )
Output
lrValue
LREAL
Istwert der Eigenschaft im Format LREAL ( Gleitkommazahl gemaess IEEE754 - 64 Bit )
Output
sObjectUnit
STRING
Einheit des Messwerts
Output
sObjectDescription
STRING
Beschreibung des Objekts
Output
xRegToServer
BOOL
Status der Registrierung am BACnet-Server ( TRUE = erfolgreiche Registrierung )
Output
xConfigObject
BOOL
Status der Konfiguration des Objekts ( TRUE = erfolgreiche Konfiguration )
Output
eCBMState
BACnet.CmpBACnet.IEC_BACNET_STATUS
CBM - Status der Kommunikation ( Aktualisierung: Zustände DONE, ERROR und ABORT )
Output
eComState
ClientReadProperty_ComStates
Status der Kommunikation ( Aktualisierung: Zustände No_Execution, Target_Device_Searching, Request_Sending, Reply_Waiting, Finishing )
Output
eErrorCodeCom
BACnet.CmpBACnet.IEC_BACNET_STATUS
Aktuellster Kommunikationsfehler
Output
eErrorCodeDevice
BACnet.CmpBACnet.IEC_BACNET_ERROR_CODE
Aktuellster vom BACnet - Zielgerätv ( BACnet-Server ) übertragener Gerätefehler
Output
eReplyErrorCode
TYPE_OF_REPLY_ERROR_CODE
Aktuellster Kommunikationsfehler in der Antwort auf eine eigene Anfrage
Output
xAlarm
BOOL
Sammelstörung ( TRUE = Störung )
Output
xAlarmCom
BOOL
Sammelstörung - Kommunikation ( TRUE = Störung )
Output
xBusy
BOOL
Kommunikationsanzeige ( TRUE = Kommunikation )
Input Const
dwObjectInstance
DWORD
Nummer des Objekts ( Bereich: 0 - 4194303 )
Input Const
eObjectType
BACnet.CmpBACnet.IEC_BACnet_Object_Type
BACnet.CmpBACnet.IEC_BACnet_Object_Type.OBJ_ANALOG_INPUT
Typ des Objekts
Input Const
dwDeviceID
DWORD
Nummer des BACnet - Zielgerät ( Bereich: 0 - 4194302 )
Input Const
tTimeUpdateActual
TIME
TIME#3s0ms
Updateintervall für die Vorgänge, die durch den Eingang ‘xUpdateActual’ beeinflusst werden
Zuletzt aktualisiert