{CustomImplementation}

Diese Anweisung macht den Baustein zum Vendor-Baustein, der für eine Bibliothek verwendet werden soll.
Aufgrund dieser Anweisung bezeichnet logi.cals die Vendor-Bausteine in C-Code auch als CustomImpl-Bausteine in der Umgangssprache.

Diese Anweisung hat die folgenden Auswirkungen:

• logi.CAD 3 legt keine C- und H-Datei im Unterordner src-gen an (wie es logi.CAD 3 automatisch machen würde). Stattdessen benötigt logi.CAD 3 die entsprechenden Dateien im Unterordner src-code (parallel zum ST-Objekt mit der Schnittstelle). Eine Anleitung finden Sie im Artikel "Details: Vendor-Baustein erstellen".
  

• Falls Sie den Vendor-Baustein in einer Bibliothekskonfiguration angeben, werden die H- und C-Dateien standardmäßig automatisch in die Bibliothek integriert. Falls die Bibliothek mit dem Vendor-Baustein bereitgestellt wird, ist es nicht möglich, eine Bibliotheksvariante für den Vendor-Baustein zu erstellen.

Falls Sie eine C-Datei verwenden wollen, geben Sie in der Anweisung { ImplementationProperties ( ) } zusätzlich die Definition functionHasCFile an. Weitere Informationen finden Sie weiter unten.

{CustomImplementation, CustomNameSpace := Name}

CustomNameSpace := Name ist ein optionaler Teil, mit dem Sie den Code für den Baustein besser identifizieren können

Beachten Sie: logi.cals empfiehlt die Verwendung der NAMESPACE ... END_NAMESPACE-Anweisungen für die Vendor-Baustein-Schnittstelle zu verwenden, um mögliche Konflikte mit anderen Bausteinen zu vermeiden. Siehe "Namespaces in ST" für Details zu diesen Anweisungen.
Falls Sie die NAMESPACE ... END_NAMESPACE-Anweisungen nicht verwenden wollen/können, fügen Sie am besten den Teil CustomNameSpace := Name hinzu. Damit ist es nicht möglich, Konflikte mit anderen Bausteinen zu vermeiden. Da aber der Name, der bei CustomNameSpace vergeben wird, in den Dateinamen der H-/C-Datei und in den H-/C-Code selbst einfliesst, ist es Ihnen möglich, den Code für den Vendor-Baustein besser zu identifizieren zu können.

Der Name, der bei der optionalen Definition implementationName innerhalb der Anweisung { ImplementationProperties ( ) } vergeben wird (siehe unten für weitere Informationen), fliesst ebenfalls in den Dateinamen der H-/C-Datei ein.

loc := "orientation"

bestimmt die Ausrichtung der angegebenen Variablen
Möglicher Wert für orientation: left, right, top oder bottom
Falls diese E/A-Definition fehlt, wird der Standardwert verwendet: left für Eingäng, right für Ausgänge
Beachten Sie:

• Bei einer Ein-/Ausgangsvariable können Sie nur die Position ändern, aber nicht die Ausrichtung. Grund: Der Eingangsanschlusspunkt einer Ein-/Ausgangsvariablen darf nur auf der linken Bausteinkante positioniert werden, der Ausgangsanschlusspunkt wird automatisch auf der gegenüberliegenden Position der rechten Bausteinkante positioniert.

• Es ist nicht möglich, die Position oder Ausrichtung eines Ergebniswerts der Funktion im Schnittstellen-Editor zu ändern.

index := #

bestimmt die Position der angegebenen Variablen
Möglicher Wert für #: ein ganzzahliger Wert, beginnend mit 0
Fehlt diese E/A-Definition, wird die nächste freie Position für die Position verwendet.

Befindet sich die Variable außerhalb von height und width und fehlt die Definition expandableGUI, wird ein Aufruf des Bausteins, der in den FBS-Editor eingefügt wird, automatisch so vergrößert, dass der Aufruf alle Variablen enthält.

altName := "name"

bestimmt den alternativen Namen der angegebenen Variablen

height := #

bestimmt die Höhe des Bausteins, falls der Baustein in den FBS-Editor eingefügt wird
Möglicher Wert für #: ein ganzzahliger Wert – Falls keine Höhe angegeben wird, wird die Höhe des Bausteins automatisch berechnet.

width := #

bestimmt die Breite des Bausteins, falls der Baustein in den FBS-Editor eingefügt wird
Möglicher Wert für #: ein ganzzahliger Wert – Falls keine Breite angegeben wird, wird die Breite des Bausteins automatisch berechnet.

minHeight := #

