Skip to main content

Befehl: Parameter bearbeiten

Funktion: Im Dialog Parameter bearbeiten werden die konstanten Eingangsparameter eines Funktionsbausteins verwaltet.

Aufruf: Menü CFC → Parameter bearbeiten, Kontextmenü oder Klick auf Funktionsbausteinfeld Parameter

Voraussetzungen:

  • Ein CFC-Editor ist aktiv.

  • Ein Funktionsbaustein instanziert, der in seiner Deklaration VAR_INPUT CONSTANT-Variablen hat.

Funktionsbausteine mit VAR_INPUT CONSTANT-Variablen werden im Editor mit dem Wort Parameter in der linken unteren Bausteinecke dargestellt.

Anmerkung

Diese Funktionalität wirkt nur auf Bausteine, die mit CODESYS >= V3.5 SP4 in einen CFC eingefügt wurden.

Anmerkung

Nur der CFC-Editor verfügt für seine VAR_INPUT CONSTANT -Variablen über diese Funktionalität.

Im FUP-Editor zeigt CODESYS immer alle Eingangsparameter am Baustein an, egal ob sie als VAR_INPUT oder VAR_INPUT CONSTANT deklariert sind. Auch für Texteditoren unterscheidet CODESYS diesbezüglich nicht.

Dialog: Parameter bearbeiten

Parameter

Name der konstanten Eingangsvariablen

Beispiel: iConst

Wenn die Eingangsvariable mit dem Pragma {attribute 'parameterCategory':= '<category name>'} gekennzeichnet ist, wird die Variable kategorisiert: Sie wird unter der angegebenen Kategorie aufgelistet.

Datentyp

Datentyp der Variablen

Bei einem benutzerdefinierten Datentyp ist das der DUT-Name.

Beispiel: EXAMPLE

Wert

Übergabewerte an die Funktionsbaustein-Instanz

  • Manuell eingegebener Wert

    Anmerkung

    Der Wert muss mit dem Datentyp kompatibel sein.

    Bei Eingangsvariablen mit benutzerdefiniertem Datentyp STRUCT folgt der Übergabewert folgender Syntax: STRUCT( <name first component> := <value>, <name further components> := <value> ). Der Strukturname steht dabei unter Datentyp.

    Beispiel: STRUCT(x1:= TRUE, i1:=222, str1 := 'second')

  • Im Onlinebetrieb als "vorbereiteter Wert" automatisch ausgelesen. Dieser Wert wird in eckigen Klammern angezeigt.

  • Im Onlinebetrieb aus der Steuerung ausgelesen. Dieser Wert wird rot hinterlegt mit rotem Rahmen dargestellt

Tipp

Klicken Sie in das Feld, um gewünschte Werte einzugeben.

Initialwert

Initialwert aus der Deklaration

Min

Minimalwert aus der Deklaration, wenn die Variable mit dem Pragma {attribute 'parameterMinValue':= '<value>'} ausgezeichnet wurde

Max

Maximalwert aus der Deklaration, wenn die Variable mit dem Pragma {attribute 'parameterMaxValue':= '<value>'} ausgezeichnet wurde

Einheit

Einheit aus der Deklaration, wenn die Variable mit dem Pragma {attribute 'parameterUnit':= '<value>'} ausgezeichnet wurde

Beschreibung

Kommentar aus der Deklaration

Vorbereitete Parameter löschen

Löscht vorbereitete Werte, die in eckigen Klammern angezeigt werden

Sie können die Applikation im Onlinebetrieb laden/ausführen und währenddessen die Funktionsbaustein-Instanz mit Werten parametrieren: Geben Sie vorbereitete Werte für die Eingangsvariable ein und wählen Sie den Befehl Debug → Werte schreiben . Diese Werte werden als mögliche Übergabewerte dann hier bereitgestellt.

Tipp

Löschen Sie die vorbereiteten Werte, wenn Sie diese nicht verwenden wollen.

Anmerkung

Der Befehl wird aktiv, wenn Sie im Onlinebetrieb vorbereitete Werte auf die Variable geschrieben haben (Befehl Debug → Werte schreiben ).

Vorbereitete Parameter im Projekt speichern

Speichert die Übergabewerte/Parameter im Projekt, sodass sie beim nächsten Onlinebetrieb verwendet werden können.

Anmerkung

Der Befehl wird aktiv, wenn Sie im Onlinebetrieb Werte geschrieben/geforcet haben und zurück im Offlinebetrieb sind.

Schließen

Übernimmt die konfigurierten Werte und schließt den Dialog

Beispiel 5. Funktionsbaustein FB_Test
TYPE EXAMPLE :
STRUCT
    x1 : BOOL;
    i1 : INT;
    str1 : STRING;
END_STRUCT
END_TYPE

TYPE COLOR :
(
	yellow,
	green,
	blue,
	black
) // Basic data type is INT, default initialization for all COLOR_BASIC variables is yellow
;
END_TYPE


FUNCTION_BLOCK FB_Test

VAR_INPUT CONSTANT
	xConst  : BOOL := FALSE; // Boolean value
	{attribute 'parameterCategory':='General'}
	{attribute 'parameterUnit':= 'm/s'}
	{attribute 'parameterMinValue':= '0'}
	{attribute 'parameterMaxValue':= '100'}
	iConst	: INT := 0; // Integer
	strConst : STRING := 'Hello World'; // String
	exampleConst : EXAMPLE := (x1 := TRUE, i1 := 1, str1 := 'first'); // STRUCT
	colorConst : COLOR := yellow; // ENUM
END_VAR

VAR_OUTPUT
END_VAR

VAR
END_VAR

;

PROGRAM PLC_PRG
VAR

	xStart : BOOL;
	fbTest	: FB_Test;

END_VAR
Abbildung 1. Implementation
Implementation


Abbildung 2. Dialog mit Parameter von fbTest
Dialog mit Parameter von fbTest




In diesem Abschnitt: