SF_RecipeWrite

Hilfeversion 1.1 / Ausgabedatum: 2023.03
Gültig für Funktionsbaustein SF_RecipeWrite, Version 1.0z (z = 0 bis 9).

Kurzbeschreibung Der Funktionsbaustein SF_RecipeWrite kann eine Rezeptur-Datei erzeugen oder verändern, indem er die Werte an seinen PayloadWrite-Eingängen schreibt. Nachdem er die Werte in den spezifizierten Datensatz (Dateisektion) der Rezeptur-Datei geschrieben hat, werden die gesamte Datei sowie der geschriebene Datensatz versiegelt und es werden Prüfsummen berechnet.

Bausteinsymbol

Eingänge Activate

Kurzbeschreibung Wert

Zustandsgesteuerter Eingang zur Aktivierung des Funktionsbausteins.
Datentyp: BOOL
Anfangswert: FALSE

FALSE: Funktionsbaustein inaktiv

TRUE: Funktionsbaustein aktiviert

Weitere Informationen hierzu finden Sie im Thema "Eingang Activate".

CommandWrite

Kurzbeschreibung Wert

Flankengesteuerter Eingang, der die Ausführung des Funktionsbausteins startet.
Datentyp: SAFEBOOL
Anfangswert: SAFEFALSE

SAFEFALSE: Es ist keine Schreiboperation angefordert.

SAFETRUE: Anforderung zum Schreiben der Daten in den Datensatz (die Dateisektion). Nachdem der Befehl erfolgreich ausgeführt wurde, steuert Done auf SAFETRUE.

Weitere Informationen hierzu finden Sie im Thema "CommandWrite".

IDRecipeFile

Kurzbeschreibung Wert

Eingang zum Spezifizieren der Kennung der Ziel-Datei, in welche die (an den PayloadWrite-Eingängen anliegenden) Daten geschrieben werden sollen.
Datentyp: SAFEINT
Anfangswert: 0
Wertebereich: 1 bis 8 Legen Sie hier die numerische Dateikennung an.

Weitere Informationen hierzu finden Sie im Thema "Eingang IDRecipeFile".

IDRecipeDataSet

Kurzbeschreibung Wert

Eingang zum Spezifizieren der Kennung des Datensatzes in der Ziel-Datei, in den die (an den PayloadWrite-Eingängen anliegenden) Daten geschrieben werden sollen.
Datentyp: SAFEINT
Gültige Werte: >= 1. Der obere Grenzwert hängt vom SPS-Typ ab.
Anfangswert: 0 Legen Sie hier die numerische Datensatzkennung an (innerhalb der durch IDRecipeFile adressierten Datei).

Weitere Informationen hierzu finden Sie im Thema "Eingang IDRecipeDataSet".

PayloadWrite** (mit ** = 0 bis 15)

Kurzbeschreibung Wert

Eingänge für die Werte, die in den adressierten Datensatz in der Rezeptur-Datei geschrieben werden sollen.
Datentyp: SAFEDWORD
Anfangswert: 0 Legen Sie hier Konstanten oder Variablen mit Werten an, die für Ihre sicherheitsbezogene Applikation geeignet sind.
Sie dürfen an diese Eingänge nur Werte anlegen, die den Ergebnissen Ihrer Risikoanalyse entsprechen.

Weitere Informationen hierzu finden Sie im Thema "PayloadWrite**".

Ausgänge Done

Kurzbeschreibung Wert

Ausgang zur Signalisierung "Abarbeitung des Funktionsbausteins abgeschlossen".
Datentyp: SAFEBOOL

SAFEFALSE:

Funktionsbaustein ist nicht aktiviert (Activate = FALSE), oder

die Operation des Funktionsbausteins ist noch nicht abgeschlossen, oder

der Funktionsbaustein konnte seine Operation aufgrund eines Fehlers nicht abschließen.

Beachten Sie...

... die detaillierte Beschreibung des Ausgangs Done (Link unter dieser Tabelle).

… den Wert, der am Ausgang DiagCode anliegt.

SAFETRUE:

Der Funktionsbaustein ist aktiviert (Activate = TRUE) und

der FB hat seine Operation erfolgreich beendet.

Weitere Informationen hierzu finden Sie im Thema "Ausgang Done".

DataSetCRC und FileCRC

Kurzbeschreibung Wert

Ausgänge für die Prüfsummen (CRCs), die der Funktionsbaustein über den Datensatz (die Dateisektion) bzw. die Datei berechnet hat, nachdem er die Datei geschrieben und versiegelt hat.
Datentyp: SAFEDWORD
Anfangswert: 0 Prüfsummen, die der FB berechnet hat.

