Preskočiť na obsah

Barcode Scanner Emulator

Skenery čiarových kódov USB HID a sériové

Skener USB HID v režime klávesnicového klinu vpíše dekódovaný čiarový kód do aplikácie s fokusom. Sériový skener USB sprístupní sériové rozhranie, často ako virtuálny port COM, a aplikácia musí ten port otvoriť a prečítať bajty. USB je kábel a zbernica. HID a sériový režim sú odlišné spôsoby, ako tie údaje podať.

Zvoľte rozhranie, ktoré aplikácia naozaj vie prečítať. Pokladničné pole, ktoré už prijíma písanie, je úloha pre klávesnicový klin. Služba, ktorej musí sken prísť, keď žiadne textové pole nemá fokus, alebo ktorá musí držať bajty skenera oddelene od klávesnice, je sériová úloha. Mnohé skenery ponúkajú len jeden z týchto režimov. Niektoré sa vedia prepnúť. Návod k tomuto modelu je zoznam režimov, ktoré sa dajú overiť.

Príručka Klávesnicový klin HID podrobne vysvetľuje cestu stlačení. Ako fungujú skenery čiarových kódov? rozoberá zachytenie a dekódovanie. Táto stránka stavia vedľa seba dve rozhrania na strane počítača a testy, ktoré patria ku každému z nich.

Čo je režim klávesnicového klinu USB HID?

V režime klávesnice USB HID sa skener hlási ako klávesnica. Operačný systém nahrá svoj bežný ovládač klávesnice. Po dekódovaní skener pošle znaky ako stlačenia klávesov do prvku, ktorý má fokus klávesnice. Webový formulár, pole položky v POS alebo textové pole na ploche tento vstup prijme bez kódu písaného osobitne pre skener.

O cieli rozhoduje fokus. Keď zamýšľané pole fokus nemá, znaky skončia v inom prvku, alebo sa stratia. Skener nekliká a ukazovateľom nehýbe.

Za obsahom môže nasledovať nastavená prípona. Enter odošle mnoho formulárov s jedným poľom. Tab presunie fokus na ďalší prvok. Ani jeden z týchto klávesov nie je zaručený. Voľbu prípony rozoberá príručka Prípony ENTER a TAB v skeneroch čiarových kódov.

Bežné udalosti klávesnice neobsahujú výrobcu skenera, sériové číslo ani príznak, že klávesy prišli zo skenera. Prehliadače s WebHID rozhrania klávesnice aj tak odmietajú, takže stránka nemôže otvoriť zariadenie klinu a prečítať surové správy HID.

Čo je sériový režim skenera čiarových kódov USB?

V sériovom režime USB skener nepíše. Sprístupní sériové rozhranie cez USB. Operačný systém toto rozhranie zvyčajne ukáže ako virtuálny port COM: názov COM vo Windows, zariadenie cu alebo tty v macOS, alebo zariadenie ttyACM alebo ttyUSB v Linuxe. Názov priraďuje ovládač a po odpojení skenera sa môže zmeniť.

Virtuálny port COM nie je fyzický port RS-232. RS-232 je elektrické rozhranie s vlastným konektorom a napäťovými úrovňami, ktoré počítač číta cez UART. Sériové USB používa kábel USB. Aplikácia stále otvára sériový port a číta bajty, ale signál na vodiči je USB. Niektoré výrobky sú skutočný skener RS-232 plus prevodník z USB na sériový port. Iné implementujú USB CDC a RS-232 vôbec nehovoria. Za bod integrácie berte port, ktorý ukazuje operačný systém, a nepredpokladajte, že elektrické podrobnosti sedia.

Aplikácia port otvorí, číta prúd bajtov a rozhodne, kde správa začína a končí. Obvyklý rámec je text čiarového kódu, za ktorým nasleduje CR (0x0D), LF (0x0A) alebo najprv CR a potom LF. Tento rámec je nastavenie zariadenia, nie pravidlo USB. Možný je aj bajt predpony, napríklad STX. Príručka Predpona a prípona v skeneroch čiarových kódov: úplná príručka oddeľuje tieto bajty od klávesu Enter, ktorý posiela skener v režime klinu.

