FB_BACnet_EventMessageTextsProperty

FB_BACnet_EventMessageTextsProperty 1:

Anwendung

Mit Hilfe des Bausteins kann die Property Event_Message_Texts eines beliebigen BACnet Objekts ausgelesen werden. Der Eingang tObjectID legt dabei das Objekt fest (Object_Identifier: Objekt Type und Objekt Instanz), auf das zugegriffen werden soll. Unter Beispiel wird eine mögliche Beschaltung gezeigt.

Baustein intern wird zudem die Decodierung der Property anhand des String-Codings vorgenommen. Dabei werden folgende Property Encoding unterstützt: UTF-8, UCS2, UCS4 und ISO8859-1. Die Ausgabe-Strings im Array arrTexts liegen Windows-1252 codiert vor (siehe auch FB_BACnet_StringExtDecode). Tritt bei der Decodierung der Property ein Fehler auf, so wird dies am Ausgang nErrorId signalisiert.

Die Bausteininstanz wird im SPS Programm angelegt und zyklisch aufgerufen. Der Ein-/Ausgang stAdsConn muss mit dem Ausgang stAdsConn des entsprechenden Device-Bausteins (FB_BACnet_Device bzw. FB_BACnet_RemoteDevice) verbunden werden.

VAR_INPUT

tObjectID      : T_BACnet_ObjectIdentifier:=16#FFFFFFFF;
bAutoGet       : BOOL:=TRUE;
bGet           : BOOL;

 

tObjectID: Legt das Objekt fest (Object_Identifier: Objekt Type und Objekt Instanz) auf das zugegriffen werden soll.

bAutoGet: TRUE = Lese die Property automatisch aus, wenn die ADS Verbindung oder der Object_Identifier sich geändert haben. Eine ADS Verbindungsänderung liegt vor, wenn die Verbindung nach einem Unterbruch wiederhergestellt oder die AMS NetID bzw. Port geändert wurde. Ein automatisches Auslesen geschieht nicht zyklisch und auch nicht bei Änderung der Property selbst!

bGet: FALSETRUE = Property wird unabhängig vom Eingang bAutoGet einmalig ausgelesen.

 

VAR_OUPUT

bDone      : BOOL;
bBusy      : BOOL;
bError     : BOOL;
nErrorId   : UINT;
arrTexts   : ARRAY [0..2] OF T_MaxString;

 

bDone: Lesen der Daten erfolgreich beendet. bDone bleibt so lange gesetzt bis bGet und bAutoGet zurückgesetzt sind oder ein erneutes Auslesen beginnt. Wurde bGet und bAutoGet zurückgesetzt bevor bDone aktiv ist, dann wird bDone für einen Zyklus gesetzt.

bBusy: Der Baustein ist beschäftigt.

bError: Fehler während der Abarbeitung.

nErrorId: Fehlercode, siehe BACnet_Globals für eine Übersicht.

arrTexts: Meldetexte als Windows-1252 codierte Strings.

VAR_IN_OUT

stAdsConn      : ST_BACnet_AdsConnection;


stAdsConn:
Verknüpfung mit dem Ausgang stAdsConn des entsprechenden Device-Bausteins.

 

Beispiel

FB_BACnet_EventMessageTextsProperty 2:
Bild-1: Beispiel für die Verwendung. Zyklisches Lesen der Property Event_Message_Texts eines BACnet Analog Input Objekts (AnalogInput: 10).