Siemens SIMATIC S7-1500 Funktionshandbuch Seite 277

Anwenderschnittstellen (API)
7.6 API IInstances
Tabelle 7- 273 AlarmNotification() - .NET (C#)
Syntax
Parameter
276
void AlarmNotification(
ushort in_HardwareIdentifier,
ushort in_ModuleState,
ushort in_NumberOfDiagnosisEvents,
SDiagExtChannelDescription [] in_ArrayOfDiagnosisEvents,
Out ushort out_SequenceNumber
);
•
ushort 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.
•
ushort in_ModuleState:
Modulzustand. Gültig sind folgende Zustände:
ModuleState.Ok = 0,
ModuleState.Error = 1,
ModuleState.MaintenanceDemanded = 2,
ModuleState.MaintenanceRequired = 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 "War-
tungsbedarf" ein Diagnosealarm generiert werden soll, dann wählen Sie als
Modulstatus "6".
•
ushort 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).
•
Out ushort out_SequenceNumber:
PLCSIM Advanced weist jedem Alarm-Ereignis 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