Zum Inhalt springen

Barcode Scanner Emulator

USB-HID- und serielle Barcodescanner

Ein Scanner im USB-HID-Tastatur-Wedge tippt den decodierten Barcode in die fokussierte Anwendung. Ein USB-Seriell-Scanner stellt eine serielle Schnittstelle bereit, oft als virtuellen COM-Port, und die Anwendung muss diesen Port öffnen und die Bytes lesen. USB ist das Kabel und der Bus. HID und seriell sind verschiedene Arten, die Daten bereitzustellen.

Wählen Sie die Schnittstelle, die die Anwendung tatsächlich lesen kann. Ein Kassenfeld, das Tippen schon annimmt, ist eine Aufgabe für den Tastatur-Wedge. Ein Dienst, der Scans empfangen muss, während kein Textfeld den Fokus hat, oder der Scannerbytes von der Tastatur getrennt halten muss, ist eine serielle Aufgabe. Viele Scanner bieten nur einen dieser Modi. Manche lassen sich umschalten. Die Anleitung dieses Modells ist die Liste der Modi, die Sie prüfen können.

Der Leitfaden HID-Tastatur-Wedge erklärt den Tastenweg im Einzelnen. Wie funktionieren Barcodescanner? behandelt Erfassung und Decodierung. Diese Seite vergleicht die beiden Host-Schnittstellen und die Tests, die zu jeder gehören.

Was ist der USB-HID-Tastatur-Wedge-Modus?

Im USB-HID-Tastaturmodus meldet sich der Scanner als Tastatur. Das Betriebssystem lädt seinen normalen Tastaturtreiber. Nach einer Decodierung sendet der Scanner die Zeichen als Tastenanschläge an das Steuerelement, das den Tastaturfokus hat. Ein Webformular, ein POS-Artikelfeld oder ein Desktop-Textfeld kann diese Eingabe ohne scannerspezifischen Code annehmen.

Der Fokus entscheidet das Ziel. Hat das vorgesehene Feld keinen Fokus, landen die Zeichen in einem anderen Steuerelement oder gehen verloren. Der Scanner klickt nicht und bewegt den Zeiger nicht.

Ein konfiguriertes Suffix kann der Nutzlast folgen. Enter sendet viele Formulare mit einem Feld ab. Tab verschiebt den Fokus zum nächsten Steuerelement. Keine der beiden Tasten ist garantiert. Die Suffixwahl steht in Suffixe ENTER und TAB bei Barcodescannern.

Gewöhnliche Tastaturereignisse enthalten weder den Hersteller des Scanners noch die Seriennummer noch ein Kennzeichen, dass die Tasten von einem Scanner kamen. Browser, die WebHID umsetzen, lehnen Tastaturschnittstellen weiterhin ab, deshalb kann eine Seite das Wedge-Gerät nicht öffnen und keine rohen HID-Reports lesen.

Was ist der USB-Seriell-Modus eines Barcodescanners?

Im USB-Seriell-Modus tippt der Scanner nicht. Er stellt über USB eine serielle Schnittstelle bereit. Das Betriebssystem zeigt diese Schnittstelle meist als virtuellen COM-Port: einen COM-Namen unter Windows, ein cu- oder tty-Gerät unter macOS oder ein ttyACM- oder ttyUSB-Gerät unter Linux. Den Namen vergibt der Treiber, und er kann sich ändern, nachdem der Scanner abgezogen wurde.

Ein virtueller COM-Port ist kein physischer RS-232-Port. RS-232 ist eine elektrische Schnittstelle mit eigenem Stecker und eigenen Spannungspegeln, die ein Computer über eine UART liest. USB-Seriell nutzt ein USB-Kabel. Die Anwendung öffnet weiterhin einen seriellen Port und liest Bytes, aber das Signal auf der Leitung ist USB. Manche Produkte sind ein echter RS-232-Scanner plus ein USB-zu-Seriell-Adapter. Andere setzen USB CDC um und sprechen nie RS-232. Behandeln Sie den Port, den das Betriebssystem anzeigt, als den Integrationspunkt, und nehmen Sie nicht an, dass die elektrischen Details übereinstimmen.

