Barcode Scanner Emulator
USB HID ja sarjaviivakoodinlukijat
USB HID -näppäimistökiilan lukija kirjoittaa puretun viivakoodin kohdistettuun sovellukseen. USB-sarjalukija tarjoaa sarjaliitännän, usein virtuaalisena COM-porttina, ja sovelluksen on avattava portti ja luettava tavut. USB on kaapeli ja väylä. HID ja sarja ovat eri tapoja esittää data.
Valitse liitäntä, jonka sovellus oikeasti osaa lukea. Kassakenttä, joka jo ottaa vastaan kirjoitusta, on näppäimistökiilan ongelma. Palvelu, jonka on saatava skannaukset silloin kun mikään tekstikenttä ei ole kohdistettuna, tai jonka on pidettävä lukijan tavut erillään näppäimistöstä, on sarjaongelma. Monet lukijat tarjoavat vain toisen tilan. Jotkin voi vaihtaa. Kyseisen mallin käsikirja on luettelo tiloista, joita voit testata.
HID-näppäimistökiila -opas selittää näppäilyreitin yksityiskohtaisesti. Miten viivakoodinlukijat toimivat käsittelee kaappauksen ja purun. Tämä sivu vertaa kahta isäntäliitäntää ja kumpaankin kuuluvia testejä.
Mikä on USB HID -näppäimistökiila?
USB HID -näppäimistötilassa lukija luetteloi itsensä näppäimistöksi. Käyttöjärjestelmä lataa tavallisen näppäimistöohjaimensa. Purun jälkeen lukija lähettää merkit näppäilyinä sille ohjausobjektille, jolla on näppäimistökohdistus. Verkkolomake, POS-nimikekenttä tai työpöydän tekstikenttä voi ottaa syötteen vastaan ilman lukijakohtaista koodia.
Kohdistus ratkaisee määränpään. Jos tarkoitettu kenttä ei ole kohdistettuna, merkit osuvat toiseen ohjausobjektiin tai katoavat. Lukija ei napsauta eikä siirrä osoitinta.
Määritetty pääte voi seurata tietosisältöä. Enter lähettää monet yhden kentän lomakkeet. Tab siirtää kohdistuksen seuraavaan ohjausobjektiin. Kumpaakaan näppäintä ei ole taattu. Päätevalinnat on kuvattu oppaassa ENTER- ja TAB-päätteet.
Tavalliset näppäintapahtumat eivät sisällä lukijan valmistajaa, sarjanumeroa eivätkä lippua, joka sanoisi näppäinten tulleen lukijasta. WebHID:n toteuttavat selaimet kieltäytyvät yhä näppäimistöliitännöistä, joten sivu ei voi avata kiilalaitetta eikä lukea raakoja HID-raportteja.
Mikä on USB-sarjatila viivakoodinlukijassa?
USB-sarjatilassa lukija ei kirjoita. Se tarjoaa sarjaliitännän USB:n yli. Käyttöjärjestelmä esittää liitännän yleensä virtuaalisena COM-porttina: COM-nimenä Windowsissa, cu- tai tty-laitteena macOS:ssä tai ttyACM- tai ttyUSB-laitteena Linuxissa. Ohjain antaa nimen, ja nimi voi muuttua, kun lukija irrotetaan.
Virtuaalinen COM-portti ei ole fyysinen RS-232-portti. RS-232 on sähköinen liitäntä, jolla on oma liitin ja omat jännitetasot ja jonka tietokone lukee UART:n kautta. USB-sarja käyttää USB-kaapelia. Sovellus avaa silti sarjaportin ja lukee tavuja, mutta johdolla kulkeva signaali on USB. Jotkin tuotteet ovat oikea RS-232-lukija ja USB-sarjasovitin. Toiset toteuttavat USB CDC:n eivätkä puhu RS-232:ta lainkaan. Käsittele käyttöjärjestelmän näyttämää porttia integraatiopisteenä, äläkä oleta sähköisten yksityiskohtien täsmäävän.
Sovellus avaa portin, lukee tavuvirran ja päättää, mistä viesti alkaa ja mihin se päättyy. Tavallinen kehys on viivakooditeksti ja sen jälkeen CR (0x0D), LF (0x0A) tai CR ja sitten LF. Kehystys on laiteasetus, ei USB:n sääntö. Myös etuliitetavu, kuten STX, on mahdollinen. Etuliitteen ja päätteen opas erottaa nämä tavut Enter-näppäimestä, jonka kiilalukija lähettää.
Siirtonopeus, databitti, pariteetti ja stop-bitit merkitsevät oikeassa UART:ssa ja monissa USB-sarjasovittimissa. Väärä nopeus tuottaa roskaa, ei selkeää virhettä. Jotkin USB CDC -virtuaali-COM-laitteet sivuuttavat isännän pyytämän siirtonopeuden ja toimittavat tavut silti. Yhtä asetusta ei ole kaikille virtuaalisille sarjalukijoille. Käytä kyseisen mallin käsikirjan nopeutta ja kehystä ja vahvista ne tunnetulla viivakoodilla.
Prosessi, joka pitää portin auki, vastaanottaa datan. Näppäimistökohdistus ei valitse määränpäätä. Toinen ohjelma, jolla portti on jo auki, estää toisen avauksen. Lukijan irrottaminen poistaa portin. Takaisin kytkeminen voi luoda uuden nimen, ja sovelluksen on avattava se portti uudelleen.
HID ja sarja
| Ominaisuus | HID-näppäimistökiila | USB-sarja |
|---|---|---|
| Datan toimitus | Näppäimistötyylinen syöte | Sarjamuotoinen tavuvirta |
| Syötekohdistus tarvitaan | Kyllä. Näppäilyt seuraavat kohdistettua ohjausobjektia | Ei. Tavut menevät prosessille, joka avasi portin |
| Selainintegraatio | Tavallinen syöte ja näppäintapahtumat | Web Serial selaimissa, jotka tukevat sitä, tai ohjelmisto sivun ulkopuolella |
| Sovelluksen hallinta | Rajoittuu näppäimistön käyttäytymiseen, kohdistukseen ja päätteisiin | Sovellus lukee ja kehystää virran |
| Laitteen tunnistus | Ei saatavilla tavallisista näppäintapahtumista | Käyttöjärjestelmä voi näyttää portin nimen. Vakaa identiteetti riippuu silti ohjaimesta |
| Määritys | Lukijan asetukset, myös pääte ja näppäimistöasettelu | Lukijan asetukset sekä isäntäportin asetukset, joita laite oikeasti käyttää |
| Tyypillinen käyttö | Lomakkeet ja POS-nimikkeiden syöttö | Erilliset integraatiot, jotka omistavat laitteen |
Nämä ovat tavanomaiset tapaukset. Tietty malli, käyttöjärjestelmä ja ohjain voivat poiketa. Bluetooth-lukija HID-näppäimistötilassa seuraa kiilasaraketta sovelluskerroksessa. Bluetooth SPP seuraa sarjasaraketta.
Miten HID-lukijat toimivat verkkosovelluksissa
Kiilaskannaus päivittää kohdistetun elementin. Tulostettavat merkit laukaisevat keydown- ja sitten input-tapahtuman. Enter ja Tab laukaisevat keydown-tapahtuman eivätkä lisää merkkiä tavalliseen tekstikenttään. event.key on "Enter" tai "Tab" näille näppäimille ja yhden merkin merkkijono tulostettavalle merkille. event.code nimeää fyysisen näppäimen ja voi pysyä samana, kun näppäimistöasettelun ristiriita muuttaa event.key-arvoa.
Alla oleva kuuntelija vahvistaa kentän vain, kun Enter saapuu. Lukija ilman Enter-päätettä jättää tekstin kenttään.
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 = ''
})
Kohdista #barcode ennen skannausta. preventDefault() estää ylälomaketta lähettämästä toista kertaa. Jos lukija lähettää Tabin, lue arvo tuossa keydown-tapahtumassa ja anna selaimen siirtää kohdistus. Jos se ei lähetä kumpaakaan, lähetä kenttä painikkeesta tai muusta nimenomaisesta toiminnosta. Tauko kirjoittamisessa on vain arvaus skannauksen päättymisestä.
Mikään noissa tapahtumissa ei tunnista USB-laitetta. Ihminen, makro tai emulaattori voi tuottaa saman jonon. Validointi kuuluu tietosisällölle. Selaimen työnkulku, myös Tab ja tyhjä syöte, on oppaassa Miten viivakoodinlukijoita testataan verkkosovelluksissa.
Miten sarjalukijat toimivat sovelluksissa
Sarjaintegraatio avaa portin, lukee tavut, jakaa ne viesteiksi ja käsittelee portin katoamisen. Työpöydällä se on käyttöjärjestelmän sarja-API tai valmistajan kirjasto. Selaimessa ainoa sisäänrakennettu vaihtoehto on Web Serial API, ja vain selaimissa, jotka toteuttavat sen.
Web Serial on käytettävissä Chromium-pohjaisissa selaimissa. Firefox ja Safari eivät tarjoa sitä. Sivun on oltava turvallinen konteksti, siis HTTPS tai localhost. requestPort() on suoritettava käyttäjän eleestä, ja käyttäjän on valittava portti selaimen kehotteessa. Näppäimistökiilan lukija ei näy luettelossa, koska se ei ole sarjalaite. Web Serial ei myöskään näe sarjaporttia, jota käyttöjärjestelmä ei ole tuonut esiin.
Esimerkin siirtonopeus on lähtökohta, jonka vaihdat käsikirjan arvoon. Silmukka pitää CR:ää tai LF:ää viestin loppuna ja kuluttaa CRLF-parin yhtenä päättäjänä. Jos lukijasi käyttää eri kehystä, tämä jako on väärin silloinkin, kun portti on auki.
<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>
Lukusilmukka jatkuu, kunnes virta päättyy tai luku epäonnistuu. Lukijan irrottaminen hylkää luvun tyypillisesti. releaseLock() ja close() suoritetaan finally-lohkossa. Tälle alkuperälle aiemmin hyväksytyt portit voi luetella kutsulla navigator.serial.getPorts() ilman kehotteen näyttämistä uudelleen. Ensimmäinen hyväksyntä vaatii yhä käyttäjän.
Työpöytäsovellus seuraa samaa ajatusta alustan sarja-API:lla: avaa, lue, kehystä ja avaa uudelleen, kun laite palaa. Tämä sivu ei keksi valmistajan komentoja. Jos lukija odottaa valmistajakohtaista protokollaa, protokolla on valmistajan dokumentaatiossa.
Kumpi on parempi: HID vai sarja?
Kumpikaan tila ei ole parempi joka tuotteelle. Käytä tilaa, jonka lukija oikeasti tarjoaa, ja tilaa, jonka sovellus osaa lukea.
Valitse HID, kun
- Sovellus ottaa jo vastaan näppäimistösyötteen kohdistetussa kentässä.
- Haluat lomakkeen tai POS-näytön toimivan ilman laitekoodia.
- Työnkulku voi taata kohdistuksen ennen jokaista skannausta.
- Enter tai Tab vastaa tapaa, jolla lomake vahvistaa tai etenee.
Harkitse sarjaa, kun
- Skannausten on tultava, kun kohdistus on valintaikkunassa, painikkeessa tai ei missään.
- Lukijan tavujen on pysyttävä erillään kirjoittamisesta.
- Sovellus voi avata portin, kehystää viestit ja toipua, kun laite irrotetaan.
- Isäntä voi myöntää luvan kyseiseen porttiin, eikä mikään muu prosessi tarvitse sitä samaan aikaan.
Lukijaa, joka luetteloi itsensä vain näppäimistöksi, ei voi vaihtaa sarjaksi isännän ohjelmistolla. Vahvista tilat käsikirjasta ennen integraation suunnittelua.
Vaihto HIDin ja sarjan välillä
Jotkin lukijat vaihtavat tilaa, kun skannaat määritysviivakoodin kyseisen valmistajan käsikirjasta tai kun kirjoitat profiilin valmistajan työkalulla. Toiset on rakennettu yhdeksi liitännäksi, eikä niissä ole mitään vaihdettavaa.
Ei ole määritysviivakoodia, joka muuttaisi joka merkin. Toiselle mallille painettu sarja voi olla tehoton tai jättää lukijan odottamattomaan tilaan. Jokaisen muutoksen jälkeen tarkista, mitä käyttöjärjestelmä näyttää: näppäimistön, COM-portin vai molemmat. Testaa sitten polku, jota sovelluksesi käyttää. Määritysopas kuvaa tavanomaiset asetusryhmät. Se ei korvaa käsikirjaa.
HID-lukijan testaus
- Kytke lukija ja varmista, että se on näppäimistökiilatilassa. Tekstieditorin pitäisi vastaanottaa merkit, kun kenttä siinä editorissa on kohdistettuna.
- Avaa viivakoodisyötteen testaaja.
- Napsauta Aloita testi tai napsauta skannausaluetta. Se muuttuu siniseksi, kun se on valmis. Sivu ei ota kohdistusta itse.
- Skannaa viivakoodi, jonka tietosisällön jo tiedät.
- Vertaa kaapattua arvoa ja merkkimäärää tuohon tietosisältöön.
- Lue pääte: ENTER, TAB tai Ei mitään. Enter ja Tab eivät kuulu viivakoodimerkkijonoon.
Testaaja kirjaa näppäintapahtumat, jotka selain näkee. Se ei voi lukea sarjaporttia eikä tunnistaa USB-laitetta. Kun merkkien keskimääräinen väli on alle 100 ms, se ilmoittaa tuon ajoituksen. Ajoitus ei ole laitteiston tunnistus. Käytä jokaiseen keydown-tapahtumaan, myös key- ja code-arvoihin, näppäimistötapahtumien testaajaa. Laajempi QA-kierros on oppaassa Miten viivakoodinlukijan syöte testataan.
Sarjalukijan testaus
Viivakoodisyötteen testaaja ei avaa COM-porttia. Sarjatesti tarvitsee ohjelman, joka voi avata lukijan tarjoaman portin.
- Varmista, että lukija on sarjatilassa ja että käyttöjärjestelmä luettelee portin, kun lukija on kytketty. Irrota se ja tarkista, että portti katoaa.
- Kirjaa portin nimi. Se on käyttöjärjestelmäkohtainen ja voi muuttua seuraavassa kytkennässä.
- Avaa portti yhteensopivasta sovelluksesta: sarjapäätteestä, työpöytäsovelluksestasi tai yllä olevasta Web Serial -esimerkistä Chromium-selaimessa HTTPS:ssä tai localhostissa.
- Aseta siirtonopeus, databitti, pariteetti ja stop-bitit, kun käsikirja määrittää ne. Ohita keksityt arvot.
- Skannaa tunnettu viivakoodi.
- Vertaa tavuja tai purettua tekstiä tuohon tietosisältöön.
- Tarkista kehystys. Etsi etuliite sekä CR, LF tai CRLF datan jälkeen vain, jos käsikirja on määrittänyt sen.
Jos portin avaus epäonnistuu, koska portti on varattu, sulje toinen ohjelma, joka pitää sen. Jos teksti on roskaa, linja-asetukset eivät vastaa laitetta. Jos portti ei koskaan ilmesty, lukija voi yhä olla näppäimistötilassa, ohjain voi puuttua tai käyttöjärjestelmän käyttäjällä ei ehkä ole lupaa avata sarjalaitteita.
Tavalliset ongelmat
Lukija toimii tekstieditorissa mutta ei kohdesovelluksessa. Laite kirjoittaa. Kohteella ei ole kohdistusta, tai keydown-kuuntelija hylkää näppäimet. Aloita oppaasta Lukija toimii Notepadissa mutta ei POS-järjestelmässä.
Lukija ei kirjoita mihinkään tekstikenttään. Se voi olla sarjatilassa, virrattomana tai se ei lue symbolia. Sarjatilan lukija ei kirjoita. Etsi COM-portti ennen kuin jäljität kenttää. Viivakoodinlukija ei toimi erottaa kuolleen lukijan väärästä liitännästä.
Sarjaportti puuttuu. Näppäimistötila ei luo COM-porttia. Puuttuva ohjain, vain lataava kaapeli tai lukija ilman sarjatilaa tuottaa saman oireen. Seuraa käyttöjärjestelmän laiteluetteloa, kun kytket lukijan.
Sarjaportti on jo käytössä. Vain yksi prosessi voi lukea sen. Sulje pääte tai sovelluksen toinen kopio ja avaa portti sitten uudelleen.
Tiedonsiirtoasetukset ovat väärin. Yhteensopimaton siirtonopeus, pariteetti tai stop-bitit näyttävät satunnaisilta merkeiltä. Aseta arvot kyseisen mallin käsikirjasta ja skannaa tunnettu koodi uudelleen.
ENTER tai TAB ei koskaan saavu. Se on kiilan pääteasetus. Syötetestaaja ilmoittaa Ei mitään. Katso Viivakoodinlukijalta puuttuu ENTER ja yllä linkitetty pääteopas. Sarjalukija ei lähetä Enter-näppäintä. Se voi lähettää CR- tai LF-tavuja sen sijaan.
Merkit ovat väärin kiilalukijassa. Lukijan näppäimistöasettelu ja käyttöjärjestelmän asettelu voivat olla ristiriidassa. Sarjatavuja ei muunneta tuon asettelun mukaan. Katso Viivakoodinlukijan väärä näppäimistöasettelu.
Selain ei pääse lukijaan. Kiilalukija ei näy Web Serial -kehotteessa. Firefoxissa ja Safarissa ei ole Web Serial API:a. Sivu, joka ei ole HTTPS tai localhost, ei voi käyttää sitä. Käyttäjä voi myös hylätä porttikehotteen.
Sovellus kadottaa lukijan irrotuksen jälkeen. Kiilalukija palaa näppäimistönä, ja seuraava skannaus vaatii yhä kohdistuksen. Sarjaportti on poissa, kunnes sovellus avaa uuden portin. Nimi ei välttämättä vastaa aiempaa.
Integraatiotilanteet
Verkkosovellukset
Näppäimistökiila sopii kohdistettuun syötteeseen ja tavallisiin DOM-tapahtumiin. Sarjakäyttö sivun sisällä tarkoittaa Web Serialia tukevassa selaimessa, turvallista kontekstia ja käyttäjän valitsemaa porttia. Sivu, jonka on tuettava Firefoxia, Safaria ja valvomattomia kioskeja, ei voi nojata pelkkään Web Serialiin. Paikallinen apuohjelma voi omistaa COM-portin ja välittää valmiit viivakoodit sivulle. Apuohjelma on erillinen ohjelmisto. Sivun ei silti pidä odottaa, että kiilatesti harjoittaa sitä.
POS-järjestelmät
POS, joka asettaa kohdistuksen nimikekenttään ja vahvistaa Enterillä, on kiilaintegraatio. POS, jonka on skannattava modaalin ollessa auki tai joka ei saa huomioida näppäimistöä, on sarjaintegraatio. Niiden sekoittaminen tuottaa skannauksia väärään kenttään tai skannauksia, jotka eivät koskaan saavu. Sovita lukijan tila näyttöön, joka on oikeasti käytössä.
Työpöytäsovellukset
Työpöytäsovellus voi ottaa kiilasyötteen vastaan siinä ohjausobjektissa, joka on kohdistettuna, tai avata virtuaalisen COM-portin ja pitää istunnon prosessin eliniän. Portin omistus, uudelleenkytkentä ja kehystys kuuluvat siihen istuntoon. Kohdistus ei.
QA-automaatio
Barcode Scanner Emulator kirjoittaa valitsemasi arvon kohdistettuun sovellukseen ja voi lähettää ENTER-päätteen, TAB-päätteen tai ei päätettä. Se kattaa näppäimistökiilan regressiot: kohdistuksen, validoinnin ja päätteen käsittelyn. Se ei luo virtuaalista COM-porttia, ei luetteloi USB-laitteita eikä toista siirtonopeutta ja kehystystä. Sarjatestit tarvitsevat yhä sarjaportin ja lukijan tai testikaksoiskappaleen, joka kirjoittaa saman tavukehyksen, jonka sovelluksesi jäsentää.
Kioskisovellukset
Kioskin, joka käyttää kiilasyötettä, on pidettävä skannauskenttä kohdistettuna valintaikkunoiden, näytönsäästäjien ja virheilmoitusten yli. Yksi kadonnut kohdistus, ja seuraava skannaus osuu pikanäppäimeen tai ei mihinkään. Sarjaa käyttävä kioski voi lukea portin ilman tuota kohdistusta, ja sen on pidettävä laitteen lupa ja avattava portti uudelleen sähkökatkon tai kaapelin irrottamisen jälkeen.
Mihin Barcode Scanner Emulator sopii
Barcode Scanner Emulator on työpöytäsovellus Windowsille, macOS:lle ja Linuxille. Se toistaa näppäimistöpolun, jota kiilalukija käyttää. Kirjoitat tekstin, valitset kirjoitusviiveen ja valitset päätteeksi ei mitään, ENTER tai TAB. Yleinen pikanäppäin kirjoittaa tekstin kohdistettuun sovellukseen.
Käytä sitä HID-tyylisten lomakkeiden kehittämiseen ja regressioon, kun lukija ei ole pöydällä. Yhdistä se viivakoodisyötteen testaajaan, jotta näet arvon, etuliitenäppäimet ja päätteen, jonka selain vastaanotti.
Se ei emuloi USB-sarjalaitetta, virtuaalista COM-porttia, USB-luettelointia eikä optista purkua. Nämä käyttäytymiset kuuluvat yhä laitteistolle tai hallitsemallesi sarjatestikaksoiskappaleelle.