Zum Haupttext springen

Veranstaltungskanal

Die Standard-WebSocket-URL für Ereignisse lautet ws://localhost:10020ist.

Der Port kann in den Einstellungen geändert werden.

Dieser Kanal ist ein einseitiger Kommunikationskanal mit geringer Frequenz, über den alle Ereignisse des Systems empfangen werden können. Eingangsnachrichten werden nicht unterstützt.

Dieser Kanal stellt sicher, dass bei jedem Ereignis eine Nachricht gesendet wird.

Standardformat​

Alle Veranstaltungen folgen der folgenden Standardstruktur:

{
"name": "device-connected",
"category": "device",
"level": "notice",
"data": {},
"message": ""
}

Feldbeschreibung​

FeldTypBeschreibung
namestringDies ist die eindeutige Kennung des Ereignisses.
categorystringDies sind Gruppenbezeichnungen, die zum Filtern und Konfigurieren verwendet werden (siehe „Gültige Kategorien“).
levelstringDies ist der Schweregrad oder die Wichtigkeit des Ereignisses (siehe gültige Stufen).
dataobjectDies ist die Nutzlast mit detaillierten Informationen zu den einzelnen Ereignissen.
messagestringDies sind optionale Erläuterungen oder Hintergrundinformationen zum Ereignis.

Veranstaltungskategorie​

category Field unterteilt Ereignisse in folgende Gruppen:

WertBeschreibung
systemDazu gehören Kern- oder Zentralsysteme sowie globale Einstellungen.
inputVerarbeitung externer Eingaben (z. B. Befehle usw.).
sessionEs handelt sich um ein Ereignis, das mit einer bestimmten Benutzersitzung zusammenhängt.
deviceGeräteverwaltung, Interaktion mit Controllern und SerialPort-Kommunikation.
moduleEs handelt sich um ein Ereignis eines Subsystems oder einer modularen Komponente.
featureEs handelt sich um ein Ereignis, das mit bestimmten Servicefunktionen oder -kapazitäten in Verbindung steht.

Veranstaltungsstufe​

Veranstaltung level Das Feld gibt den Schweregrad oder die Wichtigkeit des Ereignisses an:

WertBeschreibung
infoNur zu Informationszwecken – Protokolle, Metriken oder unwichtige Benachrichtigungen.
noticeEs handelt sich um eine Statusänderung oder ein bemerkenswertes Ereignis.
warningEs ist ein Problem aufgetreten oder eine Anomalie wurde festgestellt, das System kann jedoch weiterhin sicher betrieben werden.
errorEs ist ein Problem aufgetreten, das den Betrieb oder die Stabilität des Systems beeinträchtigen könnte.
criticalEs handelt sich um einen schwerwiegenden Fehler, der die Systemfunktionen erheblich beeinträchtigt.
panicSchwerwiegender Fehler – kann zu einem Systemabsturz oder einem nicht behebbaren Zustand führen.

Veranstaltung​

Informationen

Diese Liste enthält die aktuellsten Ereignisse, die vom System gemeldet werden. Wir arbeiten kontinuierlich daran, die Ereignistypen und die Art der Meldung weiterzuentwickeln und zu erweitern.

Eingabe​

invalid-io-channel​

Dies tritt auf, wenn ein E/A-Kanal nicht unterstützt wird oder auf unbeabsichtigte Weise verwendet wird.

Daten

FeldTypBeschreibung
received_datastringDies sind die empfangenen Rohdaten.
{
"name": "invalid-io-channel",
"category": "input",
"level": "warning",
"data": {
"received_data": "<raw_input_here>"
}
}

http-route-deprecated​

Dies tritt auf, wenn eine HTTP-Route nicht mehr unterstützt wird und in zukünftigen Versionen entfernt werden soll.

Daten

FeldTypBeschreibung
routestringDiese Route wird nicht mehr unterstützt.
substitutestringDies ist ein empfohlener Ersatz.
{
"name": "http-route-deprecated",
"category": "input",
"level": "warning",
"data": {
"route": "/the/old/way",
"substitute": "/the/new/way"
}
}

settings-invalid-key​

Dies tritt auf, wenn der Konfigurationsschlüssel ungültig ist.

Daten

FeldTypBeschreibung
keystringDer Schlüssel wurde nicht gefunden.
{
"name": "settings-invalid-key",
"category": "input",
"level": "warning",
"data": {
"key": "devices/none-existent/key"
}
}

command-deprecated​

Dies tritt auf, wenn der empfangene Befehl nicht mehr unterstützt wird und in zukünftigen Versionen entfernt werden soll.

FeldTypBeschreibung
commandstringErhaltene Anordnung zur Einstellung der Unterstützung
{
"name": "command-deprecated",
"category": "input",
"level": "warning",
"data": {
"command": "example_cmd"
},
"message": "The command `example_cmd` is deprecated and is replaced by `this_one`."
}

Gerät​

device-connected​

Zeigt an, dass das Gerät verbunden ist und voll funktionsfähig ist.

FeldTypBeschreibung
device_familystringGerätetyp: inverse oder verse_grip.
device_idstringDies ist die eindeutige Kennung des Geräts.
{
"name": "device-connected",
"category": "device",
"level": "notice",
"data": {
"device_family": "inverse",
"device_id": "04BA"
}
}

