Naar inhoud springen

Barcode Scanner Emulator

USB-HID- en seriële barcodescanners

Een scanner met USB-HID-toetsenbordwig typt de gedecodeerde barcode in de toepassing die de focus heeft. Een USB-seriële scanner biedt een seriële interface, vaak als virtuele COM-poort, en de toepassing moet die poort openen en de bytes lezen. USB is de kabel en de bus. HID en serieel zijn verschillende manieren om de gegevens aan te bieden.

Kies de interface die de toepassing echt kan lezen. Een kassaveld dat typen al aanneemt, is een toetsenbordwigprobleem. Een dienst die scans moet ontvangen terwijl geen tekstveld de focus heeft, of die scannerbytes gescheiden moet houden van het toetsenbord, is een serieel probleem. Veel scanners bieden maar een van die modi. Sommige kun je omschakelen. De handleiding van dat model is de lijst van modi die je kunt testen.

De handleiding HID-toetsenbordwig legt het pad van de toetsaanslagen in detail uit. Hoe werken barcodescanners? behandelt vastleggen en decoderen. Deze pagina vergelijkt de twee hostinterfaces en de tests die bij elk horen.

Wat is de USB-HID-toetsenbordwigmodus?

In USB-HID-toetsenbordmodus meldt de scanner zich aan als toetsenbord. Het besturingssysteem laadt het gewone toetsenbordstuurprogramma. Na een decodering stuurt de scanner de tekens als toetsaanslagen naar het besturingselement dat de toetsenbordfocus heeft. Een webformulier, een POS-artikelveld of een tekstvak op de desktop kan die invoer aannemen zonder code die specifiek voor de scanner is.

De focus bepaalt de bestemming. Als het bedoelde veld niet de focus heeft, komen de tekens in een ander besturingselement terecht of gaan ze verloren. De scanner klikt niet en verplaatst de aanwijzer niet.

Een ingesteld achtervoegsel kan na de gegevens komen. Enter verstuurt veel formulieren met één veld. Tab verplaatst de focus naar het volgende besturingselement. Geen van beide toetsen is gegarandeerd. De keuzes voor het achtervoegsel staan in ENTER- en TAB-achtervoegsels bij barcodescanners.

Gewone toetsenbordgebeurtenissen bevatten niet de leverancier van de scanner, het serienummer of een vlag die zegt dat de toetsen van een scanner kwamen. Browsers die WebHID implementeren weigeren toetsenbordinterfaces nog steeds, dus een pagina kan het wigapparaat niet openen en geen ruwe HID-rapporten lezen.

Wat is de USB-seriële modus van een barcodescanner?

In USB-seriële modus typt de scanner niet. Hij biedt een seriële interface via USB. Het besturingssysteem toont die interface meestal als een virtuele COM-poort: een COM-naam onder Windows, een cu- of tty-apparaat onder macOS, of een ttyACM- of ttyUSB-apparaat onder Linux. De naam wordt door het stuurprogramma toegekend en kan veranderen nadat de scanner is losgekoppeld.

Een virtuele COM-poort is geen fysieke RS-232-poort. RS-232 is een elektrische interface, met een eigen connector en spanningsniveaus, die een computer via een UART leest. USB-serieel gebruikt een USB-kabel. De toepassing opent nog steeds een seriële poort en leest bytes, maar het signaal op de draad is USB. Sommige producten zijn een echte RS-232-scanner plus een USB-naar-serieel-adapter. Andere implementeren USB CDC en spreken nooit RS-232. Behandel de poort die het besturingssysteem je toont als het integratiepunt, en ga er niet van uit dat de elektrische details overeenkomen.

De toepassing opent de poort, leest de bytestroom en beslist waar een bericht begint en eindigt. Een gebruikelijk kader is de barcodetekst gevolgd door CR (0x0D), LF (0x0A), of CR en daarna LF. Die omkadering is een apparaatinstelling, geen regel van USB. Een voorvoegselbyte zoals STX is ook mogelijk. De gids Voorvoegsel en achtervoegsel bij barcodescanners: volledige gids scheidt die bytes van de Enter-toets die een wigscanner stuurt.

