Data-Layer-Referenz

Alle Knoten liegen unter dem Basispfad der Anwendung:

hdvisionsystems/lumiscan-aztec-code-reader/

Die Pfade unten sind relativ dazu angegeben. Ein einzelner Lesevorgang verwendet vier Knoten; der Bild-Stream (experimentell) fügt die unter Bild-Stream aufgeführten Knoten hinzu, und System gibt an, was seine Quelle enthalten muss.

Data Layer

LumiScan Aztec Code Reader bietet seine Funktionen auf dem Data Layer unter hdvisionsystems/lumiscan-aztec-code-reader an.

Auf ctrlX OS (ctrlX CORE oder ctrlX IPC) nutzt LumiScan Aztec Code Reader den ctrlX Data Layer.

Auf einem PC mit Windows 11 oder Ubuntu 24.04 nutzt LumiScan Aztec Code Reader LumiScan Keryx.

Knotenadressen, Typen und Aufrufmuster sind auf beiden gleich. LumiScan Aztec Code Reader bietet:

  • Execute-Methoden

  • ein Stream-Abonnement auf eine Quelle (experimentell)

  • keine Modulebene: Seine Knoten liegen direkt unter hdvisionsystems/lumiscan-aztec-code-reader

Wie Adressen aufgebaut sind, wie Funktionen aufgerufen werden, die Statuscodes und die Werkzeuge sind in LumiScan Keryx beschrieben.

Knotenbaum

hdvisionsystems/lumiscan-aztec-code-reader/
├── input/
│   ├── image-address        (string)      address of the image node to read
│   └── parameter            (flatbuffers) detection parameters
├── execute                  (method)      read every Aztec code in that image
├── output/
│   └── results              (flatbuffers) one entry per code found
├── control/
│   ├── subscribe/                         the image stream (experimental)
│   │   ├── execute
│   │   ├── input/{enable,address,tag,queue-size,keep-latest-output}
│   │   └── output/stream/...              the image stream's results
│   └── unsubscribe/{execute,input/address}
├── setting/{stream,settings-hash}
└── system/meta/subscription-schema    (string)      what the stream's source must hold

Eingabe

Knoten Typ Zugriff Beschreibung

input/image-address

string

lesen, schreiben

Adresse des zu lesenden Data-Layer-Bildknotens. Der Reader hängt /data, /width, /height und /pixel-type an. Standardmäßig leer, wodurch ein Lauf fehlschlägt, bis die Adresse gesetzt ist.

input/parameter

flatbuffers

lesen, schreiben

Erkennungsparameter, Typ types/hdvisionsystems/lumiscan-aztec-code-reader/code_detect_parameters. Siehe den Hinweis unten.

input/parameter enthält in dieser Version keine Einstellungen — seine Tabelle DetectionParameters ist leer. Der Knoten existiert, damit Feineinstellungen hinzugefügt werden können, ohne den Knotenbaum zu ändern. Ein Schreibvorgang darauf ändert nichts daran, wie ein Code gelesen wird. Der Bild-Stream liest ihn ebenfalls nicht.

Methode

Knoten Blockierend Wirkung

execute

Ja

Liest das Bild unter input/image-address und schreibt jeden gefundenen Aztec-Code nach output/results. Nimmt kein Argument entgegen — schreiben Sie einen leeren Wert.

Ausgabe

Knoten Typ Zugriff Beschreibung

output/results

flatbuffers

lesen

Jeder Code, den der letzte erfolgreiche Lauf gefunden hat, Typ types/hdvisionsystems/lumiscan-aztec-code-reader/code_detect_result. Leeres Array, wenn das Bild keinen Code enthielt. Siehe Das Ergebnis.

Bild-Stream (experimentell)

Der Reader liest jeden Frame des Cam-Driver-Streams, den er abonniert hat, so wie execute ein Bild liest, und veröffentlicht ein Ergebnis pro Frame. Siehe Codes auf einem Bild-Stream lesen.

Knoten Typ Zugriff Beschreibung

control/subscribe/input/enable

bool

lesen, schreiben

Stream-Modus: true lässt den Stream laufen, false stoppt ihn.

control/subscribe/input/address

string

lesen, schreiben

Die eine Quelle: der Stream-Ordner einer Kamera, zum Beispiel hdvisionsystems/lumiscan-cam-driver/camera1/control/publish/output/stream. Eine andere Adresse ersetzt sie.

control/subscribe/input/tag

string

lesen, schreiben

