1 Allgemein

BTF bietet unter anderem eine Möglichkeit die automatisierte Erstellung des EPICS Dokumentes für ein IUT zu unterstützen.

Nachfolgend werden die Einzelheiten zu den verwendeten Dateien und deren Nutzung beschrieben.

2 Dateiablage

Nach Installation des BTF ist folgendes Verzeichnis vorhanden:
Installation Directory\MBS\BTF\Documentation\SampleScripts\EPICS-Creator

In diesem Verzeichnis befinden sich die folgenden Dateien:

header.txt
Eine Vorlage für den EPICS-Header, der Informationen wie Herstellerangaben, unterstützte BIBBs, und mehr enthalten.

footer.txt
Enthält den Fußzeilenabschnitt der EPICS-Datei.

DeviceInfo.py
Speichert die Details des IUT Device.

EPICSCreator.py
Das Hauptprogramm Skript zur Erzeugung der EPICS-Datenbank aus dem IUT.

WildcardList.py
Liste aller Eigenschaften, die einen Wildcard-Wert haben dürfen. 

Restrictions.py
Gibt manuelle Werteinschränkungen für einzelne Eigenschaften an.

ReadMe.txt
Enthält die Vorgehensweise gemäß dieser Anleitung.

3 Dateiinhalte und deren Anpassung

Kopfzeilen-Datei (header.txt)
Die Header-Datei ist eine Vorlage, die an die spezifischen Details des IUT angepasst werden muss. Beispiele für solche Details sind Herstellerinformationen und unterstützte BIBBs. 

Geräteinformationen (DeviceInfo.py)
Diese Datei muss angepasst werden, um den spezifischen Details des IUT zu entsprechen.

Die wichtigsten Anpassungen, die in dieser Datei vorgenommen werden müssen, sind:

IUT IP Adresse und BACnet Port
IP Adresse und Port für das IUT müssen hier korrekt angegeben werden.

IUT Instanznummer
Die Instanznummer für das IUT muss hier korrekt angegeben werden.

Name der EPICS-Datei
Der gewünschte Name für die zu erzeugende EPICS-Datei. Dabei ist sicherzustellen, dass der Name nicht bereits im Verzeichnis vorhanden ist.

EPICSCreator-Datei (EPICSCreator.py)
Um das EPICS-Dokument zu erstellen, wird die Datei EPICSCreator.py ausgeführt. Das EPICS-Dokument wird unter dem Namen erstellt der in der Datei DeviceInfo.py angegeben ist.

4 Erstellprozess

Die vorbereiteten Dateien wirken bei der automatisierten Erstellung des EPICS Dokumentes zusammen. Der Erstellprozess beinhaltet hauptsächlich folgende Schritte:

Nach dem Entfernen der alten EPICS-Datei wird die Datei header.txt in die Ziel-EPICS-Datei kopiert.

 Die Objektliste wird vom IUT gelesen und für jedes Objekt in der Objektliste wird eine Funktion aufgerufen,

- um alle Eigenschaften zu scannen,

- den aktuellen Wert abzurufen,

- zu versuchen den Wert zurückzuschreiben (einfacher Schreibtest)

und

- die resultierende EPICS-Zeile in die EPICS-Datei zu drucken.

 Zum Abschluss des Prozesses wird die Datei footer.txt in die EPICS-Datei kopiert.

Details zum Skript
Die Skripte wurden in Python auf der Grundlage des BACnet Test Framework BACnet API erstellt.

Hinweis: Bevor das Skript ausgeführt wird ist sicherzustellen, dass keine bereits vorhandene EPICS Datei mit dem gleichen Namen vorhanden ist. Diese würde sonst überschrieben.