Preskoči na vsebino

Barcode Scanner Emulator

Čitalniki črtnih kod USB HID in serijski

Čitalnik USB HID v načinu tipkovnega klina vtipka dekodirano črtno kodo v aplikacijo, ki ima žarišče. Serijski čitalnik USB odpre serijski vmesnik, pogosto kot navidezna vrata COM, aplikacija pa mora ta vrata odpreti in prebrati bajte. USB je kabel in vodilo. HID in serijski način sta različna načina, kako se podatki predajo.

Izberite vmesnik, ki ga aplikacija zares zna prebrati. Blagajniško polje, ki že sprejema tipkanje, je naloga tipkovnega klina. Storitev, ki mora prejeti branje, ko nobeno besedilno polje nima žarišča, ali ki mora bajte čitalnika držati ločeno od tipkovnice, je serijska naloga. Veliko čitalnikov ponuja samo enega od teh načinov. Nekateri se znajo preklopiti. Priročnik tega modela je seznam načinov, ki jih lahko preverite.

Vodnik Tipkovni klin HID natančno razloži pot pritiskov. Kako delujejo čitalniki črtnih kod? pokriva zajem in dekodiranje. Ta stran primerja dva vmesnika na strani računalnika in preizkuse, ki sodijo k vsakemu od njiju.

Kaj je način tipkovnega klina USB HID?

V načinu tipkovnice USB HID se čitalnik oglaša kot tipkovnica. Operacijski sistem naloži svoj običajni gonilnik tipkovnice. Po dekodiranju čitalnik pošlje znake kot pritiske tipk v kontrolnik, ki ima žarišče tipkovnice. Spletni obrazec, polje postavke v POS ali besedilno polje na namizju ta vnos sprejme brez kode, napisane posebej za čitalnik.

Žarišče odloči, kam gredo znaki. Če predvideno polje nima žarišča, znaki pristanejo v drugem kontrolniku ali se izgubijo. Čitalnik ne klikne in ne premakne kazalca.

Za vsebino lahko sledi nastavljena pripona. Enter pošlje marsikateri obrazec z enim poljem. Tab premakne žarišče na naslednji kontrolnik. Nobena od teh tipk ni zagotovljena. Izbira pripone je razložena v vodniku Pripone ENTER in TAB v čitalnikih črtnih kod.

Običajni dogodki tipkovnice ne vsebujejo izdelovalca čitalnika, serijske številke niti zastavice, da so tipke prišle s čitalnika. Brskalniki z WebHID vmesnike tipkovnice še vedno zavrnejo, zato stran ne more odpreti naprave klina in prebrati surovih poročil HID.

Kaj je serijski način čitalnika črtnih kod prek USB?

V serijskem načinu USB čitalnik ne tipka. Izpostavi serijski vmesnik prek USB. Operacijski sistem ta vmesnik običajno pokaže kot navidezna vrata COM: ime COM v sistemu Windows, napravo cu ali tty v sistemu macOS oziroma napravo ttyACM ali ttyUSB v sistemu Linux. Ime dodeli gonilnik in se lahko po odklopu čitalnika spremeni.

Navidezna vrata COM niso fizična vrata RS-232. RS-232 je električni vmesnik z lastnim konektorjem in napetostnimi ravnmi, ki ga računalnik bere prek UART. Serijski USB uporablja kabel USB. Aplikacija še vedno odpre serijska vrata in bere bajte, signal na žici pa je USB. Nekateri izdelki so pravi čitalnik RS-232 in pretvornik iz USB v serijska vrata. Drugi uresničijo USB CDC in RS-232 sploh ne govorijo. Za točko integracije vzemite vrata, ki jih pokaže operacijski sistem, in ne predvidevajte, da se električne podrobnosti ujemajo.

Aplikacija odpre vrata, bere tok bajtov in odloči, kje se sporočilo začne in konča. Običajen okvir je besedilo črtne kode, ki mu sledi CR (0x0D), LF (0x0A) ali najprej CR in nato LF. Ta okvir je nastavitev naprave, ne pravilo USB. Možen je tudi bajt predpone, na primer STX. Vodnik Predpona in pripona v čitalnikih črtnih kod: popoln vodnik te bajte loči od tipke Enter, ki jo pošlje čitalnik v načinu klina.