Baudsnelheid, databits, pariteit en stopbits tellen op een echte UART en op veel USB-naar-serieel-adapters. Een verkeerde snelheid levert rommel op in plaats van een duidelijke fout. Sommige virtuele USB-CDC-COM-apparaten negeren de baudsnelheid die de host vraagt en leveren de bytes toch. Er is geen enkele instelling die bij elke virtuele seriële scanner past. Gebruik de snelheid en de omkadering uit de handleiding van dat model en bevestig ze met een bekende barcode.

Het proces dat de poort openhoudt, ontvangt de gegevens. De toetsenbordfocus kiest de bestemming niet. Een ander programma dat de poort al open heeft, blokkeert een tweede opening. De scanner lostrekken verwijdert de poort. Opnieuw insteken kan een nieuwe naam maken, en de toepassing moet die poort opnieuw openen.

HID en serieel

Kenmerk HID-toetsenbordwig USB-serieel
Gegevensaflevering Invoer in toetsenbordstijl Seriële bytestroom
Invoerfocus vereist Ja. Toetsaanslagen volgen het gefocuste besturingselement Nee. Bytes gaan naar het proces dat de poort opende
Browserintegratie Gewone invoer en toetsenbordgebeurtenissen Web Serial waar de browser het ondersteunt, of software buiten de pagina
Besturing door de toepassing Beperkt tot toetsenbordgedrag, focus en achtervoegsels De toepassing leest de stroom en kadert die
Apparaatidentiteit Niet beschikbaar uit gewone toetsenbordgebeurtenissen Het besturingssysteem kan een poortnaam tonen. Een stabiele identiteit hangt nog van het stuurprogramma af
Configuratie Scannerinstellingen, inclusief achtervoegsel en toetsenbordindeling Scannerinstellingen plus de hostpoortinstellingen die het apparaat echt gebruikt
Typisch gebruik Formulieren en artikelinvoer in een POS Eigen integraties die het apparaat bezitten

Dit zijn de gebruikelijke gevallen. Een bepaald model, besturingssysteem en stuurprogramma kunnen afwijken. Een Bluetooth-scanner in HID-toetsenbordmodus volgt op toepassingsniveau de wigkolom. Bluetooth SPP volgt de seriële kolom.

Hoe HID-scanners in webtoepassingen werken

Een wigscan werkt het gefocuste element bij. Afdrukbare tekens vuren keydown en daarna input. Enter en Tab vuren keydown en voegen geen teken in een gewoon tekstveld in. event.key is "Enter" of "Tab" voor die toetsen, en een tekenreeks van één teken voor een afdrukbaar teken. event.code noemt de fysieke toets en kan gelijk blijven wanneer een afwijkende toetsenbordindeling event.key verandert.

De luisteraar hieronder bevestigt het veld alleen wanneer Enter aankomt. Een scanner zonder Enter-achtervoegsel laat de tekst in het veld staan.

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 = ''
})

Geef #barcode de focus vóór de scan. preventDefault() houdt een bovenliggend formulier tegen om een tweede keer te verzenden. Als de scanner in plaats daarvan Tab stuurt, lees de waarde in die keydown en laat de browser de focus verplaatsen. Als hij geen van beide stuurt, verstuur het veld vanuit een knop of een andere expliciete actie. Een pauze in het typen is alleen een heuristiek voor het einde van een scan.

Niets in die gebeurtenissen identificeert het USB-apparaat. Een persoon, een macro of de emulator kan dezelfde reeks produceren. De validatie hoort bij de gegevens. De browserstroom, inclusief Tab en lege invoer, staat in Barcodescanners testen in webtoepassingen.

Hoe seriële scanners in toepassingen werken

