Skip to main content

Zugriff auf BACnet-Objekte und ihre Propertys

Jeder Funktionsbaustein eines als „Gerät“ im Projektbaum eingefügten BACnet-Objekts leitet vom Funktionsbaustein BACnetStaticObjectBase (Bibliothek BACnet) und damit von BACnetObjectBase ab.

BACnetObjectBase bietet damit für jeden BACnet-Objekt-Funktionsbaustein die Möglichkeit über die allgemeine Funktion SetPropertyInstance beliebige BACnet-Propertys zu verändern.

Die Daten des zu setzenden BACnet-Propertys werden SetPropertyInstance in Form der Struktur IEC_BACNET_PROPERTY_CONTENTS übergeben. Diese Struktur beinhaltet neben einer Enumeration, die den Datentyp beschreibt, auch einen Buffer, der einen POINTER TO BYTE auf die tatsächlichen BACnet-Property-Daten besitzt. Damit ist es möglich beliebige BACnet-Property-Datenstrukturen innerhalb der IEC_BACNET_PROPERTY_CONTENTS Struktur zu übergeben. Der angegebene Datentyp definiert dabei, auf welche Strukturen oder Daten der Puffer zeigt.

Die Daten und der Datentyp müssen sich gemäß der folgenden Tabelle entsprechen.

IEC_BACNET_DATA_TYPE

CODESYS Datentyp (Struct)

DATA_TYPE_BOOLEAN

IEC_BACNET_BOOLEAN

DATA_TYPE_UNSIGNED

IEC_BACNET_UNSIGNED I

DATA_TYPE_SIGNED

EC_BACNET_SIGNED XX

DATA_TYPE_REAL

IEC_BACNET_REAL

DATA_TYPE_DOUBLE

IEC_BACNET_DOUBLE

DATA_TYPE_OCTET_STRING

IEC_BACNET_OCTET_STRING

DATA_TYPE_CHAR_STRING

IEC_BACNET_STRING

DATA_TYPE_BIT_STRING

IEC_BACNET_BIT_STRING

DATA_TYPE_ENUMERATED

IEC_BACNET_SIGNED

DATA_TYPE_DATE

IEC_BACNET_DATE

DATA_TYPE_TIME

IEC_BACNET_TIME

DATA_TYPE_OBJECT_IDENTIFIER

IEC_BACNET_OBJECT_ID

DATA_TYPE_PRI_ARRAY_ITEM

IEC_BACNET_PRIORITY_ARRAY_ITEM

DATA_TYPE_ADDRESS

IEC_BACNET_ADDRESS

DATA_TYPE_DATE_TIME

IEC_BACNET_DATE_TIME

DATA_TYPE_OBJ_PROP_REFERENCE

IEC_BACNET_OBJ_PROP_REFERENCE

DATA_TYPE_PROPERTY_STATES

IEC_BACNET_PROPERTY_STATES

DATA_TYPE_EVENT_PARAMETER

IEC_BACNET_EVENT_PARAMETER

DATA_TYPE_DATE_RANGE

IEC_BACNET_DATE_RANGE

DATA_TYPE_WEEK_N_DAY

IEC_BACNET_WEEK_AND_DAY

DATA_TYPE_CALENDAR_ENTRY

IEC_BACNET_CALENDAR_ENTRY

DATA_TYPE_TIME_VALUE

IEC_BACNET_TIME_VALUE

DATA_TYPE_SPECIAL_EVENT

IEC_BACNET_SPECIAL_EVENT

DATA_TYPE_RECIPIENT

IEC_BACNET_RECIPIENT

DATA_TYPE_SETPOINT_REFERENCE

IEC_BACNET_SETPOINT_REFERENCE

DATA_TYPE_DESTINATION

IEC_BACNET_DESTINATION

DATA_TYPE_DAILY_SCHEDULE

IEC_BACNET_DAILY_SCHEDULE

DATA_TYPE_TIME_STAMP

IEC_BACNET_TIME_STAMP

DATE_TYPE_PROPERTY_REFERENCE

IEC_BACNET_PROPERTY_REFERENCE

DATA_TYPE_ADDRESS_BINDING

IEC_BACNET_ADDRESS_BINDING

DATA_TYPE_DEV_OBJ_PROP_REFERENCE

IEC_BACNET_DEV_OBJ_PROP_REFERENCE

DATA_TYPE_CLIENT_COV

IEC_BACNET_CLIENT_COV

DATA_TYPE_LOG_RECORD

IEC_BACNET_LOG_RECORD

DATA_TYPE_ACTION_LIST

IEC_BACNET_ACTION_LIST

DATA_TYPE_READ_ACCESS_SPEC

IEC_BACNET_READ_ACCESS_SPEC

DATA_TYPE_READ_ACCESS_RESULT

IEC_BACNET_READ_ACCESS_RESULT

DATA_TYPE_COV_SUBSCRIPTION

IEC_BACNET_COV_SUBSCRIPTION

DATA_TYPE_DEV_OBJ_REFERENCE

