--- title: "Einstellungen, Module und Neustart" description: "Der Knoten system der LumiScan-Apps - Einstellungsdateien auf dem Data Layer, Module anlegen und entfernen, Moduleingaben speichern, Neustart und was bei einem Neustart erhalten bleibt." product: "LumiScan Keryx" component: "lumiscan-keryx-de" version: "1.0.0" display_version: "1.0.0.7" latest_version: true language: "de" url: "https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/settings-and-modules.html" --- # Einstellungen, Module und Neustart – LumiScan Keryx Alles, was nicht ein einzelnes Modul betrifft, liegt unter `hdvisionsystems//system/`. Die Apps gehören zu zwei Familien, die ihre Module unterschiedlich verwalten. Die Code Reader haben dort nur `system/meta/subscription-schema` (siehe [Streams](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/streams.html#consumer)). ## Cam Driver, AI Object Matching, Calibration: Einstellungsdateien {#settings-file-apps} Ihre Module sind die Moduldateien, die die Anwendungs-Einstellungsdatei auflistet. | Knoten | Art | Wirkung | | --- | --- | --- | | `system/settings` | string, lesen und schreiben | Alle geladenen Einstellungen als ein JSON-Dokument: die Anwendungsdatei, in die jede aufgeführte Moduldatei eingebettet ist (Passwörter als `*` angezeigt). Beim Schreiben werden die geänderten Dateien gespeichert - jede zuerst von der App geprüft, die alte als `.bak` aufbewahrt - und ein Neustart wird als erforderlich markiert | | `system/restart-required` | bool, schreibgeschützt | `true` nach einer gespeicherten Änderung, bis die App neu startet. In dieser Zeit meldet jedes Modul Status `-5` (`restartRequired`), und seine Methoden antworten mit `ResourceUnavailable` (ctrlX `DL_RESOURCE_UNAVAILABLE`) | | `system/control/restart/execute` | Methode | stoppt die App und startet sie erneut. Die Knoten der App verschwinden, bis sie wieder läuft: Warten Sie, bis `system/restart-required` wieder gelesen werden kann | | `system/control/create-module/execute` | Methode, Eingaben `control/create-module/input/module-id` und `content` | schreibt `.json`. Wird abgelehnt, wenn die Datei existiert | | `system/control/activate-module/execute`, `system/control/deactivate-module/execute` | Methode, Eingabe `control//input/module-id` | fügt die Datei der Liste der Anwendungsdatei hinzu bzw. entfernt sie daraus. Die Datei bleibt erhalten. Erfordert einen Neustart | | `system/found-modules`, `system/status-text` | schreibgeschützt | die bedienten Module; warum keine bedient werden | Der Cam Driver ergänzt die Kameraerkennung: `system/found-camera-modules`, `found-camera-serials`, `found-camera-mac-addresses`, `found-camera-ip-addresses` und den Handshake `system/force-ip/`. AI Object Matching bedient höchstens ein Modul: `activate-module` lehnt ein zweites ab. Beispiel - das Kameramodul `camera2` zum Cam Driver hinzufügen: 1. Schreiben Sie das JSON des Moduls auf `hdvisionsystems/lumiscan-cam-driver/system/control/create-module/input/content` und `camera2` auf `control/create-module/input/module-id`, und rufen Sie dann `control/create-module/execute` auf. 2. Schreiben Sie `camera2` auf `control/activate-module/input/module-id`, und rufen Sie dann `control/activate-module/execute` auf. 3. Rufen Sie `hdvisionsystems/lumiscan-cam-driver/system/control/restart/execute` auf. Eine Moduldatei kann auch auf dem Datenträger geändert werden. AI Object Matching und Calibration lesen ihre Moduldatei bei `reset` erneut ein; andernfalls wirkt eine Änderung beim nächsten Start. ## Template Finder, Object Finder, Area Detector, Text Reader: Module zur Laufzeit {#registry-apps} Ihre Module werden angelegt und entfernt, während die App läuft. | Knoten | Art | Wirkung | | --- | --- | --- | | `system/modules` | string[], schreibgeschützt | die aktuellen Module | | `system/create-module/execute` | Methode, Eingabe `input/module-id` | ein neues Modul mit Standardeingaben, sofort. Nach einem Neustart verschwunden, sofern nicht gespeichert | | `system/remove-module/execute` | Methode, Eingabe `input/module-id` | entfernt das Modul | | `system/save-current-modules/execute` | Methode | schreibt die Modulliste in die Anwendungsdatei und löscht die Eingabedateien von Modulen, die nicht mehr darin stehen | | `system/save-module-inputs/execute` | Methode, Eingabe `input/module-id` | schreibt die Eingaben des Moduls in `.json`, beim nächsten Start wiederhergestellt | Jeder Finder ergänzt eigene Funktionen, zum Beispiel Template Finder `system/create-template` und `system/set-template-dir`, Text Reader `system/set-tessdata-dir` und `system/refresh-languages`. Siehe das Handbuch der App. Beachten Sie, dass `create-module` zwei verschiedene Dinge bedeutet: in den Apps mit Einstellungsdateien eine Datei, die beim nächsten Neustart angewendet wird, in den Findern ein laufendes Modul, das beim nächsten Neustart verloren geht, sofern es nicht gespeichert wird. ## Was bei einem Neustart erhalten bleibt {#kept} | Was | Erhalten | | --- | --- | | Die Eingaben eines Finder-Moduls | wenn mit `system/save-module-inputs/execute` gespeichert; beim Start wiederhergestellt | | Die Modulliste einer Finder-App | wenn mit `system/save-current-modules/execute` gespeichert | | Einstellungen von Cam Driver, AI Object Matching und Calibration, die auf `system/settings` geschrieben wurden | ja, beim nächsten Start angewendet | | Zur Laufzeit gewählte Ordner (Template-, Objekt- und tessdata-Ordner) | ja, automatisch in der Anwendungsdatei gespeichert | | Der Stream eines Konsumenten | ja, siehe [Streams](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/streams.html#saved) | | Der Stream des Cam Driver und die Kameraverbindung | **nein**: Starten Sie sie nach jedem Start erneut | | Werte, die auf `input/` von Cam Driver, AI Object Matching und Calibration geschrieben wurden | **nein**: Schreiben Sie sie erneut | Es gibt keine Lademethode: Ohne Neustart liest nichts eine gespeicherte Datei erneut ein, außer dem `reset` von AI Object Matching und Calibration.