Preskoči na sadržaj

Barcode Scanner Emulator

USB HID i serijski skeneri barkoda

Skener USB HID u načinu tipkovničkog klina utipka dekodirani barkod u aplikaciju koja ima fokus. Serijski skener USB otvara serijsko sučelje, često kao virtualni priključak COM, a aplikacija mora taj priključak otvoriti i pročitati bajtove. USB je kabel i sabirnica. HID i serijski način dva su različita načina na koja se podaci predaju.

Odaberite sučelje koje aplikacija zaista može pročitati. Blagajničko polje koje već prima tipkanje problem je tipkovničkog klina. Usluga koja mora primiti skeniranje dok nijedno tekstualno polje nije u fokusu, ili koja mora držati bajtove skenera odvojeno od tipkovnice, serijski je problem. Mnogi skeneri nude samo jedan od tih načina. Neki se mogu prebaciti. Priručnik tog modela popis je načina koje možete provjeriti.

Vodič Tipkovnički klin HID podrobno objašnjava put pritisaka. Kako rade skeneri barkoda? pokriva hvatanje i dekodiranje. Ova stranica uspoređuje dva sučelja na strani računala i provjere koje pripadaju svakome od njih.

Što je način tipkovničkog klina USB HID?

U načinu tipkovnice USB HID skener se nabraja kao tipkovnica. Operacijski sustav učitava svoj uobičajeni upravljački program tipkovnice. Nakon dekodiranja skener šalje znakove kao pritiske tipki u kontrolu koja ima fokus tipkovnice. Web-obrazac, polje stavke u POS-u ili tekstualno polje na radnoj površini mogu primiti taj unos bez koda pisanog posebno za skener.

Fokus odlučuje kamo znakovi idu. Ako predviđeno polje nije u fokusu, znakovi završe u drugoj kontroli ili se izgube. Skener ne klikće i ne pomiče pokazivač.

Iza sadržaja može slijediti postavljeni sufiks. Enter šalje mnoge obrasce s jednim poljem. Tab premješta fokus na sljedeću kontrolu. Niti jedna od tih tipki nije zajamčena. Odabir sufiksa obrađen je u vodiču Sufiksi ENTER i TAB u skenerima barkoda.

Obični događaji tipkovnice ne sadrže proizvođača skenera, serijski broj ni oznaku da su tipke stigle sa skenera. Preglednici koji imaju WebHID ipak odbijaju sučelja tipkovnice, pa stranica ne može otvoriti uređaj klina i pročitati sirova izvješća HID.

Što je serijski način skenera barkoda preko USB-a?

U serijskom načinu USB skener ne tipka. Izlaže serijsko sučelje preko USB-a. Operacijski sustav to sučelje obično pokazuje kao virtualni priključak COM: ime COM u Windowsu, uređaj cu ili tty u macOS-u, ili uređaj ttyACM ili ttyUSB u Linuxu. Ime dodjeljuje upravljački program i može se promijeniti nakon što se skener odspoji.

Virtualni priključak COM nije fizički priključak RS-232. RS-232 je električno sučelje, s vlastitim priključkom i razinama napona, koje računalo čita preko UART-a. Serijski USB rabi kabel USB. Aplikacija i dalje otvara serijski priključak i čita bajtove, ali signal na žici jest USB. Neki su proizvodi pravi skener RS-232 plus pretvarač s USB-a na serijski priključak. Drugi ostvaruju USB CDC i uopće ne govore RS-232. Za točku integracije uzmite priključak koji pokazuje operacijski sustav i ne pretpostavljajte da se električne pojedinosti podudaraju.

Aplikacija otvara priključak, čita tok bajtova i odlučuje gdje poruka počinje i završava. Uobičajen okvir jest tekst barkoda iza kojeg slijedi CR (0x0D), LF (0x0A) ili prvo CR pa onda LF. Taj okvir postavka je uređaja, a ne pravilo USB-a. Moguć je i bajt prefiksa, primjerice STX. Vodič Prefiks i sufiks u skenerima barkoda: potpuni vodič odvaja te bajtove od tipke Enter koju šalje skener u načinu klina.

