AR_MGT

Typ	Funktionsbaustein
Beschreibung	Mit dem Funktionsbaustein können Sie Profinet-Applikationsbeziehungen (Application Relationship - AR) aus dem laufenden Applikationsprogramm heraus starten bzw. stoppen. Die auszuführende Aktion wird über den Parameter CMD eingestellt. Der Funktionsbaustein wird ausgeführt, wenn REQ = TRUE ist. Die Applikationsbeziehung (AR) wird durch den Stationsnamen identifiziert, der im 'Einstellungen'-Editor für das in der ANLAGE ausgewählte Profinet-Gerät angezeigt wird. Nach erfolgreicher Ausführung des Funktionsbausteins wird der Ausgang DONE auf TRUE gesetzt. Der Ausgang STATUS zeigt den aktuellen internen Zustand des Funktionsbausteins und der Ausgang RESULT den aktuellen Zustand der Applikationsbeziehung (AR) an. Tritt während der Ausführung des Funktionsbausteins ein Fehler auf, wird ERROR auf TRUE gesetzt. Der zugehörige Fehlercode wird am Ausgang STATUS angezeigt.
Hinweise	Funktionsbausteine dieses Typs müssen instanziiert werden. Der FB-Instanzname muss in der 'Variablen'-Tabelle der POE deklariert werden, in welcher der FB verwendet werden soll. Der Instanzname muss innerhalb der POE eindeutig sein. Die maximal erlaubte Anzahl von gleichzeitig aktivierten Funktionsbausteininstanzen ist durch die maximale Anzahl von ARs für den Controller festgelegt.
Parameter	Eingänge REQ Datentyp: BOOL Beschreibung: Wenn REQ = TRUE ist, wird der Funktionsbaustein ausgeführt. Die Ausgänge werden entsprechend aktualisiert. Nach Ausführung des Funktionsbausteins muss der REQ-Eingang auf FALSE gesetzt werden, um den Funktionsbaustein erneut ausführen zu können. Die Ausgänge werden zurückgesetzt. CMD Datentyp: DWORD Beschreibung: Auszuführende Aktion. Folgende Befehle werden unterstützt: Befehl Wert (hex) Aktion AR_MGT_NO_COMMAND 0x0000 Keine Aktion. Der Funktionsbaustein bleibt solange im Status IDLE, bis ein anderer Befehl abgesetzt wird. AR_MGT_GET_STATE 0x0001 Der Funktionsbaustein ruft den aktuellen Status der Applikationsbeziehung (AR) im Profinet-Stack ab. AR_MGT_START_AR 0x0002 Der Funktionsbaustein startet die angeforderte Applikationsbeziehung (AR). Die Applikationsbeziehung muss in der aktuellen Profinet-Konfiguration des Projekts verfügbar sein. AR_MGT_STOP_AR 0x0003 Der Funktionsbaustein stoppt die angeforderte Applikationsbeziehung (AR). Die Applikationsbeziehung muss in der aktuellen Profinet-Konfiguration des Projekts verfügbar sein. Ein-/Ausgang STAT_NAME Datentyp: ANY Beschreibung: Für den Parameter STAT_NAME muss der anwenderdefinierte Datentyp NAMESTRING verwendet werden. Deklaration des Datentyps NAMESTRING: TYPE     NAMESTRING : STRING(255); END_TYPE NAMESTRING hat eine Länge von 255 Zeichen. Er dient zur Angabe des Stationsnamens des Profinet-Gerätes. Laut Profinet-Spezifikation darf der Stationsname eines Profinet IO-Gerätes maximal 240 Zeichen lang sein. Die restlichen Zeichen in NAMESTRING dürfen nicht verwendet werden. Soll ein anderer anwenderdefinierter Datentyp verwendet werden, muss dieser ebenfalls eine Länge von 255 Zeichen haben, da sonst die Prüfung des Datentyps im Firmware-Funktionsbaustein einen Fehler meldet. Ausgänge DONE Datentyp: BOOL Beschreibung: Rückgabewert, ob der Funktionsbaustein ausgeführt wurde. 0   Der Funktionsbaustein wurde nicht ausgeführt. 1   Der Funktionsbaustein wurde ausgeführt. Der neue Wert wird am Ausgang RESULT ausgegeben. BUSY Datentyp: BOOL Beschreibung: Zeigt an, ob der Funktionsbaustein gerade ausgeführt wird. 0   Der Funktionsbaustein wird nicht ausgeführt. 1   Der Funktionsbaustein wird gerade ausgeführt. ERROR Datentyp: BOOL Beschreibung: Bei einem Fehler wird der Ausgang ERROR auf TRUE gesetzt. Der Ausgang STATUS zeigt den Fehlercode an. STATUS Datentyp: DWORD Beschreibung: Interner Zustand des Funktionsbausteins, wenn kein Fehler aufgetreten ist. Im Fehlerfall wird der Fehlerwert angezeigt. Eine Beschreibung der Fehlercodes finden Sie am Ende dieses Themas. RESULT Datentyp: DWORD Beschreibung: Zeigt den aktuellen Status der Applikationsbeziehung (AR) an. AR-Status Wert (hex und dez) Beschreibung AR_STATUS_ADDED 0x00000001 (1 dez) Die Applikationsbeziehung (AR) wird hinzugefügt aber nicht gestartet. Dieser Status ist für Applikationsbeziehungen gültig, die gestoppt wurden. AR_STATUS_STARTED 0x0000002 (2 dez) Die AR wurde hinzugefügt und gestartet. Die Verbindung wird aufgebaut. Dieser Status trifft beispielsweise zu, wenn ein Profinet IO-Gerät im Projekt konfiguriert wurde, dieses aber im Feld nicht verfügbar oder nicht erreicht werden kann. AR_STATUS_STARTED -> AR_STATUS_WAIT_FOR_DCP_IDENTIFY_IND -> AR_STATUS_STARTED AR_STATUS_WAIT_FOR_DCP_IDENTIFY_IND 0x00000007 (7 dez) Siehe AR_STATUS_STARTED AR_STATUS_APP_READY 0x00000019 (25 dez) Die Applikationsbeziehung (AR) ist vollständig hergestellt und aktiv. Nach Verwendung des Befehls AR_MGT_START_AR bzw. AR_MGT_STOP_AR werden am Ausgang RESULT eventuell andere Werte als AR_STATUS_ADDED, AR_STATUS_STARTED und AR_STATUS_APP_READY angezeigt. Um den Status einer Applikationsbeziehung (AR) nach Ausführung eines Befehls zu überprüfen, muss der Funktionsbaustein AR_MGT für die betreffende AR mit AR_MGT_GET_STATE aufgerufen werden. Eine gestoppte Applikationsbeziehung (AR) wird aus den ARs entfernt, welche die "BF"-LED ansteuern. Die "BF"-LED beginnt deshalb nicht zu blinken. Leuchtet die "BF"-LED nicht und eine Applikationsbeziehung (AR) wird gestoppt, kann die LED eventuell kurz aufleuchten, bleibt dann aber dauerhaft aus. Eine (neu) gestartete Applikationsbeziehung (AR) wird zu den ARs hinzugefügt, welche die "BF"-LED ansteuern. Hinweis Wird der Befehl AR_MGT_STOP_AR bzw. AR_MGT_START_AR verwendet, wird die Einstellung für 'LED BF aktivieren' im Editor 'Einstellungen' des Profinet-Geräts im PLCnext Engineer-Projekt überschrieben.
Fehlercodes	Fehlercodes am Ausgang STATUS Fehlercode (hex) Bedeutung 0x0000 Kein Fehler aufgetreten. 0xF001 Zu viele Instanzen verwendet. 0xF002 Fehler beim Initialisieren des Funktionsbausteins. 0xF003 Ungültige ID. 0xF004 Ungültiges HANDLE/ID. 0xF005 Ressourcenkonflikt. 0xF006 Ein bausteininterner Task konnte nicht erzeugt werden. 0xF007 Zu viele Instanzen verwendet. 0xF008 Ungültiger Parametertyp. 0xF009 Ungültiger Parameterwert. 0xF00A Nicht erlaubter Parameter. 0xF00B Ungültige Länge. 0xF00C ID konnte nicht erzeugt werden (zu viele IDs). 0xF00D Kein Eintrag gefunden, der zur angegebenen ID passt. 0xF00F Keine weiteren Einträge gefunden. 0xF010 Eintrag in Verwendung. 0xF011 Alarmbestätigung konnte nicht ausgeführt werden. 0xF012 Auslesen der AR-Parameter nicht möglich (1. Versuch). 0xF013 Negative Bestätigung für die Ausführung eines Profinet-Dienstes erhalten. 0xF014 Ungültige Länge im Parameter LEN/MLEN oder/und Datensatz im Ein-/Ausgang RECORD zu klein. 0xF015 Der Dienst zum Lesen des Datensatzes am Ein-/Ausgang RECORD konnte nicht ausgeführt werden. 0xF016 Der Dienst zum Schreiben des Datensatzes am Ein-/Ausgang RECORD konnte nicht ausgeführt werden. 0xF017 Eine Dienstbestätigung ist ausgeblieben. 0xF018 Der INDEX für den Zugriff auf den Datensatz am Ein-/Ausgang RECORD auf dem Profinet IO-Gerät ist ungültig, z.B. INDEX größer als 0x7FFF. 0xF019 Unbekannter Befehlscode. 0xF01A Fehler beim Starten der Applikationsbeziehung (AR). 0xF01B Fehler beim Stoppen der Applikationsbeziehung (AR). 0xF01C Benachrichtigung über gestoppte Applikationsbeziehung (AR) fehlgeschlagen. 0xF01D Das Flag "BF ansteuern" konnte nicht gesetzt werden. 0xF01E Auslesen der AR-Parameter nicht möglich (2. Versuch).