Hitrost, podatkovni biti, parnost in stop biti štejejo na pravem UART in na mnogih pretvornikih iz USB v serijska vrata. Napačna hitrost da smeti, ne čiste napake. Nekatere navidezne naprave COM z USB CDC prezrejo hitrost, ki jo gostitelj zahteva, in bajte vseeno dostavijo. Ni ene nastavitve, ki bi ustrezala vsakemu navideznemu serijskemu čitalniku. Vzemite hitrost in okvir iz priročnika tega modela, nato ju potrdite z znano črtno kodo.

Podatke prejme proces, ki drži vrata odprta. Žarišče tipkovnice ne izbere prejemnika. Drug program, ki je vrata že odprl, drugo odpiranje blokira. Odklop čitalnika vrata odstrani. Ponovni priklop lahko ustvari novo ime in aplikacija mora ta vrata odpreti znova.

HID in serijski način

Lastnost Tipkovni klin HID Serijski USB
Dostava podatkov Vnos v slogu tipkovnice Serijski tok bajtov
Zahtevano žarišče vnosa Da. Pritiski sledijo kontrolniku v žarišču Ne. Bajti gredo v proces, ki je odprl vrata
Vez z brskalnikom Običajen vnos in dogodki tipkovnice Web Serial tam, kjer ga brskalnik podpira, ali program zunaj strani
Nadzor v aplikaciji Omejen na vedenje tipkovnice, žarišče in pripone Aplikacija bere tok in iz njega sestavlja sporočila
Prepoznava naprave Iz običajnih dogodkov tipkovnice ni na voljo Operacijski sistem lahko pokaže ime vrat. Trajna istovetnost je še vedno odvisna od gonilnika
Nastavitev Nastavitve čitalnika, tudi pripona in postavitev tipkovnice Nastavitve čitalnika in tiste nastavitve vrat na gostitelju, ki jih naprava zares uporablja
Običajna raba Obrazci in vnos postavk v POS Posebne integracije, ki napravo imajo v lasti

To so običajni primeri. Določen model, operacijski sistem in gonilnik se lahko razlikujejo. Čitalnik Bluetooth v načinu tipkovnice HID na ravni aplikacije gre po stolpcu klina. Bluetooth SPP gre po serijskem stolpcu.

Kako čitalniki HID delujejo v spletnih aplikacijah

Branje s klinom posodobi element v žarišču. Natisljivi znaki sprožijo keydown in nato input. Enter in Tab sprožita keydown in v običajen besedilni vnos ne vstavita znaka. Za ti tipki je event.key enak "Enter" ali "Tab", za natisljiv znak pa je niz iz enega znaka. event.code poimenuje fizično tipko in lahko ostane enak, ko neusklajena postavitev spremeni event.key.

Poslušalec spodaj polje potrdi šele, ko pride Enter. Čitalnik brez pripone Enter pusti besedilo v polju.

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 branjem dajte žarišče #barcode. preventDefault() prepreči, da bi se nadrejeni obrazec poslal še enkrat. Če čitalnik pošlje Tab, preberite vrednost v tem keydown in pustite, da brskalnik premakne žarišče. Če ne pošlje ne Enter ne Tab, pošljite polje z gumbom ali z drugim izrecnim dejanjem. Premor v tipkanju je samo hevristika konca branja.

V teh dogodkih ni ničesar, kar bi prepoznalo napravo USB. Isto zaporedje lahko ustvari človek, makro ali emulator. Preverjanje sodi k vsebini. Potek v brskalniku, vključno s Tab in praznim vnosom, je v vodniku Kako preizkusiti čitalnike črtnih kod v spletnih aplikacijah.

Kako serijski čitalniki delujejo v aplikacijah

