Liigu sisu juurde

Barcode Scanner Emulator

USB HID ja jada-vöötkoodiskannerid

USB HID-klaviatuurikiiluga skanner trükib dekodeeritud vöötkoodi fookuses olevasse rakendusse. USB-jadaskanner avab jadaliidese, sageli virtuaalse COM-pordina, ja rakendus peab selle pordi avama ning baidid lugema. USB on kaabel ja siin. HID ja jada on erinevad viisid andmete esitamiseks.

Valige liides, mida rakendus tegelikult lugeda saab. Kassaväli, mis juba võtab tippimist vastu, on klaviatuurikiilu ülesanne. Teenus, mis peab skannimisi vastu võtma siis, kui ükski tekstiväli ei ole fookuses, või mis peab hoidma skanneri baidid klaviatuurist eraldi, on jadaülesanne. Paljud skannerid pakuvad neist režiimidest ainult ühte. Mõnda saab vahetada. Selle mudeli juhend on loetelu režiimidest, mida saate testida.

Juhend HID-klaviatuurikiil selgitab klahvivajutuste teed üksikasjalikult. Kuidas vöötkoodiskannerid töötavad? käsitleb hõivet ja dekodeerimist. See leht võrdleb kaht hosti liidest ja teste, mis kummagi juurde kuuluvad.

Mis on USB HID-klaviatuurikiilu režiim?

USB HID-klaviatuurirežiimis loendab skanner end klaviatuurina. Operatsioonisüsteem laadib oma tavalise klaviatuuridraiveri. Pärast dekodeerimist saadab skanner märgid klahvivajutustena juhtelemendile, millel on klaviatuuri fookus. Veebivorm, POS-i kaubaväli või töölaua tekstikast saab selle sisendi vastu võtta ilma skanneripõhise koodita.

Fookus otsustab sihtkoha. Kui mõeldud väli ei ole fookuses, satuvad märgid teise juhtelementi või lähevad kaduma. Skanner ei klõpsa ega liiguta kursorit.

Seadistatud järelliide võib andmesisule järgneda. Enter esitab paljud ühe väljaga vormid. Tab viib fookuse järgmisele juhtelemendile. Kumbki klahv ei ole garanteeritud. Järelliite valikuid käsitletakse juhendis ENTER ja TAB järelliited vöötkoodiskannerites.

Tavalised klaviatuurisündmused ei sisalda skanneri tootjat, seerianumbrit ega lippu, mis ütleks, et klahvid tulid skannerist. Brauserid, mis rakendavad WebHID-i, keelduvad endiselt klaviatuuriliidestest, nii et leht ei saa kiiluseadet avada ega tooreid HID-aruandeid lugeda.

Mis on USB-jada vöötkoodiskanneri režiim?

USB-jadarežiimis skanner ei tipi. See avab jadaliidese üle USB. Operatsioonisüsteem esitab selle liidese tavaliselt virtuaalse COM-pordina: COM-nime Windowsiss, cu- või tty-seadmena macOS-is või ttyACM- või ttyUSB-seadmena Linuxis. Nime määrab draiver ja see võib pärast skanneri lahtiühendamist muutuda.

Virtuaalne COM-port ei ole füüsiline RS-232 port. RS-232 on elektriline liides, millel on oma pistik ja pingetasemed ning mida arvuti loeb UART-i kaudu. USB-jada kasutab USB-kaablit. Rakendus avab endiselt jadapordi ja loeb baite, kuid juhtmel olev signaal on USB. Mõni toode on päris RS-232 skanner koos USB-jadaadapteriga. Teine rakendab USB CDC-d ega räägi RS-232-te üldse. Käsitlege porti, mida operatsioonisüsteem teile näitab, lõimimispunktina, ja ärge eeldage, et elektrilised üksikasjad kattuvad.

Rakendus avab pordi, loeb baidivoo ja otsustab, kust sõnum algab ja kus lõpeb. Tavaline raam on vöötkoodi tekst, millele järgneb CR (0x0D), LF (0x0A) või CR ja seejärel LF. See raamistik on seadme säte, mitte USB reegel. Võimalik on ka eesliitebait, näiteks STX. Vöötkoodiskanneri eesliite ja järelliite juhend eraldab need baidid Enter-klahvist, mille kiiluskanner saadab.

