FB_BA_FcdElemEntry

Funktionsbescheibung

Die Deklaration der Fassadenelemente erfolgt in den globalen Variablen als zweidimensionales Feld über die Fensterspalten (Columns) und -reihen (Rows):

VAR_GLOBAL
     arrFcdElem : ARRAY[1..gBA_cMaxColumnFcd, 1..gBA_cMaxRowFcd] OF ST_BA_FcdElem;
END_VAR

Jedes einzelne Element arrFcdElem[x,y] trägt die Informationen für jeweils ein Fassadenelement (ST_BA_FcdElem). Dazu gehören die Gruppenzugehörigkeit, die Abmessungen (Breite, Höhe) und die Koordinaten der Eckpunkte. Der Baustein greift dabei über die IN-OUT-Variable arrFcdElem direkt auf dieses Feld zu.

Anmerkung: Die Tatsache, dass die Koordinaten der Eckpunkte C2 bis C4 Ausgangswerte sind, ergibt sich daraus, dass sie aus den Eingabeparametern gebildet werden und für die Verwendung in einer Visualisierung zur Verfügung stehen sollen:

Alle Angaben [m]!

lrCnr2X = lrCnr1X
lrCnr2Y = lrCnr1Y + lrWdwHght (Fensterhöhe)
lrCnr3X = lrCnr1X + lrWdwWdth (Fensterbreite)
lrCnr3Y = lrCnr2Y
lrCnr4X = lrCnr1X + lrWdwWdth (Fensterbreite)
lrCnr4Y = lrCnr1Y

Die Verwendung des Bausteins erfolgt in drei Schritten:

• Auslesen
• Ändern
• Schreiben

Auslesen

Mit den Einträgen an iColumn und iRow wird das entsprechende Element aus der Liste, arrFcdElem[iColumn,iRow], ausgewählt. Eine steigende Flanke an bRd liest folgende Daten aus dem Listenelement aus:

• usiGrp Gruppenzugehörigkeit,
• lrCnr1X X-Koordinate des Eckpunktes1 [m]
• lrCnr1Y Y-Koordinate des Eckpunktes1 [m]
• lrWdwWdth Fensterbreite [m]
• lrWdwHght Fensterhöhe [m]

Diese werden dann den entsprechenden Eingangsvariablen des Bausteins zugewiesen, der daraus nach dem oben erläuterten Zusammenhang die Koordinaten der Eckpunkte C2-C4 als Ausgangsvariablen errechnet. Wichtig ist hierbei, dass im Schritt des Auslesens die Eingangswerte nicht überschrieben werden. So lassen sich alle Werte zunächst in einer Visualisierung anzeigen.

Ändern

In einem nächsten Programmschritt können dann die aufgeführten Eingabewerte verändert werden. Die eingegebenen Werte werden dabei ständig auf Plausibilität überprüft. Der Ausgang bErr zeigt an, ob die Werte gültig sind (bErr=FALSE). Sollte dies nicht der Fall sein, wird am Ausgang udiErrId/udiErrArg ein entsprechender Fehlercode ausgegeben. Siehe auch unten "Fehler (bErr=TRUE)".

Schreiben

Mit einer positiven Flanke an bWrt werden die parametrierten Daten in das Listenelement mit dem Index nId geschrieben, unabhängig davon, ob sie gültige Werte darstellen oder nicht. Daher ist innerhalb der Elementstruktur ST_BA_FcdElem ebenfalls ein Plausibilitätsbit bVld vorhanden, das genau diese Information an den Baustein FB_BA_ShdCorr weiterreicht und dort Fehlberechnungen vorbeugt.

Diese Vorgehensweise soll nur als Vorschlag angesehen werden. Es ist natürlich auch möglich, den Baustein ganz normal in einem Schritt zu parametrieren und die eingetragenen Werte mit einer steigenden Flanke an bWrt in das entsprechende Listenelement zu schreiben.

Fehler (bErr=TRUE)

Der Baustein FB_BA_ShdCorr, welcher beurteilt, ob alle Fenster einer Gruppe verschattet sind, wird nur dann seine Aufgabe ausführen, wenn alle Fenster der betrachteten Gruppe gültige Einträge haben.
Das bedeutet:

