Alarmnotification - Siemens SIMATIC S7-1500 Funktionshandbuch

Anwenderschnittstellen (API)
7.6 API IInstances
7.6.8.3

AlarmNotification

AlarmNotification()
Diese Funktion löst Diagnosemeldungen nach PROFINET-Standard aus.
Jeder Aufruf dieser Funktion ruft den OB 82 einmal auf, unabhängig von der Anzahl und vom
Schweregrad der übermittelten Diagnoseeinträge.
Tabelle 7- 272 AlarmNotification() - Native C++
Syntax
Parameter
274
ERuntimeErrorCode AlarmNotification(
UINT16 in_HardwareIdentifier,
UINT16 in_ModuleState,
UINT16 in_NumberOfDiagnosisEvents,
SDiagExtChannelDescription* in_ArrayOfDiagnosisEvents,
UINT16* out_SequenceNumber
);
•
UINT16 in_HardwareIdentifier:
Die HW-Kennung des Moduls oder Submoduls, das den Diagnoseeintrag sendet.
Die Kennung muss zu einer Hardware-Komponente im aktuell geladenen Pro-
jekt gehören.
•
UINT16 in_ModuleState:
Modulzustand. Gültig sind folgende Zustände:
DMODULE_STATE_OK = 0,
DMODULE_STATE_ERROR = 1,
DMODULE_STATE_MAINT_DEMANDED = 2,
DMODULE_STATE_MAINT_REQUIRED = 4
Der Parameter in_ModuleState ergibt sich aus der Summe (Veroderung) der
Schweregrade im Feld SDiagExtChannelDescription. Wenn z. B. für ein
Modul sowohl bei "Wartungsanforderung" als auch bei "Wartungsbedarf" ein Di-
agnosealarm generiert werden soll, dann wählen Sie als Modulstatus "6".
•
UINT16 in_NumberOfDiagnosisEvents:
Mehrere Diagnoseeinträge können mit einem einzigen API-Aufruf an die CPU
gesendet werden.
Gültiger Bereich: 0 bis 16. 0 bedeutet, dass kein Diagnoseeintrag für das Sub-
modul oder den Kanal erscheinen soll.
•
SDiagExtChannelDescription* in_ArrayOfDiagnosisEvents:
Zeiger auf ein Feld mit Diagnoseeinträgen. Das Feld muss mit der Anzahl der
Diagnoseeinträge übereinstimmen. Es kann auch ein Null-Zeiger sein. Definitio-
nen siehe SDiagExtChannelDescription (Seite 383).
•
UINT16* out_SequenceNumber:
PLCSIM Advanced weist jedem Alarmereignis eine eindeutige aufeinander fol-
gende Nummer zu.
Nach PROFINET-Standard ist die Sequenznummer 10 Bits weit (1 bis 7FF
Wenn die höchste Nummer erreicht ist, startet die Nummerierung wieder bei 1.
S7-PLCSIM Advanced
Funktionshandbuch, 05/2021, A5E37039506-AD
).
H