Andmeedastuskiirus, andmebitid, paarsus ja stopp-bitid loevad päris UART-il ja paljudel USB-jadaadapteritel. Vale kiirus annab sogase teksti, mitte puhta vea. Mõni USB CDC virtuaalne COM-seade eirab hosti küsitud andmeedastuskiirust ja toimetab baidid ikkagi kohale. Üht sätet, mis sobiks igale virtuaalsele jadaskannerile, ei ole. Kasutage selle mudeli juhendi kiirust ja raamistikku ning kinnitage need tuntud vöötkoodiga.

Andmed saab protsess, mis hoiab porti avatuna. Klaviatuuri fookus ei vali sihtkohta. Teine programm, millel port on juba avatud, blokeerib teise avamise. Skanneri lahtiühendamine eemaldab pordi. Tagasi ühendamine võib luua uue nime ja rakendus peab selle pordi uuesti avama.

HID ja jada

Omadus HID-klaviatuurikiil USB-jada
Andmete kohaletoimetamine Klaviatuurilaadne sisend Jada baidivoog
Sisendi fookus on nõutav Jah. Klahvivajutused järgnevad fookuses olevale juhtelemendile Ei. Baidid lähevad protsessile, mis pordi avas
Brauserisse lõimimine Tavaline sisend ja klaviatuurisündmused Web Serial seal, kus brauser seda toetab, või tarkvara väljaspool lehte
Rakenduse juhtimine Piiratud klaviatuuri käitumise, fookuse ja järelliidetega Rakendus loeb voo ja raamib selle
Seadme tuvastamine Tavalistest klaviatuurisündmustest ei ole saadaval Operatsioonisüsteem saab näidata pordi nime. Püsiv identiteet sõltub ikka draiverist
Seadistus Skanneri sätted, sealhulgas järelliide ja klaviatuuripaigutus Skanneri sätted ning hosti pordisätted, mida seade tegelikult kasutab
Tüüpiline kasutus Vormid ja POS-i kaubasisestus Pühendatud lõimimised, mis seadet omavad

Need on tavalised juhud. Konkreetne mudel, operatsioonisüsteem ja draiver võivad erineda. Bluetooth-skanner HID-klaviatuurirežiimis järgib rakendusekihil kiilu veergu. Bluetooth SPP järgib jada veergu.

Kuidas HID-skannerid veebirakendustes töötavad

Kiiluskannimine uuendab fookuses olevat elementi. Prinditavad märgid käivitavad keydown ja seejärel input. Enter ja Tab käivitavad keydown ega lisa tavalisse tekstisisendisse märki. event.key on nende klahvide puhul "Enter" või "Tab" ning prinditava märgi puhul ühemärgiline string. event.code nimetab füüsilise klahvi ja võib jääda samaks, kui klaviatuuripaigutuse sobimatus muudab event.key.

Allolev kuulaja kinnitab välja ainult siis, kui Enter saabub. Skanner, millel Enter-järelliidet ei ole, jätab teksti välja.

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

Fokuseerige #barcode enne skannimist. preventDefault() hoiab ülemvormi teist korda esitamast. Kui skanner saadab hoopis Tabi, lugege väärtus selles keydown-is ja laske brauseril fookust liigutada. Kui see ei saada kumbagi, esitage väli nupust või muust selgest toimingust. Paus tippimises on ainult heuristika skannimise lõpu jaoks.

Nendes sündmustes ei ole midagi, mis USB-seadme tuvastaks. Inimene, makro või emulaator võib anda sama jada. Kontroll kuulub andmesisule. Brauseri töövoog, sealhulgas Tab ja tühi sisend, on juhendis Kuidas testida vöötkoodiskannereid veebirakendustes.

Kuidas jadaskannerid rakendustes töötavad