Rýchlosť, dátové bity, parita a stop bity záležia na skutočnom UART a na mnohých prevodníkoch z USB na sériový port. Nesprávna rýchlosť dá smeti, nie čistú chybu. Niektoré virtuálne zariadenia COM s USB CDC rýchlosť, o ktorú hostiteľ žiada, ignorujú a bajty aj tak doručia. Neexistuje jedno nastavenie pre každý virtuálny sériový skener. Vezmite rýchlosť a rámec z návodu k tomuto modelu a potom ich potvrďte známym čiarovým kódom.

Údaje dostane proces, ktorý drží port otvorený. Fokus klávesnice príjemcu nevyberá. Iný program, ktorý port už otvoril, druhé otvorenie zablokuje. Odpojenie skenera port odstráni. Opätovné pripojenie môže vytvoriť nový názov a aplikácia musí tento port otvoriť znova.

HID a sériový režim

Vlastnosť Klávesnicový klin HID Sériové USB
Doručenie údajov Vstup v štýle klávesnice Sériový prúd bajtov
Vyžaduje sa fokus vstupu Áno. Stlačenia sledujú prvok s fokusom Nie. Bajty idú do procesu, ktorý port otvoril
Napojenie na prehliadač Bežný vstup a udalosti klávesnice Web Serial tam, kde ho prehliadač podporuje, alebo softvér mimo stránky
Riadenie v aplikácii Obmedzené na správanie klávesnice, fokus a prípony Aplikácia prúd číta a skladá z neho správy
Identifikácia zariadenia Z bežných udalostí klávesnice nedostupná Operačný systém môže ukázať názov portu. Stabilná totožnosť stále závisí od ovládača
Nastavenie Nastavenie skenera vrátane prípony a rozloženia klávesnice Nastavenie skenera plus tie nastavenia portu na hostiteľovi, ktoré zariadenie skutočne používa
Obvyklé použitie Formuláre a zadávanie položiek v POS Samostatné integrácie, ktoré zariadenie vlastnia

To sú obvyklé prípady. Daný model, operačný systém a ovládač sa môžu líšiť. Skener Bluetooth v režime klávesnice HID ide na vrstve aplikácie stĺpcom klinu. Bluetooth SPP ide sériovým stĺpcom.

Ako skenery HID pracujú vo webových aplikáciách

Sken klinom aktualizuje prvok s fokusom. Tlačiteľné znaky spustia keydown a potom input. Enter a Tab spustia keydown a do bežného textového poľa znak nevložia. Pri týchto klávesoch je event.key rovné "Enter" alebo "Tab" a pri tlačiteľnom znaku je to reťazec z jedného znaku. event.code pomenuje fyzický kláves a môže ostať rovnaké, keď nesúlad rozloženia zmení event.key.

Obsluha nižšie pole potvrdí až vtedy, keď príde Enter. Skener bez prípony Enter nechá text v poli.

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

Pred skenom dajte fokus #barcode. preventDefault() zabráni nadradenému formuláru, aby sa odoslal druhý raz. Keď skener posiela Tab, prečítajte hodnotu v tomto keydown a nechajte prehliadač presunúť fokus. Keď neposiela ani Enter, ani Tab, odošlite pole tlačidlom alebo inou výslovnou akciou. Prestávka v písaní je len heuristika konca skenu.

V týchto udalostiach nie je nič, čo by spoznalo zariadenie USB. Rovnakú postupnosť môže vytvoriť človek, makro alebo emulátor. Overenie patrí obsahu. Postup v prehliadači, vrátane Tab a prázdneho vstupu, je v príručke Ako testovať skenery čiarových kódov vo webových aplikáciách.

Ako sériové skenery pracujú v aplikáciách

Sériová integrácia otvorí port, číta bajty, rozdelí ich na správy a ošetrí zmiznutie portu. Na ploche je to sériové API operačného systému alebo knižnica výrobcu. V prehliadači je jedinou vstavanou možnosťou Web Serial API, a len v prehliadačoch, ktoré ho implementujú.