Serijska integracija odpre vrata, bere bajte, razreže jih v sporočila in obravnava izginotje vrat. Na namizju je to serijski API operacijskega sistema ali knjižnica izdelovalca. V brskalniku je edina vgrajena možnost Web Serial API, in samo v brskalnikih, ki ga uresničijo.

Web Serial je na voljo v brskalnikih na osnovi Chromium. Firefox in Safari ga ne dajeta. Stran mora biti varen kontekst, torej HTTPS ali localhost. requestPort() mora steči iz geste uporabnika, uporabnik pa mora vrata izbrati v pozivu brskalnika. Čitalnik v načinu tipkovnega klina se na tem seznamu ne pojavi, ker ni serijska naprava. Web Serial tudi ne vidi serijskih vrat, ki jih operacijski sistem ni izpostavil.

Hitrost v primeru je izhodišče, ki ga zamenjate z vrednostjo iz priročnika. Zanka vzame CR ali LF kot konec sporočila in par CRLF porabi kot en zaključek. Če čitalnik uporablja drug okvir, je ta razrez napačen, tudi ko so vrata odprta.

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

Zanka branja teče, dokler se tok ne konča ali branje ne spodleti. Odklop čitalnika branje običajno zavrne. releaseLock() in close() se izvedeta v finally. Vrata, ki so bila za ta izvor že odobrena, je mogoče našteti z navigator.serial.getPorts() brez novega poziva. Prva odobritev še vedno zahteva uporabnika.

Namizna aplikacija sledi isti zamisli s serijskim API-jem platforme: odpre, bere, sestavi okvir in znova odpre, ko se naprava vrne. Ta stran ne izmišlja ukazov izdelovalca. Če čitalnik pričakuje lasten protokol, je ta protokol v dokumentaciji izdelovalca.

Kaj je boljše: HID ali serijski način?

Noben način ni boljši za vsak izdelek. Uporabite način, ki ga čitalnik zares ponuja, in način, ki ga aplikacija zna prebrati.

Izberite HID, ko

  • Aplikacija že sprejema vnos s tipkovnice v polju z žariščem.
  • Obrazec ali zaslon POS mora delovati brez kode za napravo.
  • Potek lahko zagotovi žarišče pred vsakim branjem.
  • Enter ali Tab se ujema s tem, kako ta obrazec potrdi vrednost ali gre naprej.

Premislite o serijskem načinu, ko

  • Branja morajo prispeti, medtem ko je žarišče v pogovornem oknu, na gumbu ali nikjer.
  • Bajti čitalnika morajo ostati ločeni od tipkanja.
  • Aplikacija zna odpreti vrata, sestaviti sporočila in si opomoči, ko napravo odklopite.
  • Gostitelj lahko da dovoljenje za ta vrata in noben drug proces jih istočasno ne potrebuje.

Čitalnika, ki se oglaša samo kot tipkovnica, na gostitelju s programom ni mogoče preklopiti v serijski način. Načine potrdite v priročniku, preden zasnujete integracijo.

Preklapljanje med HID in serijskim načinom

Nekateri čitalniki spremenijo način, ko preberete konfiguracijsko črtno kodo iz priročnika tega izdelovalca ali ko zapišete profil z orodjem izdelovalca. Drugi so zgrajeni kot en vmesnik in ni kaj preklopiti.

Ni konfiguracijske črtne kode, ki bi način spremenila pri vseh znamkah. Zaporedje, natisnjeno za drug model, lahko ne naredi nič ali pusti čitalnik v nepričakovanem načinu. Po vsaki spremembi poglejte, kaj pokaže operacijski sistem: tipkovnico, vrata COM ali oboje. Nato preizkusite pot, ki jo uporablja aplikacija. Vodnik za nastavitev čitalnika črtnih kod opisuje običajne skupine nastavitev. Priročnika modela ne nadomesti.

Preizkus čitalnika HID

  1. Priključite čitalnik in potrdite, da je v načinu tipkovnega klina. Urejevalnik besedila mora prejeti znake, ko ima polje v tem urejevalniku žarišče.
  2. Odprite preizkuševalnik vnosa črtnih kod.
  3. Kliknite Začni preizkus ali kliknite območje branja. Pomodri, ko je pripravljeno. Stran sama ne prevzame žarišča.
  4. Preberite črtno kodo, katere vsebino že poznate.
  5. Primerjajte zajeto vrednost in število znakov s to vsebino.
  6. Preberite pripono: ENTER, TAB ali None. Enter in Tab nista del niza črtne kode.