Die Anwendung öffnet den Port, liest den Bytestrom und entscheidet, wo eine Nachricht beginnt und endet. Ein üblicher Rahmen ist der Barcodetext, gefolgt von CR (0x0D), LF (0x0A) oder CR und danach LF. Diese Rahmung ist eine Geräteeinstellung, keine Regel von USB. Ein Präfixbyte wie STX ist ebenfalls möglich. Der Leitfaden Präfix und Suffix beim Barcodescanner: Vollständiger Leitfaden trennt diese Bytes von der Enter-Taste, die ein Wedge-Scanner sendet.

Baudrate, Datenbits, Parität und Stoppbits zählen an einer echten UART und an vielen USB-zu-Seriell-Adaptern. Eine falsche Rate erzeugt Zeichensalat statt eines klaren Fehlers. Manche virtuellen USB-CDC-COM-Geräte ignorieren die vom Host verlangte Baudrate und liefern die Bytes trotzdem. Es gibt keine einzelne Einstellung, die zu jedem virtuellen seriellen Scanner passt. Nutzen Sie Rate und Rahmung aus der Anleitung dieses Modells und bestätigen Sie sie mit einem bekannten Barcode.

Der Prozess, der den Port offen hält, empfängt die Daten. Der Tastaturfokus wählt das Ziel nicht. Ein anderes Programm, das den Port schon geöffnet hat, blockiert ein zweites Öffnen. Zieht man den Scanner ab, verschwindet der Port. Steckt man ihn wieder ein, kann ein neuer Name entstehen, und die Anwendung muss diesen Port erneut öffnen.

HID und seriell

Merkmal HID-Tastatur-Wedge USB-Seriell
Datenübergabe Tastaturartige Eingabe Serieller Bytestrom
Eingabefokus erforderlich Ja. Tastenanschläge folgen dem fokussierten Steuerelement Nein. Bytes gehen an den Prozess, der den Port geöffnet hat
Browserintegration Gewöhnliche Eingabe und Tastaturereignisse Web Serial, wo der Browser es unterstützt, oder Software außerhalb der Seite
Steuerung durch die Anwendung Beschränkt auf Tastaturverhalten, Fokus und Suffixe Die Anwendung liest den Strom und rahmt ihn
Geräteidentifikation Aus gewöhnlichen Tastaturereignissen nicht verfügbar Das Betriebssystem kann einen Portnamen anzeigen. Eine stabile Identität hängt weiter vom Treiber ab
Konfiguration Scannereinstellungen, einschließlich Suffix und Tastaturlayout Scannereinstellungen plus die Host-Porteinstellungen, die das Gerät tatsächlich nutzt
Typischer Einsatz Formulare und POS-Artikeleingabe Eigene Integrationen, die das Gerät besitzen

Das sind die üblichen Fälle. Ein bestimmtes Modell, Betriebssystem und ein bestimmter Treiber können abweichen. Ein Bluetooth-Scanner im HID-Tastaturmodus folgt auf der Anwendungsebene der Wedge-Spalte. Bluetooth SPP folgt der seriellen Spalte.

Wie HID-Scanner in Webanwendungen arbeiten

Ein Wedge-Scan aktualisiert das fokussierte Element. Druckbare Zeichen lösen keydown und danach input aus. Enter und Tab lösen keydown aus und fügen in ein normales Texteingabefeld kein Zeichen ein. event.key ist "Enter" oder "Tab" für diese Tasten und eine Zeichenkette aus einem Zeichen für ein druckbares Zeichen. event.code benennt die physische Taste und kann gleich bleiben, wenn ein abweichendes Tastaturlayout event.key ändert.

Der Listener unten übernimmt das Feld nur, wenn Enter eintrifft. Ein Scanner ohne Enter-Suffix lässt den Text im Feld stehen.

const field = document.querySelector('#barcode')

if (!(field instanceof HTMLInputElement)) {
  throw new Error('Barcode field was not found.')
}

field.addEventListener('keydown', (event) => {
  if (event.key !== 'Enter') {
    return
  }

  event.preventDefault()
  const value = field.value.trim()
  if (!value) {
    return
  }

  console.log(value)
  field.value = ''
})

