GET_MODULE_DIFF_BLOCK

Typ Funktionsbaustein

Beschreibung Mit dem Funktionsbaustein können Modul-Differenzblöcke (ModuleDiffBlock) für Profinet Devices gelesen werden. Ein ModuleDiffBlock liefert Informationen über die Differenz zwischen der echten Hardware-Konfiguration und der erwarteten Konfiguration (Konfiguration aus dem Engineering Tool) sowie Diagnoseinformationen.
Das Lesen der Blöcke wird bei einer steigenden Flanke am Eingang REQ gestartet. Eine steigende Flanke am Ausgang NEW zeigt an, dass neue Differenzblöcke vorhanden sind.

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.

Parameter Eingänge
REQ

Datentyp: BOOL

Beschreibung: Mit REQ = TRUE wird der Funktionsbaustein ausgeführt und die Ausgänge werden entsprechend aktualisiert.
Nach erfolgreichem Ausführen des Funktionsbausteins muss REQ auf FALSE gesetzt werden, um den FB erneut auszuführen. Die Ausgänge werden mit einer fallenden Flanke an REQ zurückgesetzt.

AR_USER_ID

Datentyp: WORD

Beschreibung: Application Relation (AR) User ID des Profinet Device.

Ein-/Ausgang
MODULE_DIFF_BLOCK

Datentyp: ANY

Beschreibung: Struktur für eine Moduldifferenz. Es kann auch ein Array der Struktur enthalten, so dass mehrere Module in einem Zyklus abgefragt werden können.
(Siehe hierzu die unten stehende Beschreibung der Struktur.)

Ausgänge
DONE

Datentyp: BOOL

Beschreibung: Zeigt an, ob der Funktionsbaustein erfolgreich ausgeführt wurde.
TRUE: Funktionsbaustein wurde fehlerfrei ausgeführt. Der Ausgang NEW zeigt an, ob ein neuer Differenzblock anliegt.
FALSE: Bei der Ausführung des Funktionsbausteins ist ein Fehler aufgetreten (ERROR = TRUE). Der Ausgang STATUS zeigt den Fehlercode an.

BUSY

Datentyp: BOOL

Beschreibung: Zeigt an, ob der Funktionsbaustein gerade ausgeführt wird und auf Antwort vom Profinet Controller wartet. Der Ausgang bleibt TRUE, solange der Funktionsbaustein ausgeführt wird.
TRUE: Funktionsbaustein wird ausgeführt und wartet auf Antwort der Firmware.
FALSE: Funktionsbaustein wurde ausgeführt. Die Ausgänge DONE und ERROR zeigen an, ob der Baustein erfolgreich ausgeführt wurde oder nicht.

ERROR

Datentyp: BOOL

Beschreibung: Zeigt an, ob bei der Ausführung des Funktionsbausteins ein Fehler aufgetreten ist.
TRUE: Fehler aufgetreten. Der Ausgang STATUS zeigt den Fehlercode an.
FALSE: Kein Fehler aufgetreten.

STATUS

Datentyp: DWORD

Beschreibung: Interner Zustand des Bausteins. Nur gültig, wenn ERROR = TRUE. Die Beschreibung der möglichen Fehlercodes finden Sie am Ende der Bausteinbeschreibung.

NEW

Datentyp: BOOL

Beschreibung: Eine steigende Flanke am Ausgang NEW zeigt an, dass neue Moduldifferenzen vorhanden sind. Wenn TRUE, wird der Ausgang auch auf FALSE zurückgesetzt wenn REQ auf FALSE wechselt.

MORE_AVAILABLE

Datentyp: BOOL

Beschreibung: TRUE: Es sind weitere Moduldifferenzen für die AR vorhanden. Diese können mit einer neuen steigenden Flanke an REQ abgefragt werden.
FALSE: Es sind keine weiteren Moduldifferenzen für die AR vorhanden.

MODULE_DIFF_BLOCK-Inhalt Struktur MODULE_DIFF_BLOCK

Strukturelement Datentyp Beschreibung

AR_USER_ID WORD AR User ID des Profinet Device

API DWORD Application Process Identifier

SLOT WORD Steckplatznummer des Moduls

IDENT_NUMBER DWORD Modul-Identifikation

STATE WORD Modulstatus (siehe hierzu die unten stehende Beschreibung der möglichen Werte)

SUBMODULE_COUNT WORD Anzahl der Submodule des Moduls

SUBMODULES ARRAY[0..63] OF SUBMODULE Siehe unten

Struktur SUBMODULE

Strukturelement Datentyp Beschreibung

NODE_ID DWORD Node ID des Submoduls

SUBSLOT WORD Subslotsteckplatznummer des Submoduls

IDENT_NUMBER DWORD Submodul-Identifikation

