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 ECC 200 Data-Matrix-Codes, den Standard mit quadratischen Modulen, der für die Teilekennzeichnung und die Direktmarkierung (Direct Part Marking) verwendet wird. Jeder im Bild gefundene Code wird gemeldet; es gibt keine Begrenzung auf einen Code pro Lauf. Es sind weder Vorlage, Referenzbild, Trainingsschritt noch Konfiguration nötig: 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 dem selben 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 Rücksicht auf 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-dmc-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 daher als Zahlen. center und text sind immer vorhanden; polygons kann bei einem Eintrag fehlen, was „kein Umriss angegeben“ bedeutet und kein Fehler ist.

Das Ergebnis

Dieser Reader veröffentlicht keinen Knoten status-code oder status-text und gibt keine Kennung 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; der Knoten enthält weiterhin die 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; auch der Bild-Stream liest ihn nicht. Es gibt keine Region of Interest: Jeder Lauf durchsucht das gesamte 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 mit dem Namen datamatrix-code und zeichnet um jeden Code ein Rechteck, beschriftet mit dem dekodierten Text und dem Score. Ein Code, der lokalisiert, 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 gesamte Bild durchsucht wird.

Voraussetzungen

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

Codes auf einem Bild-Stream lesen, Streams

In dmc-reader.json im Konfigurationsverzeichnis der Anwendung: auf ctrlX OS /var/snap/rexroth-solutions/common/solutions/activeConfiguration/lumiscan-dmc-reader, unter Windows C:\ProgramData\HD Vision Systems GmbH\LumiScan Vision Suite\lumiscan-dmc-reader\etc\lumiscan-dmc-reader (oder %APP_RESOURCE_DIR%\etc\lumiscan-dmc-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-dmc-reader --generate-settings <folder> ein Beispiel als Ausgangspunkt.

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 LumiScan-FAQ der gesamten Dokumentation. Wenden Sie sich an den Customer Success von HD Vision Systems unter customer.success@hdvisionsystems.com oder +49 6221 6721905; bei Lizenzfragen an licenses@hdvisionsystems.com.

FAQ zur Lizenzierung