Een seriële integratie opent een poort, leest bytes, splitst ze in berichten en handelt het verdwijnen van de poort af. Op de desktop is dat de seriële API van het besturingssysteem of een bibliotheek van de leverancier. In een browser is de enige ingebouwde optie de Web Serial API, en alleen in browsers die haar implementeren.

Web Serial is beschikbaar in browsers op basis van Chromium. Firefox en Safari bieden haar niet. De pagina moet een beveiligde context zijn, wat HTTPS of localhost betekent. requestPort() moet vanuit een gebruikersgebaar lopen, en de gebruiker moet de poort in de prompt van de browser kiezen. Een toetsenbordwigscanner verschijnt niet in die lijst, omdat het geen serieel apparaat is. Web Serial kan ook geen seriële poort zien die het besturingssysteem niet heeft blootgelegd.

De baudsnelheid in het voorbeeld is een beginpunt dat je vervangt door de waarde uit de handleiding. De lus behandelt CR of LF als het einde van een bericht en verbruikt een CRLF-paar als één afsluiter. Als jouw scanner een ander kader gebruikt, is deze splitsing fout, ook wanneer de poort open is.

<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>

De leeslus loopt tot de stroom eindigt of het lezen mislukt. De scanner lostrekken wijst het lezen doorgaans af. releaseLock() en close() lopen in finally. Eerder goedgekeurde poorten voor deze oorsprong kun je vermelden met navigator.serial.getPorts() zonder de prompt opnieuw te tonen. De eerste goedkeuring vereist nog steeds de gebruiker.

Een desktoptoepassing volgt hetzelfde idee met de seriële API van het platform: openen, lezen, omkaderen en opnieuw openen nadat het apparaat terug is. Deze pagina verzint geen leveranciersopdrachten. Als de scanner een eigen protocol verwacht, staat dat protocol in de documentatie van de fabrikant.

Wat is beter: HID of serieel?

Geen van beide modi is beter voor elk product. Gebruik de modus die de scanner echt biedt en de modus die de toepassing kan lezen.

Kies HID wanneer

  • De toepassing toetsenbordinvoer in een gefocust veld al aanneemt.
  • Je wilt dat een formulier of een POS-scherm werkt zonder apparaatcode.
  • De werkwijze de focus vóór elke scan kan garanderen.
  • Enter of Tab past bij de manier waarop dat formulier bevestigt of verdergaat.

Overweeg serieel wanneer

  • Scans moeten aankomen terwijl de focus in een dialoogvenster, op een knop of nergens is.
  • Scannerbytes gescheiden moeten blijven van typen.
  • De toepassing een poort kan openen, berichten kan omkaderen en kan herstellen wanneer het apparaat wordt losgekoppeld.
  • De host toestemming voor die poort kan geven en geen ander proces haar tegelijk nodig heeft.

Een scanner die zich alleen als toetsenbord aanmeldt, kun je op de host niet met software naar serieel omschakelen. Bevestig de modi in de handleiding voordat je de integratie ontwerpt.

Wisselen tussen HID en serieel

Sommige scanners veranderen van modus wanneer je een configuratiebarcode uit de handleiding van die fabrikant scant, of wanneer je een profiel schrijft met het hulpprogramma van de leverancier. Andere zijn als één interface gebouwd en hebben niets om te wisselen.

Er is geen configuratiebarcode die elk merk verandert. Een reeks die voor een ander model is afgedrukt, kan niets doen, of de scanner in een onverwachte modus achterlaten. Controleer na elke wijziging wat het besturingssysteem toont: een toetsenbord, een COM-poort of beide. Test daarna het pad dat jouw toepassing gebruikt. De Configuratiehandleiding voor barcodescanners beschrijft de gebruikelijke instellingsgroepen. Hij vervangt de handleiding niet.

Een HID-scanner testen

  1. Sluit de scanner aan en bevestig dat hij in toetsenbordwigmodus staat. Een teksteditor moet tekens ontvangen wanneer een veld in die editor de focus heeft.
  2. Open de barcode-invoertester.
  3. Klik op Start Test of op het scangebied. Het wordt blauw wanneer het klaar is. De pagina neemt niet uit zichzelf de focus.
  4. Scan een barcode waarvan je de gegevens al kent.
  5. Vergelijk de vastgelegde waarde en het aantal tekens met die gegevens.
  6. Lees het achtervoegsel: ENTER, TAB of None. Enter en Tab horen niet bij de barcodereeks.