Web Serial je v prehliadačoch založených na Chromium. Firefox a Safari ho neposkytujú. Stránka musí byť v zabezpečenom kontexte, teda HTTPS alebo localhost. requestPort() sa musí spustiť z gesta používateľa a používateľ musí port vybrať vo výzve prehliadača. Skener v režime klávesnicového klinu sa v tom zozname neobjaví, pretože to nie je sériové zariadenie. Web Serial tiež nevidí sériový port, ktorý operačný systém nevystavil.

Rýchlosť v príklade je východiskový bod, ktorý nahradíte hodnotou z návodu. Slučka berie CR alebo LF ako koniec správy a pár CRLF spotrebuje ako jeden ukončovač. Keď skener používa iný rámec, je toto delenie nesprávne, aj keď je port otvorený.

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

Slučka čítania beží, kým prúd neskončí alebo čítanie nezlyhá. Odpojenie skenera čítanie obvykle odmietne. releaseLock() a close() prebehnú v finally. Porty predtým schválené pre tento pôvod sa dajú vypísať cez navigator.serial.getPorts() bez ďalšej výzvy. Prvý súhlas používateľa stále vyžaduje.

Desktopová aplikácia ide rovnakou myšlienkou so sériovým API platformy: otvoriť, čítať, zložiť rámec a otvoriť znova, keď sa zariadenie vráti. Táto stránka nevymýšľa príkazy výrobcu. Keď skener čaká vlastný protokol, je tento protokol v dokumentácii výrobcu.

Čo je lepšie: HID, alebo sériový režim?

Žiadny režim nie je lepší pre každý produkt. Použite režim, ktorý skener skutočne ponúka, a režim, ktorý aplikácia vie prečítať.

Zvoľte HID, keď

  • Aplikácia už prijíma vstup z klávesnice v poli s fokusom.
  • Formulár alebo obrazovka POS majú fungovať bez kódu pre zariadenie.
  • Postup vie zaručiť fokus pred každým skenom.
  • Enter alebo Tab zodpovedá tomu, ako tento formulár hodnotu potvrdí alebo postúpi ďalej.

Zvážte sériový režim, keď

  • Skeny musia prichádzať, kým je fokus v dialógu, na tlačidle alebo nikde.
  • Bajty skenera majú zostať oddelené od písania.
  • Aplikácia vie otvoriť port, zložiť správy a spamätať sa, keď sa zariadenie odpojí.
  • Hostiteľ môže udeliť oprávnenie k tomuto portu a žiadny iný proces ho v tej istej chvíli nepotrebuje.

Skener, ktorý sa hlási len ako klávesnica, sa na hostiteľovi nedá softvérom prepnúť do sériového režimu. Režimy potvrďte v návode, skôr než integráciu navrhnete.

Prepínanie medzi HID a sériovým režimom

Niektoré skenery zmenia režim, keď naskenujete konfiguračný čiarový kód z návodu tohto výrobcu, alebo keď zapíšete profil nástrojom výrobcu. Iné sú postavené ako jedno rozhranie a niet čo prepínať.

Neexistuje konfiguračný čiarový kód, ktorý zmení režim pri všetkých značkách. Postupnosť vytlačená pre iný model nemusí urobiť nič, alebo môže skener nechať v neočakávanom režime. Po každej zmene sa pozrite, čo ukazuje operačný systém: klávesnicu, port COM, alebo oboje. Potom vyskúšajte cestu, ktorú používa aplikácia. Príručka konfigurácie skenera čiarových kódov opisuje obvyklé skupiny nastavení. Nenahrádza návod k modelu.