Das Tag auf den Ergebnissen des Readers: Der Schritt des Readers in der Lineage jedes Stream-Ergebnisses trägt es. Leer: der Name des Readers, lumiscan-aztec-code-reader. Ein neues Tag behält die Quelle; das nächste Ergebnis trägt es.

control/subscribe/input/queue-size

uint32

lesen, schreiben

Wie viele Frames warten dürfen, während ein Frame gelesen wird, 1 bis 64.

control/subscribe/input/keep-latest-output

bool

lesen, schreiben

true, um jedes Stream-Ergebnis zusätzlich nach output/results zu schreiben.

control/unsubscribe/input/address

string

lesen, schreiben

Die zu entfernende Quelle, so wie setting/stream/address sie anzeigt.

setting/stream/enable, address, tag, queue-size, keep-latest-output

wie die Eingaben

lesen

Was control/subscribe/execute oder control/unsubscribe/execute zuletzt angewendet hat, so wie aztec-code-reader.json es unter stream speichert.

setting/settings-hash

string

lesen

Der Hash dessen, womit die Ergebnisse erzeugt werden, als 16 Hexadezimalziffern.

control/subscribe/output/stream/active

bool

lesen

true, solange der Stream läuft.

control/subscribe/output/stream/result

flatbuffers

lesen

Ein Ergebnis pro gelesenem Frame, Typ types/hdvisionsystems/lumiscan-aztec-code-reader/stream_codes: die lineage des Frames und result, die Tabelle, die output/results enthält. Abonnieren Sie den Knoten, um jedes Ergebnis zu erhalten.

control/subscribe/output/stream/last-failure

string

lesen

Warum der letzte Frame, der nicht gelesen werden konnte, fehlgeschlagen ist; nennt die Quelle mit ihrer Adresse.

control/subscribe/output/stream/statistics/elapsed-ms, received-frames, processed-frames, skipped-frames, failed-frames, lost-frames, processing-us

uint64

lesen

Die Zähler des Streams, siehe Die Statistik lesen.
Knoten Blockierend Wirkung

control/subscribe/execute

Ja

Prüft die Eingaben von control/subscribe gemeinsam, speichert sie in aztec-code-reader.json und wendet sie dann an. Eine Eingabe allein zu schreiben ändert nichts. Wird abgelehnt bei Stream-Modus ohne Adresse oder einer Warteschlangengröße außerhalb von 1 bis 64.

control/unsubscribe/execute

Ja

Entfernt die in control/unsubscribe/input/address genannte Quelle, womit der Stream-Modus endet; das Tag bleibt. Wird wie ein Subscribe in aztec-code-reader.json gespeichert. Wird abgelehnt, wenn die Adresse nicht die Quelle ist.

Die Eingaben von control/subscribe sind mit den angewendeten Werten vorbelegt, und nur control/subscribe/execute wendet sie an. Wenn aztec-code-reader.json nicht geschrieben werden kann, antworten beide Methoden mit CreationFailed (ctrlX DL_CREATION_FAILED) und ändern nichts. Ein abgelehnter Aufruf antwortet mit Rejected (ctrlX DL_INVALID_VALUE). Siehe Ergebnisse eines Methodenaufrufs.

System (experimentell)

Knoten Typ Zugriff Beschreibung

system/meta/subscription-schema

string

lesen

Was der Knoten, den der Reader abonniert, enthalten muss: ein JSON Schema (draft-04) seiner JSON-Form. Hier der Knoten frame des abonnierten Stream-Ordners, ein stream_image: ein Objekt mit lineage und image. Experimentell.

In dieser Version nicht vorhanden

Wer von den anderen LumiScan-Anwendungen kommt, sollte wissen, was diese Anwendung nicht veröffentlicht:

  • Kein Statusknoten. Es gibt keinen status-code und keinen status-text; ein fehlgeschlagener Lauf wird nur im Protokoll der Anwendung gemeldet (auf ctrlX OS im Systemprotokoll von ctrlX OS) und lässt in output/results die Codes des vorherigen Laufs stehen.

  • Kein Daten-Identifier. Es gibt nichts, was zurückgegeben wird; ein Ergebnis lässt sich also nicht dem Request zuordnen, der es erzeugt hat.

  • Kein Ergebnisbild. Die Anwendung rendert nichts — kein Knoten result-image und keine Methode plot. Verwenden Sie LumiScan Cockpit, um die Codes im Bild gezeichnet zu sehen.

  • Keine Module. Ein Reader pro Installation, unter dem einen Basispfad oben.

  • Keine Region of Interest. Jeder Lauf durchsucht das ganze Bild.