Fokussieren Sie #barcode vor dem Scan. preventDefault() hält ein übergeordnetes Formular davon ab, ein zweites Mal abzusenden. Sendet der Scanner stattdessen Tab, lesen Sie den Wert in diesem keydown und lassen Sie den Browser den Fokus verschieben. Sendet er keines von beiden, senden Sie das Feld über eine Schaltfläche oder eine andere ausdrückliche Aktion ab. Eine Pause beim Tippen ist nur eine Heuristik für das Ende eines Scans.

Nichts in diesen Ereignissen identifiziert das USB-Gerät. Eine Person, ein Makro oder der Emulator kann dieselbe Folge erzeugen. Die Prüfung gehört zur Nutzlast. Der Browserablauf, einschließlich Tab und leerer Eingabe, steht in So testen Sie Barcodescanner in Webanwendungen.

Wie serielle Scanner in Anwendungen arbeiten

Eine serielle Integration öffnet einen Port, liest Bytes, teilt sie in Nachrichten und behandelt das Verschwinden des Ports. Auf dem Desktop ist das die serielle API des Betriebssystems oder eine Herstellerbibliothek. Im Browser ist die einzige eingebaute Möglichkeit die Web Serial API, und nur in Browsern, die sie umsetzen.

Web Serial ist in Chromium-basierten Browsern verfügbar. Firefox und Safari stellen sie nicht bereit. Die Seite muss ein sicherer Kontext sein, also HTTPS oder localhost. requestPort() muss aus einer Benutzergeste laufen, und der Benutzer muss den Port in der Browserabfrage wählen. Ein Tastatur-Wedge-Scanner erscheint nicht in dieser Liste, weil er kein serielles Gerät ist. Web Serial sieht auch keinen seriellen Port, den das Betriebssystem nicht freigegeben hat.

Die Baudrate im Beispiel ist ein Anfangswert, den Sie durch den Wert aus der Anleitung ersetzen. Die Schleife behandelt CR oder LF als Ende einer Nachricht und verbraucht ein CRLF-Paar als einen Abschluss. Nutzt Ihr Scanner einen anderen Rahmen, ist diese Trennung falsch, auch wenn der Port offen ist.

<button id="open-serial" type="button">Open scanner port</button>
<p id="status" role="status"></p>
<script>
  const button = document.querySelector('#open-serial')
  const status = document.querySelector('#status')

  function takeLine(buffer) {
    const cr = buffer.indexOf('\r')
    const lf = buffer.indexOf('\n')
    const end = cr < 0 ? lf : lf < 0 ? cr : Math.min(cr, lf)
    if (end < 0) {
      return null
    }

    const line = buffer.slice(0, end).trim()
    let rest = buffer.slice(end + 1)
    if (buffer[end] === '\r' && rest.startsWith('\n')) {
      rest = rest.slice(1)
    }

    return { line, rest }
  }

  button.addEventListener('click', async () => {
    if (!('serial' in navigator)) {
      status.textContent = 'This browser does not provide Web Serial.'
      return
    }

    let port
    try {
      port = await navigator.serial.requestPort()
      await port.open({ baudRate: 9600 })
    } catch (error) {
      status.textContent = 'The port was not opened.'
      return
    }

    const reader = port.readable.getReader()
    const decoder = new TextDecoder()
    let buffer = ''

    try {
      while (true) {
        const { value, done } = await reader.read()
        if (done) {
          break
        }

        buffer += decoder.decode(value, { stream: true })
        let next = takeLine(buffer)
        while (next) {
          if (next.line) {
            status.textContent = next.line
          }
          buffer = next.rest
          next = takeLine(buffer)
        }
      }
    } catch (error) {
      status.textContent = 'The serial read stopped.'
    } finally {
      reader.releaseLock()
      await port.close()
    }
  })
</script>

Die Leseschleife läuft, bis der Strom endet oder das Lesen fehlschlägt. Das Abziehen des Scanners weist das Lesen typischerweise zurück. releaseLock() und close() laufen in finally. Zuvor für diesen Ursprung freigegebene Ports lassen sich mit navigator.serial.getPorts() auflisten, ohne die Abfrage erneut zu zeigen. Die erste Freigabe verlangt weiterhin den Benutzer.

