Skip to main content

Gemeinsame Objekt-Property-Aktionen

Die nachfolgend beschriebenen gemeinsamen Objekt-Property-Aktionen sind für alle Objekte implementiert, die die aufgeführten Propertys besitzen.

Property: Status_Flags

Das Status_Flags-Property hat einen Bit-String-Wert von 4 Bits. Die Werte von 3 dieser Bits beziehen sich auf die Werte anderer Propertys im selben Objekt. Die Beziehung ist im BACnet-Standard definiert und wird als Aktionen im beschriebenen API implementiert: Bit IN_ALARM ist logisch FALSE wenn das Event_State-Property den Wert von NORMAL hat, ansonsten logisch TRUE. Bit FAULT ist logisch TRUE wenn das Reliability-Property vorhanden ist und nicht den Wert von NO_FAULT_DETECTED hat, ansonsten logisch FALSE. Bit OUT_OF_SERVICE ist logisch TRUE wenn das Out_Of_Service-Property vorhanden ist und nicht den Wert von TRUE hat, ansonsten logisch FALSE.

Property: Out_of_Service

Das Out_Of_Service-Property, vom Typ BOOL, ist ein Anzeiger dafür ob der physikalische Punkt, den das Objekt repräsentiert, in Betrieb ist (TRUE) oder nicht (FALSE). Falls er nicht in Betrieb ist, müssen verschiedene andere Propertys beschreibbar sein. Beispielsweise müssen die Propertys Present_value und Reliability beschreibbar sein, um verschiedene Ereignisse und Zustände zu simulieren, die ein Objekt unterstützt, und die während des Normalbetriebs nicht auftreten. Also, wenn das Out_Of_Service-Property auf TRUE gesetzt ist, sind diese Propertys schreibbar, auch wenn die Anwenderapplikation KEINE Zugriffsrechte für sie definiert hat.

Propertys in Zusammenhang mit intrinsischem Reporting

Objekte, die im Standard intrinsische Reporting-Prozeduren definieren, und die auch vom vorliegenden API unterstützt werden, bekommen ihre Propertys bezüglich intrinsischen Reportings automatisch von internen Aktionen im API aktualisiert. Beispielsweise wird das Property Event_State im entsprechenden Enumerationswert für den intrinsischen Status gesetzt, in dem das Objekt sich befindet. Das Property Event_Time_Stamps wird aktualisiert, wenn die Ereignis-Bestätigung gesendet wird. Bits im Property Acked_Transitions werden ebenfalls entsprechend verändert.

Propertys in Zusammenhang mit Ändern des Werte-Reportings

Objekte, für die im Standard COV-Reporting-Prozeduren definiert sind, und die ebenso von der API unterstützt werden, bekommen ihre Propertys bezüglich des COV-Reportings automatisch durch interne Aktionen im API aktualisiert. Auch das Senden von Benachrichtigungen über Werteänderungen an registrierte Teilnehmer für Objekte oder Objekt-Propertys wird vom API durchgeführt.

Propertys in Zusammenhang mit Befehlspriorisierung

Für BACnet-Objekte werden Befehle auf Basis einer fixen Anzahl von Propertys priorisiert, die befehlserzeugenden Einheiten zugewiesen sind. Ein priorisierter Befehl (der an eine kommandierbare Property eines Objekts gerichtet ist) wird via einer WriteProperty-Service-Anfrage oder einer WritePropertyMultiple-Service-Anfrage ausgeführt. Die Basisanfrage schließt einen bedingten Priority-Parameter ein, der von 1 bis 16 reicht. Jede kommandierbare Property eines Objekts hat eine zugehörige Priorisierungstabelle, die durch das Priority_Array-Property repräsentiert wird. Das Priority_Array besteht aus einem Array von befohlenen Werten, angeordnet nach absteigender Priorität. Der erste Wert im Array entspricht Priorität 1 (höchste) der zweite Wert entspricht Priorität 2, usw., bis zum sechzehnten Wert, der Priorität 16 entspricht (niedrigste). Wenn ein solcher priorisierter Befehl vom API empfangen wird, werden alle in Absatz 19 im BACnet-Standard beschriebenen Aktionen stattfinden, indem interne Aktionen den priorisierten Befehl korrekt behandeln. Wenn die Benutzerapplikation Callbacks für die Propertys Present_value und Priority_Array registriert hat, wird sie über den aktuellen Befehlsstatus im Objekt informiert.