De tester legt toetsenbordgebeurtenissen vast die de browser kan zien. Hij kan geen seriële poort lezen en het USB-apparaat niet identificeren. Wanneer de gemiddelde ruimte tussen tekens onder 100 ms ligt, meldt hij die timing. De timing is geen hardware-identificatie. Gebruik voor elke keydown, inclusief key en code, de toetsenbordevenemententester. Een bredere QA-ronde staat in Scannerinvoer van barcodes testen.

Een seriële scanner testen

De barcode-invoertester opent geen COM-poort. Een seriële test heeft een programma nodig dat de poort kan openen die de scanner blootlegt.

  1. Bevestig dat de scanner in een seriële modus staat en dat het besturingssysteem een poort vermeldt wanneer hij is aangesloten. Koppel hem los en controleer dat de poort verdwijnt.
  2. Noteer de poortnaam. Die is specifiek voor het besturingssysteem en kan bij de volgende aansluiting veranderen.
  3. Open de poort vanuit een passende toepassing: een seriële terminal, je desktopapp of het Web Serial-voorbeeld hierboven in een Chromium-browser op HTTPS of localhost.
  4. Stel baudsnelheid, databits, pariteit en stopbits in wanneer de handleiding ze noemt. Sla verzonnen waarden over.
  5. Scan een bekende barcode.
  6. Vergelijk de bytes of de gedecodeerde tekst met die gegevens.
  7. Controleer de omkadering. Zoek een voorvoegsel en CR, LF of CRLF na de gegevens, alleen als de handleiding dat zo heeft ingesteld.

Als het openen van de poort mislukt omdat ze bezet is, sluit dan het andere programma dat haar vasthoudt. Als de tekst rommel is, komen de lijninstellingen niet overeen met het apparaat. Als de poort nooit verschijnt, kan de scanner nog in toetsenbordmodus staan, kan het stuurprogramma ontbreken, of mag de gebruiker van het besturingssysteem seriële apparaten niet openen.

Veelvoorkomende problemen

De scanner werkt in een teksteditor en niet in de doeltoepassing. Het apparaat typt. Het doel heeft geen focus, of een keydown-luisteraar gooit de toetsen weg. Begin met Scanner werkt in Kladblok maar niet in de POS.

De scanner typt in geen enkel tekstveld. Hij kan in seriële modus staan, uitgeschakeld zijn of het symbool niet lezen. Een scanner in seriële modus typt niet. Zoek een COM-poort voordat je het veld onderzoekt. Barcodescanner werkt niet scheidt een dode scanner van de verkeerde interface.

De seriële poort ontbreekt. Toetsenbordmodus maakt geen COM-poort. Een ontbrekend stuurprogramma, een kabel die alleen laadt, of een scanner zonder seriële modus geeft hetzelfde symptoom. Houd de apparatenlijst van het besturingssysteem in de gaten terwijl je de scanner insteekt.

De seriële poort is al in gebruik. Maar één proces kan haar lezen. Sluit de terminal of de andere kopie van de toepassing en open haar opnieuw.

De communicatie-instellingen zijn verkeerd. Een afwijkende baudsnelheid, pariteit of stopbits zien eruit als willekeurige tekens. Zet de waarden uit de handleiding van dat model en scan een bekende code opnieuw.

ENTER of TAB komt nooit aan. Dat is een instelling van het wig-achtervoegsel. De invoertester meldt None. Zie Barcodescanner mist ENTER en de hierboven gekoppelde gids over achtervoegsels. Een seriële scanner stuurt niet de Enter-toets. Hij kan in plaats daarvan CR- of LF-bytes sturen.