Brzina, podatkovni bitovi, paritet i stop bitovi važni su na pravom UART-u i na mnogim pretvaračima s USB-a na serijski priključak. Pogrešna brzina daje smeće, a ne čistu pogrešku. Neki virtualni uređaji COM s USB CDC zanemaruju brzinu koju domaćin traži i svejedno isporučuju bajtove. Nema jedne postavke koja pristaje svakom virtualnom serijskom skeneru. Uzmite brzinu i okvir iz priručnika tog modela, zatim ih potvrdite poznatim barkodom.

Podatke prima proces koji drži priključak otvorenim. Fokus tipkovnice ne bira primatelja. Drugi program koji je priključak već otvorio blokirat će drugo otvaranje. Odspajanje skenera uklanja priključak. Ponovno priključivanje može stvoriti novo ime, a aplikacija mora taj priključak otvoriti iznova.

HID i serijski način

Značajka Tipkovnički klin HID Serijski USB
Isporuka podataka Unos u stilu tipkovnice Serijski tok bajtova
Potreban fokus unosa Da. Pritisci slijede kontrolu u fokusu Ne. Bajtovi idu u proces koji je otvorio priključak
Veza s preglednikom Običan unos i događaji tipkovnice Web Serial ondje gdje ga preglednik podržava, ili program izvan stranice
Upravljanje u aplikaciji Ograničeno na ponašanje tipkovnice, fokus i sufikse Aplikacija čita tok i slaže iz njega poruke
Prepoznavanje uređaja Nedostupno iz običnih događaja tipkovnice Operacijski sustav može pokazati ime priključka. Postojan identitet i dalje ovisi o upravljačkom programu
Konfiguracija Postavke skenera, uključujući sufiks i raspored tipkovnice Postavke skenera plus one postavke priključka na domaćinu koje uređaj stvarno rabi
Tipična uporaba Obrasci i unos stavki u POS Zasebne integracije kojima uređaj pripada

To su uobičajeni slučajevi. Određeni model, operacijski sustav i upravljački program mogu se razlikovati. Skener Bluetooth u načinu tipkovnice HID na sloju aplikacije ide stupcem klina. Bluetooth SPP ide serijskim stupcem.

Kako HID skeneri rade u web-aplikacijama

Skeniranje klinom ažurira element u fokusu. Ispisivi znakovi okidaju keydown, a zatim input. Enter i Tab okidaju keydown i ne umeću znak u obično tekstualno polje. Za te je tipke event.key jednak "Enter" ili "Tab", a za ispisivi znak niz je od jednog znaka. event.code imenuje fizičku tipku i može ostati isti kad nesklad rasporeda promijeni event.key.

Slušatelj niže potvrđuje polje tek kad stigne Enter. Skener bez sufiksa Enter ostavlja tekst u 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 = ''
})

Prije skeniranja dajte fokus #barcode. preventDefault() sprječava da se nadređeni obrazac pošalje drugi put. Ako skener šalje Tab, pročitajte vrijednost u tom keydown i dopustite pregledniku da premjesti fokus. Ako ne šalje ni Enter ni Tab, pošaljite polje gumbom ili drugom izričitom radnjom. Stanka u tipkanju samo je heuristika kraja skeniranja.

U tim događajima nema ničega što prepoznaje uređaj USB. Isti niz može stvoriti čovjek, makro ili emulator. Provjera pripada sadržaju. Tijek u pregledniku, uključujući Tab i prazan unos, opisan je u vodiču Kako testirati skenere barkoda u web-aplikacijama.

Kako serijski skeneri rade u aplikacijama