IEC_BACNET_DEV_OBJ_REFERENCE

DATA_TYPE_DEV_OBJ_PROP_VALUE

IEC_BACNET_DEV_OBJ_PROP_VALUE

DATA_TYPE_ACCUMULATOR_RECORD

IEC_BACNET_ACCUMULATOR_RECORD

DATA_TYPE_PRESCALE

IEC_BACNET_PRESCALE

DATA_TYPE_SCALE

IEC_BACNET_SCALE

DATA_TYPE_EVENT_LOG_RECORD

IEC_BACNET_EVENT_LOG_RECORD

DATA_TYPE_LOG_RECORD_MULTIPLE

IEC_BACNET_LOG_RECORD_MULTIPLE

DATA_TYPE_SHED_LEVEL

IEC_BACNET_SHED_LEVEL

DATA_TYPE_AUTHENTICATION_POLICY

IEC_BACNET_AUTHENTICATION_POLICY

DATA_TYPE_AUTHENTICATION_FACTOR

IEC_BACNET_AUTHENTICATION_FECTOR

DATA_TYPE_CREDENTIAL_AUTHENTICATION_FACTOR

IEC_BACNET_CREDENTIAL_AUTHENTICATION_FACTOR

DATA_TYPE_ACCESS_RULE

IEC_BACNET_ACCESS_RULE

DATA_TYPE_ASSIGNED_ACCESS_RIGHTS

IEC_BACNET_ASSIGNED_ACCESS_RIGHTS

DATA_TYPE_AUTHENTICATION_FACTOR_FORMAT

IEC_BACNET_AUTHENTICATION_FACTOR_FORMAT

DATA_TYPE_OPTIONAL_CHAR_STRING

IEC_BACNET_OPTIONAL_STRING

DATA_TYPE_PROPERTY_ACCESS_RESULT

IEC_BACNET_PROPERTY_ACCESS_RESULT

DATA_TYPE_VT_SESSION

IEC_BACNET_VT_SESSION

DATA_TYPE_SESSION_KEY

IEC_BACNET_SESSION_KEY

DATA_TYPE_NETWORK_SECURITY_POLICY

IEC_BACNET_NETWORK_SECURITY_POLICY

DATA_TYPE_KEY_IDENTIFIER

IEC_BACNET_KEY_IDENTIFIER

DATA_TYPE_SECURITY_KEY_SET

IEC_BACNET_SECURITY_KEY_SET

DATA_TYPE_NEW_STANDARD

IEC_BACNET_RAW_ASN1_VALUE

DATA_TYPE_PROPRIETARY

IEC_BACNET_RAW_ASN1_VALUE

DATA_TYPE_EXTENDED

IEC_BACNET_RAW_ASN1_VALUE

DATA_TYPE_RAW_ASN1_VALUE

IEC_BACNET_RAW_ASN1_VALUE

Für einige häufig verwendete Datentypen bietet der Basis-Funktionsbaustein BACnetObjectBase Hilfsfunktionen (SetBACnetRealProperty, SetBACnetBooleanProperty, etc.).

Beispiel 604. Beispiel für korrekt verwendete IEC_BACNET_PROPERTY_CONTENTS
METHOD SetBACnetRealProperty
VAR_INPUT
        propID: CmpBACnet.IEC_BACNET_PROPERTY_ID;
        rVal : REAL;
END_VAR
VAR
        BACreal : CmpBACnet.IEC_BACNET_REAL := 0.0;
        conts : CmpBACnet.IEC_BACNET_PROPERTY_CONTENTS := ( tag := CmbBACnet.IEC_BACNET_DATA_TYPE.DATA_TYPE_REAL,
                                                                                                                nElements := 1,
                                                                                                                buffer := ( nBufferSize := SIZEOF(LREAL), pBuffer := ADR(BACreal) ),
                                                                                                                rawBuffer := ( nBufferSize := 0, pBuffer :=0) );
END_VAR
BACreal := rVal;
SetPropertyInstance(propID, -1, conts);

Dieser Code setzt ein BACnet-Property vom Typ REAL auf den Wert 0.0.



Entsprechend, um im allgemeinsten Fall BACnet-Propertys auszulesen, bietet der Funktionsbaustein BACnetObjectBase die Funktion GetPropertyInstance. Hier können Sie innerhalb der Struktur IEC_BACNET_PROPERTY_CONTENTS entweder einen mit dem korrekten Datentyp vorinitialisierter Puffer übergeben, der dann befüllt wird; oder einen Puffer der Größe 0, der automatisch initialisiert wird, den Sie dann aber mit Hilfe der Funktion FreeStackAllocatedMemory nach der Benutzung wieder freigeben müssen.

Unabhängig von diesem allgemeinen Fall stehen für die häufigsten Fälle Hilfsfunktionen bereit. Außerdem gibt es für die am häufigsten verwendeten BACnet-Propertys je BACnet-Objekt-Funktionsbaustein jeweils eine Auswahl an Funktionsbaustein-Propertys, die den direkten Zugriff erlauben.