Eine Desktop-Anwendung folgt derselben Idee mit der seriellen API der Plattform: öffnen, lesen, rahmen und nach der Rückkehr des Geräts erneut öffnen. Diese Seite erfindet keine Herstellerbefehle. Erwartet der Scanner ein proprietäres Protokoll, steht dieses Protokoll in der Dokumentation des Herstellers.

Was ist besser: HID oder seriell?

Keiner der Modi ist für jedes Produkt besser. Nutzen Sie den Modus, den der Scanner tatsächlich bietet, und den Modus, den die Anwendung lesen kann.

Wählen Sie HID, wenn

  • die Anwendung Tastatureingaben in einem fokussierten Feld schon annimmt.
  • ein Formular oder ein POS-Bildschirm ohne Gerätecode arbeiten soll.
  • der Ablauf den Fokus vor jedem Scan sichern kann.
  • Enter oder Tab dazu passt, wie dieses Formular abschließt oder weitergeht.

Ziehen Sie seriell in Betracht, wenn

  • Scans ankommen müssen, während der Fokus in einem Dialog, auf einer Schaltfläche oder nirgends liegt.
  • Scannerbytes vom Tippen getrennt bleiben müssen.
  • die Anwendung einen Port öffnen, Nachrichten rahmen und sich erholen kann, wenn das Gerät abgezogen wird.
  • der Host die Erlaubnis für diesen Port erteilen kann und kein anderer Prozess ihn gleichzeitig braucht.

Ein Scanner, der sich nur als Tastatur meldet, lässt sich auf dem Host nicht per Software auf seriell umstellen. Bestätigen Sie die Modi in der Anleitung, bevor Sie die Integration entwerfen.

Zwischen HID und seriell wechseln

Manche Scanner wechseln den Modus, wenn Sie einen Konfigurationsbarcode aus der Anleitung dieses Herstellers scannen oder ein Profil mit dem Programm des Herstellers schreiben. Andere sind als eine Schnittstelle gebaut und haben nichts umzuschalten.

Es gibt keinen Konfigurationsbarcode, der jede Marke ändert. Eine Folge, die für ein anderes Modell gedruckt wurde, kann nichts bewirken oder den Scanner in einem unerwarteten Modus lassen. Prüfen Sie nach jeder Änderung, was das Betriebssystem zeigt: eine Tastatur, einen COM-Port oder beides. Testen Sie dann den Weg, den Ihre Anwendung nutzt. Der Leitfaden zur Konfiguration von Barcodescannern beschreibt die üblichen Einstellungsgruppen. Er ersetzt die Anleitung nicht.

Einen HID-Scanner testen

  1. Schließen Sie den Scanner an und bestätigen Sie, dass er im Tastatur-Wedge-Modus ist. Ein Texteditor sollte Zeichen empfangen, wenn ein Feld in diesem Editor den Fokus hat.
  2. Öffnen Sie den Barcode-Eingabetester.
  3. Klicken Sie auf Start Test oder auf den Scanbereich. Er wird blau, wenn er bereit ist. Die Seite nimmt den Fokus nicht von selbst.
  4. Scannen Sie einen Barcode, dessen Nutzlast Sie schon kennen.
  5. Vergleichen Sie den erfassten Wert und die Zeichenzahl mit dieser Nutzlast.
  6. Lesen Sie das Suffix: ENTER, TAB oder None. Enter und Tab gehören nicht zur Barcodezeichenfolge.

Der Tester zeichnet Tastaturereignisse auf, die der Browser sehen kann. Er kann keinen seriellen Port lesen und das USB-Gerät nicht identifizieren. Liegt der mittlere Abstand zwischen den Zeichen unter 100 ms, meldet er diese Zeit. Die Zeit ist keine Hardware-Identifikation. Für jedes keydown, einschließlich key und code, nutzen Sie den Tastaturereignis-Tester. Ein breiterer QA-Durchgang steht in So testen Sie die Eingabe eines Barcodescanners.

