Lumaktaw sa nilalaman

Barcode Scanner Emulator

USB HID laban sa serial barcode scanner

Ang USB HID keyboard-wedge scanner ay nagta-type ng na-decode na barcode sa application na may focus. Ang USB serial scanner ay naglalantad ng serial interface, kadalasang virtual na COM port, at kailangang buksan ng application ang port na iyon at basahin ang mga byte. Ang USB ang cable at ang bus. Ang HID at serial ay magkaibang paraan ng pagpapakita ng data.

Piliin ang interface na talagang nababasa ng application. Ang checkout field na tumatanggap na ng pagta-type ay problema ng keyboard wedge. Ang serbisyong kailangang tumanggap ng scan habang walang text field na may focus, o kailangang panatilihing hiwalay ang mga byte ng scanner sa keyboard, ay problema ng serial. Isa lang sa mga mode na iyon ang inaalok ng maraming scanner. May ilan na maaaring magpalit. Ang manual ng modelong iyon ang listahan ng mga mode na puwede mong subukan.

Ipinapaliwanag nang detalyado ng gabay na HID keyboard wedge ang landas ng keystroke. Sinasaklaw ng Paano gumagana ang mga barcode scanner? ang pagkuha at pag-decode. Inihahambing ng pahinang ito ang dalawang host interface at ang mga pagsubok na kabilang sa bawat isa.

Ano ang USB HID keyboard wedge mode?

Sa USB HID keyboard mode, nag-e-enumerate ang scanner bilang keyboard. Niloload ng operating system ang karaniwan nitong keyboard driver. Pagkatapos ng decode, ipinapadala ng scanner ang mga karakter bilang keystroke sa control na may keyboard focus. Matatanggap ng web form, ng item field ng POS, o ng desktop text box ang input na iyon nang walang code na partikular sa scanner.

Ang focus ang nagpapasya ng destinasyon. Kung walang focus ang nilalayong field, napupunta ang mga karakter sa ibang control o nawawala. Hindi nagki-click ang scanner, at hindi nito ginagalaw ang pointer.

Maaaring sumunod sa payload ang naka-configure na hulapi. Nagsa-submit ang Enter ng maraming single-field form. Inililipat ng Tab ang focus sa susunod na control. Walang garantisadong key sa dalawa. Ang mga pagpili ng hulapi ay tinalakay sa Mga hulaping ENTER laban sa TAB sa mga barcode scanner.

Walang vendor ng scanner, serial number, o flag na nagsasabing galing sa scanner ang mga key ang ordinaryong keyboard event. Tinatanggihan pa rin ng mga browser na nagpapatupad ng WebHID ang mga keyboard interface, kaya hindi mabubuksan ng page ang wedge device at hindi mababasa ang raw na HID report.

Ano ang USB serial barcode scanner mode?

Sa USB serial mode, hindi nagta-type ang scanner. Naglalantad ito ng serial interface sa USB. Karaniwang ipinapakita ng operating system ang interface na iyon bilang virtual na COM port: pangalan ng COM sa Windows, device na cu o tty sa macOS, o device na ttyACM o ttyUSB sa Linux. Itinatalaga ng driver ang pangalan at maaari itong magbago pagkatapos matanggal ang scanner.

Hindi pisikal na RS-232 port ang virtual na COM port. Ang RS-232 ay electrical interface, may sariling connector at antas ng boltahe, na binabasa ng computer sa pamamagitan ng UART. Gumagamit ng USB cable ang USB serial. Binubuksan pa rin ng application ang serial port at binabasa ang mga byte, ngunit USB ang signal sa wire. Ang ilang produkto ay totoong RS-232 scanner kasama ang USB-to-serial adapter. Ang iba ay nagpapatupad ng USB CDC at hindi kailanman nagsasalita ng RS-232. Ituring ang port na ipinapakita ng operating system bilang punto ng integration, at huwag ipagpalagay na tugma ang mga detalye ng kuryente.

Binubuksan ng application ang port, binabasa ang byte stream, at pinagpapasyahan kung saan nagsisimula at nagtatapos ang mensahe. Karaniwang frame ang teksto ng barcode na sinusundan ng CR (0x0D), LF (0x0A), o CR at pagkatapos ay LF. Setting ng device ang framing na iyon, hindi panuntunan ng USB. Posible rin ang prefix byte gaya ng STX. Inihihiwalay ng Unlapi laban sa hulapi sa mga barcode scanner: kumpletong gabay ang mga byte na iyon sa Enter key na ipinapadala ng wedge scanner.

