Einstellungen, Module und Neustart

Alles, was nicht ein einzelnes Modul betrifft, liegt unter hdvisionsystems/<app>/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).

Cam Driver, AI Object Matching, Calibration: Einstellungsdateien

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 <module-id>.json. Wird abgelehnt, wenn die Datei existiert

system/control/activate-module/execute, system/control/deactivate-module/execute

Methode, Eingabe control/<function>/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

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 <module-id>.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

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

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.