Barcode Scanner Emulator
USB HID dhidi ya skana za mfululizo za msimbo pau
Skana ya keyboard wedge ya USB HID huandika msimbo pau uliofumbuliwa katika programu yenye lengo. Skana ya mfululizo ya USB hufungua kiolesura cha mfululizo, mara nyingi kama bandari pepe ya COM, na programu lazima ifungue bandari hiyo na isome baiti. USB ni kebo na basi. HID na mfululizo ni njia tofauti za kuwasilisha data.
Chagua kiolesura ambacho programu inaweza kusoma kweli. Sehemu ya malipo inayokubali tayari uandikaji ni tatizo la keyboard wedge. Huduma ambayo lazima ipokee uskani wakati hakuna sehemu ya maandishi yenye lengo, au ambayo lazima itenganishe baiti za skana na kibodi, ni tatizo la mfululizo. Skana nyingi hutoa moja tu ya hali hizo. Baadhi zinaweza kubadilishwa. Mwongozo wa modeli hiyo ndio orodha ya hali unazoweza kujaribu.
Mwongozo wa HID keyboard wedge unaeleza kwa kina njia ya mibofyo ya vitufe. Skana za msimbo pau hufanya kazi vipi? inashughulikia kunasa na kufumbua. Ukurasa huu unalinganisha violesura viwili vya mwenyeji na majaribio yanayomilikiwa na kila kimoja.
Hali ya keyboard wedge ya USB HID ni nini?
Katika hali ya kibodi ya USB HID skana huhesabiwa kama kibodi. Mfumo wa uendeshaji hupakia kiendeshi chake cha kawaida cha kibodi. Baada ya kufumbua, skana hutuma herufi kama mibofyo ya vitufe kwa kidhibiti chochote kilicho na lengo la kibodi. Fomu ya wavuti, sehemu ya bidhaa ya POS, au kisanduku cha maandishi cha eneo-kazi inaweza kupokea ingizo hilo bila msimbo maalum wa skana.
Lengo linaamua kikomo. Ikiwa sehemu iliyokusudiwa haina lengo, herufi huangukia kidhibiti kingine au hupotea. Skana haibofyi, wala haihamishi kielekezi.
Kiambishi cha mwisho kilichosanidiwa kinaweza kufuata mzigo. Enter huwasilisha fomu nyingi za sehemu moja. Tab huhamisha lengo kwa kidhibiti kinachofuata. Hakuna kitufe kati ya hivyo viwili kinachohakikishwa. Chaguo za kiambishi cha mwisho zinaelezwa katika Viambishi vya mwisho vya ENTER na TAB katika skana za msimbo pau.
Matukio ya kawaida ya kibodi hayajumuishi muuzaji wa skana, nambari ya mfululizo, wala bendera inayosema vitufe vilitoka kwa skana. Vivinjari vinavyotekeleza WebHID bado vinakataa violesura vya kibodi, hivyo ukurasa hauwezi kufungua kifaa cha wedge na kusoma ripoti ghafi za HID.
Hali ya skana ya msimbo pau ya mfululizo ya USB ni nini?
Katika hali ya mfululizo ya USB skana haiandiki. Inafungua kiolesura cha mfululizo kupitia USB. Mfumo wa uendeshaji kwa kawaida huwasilisha kiolesura hicho kama bandari pepe ya COM: jina la COM katika Windows, kifaa cha cu au tty katika macOS, au kifaa cha ttyACM au ttyUSB katika Linux. Jina linatolewa na kiendeshi na linaweza kubadilika baada ya skana kuchopolewa.
Bandari pepe ya COM si bandari halisi ya RS-232. RS-232 ni kiolesura cha umeme, chenye kiunganishi na viwango vyake vya voltage, ambacho kompyuta husoma kupitia UART. Mfululizo wa USB hutumia kebo ya USB. Programu bado hufungua bandari ya mfululizo na kusoma baiti, lakini ishara kwenye waya ni USB. Baadhi ya bidhaa ni skana halisi ya RS-232 pamoja na adapta ya USB kwenda mfululizo. Nyingine zinatekeleza USB CDC na hazizungumzi RS-232 kamwe. Chukulia bandari ambayo mfumo wa uendeshaji unakuonyesha kama sehemu ya ujumuishaji, na usidhani maelezo ya umeme yanalingana.
Programu hufungua bandari, husoma mtiririko wa baiti, na huamua mahali ujumbe unapoanza na kuishia. Fremu ya kawaida ni maandishi ya msimbo pau yakifuatwa na CR (0x0D), LF (0x0A), au CR kisha LF. Fremu hiyo ni mpangilio wa kifaa, si kanuni ya USB. Baiti ya kiambishi awali kama STX pia inawezekana. Mwongozo wa kiambishi awali na kiambishi cha mwisho hutenganisha baiti hizo na kitufe cha Enter ambacho skana ya wedge hutuma.
Kasi ya baud, biti za data, usawa, na biti za kusimamisha ni muhimu kwenye UART halisi na kwenye adapta nyingi za USB kwenda mfululizo. Kasi isiyo sahihi hutoa takataka badala ya kosa safi. Baadhi ya vifaa pepe vya COM vya USB CDC hupuuza kasi ya baud inayotakiwa na mwenyeji na bado huwasilisha baiti. Hakuna mpangilio mmoja unaofaa kila skana pepe ya mfululizo. Tumia kasi na fremu katika mwongozo wa modeli hiyo, kisha uyathibitishe kwa msimbo pau unaojulikana.
Mchakato unaoshikilia bandari wazi hupokea data. Lengo la kibodi halichagui kikomo. Programu nyingine ambayo tayari imefungua bandari itazuia ufunguaji wa pili. Kuchopoa skana huondoa bandari. Kuichomeka tena kunaweza kuunda jina jipya, na programu lazima ifungue bandari hiyo tena.
HID dhidi ya mfululizo
| Sifa | Keyboard wedge ya HID | Mfululizo wa USB |
|---|---|---|
| Uwasilishaji wa data | Ingizo la mtindo wa kibodi | Mtiririko wa baiti wa mfululizo |
| Lengo la ingizo linahitajika | Ndiyo. Mibofyo ya vitufe hufuata kidhibiti chenye lengo | Hapana. Baiti huenda kwa mchakato uliofungua bandari |
| Ujumuishaji katika kivinjari | Ingizo la kawaida na matukio ya kibodi | Web Serial pale kivinjari kinapoiunga mkono, au programu nje ya ukurasa |
| Udhibiti wa programu | Umepunguzwa kwa tabia ya kibodi, lengo, na viambishi vya mwisho | Programu husoma mtiririko na kuiweka katika fremu |
| Utambulisho wa kifaa | Haupatikani kutoka kwa matukio ya kawaida ya kibodi | Mfumo wa uendeshaji unaweza kuonyesha jina la bandari. Utambulisho thabiti bado unategemea kiendeshi |
| Usanidi | Mipangilio ya skana, ikiwa ni pamoja na kiambishi cha mwisho na mpangilio wa kibodi | Mipangilio ya skana pamoja na mipangilio ya bandari ya mwenyeji ambayo kifaa hutumia kweli |
| Matumizi ya kawaida | Fomu na uingizaji wa bidhaa wa POS | Ujumuishaji maalum unaomiliki kifaa |
Hivi ni visa vya kawaida. Modeli fulani, mfumo wa uendeshaji, na kiendeshi vinaweza kutofautiana. Skana ya Bluetooth katika hali ya kibodi ya HID hufuata safu ya wedge kwenye tabaka la programu. Bluetooth SPP hufuata safu ya mfululizo.
Jinsi skana za HID zinavyofanya kazi katika programu za wavuti
Uskani wa wedge husasisha kipengele chenye lengo. Herufi zinazochapika huwasha keydown kisha input. Enter na Tab huwasha keydown na haziingizi herufi katika ingizo la kawaida la maandishi. event.key ni "Enter" au "Tab" kwa vitufe hivyo, na mfuatano wa herufi moja kwa herufi inayochapika. event.code hutaja kitufe halisi na kinaweza kubaki vile vile wakati kutofautiana kwa mpangilio wa kibodi kunabadilisha event.key.
Msikilizaji hapa chini huthibitisha sehemu pale tu Enter inapofika. Skana isiyo na kiambishi cha mwisho cha Enter huacha maandishi katika sehemu.
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 = ''
})
Weka lengo kwa #barcode kabla ya uskani. preventDefault() huzuia fomu ya mzazi kuwasilishwa mara ya pili. Ikiwa skana inatuma Tab badala yake, soma thamani katika keydown hiyo na uruhusu kivinjari kihamishe lengo. Ikiwa haitumi chochote kati ya hivyo viwili, wasilisha sehemu kutoka kwa kitufe au kitendo kingine wazi. Kusitisha katika uandikaji ni makadirio tu ya mwisho wa uskani.
Hakuna chochote katika matukio hayo kinachotambua kifaa cha USB. Mtu, makro, au kiigaji kinaweza kutoa mfuatano uleule. Uthibitisho ni wa mzigo. Mtiririko wa kazi wa kivinjari, ikiwa ni pamoja na Tab na ingizo tupu, uko katika Jinsi ya kujaribu skana za msimbo pau katika programu za wavuti.
Jinsi skana za mfululizo zinavyofanya kazi katika programu
Ujumuishaji wa mfululizo hufungua bandari, husoma baiti, huzigawa katika ujumbe, na hushughulikia bandari inapotoweka. Katika eneo-kazi, hiyo ni API ya mfululizo ya mfumo wa uendeshaji au maktaba ya muuzaji. Katika kivinjari, chaguo pekee lililojengwa ndani ni Web Serial API, na katika vivinjari vinavyoitekeleza pekee.
Web Serial inapatikana katika vivinjari vinavyotegemea Chromium. Firefox na Safari haziitoi. Ukurasa lazima uwe muktadha salama, ambayo inamaanisha HTTPS au localhost. requestPort() lazima iendeshwe kutoka kwa ishara ya mtumiaji, na mtumiaji lazima achague bandari katika kidokezo cha kivinjari. Skana ya keyboard wedge haionekani katika orodha hiyo, kwa sababu si kifaa cha mfululizo. Web Serial pia haiwezi kuona bandari ya mfululizo ambayo mfumo wa uendeshaji haujafungua.
Kasi ya baud katika mfano ni mahali pa kuanzia unachobadilisha na thamani ya mwongozo. Kitanzi huchukulia CR au LF kama mwisho wa ujumbe na hutumia jozi ya CRLF kama kimaliziaji kimoja. Ikiwa skana yako inatumia fremu tofauti, mgawanyiko huu si sahihi hata bandari ikiwa wazi.
<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>
Kitanzi cha kusoma huendelea hadi mtiririko uishe au usomaji ushindwe. Kuchopoa skana kwa kawaida hukataa usomaji. releaseLock() na close() huendeshwa katika finally. Bandari zilizoidhinishwa awali kwa chimbuko hili zinaweza kuorodheshwa kwa navigator.serial.getPorts() bila kuonyesha kidokezo tena. Idhini ya kwanza bado inahitaji mtumiaji.
Programu ya eneo-kazi hufuata wazo lilelile kwa API ya mfululizo ya jukwaa: fungua, soma, weka fremu, na ufungue tena baada ya kifaa kurudi. Ukurasa huu haubuni amri za muuzaji. Ikiwa skana inatarajia itifaki ya umiliki, itifaki hiyo iko katika nyaraka za mtengenezaji.
Ipi iliyo bora: HID au mfululizo?
Hakuna hali iliyo bora kwa kila bidhaa. Tumia hali ambayo skana hutoa kweli na hali ambayo programu inaweza kusoma.
Chagua HID wakati
- Programu tayari inakubali ingizo la kibodi katika sehemu yenye lengo.
- Unataka fomu au skrini ya POS ifanye kazi bila msimbo wa kifaa.
- Mtiririko wa kazi unaweza kuhakikisha lengo kabla ya kila uskani.
- Enter au Tab inalingana na jinsi fomu hiyo inavyothibitisha au kusonga mbele.
Fikiria mfululizo wakati
- Uskani lazima ufike wakati lengo liko katika kisanduku cha mazungumzo, kwenye kitufe, au hakuna mahali.
- Baiti za skana lazima zibaki zikitengwa na uandikaji.
- Programu inaweza kufungua bandari, kuweka fremu ya ujumbe, na kupona kifaa kinapochopolewa.
- Mwenyeji anaweza kutoa ruhusa kwa bandari hiyo na hakuna mchakato mwingine unaoihitaji kwa wakati mmoja.
Skana inayohesabiwa kama kibodi pekee haiwezi kubadilishwa kuwa mfululizo katika programu ya mwenyeji. Thibitisha hali katika mwongozo kabla ya kubuni ujumuishaji.
Kubadilisha kati ya HID na mfululizo
Baadhi ya skana hubadilisha hali unaposkani msimbo pau wa usanidi kutoka kwa mwongozo wa mtengenezaji huyo, au unapoandika wasifu kwa zana ya muuzaji. Nyingine zimejengwa kama kiolesura kimoja na hazina cha kubadilisha.
Hakuna msimbo pau wa usanidi unaobadilisha kila chapa. Mfuatano uliochapishwa kwa modeli nyingine unaweza kutofanya chochote, au unaweza kuacha skana katika hali isiyotarajiwa. Baada ya mabadiliko yoyote, angalia kile mfumo wa uendeshaji unaonyesha: kibodi, bandari ya COM, au vyote viwili. Kisha jaribu njia ambayo programu yako hutumia. Mwongozo wa usanidi wa skana ya msimbo pau unaeleza vikundi vya kawaida vya mipangilio. Haubadilishi mwongozo.
Kujaribu skana ya HID
- Unganisha skana na uthibitishe iko katika hali ya keyboard wedge. Kihariri cha maandishi kinapaswa kupokea herufi sehemu katika kihariri hicho inapokuwa na lengo.
- Fungua kipimaji cha ingizo la msimbo pau.
- Bofya Anza jaribio, au bofya eneo la uskani. Linageuka bluu linapokuwa tayari. Ukurasa hauchukui lengo peke yake.
- Skani msimbo pau ambao mzigo wake tayari unaujua.
- Linganisha thamani iliyonasiwa na idadi ya herufi na mzigo huo.
- Soma kiambishi cha mwisho: ENTER, TAB, au Hakuna. Enter na Tab si sehemu ya mfuatano wa msimbo pau.
Kipimaji hurekodi matukio ya kibodi ambayo kivinjari kinaweza kuona. Hakiwezi kusoma bandari ya mfululizo, wala hakiwezi kutambua kifaa cha USB. Wakati pengo la wastani kati ya herufi likiwa chini ya 100 ms, hutoa taarifa ya muda huo. Muda si utambulisho wa maunzi. Kwa kila keydown, ikiwa ni pamoja na key na code, tumia kipimaji cha matukio ya kibodi. Ukaguzi mpana zaidi wa QA uko katika Jinsi ya kujaribu ingizo la skana ya msimbo pau.
Kujaribu skana ya mfululizo
Kipimaji cha ingizo la msimbo pau hakifungui bandari ya COM. Jaribio la mfululizo linahitaji programu inayoweza kufungua bandari ambayo skana hufungua.
- Thibitisha skana iko katika hali ya mfululizo na kwamba mfumo wa uendeshaji unaorodhesha bandari inapounganishwa. Ichomoe na uhakikishe bandari inatoweka.
- Andika jina la bandari. Ni mahususi kwa mfumo wa uendeshaji na linaweza kubadilika katika kuchomeka kunakofuata.
- Fungua bandari kutoka kwa programu inayooana: kituo cha mfululizo, programu yako ya eneo-kazi, au mfano wa Web Serial hapo juu katika kivinjari cha Chromium kwenye HTTPS au localhost.
- Weka kasi ya baud, biti za data, usawa, na biti za kusimamisha mwongozo unapozitaja. Ruka thamani zilizobuniwa.
- Skani msimbo pau unaojulikana.
- Linganisha baiti au maandishi yaliyofumbuliwa na mzigo huo.
- Kagua fremu. Tafuta kiambishi awali, na CR, LF, au CRLF baada ya data, ikiwa tu ndivyo mwongozo ulivyosanidi.
Ikiwa kufungua bandari kunashindwa kwa sababu ina shughuli, funga programu nyingine inayoishikilia. Ikiwa maandishi ni takataka, mipangilio ya laini hailingani na kifaa. Ikiwa bandari haionekani kamwe, skana bado inaweza kuwa katika hali ya kibodi, kiendeshi kinaweza kukosekana, au mtumiaji wa mfumo wa uendeshaji anaweza kutoruhusiwa kufungua vifaa vya mfululizo.
Matatizo ya kawaida
Skana inafanya kazi katika kihariri cha maandishi na si katika programu lengwa. Kifaa kinaandika. Programu lengwa haina lengo, au msikilizaji wa keydown unatupa vitufe. Anza na Skana inafanya kazi katika Notepad lakini si katika POS.
Skana haiandiki katika sehemu yoyote ya maandishi. Inaweza kuwa katika hali ya mfululizo, imezimwa, au haisomi alama. Skana ya hali ya mfululizo haiandiki. Tafuta bandari ya COM kabla ya kutatua sehemu. Skana ya msimbo pau haifanyi kazi hutenganisha skana iliyokufa na kiolesura kisicho sahihi.
Bandari ya mfululizo haipo. Hali ya kibodi haiundi bandari ya COM. Kiendeshi kinachokosekana, kebo inayochaji tu, au skana isiyo na hali ya mfululizo hutoa dalili ileile. Tazama orodha ya vifaa ya mfumo wa uendeshaji unapochomeka skana.
Bandari ya mfululizo tayari inatumika. Mchakato mmoja tu unaweza kuisoma. Funga kituo au nakala nyingine ya programu, kisha uifungue tena.
Mipangilio ya mawasiliano si sahihi. Kasi ya baud, usawa, au biti za kusimamisha zisizolingana huonekana kama herufi za nasibu. Weka thamani kutoka kwa mwongozo wa modeli hiyo, kisha skani tena msimbo unaojulikana.
ENTER au TAB haifiki kamwe. Huo ni mpangilio wa kiambishi cha mwisho cha wedge. Kipimaji cha ingizo hutoa taarifa Hakuna. Angalia Skana ya msimbo pau haina ENTER na mwongozo wa kiambishi cha mwisho uliounganishwa hapo juu. Skana ya mfululizo haitumi kitufe cha Enter. Inaweza kutuma baiti za CR au LF badala yake.
Herufi si sahihi kwenye skana ya wedge. Mpangilio wa kibodi wa skana na mpangilio wa mfumo wa uendeshaji unaweza kutokubaliana. Baiti za mfululizo hazipangwa upya na mpangilio huo. Angalia Mpangilio mbaya wa kibodi wa skana ya msimbo pau.
Kivinjari hakiwezi kufikia skana. Skana ya wedge haitaonekana katika kidokezo cha Web Serial. Firefox na Safari hazina Web Serial API. Ukurasa usio HTTPS au localhost hauwezi kuitumia. Mtumiaji anaweza pia kuondoa kidokezo cha bandari.
Programu hupoteza skana baada ya kuchopolewa. Skana ya wedge hurudi kama kibodi, na uskani unaofuata bado unahitaji lengo. Bandari ya mfululizo huwa haipo hadi programu ifungue bandari mpya. Jina linaweza kutolingana na la awali.
Hali za ujumuishaji
Programu za wavuti
Keyboard wedge inafaa ingizo lenye lengo na matukio ya kawaida ya DOM. Ufikiaji wa mfululizo ndani ya ukurasa unamaanisha Web Serial katika kivinjari kinachoiunga mkono, muktadha salama, na bandari iliyochaguliwa na mtumiaji. Ukurasa ambao lazima uunge mkono Firefox, Safari, na vioski visivyo na msimamizi hauwezi kutegemea Web Serial peke yake. Msaidizi wa karibu anaweza kumiliki bandari ya COM na kusambaza misimbo pau kamili kwa ukurasa. Msaidizi huyo ni programu tofauti. Ukurasa bado haufai kutarajia jaribio la wedge kuliendesha.
Mifumo ya POS
POS inayoweka lengo katika sehemu ya bidhaa na kuthibitisha kwa Enter ni ujumuishaji wa wedge. POS ambayo lazima iskani wakati dirisha la kawaida limefunguliwa, au ambayo lazima ipuuze kibodi, ni ujumuishaji wa mfululizo. Kuzichanganya huleta uskani katika sehemu isiyo sahihi au uskani usiofika kamwe. Linganisha hali ya skana na skrini iliyo kazini kweli.
Programu za eneo-kazi
Programu ya eneo-kazi inaweza kupokea ingizo la wedge katika kidhibiti chochote kilicho na lengo, au inaweza kufungua bandari pepe ya COM na kushikilia kipindi kwa maisha ya mchakato. Umiliki wa bandari, kuunganisha tena, na fremu ni sehemu ya kipindi hicho. Lengo si hivyo.
Uendeshaji otomatiki wa QA
Barcode Scanner Emulator huandika thamani unayochagua katika programu yenye lengo na inaweza kutuma ENTER, TAB, au bila kiambishi cha mwisho. Hiyo inashughulikia kurudi nyuma kwa keyboard wedge: lengo, uthibitisho, na ushughulikiaji wa kiambishi cha mwisho. Haiundi bandari pepe ya COM, haihesabu vifaa vya USB, wala hairudii kasi ya baud na fremu. Majaribio ya mfululizo bado yanahitaji bandari ya mfululizo na kisomaji, au mfano wa jaribio unaoandika fremu ileile ya baiti ambayo programu yako huchanganua.
Programu za kioski
Kioski kinachotumia ingizo la wedge lazima kiweke sehemu ya uskani yenye lengo kupitia visanduku vya mazungumzo, viokoa skrini, na ujumbe wa makosa. Lengo moja likipotea, uskani unaofuata hugonga njia ya mkato au hakuna kitu. Kioski kinachotumia mfululizo kinaweza kusoma bandari bila lengo hilo, na lazima kishikilie ruhusa ya kifaa na kufungue tena bandari baada ya kupotea kwa umeme au kung'olewa kwa kebo.
Barcode Scanner Emulator inafaa wapi
Barcode Scanner Emulator ni programu ya eneo-kazi kwa Windows, macOS, na Linux. Inarudia njia ya kibodi ambayo skana ya wedge hutumia. Unaingiza maandishi, unachagua kuchelewa kwa uandikaji, na unachagua kiambishi cha mwisho cha hakuna, ENTER, au TAB. Njia ya mkato ya jumla huandika maandishi hayo katika programu yenye lengo.
Itumie kuendeleza na kufanya majaribio ya kurudi nyuma ya fomu za mtindo wa HID wakati skana haipo mezani. Iunganishe na kipimaji cha ingizo la msimbo pau ili kuona thamani, vitufe vya kiambishi awali, na kiambishi cha mwisho ambacho kivinjari kilipokea.
Haiigi kifaa cha mfululizo cha USB, bandari pepe ya COM, uhesabuji wa USB, wala ufunguzi wa macho. Tabia hizo bado ni za maunzi, au za mfano wa jaribio la mfululizo unaoudhibiti.