Implementierung von Logging-Objekten (Event-Log, Trend-Log, Trend-Log-Multiple)
Für die Objekttypen Event-Log, Trend-Log and Trend-Log-Multiple wird vom BACnet Stack/API keine vollständige Implementierung ihrer Funktionalitäten bereitgestellt, weil das Speichern von geloggten Daten möglicherweise sehr hardware-spezifisch ist und deshalb sehr wahrscheinlich von der jeweiligen Anwenderapplikation implementiert wird. Dennoch ist das mögliche Verhalten der Logging-Objekte in der API vorimplementiert, so dass grundsätzlich nur das Aufnehmen und Lesen der Trenddaten in der Anwenderapplikation implementiert werden muss.
A. Implementierung von Datenaufzeichnung für Logging-Objekte
Jedes Logging-Objekt verwendet sein Log_Buffer-Property für das Speichern der aufgenommenen Daten. Da auf dieses Property nur über den ReadRange-Service zugegriffen (und somit auf Einhaltung des BACnet-Standards getestet) werden kann, ist es nicht nötig, sich um seine interne (Anwenderapplikation) Darstellung zu sorgen. Deshalb handhabt das BACnet Stack/API den Log_Buffer so, als wäre es nur 1 Aufzeichnung lang und schreibt die eingehenden Aufzeichnungen in diese einzige Aufzeichnung wann immer nötig (z.B. wenn das geloggte Objekt neue Daten produziert). Deshalb ist es für das Implementieren einer sauberen Aufzeichnung der geloggten Daten ausreichend, die Schreib-Events auf die Log_Buffer-Property einzufangen und die eingehenden Einzelaufzeichnungen konsequent zu speichern.
Zu diesem Zweck können Sie das Write-Callback des BACnet Stack/API verwenden. Dieser Callback wird immer aufgerufen, wenn das Property eines Objekts geschrieben wird (unter der Annahme, dass der Callback des Objekts mit Funktion BACnet.BACnetObjectBase.SetPropertyCallbackAttachment aktiviert wurde, die Teil jedes BACnet-Objekt-FBs in CODESYS ist). Das Eintragen eines solchen Write-Callback erfolgt sehr ähnlich zum Eintragen eines Service Hooks, mit dem einzigen Unterschied, dass eine andere Eintragefunktion verwendet wird. Wieder können ein (oder zwei) CallbackFB, die die Schnittstelle IBACnetEventConsumer implementieren, mit Hilfe der Funktion RegisterCallback des BACnetServer-FBs eingetragen werden:
BACnetServer.RegisterCallback(CmpBACnet.IEC_BACNET_CALLBACK_TYPE.BACNET_CALLBACK_WRITE, CallbackFB, 0);
Die entsprechende Funktion BACnetEventCallback im CallbackFB kann nun implementiert werden, um die Aufzeichnung, die mit den Callback-Daten (EVT_BACNET_WRITEPROPERTYCALLBACK) bei jedem Aufruf mitkommen. Wenn Sie die Implementierung vornehmen, stellen Sie sicher, dass Sie nach der korrekten Objekt-ID und der korrekten Property-ID für die Callback-Daten filtern, so dass Sie sicher sein können, ausschließlich Aufzeichnungsdaten in das Log_Buffer eines Logging-Objekts zu schreiben.
B. Implementierung des Datenlesens für Logging-Objekte
Wie vorher erwähnt, kann die Log_Buffer-Property eines Logging-Objekts nur unter Verwendung des ReadRange-Services ausgelesen werden. Somit reicht es aus, für die Implementierung des Datenlesens für die Logging-Objekten den ReadRange Service Hook zu implementieren.
Der ReadRange Service Hook kann auf gleiche Weise implementiert werden wie Beispiel CreateObject Service Hook, Implementierungsbeispiel für CreateObject beschreibt. Das heißt Eintragen eines CallbackFB zum entsprechenden Hook (RegisterHook). Innerhalb der BACnetEventCallback-Funktion dieses CallbackFB können Sie dann nach der korrekten Objekt-ID und Property-ID filtern und die korrekten Service-Daten erhalten (EVT_BACNET_READRANGE).
Innerhalb des ReadRange-Hooks müssen exakt die Daten zurückgegeben werden (abhängig von der angegebenen Objekt-ID), die zuvor im Write-Callback aufgezeichnet wurden (siehe A). Dabei muss der ReadRange-Hook für das Aussortieren von Daten sorgen, abhängig von den angeforderten Aufzeichnungsnummern und Aufzeichnungszeitstempeln.
C. Kommentare
Die in A. und B. beschriebene Prozedur gilt für alle Logging-Objekte, d.h. Event-Log-Objekt, Trend-Log-Objekt und Trend-Log-Multiple-Objekt. Dabei ist es nicht nötig, sich um irgendwelche Objekt-Aktionen bezüglich Propertys zu kümmern. Es müssen nur der Write-Callback-Hook für das Speichern der Daten und der ReadRange-Hook für das Wiederauslesen dieser Daten implementiert werden.
Für weitere Informationen siehe: Implementierungsanforderungen bei Verwendung des derzeitigen BACnet API/Stacks