Einen seriellen Scanner testen

Der Barcode-Eingabetester öffnet keinen COM-Port. Ein serieller Test braucht ein Programm, das den Port öffnen kann, den der Scanner bereitstellt.

  1. Bestätigen Sie, dass der Scanner in einem seriellen Modus ist und dass das Betriebssystem bei Verbindung einen Port auflistet. Ziehen Sie ihn ab und prüfen Sie, dass der Port verschwindet.
  2. Notieren Sie den Portnamen. Er ist betriebssystemspezifisch und kann sich beim nächsten Einstecken ändern.
  3. Öffnen Sie den Port aus einer passenden Anwendung: einem seriellen Terminal, Ihrer Desktop-App oder dem Web-Serial-Beispiel oben in einem Chromium-Browser unter HTTPS oder localhost.
  4. Setzen Sie Baudrate, Datenbits, Parität und Stoppbits, wenn die Anleitung sie nennt. Überspringen Sie erfundene Werte.
  5. Scannen Sie einen bekannten Barcode.
  6. Vergleichen Sie die Bytes oder den decodierten Text mit dieser Nutzlast.
  7. Prüfen Sie die Rahmung. Suchen Sie ein Präfix und nach den Daten CR, LF oder CRLF, nur wenn die Anleitung das so eingestellt hat.

Schlägt das Öffnen fehl, weil der Port belegt ist, schließen Sie das andere Programm, das ihn hält. Ist der Text Zeichensalat, passen die Leitungseinstellungen nicht zum Gerät. Erscheint der Port nie, kann der Scanner noch im Tastaturmodus sein, der Treiber fehlen oder dem Betriebssystembenutzer das Öffnen serieller Geräte verwehrt sein.

Häufige Probleme

Der Scanner arbeitet in einem Texteditor und nicht in der Zielanwendung. Das Gerät tippt. Das Ziel hat keinen Fokus, oder ein keydown-Listener verwirft die Tasten. Beginnen Sie mit Scanner funktioniert im Notepad, aber nicht im POS.

Der Scanner tippt in kein Textfeld. Er kann im seriellen Modus sein, ausgeschaltet sein oder das Symbol nicht lesen. Ein Scanner im seriellen Modus tippt nicht. Suchen Sie einen COM-Port, bevor Sie das Feld untersuchen. Barcodescanner funktioniert nicht trennt einen toten Scanner von der falschen Schnittstelle.

Der serielle Port fehlt. Der Tastaturmodus erzeugt keinen COM-Port. Ein fehlender Treiber, ein reines Ladekabel oder ein Scanner ohne seriellen Modus erzeugen dasselbe Symptom. Beobachten Sie die Geräteliste des Betriebssystems, während Sie den Scanner einstecken.

Der serielle Port ist schon in Gebrauch. Nur ein Prozess kann ihn lesen. Schließen Sie das Terminal oder die andere Kopie der Anwendung und öffnen Sie ihn erneut.

Die Kommunikationseinstellungen sind falsch. Abweichende Baudrate, Parität oder Stoppbits sehen wie zufällige Zeichen aus. Setzen Sie die Werte aus der Anleitung dieses Modells und scannen Sie einen bekannten Code erneut.

ENTER oder TAB kommt nie an. Das ist eine Wedge-Suffixeinstellung. Der Eingabetester meldet None. Siehe Barcodescanner sendet kein ENTER und den oben verlinkten Suffix-Leitfaden. Ein serieller Scanner sendet nicht die Enter-Taste. Er kann stattdessen CR- oder LF-Bytes senden.

Die Zeichen sind an einem Wedge-Scanner falsch. Das Tastaturlayout des Scanners und das Layout des Betriebssystems können voneinander abweichen. Serielle Bytes werden von diesem Layout nicht neu zugeordnet. Siehe Falsches Tastaturlayout am Barcodescanner.

Der Browser kommt nicht an den Scanner. Ein Wedge-Scanner erscheint nicht in der Web-Serial-Abfrage. Firefox und Safari haben keine Web Serial API. Eine Seite, die nicht HTTPS oder localhost ist, kann sie nicht nutzen. Der Benutzer kann die Portabfrage auch schließen.