Tekens zijn fout op een wigscanner. De toetsenbordindeling van de scanner en die van het besturingssysteem kunnen uiteenlopen. Seriële bytes worden door die indeling niet opnieuw toegewezen. Zie Verkeerde toetsenbordindeling van de barcodescanner.

De browser kan niet bij de scanner. Een wigscanner verschijnt niet in de Web Serial-prompt. Firefox en Safari hebben geen Web Serial API. Een pagina die niet HTTPS of localhost is, kan haar niet gebruiken. De gebruiker kan de poortprompt ook sluiten.

De toepassing verliest de scanner nadat die is losgekoppeld. Een wigscanner komt terug als toetsenbord, en de volgende scan vereist nog steeds focus. Een seriële poort is weg tot de toepassing de nieuwe poort opent. De naam hoeft niet bij de vorige te passen.

Integratiescenario's

Webtoepassingen

Toetsenbordwig past bij een gefocuste invoer en gewone DOM-gebeurtenissen. Seriële toegang in de pagina betekent Web Serial in een ondersteunende browser, een beveiligde context en een door de gebruiker gekozen poort. Een pagina die Firefox, Safari en onbemande kiosken moet ondersteunen, kan niet alleen op Web Serial leunen. Een lokale helper kan de COM-poort bezitten en volledige barcodes naar de pagina doorsturen. Die helper is aparte software. De pagina moet niet verwachten dat een wigtest hem meeneemt.

POS-systemen

Een POS die de focus in het artikelveld zet en met Enter bevestigt, is een wigintegratie. Een POS die moet scannen terwijl een dialoogvenster open is, of die het toetsenbord moet negeren, is een seriële integratie. Ze mengen levert scans in het verkeerde veld of scans die nooit aankomen. Stem de scannermodus af op het scherm dat echt dienstdoet.

Desktoptoepassingen

Een desktopapp kan wiginvoer aannemen in het besturingselement dat de focus heeft, of de virtuele COM-poort openen en een sessie houden voor de levensduur van het proces. Poortbezit, opnieuw verbinden en omkadering horen bij die sessie. Focus niet.

QA-automatisering

De Barcode Scanner Emulator typt een waarde die je kiest in de gefocuste toepassing en kan ENTER, TAB of geen achtervoegsel sturen. Dat dekt regressies van de toetsenbordwig: focus, validatie en afhandeling van het achtervoegsel. Hij maakt geen virtuele COM-poort, somt geen USB-apparaten op en bootst baudsnelheid en omkadering niet na. Seriële tests hebben nog steeds een seriële poort en een lezer nodig, of een testdubbel die dezelfde byte-omkadering schrijft die jouw toepassing ontleedt.

Kiosktoepassingen

Een kiosk die wiginvoer gebruikt, moet het scanveld gefocust houden over dialoogvensters, schermbeveiliging en foutmeldingen heen. Eén verloren focus en de volgende scan raakt een sneltoets of niets. Een kiosk die serieel gebruikt, kan de poort zonder die focus lezen, en moet de toestemming voor het apparaat houden en de poort opnieuw openen na stroomuitval of een getrokken kabel.

Waar de Barcode Scanner Emulator past

De Barcode Scanner Emulator is een desktopapp voor Windows, macOS en Linux. Hij bootst het toetsenbordpad na dat een wigscanner gebruikt. Je voert de tekst in, kiest een typvertraging en kiest een achtervoegsel van geen, ENTER of TAB. Een globale sneltoets typt die tekst in de gefocuste toepassing.

Gebruik hem om HID-achtige formulieren te ontwikkelen en op regressies te controleren wanneer de scanner niet op het bureau ligt. Koppel hem aan de barcode-invoertester om de waarde, de voorvoegseltoetsen en het achtervoegsel te zien die de browser ontving.

Hij emuleert geen USB-serieel apparaat, geen virtuele COM-poort, geen USB-enumeratie en geen optische decodering. Dat gedrag hoort nog bij de hardware, of bij een seriële testdubbel die jij bestuurt.