Langkau ke kandungan

Barcode Scanner Emulator

Pengimbas Kod Bar USB HID dan Bersiri

Pengimbas baji papan kekunci USB HID menaip kod bar yang telah disahkod ke dalam aplikasi yang sedang berfokus. Pengimbas bersiri USB mendedahkan antara muka bersiri, lazimnya sebagai port COM maya, dan aplikasi perlu membuka port itu serta membaca bait. USB ialah kabel dan bas. HID dan bersiri ialah dua cara berbeza untuk mempersembahkan data.

Pilih antara muka yang benar-benar boleh dibaca oleh aplikasi. Medan kaunter yang sudah menerima penaipan ialah soal baji papan kekunci. Perkhidmatan yang mesti menerima imbasan walaupun tiada medan teks berfokus, atau yang mesti memisahkan bait pengimbas daripada papan kekunci, ialah soal bersiri. Ramai pengimbas hanya menawarkan satu daripada mod itu. Sesetengahnya boleh bertukar. Manual model itu ialah senarai mod yang boleh diuji.

Panduan Baji Papan Kekunci HID menerangkan laluan ketukan kekunci dengan terperinci. Bagaimanakah Pengimbas Kod Bar Berfungsi? merangkumi tangkapan dan penyahkodan. Halaman ini membandingkan dua antara muka hos dan ujian yang tergolong pada setiap satu.

Apakah mod baji papan kekunci USB HID?

Dalam mod papan kekunci USB HID, pengimbas disenaraikan sebagai papan kekunci. Sistem pengendalian memuatkan pemacu papan kekunci biasa. Selepas penyahkodan, pengimbas menghantar aksara sebagai ketukan kekunci kepada kawalan yang memegang fokus papan kekunci. Borang web, medan item POS, atau kotak teks desktop boleh menerima input itu tanpa kod khusus pengimbas.

Fokus yang menentukan destinasi. Jika medan yang dimaksudkan tidak berfokus, aksara masuk ke kawalan lain atau hilang. Pengimbas tidak mengklik, dan tidak menggerakkan penuding.

Akhiran yang telah dikonfigurasi boleh menyusul muatan. Enter menghantar banyak borang satu medan. Tab memindahkan fokus ke kawalan seterusnya. Tiada kekunci yang dijamin. Pilihan akhiran dibincangkan dalam Akhiran ENTER dan TAB pada Pengimbas Kod Bar.

Peristiwa papan kekunci biasa tidak mengandungi vendor pengimbas, nombor siri, atau bendera yang menyatakan kekunci datang daripada pengimbas. Pelayar yang melaksanakan WebHID tetap menolak antara muka papan kekunci, jadi halaman tidak boleh membuka peranti baji dan membaca laporan HID mentah.

Apakah mod pengimbas kod bar bersiri USB?

Dalam mod bersiri USB, pengimbas tidak menaip. Ia mendedahkan antara muka bersiri melalui USB. Sistem pengendalian biasanya mempersembahkan antara muka itu sebagai port COM maya: nama COM pada Windows, peranti cu atau tty pada macOS, atau peranti ttyACM atau ttyUSB pada Linux. Nama diberikan oleh pemacu dan boleh berubah selepas pengimbas dicabut.

Port COM maya bukan port RS-232 fizikal. RS-232 ialah antara muka elektrik, dengan penyambung dan aras voltan sendiri, yang dibaca komputer melalui UART. Bersiri USB menggunakan kabel USB. Aplikasi tetap membuka port bersiri dan membaca bait, tetapi isyarat pada wayar ialah USB. Sesetengah produk ialah pengimbas RS-232 sebenar ditambah penyesuai USB-ke-bersiri. Yang lain melaksanakan USB CDC dan langsung tidak bercakap RS-232. Anggap port yang ditunjukkan oleh sistem pengendalian sebagai titik integrasi, dan jangan anggap butiran elektriknya sepadan.

Aplikasi membuka port, membaca aliran bait, dan memutuskan di mana mesej bermula serta berakhir. Bingkai yang lazim ialah teks kod bar diikuti CR (0x0D), LF (0x0A), atau CR kemudian LF. Pembingkaian itu ialah tetapan peranti, bukan peraturan USB. Bait awalan seperti STX juga mungkin. Awalan dan Akhiran pada Pengimbas Kod Bar: Panduan Lengkap memisahkan bait itu daripada kekunci Enter yang dihantar oleh pengimbas baji.