Mahalaga ang baud rate, data bits, parity, at stop bits sa totoong UART at sa maraming USB-to-serial adapter. Ang maling rate ay nagbubunga ng basura, hindi ng malinis na error. Binabalewala ng ilang USB CDC virtual COM device ang baud rate na hinihiling ng host at naghahatid pa rin ng mga byte. Walang iisang setting na bagay sa bawat virtual serial scanner. Gamitin ang rate at framing sa manual ng modelong iyon, pagkatapos ay kumpirmahin sa kilalang barcode.

Tinatanggap ng prosesong humahawak sa bukas na port ang data. Hindi pinipili ng keyboard focus ang destinasyon. Haharangin ng ibang program na bukas na ang port ang pangalawang pagbukas. Inaalis ng pagtanggal sa scanner ang port. Ang pagkakabit muli ay maaaring lumikha ng bagong pangalan, at kailangang buksan muli ng application ang port na iyon.

HID laban sa serial

Tampok HID keyboard wedge USB serial
Paghahatid ng data Input na parang keyboard Serial byte stream
Kailangan ang input focus Oo. Sinusundan ng mga keystroke ang control na may focus Hindi. Napupunta ang mga byte sa prosesong nagbukas ng port
Integration sa browser Ordinaryong input at keyboard event Web Serial kung saan sinusuportahan ito ng browser, o software sa labas ng page
Kontrol ng application Limitado sa kilos ng keyboard, sa focus, at sa mga hulapi Binabasa at fini-frame ng application ang stream
Pagkilala sa device Hindi available mula sa ordinaryong keyboard event Maipapakita ng operating system ang pangalan ng port. Ang matatag na pagkakakilanlan ay nakasalalay pa rin sa driver
Configuration Mga setting ng scanner, kasama ang hulapi at keyboard layout Mga setting ng scanner kasama ang mga setting ng host port na talagang ginagamit ng device
Karaniwang gamit Mga form at pagpasok ng item sa POS Mga dedikadong integration na nagmamay-ari ng device

Ito ang karaniwang mga kaso. Maaaring magkaiba ang isang model, operating system, at driver. Ang Bluetooth scanner sa HID keyboard mode ay sumusunod sa column ng wedge sa layer ng application. Ang Bluetooth SPP ay sumusunod sa column ng serial.

Paano gumagana ang mga HID scanner sa mga web application

Ina-update ng wedge scan ang elementong may focus. Nagfi-fire ang mga napi-print na karakter ng keydown at pagkatapos ay input. Nagfi-fire ang Enter at Tab ng keydown at hindi naglalagay ng karakter sa normal na text input. Ang event.key ay "Enter" o "Tab" para sa mga key na iyon, at isang string na isang karakter para sa napi-print na karakter. Pinangalanan ng event.code ang pisikal na key at maaari itong manatiling pareho kapag binago ng hindi tugmang keyboard layout ang event.key.

Kinukumpirma ng listener sa ibaba ang field kapag dumating lang ang Enter. Iniiwan ng scanner na walang Enter suffix ang teksto sa field.

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

I-focus ang #barcode bago ang scan. Pinipigilan ng preventDefault() ang parent form na mag-submit nang pangalawang beses. Kung Tab ang ipinapadala ng scanner, basahin ang value sa keydown na iyon at hayaang ilipat ng browser ang focus. Kung wala sa dalawa ang ipinapadala, i-submit ang field mula sa button o sa ibang tahasang aksyon. Ang paghinto sa pagta-type ay heuristic lang para sa dulo ng scan.

Walang anuman sa mga event na iyon ang tumutukoy sa USB device. Ang tao, ang macro, o ang emulator ay maaaring gumawa ng parehong sequence. Nasa payload ang validation. Ang workflow sa browser, kasama ang Tab at walang lamang input, ay nasa Paano subukan ang mga barcode scanner sa mga web application.

Paano gumagana ang mga serial scanner sa mga application

