Barcode Scanner Emulator
Pemindai kode batang USB HID dan serial
Pemindai keyboard wedge USB HID mengetikkan kode batang yang sudah didekode ke aplikasi yang sedang berfokus. Pemindai serial USB menampilkan antarmuka serial, sering sebagai port COM virtual, dan aplikasi harus membuka port itu lalu membaca byte. USB adalah kabel dan bus. HID dan serial adalah dua cara berbeda untuk menyajikan data.
Pilih antarmuka yang benar-benar bisa dibaca aplikasi. Bidang kasir yang sudah menerima ketikan adalah soal keyboard wedge. Layanan yang harus menerima pindaian saat tidak ada bidang teks yang berfokus, atau yang harus memisahkan byte pemindai dari papan ketik, adalah soal serial. Banyak pemindai hanya menawarkan salah satu mode itu. Sebagian bisa berganti. Buku panduan model itu adalah daftar mode yang bisa Anda uji.
Panduan HID keyboard wedge menjelaskan jalur ketukan tombol secara rinci. Bagaimana cara kerja pemindai kode batang? membahas penangkapan dan dekode. Halaman ini membandingkan dua antarmuka host dan pengujian yang menjadi milik masing-masing.
Apa itu mode keyboard wedge USB HID?
Dalam mode papan ketik USB HID, pemindai terdaftar sebagai papan ketik. Sistem operasi memuat pengandar papan ketik biasa. Setelah dekode, pemindai mengirim karakter sebagai ketukan tombol ke kontrol yang memegang fokus papan ketik. Formulir web, bidang barang POS, atau kotak teks desktop bisa menerima masukan itu tanpa kode khusus pemindai.
Fokus yang menentukan tujuan. Jika bidang yang dimaksud tidak berfokus, karakter masuk ke kontrol lain atau hilang. Pemindai tidak mengeklik, dan tidak menggerakkan penunjuk.
Akhiran yang sudah dikonfigurasi bisa menyusul muatan. Enter mengirim banyak formulir satu bidang. Tab memindahkan fokus ke kontrol berikutnya. Tidak ada tombol yang dijamin. Pilihan akhiran dibahas di Akhiran ENTER vs TAB pada pemindai kode batang.
Peristiwa papan ketik biasa tidak memuat vendor pemindai, nomor seri, atau bendera yang menyatakan bahwa tombol berasal dari pemindai. Peramban yang menerapkan WebHID tetap menolak antarmuka papan ketik, jadi halaman tidak bisa membuka perangkat wedge dan membaca laporan HID mentah.
Apa itu mode pemindai kode batang serial USB?
Dalam mode serial USB, pemindai tidak mengetik. Ia menampilkan antarmuka serial lewat USB. Sistem operasi biasanya menyajikan antarmuka itu sebagai port COM virtual: nama COM di Windows, perangkat cu atau tty di macOS, atau perangkat ttyACM atau ttyUSB di Linux. Nama diberikan oleh pengandar dan bisa berubah setelah pemindai dicabut.
Port COM virtual bukan port RS-232 fisik. RS-232 adalah antarmuka listrik, dengan konektor dan level tegangan sendiri, yang dibaca komputer melalui UART. Serial USB memakai kabel USB. Aplikasi tetap membuka port serial dan membaca byte, tetapi sinyal di kabel adalah USB. Sebagian produk adalah pemindai RS-232 sungguhan ditambah adaptor USB-ke-serial. Yang lain menerapkan USB CDC dan tidak berbicara RS-232 sama sekali. Perlakukan port yang ditunjukkan sistem operasi sebagai titik integrasi, dan jangan menganggap rincian listriknya sama.
Aplikasi membuka port, membaca aliran byte, dan memutuskan di mana pesan mulai serta berakhir. Bingkai yang umum adalah teks kode batang diikuti CR (0x0D), LF (0x0A), atau CR lalu LF. Pembingkaian itu adalah pengaturan perangkat, bukan aturan USB. Byte awalan seperti STX juga mungkin. Awalan dan akhiran pada pemindai kode batang: panduan lengkap memisahkan byte itu dari tombol Enter yang dikirim pemindai wedge.
Laju baud, bit data, parity, dan bit stop penting pada UART sungguhan dan pada banyak adaptor USB-ke-serial. Laju yang salah menghasilkan sampah, bukan galat yang bersih. Sebagian perangkat COM virtual USB CDC mengabaikan laju baud yang diminta host dan tetap mengirim byte. Tidak ada satu pengaturan yang cocok untuk setiap pemindai serial virtual. Pakai laju dan bingkai di buku panduan model itu, lalu pastikan dengan kode batang yang sudah diketahui.
Proses yang menahan port tetap terbuka menerima data. Fokus papan ketik tidak memilih tujuan. Program lain yang sudah membuka port akan menghalangi pembukaan kedua. Mencabut pemindai menghilangkan port. Menyambungkannya kembali bisa membuat nama baru, dan aplikasi harus membuka port itu lagi.
HID dan serial
| Fitur | keyboard wedge HID | serial USB |
|---|---|---|
| Pengiriman data | Masukan bergaya papan ketik | Aliran byte serial |
| Fokus masukan diperlukan | Ya. Ketukan mengikuti kontrol yang berfokus | Tidak. Byte pergi ke proses yang membuka port |
| Integrasi peramban | Masukan dan peristiwa papan ketik biasa | Web Serial bila peramban mendukungnya, atau perangkat lunak di luar halaman |
| Kendali aplikasi | Terbatas pada perilaku papan ketik, fokus, dan akhiran | Aplikasi membaca dan membingkai aliran |
| Identifikasi perangkat | Tidak tersedia dari peristiwa papan ketik biasa | Sistem operasi bisa menampilkan nama port. Identitas yang stabil tetap bergantung pada pengandar |
| Konfigurasi | Pengaturan pemindai, termasuk akhiran dan tata letak papan ketik | Pengaturan pemindai plus pengaturan port host yang benar-benar dipakai perangkat |
| Pemakaian umum | Formulir dan entri barang POS | Integrasi khusus yang memiliki perangkat |
Itu kasus yang biasa. Model, sistem operasi, dan pengandar tertentu bisa berbeda. Pemindai Bluetooth dalam mode papan ketik HID mengikuti kolom wedge di lapisan aplikasi. Bluetooth SPP mengikuti kolom serial.
Bagaimana pemindai HID bekerja di aplikasi web
Pindaian wedge memperbarui elemen yang berfokus. Karakter yang bisa dicetak memicu keydown lalu input. Enter dan Tab memicu keydown dan tidak menyisipkan karakter ke masukan teks biasa. Untuk tombol itu, event.key adalah "Enter" atau "Tab", dan untuk karakter yang bisa dicetak berupa string satu karakter. event.code menamai tombol fisik dan bisa tetap sama ketika ketidakcocokan tata letak mengubah event.key.
Pendengar di bawah hanya mengunci bidang saat Enter tiba. Pemindai tanpa akhiran Enter meninggalkan teks di bidang.
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 pindaian. preventDefault() menjaga formulir induk agar tidak terkirim untuk kedua kalinya. Jika pemindai mengirim Tab, baca nilai pada keydown itu dan biarkan peramban memindahkan fokus. Jika tidak mengirim keduanya, kirim bidang dari tombol atau tindakan eksplisit lain. Jeda saat mengetik hanya heuristik untuk akhir pindaian.
Tidak ada apa pun dalam peristiwa itu yang mengidentifikasi perangkat USB. Orang, makro, atau emulator bisa menghasilkan urutan yang sama. Validasi ada pada muatan. Alur kerja peramban, termasuk Tab dan masukan kosong, ada di Cara menguji pemindai kode batang di aplikasi web.
Bagaimana pemindai serial bekerja di aplikasi
Integrasi serial membuka port, membaca byte, memecahnya menjadi pesan, dan menangani port yang hilang. Di desktop, itu API serial sistem operasi atau pustaka vendor. Di peramban, satu-satunya pilihan bawaan adalah Web Serial API, dan hanya di peramban yang menerapkannya.
Web Serial tersedia di peramban berbasis Chromium. Firefox dan Safari tidak menyediakannya. Halaman harus berada di konteks aman, yang berarti HTTPS atau localhost. requestPort() harus berjalan dari gestur pengguna, dan pengguna harus memilih port di prompt peramban. Pemindai keyboard wedge tidak muncul di daftar itu, karena ia bukan perangkat serial. Web Serial juga tidak melihat port serial yang belum diekspos sistem operasi.
Laju baud dalam contoh adalah titik awal yang Anda ganti dengan nilai di buku panduan. Lingkaran memperlakukan CR atau LF sebagai akhir pesan dan memakai pasangan CRLF sebagai satu terminator. Jika pemindai memakai bingkai lain, pemecahan ini salah meskipun 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>
Lingkaran baca berjalan sampai aliran berakhir atau pembacaan gagal. Mencabut pemindai biasanya menolak pembacaan. releaseLock() dan close() berjalan di finally. Port yang sebelumnya disetujui untuk origin ini bisa didaftar dengan navigator.serial.getPorts() tanpa menampilkan prompt lagi. Persetujuan pertama tetap membutuhkan pengguna.
Aplikasi desktop mengikuti gagasan yang sama dengan API serial platform: buka, baca, bingkai, dan buka lagi setelah perangkat kembali. Halaman ini tidak mengarang perintah vendor. Jika pemindai mengharapkan protokol milik sendiri, protokol itu ada di dokumentasi produsen.
Mana yang lebih baik: HID atau serial?
Tidak ada mode yang lebih baik untuk setiap produk. Pakai mode yang benar-benar ditawarkan pemindai dan mode yang bisa dibaca aplikasi.
Pilih HID ketika
- Aplikasi sudah menerima masukan papan ketik di bidang yang berfokus.
- Anda ingin formulir atau layar POS bekerja tanpa kode perangkat.
- Alur kerja bisa menjamin fokus sebelum setiap pindaian.
- Enter atau Tab cocok dengan cara formulir itu mengunci atau maju.
Pertimbangkan serial ketika
- Pindaian harus tiba saat fokus ada di dialog, di tombol, atau tidak di mana pun.
- Byte pemindai harus tetap terpisah dari pengetikan.
- Aplikasi bisa membuka port, membingkai pesan, dan pulih ketika perangkat dicabut.
- Host bisa memberi izin ke port itu dan tidak ada proses lain yang membutuhkannya pada saat yang sama.
Pemindai yang hanya terdaftar sebagai papan ketik tidak bisa dialihkan ke serial lewat perangkat lunak di host. Pastikan mode di buku panduan sebelum Anda merancang integrasi.
Beralih antara HID dan serial
Sebagian pemindai berganti mode ketika Anda memindai kode batang konfigurasi dari buku panduan produsen itu, atau ketika Anda menulis profil dengan utilitas vendor. Yang lain dibuat sebagai satu antarmuka dan tidak punya apa pun untuk dialihkan.
Tidak ada kode batang konfigurasi yang mengubah setiap merek. Urutan yang dicetak untuk model lain bisa tidak melakukan apa-apa, atau meninggalkan pemindai di mode yang tidak terduga. Setelah perubahan apa pun, periksa apa yang ditunjukkan sistem operasi: papan ketik, port COM, atau keduanya. Lalu uji jalur yang dipakai aplikasi. Panduan konfigurasi pemindai kode batang menjelaskan kelompok pengaturan yang biasa. Ia tidak menggantikan buku panduan.
Menguji pemindai HID
- Sambungkan pemindai dan pastikan ia berada di mode keyboard wedge. Editor teks harus menerima karakter ketika bidang di editor itu berfokus.
- Buka penguji masukan kode batang.
- Klik Start Test, atau klik area pindai. Area itu menjadi biru ketika siap. Halaman tidak mengambil fokus sendiri.
- Pindai kode batang yang muatannya sudah Anda ketahui.
- Bandingkan nilai yang tertangkap dan jumlah karakter dengan muatan itu.
- Baca akhiran: ENTER, TAB, atau None. Enter dan Tab bukan bagian dari string kode batang.
Penguji merekam peristiwa papan ketik yang bisa dilihat peramban. Ia tidak bisa membaca port serial, dan tidak bisa mengidentifikasi perangkat USB. Ketika celah rata-rata antar karakter di bawah 100 ms, ia melaporkan waktu itu. Waktu itu bukan identifikasi perangkat keras. Untuk setiap keydown, termasuk key dan code, pakai penguji peristiwa papan ketik. Pemeriksaan QA yang lebih luas ada di Cara menguji masukan pemindai kode batang.
Menguji pemindai serial
Penguji masukan kode batang tidak membuka port COM. Pengujian serial membutuhkan program yang bisa membuka port yang diekspos pemindai.
- Pastikan pemindai berada di mode serial dan sistem operasi menampilkan port ketika pemindai tersambung. Cabut, lalu periksa bahwa port hilang.
- Catat nama port. Nama itu khusus sistem operasi dan bisa berubah pada penyambungan berikutnya.
- Buka port dari aplikasi yang kompatibel: terminal serial, aplikasi desktop Anda, atau contoh Web Serial di atas pada peramban Chromium di HTTPS atau localhost.
- Atur laju baud, bit data, parity, dan bit stop ketika buku panduan menentukannya. Lewati nilai yang dikarang.
- Pindai kode batang yang sudah diketahui.
- Bandingkan byte atau teks yang didekode dengan muatan itu.
- Periksa bingkai. Cari awalan, dan CR, LF, atau CRLF setelah data, hanya jika buku panduan mengonfigurasi hal itu.
Jika pembukaan port gagal karena sedang sibuk, tutup program lain yang menahannya. Jika teks berupa sampah, pengaturan jalur tidak cocok dengan perangkat. Jika port tidak pernah muncul, pemindai mungkin masih di mode papan ketik, pengandar mungkin hilang, atau pengguna OS mungkin tidak diizinkan membuka perangkat serial.
Masalah yang umum
Pemindai bekerja di editor teks dan tidak di aplikasi sasaran. Perangkat sedang mengetik. Sasaran tidak punya fokus, atau pendengar keydown membuang tombol. Mulai dari Pemindai bekerja di Notepad tetapi tidak di POS.
Pemindai tidak mengetik ke bidang teks mana pun. Ia mungkin berada di mode serial, mati, atau tidak membaca simbol. Pemindai mode serial tidak akan mengetik. Periksa port COM sebelum Anda menelusuri bidang. Pemindai kode batang tidak bekerja memisahkan pemindai yang mati dari antarmuka yang salah.
Port serial tidak ada. Mode papan ketik tidak membuat port COM. Pengandar yang hilang, kabel yang hanya mengisi daya, atau pemindai yang tidak punya mode serial menghasilkan gejala yang sama. Amati daftar perangkat OS selagi Anda mencolokkan pemindai.
Port serial sudah dipakai. Hanya satu proses yang bisa membacanya. Tutup terminal atau salinan lain aplikasi, lalu buka lagi.
Pengaturan komunikasi salah. Baud, parity, atau bit stop yang tidak cocok tampak seperti karakter acak. Atur nilai dari buku panduan model itu, lalu pindai kode yang diketahui lagi.
ENTER atau TAB tidak pernah tiba. Itu pengaturan akhiran wedge. Penguji masukan melaporkan None. Lihat Pemindai kode batang tidak mengirim ENTER dan panduan akhiran yang ditautkan di atas. Pemindai serial tidak mengirim tombol Enter. Ia mungkin mengirim byte CR atau LF sebagai gantinya.
Karakter salah pada pemindai wedge. Tata letak papan ketik pemindai dan tata letak sistem operasi bisa tidak sejalan. Byte serial tidak dipetakan ulang oleh tata letak itu. Lihat Tata letak papan ketik pemindai kode batang salah.
Peramban tidak bisa mengakses pemindai. Pemindai wedge tidak akan muncul di prompt Web Serial. Firefox dan Safari tidak punya Web Serial API. Halaman yang bukan HTTPS atau localhost tidak bisa memakainya. Pengguna juga bisa menutup prompt port.
Aplikasi kehilangan pemindai setelah dicabut. Pemindai wedge kembali sebagai papan ketik, dan pindaian berikutnya tetap membutuhkan fokus. Port serial hilang sampai aplikasi membuka port baru. Namanya mungkin tidak sama dengan yang sebelumnya.
Skenario integrasi
Aplikasi web
Keyboard wedge cocok untuk masukan yang berfokus dan peristiwa DOM biasa. Akses serial di dalam halaman berarti Web Serial di peramban yang mendukung, konteks aman, dan port yang dipilih pengguna. Halaman yang harus mendukung Firefox, Safari, dan kios tanpa penjaga tidak bisa hanya bergantung pada Web Serial. Pembantu lokal bisa memiliki port COM dan meneruskan kode batang yang utuh ke halaman. Pembantu itu adalah perangkat lunak terpisah. Halaman tetap tidak boleh mengharapkan pengujian wedge untuk melatihnya.
Sistem POS
POS yang menaruh fokus di bidang barang dan mengunci pada Enter adalah integrasi wedge. POS yang harus memindai saat modal terbuka, atau yang harus mengabaikan papan ketik, adalah integrasi serial. Mencampurnya menghasilkan pindaian di bidang yang salah atau pindaian yang tidak pernah tiba. Cocokkan mode pemindai dengan layar yang benar-benar bertugas.
Aplikasi desktop
Aplikasi desktop bisa menerima masukan wedge di kontrol mana pun yang berfokus, atau membuka port COM virtual dan menjaga sesi selama proses hidup. Kepemilikan port, penyambungan ulang, dan pembingkaian adalah bagian dari sesi itu. Fokus bukan.
Otomatisasi QA
Barcode Scanner Emulator mengetikkan nilai yang Anda pilih ke aplikasi yang berfokus dan bisa mengirim ENTER, TAB, atau tanpa akhiran. Itu mencakup regresi keyboard wedge: fokus, validasi, dan penanganan akhiran. Ia tidak membuat port COM virtual, tidak mendaftarkan perangkat USB, dan tidak mereproduksi baud serta bingkai. Pengujian serial tetap butuh port serial dan pembaca, atau dobel uji yang menulis bingkai byte yang sama dengan yang diurai aplikasi.
Aplikasi kios
Kios yang memakai masukan wedge harus menjaga fokus bidang pindai melewati dialog, screen saver, dan pesan galat. Satu fokus yang hilang, pindaian berikutnya mengenai pintasan atau tidak mengenai apa pun. Kios yang memakai serial bisa membaca port tanpa fokus itu, dan harus memegang izin ke perangkat serta membuka lagi port setelah listrik padam atau kabel tercabut.
Di mana Barcode Scanner Emulator berperan
Barcode Scanner Emulator adalah aplikasi desktop untuk Windows, macOS, dan Linux. Ia mereproduksi jalur papan ketik yang dipakai pemindai wedge. Anda memasukkan teks, memilih jeda pengetikan, dan memilih akhiran none, ENTER, atau TAB. Pintasan global mengetikkan teks itu ke aplikasi yang berfokus.
Pakai untuk mengembangkan dan meregresi formulir bergaya HID ketika pemindai tidak ada di meja. Pasangkan dengan penguji masukan kode batang untuk melihat nilai, tombol awalan, dan akhiran yang diterima peramban.
Ia tidak meniru perangkat serial USB, port COM virtual, enumerasi USB, atau dekode optik. Perilaku itu tetap milik perangkat keras, atau milik dobel uji serial yang Anda kendalikan.