FB_BA_RdShdObjLst

Mit Hilfe dieses Bausteines lassen sich Daten für Verschattungsobjekte aus einer vordefinierten Excel-Tabelle im csv-Format in die Liste der Verschattungsobjekte importieren. Zusätzlich werden die importierten Daten auf Plausibilität überprüft und Fehler in eine Log-Datei geschrieben.

Das folgende Beispiel zeigt die Excel-Tabelle mit den Einträgen der Fensterelemente.
Alle Textfelder sind frei beschreibbar. Wichtig sind die grün markierten Felder, jede Zeile dort kennzeichnet einen Datensatz. Je nachdem ob es sich um den Typ Viereck oder Kugel handelt, haben die Spalten G bis J eine unterschiedliche Bedeutung. Die Spalten K bis M sind bei Kugeln freizulassen. Bezüglich der Vierecks-Koordinaten werden nur die relevanten Daten eingegeben und die restlichen intern berechnet, siehe FB_BA_ShdObjEntry.
Folgende Regeln sind zu beachten:

• Ein Datensatz muss immer mit einem '@' beginnen.
• Die Monatseinträge dürfen nicht 0 und größer 12 sein, alle anderen Kombinationen sind möglich.
  Beispiele:
  Beginn=1, Ende=1: Verschattung im Januar.
  Beginn=1, Ende=5: Verschattung von Anfang Januar bis Ende Mai.
  Beginn=11, Ende=5: Verschattung von Anfang November bis Ende Mai (des folgenden Jahres).
• Fensterbreite und Fensterhöhe müssen größer Null sein
• Die z-Koordinaten P1z und P3z bzw. Mz müssen größer Null sein.
• Der Radius muss größer Null sein.
• Die Gesamtgröße der Tabelle darf systembedingt 65534 Bytes nicht überschreiten.
• Die Tabelle muss in Excel als Dateityp "CSV (Trennzeichen-getrennt) (*.csv)" abgespeichert worden sein.

Es ist nicht notwendig, alle Verschattungsobjekte, welche pro Fassade möglich sind, zu beschreiben. Nur die, die in der Liste aufgeführt werden, kommen letztendlich zum Tragen.

Log-Datei

Bei jedem Start des Lesebausteines wird die Logdatei neu beschrieben und der alte Inhalt gelöscht. Ist die Log-Datei nicht vorhanden, so wird sie zunächst automatisch erstellt. Die Log-Datei enthält dann entweder eine OK Meldung oder eine Auflistung aller aufgetretenen Fehler. Fehler, welche mit dem Öffnen, Beschreiben oder Schließen der Logdatei selbst in Zusammenhang stehen, können nicht mitgeschrieben werden. Daher ist immer auch der Ausgang sErrDescr des Lesebausteines zu beachten, der den letzten Fehlercode anzeigt. Da im Ablauf des Lesens die Log-Datei immer als Letztes geschlossen wird, ist ein entsprechender Hinweis im Fehlerfall gewährleistet.

Programmbeispiel

In diesem Beispiel wird bei PLC-Start die Variable bInit zunächst auf TRUE gesetzt. Damit erhält der Eingang bStt am Baustein fbReadShadingObjects einmalig eine steigende Flanke, welche den Lesevorgang auslöst. Gelesen wird die Datei "ShadingObjects.csv", welche sich im Ordner "C:∖Projekte∖" befindet. In demselben Ordner wird dann die Logdatei "Logfile.txt" hinterlegt. Ist diese Logdatei noch nicht vorhanden wird sie erstellt, andernfalls wird der bestehende Inhalt überschrieben. Das Lesen und Schreiben erfolgt auf demselben Rechner, auf dem sich auch die PLC befindet. Das wird durch den Eingang sNetID = '' (=lokal) definiert. Alle Daten werden in die im Programm deklarierte Liste arrShdObj geschrieben. Während gelesen und geschrieben wird ist der Ausgang bBusy auf TRUE. Der zuletzt auftretende Fehler in Bezug auf das Dateihandling wird an sErrDescr angezeigt, bErr steht dann auf TRUE. Wird hingegen ein Fehler im Datensatz erkannt, wird dies an bErrDataSet angezeigt und in der Log-Datei näher beschrieben. Die Anzahl der gefundenen und gelesenen Datenzeilen wird an udiAmtSetsRd zur Kontrolle angezeigt.

In die folgende Excel Liste wurden die markierten Fehler eingebaut. Dadurch ergibt sich das gezeigte Log-File:

Der erste Fehler ist im Datensatz 3 und ein Typ-Fehler, da "2" nicht definiert ist.
Der nächste Fehler in Datensatz 6 wurde nach Validierung der Daten mit dem intern genutzten Baustein FB_BA_ShdObjEntry gefunden und daher näher mit einer Fehlerbeschreibung versehen. Der dritte Fehler trat ebenfalls nach der internen Validierung auf.

Wichtig hierbei ist, dass sich die Datensatz-Nummer (hier 11) nicht nach der eingetragenen Nummer in der Liste, sondern nach der tatsächlichen laufenden Nummer richtet: eingelesen wurden hier lediglich 16 Datensätze.

VAR_INPUT

bStt      : BOOL;
sDataFile : STRING;
sLogFile  : STRING;
sNetId    : T_AmsNetId;;

bStt: Eine TRUE-Flanke an diesem Eingang startet den Lesevorgang.

sDataFile: Enthält den Pfad- und Dateinamen der zu öffnenden Daten-Datei. Diese muss in Excel als Dateityp "CSV (Trennzeichen-getrennt) (*.csv)" abgespeichert worden sein. Wird die Datei mit einem einfachen Text-Editor geöffnet, so müssen die Werte durch Semikola getrennt dargestellt sein. Beispiel für einen Eintrag: sDataFile:= 'C:∖Projects∖ShadingObjects.csv'

sLogFile: dto. Log-File für die auflaufenden Fehler. Diese Datei wird bei jeder neuen Bausteinaktivierung überschrieben, so dass nur aktuelle Fehler enthalten sind.

sNetId: Hier kann ein String mit der AMS Net Id des TwinCAT-Rechners angegeben werden, auf dem die Dateien geschrieben/gelesen werden sollen. Für den lokalen Rechner kann auch ein Leerstring angegeben werden (siehe T_AmsNetId).

Die Speicherung der Daten kann nur auf dem Steuerungsrechner selbst und den Rechnern erfolgen, die mit dem Steuerungsrechner per ADS verbunden sind. Verweise auf lokale Festplatten dieser Rechner sind möglich, nicht jedoch auf verbundene Netzwerkfestplatten.

VAR_OUTPUT

bBusy        : BOOL;
udiAmtSetsRd : UDINT;
bErr         : BOOL;
sErrDescr    : T_MAXSTRING;
bErrDataSet  : BOOL;

bBusy: Dieser Ausgang steht auf TRUE, solange Elemente aus der Datei ausgelesen werden.

udiAmtSetsRd: Anzahl der gelesenen Datensätze.

bErr: Dieser Ausgang wird auf TRUE geschaltet, wenn ein Datei-Schreib- bzw. Lesefehler aufgetreten ist.

sErrDescr: Enthält die Fehlerbeschreibung.

bErrDataSet: Dieser Ausgang wird auf TRUE geschaltet, wenn die gelesenen Datensätze fehlerhaft sind. Nähere Einzelheiten werden in die Log-Datei geschrieben.

VAR_IN_OUT

arrShdObj: ARRAY[1..Param.uiMaxShdObj] OF ST_BA_ShdObj;

arrShdObj: Liste der Verschattungsobjekte.

Voraussetzungen