Kadar baud, bit data, parity, dan bit henti penting pada UART sebenar dan pada banyak penyesuai USB-ke-bersiri. Kadar yang salah menghasilkan sampah, bukan ralat yang bersih. Sesetengah peranti COM maya USB CDC mengabaikan kadar baud yang diminta hos dan tetap menghantar bait. Tiada satu tetapan yang sesuai untuk setiap pengimbas bersiri maya. Gunakan kadar dan bingkai dalam manual model itu, kemudian sahkan dengan kod bar yang diketahui.

Proses yang memegang port terbuka menerima data. Fokus papan kekunci tidak memilih destinasi. Program lain yang sudah membuka port akan menyekat pembukaan kedua. Mencabut pengimbas menghilangkan port. Memasangnya semula boleh mencipta nama baharu, dan aplikasi perlu membuka port itu sekali lagi.

HID dan bersiri

Ciri baji papan kekunci HID bersiri USB
Penghantaran data Input gaya papan kekunci Aliran bait bersiri
Fokus input diperlukan Ya. Ketukan mengikut kawalan yang berfokus Tidak. Bait pergi kepada proses yang membuka port
Integrasi pelayar Input dan peristiwa papan kekunci biasa Web Serial apabila pelayar menyokongnya, atau perisian di luar halaman
Kawalan aplikasi Terhad kepada kelakuan papan kekunci, fokus, dan akhiran Aplikasi membaca dan membingkai aliran
Pengenalpastian peranti Tidak tersedia daripada peristiwa papan kekunci biasa Sistem pengendalian boleh menunjukkan nama port. Identiti yang stabil masih bergantung pada pemacu
Konfigurasi Tetapan pengimbas, termasuk akhiran dan susun atur papan kekunci Tetapan pengimbas serta tetapan port hos yang benar-benar digunakan peranti
Penggunaan tipikal Borang dan entri item POS Integrasi khusus yang memiliki peranti

Itulah kes yang biasa. Model, sistem pengendalian, dan pemacu tertentu boleh berbeza. Pengimbas Bluetooth dalam mod papan kekunci HID mengikut lajur baji pada lapisan aplikasi. Bluetooth SPP mengikut lajur bersiri.

Bagaimanakah pengimbas HID berfungsi dalam aplikasi web

Imbasan baji mengemas kini elemen yang berfokus. Aksara yang boleh dicetak mencetuskan keydown kemudian input. Enter dan Tab mencetuskan keydown dan tidak memasukkan aksara ke input teks biasa. Bagi kekunci itu, event.key ialah "Enter" atau "Tab", dan bagi aksara yang boleh dicetak ia ialah rentetan satu aksara. event.code menamakan kekunci fizikal dan boleh kekal sama apabila ketidakpadanan susun atur mengubah event.key.

Pendengar di bawah hanya mengunci medan apabila Enter tiba. Pengimbas tanpa akhiran Enter meninggalkan teks dalam medan.

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

Fokuskan #barcode sebelum imbasan. preventDefault() menghalang borang induk daripada dihantar kali kedua. Jika pengimbas menghantar Tab, baca nilai pada keydown itu dan biarkan pelayar mengalihkan fokus. Jika kedua-duanya tidak dihantar, hantar medan daripada butang atau tindakan nyata yang lain. Jeda semasa menaip hanyalah heuristik bagi penghujung imbasan.

Tiada apa-apa dalam peristiwa itu yang mengenal pasti peranti USB. Orang, makro, atau emulator boleh menghasilkan urutan yang sama. Pengesahan terletak pada muatan. Aliran kerja pelayar, termasuk Tab dan input kosong, ada dalam Cara Menguji Pengimbas Kod Bar dalam Aplikasi Web.

Bagaimanakah pengimbas bersiri berfungsi dalam aplikasi

Integrasi bersiri membuka port, membaca bait, memecahkannya kepada mesej, dan mengendalikan port yang hilang. Pada desktop, itu ialah API bersiri sistem pengendalian atau pustaka vendor. Dalam pelayar, satu-satunya pilihan terbina dalam ialah Web Serial API, dan hanya pada pelayar yang melaksanakannya.