bestimmt die Minimumhöhe des Bausteins – Nach dem Einfügen des Bausteins in den FBS-Editor kann der Baustein bis zu der angegebenen Minimumhöhe verkleinert werden.
Möglicher Wert für #: ein ganzzahliger Wert

maxHeight := #

bestimmt die Maximumhöhe des Bausteins – Nach dem Einfügen des Bausteins in den FBS-Editor kann der Baustein bis zu der angegebenen Maximumhöhe vergrößert werden.
Möglicher Wert für #: ein ganzzahliger Wert

minWidth := #

bestimmt die Minimumbreite des Bausteins – Nach dem Einfügen des Bausteins in den FBS-Editor kann der Baustein bis zu der angegebenen Minimumbreite verkleinert werden.
Möglicher Wert für #: ein ganzzahliger Wert

maxWidth := #

bestimmt die Maximumbreite des Bausteins – Nach dem Einfügen des Bausteins in den FBS-Editor kann der Baustein bis zu der angegebenen Maximumbreite vergrößert werden.
Möglicher Wert für #: ein ganzzahliger Wert

minInputs := #

bestimmt die Anzahl der Eingänge, die für die ordnungsgemäße Funktion des Vendor-Bausteins erforderlich sind
Möglicher Wert für #: ein ganzzahliger Wert

Eine Warnung wird ausgegeben, falls ein Bausteinaufruf in einen Editor eingefügt wird und im FBS-Editor zu wenig Eingänge des Bausteinaufrufs beschaltet sind oder im ST-Editor zu wenig Parameter für den Bausteinaufruf angegeben sind. Um die Warnung zu vermeiden, müssen Sie die erforderliche Anzahl von Eingängen oder zumindest den letzten Eingang beschalten oder angeben.
Im Falle von minInputs := 3 müssten Sie die ersten 3 Eingänge oder zumindest den 3. Eingang beschalten, um die Warnung zu vermeiden. Die Beschaltung des 3. Eingangs ist ausreichend, da logi.CAD 3 den nicht-beschaltete Eingängen der Standardausgangswert zuweist.

Falls Sie diese Definition angeben, fügen Sie am besten die Definition expandableGUI auch ein. Die Definition expandable innerhalb der Anweisung { ImplementationProperties ( ) } könnte ebenfalls erforderlich sein (siehe unten für weitere Informationen).

fixedSize

bewirkt, dass der Baustein eine feste Größe hat
Falls ein Aufruf des Bausteins in einen FBS-Editor eingefügt wird, wird der Aufruf mit einer festen Größe (= die angegebene Höhe und Breite) eingefügt. Es ist nicht möglich, den Baustein zu verkleinern oder zu vergrößern.

In der Folge werden die Angaben für minHeight, maxHeight, minWidth und maxWidth ignoriert. Stattdessen werden nur die Angaben für height und width berücksichtigt.

hideIONames

verbirgt die Namen der Eingänge, Ausgänge, Ein-/Ausgänge und den Ergebniswert einer Funktion

hideOutputOfVarInOut

für Ein-/Ausgangsvariablen (= VAR_IN_OUT) angewendet, sodass Folgendes gilt:

logi.CAD 3 zeigt die Schnittstelle des Bausteins wie in logi.CAD/32 an. Das bedeutet, dass nur d er Eingangsanschlusspunkt der Ein-/Ausgangsvariablen in logi.CAD 3 angezeigt wird. Außerdem ist es möglich, dass andere Variablen auf der gegenüberliegenden Position des Eingangsanschlusspunkt angezeigt werden .
Siehe die Systemblöcke MOVE_2D_ARRAY und SEL_2D_ARRAY (in der Systembibliothek Standard bereitgestellt) für die Verwendung dieser Einstellung.

Diese Einstellung wird automatisch übernommen, falls ein Baustein mit Ein-/Ausgangsvariablen von logi.CAD/32 nach logi.CAD 3 migriert wird. Der Schnittstellen-Editor bietet für diese Schnittstellenanweisung kein passendes GUI-Element.

altName := "name"

bestimmt den alternativen Namen für den Baustein

vNameAlignment := "value"

bestimmt die vertikale Ausrichtung des Bausteinnamens (oder des alternativen Namens für den Baustein)
Möglicher Wert für value:

• top: Der Name wird am oberen Rand der Schnittstelle angezeigt, aber oberhalb des ersten möglichen Eingangs, Ausgangs, Ein-/Ausgangs oder .
  

• baseline: Der Name wird am oberen Rand der Schnittstelle angezeigt, aber an der gleichen vertikalen Position wie der erste mögliche Eingang, Ausgang, Ein-/Ausgang oder EN/ENO (= auf der Grundlinie).
  

• center: Der Name wird in der Mitte der Schnittstelle angezeigt.