Testovanie skenera HID

  1. Pripojte skener a overte, že je v režime klávesnicového klinu. Textový editor má dostať znaky, keď má pole v tomto editore fokus.
  2. Otvorte tester vstupu čiarových kódov.
  3. Kliknite na Spustiť test, alebo kliknite na oblasť skenovania. Zmodrie, keď je pripravená. Stránka si fokus sama neberie.
  4. Naskenujte čiarový kód, ktorého obsah už poznáte.
  5. Porovnajte zachytenú hodnotu a počet znakov s týmto obsahom.
  6. Prečítajte príponu: ENTER, TAB alebo None. Enter a Tab nie sú súčasťou reťazca čiarového kódu.

Tester zaznamenáva udalosti klávesnice, ktoré prehliadač vidí. Sériový port čítať nevie a zariadenie USB nespozná. Keď je priemerná medzera medzi znakmi kratšia než 100 ms, ohlási tento čas. Čas nie je identifikácia hardvéru. Pre každé keydown, vrátane key a code, použite tester udalostí klávesnice. Širší prechod je v príručke Ako testovať vstup zo skenera čiarových kódov.

Testovanie sériového skenera

Tester vstupu čiarových kódov port COM neotvára. Sériový test potrebuje program, ktorý vie otvoriť port vystavený skenerom.

  1. Overte, že skener je v sériovom režime a že operačný systém ukáže port, keď je skener pripojený. Odpojte ho a skontrolujte, že port zmizne.
  2. Poznačte si názov portu. Závisí od operačného systému a pri ďalšom pripojení sa môže zmeniť.
  3. Otvorte port zo zlučiteľnej aplikácie: sériového terminálu, vašej desktopovej aplikácie alebo príkladu Web Serial vyššie v prehliadači založenom na Chromium cez HTTPS alebo localhost.
  4. Nastavte rýchlosť, dátové bity, paritu a stop bity, keď ich návod uvádza. Hodnoty, ktoré v návode nie sú, nevymýšľajte.
  5. Naskenujte známy čiarový kód.
  6. Porovnajte bajty alebo dekódovaný text s týmto obsahom.
  7. Skontrolujte rámec. Hľadajte predponu a CR, LF alebo CRLF za údajmi, len keď práve to návod nastavil.

Keď sa port neotvorí, pretože je obsadený, zatvorte druhý program, ktorý ho drží. Keď je text smeti, parametre linky so zariadením nesedia. Keď sa port vôbec neobjaví, skener môže stále byť v režime klávesnice, ovládač môže chýbať, alebo používateľ operačného systému nemusí smieť otvárať sériové zariadenia.

Časté ťažkosti

Skener funguje v textovom editore a nie v cieľovej aplikácii. Zariadenie píše. Cieľ nemá fokus, alebo obsluha keydown klávesy zahadzuje. Začnite článkom Skener funguje v Notepade, ale nie v POS.

Skener nepíše do žiadneho textového poľa. Môže byť v sériovom režime, vypnutý, alebo symbol nečíta. Skener v sériovom režime písať nebude. Skôr než budete ladiť pole, pozrite sa po porte COM. Článok Skener čiarových kódov nefunguje oddeľuje nefunkčný skener od nesprávneho rozhrania.

Sériový port chýba. Režim klávesnice port COM nevytvorí. Chýbajúci ovládač, kábel len na nabíjanie alebo skener bez sériového režimu dajú rovnaký príznak. Sledujte zoznam zariadení systému, kým skener pripájate.

Sériový port je už obsadený. Čítať ho môže len jeden proces. Zatvorte terminál alebo druhú kópiu aplikácie a port otvorte znova.

Nastavenia komunikácie sú nesprávne. Nesúlad rýchlosti, parity alebo stop bitov vyzerá ako náhodné znaky. Nastavte hodnoty z návodu k tomuto modelu a potom znova naskenujte známy kód.

ENTER alebo TAB nikdy nepríde. To je nastavenie prípony klinu. Tester vstupu hlási None. Pozrite Skeneru čiarových kódov chýba ENTER a príručku o príponách vyššie. Sériový skener kláves Enter neposiela. Môže poslať bajty CR alebo LF.