device-disconnected​

Dies zeigt an, dass die Verbindung zu einem zuvor verbundenen Gerät getrennt wurde.

FeldTypBeschreibung
device_familystringGerätetyp: inverse oder verse_grip.
device_idstringDies ist die eindeutige Kennung des Geräts.
{
"name": "device-disconnected",
"category": "device",
"level": "notice",
"data": {
"device_family": "verse_grip",
"device_id": "61548"
}
}

Sitzung​

device-low-control-rate​

Dies tritt auf, wenn die Geschwindigkeit der direkt an das Gerät gesendeten Steuerbefehle so niedrig ist, dass die Sicherheitsgrenze erreicht wird. Dies ist eine Warnung, die darauf hinweist, dass die Geschwindigkeit sich der Sperrgeschwindigkeit nähert.

FeldTypBeschreibung
session_idintDies ist die ID der betreffenden Simulationssitzung.
device_familystringGerätetyp: inverse oder verse_grip.
device_idstringDies ist die eindeutige Kennung des Geräts.
frequencyintDies ist die aktuelle Regelungsfrequenz (in Hz).
{
"name": "device-low-control-rate",
"category": "session",
"level": "warning",
"data": {
"session_id": 3,
"device_family": "inverse",
"device_id": "1A2B",
"frequency": 260
},
"message": ""
}

device-critical-control-rate​

Dies tritt auf, wenn die Geschwindigkeit der direkt an das Gerät gesendeten Steuerbefehle so niedrig ist, dass die Sicherheitsgrenze erreicht wird.

FeldTypBeschreibung
session_idintDies ist die ID der betreffenden Simulationssitzung.
device_familystringGerätetyp: inverse oder verse_grip.
device_idstringDies ist die eindeutige Kennung des Geräts.
frequencyintDies ist die aktuelle Regelungsfrequenz (in Hz).
{
"name": "device-critical-control-rate",
"category": "session",
"level": "error",
"data": {
"session_id": 3,
"device_family": "inverse",
"device_id": "1A2B",
"frequency": 82
},
"message": ""
}

Funktionen​

sdf-sdf_hfx-created​

Dies tritt auf, wenn ein SDF-Entity-FX erstellt wird.

FeldTypBeschreibung
session_idintDies ist die ID der betreffenden Simulationssitzung.
device_idstringDies ist die eindeutige Kennung des Geräts.
hfx_idstringDies ist die FX-ID, die bei der Erstellung verwendet wurde.
{
"name": "sdf-sdf_hfx-created",
"category": "feature",
"level": "notice",
"data": {
"session_id": 3,
"device_id": "1A2B",
"hfx_id": "my_fx_name"
},
"message": ""
}

sdf-sdf_hfx-deleted​

Dies tritt auf, wenn die SDF-Entität „FX“ gelöscht wird.

FeldTypBeschreibung
session_idintDies ist die ID der betreffenden Simulationssitzung.
device_idstringDies ist die eindeutige Kennung des Geräts.
hfx_idstringDies ist eine gelöschte FX-ID.
{
"name": "sdf-sdf_hfx-deleted",
"category": "feature",
"level": "notice",
"data": {
"session_id": 3,
"device_id": "1A2B",
"hfx_id": "my_fx_name"
},
"message": ""
}

sdf-sdf_hfx-updated​

Dies tritt auf, wenn das SDF-Entity FX aktualisiert wird.

FeldTypBeschreibung
session_idintDies ist die ID der betreffenden Simulationssitzung.
device_idstringDies ist die eindeutige Kennung des Geräts.
hfx_idstringDies ist die aktualisierte FX-ID.
{
"name": "sdf-sdf_hfx-updated",
"category": "feature",
"level": "notice",
"data": {
"session_id": 3,
"device_id": "1A2B",
"hfx_id": "my_fx_name"
},
"message": ""
}

sdf-sdf_hfx-range-entered​

Dies geschieht, wenn der Cursor des angegebenen Geräts in den Bereich einer SDF-Entität eintritt.

FeldTypBeschreibung
session_idintDies ist die ID der betreffenden Simulationssitzung.
device_idstringDies ist die eindeutige Kennung des Geräts.
hfx_idstringDies ist die FX-ID.
{
"name": "sdf-sdf_hfx-range-entered",
"category": "feature",
"level": "notice",
"data": {
"session_id": 3,
"device_id": "1A2B",
"hfx_id": "my_fx_name"
},
"message": ""
}

sdf-sdf_hfx-range-exited​

Tritt auf, wenn der Cursor des ausgewählten Geräts den Bereich der SDF-Entität verlässt.

FeldTypBeschreibung
session_idintDies ist die ID der betreffenden Simulationssitzung.
device_idstringDies ist die eindeutige Kennung des Geräts.
hfx_idstringDies ist die FX-ID.
{
"name": "sdf-sdf_hfx-range-exited",
"category": "feature",
"level": "notice",
"data": {
"session_id": 3,
"device_id": "1A2B",
"hfx_id": "my_fx_name"
},
"message": ""
}