Objekt: Accumulator

Der Accumulator-Objekttyp definiert ein standardisiertes Objekt, dessen Propertys die extern sichtbaren Charakteristiken eines Geräts repräsentieren, welches durch Impulszählung durchgeführte Messungen anzeigt. Die Impulseingabe am Objekt kann entweder durch Hinzufügen der eigenen Property Prop_Pulse_Value_Source und Füllen derselben mit einer Referenz auf eine BINARY oder BOOLEAN Wertequelle erfolgen, oder durch Aufrufen der BACnet.BACnetServer.UpdateAccumulatorDataSourceValue-Funktion, die für jeden eingefügten BACnet-Server im CODESYS-Gerätebaum verfügbar ist. In jedem Fall wird das Toggeln von Werten vom Objekt gezählt und alle im BACnet-Standard definierten Property-Aktionen werden vom API durchgeführt. Die Prozedur des intrinsischen Reportings wird ebenfalls durch interne Aktionen in der API für dieses Objekt durchgeführt.

Objekt: Analog-Input

Der Objekttyp Analog-Input definiert ein standardisiertes Objekt, dessen Propertys die extern sichtbaren Charakteristiken eines physikalischen analogen Eingangs repräsentieren. Die Propertys Min_Pres_Val und Max_pres_Val, die die niedrigste und höchste Zahl in Engineering-Einheiten anzeigen, die zuverlässig für das Present_Value-Property dieses Objekts erreicht werden kann, erzeugen „value out of range“-Fehler, falls Present_Value außerhalb dieses Bereichs liegt. Auch die Werte der Propertys High_Limit, Low_Limit und Deadband werden überwacht, ob sie außerhalb dieses Bereichs geraten. Die optional vorhandene Property Resolution, die die kleinste erkennbare Änderung in Present_Value in Engineering-Einheiten angibt, beeinflusst die Einstellung der Present_Value-Property direkt und passt ihren Wert automatisch an. Die Change-Of-value-Reporting-Prozedur und die Prozedur für das intrinsische Reporting sind durch interne Aktionen der API für diesen Objekttype voll implementiert.

Objekt: Analog-Output

Der Objekttyp Analog-Output definiert ein standardisiertes Objekt, dessen Propertys die extern sichtbaren Charakteristiken eines physikalischen analogen Ausgangs repräsentieren. Alle Aktionen, die für das Analog-Input-Objekt implementiert sind, sind auch für diesen Objekttyp implementiert.

Objekt: Analog-Value

Der Objekttyp Analog-Value definiert ein standardisiertes Objekt, dessen Propertys die extern sichtbaren Charakteristiken eines analogen Werts repräsentieren. Ein „analog value“ ist ein Kontrollsystemparameter, der im Speicher des BACnet-Geräts liegt und hat kein physikalisches Gerät. Alle Aktionen, die für das Analog-Input-Objekt implementiert sind, sind auch für diesen Objekttyp implementiert.

Objekt: Averaging

Der Objekttyp Averaging definiert ein standardisiertes Objekt, dessen Propertys die extern sichtbaren Charakteristiken eines Werts repräsentieren, der periodisch über eine bestimmte Zeitspanne aufgezeichnet wird. Das Averaging-Objekt zeichnet den Minimum,- Maximum- und Durchschnittswert über die Zeitspanne auf und macht diese Werte als Propertys des Averaging-Objekts sichtbar. Der aufgezeichnete Wert kann der Wert irgendeines BOOLEAN, INTEGER, UNSIGNED, ENUMERATED oder REAL Propertys sein. Der Wert des über Object_Property_Reference referenzierten Objekts wird ermittelt und alle abhängigen Property-Werte, wie Minimum_Value, Maximum_Value, Average_Value und andere werden durch interne Aktionen im API aktualisiert.

Die gemeinsamen Property-Aktionen, die im API implementiert sind, gelten auch für weitere Objekte. Für weitere Informationen siehe: Implementierungsanforderungen bei Verwendung des derzeitigen BACnet API/Stacks