• bottom: Der Name wird am unteren Rand der Schnittstelle angezeigt.

Siehe die folgenden Beispiele für die Ausrichtung.
Fehlt diese Definition, wird der Standardwert center verwendet.

bgColor := "value"

bestimmt die Hintergrundfarbe des Bausteins
Möglicher Wert für value: ein Farben-Name laut https://www.w3schools.com/cssref/css_colors.asp

logi.cals empfiehlt, dass Sie und/oder Ihr Systemintegrator keine Gelb-Farbtöne bei der Gestaltung von FBS-Elementen verwenden, da " Gelb" für die Verfolgung von sicheren Signale beim Entwickeln von sicherheitsrelevanten Anwendungen verwendet wird. logi.CAD 3 prüft nicht, ob Farben bereits anderweitig verwendet werden. Die Verwendung von Gelb-Farbtönen durch Sie und/oder Ihren Systemintegrator könnte also zur Folge haben, dass "Gelb" dann auch eine nicht-sichere Logik kennzeichnet.

fgColor := "value"

bestimmt die Farbe des Bausteintextes; Mögliche Werte: siehe die Hintergrundfarbe des Bausteins

iofgColor := "value"

bestimmt die Farbe der Eingänge, Ausgänge, Ein-/Ausgänge und des Ergebniswertes einer Funktion; Mögliche Werte: siehe Hintergrundfarbe des Bausteins

expandableGUI

bestimmt, dass der Vendor-Baustein ein erweiterbarer Baustein ist, d.h. er kann um zusätzliche Ein-/Ausgänge erweitert werden ( falls der Baustein vergrößert wird)
Diese zusätzlichen Ein-/Ausgänge müssen sich auf einer Position zwischen der Minimumhöhe/-breite und der Maximumhöhe/-breite des Bausteins befinden. Ein eingefügter Aufruf wird nicht automatisch so vergrößert, dass alle Variablen angezeigt werden.

pageSize := "valuexvalue"

bestimmt die Seitengröße, falls die FBS-Logik im grafischen FBS-Editor angezeigt wird.
Diese Schnittstellen-Definition ist für die Schnittstelle der Vendor-Bausteine nicht relevant.

instanceName := {definitions};

bestimmt das Layout des Instanznamens für eine Funktionsbaustein-Instanz
Beispiel: instanceName := {visible, position := "manual", x := 0, y := 20, width := 300, height := 20, bgColor := "beige", fgColor := "black", border};
Mögliche Definitionen sind:

• visible: bewirkt, dass der Instanzname angezeigt wird; Ohne dieser Definition wird der Instanzname nicht angezeigt.
  Die Anweisung instanceNameVisible wurde in logi.CAD 3-Versionen < 2.9.0 verwendet und wird nicht mehr unterstützt.
  

• position: bestimmt, ob der angezeigte Instanzname oberhalb des oberen Bausteinrandes oder innerhalb der Schnittstelle angezeigt wird; Mögliche Werte:: top oder manual

• x und y: bestimmt, wo der Instanzname innerhalb der Schnittstelle angezeigt wird (wird nur bei position := "manual"; ausgewertet); Mögliche Werte sind Ganzzahl-Werte. Ohne dieser Definitionen wird der Instanzname beginnend in der linken oberen Ecke angezeigt.
  

• width und height: bestimmt die Breite und Höhe für den angezeigten Instanznamen (wird nur bei position := "manual"; ausgewertet); Mögliche Werte sind Ganzzahl-Werte. Ohne dieser Definitionen wird die Standardgröße verwendet.
  Falls der Platz nicht ausreicht, um den kompletten Instanznamen anzuzeigen, wird der Instanzname abgeschnitten.
  

• bgColor: bestimmt die Hintergrundfarbe für den angezeigten Instanznamen; Mögliche Werte: siehe Hintergrundfarbe des Bausteins

• fgColor: bestimmt die Textfarbe für den angezeigten Instanznamen; Mögliche Werte: siehe Hintergrundfarbe des Bausteins

• border: bewirkt, dass der Instanzname mit einem Rahmen angezeigt wird; Ohne dieser Definition wird kein Rahmen angezeigt.
  

• alignment: bestimmt die Ausrichtung des Instanznamens; Ohne dieser Definition wird der Instanzname so ausgerichtet, wie wenn der Wert centered angegeben wird.
  Mögliche Werte für alignment: top-left, top-center, top-right, center-left, center, center-right, bottom-left, bottom-center oder bottom-right
  

valueFields := {definitions};