Web Serial tersedia pada pelayar berasaskan Chromium. Firefox dan Safari tidak menyediakannya. Halaman mesti berada dalam konteks selamat, yang bermaksud HTTPS atau localhost. requestPort() mesti berjalan daripada gerak isyarat pengguna, dan pengguna mesti memilih port dalam gesaan pelayar. Pengimbas baji papan kekunci tidak muncul dalam senarai itu, kerana ia bukan peranti bersiri. Web Serial juga tidak melihat port bersiri yang belum didedahkan oleh sistem pengendalian.

Kadar baud dalam contoh ialah titik permulaan yang anda ganti dengan nilai dalam manual. Gelung menganggap CR atau LF sebagai hujung mesej dan memakan pasangan CRLF sebagai satu penamat. Jika pengimbas menggunakan bingkai lain, pemecahan ini salah walaupun port sudah terbuka.

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

Gelung baca berjalan sehingga aliran tamat atau pembacaan gagal. Mencabut pengimbas biasanya menolak pembacaan. releaseLock() dan close() berjalan dalam finally. Port yang sebelum ini diluluskan untuk origin ini boleh disenaraikan dengan navigator.serial.getPorts() tanpa menunjukkan gesaan lagi. Kelulusan pertama tetap memerlukan pengguna.

Aplikasi desktop mengikut gagasan yang sama dengan API bersiri platform: buka, baca, bingkai, dan buka semula selepas peranti kembali. Halaman ini tidak mereka-reka perintah vendor. Jika pengimbas mengharapkan protokol proprietari, protokol itu ada dalam dokumentasi pengeluar.

Yang manakah lebih baik: HID atau bersiri?

Tiada mod yang lebih baik untuk setiap produk. Gunakan mod yang benar-benar ditawarkan pengimbas dan mod yang boleh dibaca aplikasi.

Pilih HID apabila

  • Aplikasi sudah menerima input papan kekunci dalam medan yang berfokus.
  • Anda mahu borang atau skrin POS berfungsi tanpa kod peranti.
  • Aliran kerja boleh menjamin fokus sebelum setiap imbasan.
  • Enter atau Tab sepadan dengan cara borang itu mengunci atau maju.

Pertimbangkan bersiri apabila

  • Imbasan mesti tiba semasa fokus berada dalam dialog, pada butang, atau tidak di mana-mana.
  • Bait pengimbas mesti kekal terpisah daripada penaipan.
  • Aplikasi boleh membuka port, membingkai mesej, dan pulih apabila peranti dicabut.
  • Hos boleh memberi kebenaran kepada port itu dan tiada proses lain yang memerlukannya pada masa yang sama.

Pengimbas yang hanya disenaraikan sebagai papan kekunci tidak boleh ditukar kepada bersiri melalui perisian pada hos. Sahkan mod dalam manual sebelum anda mereka bentuk integrasi.

Bertukar antara HID dan bersiri

Sesetengah pengimbas menukar mod apabila anda mengimbas kod bar konfigurasi daripada manual pengeluar itu, atau apabila anda menulis profil dengan utiliti vendor. Yang lain dibina sebagai satu antara muka dan tiada apa untuk ditukar.

Tiada kod bar konfigurasi yang mengubah setiap jenama. Urutan yang dicetak untuk model lain mungkin tidak melakukan apa-apa, atau meninggalkan pengimbas dalam mod yang tidak dijangka. Selepas sebarang perubahan, semak apa yang ditunjukkan oleh sistem pengendalian: papan kekunci, port COM, atau kedua-duanya. Kemudian uji laluan yang digunakan aplikasi. Panduan Konfigurasi Pengimbas Kod Bar menerangkan kumpulan tetapan yang biasa. Ia tidak menggantikan manual.