Preizkuševalnik beleži dogodke tipkovnice, ki jih brskalnik vidi. Serijskih vrat ne more brati in naprave USB ne more prepoznati. Ko je povprečna vrzel med znaki krajša od 100 ms, sporoči ta čas. Čas ni prepoznava strojne opreme. Za vsak keydown, vključno s key in code, uporabite preizkuševalnik dogodkov tipkovnice. Širši prehod je v vodniku Kako preizkusiti vnos čitalnika črtnih kod.

Preizkus serijskega čitalnika

Preizkuševalnik vnosa črtnih kod ne odpre vrat COM. Serijski preizkus potrebuje program, ki zna odpreti vrata, ki jih čitalnik izpostavi.

  1. Potrdite, da je čitalnik v serijskem načinu in da operacijski sistem pokaže vrata, ko je čitalnik priključen. Odklopite ga in preverite, da vrata izginejo.
  2. Zapišite ime vrat. Odvisno je od operacijskega sistema in se lahko ob naslednjem priklopu spremeni.
  3. Odprite vrata iz združljive aplikacije: serijskega terminala, vaše namizne aplikacije ali zgornjega primera Web Serial v brskalniku na osnovi Chromium prek HTTPS ali localhost.
  4. Nastavite hitrost, podatkovne bite, parnost in stop bite, ko jih priročnik navede. Vrednosti, ki jih v priročniku ni, si ne izmišljujte.
  5. Preberite znano črtno kodo.
  6. Primerjajte bajte ali dekodirano besedilo s to vsebino.
  7. Preverite okvir. Iščite predpono ter CR, LF ali CRLF za podatki, samo če je priročnik nastavil prav to.

Če odpiranje vrat ne uspe, ker so zasedena, zaprite drugi program, ki jih drži. Če je besedilo smeti, parametri linije ne ustrezajo napravi. Če se vrata nikoli ne pojavijo, je čitalnik morda še v načinu tipkovnice, gonilnik morda manjka ali uporabnik operacijskega sistema morda ne sme odpirati serijskih naprav.

Pogoste težave

Čitalnik deluje v urejevalniku besedila, ne pa v ciljni aplikaciji. Naprava tipka. Cilj nima žarišča ali poslušalec keydown zavrže tipke. Začnite z Čitalnik deluje v Notepadu, ne pa v POS.

Čitalnik ne tipka v nobeno besedilno polje. Lahko je v serijskem načinu, izklopljen ali simbola ne bere. Čitalnik v serijskem načinu ne bo tipkal. Preverite vrata COM, preden iščete napako v polju. Čitalnik črtnih kod ne deluje loči nedelujoč čitalnik od napačnega vmesnika.

Serijskih vrat ni. Način tipkovnice ne ustvari vrat COM. Manjkajoč gonilnik, kabel samo za polnjenje ali čitalnik brez serijskega načina dajo isti simptom. Opazujte seznam naprav operacijskega sistema, medtem ko čitalnik priklapljate.

Serijska vrata so že v uporabi. Brati jih sme samo en proces. Zaprite terminal ali drugo kopijo aplikacije, nato vrata odprite znova.

Nastavitve komunikacije so napačne. Neusklajena hitrost, parnost ali stop biti so videti kot naključni znaki. Nastavite vrednosti iz priročnika tega modela, nato znova preberite znano kodo.

ENTER ali TAB nikoli ne prideta. To je nastavitev pripone klina. Preizkuševalnik vnosa sporoči None. Glejte Čitalniku črtnih kod manjka ENTER in vodnik o priponah zgoraj. Serijski čitalnik ne pošlje tipke Enter. Lahko pošlje bajta CR ali LF.

