FAQ

Ja. Auf ctrlX OS (ctrlX CORE oder ctrlX IPC) verwendet er den ctrlX Data Layer; auf einem PC (Windows 11 oder Ubuntu 24.04) verwendet er LumiScan Keryx, den Data Layer von HD Vision Systems für PCs. Die Knotenadressen, Typen und das Verhalten sind auf beiden gleich; ein Programm, das für den einen geschrieben wurde, funktioniert also auch mit dem anderen.

Data-Layer-Referenz, ctrlX Data Layer und LumiScan Keryx

Er liest lineare (1D-)Barcodes. Der Reader ist für die gesamte lineare Familie von ZXing konfiguriert und nicht für eine einzelne Symbologie; Code 128, Code 39, EAN-13 und UPC-A werden also unter anderem alle mit demselben Aufruf gelesen. Die Symbologie muss nicht vorab bekannt sein. Jeder im Bild gefundene Code wird gemeldet; es gibt keine Beschränkung auf einen Code pro Lauf. Es werden weder Vorlage, Referenzbild, Trainingsschritt noch Konfiguration benötigt: Sie geben dem Reader die Adresse eines Bildes und rufen execute auf.

Beschreibung

Der Reader spricht nicht selbst mit einer Kamera. Er liest den in input/image-address genannten Bildknoten, den eine andere Anwendung veröffentlicht: auf ctrlX OS eine auf demselben Gerät (der Zugriff auf einen entfernten Data Layer wird nicht unterstützt), auf einem PC eine, die mit demselben LumiScan Keryx verbunden ist. Normalerweise ist das LumiScan Cam Driver, zum Beispiel hdvisionsystems/lumiscan-cam-driver/camera1/output/image. Der Knoten muss data (rohe, unkomprimierte uint8-Pixeldaten), width, height und pixel-type (Name des GenICam-Pixelformats) bereitstellen. Geben Sie die Adresse des Bildknotens selbst an, nicht die seines Kindknotens data: Der Reader hängt /data, /width, /height und /pixel-type an.

Voraussetzungen, Einen Code lesen

Mono8, Mono12, RGB8, RGB12, BGR8, BGR12, Bayer_GR8, Bayer_RG8, Bayer_GR12 und Bayer_RG12. Der Name wird ohne Beachtung der Groß- und Kleinschreibung verglichen, und bei den Bayer-Namen darf der Unterstrich entfallen (BayerGR8 und bayer_gr8 sind dasselbe Format). Bayer-Bilder werden vor der Suche in Farbbilder umgewandelt. Jedes andere Pixelformat wird abgelehnt, und der Lauf liefert kein Ergebnis. Die Bilddaten müssen für das angegebene Format mindestens width x height x bytes-per-pixel Bytes umfassen; ein kürzerer Puffer wird abgelehnt.

Voraussetzungen

Alle Pfade sind relativ zu hdvisionsystems/lumiscan-barcode-reader.

Einen Code lesen

output/results ist ein Flatbuffer (CodeDetectResultArray.results) mit einem Eintrag pro Code: center (ein Point2f mit x und y in Bildpixeln), text (der dekodierte Inhalt), score (wie sicher das Leseergebnis ist) und polygons (die Eckpunkte, die den Code umreißen). Auf ctrlX OS kommen die Zahlen über die ctrlX REST API in Anführungszeichen zurück, als Strings; parsen Sie sie also als Zahlen. center und text sind immer vorhanden; polygons kann bei einem Eintrag fehlen, was bedeutet, dass keine Umrandung angegeben wurde, nicht, dass ein Fehler vorliegt.

Das Ergebnis

Dieser Reader veröffentlicht keinen Knoten status-code oder status-text und gibt keinen Identifier zurück. Ein Lauf schlägt fehl, wenn das Bild nicht gelesen werden kann: keine Adresse gesetzt, eine Adresse, die sich nicht auflösen lässt, ein fehlender oder zu kurzer data-Puffer oder ein nicht unterstütztes Pixelformat. Ein fehlgeschlagener Lauf lässt output/results unverändert, mit den Codes des vorherigen Laufs.

Prüfen Sie das Protokoll der Anwendung (auf ctrlX OS das Systemprotokoll), in das der Grund geschrieben wird, oder lesen Sie output/results vor und nach dem Lauf und vergleichen Sie.

Einen Code lesen, Data-Layer-Referenz

Nein, nicht in dieser Version. input/parameter enthält keine Einstellungen (seine Tabelle DetectionParameters ist leer); ein Schreibvorgang darauf ändert also nichts, und auch der Bild-Stream liest ihn nicht. Es gibt keine Region of Interest: Jeder Lauf durchsucht das ganze Bild. Es gibt keine Module: ein Reader pro Installation, unter einem einzigen Basispfad. Es gibt auch kein Ergebnisbild; verwenden Sie LumiScan Cockpit, um die Codes zu sehen.

Data-Layer-Referenz

Öffnen Sie LumiScan Cockpit. Es führt den Reader als Ansicht namens bar-code und zeichnet ein Rechteck um jeden Code, beschriftet mit dem dekodierten Text und dem Score. Ein Code, der gefunden, aber nicht dekodiert wurde, hat keinen Text und wird nur mit seinem Score beschriftet.

Das Ergebnis

Das Lesen ist synchron: Der Schreibvorgang auf execute kehrt zurück, wenn die Suche abgeschlossen ist. Wie lange das dauert, hängt von der Bildgröße ab, da bei jedem Lauf das ganze Bild durchsucht wird.

Voraussetzungen

Ja, als experimentelle Funktion. Der Reader abonniert den Stream einer Kamera von LumiScan Cam Driver und liest jeden Barcode in jedem Frame, sobald er eintrifft, genau so, wie execute ein Bild liest. Alle Pfade sind relativ zu hdvisionsystems/lumiscan-barcode-reader.

Codes auf einem Bild-Stream lesen, Streams

In barcode-reader.json im Konfigurationsverzeichnis der Anwendung: auf ctrlX OS /var/snap/rexroth-solutions/common/solutions/activeConfiguration/lumiscan-barcode-reader, unter Windows C:\ProgramData\HD Vision Systems GmbH\LumiScan Vision Suite\lumiscan-barcode\etc\lumiscan-barcode-reader (oder %APP_RESOURCE_DIR%\etc\lumiscan-barcode-reader). control/subscribe/execute und control/unsubscribe/execute speichern dort, was sie anwenden, und nach einem Neustart streamt ein Reader, der gestreamt hat, sofort wieder. Auf einem PC schreibt lumiscan-barcode --generate-settings <folder> ein Beispiel, mit dem Sie beginnen können.

In der Einstellungsdatei gespeichert

Ist eine Advanced-Lizenz verfügbar, verwendet die Anwendung sie automatisch. Ist keine verfügbar, läuft sie mit den Standard-Funktionen, statt den Start zu verweigern.

Voraussetzungen, FAQ zur Lizenzierung

Ein Lizenzplatz deckt den Reader ab, da es einen Reader pro Installation gibt. Bezugswege:

Voraussetzungen, FAQ zur Lizenzierung

Siehe die übergreifende LumiScan-FAQ. Wenden Sie sich an den Customer Success von HD Vision Systems unter customer.success@hdvisionsystems.com oder +49 6221 6721905; für Lizenzen an licenses@hdvisionsystems.com.

FAQ zur Lizenzierung