Jadalõimimine avab pordi, loeb baite, jagab need sõnumiteks ja tuleb toime pordi kadumisega. Töölaual on see operatsioonisüsteemi jada-API või tootja teek. Brauseris on ainus sisseehitatud valik Web Serial API, ja ainult brauserites, mis seda rakendavad.

Web Serial on saadaval Chromiumil põhinevates brauserites. Firefox ja Safari seda ei paku. Leht peab olema turvaline kontekst, mis tähendab HTTPS-i või localhosti. requestPort() peab jooksma kasutaja žestist ja kasutaja peab pordi brauseri viibas valima. Klaviatuurikiiluga skanner selles loendis ei ilmu, sest see ei ole jadaseade. Web Serial ei näe ka jadaporti, mida operatsioonisüsteem ei ole avanud.

Näite andmeedastuskiirus on lähtepunkt, mille asendate juhendi väärtusega. Tsükkel käsitleb CR-i või LF-i sõnumi lõpuna ja tarbib CRLF-paari ühe lõpetajana. Kui teie skanner kasutab teistsugust raami, on see tükeldus vale ka siis, kui port on avatud.

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

Lugemistsükkel jookseb, kuni voog lõpeb või lugemine ebaõnnestub. Skanneri lahtiühendamine tavaliselt lükkab lugemise tagasi. releaseLock() ja close() jooksevad finally-plokis. Selle päritolu varem kinnitatud porte saab loetleda käsuga navigator.serial.getPorts(), ilma viipa uuesti näitamata. Esimene kinnitus nõuab ikka kasutajat.

Töölauarakendus järgib sama mõtet platvormi jada-API-ga: ava, loe, raami ja ava uuesti pärast seadme naasmist. See leht ei mõtle välja tootja käske. Kui skanner ootab tootjapõhist protokolli, on see protokoll tootja dokumentatsioonis.

Kumb on parem: HID või jada?

Ükski režiim ei ole iga toote jaoks parem. Kasutage režiimi, mida skanner tegelikult pakub, ja režiimi, mida rakendus lugeda saab.

Valige HID, kui

  • Rakendus võtab juba fookuses oleval väljal klaviatuurisisendit vastu.
  • Soovite, et vorm või POS-i ekraan töötaks ilma seadmekoodita.
  • Töövoog suudab enne iga skannimist fookuse tagada.
  • Enter või Tab vastab sellele, kuidas see vorm kinnitab või edasi liigub.

Kaaluge jada, kui

  • Skannimised peavad saabuma siis, kui fookus on dialoogis, nupul või eikuskil.
  • Skanneri baidid peavad jääma tippimisest eraldi.
  • Rakendus suudab pordi avada, sõnumeid raamida ja taastuda, kui seade lahti ühendatakse.
  • Host saab sellele pordile loa anda ja ükski teine protsess ei vaja seda samal ajal.

Skannerit, mis loendab end ainult klaviatuurina, ei saa hosti tarkvaras jadaks lülitada. Kinnitage režiimid juhendis, enne kui lõimimise kavandate.

Vahetamine HID-i ja jada vahel

Mõni skanner vahetab režiimi, kui skannite seadistusvöötkoodi selle tootja juhendist, või kui kirjutate profiili tootja utiliidiga. Teine on ehitatud ühe liidesena ja sellel ei ole midagi vahetada.

Seadistusvöötkoodi, mis muudaks iga kaubamärki, ei ole. Teise mudeli jaoks trükitud jada võib mitte midagi teha või jätta skanneri ootamatusse režiimi. Pärast mis tahes muudatust kontrollige, mida operatsioonisüsteem näitab: klaviatuuri, COM-porti või mõlemat. Seejärel testige teed, mida teie rakendus kasutab. Vöötkoodiskanneri seadistamise juhend kirjeldab tavalisi säteterühmi. See ei asenda juhendit.