Nagbubukas ng port ang serial integration, nagbabasa ng mga byte, hinahati ang mga ito sa mga mensahe, at hinahawakan ang pagkawala ng port. Sa desktop, iyon ang serial API ng operating system o library ng vendor. Sa browser, ang tanging built-in na opsyon ay ang Web Serial API, at sa mga browser lang na nagpapatupad nito.

Available ang Web Serial sa mga browser na batay sa Chromium. Hindi ito ibinibigay ng Firefox at Safari. Kailangang secure context ang page, na nangangahulugang HTTPS o localhost. Kailangang tumakbo ang requestPort() mula sa gesture ng user, at kailangang piliin ng user ang port sa prompt ng browser. Hindi lumalabas sa listahang iyon ang keyboard-wedge scanner, dahil hindi ito serial device. Hindi rin nakikita ng Web Serial ang serial port na hindi inilantad ng operating system.

Panimulang punto ang baud rate sa halimbawa, na papalitan mo ng halaga sa manual. Itinuturing ng loop ang CR o LF bilang dulo ng mensahe at kinokonsumo ang pares na CRLF bilang isang terminator. Kung ibang frame ang ginagamit ng scanner, mali ang split na ito kahit bukas ang port.

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

Tumatakbo ang read loop hanggang matapos ang stream o mabigo ang pagbasa. Karaniwang tinatanggihan ng pagtanggal sa scanner ang pagbasa. Tumatakbo ang releaseLock() at close() sa finally. Maililista ang mga port na naaprubahan na para sa origin na ito gamit ang navigator.serial.getPorts() nang hindi ipinapakita muli ang prompt. Kailangan pa rin ng user ang unang pag-apruba.

Sinusunod ng desktop application ang parehong ideya sa serial API ng platform: buksan, basahin, i-frame, at buksan muli pagkatapos bumalik ang device. Hindi gumagawa ang pahinang ito ng mga utos ng vendor. Kung umaasa ang scanner ng proprietary protocol, nasa dokumentasyon ng manufacturer ang protocol na iyon.

Alin ang mas mabuti: HID o serial?

Walang mode na mas mabuti para sa bawat produkto. Gamitin ang mode na talagang inaalok ng scanner at ang mode na nababasa ng application.

Piliin ang HID kapag

  • Tumatanggap na ang application ng keyboard input sa field na may focus.
  • Gusto mong gumana ang form o screen ng POS nang walang device code.
  • Magagarantiyahan ng workflow ang focus bago ang bawat scan.
  • Tumutugma ang Enter o Tab sa paraan ng pagkumpirma o pagsulong ng form na iyon.

Isaalang-alang ang serial kapag

  • Kailangang dumating ang mga scan habang nasa dialog, nasa button, o wala saanman ang focus.
  • Kailangang manatiling hiwalay ang mga byte ng scanner sa pagta-type.
  • Kaya ng application na buksan ang port, i-frame ang mga mensahe, at makabawi kapag natanggal ang device.
  • Makapagbibigay ang host ng pahintulot sa port na iyon at walang ibang proseso ang nangangailangan nito nang sabay.

Ang scanner na nag-e-enumerate lang bilang keyboard ay hindi maililipat sa serial sa software ng host. Kumpirmahin ang mga mode sa manual bago idisenyo ang integration.

Pagpapalit sa pagitan ng HID at serial

Nagbabago ang mode ng ilang scanner kapag nag-scan ka ng configuration barcode mula sa manual ng manufacturer na iyon, o kapag sumulat ka ng profile gamit ang utility ng vendor. Ang iba ay ginawa bilang iisang interface at walang maililipat.

Walang configuration barcode na nagbabago sa bawat brand. Ang sequence na inilimbag para sa ibang model ay maaaring walang gawin, o maaaring iwan ang scanner sa hindi inaasahang mode. Pagkatapos ng anumang pagbabago, tingnan kung ano ang ipinapakita ng operating system: keyboard, COM port, o pareho. Pagkatapos ay subukan ang landas na ginagamit ng application. Inilalarawan ng Gabay sa configuration ng barcode scanner ang karaniwang mga grupo ng setting. Hindi nito pinapalitan ang manual.

