Barcode Scanner Emulator
USB HID ir nuoseklieji brūkšninių kodų skaitytuvai
USB HID klaviatūros pleišto skaitytuvas įveda dekoduotą brūkšninį kodą į fokusuotą programą. USB nuoseklusis skaitytuvas atveria nuosekliąją sąsają, dažnai kaip virtualų COM prievadą, ir programa turi tą prievadą atidaryti bei skaityti baitus. USB yra laidas ir magistralė. HID ir nuoseklusis yra skirtingi duomenų pateikimo būdai.
Pasirinkite sąsają, kurią programa iš tikrųjų gali skaityti. Kasos laukas, kuris jau priima rašymą, yra klaviatūros pleišto uždavinys. Tarnyba, kuri turi gauti nuskaitymus, kai joks teksto laukas nėra fokusuotas, arba kuri turi laikyti skaitytuvo baitus atskirai nuo klaviatūros, yra nuoseklusis uždavinys. Daugelis skaitytuvų siūlo tik vieną iš tų režimų. Kai kuriuos galima perjungti. To modelio vadovas yra režimų, kuriuos galite tikrinti, sąrašas.
Vadovas HID klaviatūros pleištas išsamiai paaiškina klavišų paspaudimų kelią. Kaip veikia brūkšninių kodų skaitytuvai? apima fiksavimą ir dekodavimą. Šis puslapis lygina dvi pagrindinio kompiuterio sąsajas ir testus, kurie priklauso kiekvienai.
Kas yra USB HID klaviatūros pleišto režimas?
USB HID klaviatūros režimu skaitytuvas prisistato kaip klaviatūra. Operacinė sistema įkelia savo įprastą klaviatūros tvarkyklę. Po dekodavimo skaitytuvas siunčia simbolius kaip klavišų paspaudimus į valdiklį, kuris turi klaviatūros fokusą. Žiniatinklio forma, POS prekės laukas arba darbalaukio teksto laukas gali priimti tą įvestį be skaitytuvui skirto kodo.
Fokusas nusprendžia paskirtį. Jei numatytas laukas nėra fokusuotas, simboliai patenka į kitą valdiklį arba dingsta. Skaitytuvas nepaspaudžia ir nejudina žymeklio.
Sukonfigūruota priesaga gali eiti po apkrovos. Enter pateikia daug vieno lauko formų. Tab perkelia fokusą į kitą valdiklį. Nė vienas iš tų klavišų nėra garantuotas. Priesagų pasirinkimai aptariami vadove ENTER ir TAB priesagos brūkšninių kodų skaitytuvuose.
Įprasti klaviatūros įvykiai neapima skaitytuvo gamintojo, serijos numerio ar žymos, kuri sakytų, kad klavišai atėjo iš skaitytuvo. Naršyklės, kurios įgyvendina WebHID, vis tiek atmeta klaviatūros sąsajas, todėl puslapis negali atidaryti pleišto įrenginio ir skaityti neapdorotų HID ataskaitų.
Kas yra USB nuosekliojo brūkšninių kodų skaitytuvo režimas?
USB nuosekliuoju režimu skaitytuvas nerašo. Jis atveria nuosekliąją sąsają per USB. Operacinė sistema tą sąsają paprastai pateikia kaip virtualų COM prievadą: COM vardą sistemoje Windows, cu arba tty įrenginį macOS arba ttyACM arba ttyUSB įrenginį Linux. Vardą priskiria tvarkyklė, ir jis gali pasikeisti atjungus skaitytuvą.
Virtualus COM prievadas nėra fizinis RS-232 prievadas. RS-232 yra elektrinė sąsaja su savo jungtimi ir įtampos lygiais, kurią kompiuteris skaito per UART. USB nuoseklusis naudoja USB laidą. Programa vis tiek atidaro nuoseklųjį prievadą ir skaito baitus, bet signalas laide yra USB. Vieni gaminiai yra tikras RS-232 skaitytuvas ir USB į nuoseklųjį adapteris. Kiti įgyvendina USB CDC ir iš viso nekalba RS-232. Laikykite prievadą, kurį rodo operacinė sistema, integracijos tašku ir nelaikykite, kad elektrinės detalės sutampa.
Programa atidaro prievadą, skaito baitų srautą ir nusprendžia, kur pranešimas prasideda ir baigiasi. Įprastas rėmas yra brūkšninio kodo tekstas, po kurio eina CR (0x0D), LF (0x0A) arba CR ir tada LF. Tas rėminimas yra įrenginio nustatymas, ne USB taisyklė. Galimas ir priešdėlio baitas, pavyzdžiui STX. Priešdėlio ir priesagos vadovas atskiria tuos baitus nuo Enter klavišo, kurį siunčia pleišto skaitytuvas.
Sparta bodais, duomenų bitai, lyginumas ir stabdymo bitai svarbūs tikrame UART ir daugelyje USB į nuoseklųjį adapterių. Neteisinga sparta duoda šiukšles, o ne švarią klaidą. Kai kurie USB CDC virtualūs COM įrenginiai nepaiso pagrindinio kompiuterio prašomos spartos ir baitus vis tiek pristato. Nėra vieno nustatymo, kuris tiktų kiekvienam virtualiam nuosekliajam skaitytuvui. Naudokite to modelio vadove nurodytą spartą ir rėminimą, tada patvirtinkite juos žinomu brūkšniniu kodu.
Duomenis gauna procesas, kuris laiko prievadą atidarytą. Klaviatūros fokusas paskirties neparenka. Kita programa, kuri prievadą jau turi atidarytą, užblokuos antrą atidarymą. Skaitytuvo atjungimas pašalina prievadą. Prijungus iš naujo gali atsirasti naujas vardas, ir programa turi tą prievadą atidaryti dar kartą.
HID ir nuoseklusis
| Savybė | HID klaviatūros pleištas | USB nuoseklusis |
|---|---|---|
| Duomenų pristatymas | Klaviatūros stiliaus įvestis | Nuoseklusis baitų srautas |
| Reikalingas įvesties fokusas | Taip. Klavišų paspaudimai seka fokusuotą valdiklį | Ne. Baitai eina procesui, kuris atidarė prievadą |
| Integracija į naršyklę | Įprasta įvestis ir klaviatūros įvykiai | Web Serial ten, kur naršyklė jį palaiko, arba programinė įranga už puslapio ribų |
| Programos valdymas | Apribotas klaviatūros elgsena, fokusu ir priesagomis | Programa skaito srautą ir jį rėmina |
| Įrenginio atpažinimas | Iš įprastų klaviatūros įvykių neprieinamas | Operacinė sistema gali parodyti prievado vardą. Stabili tapatybė vis tiek priklauso nuo tvarkyklės |
| Konfigūracija | Skaitytuvo nustatymai, įskaitant priesagą ir klaviatūros išdėstymą | Skaitytuvo nustatymai ir pagrindinio kompiuterio prievado nustatymai, kuriuos įrenginys iš tikrųjų naudoja |
| Tipinis naudojimas | Formos ir POS prekių įvedimas | Specialios integracijos, kurios valdo įrenginį |
Tai įprasti atvejai. Konkretus modelis, operacinė sistema ir tvarkyklė gali skirtis. Bluetooth skaitytuvas HID klaviatūros režimu programos sluoksnyje seka pleišto stulpelį. Bluetooth SPP seka nuoseklųjį stulpelį.
Kaip HID skaitytuvai veikia žiniatinklio programose
Pleišto nuskaitymas atnaujina fokusuotą elementą. Spausdinami simboliai paleidžia keydown, o tada input. Enter ir Tab paleidžia keydown ir neįterpia simbolio į įprastą teksto įvestį. event.key tiems klavišams yra "Enter" arba "Tab", o spausdinamam simboliui – vieno simbolio eilutė. event.code įvardija fizinį klavišą ir gali likti toks pat, kai klaviatūros išdėstymo neatitiktis pakeičia event.key.
Žemiau esantis klausytojas patvirtina lauką tik tada, kai ateina Enter. Skaitytuvas be Enter priesagos palieka tekstą lauke.
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 = ''
})
Prieš nuskaitymą sufokusuokite #barcode. preventDefault() neleidžia tėvinei formai pateikti antrą kartą. Jei skaitytuvas siunčia Tab, perskaitykite reikšmę tame keydown ir leiskite naršyklei perkelti fokusą. Jei nesiunčia nė vieno, pateikite lauką mygtuku arba kitu aiškiu veiksmu. Pauzė rašyme tėra euristika nuskaitymo pabaigai.
Tuose įvykiuose nėra nieko, kas identifikuotų USB įrenginį. Asmuo, makrokomanda arba emuliatorius gali sukurti tą pačią seką. Tikrinimas priklauso apkrovai. Naršyklės darbo eiga, įskaitant Tab ir tuščią įvestį, yra vadove Kaip testuoti brūkšninių kodų skaitytuvus žiniatinklio programose.
Kaip nuoseklieji skaitytuvai veikia programose
Nuoseklioji integracija atidaro prievadą, skaito baitus, skaido juos į pranešimus ir susitvarko, kai prievadas dingsta. Darbalaukyje tai operacinės sistemos nuoseklioji API arba gamintojo biblioteka. Naršyklėje vienintelė įtaisyta galimybė yra Web Serial API, ir tik naršyklėse, kurios ją įgyvendina.
Web Serial yra Chromium pagrindu veikiančiose naršyklėse. Firefox ir Safari jos neteikia. Puslapis turi būti saugiame kontekste, o tai reiškia HTTPS arba localhost. requestPort() turi veikti iš naudotojo gesto, ir naudotojas turi pasirinkti prievadą naršyklės raginime. Klaviatūros pleišto skaitytuvas tame sąraše nepasirodo, nes tai nėra nuoseklusis įrenginys. Web Serial taip pat nemato nuosekliojo prievado, kurio operacinė sistema neatvėrė.
Sparta pavyzdyje yra pradžios taškas, kurį pakeičiate vadovo reikšme. Ciklas laiko CR arba LF pranešimo pabaiga ir suvartoja CRLF porą kaip vieną užbaigiklį. Jei jūsų skaitytuvas naudoja kitokį rėmą, šis skaidymas neteisingas net tada, kai prievadas atidarytas.
<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>
Skaitymo ciklas veikia, kol srautas baigiasi arba skaitymas nepavyksta. Skaitytuvo atjungimas paprastai atmeta skaitymą. releaseLock() ir close() veikia finally. Anksčiau patvirtintus šios kilmės prievadus galima išvardyti su navigator.serial.getPorts() nerodant raginimo dar kartą. Pirmas patvirtinimas vis tiek reikalauja naudotojo.
Darbalaukio programa seka tą pačią mintį su platformos nuosekliąja API: atidaryti, skaityti, rėminti ir vėl atidaryti, kai įrenginys grįžta. Šis puslapis nekuria gamintojo komandų. Jei skaitytuvas tikisi nuosavo protokolo, tas protokolas yra gamintojo dokumentacijoje.
Kas geriau: HID ar nuoseklusis?
Nė vienas režimas nėra geresnis kiekvienam gaminiui. Naudokite režimą, kurį skaitytuvas iš tikrųjų siūlo, ir režimą, kurį programa gali skaityti.
Rinkitės HID, kai
- Programa jau priima klaviatūros įvestį fokusuotame lauke.
- Norite, kad forma arba POS ekranas veiktų be įrenginio kodo.
- Darbo eiga gali užtikrinti fokusą prieš kiekvieną nuskaitymą.
- Enter arba Tab atitinka tai, kaip ta forma patvirtina arba pereina toliau.
Svarstykite nuoseklųjį, kai
- Nuskaitymai turi ateiti, kai fokusas yra dialogo lange, ant mygtuko arba niekur.
- Skaitytuvo baitai turi likti atskirai nuo rašymo.
- Programa gali atidaryti prievadą, rėminti pranešimus ir atsigauti, kai įrenginys atjungiamas.
- Pagrindinis kompiuteris gali suteikti leidimą tam prievadui ir joks kitas procesas jo tuo pačiu metu nereikalauja.
Skaitytuvo, kuris prisistato tik kaip klaviatūra, programine įranga pagrindiniame kompiuteryje perjungti į nuoseklųjį negalima. Prieš projektuodami integraciją patvirtinkite režimus vadove.
Perjungimas tarp HID ir nuosekliojo
Kai kurie skaitytuvai keičia režimą, kai nuskaitote konfigūracijos brūkšninį kodą iš to gamintojo vadovo arba kai profilį įrašote gamintojo priemone. Kiti sukurti kaip viena sąsaja ir neturi ko perjungti.
Nėra konfigūracijos brūkšninio kodo, kuris pakeistų kiekvieną gamintoją. Kitam modeliui atspausdinta seka gali nieko nepadaryti arba palikti skaitytuvą netikėtame režime. Po bet kokio pakeitimo patikrinkite, ką rodo operacinė sistema: klaviatūrą, COM prievadą arba abu. Tada išbandykite kelią, kurį naudoja jūsų programa. Brūkšninių kodų skaitytuvo konfigūravimo vadovas aprašo įprastas nustatymų grupes. Jis nepakeičia vadovo.
HID skaitytuvo testavimas
- Prijunkite skaitytuvą ir patvirtinkite, kad jis yra klaviatūros pleišto režimu. Teksto rengyklė turėtų gauti simbolius, kai toje rengyklėje laukas yra fokusuotas.
- Atidarykite brūkšninio kodo įvesties testerį.
- Spustelėkite Pradėti testą arba spustelėkite nuskaitymo sritį. Ji tampa mėlyna, kai yra pasirengusi. Puslapis pats neperima fokuso.
- Nuskaitykite brūkšninį kodą, kurio apkrovą jau žinote.
- Palyginkite užfiksuotą reikšmę ir ženklų skaičių su ta apkrova.
- Perskaitykite priesagą: ENTER, TAB arba Nėra. Enter ir Tab nėra brūkšninio kodo eilutės dalis.
Testeris registruoja klaviatūros įvykius, kuriuos naršyklė gali matyti. Jis negali skaityti nuosekliojo prievado ir negali identifikuoti USB įrenginio. Kai vidutinis tarpas tarp simbolių yra mažesnis nei 100 ms, jis praneša tą laiką. Laikas nėra aparatinės įrangos identifikacija. Kiekvienam keydown, įskaitant key ir code, naudokite klaviatūros įvykių testerį. Platesnis QA patikrinimas yra vadove Kaip testuoti brūkšninių kodų skaitytuvo įvestį.
Nuosekliojo skaitytuvo testavimas
Brūkšninio kodo įvesties testeris neatidaro COM prievado. Nuosekliam testui reikia programos, kuri gali atidaryti prievadą, kurį atveria skaitytuvas.
- Patvirtinkite, kad skaitytuvas yra nuosekliuoju režimu ir kad operacinė sistema išvardija prievadą, kai jis prijungtas. Atjunkite jį ir patikrinkite, kad prievadas dingsta.
- Užsirašykite prievado vardą. Jis priklauso nuo operacinės sistemos ir gali pasikeisti kitą kartą prijungus.
- Atidarykite prievadą iš suderinamos programos: nuosekliojo terminalo, savo darbalaukio programos arba aukščiau esančio Web Serial pavyzdžio Chromium naršyklėje per HTTPS arba localhost.
- Nustatykite spartą bodais, duomenų bitus, lyginumą ir stabdymo bitus, kai vadovas juos nurodo. Praleiskite sugalvotas reikšmes.
- Nuskaitykite žinomą brūkšninį kodą.
- Palyginkite baitus arba dekoduotą tekstą su ta apkrova.
- Patikrinkite rėminimą. Ieškokite priešdėlio ir CR, LF arba CRLF po duomenų tik tada, jei būtent taip sukonfigūravo vadovas.
Jei prievado atidarymas nepavyksta, nes jis užimtas, uždarykite kitą programą, kuri jį laiko. Jei tekstas yra šiukšlės, linijos nustatymai neatitinka įrenginio. Jei prievadas niekada nepasirodo, skaitytuvas vis dar gali būti klaviatūros režimu, gali trūkti tvarkyklės arba operacinės sistemos naudotojui gali būti neleidžiama atidaryti nuosekliųjų įrenginių.
Dažnos problemos
Skaitytuvas veikia teksto rengyklėje, bet ne tikslinėje programoje. Įrenginys rašo. Tikslas neturi fokuso arba keydown klausytojas atmeta klavišus. Pradėkite nuo Skaitytuvas veikia užrašinėje, bet ne POS.
Skaitytuvas nerašo į jokį teksto lauką. Jis gali būti nuosekliuoju režimu, išjungtas arba neskaito simbolio. Nuosekliuoju režimu veikiantis skaitytuvas nerašo. Prieš derindami lauką ieškokite COM prievado. Brūkšninių kodų skaitytuvas neveikia atskiria neveikiantį skaitytuvą nuo netinkamos sąsajos.
Nuosekliojo prievado nėra. Klaviatūros režimas nekuria COM prievado. Trūkstama tvarkyklė, laidas, kuris tik įkrauna, arba skaitytuvas be nuosekliojo režimo duoda tą patį simptomą. Stebėkite operacinės sistemos įrenginių sąrašą, kol jungiate skaitytuvą.
Nuoseklusis prievadas jau naudojamas. Jį gali skaityti tik vienas procesas. Uždarykite terminalą arba kitą programos kopiją, tada atidarykite iš naujo.
Ryšio nustatymai neteisingi. Nesutampanti sparta, lyginumas arba stabdymo bitai atrodo kaip atsitiktiniai simboliai. Nustatykite to modelio reikšmes iš vadovo, tada dar kartą nuskaitykite žinomą kodą.
ENTER arba TAB niekada neateina. Tai pleišto priesagos nustatymas. Įvesties testeris praneša Nėra. Žr. Brūkšninių kodų skaitytuvui trūksta ENTER ir aukščiau susietą priesagos vadovą. Nuoseklusis skaitytuvas nesiunčia Enter klavišo. Jis gali siųsti CR arba LF baitus.
Simboliai pleišto skaitytuve neteisingi. Skaitytuvo klaviatūros išdėstymas ir operacinės sistemos išdėstymas gali nesutapti. Nuosekliųjų baitų tas išdėstymas neperkoduoja. Žr. Neteisingas brūkšninių kodų skaitytuvo klaviatūros išdėstymas.
Naršyklė negali pasiekti skaitytuvo. Pleišto skaitytuvas nepasirodys Web Serial raginime. Firefox ir Safari neturi Web Serial API. Puslapis, kuris nėra HTTPS arba localhost, ja naudotis negali. Naudotojas taip pat gali atmesti prievado raginimą.
Programa pameta skaitytuvą jį atjungus. Pleišto skaitytuvas grįžta kaip klaviatūra, ir kitam nuskaitymui vis tiek reikia fokuso. Nuosekliojo prievado nebėra, kol programa atidaro naują prievadą. Vardas gali nesutapti su ankstesniu.
Integracijos scenarijai
Žiniatinklio programos
Klaviatūros pleištas tinka fokusuotai įvesčiai ir įprastiems DOM įvykiams. Nuoseklioji prieiga puslapio viduje reiškia Web Serial palaikančioje naršyklėje, saugų kontekstą ir naudotojo pasirinktą prievadą. Puslapis, kuris turi palaikyti Firefox, Safari ir nestebimus kioskus, negali remtis vien Web Serial. Vietinis pagalbininkas gali valdyti COM prievadą ir perduoti užbaigtus brūkšninius kodus puslapiui. Tas pagalbininkas yra atskira programinė įranga. Puslapis vis tiek neturėtų tikėtis, kad pleišto testas jį išbandys.
POS sistemos
POS, kuris fokusą padeda prekės lauke ir patvirtina Enter klavišu, yra pleišto integracija. POS, kuris turi skenuoti, kol atidarytas modalinis langas, arba kuris turi nepaisyti klaviatūros, yra nuoseklioji integracija. Juos sumaišius nuskaitymai patenka į netinkamą lauką arba niekada neatvyksta. Skaitytuvo režimą derinkite su ekranu, kuris iš tikrųjų budi.
Darbalaukio programos
Darbalaukio programa gali priimti pleišto įvestį tame valdiklyje, kuris fokusuotas, arba atidaryti virtualų COM prievadą ir laikyti seansą visą proceso gyvavimo laiką. Prievado valdymas, pakartotinis prisijungimas ir rėminimas yra to seanso dalis. Fokusas nėra.
QA automatizavimas
Barcode Scanner Emulator įveda jūsų pasirinktą reikšmę į fokusuotą programą ir gali siųsti ENTER, TAB arba jokios priesagos. Tai apima klaviatūros pleišto regresijas: fokusą, tikrinimą ir priesagų tvarkymą. Jis nekuria virtualaus COM prievado, neišvardija USB įrenginių ir neatkuria spartos bei rėminimo. Nuosekliems testams vis tiek reikia nuosekliojo prievado ir skaitytuvo arba testo dublikato, kuris rašo tą patį baitų rėminimą, kurį jūsų programa analizuoja.
Kioskų programos
Kioskas, naudojantis pleišto įvestį, turi išlaikyti nuskaitymo lauką fokusuotą per dialogus, ekrano užsklandas ir klaidų pranešimus. Vienas prarastas fokusas, ir kitas nuskaitymas pataiko į trumpinį arba į nieką. Kioskas, naudojantis nuoseklųjį, gali skaityti prievadą be to fokuso ir turi turėti leidimą įrenginiui bei vėl atidaryti prievadą po elektros dingimo arba laido ištraukimo.
Kur tinka Barcode Scanner Emulator
Barcode Scanner Emulator yra darbalaukio programa, skirta Windows, macOS ir Linux. Ji atkuria klaviatūros kelią, kurį naudoja pleišto skaitytuvas. Įvedate tekstą, pasirenkate rašymo delsą ir pasirenkate priesagą: nėra, ENTER arba TAB. Visuotinis trumpinys įveda tą tekstą į fokusuotą programą.
Naudokite jį HID stiliaus formoms kurti ir regresijai tikrinti, kai skaitytuvo nėra ant stalo. Sujunkite jį su brūkšninio kodo įvesties testeriu, kad pamatytumėte reikšmę, priešdėlio klavišus ir priesagą, kuriuos gavo naršyklė.
Jis neemuliuoja USB nuosekliojo įrenginio, virtualaus COM prievado, USB išvardijimo ar optinio dekodavimo. Ta elgsena vis tiek priklauso aparatinei įrangai arba nuosekliajam testo dublikatui, kurį valdote.