Hopp til innhold

Barcode Scanner Emulator

USB HID mot serielle strekkodeskannere

En skanner med USB HID-tastaturkile skriver den dekodede strekkoden inn i programmet som har fokus. En USB-seriell skanner viser et serielt grensesnitt, ofte som en virtuell COM-port, og programmet må åpne den porten og lese bytene. USB er kabelen og bussen. HID og seriell er ulike måter å presentere dataene på.

Bruk grensesnittet programmet faktisk klarer å lese. Et kassefelt som allerede tar imot tasting, er et tastaturkile-spørsmål. En tjeneste som må ta imot skanninger uten at noe tekstfelt har fokus, eller som må holde skannerens byte atskilt fra tastaturet, er et serielt spørsmål. Mange skannere har bare den ene modusen. Enkelte kan byttes. Håndboken for akkurat den modellen er listen over moduser du kan prøve.

Veiledningen om HID-tastaturkile går gjennom tastestien i detalj. Hvordan fungerer strekkodeskannere tar for seg fangst og dekoding. Her sammenlignes de to vertsgrensesnittene og testene som hører til hvert av dem.

Hva er USB HID-tastaturkile?

I USB HID-tastaturmodus teller skanneren seg opp som et tastatur. Operativsystemet laster den vanlige tastaturdriveren. Etter en dekoding sender skanneren tegnene som tastetrykk til kontrollen som har tastaturfokus. Et nettskjema, et varefelt i en POS eller en tekstboks på skrivebordet kan ta imot den inndataen uten skannerspesifikk kode.

Fokus avgjør hvor tegnene havner. Mangler det tiltenkte feltet fokus, lander tegnene i en annen kontroll, eller de blir borte. Skanneren klikker ikke, og den flytter ikke pekeren.

Et konfigurert suffiks kan komme etter nyttelasten. Enter sender mange skjemaer med ett felt. Tab flytter fokus til neste kontroll. Ingen av tastene er garantert. Valgene av suffiks står i ENTER- og TAB-suffikser.

Vanlige tastaturhendelser har verken skannerens produsent, serienummer eller et flagg som sier at tastene kom fra en skanner. Nettlesere som implementerer WebHID, avviser likevel tastaturgrensesnitt, så en side kan ikke åpne kile-enheten og lese rå HID-rapporter.

Hva er USB-seriell modus for en strekkodeskanner?

I USB-seriell modus taster ikke skanneren. Den viser et serielt grensesnitt over USB. Operativsystemet presenterer vanligvis grensesnittet som en virtuell COM-port: et COM-navn i Windows, en cu- eller tty-enhet i macOS, eller en ttyACM- eller ttyUSB-enhet i Linux. Navnet settes av driveren og kan endre seg etter at skanneren er koblet fra.

En virtuell COM-port er ikke en fysisk RS-232-port. RS-232 er et elektrisk grensesnitt, med egen kontakt og egne spenningsnivåer, som en datamaskin leser gjennom en UART. USB-seriell bruker en USB-kabel. Programmet åpner likevel en seriell port og leser byte, men signalene på ledningen er USB. Noen produkter er en ekte RS-232-skanner pluss en USB-til-seriell-adapter. Andre implementerer USB CDC og snakker aldri RS-232. Ta porten operativsystemet viser, som integrasjonspunktet, og ikke gå ut fra at de elektriske detaljene stemmer.

Programmet åpner porten, leser bytestrømmen og avgjør hvor en melding starter og slutter. En vanlig ramme er strekkodeteksten etterfulgt av CR (0x0D), LF (0x0A) eller CR og deretter LF. Innrammingen er en enhetsinnstilling, ikke en USB-regel. Et prefiksbyte som STX er også mulig. Veiledningen om prefiks og suffiks skiller de bytene fra Enter-tasten en kileskanner sender.

Baudrate, databiter, paritet og stoppbiter betyr noe på en ekte UART og på mange USB-til-seriell-adaptere. Feil rate gir søppel i stedet for en tydelig feil. Enkelte virtuelle COM-enheter med USB CDC overser baudraten verten ber om, og leverer likevel byte. Det finnes ingen enkelt innstilling som passer alle virtuelle serielle skannere. Bruk raten og innrammingen i håndboken for den modellen, og bekreft dem deretter med en kjent strekkode.

Prosessen som holder porten åpen, mottar dataene. Tastaturfokus velger ikke mottakeren. Et annet program som allerede har porten åpen, sperrer et nytt åpningsforsøk. Når skanneren kobles fra, forsvinner porten. Når den kobles til igjen, kan det oppstå et nytt navn, og programmet må åpne den porten på nytt.