Menguji pengimbas HID

  1. Sambungkan pengimbas dan sahkan ia berada dalam mod baji papan kekunci. Editor teks sepatutnya menerima aksara apabila medan dalam editor itu berfokus.
  2. Buka Penguji Input Kod Bar.
  3. Klik Start Test, atau klik kawasan imbasan. Kawasan itu menjadi biru apabila sedia. Halaman tidak mengambil fokus sendiri.
  4. Imbas kod bar yang muatannya sudah anda ketahui.
  5. Bandingkan nilai yang ditangkap dan bilangan aksara dengan muatan itu.
  6. Baca akhiran: ENTER, TAB, atau None. Enter dan Tab bukan sebahagian daripada rentetan kod bar.

Penguji merekod peristiwa papan kekunci yang boleh dilihat oleh pelayar. Ia tidak boleh membaca port bersiri, dan tidak boleh mengenal pasti peranti USB. Apabila jurang purata antara aksara di bawah 100 ms, ia melaporkan masa itu. Masa itu bukan pengenalpastian perkakasan. Bagi setiap keydown, termasuk key dan code, gunakan Penguji Peristiwa Papan Kekunci. Semakan QA yang lebih luas ada dalam Cara Menguji Input Pengimbas Kod Bar.

Menguji pengimbas bersiri

Penguji Input Kod Bar tidak membuka port COM. Ujian bersiri memerlukan program yang boleh membuka port yang didedahkan oleh pengimbas.

  1. Sahkan pengimbas berada dalam mod bersiri dan sistem pengendalian menyenaraikan port apabila pengimbas disambungkan. Cabut, kemudian semak bahawa port hilang.
  2. Catat nama port. Nama itu khusus sistem pengendalian dan boleh berubah pada pemasangan seterusnya.
  3. Buka port daripada aplikasi yang serasi: terminal bersiri, aplikasi desktop anda, atau contoh Web Serial di atas pada pelayar Chromium di HTTPS atau localhost.
  4. Tetapkan kadar baud, bit data, parity, dan bit henti apabila manual menentukannya. Langkau nilai yang direka.
  5. Imbas kod bar yang diketahui.
  6. Bandingkan bait atau teks yang disahkod dengan muatan itu.
  7. Semak bingkai. Cari awalan, dan CR, LF, atau CRLF selepas data, hanya jika manual mengkonfigurasikan perkara itu.

Jika pembukaan port gagal kerana ia sibuk, tutup program lain yang memegangnya. Jika teks berupa sampah, tetapan talian tidak sepadan dengan peranti. Jika port tidak pernah muncul, pengimbas mungkin masih dalam mod papan kekunci, pemacu mungkin tiada, atau pengguna OS mungkin tidak dibenarkan membuka peranti bersiri.

Masalah biasa

Pengimbas berfungsi dalam editor teks tetapi tidak dalam aplikasi sasaran. Peranti sedang menaip. Sasaran tidak mempunyai fokus, atau pendengar keydown membuang kekunci. Mulakan dengan Pengimbas Berfungsi dalam Notepad tetapi Tidak dalam POS.

Pengimbas tidak menaip ke mana-mana medan teks. Ia mungkin dalam mod bersiri, dimatikan, atau tidak membaca simbol. Pengimbas mod bersiri tidak akan menaip. Semak port COM sebelum anda menyahpepijat medan. Pengimbas Kod Bar Tidak Berfungsi memisahkan pengimbas yang mati daripada antara muka yang salah.

Port bersiri tiada. Mod papan kekunci tidak mencipta port COM. Pemacu yang tiada, kabel cas sahaja, atau pengimbas yang tiada mod bersiri menghasilkan gejala yang sama. Perhatikan senarai peranti OS semasa anda memasang pengimbas.

Port bersiri sudah digunakan. Hanya satu proses boleh membacanya. Tutup terminal atau salinan lain aplikasi, kemudian buka semula.

Tetapan komunikasi salah. Baud, parity, atau bit henti yang tidak sepadan kelihatan seperti aksara rawak. Tetapkan nilai daripada manual model itu, kemudian imbas kod yang diketahui sekali lagi.

ENTER atau TAB tidak pernah tiba. Itu tetapan akhiran baji. Penguji input melaporkan None. Lihat Pengimbas Kod Bar Tiada ENTER dan panduan akhiran yang dipautkan di atas. Pengimbas bersiri tidak menghantar kekunci Enter. Ia mungkin menghantar bait CR atau LF sebagai ganti.