fügt Wertfelder für Eingänge innerhalb der Schnittstelle hinzu und bestimmt das Layout dieser Wertfelder
Beispiel für 2 Wertfelder: valueFields := {{x := 60, y := 0, width := 160, height := 19, variable := "in1", initValue := "5"}, {x := 90, y := 20, width := 80, height := 39, variable := "in2", initValue := "10", fgColor := "black", border}};
Mögliche Definitionen sind:

• x und y: bestimmt, wo das Wertfeld angezeigt wird; Mögliche Werte sind Ganzzahl-Werte.
  

• width und height: bestimmt die Breite und Höhe für das Wertfeld; Mögliche Werte sind Ganzzahl-Werte.
  

• variable: legt fest, für welchen Eingang das Wertfeld gültig ist; Mögliche Werte sind Ganzzahl-Werte.

• initValue: bestimmt den Inhalt des Wertfelde; Mögliche Werte sind Literale gemäß dem Datentyp der jeweiligen Eingangs.

• fgColor: entspricht der gleichlautenden Definition für den Instanznamen

• border: entspricht der gleichlautenden Definition für den Instanznamen

• alignment: entspricht der gleichlautenden Definition für den Instanznamen; Ohne dieser Definition wird der Text innerhalb des Wertfeldes so ausgerichtet, als ob der Wert centered-left angegeben ist.
  

commentFields := {definitions};

fügt Kommentarfelder innerhalb der Schnittstelle hinzu und bestimmt das Layout dieser Kommentarfelder
Beispiel für 2 Kommentarfelder: commentFields := {{x := 40, y := 110, width := 200, height := 19, text := "comment 1", fgColor := "black", bgColor := "beige", border}, {x := 110, y := 150, width := 190, height := 19, text := "comment 2"}};Mögliche Definitionen sind:

• x und y: bestimmt, wo das Kommentarfeld angezeigt wird; Mögliche Werte sind Ganzzahl-Werte.
  

• width und height: bestimmt die Breite und Höhe für das Kommentarfeld; Mögliche Werte sind Ganzzahl-Werte.

• text: bestimmt den Inhalt des Kommentarfelds

• fgColor: entspricht der gleichlautenden Definition für den Instanznamen

• bgColor: entspricht der gleichlautenden Definition für den Instanznamen

• border: entspricht der gleichlautenden Definition für den Instanznamen

• alignment: entspricht der gleichlautenden Definition für den Instanznamen; Ohne dieser Definition wird der Text innerhalb des Kommentarfeldes so ausgerichtet, als ob der Wert centered-left angegeben ist.
  

{REQUIRES_NON_TEMP_VALUE}

definiert, dass temporäre Werte nicht mit der entsprechenden Ein-/Ausgangsvariable (VAR_IN_OUT) verbunden werden dürfen.
Siehe das folgende Beispiel.

{
  description := "string";
  comment := "string";
  customDataJson := 'Json-String';
  concreteType := data-type;
}

gibt die folgenden zusätzlichen Daten (= Datenelemente) für die Variable an:

• eine Beschreibung (auch als Langname bezeichnet)

• ein Kommentar

• eine JSON-Zeichenkette

• einen konkreten Datentypen für die Instanz eines anderen Vendor-Funktionbausteins, der Eingänge mit einem →allgemeinen Datentyp enthält
  Die Anweisung concreteType ist unbedingt erforderlich, damit beim Erstellen der Anwendung die nötigen Typisierungsinformation zum Vendor-Funktionbaustein mit den ANY-Eingängen vorhanden ist.
  

Siehe "Beschreibung, Kommentar, JSON-String oder Typ für Variablen oder Datentypen angeben" für Details.

{ DoNotValidateThisFile ('') }

ignoriert den gesamten Inhalt des aktuellen ST-Objekts
logi.CAD 3 empfiehlt Ihnen, diese Anweisung nur für automatisch erzeugte ST-Objekte zu verwenden. Wenn Sie diese Anweisung trotzdem am Anfang einer manuell erstellten Schnittstelle einfügen, erhalten Sie keine Meldungen wegen fehlerhaften Anweisungen.

Siehe "Anweisung zum Ignorieren von ST-Objekten" für Details zu dieser Anweisung.

{ AccessLevel := Private|Public }

Derzeit wird diese Anweisung nicht für die Verwendung innerhalb von Vendor-Bausteinen unterstützt.
Die Anweisung { AccessLevel := ...} wird automatisch von logi.CAD 3 für eine POE in einer Bibliothek erzeugt, da die POE in einer Bibliothekskonfiguration angegeben ist.

{suppressWarning modelRuleNamespace.modelRuleId('reason for suppression'), scope:=element|file}

Derzeit wird diese Anweisung nicht für die Verwendung innerhalb von Vendor-Bausteinen unterstützt.

Siehe "Anweisung zum Unterdrücken von Warnungen" für Details zu dieser Anweisung.