# ClientReadProperties\_NameValueUnitDescription ## `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 | Name | Datentyp | Wertebereich | Initialwert | Funktion | | --------------- | -------------------- | ------------ | ----------- | --------------------------------------------------------------------------------------------------------- | | *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 | Name | Datentyp | Wertebereich | Initialwert | Funktion | | ---------------------- | ------------------------------------------ | ------------ | ----------- | ----------------------------------------------------------------------------------- | | *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 | Name | Datentyp | Wertebereich | Initialwert | Funktion | | --------------------- | ------------------------------------------ | ------------ | ------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | **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: | Scope | Name | Type | Initial | Comment | | ----------- | --------------------- | ----------------------------------------- | ------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | | 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

| --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://support.powerio.com/hub/codesys-hvac/hvac-bacnet2-library/funktionsbausteine/client-objekte/clientreadproperties_namevalueunitdescription.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.