Aksara salah pada pengimbas baji. Susun atur papan kekunci pengimbas dan susun atur sistem pengendalian boleh tidak sehaluan. Bait bersiri tidak dipetakan semula oleh susun atur itu. Lihat Susun Atur Papan Kekunci Pengimbas Kod Bar Salah.

Pelayar tidak dapat mengakses pengimbas. Pengimbas baji tidak akan muncul dalam gesaan Web Serial. Firefox dan Safari tiada Web Serial API. Halaman yang bukan HTTPS atau localhost tidak boleh menggunakannya. Pengguna juga boleh menutup gesaan port.

Aplikasi kehilangan pengimbas selepas ia dicabut. Pengimbas baji kembali sebagai papan kekunci, dan imbasan seterusnya tetap memerlukan fokus. Port bersiri hilang sehingga aplikasi membuka port baharu. Namanya mungkin tidak sepadan dengan yang sebelumnya.

Senario integrasi

Aplikasi web

Baji papan kekunci sesuai untuk input yang berfokus dan peristiwa DOM biasa. Akses bersiri di dalam halaman bermaksud Web Serial pada pelayar yang menyokong, konteks selamat, dan port yang dipilih pengguna. Halaman yang mesti menyokong Firefox, Safari, dan kiosk tanpa penjaga tidak boleh bergantung pada Web Serial sahaja. Pembantu tempatan boleh memiliki port COM dan memajukan kod bar yang lengkap ke halaman. Pembantu itu ialah perisian berasingan. Halaman tetap tidak patut mengharapkan ujian baji untuk melatihnya.

Sistem POS

POS yang meletakkan fokus pada medan item dan mengunci pada Enter ialah integrasi baji. POS yang mesti mengimbas semasa modal terbuka, atau yang mesti mengabaikan papan kekunci, ialah integrasi bersiri. Mencampurkannya menghasilkan imbasan dalam medan yang salah atau imbasan yang tidak pernah tiba. Padankan mod pengimbas dengan skrin yang benar-benar bertugas.

Aplikasi desktop

Aplikasi desktop boleh menerima input baji pada kawalan yang berfokus, atau membuka port COM maya dan mengekalkan sesi sepanjang hayat proses. Pemilikan port, penyambungan semula, dan pembingkaian ialah sebahagian daripada sesi itu. Fokus bukan.

Automasi QA

Barcode Scanner Emulator menaip nilai yang anda pilih ke dalam aplikasi yang berfokus dan boleh menghantar ENTER, TAB, atau tiada akhiran. Itu merangkumi regresi baji papan kekunci: fokus, pengesahan, dan pengendalian akhiran. Ia tidak mencipta port COM maya, tidak menyenaraikan peranti USB, dan tidak menghasilkan semula baud serta bingkai. Ujian bersiri masih memerlukan port bersiri dan pembaca, atau pendua ujian yang menulis bingkai bait yang sama dengan yang dihuraikan oleh aplikasi.

Aplikasi kiosk

Kiosk yang menggunakan input baji mesti mengekalkan fokus medan imbasan merentas dialog, screen saver, dan mesej ralat. Satu fokus yang hilang, imbasan seterusnya terkena pintasan atau tidak terkena apa-apa. Kiosk yang menggunakan bersiri boleh membaca port tanpa fokus itu, dan mesti memegang kebenaran kepada peranti serta membuka semula port selepas bekalan terputus atau kabel tercabut.

Di mana Barcode Scanner Emulator sesuai

Barcode Scanner Emulator ialah aplikasi desktop untuk Windows, macOS, dan Linux. Ia menghasilkan semula laluan papan kekunci yang digunakan oleh pengimbas baji. Anda memasukkan teks, memilih lengah penaipan, dan memilih akhiran tiada, ENTER, atau TAB. Pintasan global menaip teks itu ke dalam aplikasi yang berfokus.

Gunakannya untuk membangunkan dan meregresi borang gaya HID apabila pengimbas tiada di atas meja. Pasangkannya dengan Penguji Input Kod Bar untuk melihat nilai, kekunci awalan, dan akhiran yang diterima pelayar.

Ia tidak meniru peranti bersiri USB, port COM maya, penghitungan USB, atau penyahkodan optik. Kelakuan itu masih milik perkakasan, atau milik pendua ujian bersiri yang anda kawal.