HID mot seriell

Egenskap HID-tastaturkile USB-seriell
Datalevering Inndata i tastaturstil Seriell bytestrøm
Krever inndatafokus Ja. Tastetrykkene følger kontrollen med fokus Nei. Bytene går til prosessen som åpnet porten
Integrasjon i nettleseren Vanlig inndata og tastaturhendelser Web Serial der nettleseren støtter det, eller programvare utenfor siden
Programmets kontroll Begrenset til tastaturatferd, fokus og suffikser Programmet leser og rammer inn strømmen
Identifikasjon av enheten Ikke tilgjengelig fra vanlige tastaturhendelser Operativsystemet kan vise et portnavn. Stabil identitet avhenger likevel av driveren
Konfigurasjon Skannerinnstillinger, inkludert suffiks og tastaturoppsett Skannerinnstillinger pluss vertsinnstillingene for porten som enheten faktisk bruker
Typisk bruk Skjemaer og vareinntasting i POS Egne integrasjoner som eier enheten

Dette er de vanlige tilfellene. En gitt modell, et operativsystem og en driver kan avvike. En Bluetooth-skanner i HID-tastaturmodus følger kilekolonnen i programlaget. Bluetooth SPP følger den serielle kolonnen.

Slik virker HID-skannere i nettprogrammer

En kileskanning oppdaterer elementet som har fokus. Tegn som kan skrives ut, utløser keydown og deretter input. Enter og Tab utløser keydown og setter ikke inn et tegn i et vanlig tekstfelt. event.key er "Enter" eller "Tab" for de tastene, og en streng på ett tegn for et tegn som kan skrives ut. event.code navngir den fysiske tasten og kan bli stående når et feil tastaturoppsett endrer event.key.

Lytteren under bekrefter feltet bare når Enter kommer. En skanner uten Enter-suffiks lar teksten ligge i feltet.

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

Gi #barcode fokus før skanningen. preventDefault() hindrer et overordnet skjema i å bli sendt en gang til. Sender skanneren Tab i stedet, les verdien i den keydown og la nettleseren flytte fokus. Sender den ingen av dem, send feltet fra en knapp eller en annen tydelig handling. En pause i tastingen er bare et hint om at skanningen er ferdig.

Ingenting i hendelsene identifiserer USB-enheten. En person, en makro eller emulatoren kan lage den samme rekkefølgen. Valideringen hører hjemme på nyttelasten. Arbeidsflyten i nettleseren, inkludert Tab og tom inndata, står i Slik tester du strekkodeskannere i webprogrammer.

Slik virker serielle skannere i programmer

En seriell integrasjon åpner en port, leser byte, deler dem i meldinger og håndterer at porten forsvinner. På skrivebordet er det operativsystemets serielle API eller et bibliotek fra leverandøren. I en nettleser er det eneste innebygde valget Web Serial API, og bare i nettlesere som implementerer det.

Web Serial finnes i Chromium-baserte nettlesere. Firefox og Safari tilbyr det ikke. Siden må være en sikker kontekst, altså HTTPS eller localhost. requestPort() må kjøres fra en brukerhandling, og brukeren må velge porten i nettleserens spørsmål. En tastaturkile-skanner står ikke på den listen, fordi den ikke er en seriell enhet. Web Serial ser heller ikke en seriell port som operativsystemet ikke har vist frem.

Baudraten i eksempelet er et utgangspunkt du bytter ut med verdien fra håndboken. Løkken behandler CR eller LF som slutten på en melding og bruker et CRLF-par som én avslutter. Bruker skanneren din en annen ramme, er denne oppdelingen feil selv om porten er åpen.

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

Leseløkken kjører til strømmen tar slutt eller lesingen feiler. Når skanneren kobles fra, blir lesingen vanligvis avvist. releaseLock() og close() kjører i finally. Porter som allerede er godkjent for denne opprinnelsen, kan listes med navigator.serial.getPorts() uten at spørsmålet vises på nytt. Den første godkjenningen krever fortsatt brukeren.

Et skrivebordsprogram følger den samme ideen med plattformens serielle API: åpne, les, ram inn, og åpne igjen når enheten kommer tilbake. Denne siden finner ikke opp leverandørkommandoer. Forventer skanneren en proprietær protokoll, står protokollen i produsentens dokumentasjon.

Hva er best: HID eller seriell?

Ingen modus er best for ethvert produkt. Bruk modusen skanneren faktisk tilbyr, og modusen programmet kan lese.

Velg HID når

  • Programmet allerede tar imot tastaturinndata i et felt med fokus.
  • Du vil at et skjema eller en POS-skjerm skal virke uten enhetskode.
  • Arbeidsflyten kan sikre fokus før hver skanning.
  • Enter eller Tab stemmer med måten skjemaet bekrefter eller går videre på.