Serijska integracija otvara priključak, čita bajtove, reže ih u poruke i obrađuje nestanak priključka. Na radnoj površini to je serijski API operacijskog sustava ili knjižnica proizvođača. U pregledniku jedina je ugrađena mogućnost Web Serial API, i to samo u preglednicima koji ga ostvaruju.

Web Serial dostupan je u preglednicima utemeljenima na Chromiumu. Firefox i Safari ga ne daju. Stranica mora biti siguran kontekst, što znači HTTPS ili localhost. requestPort() mora krenuti iz geste korisnika, a korisnik mora odabrati priključak u upitu preglednika. Skener u načinu tipkovničkog klina ne pojavljuje se na tom popisu jer nije serijski uređaj. Web Serial također ne vidi serijski priključak koji operacijski sustav nije izložio.

Brzina u primjeru polazna je točka koju zamjenjujete vrijednošću iz priručnika. Petlja CR ili LF uzima kao kraj poruke i par CRLF troši kao jedan završetak. Ako skener rabi drugi okvir, ta je podjela pogrešna čak i kad je priključak 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>

Petlja čitanja traje dok tok ne završi ili čitanje ne padne. Odspajanje skenera obično odbija čitanje. releaseLock() i close() izvršavaju se u finally. Priključci već odobreni za to podrijetlo mogu se nabrojiti pomoću navigator.serial.getPorts() bez novog upita. Prvo odobrenje i dalje traži korisnika.

Stolna aplikacija slijedi istu zamisao sa serijskim API-jem platforme: otvoriti, čitati, složiti okvir i otvoriti ponovno kad se uređaj vrati. Ova stranica ne izmišlja naredbe proizvođača. Ako skener očekuje vlastiti protokol, taj je protokol u dokumentaciji proizvođača.

Što je bolje: HID ili serijski način?

Nijedan način nije bolji za svaki proizvod. Rabite način koji skener stvarno nudi i način koji aplikacija može pročitati.

Odaberite HID kad

  • Aplikacija već prima unos s tipkovnice u polju s fokusom.
  • Obrazac ili zaslon POS-a trebaju raditi bez koda za uređaj.
  • Tijek može zajamčiti fokus prije svakog skeniranja.
  • Enter ili Tab odgovaraju tome kako taj obrazac potvrđuje vrijednost ili ide dalje.

Razmotrite serijski način kad

  • Skeniranja moraju stizati dok je fokus u dijalogu, na gumbu ili nigdje.
  • Bajtovi skenera moraju ostati odvojeni od tipkanja.
  • Aplikacija može otvoriti priključak, složiti poruke i oporaviti se kad se uređaj odspoji.
  • Domaćin može dati dopuštenje za taj priključak i nijedan drugi proces ne treba ga u isto vrijeme.

Skener koji se nabraja samo kao tipkovnica ne može se na domaćinu prebaciti u serijski način programom. Potvrdite načine u priručniku prije nego što osmislite integraciju.

Prebacivanje između HID-a i serijskog načina

Neki skeneri mijenjaju način kad skenirate konfiguracijski barkod iz priručnika tog proizvođača ili kad zapišete profil alatom proizvođača. Drugi su građeni kao jedno sučelje i nema što prebaciti.

Nema konfiguracijskog barkoda koji mijenja način kod svih marki. Niz otisnut za drugi model može ne učiniti ništa ili ostaviti skener u neočekivanom načinu. Nakon svake promjene pogledajte što pokazuje operacijski sustav: tipkovnicu, priključak COM ili oboje. Zatim isprobajte put kojim se služi aplikacija. Vodič za konfiguraciju skenera barkoda opisuje uobičajene skupine postavki. Ne zamjenjuje priručnik modela.