Pagsubok sa HID scanner

  1. Ikonekta ang scanner at kumpirmahing nasa keyboard-wedge mode ito. Dapat tumanggap ng mga karakter ang text editor kapag may focus ang field sa editor na iyon.
  2. Buksan ang Tester ng barcode input.
  3. I-click ang Start Test, o i-click ang scan area. Nagiging asul ito kapag handa na. Hindi kumukuha ng focus ang page nang mag-isa.
  4. Mag-scan ng barcode na alam mo na ang payload.
  5. Ikumpara ang nahuling value at ang bilang ng karakter sa payload na iyon.
  6. Basahin ang hulapi: ENTER, TAB, o None. Hindi bahagi ng barcode string ang Enter at Tab.

Itinatala ng tester ang mga keyboard event na nakikita ng browser. Hindi nito mabasa ang serial port, at hindi nito matukoy ang USB device. Kapag ang average na agwat sa pagitan ng mga karakter ay wala pang 100 ms, iniulat nito ang timing na iyon. Hindi pagkilala sa hardware ang timing. Para sa bawat keydown, kasama ang key at code, gamitin ang Tester ng keyboard event. Nasa Paano subukan ang input ng barcode scanner ang mas malawak na QA pass.

Pagsubok sa serial scanner

Hindi nagbubukas ng COM port ang Tester ng barcode input. Kailangan ng serial test ang program na makakabukas ng port na inilalantad ng scanner.

  1. Kumpirmahing nasa serial mode ang scanner at naglilista ang operating system ng port kapag nakakonekta ito. Tanggalin ito at tingnan kung nawawala ang port.
  2. Itala ang pangalan ng port. Partikular ito sa operating system at maaaring magbago sa susunod na pagkakabit.
  3. Buksan ang port mula sa compatible na application: serial terminal, desktop app mo, o ang halimbawa ng Web Serial sa itaas sa Chromium browser sa HTTPS o localhost.
  4. Itakda ang baud rate, data bits, parity, at stop bits kapag tinukoy ng manual. Laktawan ang mga inimbentong value.
  5. Mag-scan ng kilalang barcode.
  6. Ikumpara ang mga byte o ang na-decode na teksto sa payload na iyon.
  7. Suriin ang framing. Hanapin ang prefix, at ang CR, LF, o CRLF pagkatapos ng data, kung iyon lang ang kinonfigura ng manual.

Kung nabigo ang pagbukas ng port dahil abala ito, isara ang ibang program na humahawak dito. Kung basura ang teksto, hindi tumutugma sa device ang mga setting ng linya. Kung hindi kailanman lumilitaw ang port, maaaring nasa keyboard mode pa ang scanner, maaaring kulang ang driver, o maaaring hindi pinapayagan ang user ng OS na magbukas ng mga serial device.

Mga karaniwang problema

Gumagana ang scanner sa text editor at hindi sa target na application. Nagta-type ang device. Walang focus ang target, o nagtatapon ng mga key ang isang keydown listener. Magsimula sa Gumagana ang scanner sa Notepad pero hindi sa POS.

Hindi nagta-type ang scanner sa anumang text field. Maaaring nasa serial mode ito, nakapatay, o hindi nababasa ang simbolo. Hindi magta-type ang scanner na nasa serial mode. Tingnan ang COM port bago i-debug ang field. Inihihiwalay ng Hindi gumagana ang barcode scanner ang patay na scanner sa maling interface.

Nawawala ang serial port. Hindi lumilikha ng COM port ang keyboard mode. Ang kulang na driver, ang charge-only na cable, o ang scanner na walang serial mode ay nagbubunga ng parehong sintomas. Panoorin ang listahan ng device ng OS habang ikinakabit mo ang scanner.

Ginagamit na ang serial port. Isang proseso lang ang makakabasa nito. Isara ang terminal o ang ibang kopya ng application, pagkatapos ay buksan itong muli.

Mali ang mga setting ng komunikasyon. Ang hindi tugmang baud, parity, o stop bits ay mukhang random na karakter. Itakda ang mga value mula sa manual ng modelong iyon, pagkatapos ay mag-scan muli ng kilalang code.

Hindi kailanman dumarating ang ENTER o TAB. Setting iyon ng wedge suffix. Nag-uulat ng None ang input tester. Tingnan ang Nawawalang ENTER ng barcode scanner at ang gabay sa hulapi na naka-link sa itaas. Hindi nagpapadala ng Enter key ang serial scanner. Maaari itong magpadala ng mga byte na CR o LF sa halip.