Vurder seriell når

  • Skanninger må komme inn mens fokus ligger i en dialog, på en knapp eller ingen steder.
  • Skannerens byte må holdes atskilt fra tasting.
  • Programmet kan åpne en port, ramme inn meldinger og komme seg når enheten kobles fra.
  • Verten kan gi tillatelse til den porten, og ingen annen prosess trenger den samtidig.

En skanner som bare teller seg opp som tastatur, kan ikke byttes til seriell i programvare på verten. Bekreft modusene i håndboken før du utformer integrasjonen.

Bytte mellom HID og seriell

Noen skannere bytter modus når du skanner en konfigurasjonsstrekkode fra den produsentens håndbok, eller når du skriver en profil med leverandørens verktøy. Andre er bygget som ett grensesnitt og har ingenting å bytte.

Det finnes ingen konfigurasjonsstrekkode som endrer ethvert merke. En sekvens trykt for en annen modell kan gjøre ingenting, eller den kan etterlate skanneren i en uventet modus. Etter enhver endring, se hva operativsystemet viser: et tastatur, en COM-port eller begge. Test deretter stien programmet ditt bruker. Konfigurasjonsveiledningen beskriver de vanlige innstillingsgruppene. Den erstatter ikke håndboken.

Teste en HID-skanner

  1. Koble til skanneren, og bekreft at den er i tastaturkile-modus. Et tekstprogram skal motta tegn når et felt i det programmet har fokus.
  2. Åpne strekkodeinndatatesten.
  3. Klikk Start test, eller klikk i skanneområdet. Det blir blått når det er klart. Siden tar ikke fokus av seg selv.
  4. Skann en strekkode du allerede kjenner nyttelasten til.
  5. Sammenlign den fangede verdien og tegnantallet med den nyttelasten.
  6. Les suffikset: ENTER, TAB eller Ingen. Enter og Tab er ikke en del av strekkodestrengen.

Testen registrerer tastaturhendelsene nettleseren kan se. Den kan ikke lese en seriell port, og den kan ikke identifisere USB-enheten. Når det gjennomsnittlige oppholdet mellom tegn er under 100 ms, rapporterer den den tidsmålingen. Tidsmålingen er ikke en identifisering av maskinvaren. For hver keydown, inkludert key og code, bruk tastaturhendelsestesten. En bredere QA-gjennomgang står i Slik tester du inndata fra strekkodeskanner.

Teste en seriell skanner

Strekkodeinndatatesten åpner ikke en COM-port. En seriell test trenger et program som kan åpne porten skanneren viser.

  1. Bekreft at skanneren er i en seriell modus, og at operativsystemet lister en port når den er tilkoblet. Koble den fra, og sjekk at porten forsvinner.
  2. Noter portnavnet. Det er spesifikt for operativsystemet og kan endre seg ved neste tilkobling.
  3. Åpne porten fra et kompatibelt program: en seriell terminal, skrivebordsprogrammet ditt eller Web Serial-eksempelet ovenfor i en Chromium-nettleser på HTTPS eller localhost.
  4. Sett baudrate, databiter, paritet og stoppbiter når håndboken oppgir dem. Hopp over oppdiktede verdier.
  5. Skann en kjent strekkode.
  6. Sammenlign bytene eller den dekodede teksten med den nyttelasten.
  7. Sjekk innrammingen. Se etter et prefiks, og etter CR, LF eller CRLF etter data, bare hvis det er det håndboken konfigurerte.

Hvis porten ikke lar seg åpne fordi den er opptatt, lukk det andre programmet som holder den. Er teksten søppel, stemmer linjeinnstillingene ikke med enheten. Dukker porten aldri opp, kan skanneren fremdeles være i tastaturmodus, driveren kan mangle, eller OS-brukeren har kanskje ikke lov til å åpne serielle enheter.

Vanlige problemer

Skanneren virker i et tekstprogram, men ikke i målprogrammet. Enheten taster. Målet har ikke fokus, eller en keydown-lytter forkaster tastene. Begynn med Skanneren virker i Notisblokk, men ikke i POS.

Skanneren taster ikke i noe tekstfelt. Den kan være i seriell modus, avslått, eller den leser ikke symbolet. En skanner i seriell modus taster ikke. Se etter en COM-port før du feilsøker feltet. Strekkodeskanner virker ikke skiller en død skanner fra feil grensesnitt.