Testiranje HID skenera

  1. Priključite skener i potvrdite da je u načinu tipkovničkog klina. Uređivač teksta treba primiti znakove kad je polje u tom uređivaču u fokusu.
  2. Otvorite tester unosa barkoda.
  3. Kliknite Pokrenite test ili kliknite područje skeniranja. Poplavi kad je spremno. Stranica sama ne preuzima fokus.
  4. Skenirajte barkod čiji sadržaj već znate.
  5. Usporedite uhvaćenu vrijednost i broj znakova s tim sadržajem.
  6. Pročitajte sufiks: ENTER, TAB ili None. Enter i Tab nisu dio niza barkoda.

Tester bilježi događaje tipkovnice koje preglednik vidi. Ne može čitati serijski priključak i ne može prepoznati uređaj USB. Kad je prosječan razmak između znakova kraći od 100 ms, javlja to vrijeme. Vrijeme nije prepoznavanje hardvera. Za svaki keydown, uključujući key i code, upotrijebite tester događaja tipkovnice. Širi prolaz nalazi se u vodiču Kako testirati unos skenera barkoda.

Testiranje serijskog skenera

Tester unosa barkoda ne otvara priključak COM. Serijski test treba program koji može otvoriti priključak koji skener izlaže.

  1. Potvrdite da je skener u serijskom načinu i da operacijski sustav nabraja priključak kad je skener priključen. Odspojite ga i provjerite da priključak nestaje.
  2. Zapišite ime priključka. Ovisi o operacijskom sustavu i može se promijeniti pri sljedećem priključivanju.
  3. Otvorite priključak iz sukladne aplikacije: serijskog terminala, vaše stolne aplikacije ili primjera Web Serial iznad u pregledniku utemeljenom na Chromiumu, preko HTTPS-a ili localhosta.
  4. Postavite brzinu, podatkovne bitove, paritet i stop bitove kad ih priručnik navodi. Vrijednosti kojih u priručniku nema ne izmišljajte.
  5. Skenirajte poznati barkod.
  6. Usporedite bajtove ili dekodirani tekst s tim sadržajem.
  7. Provjerite okvir. Tražite prefiks te CR, LF ili CRLF iza podataka, samo ako je priručnik upravo to postavio.

Ako otvaranje priključka ne uspije jer je zauzet, zatvorite drugi program koji ga drži. Ako je tekst smeće, parametri linije ne odgovaraju uređaju. Ako se priključak nikad ne pojavi, skener može još biti u načinu tipkovnice, upravljački program može nedostajati ili korisnik operacijskog sustava možda ne smije otvarati serijske uređaje.

Česti problemi

Skener radi u uređivaču teksta, a ne u ciljnoj aplikaciji. Uređaj tipka. Cilj nema fokus ili slušatelj keydown odbacuje tipke. Počnite s Skener radi u Notepadu, ali ne u POS-u.

Skener ne tipka ni u jedno tekstualno polje. Može biti u serijskom načinu, isključen ili ne čita simbol. Skener u serijskom načinu neće tipkati. Provjerite priključak COM prije nego što tražite grešku u polju. Skener barkoda ne radi odvaja neispravan skener od krivog sučelja.

Serijski priključak nedostaje. Način tipkovnice ne stvara priključak COM. Nedostajući upravljački program, kabel samo za punjenje ili skener bez serijskog načina daju isti simptom. Gledajte popis uređaja operacijskog sustava dok priključujete skener.

Serijski priključak već je u uporabi. Čitati ga može samo jedan proces. Zatvorite terminal ili drugu kopiju aplikacije, zatim priključak otvorite ponovno.

Postavke komunikacije su krive. Nesklad brzine, pariteta ili stop bitova izgleda kao nasumični znakovi. Postavite vrijednosti iz priručnika tog modela, zatim ponovno skenirajte poznati kod.

ENTER ili TAB nikad ne stignu. To je postavka sufiksa klina. Tester unosa javlja None. Pogledajte Skeneru barkoda nedostaje ENTER i vodič o sufiksima iznad. Serijski skener ne šalje tipku Enter. Može poslati bajtove CR ili LF.