Znaky na skeneri v režime klinu sú nesprávne. Rozloženie klávesnice skenera a rozloženie operačného systému sa môžu rozchádzať. Sériové bajty toto rozloženie nepremapuje. Pozrite Nesprávne rozloženie klávesnice skenera čiarových kódov.

Prehliadač sa k skeneru nedostane. Skener v režime klinu sa vo výzve Web Serial neobjaví. Firefox a Safari nemajú Web Serial API. Stránka, ktorá nie je na HTTPS ani na localhost, ho použiť nemôže. Používateľ môže výzvu k portu aj zatvoriť.

Aplikácia skener po odpojení stratí. Skener v režime klinu sa vráti ako klávesnica a ďalší sken stále potrebuje fokus. Sériový port nie je, kým aplikácia neotvorí nový port. Názov sa s predchádzajúcim nemusí zhodovať.

Scenáre integrácie

Webové aplikácie

Klávesnicový klin sedí poľu s fokusom a bežným udalostiam DOM. Sériový prístup vo vnútri stránky znamená Web Serial v prehliadači, ktorý ho podporuje, zabezpečený kontext a port vybraný používateľom. Stránka, ktorá musí podporovať Firefox, Safari a kiosky bez obsluhy, sa nemôže spoliehať len na Web Serial. Miestny pomocník môže vlastniť port COM a posielať hotové čiarové kódy na stránku. Tento pomocník je samostatný softvér. Test klinu ten program necvičí.

Systémy POS

POS, ktorý dá fokus do poľa položky a hodnotu potvrdí klávesom Enter, je integrácia klinu. POS, ktorý musí skenovať, kým je otvorený modálny dialóg, alebo ktorý musí klávesnicu ignorovať, je sériová integrácia. Miešanie dá skeny v nesprávnom poli alebo skeny, ktoré nedorazia. Režim skenera zlaďte s obrazovkou, ktorá je skutočne v službe.

Desktopové aplikácie

Desktopová aplikácia môže prijať vstup klinu v prvku, ktorý má fokus, alebo otvoriť virtuálny port COM a držať reláciu počas života procesu. Vlastníctvo portu, opätovné pripojenie a rámec sú súčasťou tejto relácie. Fokus k nej nepatrí.

Automatizácia QA

Barcode Scanner Emulator zapíše vami zvolenú hodnotu do aplikácie s fokusom a môže poslať ENTER, TAB, alebo sa zaobísť bez prípony. Tým pokryje regresie klávesnicového klinu: fokus, overenie a spracovanie prípony. Nevytvorí virtuálny port COM, nevymenúva zariadenia USB a neobnoví rýchlosť ani rámec. Sériové testy stále potrebujú sériový port a čítací program, alebo testovacieho dvojníka, ktorý zapíše rovnaký bajtový rámec, aký aplikácia rozoberá.

Kiosk

Kiosk so vstupom klinu musí držať pole skenu vo fokuse cez dialógy, šetriče obrazovky a chybové správy. Raz stratený fokus a ďalší sken trafí skratku, alebo nič. Kiosk so sériovým režimom môže port čítať bez tohto fokusu a musí držať oprávnenie k zariadeniu a port znova otvoriť po výpadku napájania alebo vytrhnutí kábla.

Kam sa hodí Barcode Scanner Emulator

Barcode Scanner Emulator je desktopová aplikácia pre Windows, macOS a Linux. Obnovuje klávesnicovú cestu, ktorú používa skener v režime klinu. Zadáte text, zvolíte oneskorenie písania a zvolíte príponu: žiadna, ENTER alebo TAB. Globálna skratka tento text zapíše do aplikácie s fokusom.

Použite ho na vývoj formulárov v štýle HID a na chytanie ich regresií, keď skener nie je na stole. Spojte ho s testerom vstupu čiarových kódov, aby ste videli hodnotu, klávesy predpony a príponu, ktoré prehliadač dostal.

Neemuluje sériové zariadenie USB, virtuálny port COM, vymenovanie USB ani optické dekódovanie. Toto správanie stále patrí hardvéru, alebo sériovému testovaciemu dvojníkovi, ktorého ovládate.