Den serielle porten mangler. Tastaturmodus oppretter ingen COM-port. En manglende driver, en kabel som bare lader, eller en skanner uten seriell modus gir det samme symptomet. Følg med på enhetslisten i operativsystemet mens du kobler til skanneren.

Den serielle porten er allerede i bruk. Bare én prosess kan lese den. Lukk terminalen eller den andre kopien av programmet, og åpne den deretter igjen.

Kommunikasjonsinnstillingene er feil. Baud, paritet eller stoppbiter som ikke stemmer, ser ut som tilfeldige tegn. Sett verdiene fra håndboken for den modellen, og skann deretter en kjent kode på nytt.

ENTER eller TAB kommer aldri fram. Det er en suffiksinnstilling for kilen. Inndatatesten rapporterer Ingen. Se Strekkodeskanner mangler ENTER og suffiksveiledningen som er lenket ovenfor. En seriell skanner sender ikke Enter-tasten. Den kan sende CR- eller LF-byte i stedet.

Tegnene er feil på en kileskanner. Skannerens tastaturoppsett og operativsystemets oppsett kan være uenige. Serielle byte blir ikke tilordnet på nytt av det oppsettet. Se Feil tastaturoppsett på strekkodeskanner.

Nettleseren får ikke tilgang til skanneren. En kileskanner vises ikke i spørsmålet fra Web Serial. Firefox og Safari har ikke Web Serial API. En side som ikke er HTTPS eller localhost, kan ikke bruke det. Brukeren kan også avvise portspørsmålet.

Programmet mister skanneren etter at den er koblet fra. En kileskanner kommer tilbake som et tastatur, og neste skanning krever fortsatt fokus. En seriell port er borte til programmet åpner den nye porten. Navnet trenger ikke å stemme med det forrige.

Integrasjonsscenarier

Nettprogrammer

Tastaturkile passer et felt med fokus og vanlige DOM-hendelser. Seriell tilgang inne på siden betyr Web Serial i en nettleser som støtter det, en sikker kontekst og en port brukeren har valgt. En side som må støtte Firefox, Safari og ubemannede kiosker, kan ikke stole på Web Serial alene. En lokal hjelper kan eie COM-porten og videresende ferdige strekkoder til siden. Den hjelperen er egen programvare. Siden skal likevel ikke forvente at en kiletest øver den.

Kassasystemer

Et POS som legger fokus i varefeltet og bekrefter på Enter, er en kileintegrasjon. Et POS som må skanne mens en modal er åpen, eller som må overse tastaturet, er en seriell integrasjon. Å blande dem gir skanninger i feil felt eller skanninger som aldri kommer fram. La skannermodusen passe til skjermen som faktisk er i bruk.

Skrivebordsprogram

Et skrivebordsprogram kan ta imot kileinndata i kontrollen som har fokus, eller åpne den virtuelle COM-porten og holde en økt så lenge prosessen lever. Eierskap til porten, ny tilkobling og innramming hører til den økten. Fokus gjør det ikke.

Automatisert QA

Barcode Scanner Emulator skriver en verdi du velger, inn i programmet med fokus og kan sende ENTER, TAB eller ingen suffiks. Det dekker regresjoner for tastaturkile: fokus, validering og suffikshåndtering. Den oppretter ikke en virtuell COM-port, teller ikke opp USB-enheter og gjenskaper ikke baud og innramming. Serielle tester trenger fortsatt en seriell port og en leser, eller en testdobbel som skriver den samme byteinnrammingen programmet ditt tolker.

Kioskapplikasjoner

En kiosk som bruker kileinndata, må holde skannefeltet i fokus på tvers av dialoger, skjermsparere og feilmeldinger. Ett tapt fokus, og neste skanning treffer en snarvei eller ingenting. En kiosk som bruker seriell, kan lese porten uten det fokuset, og den må beholde tillatelse til enheten og åpne porten igjen etter strømbrudd eller en trukket kabel.

Hvor Barcode Scanner Emulator hører hjemme

Barcode Scanner Emulator er et skrivebordsprogram for Windows, macOS og Linux. Det gjenskaper tastaturstien en kileskanner bruker. Du skriver inn teksten, velger en tasteforsinkelse og velger et suffiks som er ingen, ENTER eller TAB. En global snarvei skriver den teksten inn i programmet med fokus.

Bruk det til å utvikle og regresjonsteste skjemaer i HID-stil når skanneren ikke står på pulten. Koble det sammen med strekkodeinndatatesten for å se verdien, prefikstegnene og suffikset nettleseren mottok.

Det emulerer ikke en USB-seriell enhet, en virtuell COM-port, USB-oppregning eller en optisk dekoding. Den atferden hører fortsatt til maskinvaren, eller til en seriell testdobbel du styrer.