HID-skanneri testimine

  1. Ühendage skanner ja kinnitage, et see on klaviatuurikiilu režiimis. Tekstiredaktor peaks saama märke, kui selle redaktori väli on fookuses.
  2. Avage vöötkoodisisendi tester.
  3. Klõpsake Alusta testi või klõpsake skannimisala. See muutub valmisolekul siniseks. Leht ei võta fookust ise.
  4. Skannige vöötkood, mille andmesisu te juba teate.
  5. Võrrelge hõivatud väärtust ja märkide arvu selle andmesisuga.
  6. Lugege järelliide: ENTER, TAB või Puudub. Enter ja Tab ei kuulu vöötkoodi stringi.

Tester salvestab klaviatuurisündmused, mida brauser näeb. See ei saa jadaporti lugeda ega USB-seadet tuvastada. Kui märkide vaheline keskmine vahe on alla 100 ms, teatab see sellest ajastusest. Ajastus ei ole riistvara tuvastus. Iga keydown jaoks, sealhulgas key ja code, kasutage klaviatuurisündmuste testerit. Laiem QA-käik on juhendis Kuidas testida vöötkoodiskanneri sisendit.

Jadaskanneri testimine

Vöötkoodisisendi tester ei ava COM-porti. Jadatest vajab programmi, mis suudab avada pordi, mille skanner avab.

  1. Kinnitage, et skanner on jadarežiimis ja et operatsioonisüsteem loetleb pordi, kui see on ühendatud. Ühendage see lahti ja kontrollige, et port kaob.
  2. Märkige pordi nimi üles. See on operatsioonisüsteemipõhine ja võib järgmisel ühendamisel muutuda.
  3. Avage port ühilduvast rakendusest: jadaterminalist, oma töölauarakendusest või ülaltoodud Web Seriali näitest Chromiumi brauseris HTTPS-il või localhostil.
  4. Määrake andmeedastuskiirus, andmebitid, paarsus ja stopp-bitid, kui juhend need ette näeb. Jätke välja mõeldud väärtused.
  5. Skannige tuntud vöötkood.
  6. Võrrelge baite või dekodeeritud teksti selle andmesisuga.
  7. Kontrollige raamistikku. Otsige eesliidet ning CR-i, LF-i või CRLF-i andmete järel ainult siis, kui juhend just selle seadistas.

Kui pordi avamine ebaõnnestub, sest see on hõivatud, sulgege teine programm, mis seda hoiab. Kui tekst on sogane, ei vasta liinisätted seadmele. Kui porti kunagi ei ilmu, võib skanner olla endiselt klaviatuurirežiimis, draiver võib puududa või operatsioonisüsteemi kasutajal ei pruugi olla luba jadaseadmeid avada.

Tavalised probleemid

Skanner töötab tekstiredaktoris, kuid mitte sihtrakenduses. Seade tipib. Sihtkohal ei ole fookust või keydown-kuulaja viskab klahvid kõrvale. Alustage juhendist Skanner töötab Notepadis, kuid mitte POS-is.

Skanner ei tipi ühtegi tekstivälja. See võib olla jadarežiimis, välja lülitatud või ei loe sümbolit. Jadarežiimis skanner ei tipi. Otsige COM-porti, enne kui välja silute. Vöötkoodiskanner ei tööta eraldab surnud skanneri valest liidesest.

Jadaport puudub. Klaviatuurirežiim ei loo COM-porti. Puuduv draiver, ainult laadimiseks mõeldud kaabel või skanner, millel jadarežiimi ei ole, annab sama sümptomi. Jälgige operatsioonisüsteemi seadmete loendit, kui skanneri ühendate.

Jadaport on juba kasutusel. Seda saab lugeda ainult üks protsess. Sulgege terminal või rakenduse teine koopia ja avage see siis uuesti.

Sidesätted on valed. Sobimatu andmeedastuskiirus, paarsus või stopp-bitid näevad välja nagu juhuslikud märgid. Määrake selle mudeli väärtused juhendist ja skannige siis tuntud kood uuesti.

ENTER või TAB ei saabu kunagi. See on kiilu järelliite säte. Sisendi tester teatab Puudub. Vt Vöötkoodiskanneril puudub ENTER ja ülal viidatud järelliite juhendit. Jadaskanner ei saada Enter-klahvi. See võib saata hoopis CR- või LF-baite.