Mali ang mga karakter sa wedge scanner. Maaaring hindi magkasundo ang keyboard layout ng scanner at ang layout ng operating system. Hindi nire-remap ng layout na iyon ang mga serial byte. Tingnan ang Maling keyboard layout ng barcode scanner.

Hindi ma-access ng browser ang scanner. Hindi lilitaw ang wedge scanner sa prompt ng Web Serial. Walang Web Serial API ang Firefox at Safari. Hindi magagamit ito ng page na hindi HTTPS o localhost. Maaari ring isara ng user ang prompt ng port.

Nawawala sa application ang scanner pagkatapos itong tanggalin. Bumabalik ang wedge scanner bilang keyboard, at kailangan pa rin ng focus ang susunod na scan. Wala ang serial port hanggang buksan ng application ang bagong port. Maaaring hindi tumugma ang pangalan sa nauna.

Mga senaryo ng integration

Mga web application

Bagay ang keyboard wedge sa input na may focus at sa ordinaryong DOM event. Ang serial access sa loob ng page ay nangangahulugang Web Serial sa browser na sumusuporta, isang secure context, at port na pinili ng user. Ang page na kailangang sumuporta sa Firefox, Safari, at sa mga kiosk na walang bantay ay hindi maaaring umasa sa Web Serial nang mag-isa. Maaaring magmay-ari ang lokal na helper ng COM port at ipasa ang kumpletong mga barcode sa page. Hiwalay na software ang helper na iyon. Hindi pa rin dapat asahan ng page na susubukan ito ng wedge test.

Mga sistema ng POS

Ang POS na naglalagay ng focus sa item field at kumukumpirma sa Enter ay wedge integration. Ang POS na kailangang mag-scan habang bukas ang modal, o kailangang balewalain ang keyboard, ay serial integration. Ang paghahalo sa mga ito ay nagbubunga ng mga scan sa maling field o ng mga scan na hindi kailanman dumarating. Itugma ang mode ng scanner sa screen na talagang naka-duty.

Mga desktop application

Maaaring tumanggap ang desktop app ng wedge input sa control na may focus, o buksan ang virtual na COM port at panatilihin ang session habang buhay ang proseso. Bahagi ng session na iyon ang pagmamay-ari ng port, ang muling pagkonekta, at ang framing. Hindi ang focus.

QA automation

Nagta-type ang Barcode Scanner Emulator ng value na pipiliin mo sa application na may focus at maaaring magpadala ng ENTER, TAB, o walang hulapi. Sinasaklaw nito ang mga regression ng keyboard wedge: focus, validation, at paghawak ng hulapi. Hindi ito lumilikha ng virtual na COM port, hindi nag-e-enumerate ng mga USB device, at hindi nire-reproduce ang baud at framing. Kailangan pa rin ng mga serial test ang serial port at reader, o test double na nagsusulat ng parehong byte framing na pina-parse ng application.

Mga kiosk application

Kailangang panatilihin ng kiosk na gumagamit ng wedge input ang focus ng scan field sa mga dialog, screen saver, at mensahe ng error. Isang nawalang focus, at tatama ang susunod na scan sa shortcut o sa wala. Nababasa ng kiosk na gumagamit ng serial ang port nang wala ang focus na iyon, at kailangan nitong hawakan ang pahintulot sa device at buksan muli ang port pagkatapos ng pagkawala ng kuryente o paghila ng cable.

Saan nababagay ang Barcode Scanner Emulator

Ang Barcode Scanner Emulator ay desktop app para sa Windows, macOS, at Linux. Nire-reproduce nito ang keyboard path na ginagamit ng wedge scanner. Ilalagay mo ang teksto, pipili ng typing delay, at pipili ng hulaping none, ENTER, o TAB. Nagta-type ang global shortcut ng tekstong iyon sa application na may focus.

Gamitin ito upang bumuo at mag-regress ng mga form na istilo ng HID kapag wala sa mesa ang scanner. Ipares ito sa Tester ng barcode input upang makita ang value, mga prefix key, at hulapi na natanggap ng browser.

Hindi nito ine-emulate ang USB serial device, ang virtual na COM port, ang USB enumeration, o ang optical decode. Ang mga kilos na iyon ay kabilang pa rin sa hardware, o sa serial test double na kontrolado mo.