Rotoclear OPC UA PubSub
Dokumentation
Erste Schritte
Rotoclear stellt über brokerloses UDP-UADP-PubSub 64 Befehle bereit: 55 feste Befehle, acht typisierte Schreibgruppen und eine Statusabfrage. Verwenden Sie dieses Handbuch, um eine SPS oder eine andere PubSub-Gegenstelle einzurichten und Bildfunktionen, Aufzeichnung, KI und GPIO zu steuern. Diese Schnittstelle verwendet PubSub-Datensätze anstelle von aus der Ferne aufrufbaren OPC-UA-Client/Server-Methoden.
Konfiguration
Netzwerkkonfiguration
| Einstellung | Befehl | Bisheriger Status | Strukturiertes Ergebnis |
|---|---|---|---|
| Sender | Gegenstelle | Gerät | Gerät |
| Zieladresse | opc.udp://<device>:4840/ |
opc.udp://<publisher_host>:4843/ |
Wie beim Status |
| PublisherId, als UInt16 codiert | 2234 | 2235 | 2235 |
| WriterGroupId | 100 | 101 | 102 |
| DataSetWriterId | 62541 | 62542 | 62543 |
| Felder | One scalar String Command |
One scalar String Status |
One scalar String Result |
| Beispiel | light0_on or JSON below |
ok |
JSON result below |
Verwenden Sie das Transportprofil http://opcfoundation.org/UA-Profile/Transport/pubsub-udp-uadp und die Variant-Feldcodierung. Schließen Sie Publisher-ID, Gruppenheader, Writer-Group-ID und Payload-Header ein. Konfigurieren Sie für Result einen separaten DataSetReader; dessen Metadaten enthalten ein skalares String-Feld. Ergebnisse verwenden eine eigene WriterGroup, damit der bisherige Statusdatensatz unverändert bleibt.
Setzen Sie publisher_host auf die erreichbare Adresse der Gegenstelle, die Status und Ergebnisse empfängt. Während der Einrichtung kann ein leerer Wert gespeichert werden; beim Start des Workers wird dieser jedoch abgelehnt. Die Zieladresse wird ausdrücklich konfiguriert und nicht aus eingehenden Befehlen ermittelt. Das Gerät bindet standardmäßig an 0.0.0.0. Die Datensatz-IDs müssen mit denen der Gegenstelle übereinstimmen. Die Writer-Group-ID und die DataSet-Writer-ID für Ergebnisse müssen sich von den entsprechenden Status-IDs unterscheiden. Beide ausgehenden Gruppen verwenden dieselbe konfigurierte Zieladresse.
Beide ausgehenden Gruppen veröffentlichen alle 500 ms sowie zusätzlich dann, wenn sich ihre Werte durch die Befehlsverarbeitung ändern. Bis zum ersten Ergebnis ist der String Result leer. Regelmäßige Wiederholungen stellen keine neuen Vorgänge dar. Ordnen Sie Ergebnisse anhand der request_id zu.
Der interne Namespace lautet standardmäßig urn:rotoclear:opc:pubsub, das Objekt heißt rotoclear. Externe Clients benötigen keine Node-IDs. Der interne Wert NoOfCommandsReceived ist kein veröffentlichtes Datensatzfeld.
Aufbewahrungsrichtlinie für Backups
Aktivieren Sie configure_backup ausdrücklich in opc_config.methods einer gespeicherten Installation und starten Sie den Worker neu, um diesen Befehl zu verwenden. Eine gespeicherte Freigabeliste, die nur set_parameter enthält, berechtigt nicht zum Schreiben von Backup-Richtlinien. configure_backup ruft ausschließlich die folgenden drei API-Setter mit Berechtigung für die Speicherrichtlinie auf. Der Befehl kann weder Speicherzugangsdaten ändern noch ein Speichergerät auswählen.
params.name |
params.value |
|---|---|
backupUseCompleteSpace |
Boolean; legt fest, ob der gesamte Speicherplatz oder die konfigurierte Aufbewahrungskapazität verwendet wird |
backupNumberOfSavedHours |
Integer, 1–8760 Stunden; Backup-Speicher muss verfügbar sein |
backupOnReachingRecordingTimeCapacityAction |
String: stopRecording oder reduceMaxTime |
"version": 1,
"request_id": "retention-001",
"command": "configure_backup",
"params": {
"name": "backupNumberOfSavedHours",
"value": 24
}
}
Die Obergrenze von 8760 Stunden ist eine bewusst festgelegte OPC-Grenze und keine Garantie für die Speicherkapazität. Die API kann die angeforderte Stundenzahl an den verfügbaren Speicherplatz anpassen. Ein erfolgreiches Ergebnis zur Aufbewahrung enthält requested, value, configured_hours und adjusted. Beispielsweise bedeutet requested:24, value:12, adjusted:true, dass die API 12 Stunden festgelegt hat. Der verfügbare Schreibschlüssel lautet backupNumberOfSavedHours. backupNumberOfSavedHoursSet ist schreibgeschützt und gibt die tatsächlich wirksame Konfiguration zurück.
Diese Einstellungen verwenden das vorhandene Backup-Verhalten, einschließlich Kapazitätsmeldungen, des Stoppens der Aufzeichnung oder der Verringerung der Aufbewahrungsdauer bei Erreichen der Kapazität sowie der automatischen Bereinigung dafür vorgesehener Backup-Medien. Änderungen werden als einzelne Vorgänge angewendet, nicht als atomare Transaktion über mehrere Einstellungen. Lesen Sie nach der Konfiguration die Richtlinieneinstellungen und die verbleibende Kapazität aus.
Sicherheit und Aktivierung von Befehlen
Konfigurieren Sie beide Gegenstellen mit demselben security_mode (None, Sign, SignAndEncrypt), derselben security_policy (Aes128Ctr, Aes256Ctr), derselben Token-ID und denselben Schlüsselbytes. Die Standardwerte sind SignAndEncrypt, Aes128Ctr und Token 1. Status und Ergebnis verwenden dieselbe Richtlinie. Die Token-ID allein stellt keine durchgesetzte Autorisierungsgrenze dar: Nachrichten mit passenden Schlüsseln können auch mit einer abweichenden Token-ID akzeptiert werden. Schützen und ersetzen Sie daher die tatsächlichen Schlüssel, wenn Sie einen Zugriff widerrufen.
Das Gerät erzeugt automatisch kryptografisch zufällige Schlüssel unter /media/data/config/certs/pubsub_keys.bin, wenn gesichertes OPC UA erstmals gestartet wird oder die zugehörigen Schlüssel erstmals heruntergeladen werden. Die Schlüssel bleiben bei Anwendungsneustarts und Firmware-Updates erhalten; vorhandene Schlüssel werden beibehalten. Die Binärdatei enthält in dieser Reihenfolge den Signaturschlüssel, den Verschlüsselungsschlüssel und die Schlüssel-Nonce:
| Richtlinie | Signaturschlüssel | Verschlüsselungsschlüssel | Nonce | Gesamt |
|---|---|---|---|---|
| Aes128Ctr | 32 bytes | 16 bytes | 4 bytes | 52 bytes |
| Aes256Ctr | 32 bytes | 32 bytes | 4 bytes | 68 bytes |
Speichern Sie unter Einstellungen → Module → OPC UA die Sicherheitskonfiguration. Verwenden Sie anschließend Sicherheitsstatus → Herunterladen, um pubsub_keys.bin herunterzuladen. Eine manuelle Schlüsselerzeugung ist nicht erforderlich. Der Download setzt ein aktives OPC-UA-Modul und die Berechtigung NetworkSettings_rw voraus. Verwenden Sie HTTPS und behandeln Sie die Datei vertraulich: Ihr Besitz ermöglicht sowohl das Veröffentlichen von Befehlen als auch das Entschlüsseln von Nachrichten. Konfigurieren Sie die Gegenstelle mit den heruntergeladenen Bytes sowie der passenden Richtlinie und Token-ID.
Der Download-Endpunkt lautet GET /opc/pubsub-keys und verwendet dieselbe authentifizierte Sitzung wie die Einstellungsoberfläche. Antworten werden als Dateianhang mit Cache-Control: no-store bereitgestellt. Solange der Worker läuft, liefern Downloads die beim Start geladenen Schlüssel. Starten Sie den Worker nach Einstellungsänderungen neu, um die neu gespeicherte Konfiguration zu verwenden. Bei gestopptem Worker verwenden Downloads die gespeicherte Konfiguration und erzeugen fehlende Standardschlüssel. Ein nicht vorhandener benutzerdefinierter Schlüsselpfad oder eine ungültige Schlüssellänge führt zu einem Fehler, ohne vorhandene Schlüssel zu ersetzen. Ein Wechsel zwischen AES-Richtlinien erfordert eine passende Schlüsseldatei. Die automatische Erzeugung ersetzt die Schlüssel einer bestehenden Installation nicht. Benutzerdefinierte Dateien können weiterhin durch einen Administrator bereitgestellt werden. Nach einem Zurücksetzen auf Werkseinstellungen, bei dem die dauerhafte Konfiguration entfernt wird, müssen die Gegenstellen erneut eingerichtet werden.
Benutzerdefinierte Pfade für pubsub.keys_file müssen normalisierte absolute Pfade innerhalb von /media/data/config/certs/ sein. Schlüsseldateien, die symbolische Links sind, werden abgelehnt. Die Schlüssel werden beim Start in den Worker eingelesen. Eine Änderung der Datei oder der gespeicherten Sicherheitseinstellungen ersetzt die Schlüssel eines aktiven Workers nicht. Stoppen Sie den Worker, stellen Sie passende Schlüssel für beide Gegenstellen bereit und starten Sie ihn neu. Es gibt keinen automatischen Schlüsselwechsel.
None benötigt keine Schlüssel. Die PubSub-Sicherheit authentifiziert den Besitz von Gruppenschlüsseln. Sie stellt kein separates Anwendungsbenutzerkonto für jeden Publisher bereit.
Aktivieren und konfigurieren Sie OPC UA unter Einstellungen → Module → OPC UA. Die Modul-/Lizenzkennung lautet opcua. Der Start der Laufzeit erfordert eine aktive Lizenz. Mit den entsprechenden Netzwerkberechtigungen bleibt die Konfiguration auch bei inaktivem Modul les- und schreibbar.
Die Einstellungen werden dauerhaft in /media/data/config/opc.json gespeichert. Die authentifizierte Konfigurationsschnittstelle benötigt zum Schreiben die Berechtigung NetworkSettings_rw:
1. Schreiben Sie opc_config mit Adressen, Sicherheitseinstellungen, Datensatz-IDs und den gewünschten kanonischen Befehlsnamen in methods.
2. Prüfen Sie opc_config_validation_result.
3. Schreiben Sie für opc_action zunächst den Wert {"action":"stop_opc_server"} und anschließend {"action":"start_opc_server"}.
4. Prüfen Sie, ob opc_status_update.server.state den Wert "started" hat.
Eine ausdrückliche Aktion start_opc_server bei aktiver Lizenz speichert autostart:true. stop_opc_server speichert autostart:false. Bei aktiviertem Autostart wird bei der Modulaktivierung bzw. beim Anwendungsstart versucht, den Worker mit den gespeicherten Einstellungen zu starten. Dies dokumentiert den angeforderten Start, ist jedoch kein Nachweis für ein erfolgreiches Binden an die Netzwerkadresse. Prüfen Sie opc_status_update und die zugehörigen Fehlerdetails. Korrigieren Sie eine ungültige Zieladresse oder einen belegten Port, bevor Sie den Start erneut versuchen. Eine Deaktivierung der Lizenz beendet die Laufzeitausführung.
Die dauerhaft gespeicherte Freigabeliste heißt enabled_methods; in der beobachtbaren Konfigurationsvariable heißt sie methods. Vorhandene gespeicherte Freigabelisten werden beibehalten. Eine Installation, in der nur die ursprünglichen 13 Befehle aktiviert wurden, muss die gewünschten neuen Befehle ausdrücklich ergänzen und anschließend neu gestartet werden. Die Standardwerte für eine neue Konfiguration und die mitgelieferte Vorlage enthalten alle 64 Befehlsnamen. Der laufende Worker verwendet bis zum nächsten Neustart einen beim Start erstellten Stand der Einstellungen.
commands ordnet über die Konfigurations-API kanonischen Namen benutzerdefinierte Legacy-Befehlsstrings zu. Der Editor Command Strings ist in der Einstellungsoberfläche ausgeblendet. Verwenden Sie die dokumentierten Standardstrings, sofern Ihre Installation nicht ausdrücklich Alternativen vorgibt. Die Zuordnungen müssen eindeutig, nicht leer und höchstens 63 UTF-8-Byte lang sein. Sie dürfen weder führende oder nachgestellte Leerzeichen noch NUL enthalten und nicht mit { beginnen. Der Abgleich erfolgt exakt und unterscheidet zwischen Groß- und Kleinschreibung. Strukturierte Anfragen verwenden kanonische Namen und dieselbe Methoden-Freigabeliste.
set_parameter akzeptiert 42 Einstellungsnamen; configure_backup akzeptiert drei Richtliniennamen. KI und GPIO verwenden sechs unabhängig voneinander aktivierbare Befehlsgruppen.
Der Adapter stellt ausschließlich die nachfolgend aufgeführten Steuerelemente und Leseschlüssel bereit. Beliebige beobachtbare Variablen, Benutzerverwaltung, Netzwerkkonfiguration, Firmware-Updates, Neustart, Zurücksetzen auf Werkseinstellungen, Dateiübertragung und das Löschen von Medien werden nicht bereitgestellt.
Anfragen
Senden Sie kein unverpacktes JSON in einem UDP-Datagramm. Codieren Sie den JSON-Text als skalares String-Feld innerhalb einer UADP-DataSetMessage. OPC-Anfragen akzeptieren das MQTT-Feld expires_at_ms nicht.
Legacy-Clients können weiterhin einen einzelnen festen Befehlsstring senden, beispielsweise video_start. Das bisherige ok bedeutet, dass die Anfrage in die Warteschlange des Status-Threads aufgenommen wurde. Es bestätigt keine erfolgreiche Ausführung. Lesen Sie Result, um zu erfahren, ob Validierung und Ausführung erfolgreich waren. Legacy-Anfragen erhalten automatisch erzeugte IDs und besitzen keinen Schutz vor doppelter Ausführung. Wiederholtes Veröffentlichen wiederholt Aktionen, soweit die API dies zulässt.
Legacy-Strings werden sowohl in gesicherten Modi als auch bei None weiterhin akzeptiert. Eingehende Befehlswerte werden nicht allein deshalb entprellt oder gefiltert, weil derselbe Wert wiederholt auftritt. Ein zyklischer SPS-Publisher darf eine Legacy-Aktion nicht in jedem SPS-Zyklus senden, sofern keine wiederholte Ausführung beabsichtigt ist. Verwenden Sie für Wiederholungsversuche strukturierte Anfragen mit gleichbleibenden IDs. Signierung und Verschlüsselung ergänzen weder ein Ablaufdatum auf Anwendungsebene noch eine dauerhafte Historie zum Schutz vor Wiedereinspielung. Der Arbeitsspeicher-Cache für zustandsändernde Anfragen ist auf fünf Minuten begrenzt.
Für die Zuordnung von Antworten, die Übergabe von Parametern und den Schutz vor doppelter Ausführung übergeben Sie den folgenden JSON-Text im selben Command-String-Feld.
Anfragen enthalten 1–1024 Byte ohne NUL. version muss die Ganzzahl 1 sein; request_id muss ein nicht leerer String mit höchstens 64 Byte sein. Unbekannte Felder, falsche JSON-Typen, nicht unterstützte Werte und unerwartete Parameter bei festen Befehlen werden abgelehnt. params ist nur bei festen Befehlen optional. Senden Sie Zahlen und Objekte als JSON-Zahlen bzw. JSON-Objekte und nicht als Strings, die diese enthalten.
"version": 1,
"request_id": "plc-001",
"command": "select_head1"
}
{
"version": 1,
"request_id": "plc-002",
"command": "set_parameter",
"params": {
"name": "light1Brightness",
"value": 60
}
}
{
"version": 1,
"request_id": "plc-read-003",
"command": "get_state",
"params": {
"keys": [
"record",
"recordingMode",
"recordingFilename",
"recordTime"
]
}
}
Befehle
Feste Befehle
Steuerung von Bildaufnahme, Aufzeichnung, Beleuchtung und Standbild:
| Befehle | Aktion |
|---|---|
take_picture |
Eine JPEG-Aufnahme anfordern |
video_start, video_stop |
Normale manuelle Aufzeichnung starten/stoppen |
timelapse_start, timelapse_stop |
Zeitrafferaufzeichnung starten/stoppen |
slowmotion_start, slowmotion_stop |
Zeitlupenaufzeichnung starten/stoppen |
light0_on, light0_off, light1_on, light1_off |
Beleuchtung des jeweiligen Kamerakopfs ein-/ausschalten |
freeze_stream_on, freeze_stream_off |
Standbildfunktion für den Stream ein-/ausschalten |
Bildaufnahme und Aufzeichnung verwenden den gemeinsamen API-Lebenszyklus, Speicherprüfungen, die Koordination der Hardwarezugriffe, konfigurierte Dateinamen und die Medienregistrierung. Zum Starten sind eine angeschlossene Kamera und ein geeigneter Aufzeichnungsspeicher erforderlich. Zeitlupe erfordert zusätzlich einen kompatiblen Kamerakopf. Stoppbefehle müssen zum aktiven Aufzeichnungsmodus passen. OPC- und API-Clients verwenden denselben Aufzeichnungsstatus.
Kamerakopfauswahl, Bildeinstellungen und Betriebssteuerung:
| Commands | API setting/action |
|---|---|
select_head0, select_head1 |
cameraSwitch false/true; requested head must exist |
head0_sensor0, head0_sensor1, head1_sensor0, head1_sensor1 |
Selected sensor for the specified head; sensor must exist |
layout_single |
pip=0 |
layout_pip_bottom_left, layout_pip_top_left, layout_pip_top_right, layout_pip_bottom_right |
pip=1,2,3,4 respectively; both heads required |
layout_side_by_side |
pip=5; both heads required |
auto_exposure_on, auto_exposure_off |
exposure |
auto_white_balance_on, auto_white_balance_off |
whiteBalance |
noise_suppression_on, noise_suppression_off |
noiseSuppression |
head0_auto_rotate_on, head0_auto_rotate_off, head1_auto_rotate_on, head1_auto_rotate_off |
autoRotate0/1 |
head0_disc_on, head0_disc_off, head1_disc_on, head1_disc_off |
dictRotation0/1; existing API motor behavior |
visual_backup_on, visual_backup_off |
backupActive, the desired backup setting |
autofocus_center |
tapToFocusView={"x":0.5,"y":0.5}; selected sensor needs focus support |
zoom_reset |
zoomState={"zoom":1.0} |
stream_time_on, stream_time_off, stream_date_on, stream_date_off |
Stream timestamp/date overlay |
record_time_on, record_time_off, record_date_on, record_date_off |
Recording timestamp/date overlay |
record_audio_on, record_audio_off |
recordingAudioActive |
backup_audio_on, backup_audio_off |
backupAudioActive |
Die Einstellungen werden über die API-Setter angewendet. applied bestätigt den Anwendungszustand, jedoch weder die Motordrehzahl noch das Einregeln der Belichtung, hörbare Audioausgabe oder das tatsächliche Schreiben von Backups. Backups erfordern einen geeigneten konfigurierten Speicher. Audio hängt weiterhin von der Audiokonfiguration des Geräts ab.
Typisierte Parameter
set_parameter erfordert genau params.name und params.value. Nur die folgenden Namen werden bereitgestellt:
| Namen | JSON-Typ und zulässige Werte |
|---|---|
| streamingBitrate | Ganzzahl 0…100.000.000 Bit/s; 0 stellt die qualitätsbasierte Auswahl wieder her; die tatsächliche Encoder-Ausgabe bleibt durch die konfigurierte Obergrenze begrenzt |
| streamingMaxBitrate, recordingMaxBitrate | Ganzzahl 10.000.000…100.000.000 Bit/s |
| streamingTimestampSetting, recordingTimestampSetting | Nicht leeres Objekt zur Teilaktualisierung: x, y als Zahlen 0…1; scaleValue als Zahl 0,4…2,2; drawBackdrop als boolescher Wert; backdropColor, textColor als Ganzzahlen 0…4.294.967.295 im gepackten Farbformat der API |
| prerollSettings | Nicht leeres Objekt zur Teilaktualisierung: enabled als boolescher Wert und/oder durationSec als Ganzzahl 15…30 |
| changeVideoName, changeImageName | Zeichenfolge als Dateinamenpräfix, 0…17 Byte; der reservierte Wert Backup wird abgelehnt |
| changePostName, changeBackupPostName | Zeichenfolge als Dateinamensuffix, 0…55 Byte |
| alignmentStream0, alignmentStream1 | Zeichenfolge "0" für die normale Ausrichtung oder "1" für die alternative Hardwareausrichtung; der entsprechende Kamerakopf muss vorhanden sein; kein Winkel in Grad |
| brightness, saturation | Ganzzahl −7…7 |
| expo | Zahl 0,01…1000 in den bestehenden API-Belichtungseinheiten |
| gain | Ganzzahl 0…42 |
| contrast | Zahl 1…2,5 |
| sharpness | Ganzzahl 0…15 |
| redGain, blueGain | Ganzzahl −128…127 |
| light0Brightness, light1Brightness | Ganzzahl 0…100; angeschlossener, dimmbarer Kamerakopf erforderlich |
| focusCam0Sensor0, focusCam0Sensor1, focusCam1Sensor0, focusCam1Sensor1 | Ganzzahl 0…1023; entsprechender Fokusmotor erforderlich |
| pictureQuality | Ganzzahl 10…90 |
| streamingQuality, recordingQuality, slowmoQuality | Ganzzahl 1…100 |
| fotoResolution, resolution, streamingResolution | Zeichenfolge HD, FullHD, 4K |
| fps, streamingFps | Ganzzahl 1, 5, 10, 15, 24, 30, 60 |
| highSpeedMode | Ganzzahl 120, 240, 480, 600, 720, 960 |
| timelapseInputFps | Zahl 0,01…1 |
| timelapseOutputFps | Zahl 1…60 |
| streamingFormat | Zeichenfolge h264, hevc |
| recordingFormat | Zeichenfolge h264, hevc, mjpg |
| tapToFocusView | Objekt mit x und y, jeweils Zahlen 0…1 innerhalb der aktuellen Ansicht |
| zoomState | Nicht leeres Objekt: zoom als Zahl 1…4 bzw. bis 7 bei einem Kamerakopf mit Unterstützung für die Fokussierung des Telesensors; zum Verschieben des Bildausschnitts werden left und top verwendet, jeweils als Zahlen 0…1 |
Beispiel:
Die Einschränkungen der API für Aufzeichnungs- und Backup-Einstellungen gelten weiterhin. Ein abgelehnter Setter oder eine Abweichung beim Rücklesen liefert failed. Zoom und Autofokus liefern accepted, da die Hardwarebewegung asynchron erfolgt. Diese Steuerelemente bieten keine zusätzlichen Garantien über das Hardwareverhalten der API hinaus.
"version": 1,
"request_id": "plc-004",
"command": "set_parameter",
"params": {
"name": "tapToFocusView",
"value": {
"x": 0.4,
"y": 0.6
}
}
}
Beispiele für strukturierte Einstellungen
Bei Einblendungen und Voraufzeichnung behalten ausgelassene Felder ihre bisherigen Werte. Unbekannte Felder, leere Objekte und als String codierte Objekte werden abgelehnt. data.value im Ergebnis enthält das vollständige akzeptierte Objekt. Unterschiede in der numerischen Darstellung als Ganz- oder Gleitkommazahl führen nicht fälschlich zu Fehlern. prerollSettings beschreibt die Konfiguration. Lesen Sie prerollStatus, um die aktive Pufferung, Dauer und Kapazität zu prüfen. Besondere Aufzeichnungsmodi können die Pufferung aussetzen, selbst wenn diese in der Konfiguration aktiviert ist.
Dateinamensbestandteile akzeptieren ASCII-Buchstaben, Ziffern, Bindestrich, Unterstrich und Punkt. Leere Strings löschen den jeweiligen Bestandteil und stellen das normale API-Verhalten zur Dateibenennung wieder her. Leerzeichen, Nicht-ASCII-Text, Verzeichnistrennzeichen, NUL sowie . und .. werden vor dem API-Aufruf abgelehnt. Namen werden daher nicht stillschweigend bereinigt oder gekürzt. Änderungen der Benennung betreffen nachfolgende Aufnahmen bzw. Dateien, nicht die Namen bestehender Aufzeichnungen. Die Grenzen von 17 bzw. 55 Byte entsprechen den einschließlich der Grenzposition geltenden Teilstringgrenzen des aktuellen API-Setters.
Die Bitratenobergrenzen verwenden die vorhandenen API-Grenzen von 10–100 Mbit/s. Die Obergrenze von 100 Mbit/s für die Zielbitrate ist eine durch die OPC-Schnittstellenspezifikation festgelegte Grenze. Sie bedeutet nicht, dass alle Codecs oder Modi diese Bitrate erreichen können. Änderungen an Aufzeichnungsauflösung und Bildrate können die Aufzeichnungsobergrenze neu berechnen. Fragen Sie nach solchen Änderungen die akzeptierten Einstellungen ab.
"version": 1,
"request_id": "overlay-001",
"command": "set_parameter",
"params": {
"name": "streamingTimestampSetting",
"value": {
"x": 0.05,
"y": 0.9,
"scaleValue": 1.2,
"drawBackdrop": true
}
}
}
{
"version": 1,
"request_id": "preroll-001",
"command": "set_parameter",
"params": {
"name": "prerollSettings",
"value": {
"enabled": true,
"durationSec": 30
}
}
}
{
"version": 1,
"request_id": "name-001",
"command": "set_parameter",
"params": {
"name": "changePostName",
"value": "Part_123"
}
}
{
"version": 1,
"request_id": "bitrate-001",
"command": "set_parameter",
"params": {
"name": "streamingMaxBitrate",
"value": 20000000
}
}
KI-Befehle
Aktivieren Sie die benötigten Namen in opc_config.methods und starten Sie anschließend den OPC-Worker neu: ai_control, ai_model, ai_runtime. Vorhandene gespeicherte Freigabelisten werden nicht automatisch erweitert. Dies sind separate Vorgänge und keine zusätzlichen Namen, die von set_parameter akzeptiert werden.
| Befehl | params |
Verhalten |
|---|---|---|
ai_control |
Nicht leeres Objekt mit optionalen Feldern: active als boolescher Wert, project als Zeichenfolge, confidence als Zahl 0…1 |
Start/Stopp anfordern oder Projekt und Konfidenzschwelle konfigurieren |
ai_model |
project und model als Zeichenfolgen |
Ein installiertes Modell auswählen; ein leerer Modellname hebt die Auswahl auf |
ai_runtime |
project als Zeichenfolge und nicht leeres settings-Objekt |
Validierte projektspezifische Laufzeitkonfiguration mit der bestehenden Konfiguration zusammenführen |
Die Projekte heißen humandetect, spandetekt und motiondetect. Letzteres verwendet kein auswählbares Modell. Modell- und Profilnamen müssen mit den Metadaten installierter Modelle übereinstimmen und dürfen keine Dateisystempfade sein. Lesen Sie kiModels, um Namen und verfügbare Profile zu ermitteln.
Die Aktivierung der KI erfordert eine aktive KI-Lizenz, eine angeschlossene Kamera, das Fehlen eines exklusiven Ressourcenkonflikts mit einer Aufzeichnung sowie bei Projekten, die ein Modell benötigen, ein installiertes und ausgewähltes Modell. Auch Modell- und Laufzeitänderungen erfordern die Lizenz. Stoppen Sie die KI und warten Sie auf das Ende des Prozesses, bevor Sie das Modell des laufenden Projekts oder Projekt/Konfidenz der Steuerung ändern. Das erneute Setzen von active:true bei einem bereits laufenden lokalen Prozess fordert keinen Neustart an. Projekt und Konfidenz können im inaktiven Zustand konfiguriert werden. Eine Änderung dieser Felder aktiviert die KI nicht automatisch.
Verwenden Sie anstelle des Beispielnamens detector.hef den Namen eines tatsächlich installierten Modells. Start-/Stoppergebnisse haben den Status accepted. Prozessstart, Herunterfahren und Inferenz erfolgen asynchron. Verfolgen Sie kiControl.status/error, kiProjects, processAmpel und processGraph über get_state. Ein Prozessstatus „running“ beweist nicht, dass bereits ein erstes Inferenzergebnis vorliegt. Es wird kein anfragespezifisches Abschlussereignis ausgegeben.
"version": 1,
"request_id": "ai-model-001",
"command": "ai_model",
"params": {
"project": "humandetect",
"model": "detector.hef"
}
}
{
"version": 1,
"request_id": "ai-start-001",
"command": "ai_control",
"params": {
"project": "humandetect",
"confidence": 0.35,
"active": true
}
}
{
"version": 1,
"request_id": "ai-stop-001",
"command": "ai_control",
"params": {
"active": false
}
}
Unterstützte Felder von ai_runtime.settings:
| Feld | Datentyp und Grenzen |
|---|---|
displayMode |
all oder relevant; relevant ist nur für spandetekt verfügbar |
showTool, autoTag, deletable |
Boolescher Wert |
profile |
Nicht leere Zeichenfolge ≤64 Byte; muss vom ausgewählten Modell als verfügbar ausgewiesen sein |
window |
Zahl 0.3…60 Sekunden, entsprechend den Grenzen des Messwert-Zeitfensters |
triggerTime, gap, cooldown |
Ganzzahl 0…3600 Sekunden; die Obergrenze ist durch die OPC-Schnittstellenspezifikation festgelegt |
classes |
Objekt, das bis zu 16 Klassennamen/-IDs Schwellenwerte von 0…10,000 zuordnet |
ampel |
Objekt mit window (0.3…60 Sekunden) und classes; jede Klasse enthält warn und crit als Zahlen 0…10,000 |
Klassenschlüssel sind nicht leere Strings mit höchstens 64 Byte ohne NUL. Sie müssen den Klassenkennungen des Datenlieferanten bzw. Modells entsprechen, damit sie sich auf die Auswertung auswirken. Schwellenwerte beziehen sich auf Mittelwerte der Klassenanzahl und nicht zwingend auf Konfidenzwahrscheinlichkeiten. Null deaktiviert den jeweiligen Ampelschwellenwert. Wenn beide Werte positiv sind, darf warn nicht größer als crit sein. Die Grenzen von 16 Klassen und 10.000 für Schwellenwerte sind OPC-Grenzen. Die Anfragegrenze von 1024 Byte gilt weiterhin.
Einstellungen auf oberster Ebene, die in der Teilaktualisierung ausgelassen werden, bleiben erhalten. Übergebene Objekte classes und ampel ersetzen die jeweiligen verschachtelten Werte vollständig. Dies entspricht dem Zusammenführungsverhalten der API, das nur die oberste Ebene berücksichtigt. Das Zurücksetzen mit null, beliebige Laufzeitschlüssel, die Einspeisung von Daten über kiSample/kiEvent, Modell-Uploads und das Löschen von Modellen werden durch diese Befehle nicht bereitgestellt. applied bedeutet, dass die Konfiguration gespeichert wurde. Das Anzeige- und Laufzeitverhalten hängt weiterhin von der Unterstützung durch den Datenlieferanten ab. Damit Auto-Tag-Einstellungen nutzbare Markierungen erzeugen, sind eine geeignete Modellklassenkonfiguration und Backup-Speicher erforderlich.
"version": 1,
"request_id": "ai-runtime-001",
"command": "ai_runtime",
"params": {
"project": "spandetekt",
"settings": {
"autoTag": true,
"window": 2,
"triggerTime": 10,
"gap": 10,
"cooldown": 20,
"ampel": {
"window": 2,
"classes": {
"0": {
"warn": 0.25,
"crit": 0.5
}
}
}
}
}
}
GPIO-Befehle und KI-GPIO-Verknüpfungen
Aktivieren Sie die benötigten Namen unabhängig voneinander: gpio_output, gpio_input_binding, gpio_output_binding. Das GPIO-Modul muss aktiviert und lizenziert sein. Anfragen können weder einen Eigentümer, ein Konto, Berechtigungen, eine Geräterolle, einen beliebigen API-Schlüssel, eine URL noch eine Netzwerkaufgabe festlegen.
OPC-Befehle und zurückgegebene Objekte einzelner Verknüpfungen verwenden die physischen Pinnummern 1–4. Die vorhandenen unveränderten API-Verknüpfungsarrays, die von get_state zurückgegeben werden, behalten ihre ursprünglichen nullbasierten Pinwerte 0–3. gpioInput/gpioOutput verwenden pin1 bis pin4 mit den Pegeln "0"/"1" als Strings.
Ausgangspegel setzen
value muss ein JSON-Boolean sein. Der Adapter prüft den Schreibvorgang des Treibers und liest den vom Treiber gemeldeten Pegel zurück, bevor er applied mit driver_readback:true zurückgibt. Dies überprüft weder die externe Verdrahtung noch einen angeschlossenen Aktor. Schreibvorgänge werden abgelehnt, wenn für diesen Ausgang eine Verknüpfung besteht oder irgendeine Legacy-Ausgangsaufgabe aktiv ist, einschließlich verzögerter Aufgaben. Ein Treiber- oder Rücklesefehler kann nach dem Schreibvorgang auftreten. Ein Fehler ist daher kein Nachweis dafür, dass der Pegel unverändert geblieben ist. Dieser Befehl speichert keinen gewünschten Pegel über einen Neustart hinweg und implementiert weder Impulse noch Zeitpläne oder wiederholte Signalverläufe.
"version": 1,
"request_id": "gpio-level-001",
"command": "gpio_output",
"params": {
"pin": 1,
"value": true
}
}
Eingang mit einer Geräteaktion verknüpfen
Verfügbare Aktionen sind light0, light1 und recording. HIGH wählt Ein/Start, LOW wählt Aus/Stopp. Nach dem Erstellen oder der GPIO-Initialisierung wird der aktuelle Eingangspegel einmal angewendet. Spätere Änderungen werden nach einer Stabilisierungszeit von 300 ms angewendet. Fehlgeschlagene Aktionen oder spätere Änderungen über die Benutzeroberfläche werden bei unverändertem Pegel nicht fortlaufend erneut ausgeführt. Doppelte Pin-/Aktionsverknüpfungen werden abgelehnt. Es sind maximal 32 Eingangsverknüpfungen möglich. Verschiedene Aktionen können denselben Eingangspin verwenden. Der umfangreichere Aktionskatalog der API erweitert die Freigabeliste des Protokolls nicht. Beispielsweise wird freeze von diesem Befehl nicht akzeptiert.
"version": 1,
"request_id": "gpio-input-001",
"command": "gpio_input_binding",
"params": {
"pin": 1,
"action": "recording"
}
}
Über OPC erstellte Eingangsverknüpfungen erhalten die serverseitig zugewiesene Geräterolle deviceRole:"opc_pubsub" und zeigen opc-pubsub als Eigentümer an. Die Geräterolle unterscheidet sich von einem Kontobenutzernamen und wird dauerhaft mit der Verknüpfung gespeichert. Ihre Aktionsausführung ist auf Berechtigungen für Kamerakopfbeleuchtung und Aufzeichnung beschränkt. Sie übernimmt niemals die ersatzweise verwendeten Administratorrechte des API-Handlers. Clients können keines der beiden Eigentumsfelder angeben. Bestehende API-eigene Verknüpfungen behalten ihr kontobasiertes Verhalten.
Ausgang mit einem Geräte- oder KI-Zustand verknüpfen
| Quelle | Zusätzliche Argumente |
|---|---|
vbActive, light0, light1, internet, reconstruction3d |
Keine; boolesche Signalquelle |
recording |
when: start oder stop |
kiAmpel |
instance: ein unterstütztes KI-Projekt; when: green, orange, red oder gray |
"version": 1,
"request_id": "gpio-ai-001",
"command": "gpio_output_binding",
"params": {
"pin": 2,
"source": "kiAmpel",
"instance": "spandetekt",
"when": "red",
"active_high": true
}
}
active_high ist optional und standardmäßig true. Der Ausgang folgt der ausgewählten Quellenbedingung; bei false wird das Signal invertiert. Ein fehlender Quellenzustand wird als inaktiv behandelt. Durch die Invertierung kann der Ausgang in diesem Fall HIGH werden. vbActive gibt die angeforderte Aktivierung des Backups wieder und bestätigt nicht das tatsächliche Schreiben von Dateien. reconstruction3d ist ein vom Datenlieferanten gemeldeter Zustand. Eine Verknüpfung damit startet keine Rekonstruktion.
Pro Pin gibt es eine Ausgangsverknüpfung. Das Erstellen einer Verknüpfung ersetzt die bisherige Verknüpfung dieses Pins und wertet die neue Quelle sofort aus. Die Erstellung wird abgelehnt, solange irgendeine Legacy-Ausgangsaufgabe aktiv ist. applied bestätigt die dauerhaft gespeicherte Verknüpfungskonfiguration, nicht das Rücklesen des physischen Ausgangs. Die gemeinsame API-Auswertelogik für Verknüpfungen steuert spätere Ausgangsänderungen.
Verknüpfungen lesen und entfernen
Lesen Sie gpioInputBindings, gpioOutputBindings, gpioSources, gpioActions, gpioInput und gpioOutput über get_state. Ergebnisse beim Erstellen enthalten die ID der Verknüpfung. Entfernen Sie eine Verknüpfung mit dem zur jeweiligen Richtung passenden Befehl.
Zum Löschen ist eine vorhandene positive ganzzahlige ID erforderlich. Das Löschen von OPC-Eingangsverknüpfungen ist auf OPC-eigene Verknüpfungen beschränkt. Beim Löschen von Ausgangsverknüpfungen kann eine vorhandene Ausgangsverknüpfung entfernt werden. Löschanfragen dürfen keine Felder zur Erstellung enthalten. Nach dem Entfernen einer Ausgangsverknüpfung bleibt deren letzter Pegel unverändert. Verwenden Sie anschließend gpio_output, wenn ein bestimmter Pegel erforderlich ist.
Verknüpfungen bleiben bei Anwendungsneustarts erhalten und werden unabhängig vom OPC-Worker weiter ausgeführt. Das Entfernen eines Befehls aus der OPC-Freigabeliste oder das Stoppen des Workers verhindert weitere Konfigurationsanfragen, entfernt jedoch keine bestehenden Verknüpfungen. Löschen Sie nicht mehr benötigte Verknüpfungen ausdrücklich. Allgemeine HTTP-/TCP-/UDP-Eingangsaufgaben, beliebige Aufgaben zum Schreiben von Zuständen, tägliche Zeitpläne und Ausgangsimpulsfolgen verbleiben in der bestehenden API und sind nicht Bestandteil dieser Integration.
"version": 1,
"request_id": "gpio-remove-001",
"command": "gpio_input_binding",
"params": {
"id": 1,
"delete": true
}
}
Abfragen und Ergebnisse
Statusabfragen
get_state erfordert params.keys, ein Array mit 1–16 zulässigen Strings. Doppelte Schlüssel werden einmal zurückgegeben. Lesezugriffe liefern den aktuellen API-Zustand und keine hardwaresynchrone Momentaufnahme. Die Freigabeliste lautet:
cameraSwitch, cam0Exists, cam1Exists, cam0SelectedSensor, cam1SelectedSensor, headIsSlowMoCompatible, light0, light1, light0Brightness, light1Brightness, light0Dim, light1Dim, dictRotation0, dictRotation1, RPM0, RPM1, exposure, whiteBalance, noiseSuppression, brightness, expo, gain, contrast, sharpness, saturation, redGain, blueGain, pip, autoRotate0, autoRotate1, freeze, zoomState, focusView, focusCam0Sensor0, focusCam0Sensor1, focusCam1Sensor0, focusCam1Sensor1, takePicture, record, recordingMode, recordTime, recordingFilename, fotoFilename, backupActive, backupFilename, backupRemainingCapacitySeconds, fotoResolution, resolution, fps, streamingResolution, streamingFps, pictureQuality, streamingQuality, recordingQuality, slowmoQuality, streamingFormat, recordingFormat, timelapseInputFps, timelapseOutputFps, highSpeedMode, streamingWithTimeStamp, streamingWithDateStamp, recordingWithTimeStamp, recordingWithDateStamp, recordingAudioActive, backupAudioActive, streamingIsBusy, streamingBitrate, streamingMaxBitrate, recordingMaxBitrate, streamingTimestampSetting, recordingTimestampSetting, prerollSettings, prerollStatus, changeVideoName, changeImageName, changePostName, changeBackupPostName, alignmentStream0, alignmentStream1, backupUseCompleteSpace, backupNumberOfSavedHours, backupNumberOfSavedHoursSet, backupOnReachingRecordingTimeCapacityAction, kiControl, kiModels, kiRuntimeSettings, kiProjects, processAmpel, processGraph, reconstruction3dActive, gpioInput, gpioOutput, gpioInputBindings, gpioOutputBindings, gpioSources, gpioActions, fpgaTemp, oct0, oct1, psi0, psi1, swVersion, fmVersion.
Ergebnisse, Wiederholungsversuche und Grenzen
Beispiel für das erfolgreiche Setzen einer Einstellung:
phase |
Bedeutung |
|---|---|
applied |
Die angeforderten API-Felder stimmen mit den zurückgelesenen Werten überein, oder die Aufbewahrungsdauer wurde mit dem ausdrücklich gemeldeten Wert adjusted angewendet |
accepted |
Eine Anfrage für Bildaufnahme, Videoaufzeichnung, Fokus, Zoom oder KI-Start/-Stopp wurde zur asynchronen Bearbeitung angenommen |
completed |
Eine get_state-Abfrage wurde abgeschlossen; data ordnet die angeforderten Namen den aktuellen Werten zu |
failed |
Die Validierung der Anfrage, die Prüfung von Berechtigungen oder unterstützten Funktionen oder die Ausführung ist fehlgeschlagen |
"version": 1,
"request_id": "plc-002",
"command": "set_parameter",
"phase": "applied",
"timestamp_ms": 1791800000000,
"data": {
"name": "light1Brightness",
"value": 60,
"note": "API setting applied; physical completion is not confirmed"
},
"error_code": null,
"error_message": null
}
timestamp_ms ist die Unix-Zeit des Geräts in Millisekunden. Bei Bildaufnahme und Aufzeichnung benennt data.observe die regelmäßig abzufragenden Statusschlüssel. Vergleichen Sie bei einer Bildaufnahme den Abschlusszeitstempel von takePicture und fotoFilename mit ihren vorherigen Werten. Prüfen Sie bei einer Aufzeichnung record, recordingMode, recordingFilename und recordTime. Asynchrone Vorgänge melden ihren laufenden Zustand über get_state; es gibt kein späteres anfragespezifisches Abschlussereignis. Ein Dateiname allein beweist nicht, dass eine Aufzeichnung vollständig geschrieben wurde. Der Zustand kann außerdem durch einen anderen API-Client geändert werden.
Zu den Fehlercodes gehören invalid_request, rejected, request_id_conflict, not_applied und result_too_large. Die menschenlesbare error_message nennt den Grund. not_applied gibt außerdem die angeforderten und aktuellen Werte zurück. Ein Setter kann den Zustand bereits teilweise geändert haben, bevor dieses Ergebnis ausgegeben wird. Wenn eine Ausführung den Zustand vor einem Fehler möglicherweise teilweise geändert hat, fragen Sie den betroffenen Zustand ab, bevor Sie eine neue Anfrage senden.
Für strukturierte zustandsändernde Anfragen werden bis zu 1024 IDs für fünf Minuten gespeichert, gemessen mit einer monotonen Uhr. Eine Wiederholung derselben ID mit demselben Befehl und denselben Parametern liefert die zwischengespeicherte Antwort, ohne den Vorgang erneut auszuführen. Wird eine zwischengespeicherte ID für andere Inhalte wiederverwendet, wird request_id_conflict zurückgegeben. Ein voller Cache lehnt neue zustandsändernde Anfragen ab, bis Einträge ablaufen. Geschützte IDs werden nicht vorzeitig entfernt. get_state liefert aktuelle Zustände und belegt keinen Cache-Platz. Eine Abfrage mit einer bereits durch eine zustandsändernde Anfrage reservierten ID führt dennoch zu einem Konflikt. Legacy-Befehle werden niemals dedupliziert.
Der Cache liegt im Arbeitsspeicher und bleibt bei einem Anwendungsneustart nicht erhalten. Abgelaufene IDs können erneut ausgeführt werden. Verwenden Sie eindeutige IDs über alle Clients und alle bewusst getrennten Aktionen hinweg. Eine zwischengespeicherte Ablehnung bleibt für diese ID eine Ablehnung. Verwenden Sie nach Behebung der Ursache eine neue ID für einen bewusst neuen Versuch.
UDP garantiert weder die Zustellung noch eine Empfangsbestätigung. Wiederholen Sie bei einer Zeitüberschreitung eine zustandsändernde Anfrage innerhalb des Cache-Zeitfensters mit derselben ID. Eine ausbleibende Antwort ist kein Nachweis für einen Fehler. Die Empfangswarteschlange fasst 32 Anfragen; die Thread-Kanäle fassen jeweils 30 Ereignisse. Bei Überlastung kann eine Anfrage ohne zugeordnetes Ergebnis verloren gehen. Die Hauptschleife unterbricht das Entnehmen von Anfragen, wenn ihr Ergebniskanal voll ist. Serialisierte JSON-Ergebnisse sind auf 1300 Byte begrenzt. Dadurch bleibt bei einer Standard-MTU von 1500 Byte Platz für den UADP- und Sicherheits-Overhead. Zu große Ergebnisse liefern result_too_large. Fragen Sie weniger Schlüssel ab. Wenn bereits ein einzelnes Feld zu groß ist, rufen Sie es über die HTTP-/WebSocket-API ab. Netzwerkpfade mit kleinerer MTU können zusätzliche Einschränkungen verursachen.
Aufzeichnung und Arbeitsabläufe mit zwei Kameraköpfen
Die Nummerierung von Kameraköpfen und Sensoren beginnt bei null. Wählen Sie einen installierten Kamerakopf mit select_head0 oder select_head1. Verwenden Sie den passenden Sensorbefehl, wenn der Kamerakopf über diesen Sensor verfügt. Bild-in-Bild- und nebeneinander angeordnete Ansichten erfordern zwei angeschlossene Kameraköpfe. Bildeinstellungen verwenden dieselbe Geräte-API wie die Benutzeroberfläche.
Setzen Sie für normale Aufzeichnungen recordingFormat auf h264, hevc (H.265) oder mjpg (MJPEG) und konfigurieren Sie anschließend resolution und fps. Verwenden Sie für Live-Streaming streamingFormat, streamingResolution und streamingFps. Die Aufzeichnungsvoreinstellungen der Benutzeroberfläche sind 4K30 (4K, 30), FHD60 (FullHD, 60), FHD30 (FullHD, 30), HD60 (HD, 60) und HD30 (HD, 30). Zulässige Parameterwerte bedeuten nicht, dass jede Kombination mit jedem Kamerakopf oder Aufzeichnungsmodus verfügbar ist.
Senden Sie jeweils eine Einstellung, warten Sie auf deren Ergebnis und fragen Sie anschließend die akzeptierten Werte ab. Starten Sie eine Aufzeichnung erst, wenn Speicher- und Kamerakonfiguration bereit sind. Lesen Sie den Aufzeichnungsstatus, senden Sie den passenden Stoppbefehl und beobachten Sie den Übergang zurück in den Ruhezustand. Verwenden Sie timelapse_start zusammen mit den Zeitraffer-Eingangs-/Ausgangsbildraten oder slowmotion_start mit einem unterstützten highSpeedMode und einem kompatiblen Kamerakopf. Konfigurationsänderungen sind einzelne Vorgänge und keine Transaktion.
Fehlerbehebung
| Symptom | Prüfung |
|---|---|
| Keine Antworten | Modul- und Worker-/Client-Status, Zieladresse, Netzwerkroute und Firewall sowie den abonnierten Ergebnispfad oder die Datensatz-IDs prüfen |
| Befehl nicht verfügbar | Maßgebliche Schreibweise, Berechtigungen oder OPC-Freigabeliste, Modulaktivierung, angeschlossenen Kamerakopf und unterstützten Sensor prüfen |
| Aufnahme kann nicht gestartet werden | Verfügbarkeit des konfigurierten Aufnahmespeichers, Kameraverbindung, aktuelle Ressourcennutzung durch Aufnahme und KI sowie die Kompatibilität der Betriebsmodi prüfen |
| Wert weicht von der Anfrage ab | Ergebnisphase, Fehlerdetails, tatsächlich geltende Aufbewahrung auf dem Speicher und aktuellen Zustand prüfen; auch andere Clients können Einstellungen ändern |
| KI startet nicht | Ausgewähltes Projekt, Metadaten des installierten Modells, KI-Aktivierung, verfügbare Ressourcen und kiControl.error prüfen |
| GPIO-Ausgang lässt sich nicht setzen | GPIO-Aktivierung, bestehende Ausgangszuordnung oder Aufgabe des bisherigen Systems, Eigentümer und Berechtigungen für die Signalquelle prüfen |
| Start abgelehnt | Eine aktive opcua-Lizenz, einen nicht leeren publisher_host, einen gültigen Schlüsselpfad und eine gültige Schlüssellänge sowie einen verfügbaren UDP-Befehlsport prüfen. |
| result_too_large | Die Zustandsabfrage aufteilen; die HTTP-/WebSocket-API verwenden, wenn ein einzelnes Feld die Ergebnisgrenze von 1300 Byte überschreitet. |
| Wiederholte Aktionen oder Ergebnisse | Bei erneuten Versuchen dieselben Anfrage-IDs verwenden. Befehlspakete des bisherigen Systems können eine erneute Ausführung auslösen; zyklische Result-Veröffentlichungen wiederholen das letzte Ergebnis, ohne einen neuen Vorgang darzustellen. |