Weitere Informationen hierzu finden Sie im Thema "Ausgänge DataSetCRC und FileCRC".

DiagCode

Kurzbeschreibung Wert

Ausgang für Diagnosemeldung.
Datentyp: WORD Diagnosemeldung des Funktionsbausteins.
Die möglichen Werte sind im Thema "Diagnose-Codes" aufgelistet und beschrieben.

Weitere Informationen hierzu finden Sie in den Themen "Ausgang DiagCode" und "Diagnose-Codes".

Detailinformationen Funktionsbaustein-Instanziierung

Die IEC 61131-3 definiert die Instanziierung von Funktionsbausteinen. Instanziieren bedeutet, dass ein Funktionsbaustein einmal definiert wird und dann mehrfach verwendet (instanziiert) werden kann. Dies gilt für alle Standard-FBs und sicherheitsbezogene FBs (sowohl lokale als auch FBs aus Firmware- und Anwenderbibliotheken).

Warum Instanziierung?
Ein Funktionsbaustein besitzt einen internen Speicher, in dem dieser die Arbeitsdaten (lokale Variablen) ablegt. Das bedeutet, die Ausgangswerte, die ein FB berechnet, hängen von den aktuellen intern gespeicherten Werten ab. Die gleichen Eingangswerte liefern deshalb bei verschiedenen FB-Instanzen nicht zwingend die gleichen Ausgangswerte.
Die internen Daten des Funktionsbausteins müssen daher für jeden Aufruf, d.h. für jede FB-Instanz, in einem getrennten Speicherbereich gehalten werden. Um jede FB-Instanz eindeutig identifizieren und ihren Speicherbereich separat halten zu können, werden Instanznamen verwendet. Der Instanzname eines FB muss in der 'Variablen'-Tabelle der POE deklariert werden, in welcher der FB verwendet werden soll.

Dabei gilt Folgendes:

Funktionsbausteine können in anderen Funktionsbausteinen und in Programm-POEs instanziiert werden. Der Aufruf eines FB in einer Funktion-POE ist nicht möglich.

Funktionen werden ohne Instanznamen aufgerufen, da sie keinen internen Speicher besitzen.

In PLCnext Engineer wird strikt zwischen sicherheitsbezogenem Code und (nicht-sicherheitsbezogenem) Standard-Code unterschieden. Wenn Ihr Projekt eine sicherheitsbezogene SPS enthält, gilt Folgendes:

Sicherheitsbezogene FBs können nur in sicherheitsbezogenen POEs instanziiert werden, aber nicht in (nicht-sicherheitsbezogenen) Standard-POEs.

Anwenderdefinierte Standard-FBs können nur in Standard-POEs instanziiert werden. Sie können nicht in sicherheitsbezogenen POEs aufgerufen werden.

Bestimmte Standard-Firmware-FBs können sowohl in sicherheitsbezogenen, als auch in Standard-POEs instanziiert werden.

Hinweis
Beim Einfügen eines Standard-FBs in ein sicherheitsbezogenes SNOLD-Netzwerk gelten die Regeln für die implizite Typumwandlung (von sicherheitsbezogen nach Standard).

Beispiel für die Instanziierung eines sicherheitsbezogenen Rezepturen-Funktionsbausteins

Der sicherheitsbezogene PLCopen-Funktionsbaustein SF_RecipeDeleteDataSet wurde über die Bibliothek 'RecipeFile' in das Projekt eingefügt. Er ist dann in der Kategorie 'Programmierung' des KOMPONENTEN-Bereichs verfügbar. Dort befindet sich ein Ordner mit demselben Namen wie die Bibliothek, aus dem sich die FBs in den sicherheitsbezogenen Code einfügen lassen.
Der FB soll im Code des sicherheitsbezogenen Programms 'S_Main' zweimal aufgerufen werden. Für jede FB-Instanz wurde in der Variablentabelle des aufrufenden Programms ein Instanzname deklariert: SF_RecipeDeleteDataSet1 und SF_RecipeDeleteDataSet2. Die zwei FB-Instanzen wurden in das Code-Arbeitsblatt eingefügt, wobei unterschiedliche Variablen an die Eingangs- und Ausgangs-Formalparameter der Instanzen angeschlossen sind.

Weitere Informationen finden Sie in folgenden Abschnitten:

Funktionsbeschreibung

Fehlervermeidung

Anwendungsfälle, Signalablauf-Diagramme & Anwendungsbeispiele

Diagnose-Codes des FB

Messung der CPU-Auslastung