Znaki so napačni pri čitalniku v načinu klina. Postavitev tipkovnice čitalnika in postavitev operacijskega sistema se lahko razideta. Serijskih bajtov ta postavitev ne preslika. Glejte Napačna postavitev tipkovnice čitalnika črtnih kod.

Brskalnik ne more do čitalnika. Čitalnik v načinu klina se v pozivu Web Serial ne bo pojavil. Firefox in Safari nimata Web Serial API. Stran, ki ni na HTTPS ali localhost, ga ne more uporabiti. Uporabnik lahko poziv za vrata tudi zapre.

Aplikacija čitalnik po odklopu izgubi. Čitalnik v načinu klina se vrne kot tipkovnica in naslednje branje še vedno zahteva žarišče. Serijskih vrat ni, dokler aplikacija ne odpre novih. Ime se s prejšnjim ni nujno ujemalo.

Scenariji integracije

Spletne aplikacije

Tipkovni klin ustreza polju z žariščem in običajnim dogodkom DOM. Serijski dostop znotraj strani pomeni Web Serial v brskalniku, ki ga podpira, varen kontekst in vrata, ki jih je izbral uporabnik. Stran, ki mora podpirati Firefox, Safari in kioske brez osebja, se ne more zanesti samo na Web Serial. Krajevni pomočnik lahko ima vrata COM in strani posreduje dokončane črtne kode. Ta pomočnik je ločena programska oprema. Preizkus klina tega programa ne vadi.

Sistemi POS

POS, ki da žarišče v polje postavke in vrednost potrdi s tipko Enter, je integracija klina. POS, ki mora brati, medtem ko je odprto modalno okno, ali ki mora tipkovnico prezreti, je serijska integracija. Mešanje da branja v napačnem polju ali branja, ki ne prispejo. Način čitalnika uskladite z zaslonom, ki je zares v službi.

Namizne aplikacije

Namizna aplikacija lahko sprejme vnos klina v kontrolniku, ki ima žarišče, ali odpre navidezna vrata COM in drži sejo za čas življenja procesa. Lastništvo vrat, ponovna povezava in okvir so del te seje. Žarišče ni.

Avtomatizacija QA

Barcode Scanner Emulator vtipka vrednost, ki jo izberete, v aplikacijo z žariščem in lahko pošlje ENTER, TAB ali gre brez pripone. S tem pokrije regresije tipkovnega klina: žarišče, preverjanje in obravnavo pripone. Ne ustvari navideznih vrat COM, ne našteje naprav USB in ne poustvari hitrosti niti okvira. Serijski preizkusi še vedno potrebujejo serijska vrata in bralni program ali preizkusnega dvojnika, ki zapiše isti bajtni okvir, kot ga aplikacija razčleni.

Kiosk

Kiosk, ki uporablja vnos klina, mora polje branja držati v žarišču čez pogovorna okna, ohranjevalnike zaslona in sporočila o napaki. Eno izgubljeno žarišče in naslednje branje zadene bližnjico ali nič. Kiosk, ki uporablja serijski način, lahko vrata bere brez tega žarišča in mora držati dovoljenje za napravo ter vrata znova odpreti po izgubi napajanja ali iztrganem kablu.

Kam sodi Barcode Scanner Emulator

Barcode Scanner Emulator je namizna aplikacija za Windows, macOS in Linux. Obnovi pot tipkovnice, ki jo uporablja čitalnik v načinu klina. Vnesete besedilo, izberete zakasnitev tipkanja in izberete pripono: nobena, ENTER ali TAB. Splošna bližnjica to besedilo vtipka v aplikacijo z žariščem.

Uporabite ga, da razvijate obrazce v slogu HID in lovite njihove regresije, ko čitalnika ni na mizi. Združite ga s preizkuševalnikom vnosa črtnih kod, da vidite vrednost, tipke predpone in pripono, ki jih je prejel brskalnik.

Ne posnema serijske naprave USB, navideznih vrat COM, naštevanja USB niti optičnega dekodiranja. To vedenje še vedno sodi k strojni opremi ali k serijskemu preizkusnemu dvojniku, ki ga upravljate.