Märgid on kiiluskanneril valed. Skanneri klaviatuuripaigutus ja operatsioonisüsteemi paigutus võivad lahkneda. Jadabaite see paigutus ümber ei vastenda. Vt Vöötkoodiskanneri vale klaviatuuripaigutus.

Brauser ei pääse skannerile ligi. Kiiluskanner ei ilmu Web Seriali viibas. Firefoxil ja Safaril ei ole Web Serial API-t. Leht, mis ei ole HTTPS ega localhost, ei saa seda kasutada. Kasutaja võib pordiviiba ka sulgeda.

Rakendus kaotab skanneri pärast lahtiühendamist. Kiiluskanner naaseb klaviatuurina ja järgmine skannimine nõuab ikka fookust. Jadaport on kadunud, kuni rakendus uue pordi avab. Nimi ei pruugi eelmise omaga kattuda.

Lõimimise stsenaariumid

Veebirakendused

Klaviatuurikiil sobib fookuses olevale sisendile ja tavalistele DOM-sündmustele. Jadapääs lehe sees tähendab Web Serialit toetavas brauseris, turvalist konteksti ja kasutaja valitud porti. Leht, mis peab toetama Firefoxi, Safarit ja järelevalveta kioskeid, ei saa toetuda ainult Web Serialile. Kohalik abiline saab omada COM-porti ja edastada valmis vöötkoodid lehele. See abiline on eraldi tarkvara. Leht ei peaks ikkagi eeldama, et kiilutest seda läbi mängib.

POS-süsteemid

POS, mis paneb fookuse kaubaväljale ja kinnitab Enteriga, on kiilulõimimine. POS, mis peab skannima ajal, mil modaal on avatud, või mis peab klaviatuuri eirama, on jadalõimimine. Nende segamine viib skannimised valesse välja või jätab need saabumata. Sobitage skanneri režiim ekraaniga, mis tegelikult töös on.

Töölauarakendused

Töölauarakendus saab võtta kiilusisendit vastu juhtelemendis, mis on fookuses, või avada virtuaalse COM-pordi ja hoida seanssi protsessi eluea jooksul. Pordi omand, taasühendus ja raamistik on selle seansi osa. Fookus ei ole.

QA-automaatika

Barcode Scanner Emulator trükib teie valitud väärtuse fookuses olevasse rakendusse ja saab saata ENTER, TAB või järelliite puudumise. See katab klaviatuurikiilu regressioonid: fookuse, kontrolli ja järelliite käsitlemise. See ei loo virtuaalset COM-porti, ei loenda USB-seadmeid ega taasesita andmeedastuskiirust ja raamistikku. Jadatestid vajavad ikka jadaporti ja lugejat või testdublanti, mis kirjutab sama baidiraami, mida teie rakendus sõelub.

Kioskirakendused

Kiosk, mis kasutab kiilusisendit, peab hoidma skannivälja fookuses üle dialoogide, ekraanisäästjate ja veateadete. Üks kadunud fookus ja järgmine skannimine tabab otseteed või mitte midagi. Kiosk, mis kasutab jada, saab porti lugeda ilma selle fookuseta ning peab hoidma seadmele luba ja pordi pärast voolukatkestust või kaabli väljatõmbamist uuesti avama.

Kuhu Barcode Scanner Emulator sobib

Barcode Scanner Emulator on töölauarakendus Windowsile, macOS-ile ja Linuxile. See taasesitab klaviatuuritee, mida kiiluskanner kasutab. Sisestate teksti, valite tippimisviivituse ja valite järelliite: puudub, ENTER või TAB. Globaalne otsetee trükib selle teksti fookuses olevasse rakendusse.

Kasutage seda HID-laadsete vormide arendamiseks ja regressiooniks, kui skanner ei ole laual. Siduge see vöötkoodisisendi testeriga, et näha väärtust, eesliiteklahve ja järelliidet, mille brauser sai.

See ei emuleeri USB-jadaseadet, virtuaalset COM-porti, USB loendamist ega optilist dekodeerimist. Need käitumised kuuluvad ikka riistvarale või jadatestdublantile, mida teie juhite.