• usiGrp muss größer als 0 sein
• lrCnr1X muss größer oder gleich 0.0 sein
• lrCnr1Y muss größer oder gleich 0.0 sein
• lrWdwWdth muss größer als 0 sein
• lrWdwHght muss größer als 0 sein

Ist eines dieser Kriterien nicht erfüllt, so wird dies als Falscheingabe interpretiert und der Fehlerausgang bErr am Bausteinausgang von FB_BA_FcdElemEntry gesetzt. Innerhalb des Fensterelementes ST_BA_FcdElem wird das Plausibilitätsbit bVld auf FALSE gesetzt.
Sind hingegen alle Einträge eines Fassadenelementes Null, wird es als gültiges, gewollt ausgelassenes Fassadenelement angesehen:

Bei einer Fassade von 6x4 Fenstern wären hier die Elemente Fenster (2,1), Fenster (3,5) und Fenster (4,4) Leerelemente.

VAR_INPUT

iColumn      : INT;
iRow         : INT;
bWrt         : BOOL;
bRd          : BOOL;
usiGrp       : USINT;
lrCnr1X      : LREAL;
lrCnr1Y      : LREAL;
lrWdwWdth    : LREAL;
lrWdwHght    : LREAL;

iColumn: Spalten-Index des gewählten Elementes auf der Fassade. Dies bezieht sich auf die Auswahl eines Feldelementes des unter der IN-OUT-Variablen arrFcdElem angelegten Arrays.

iRow: dto. Reihen-Index. und dürfen nicht Null sein!iRowiColumn Das ergibt sich aus der Felddefinition, welche jeweils mit 1 beginnt, siehe oben.

bRd: Mit einer positiven Flanke an diesem Eingang werden die Informationen des gewählten Elementes, arrFcdElem[iColumn,iRow] in den Baustein gelesen und den Eingangsvariablen usiGrp bis lrWdwHght zugewiesen. Daraus ergeben sich dann die Ausgangsvariablen lrCnr2X bis lrCnr4Y. Sind zu Zeitpunkt des Auslesens schon Daten an den Eingängen usiGrp bis lrWdwHght angelegt, so werden die zuvor ausgelesenen Daten sofort mit diesen überschrieben.

bWrt: Eine positive Flanke schreibt die eingegebenen sowie errechneten Werte in das gewählte Feldelement arrFcdElem[iColumn,iRow].

usiGrp: Gruppenzugehörigkeit.

lrCnr1X: X-Koordinate des Eckpunktes1 [m].

lrCnr1Y: Y-Koordinate des Eckpunktes1 [m].

lrWdwWdth: Fensterbreite [m].

lrWdwHght: Fensterhöhe [m].

VAR_OUTPUT

lrCnr2X   : LREAL;
lrCnr2Y   : LREAL;
lrCnr3X   : LREAL;
lrCnr3Y   : LREAL;
lrCnr4X   : LREAL;
lrCnr4Y   : LREAL;
bErr      : BOOL;
udiErrId  : UDINT;
udiErrArg : UDINT;

lrCnr2X: Ermittelte X-Koordinate des Eckpunktes 2 des Fensters [m]. Siehe "Anmerkung" oben.

lrCnr2Y: Ermittelte Y-Koordinate des Eckpunktes 2 des Fensters [m]. Siehe "Anmerkung" oben.

lrCnr3X: Ermittelte X-Koordinate des Eckpunktes 3 des Fensters [m]. Siehe "Anmerkung" oben.

lrCnr3Y: Ermittelte Y-Koordinate des Eckpunktes 3 des Fensters [m]. Siehe "Anmerkung" oben.

lrCnr4X: Ermittelte X-Koordinate des Eckpunktes 4 des Fensters [m]. Siehe "Anmerkung" oben.

lrCnr4Y: Ermittelte Y-Koordinate des Eckpunktes 4 des Fensters [m]. Siehe "Anmerkung" oben.

bErr : Ergebnis Kontrolle für die eingegebenen Werte.

udiErrId / udiErrArg: Enthält die Fehlernummer und das Fehlerargument. Siehe Fehlercodes.

VAR_IN_OUT

arrFcdElem : ARRAY[1..gBA_cMaxColumnFcd, 1..gBA_cMaxRowFcd] OF ST_BA_FcdElem;

arrFcdElem: Liste von Fassadenelementen.

Voraussetzungen