STATE WORD Submodulstatus (siehe hierzu die unten stehende Beschreibung der möglichen Werte)

ModuleState-Werte

Das Blockelement STATE in der Struktur MODULE_DIFF_BLOCK beschreibt den Modulstatus. Es kann folgende Werte enthalten:

Wert Beschreibung

0x0000 Kein Modul (z.B. Modul nicht gesteckt).

0x0001 Falsches Modul gesteckt (z.B. falsche Modul-Identifikation).

0x0002 Modul is korrekt, aber mindestens ein Submodul is verriegelt, falsch oder fehlt.

0x0003 Modul ist nicht das geforderte Modul. Das IO Device ist in der Lage, sich an das Modul anzupassen.

SubmoduleState-Werte

Das bit-kodierte Blockelement STATE in der Struktur SUBMODULE beschreibt den Submodulstatus. Es enthält mehrere Informationen, die durch das Verknüpfen mit verschiedenen Bitmasken ausgelesen werden müssen.

Beispiel: Durch Verknüpfen der Bitmaske 0x0010 mit dem Wert wird Bit 4 (MaintenanceRequired) ausgelesen (siehe folgende Tabelle).

Auswertung des Formatanzeigers (FormatIndicator, Bit 15)
Die Bedeutung der Bits des SubmoduleState-Werts hängt vom Wert des Formatanzeigers (Bit 15) ab. Dabei gilt Folgendes:

Bit 15 (0x8000) = 1: SubmoduleState besteht aus SubmoduleState.IdentInfo, SubmoduleState.ARInfo und SubmoduleState.AddInfo.

Bit 15 = 0: SubmoduleState enthält unformatierte Detailinformationen.

SubmoduleState

Bit Bitmaske Beschreibung

0 - 2 0x0007 Ergänzende Informationen (AddInfo)

0 Keine weiteren Informationen. Keine der für dieses Feld definierten Optionen sind aktiviert.

1 Übernahme ist nicht erlaubt. Das Submodul ist nicht für die Übernahme durch IO Supervisor AR geeignet.

2 - 7 Reserviert

3 0x0008 Abgestufte Diagnose (QualifiedInfo)

0 Keine abgestufte Diagnose für dieses Submodul verfügbar.

1 Für dieses Submodul ist mindestens eine abgestufte Diagnose verfügbar.

4 0x0010 Wartungsanforderung (MaintenanceRequired)

0 Keine Wartungsanforderung für dieses Submodul vorhanden.

1 Für dieses Submodul ist mindestens eine Wartungsanforderung vorhanden.

5 0x0020 Wartungsbedarf (MaintenanceDemanded)

0 Kein Wartungsbedarf für dieses Submodul vorhanden.

1 Für dieses Submodul ist mindestens ein Wartungsbedarf vorhanden.

6 0x0040 Diagnose (DiagInfo)

0 Kein Diagnosedaten für dieses Submodul vorhanden.

1 Diagnosedaten für dieses Submodul vorhanden. Die Daten können mit den entsprechenden Datensätzen (Records) oder IDiagnosisQueryService gelesen werden.

7 - 10 0x0780 AR Info (ARInfo)

0 AR ist Besitzer des Submoduls.

1 AR Pending AR ist Besitzer des Submoduls, aber das Submodul ist gesperrt (z.B. wegen anstehender Parameterüberprüfung).

2 AR ist nicht Besitzer des Submoduls. Das Submodul ist gesperrt durch übergeordnete Dienste.

3 AR ist nicht Besitzer des Submoduls. Das Submodul ist gesperrt durch IO Controller.

4 AR ist nicht Besitzer des Submoduls. Das Submodul ist gesperrt durch IO Supervisor.

5 - 15 Reserviert

11 - 14 0x7800 Identifizierungsinformationen (IdentInfo)

0 OK

1 Submodul ist nicht das geforderte, aber kompatibel.

2 Falsches Submodul

3 Kein Submodul

4 - 15 Reserviert

15 0x8000 Formatanzeiger (FormatIndicator)

0 Submodul enthält unformatierte Detailinformationen (siehe folgende Tabelle).

1 SubmoduleState besteht aus SubmoduleState.IdentInfo, SubmoduleState.ARInfo und SubmoduleState.AddInfo.

Bedeutung von SubmoduleState wenn Formatanzeiger (Bit 15) = 0

(SubmoduleState mit Bitmaske 0x7FFF verknüpft.)

Wert Beschreibung

0x0000 Kein Submodul

0x0001 Falsches Submodul

0x0002 AR ist nicht Besitzer des Submoduls. Andere IO Supervisor AR ist Besitzerin des Submoduls.

0x0004 AR Pending

0x0007 Submodul ist nicht das geforderte, aber kompatibel.

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).