Die Anwendung verliert den Scanner, nachdem er abgezogen wurde. Ein Wedge-Scanner kehrt als Tastatur zurück, und der nächste Scan verlangt weiterhin Fokus. Ein serieller Port ist weg, bis die Anwendung den neuen Port öffnet. Der Name muss nicht zum vorherigen passen.

Integrationsszenarien

Webanwendungen

Der Tastatur-Wedge passt zu einem fokussierten Eingabefeld und zu gewöhnlichen DOM-Ereignissen. Serieller Zugriff in der Seite bedeutet Web Serial in einem unterstützenden Browser, einen sicheren Kontext und einen vom Benutzer gewählten Port. Eine Seite, die Firefox, Safari und unbeaufsichtigte Kioske unterstützen muss, kann sich nicht allein auf Web Serial stützen. Ein lokaler Helfer kann den COM-Port besitzen und vollständige Barcodes an die Seite weitergeben. Dieser Helfer ist eigene Software. Die Seite sollte nicht erwarten, dass ein Wedge-Test ihn mit ausübt.

POS-Systeme

Ein POS, das den Fokus ins Artikelfeld legt und mit Enter abschließt, ist eine Wedge-Integration. Ein POS, das scannen muss, während ein Dialog offen ist, oder das die Tastatur ignorieren muss, ist eine serielle Integration. Beides zu mischen erzeugt Scans im falschen Feld oder Scans, die nie ankommen. Passen Sie den Scannermodus an den Bildschirm an, der tatsächlich im Dienst ist.

Desktop-Anwendungen

Eine Desktop-App kann Wedge-Eingaben in dem Steuerelement annehmen, das den Fokus hat, oder den virtuellen COM-Port öffnen und eine Sitzung für die Lebensdauer des Prozesses halten. Portbesitz, Wiederverbinden und Rahmung gehören zu dieser Sitzung. Der Fokus nicht.

QA-Automatisierung

Der Barcode Scanner Emulator tippt einen von Ihnen gewählten Wert in die fokussierte Anwendung und kann ENTER, TAB oder kein Suffix senden. Das deckt Regressionen des Tastatur-Wedge ab: Fokus, Prüfung und Suffixbehandlung. Er erzeugt keinen virtuellen COM-Port, zählt keine USB-Geräte auf und bildet Baudrate und Rahmung nicht nach. Serielle Tests brauchen weiterhin einen seriellen Port und ein Leseprogramm oder ein Test-Double, das dieselbe Byte-Rahmung schreibt, die Ihre Anwendung zerlegt.

Kiosk-Anwendungen

Ein Kiosk mit Wedge-Eingabe muss das Scanfeld über Dialoge, Bildschirmschoner und Fehlermeldungen hinweg fokussiert halten. Ein verlorener Fokus, und der nächste Scan trifft ein Kürzel oder nichts. Ein Kiosk mit serieller Verbindung kann den Port ohne diesen Fokus lesen und muss die Erlaubnis für das Gerät behalten und den Port nach Stromausfall oder gezogenem Kabel erneut öffnen.

Wo der Barcode Scanner Emulator hingehört

Der Barcode Scanner Emulator ist eine Desktop-App für Windows, macOS und Linux. Er bildet den Tastaturweg nach, den ein Wedge-Scanner nutzt. Sie geben den Text ein, wählen eine Tippverzögerung und wählen ein Suffix von keinem, ENTER oder TAB. Ein globales Kürzel tippt diesen Text in die fokussierte Anwendung.

Nutzen Sie ihn, um HID-artige Formulare zu entwickeln und auf Regressionen zu prüfen, wenn der Scanner nicht auf dem Tisch liegt. Kombinieren Sie ihn mit dem Barcode-Eingabetester, um den Wert, die Präfixtasten und das Suffix zu sehen, die der Browser empfangen hat.

Er emuliert kein USB-Seriell-Gerät, keinen virtuellen COM-Port, keine USB-Enumeration und keine optische Decodierung. Diese Verhaltensweisen gehören weiterhin zur Hardware oder zu einem seriellen Test-Double, das Sie steuern.