Znakovi su krivi na skeneru u načinu klina. Raspored tipkovnice skenera i raspored operacijskog sustava mogu se razići. Serijske bajtove taj raspored ne preslikava. Pogledajte Pogrešan raspored tipkovnice skenera barkoda.

Preglednik ne može doći do skenera. Skener u načinu klina neće se pojaviti u upitu Web Serial. Firefox i Safari nemaju Web Serial API. Stranica koja nije na HTTPS-u ni na localhostu ne može ga rabiti. Korisnik može i zatvoriti upit za priključak.

Aplikacija izgubi skener nakon odspajanja. Skener u načinu klina vraća se kao tipkovnica, a sljedeće skeniranje i dalje traži fokus. Serijskog priključka nema dok aplikacija ne otvori novi priključak. Ime se ne mora podudarati s prethodnim.

Scenariji integracije

Web-aplikacije

Tipkovnički klin pristaje polju s fokusom i običnim događajima DOM. Serijski pristup unutar stranice znači Web Serial u pregledniku koji ga podržava, siguran kontekst i priključak koji je odabrao korisnik. Stranica koja mora podržati Firefox, Safari i nenadzirane kioske ne može se osloniti samo na Web Serial. Lokalni pomoćnik može držati priključak COM i prosljeđivati gotove barkodove stranici. Taj je pomoćnik zaseban softver. Provjera klina taj program ne vježba.

Sustavi POS

POS koji stavlja fokus u polje stavke i potvrđuje vrijednost tipkom Enter integracija je klina. POS koji mora skenirati dok je otvoren modalni dijalog, ili koji mora zanemariti tipkovnicu, serijska je integracija. Miješanje daje skeniranja u krivom polju ili skeniranja koja ne stignu. Uskladite način skenera sa zaslonom koji je stvarno na dužnosti.

Stolne aplikacije

Stolna aplikacija može primiti unos klina u kontroli koja je u fokusu ili otvoriti virtualni priključak COM i držati sesiju za vijek procesa. Vlasništvo nad priključkom, ponovno povezivanje i okvir dio su te sesije. Fokus nije.

Automatizacija QA

Barcode Scanner Emulator utipka vrijednost koju odaberete u aplikaciju s fokusom i može poslati ENTER, TAB ili proći bez sufiksa. Time pokriva regresije tipkovničkog klina: fokus, provjeru i obradu sufiksa. Ne stvara virtualni priključak COM, ne nabraja uređaje USB i ne reproducira brzinu ni okvir. Serijske provjere i dalje trebaju serijski priključak i program za čitanje, ili testnog dvojnika koji piše isti bajtni okvir koji aplikacija rastavlja.

Kiosk aplikacije

Kiosk koji rabi unos klina mora držati polje skeniranja u fokusu kroz dijaloge, čuvare zaslona i poruke o pogrešci. Jedan izgubljen fokus i sljedeće skeniranje pogađa prečac ili ništa. Kiosk koji rabi serijski način može čitati priključak bez tog fokusa i mora držati dopuštenje za uređaj te ponovno otvoriti priključak nakon gubitka napajanja ili iščupanog kabela.

Gdje pristaje Barcode Scanner Emulator

Barcode Scanner Emulator stolna je aplikacija za Windows, macOS i Linux. Obnavlja put tipkovnice kojim se služi skener u načinu klina. Unesete tekst, odaberete kašnjenje tipkanja i odaberete sufiks: nema, ENTER ili TAB. Globalni prečac utipka taj tekst u aplikaciju s fokusom.

Rabite ga da razvijate obrasce u stilu HID i hvatate njihove regresije kad skenera nema na stolu. Sparite ga s testerom unosa barkoda da vidite vrijednost, tipke prefiksa i sufiks koji je preglednik primio.

Ne oponaša serijski uređaj USB, virtualni priključak COM, nabrajanje USB-a ni optičko dekodiranje. To ponašanje i dalje pripada hardveru ili serijskom testnom dvojniku kojim upravljate.