Barcode Scanner Emulator
USB HID és soros vonalkódolvasók
Az USB HID billentyűzet-ékeléses olvasó a dekódolt vonalkódot a fókuszban lévő alkalmazásba gépel. Az USB soros olvasó soros felületet kínál, gyakran virtuális COM-portként, és az alkalmazásnak meg kell nyitnia a portot és be kell olvasnia a bájtokat. Az USB a kábel és a busz. A HID és a soros két különböző módja az adatok megjelenítésének.
Azt a felületet válassza, amelyet az alkalmazás ténylegesen olvasni tud. A pénztári mező, amely már fogad gépelést, billentyűzet-ékelési kérdés. Az a szolgáltatás, amelynek akkor is meg kell kapnia a leolvasást, amikor egyetlen szövegmező sincs fókuszban, vagy amelynek el kell választania az olvasó bájtjait a billentyűzettől, soros kérdés. Sok olvasó csak az egyik módot kínálja. Némelyik váltható. Az adott modell kézikönyve a tesztelhető módok listája.
A HID billentyűzet-ékelés útmutató részletesen elmagyarázza a billentyűutat. A Hogyan működnek a vonalkódolvasók? a rögzítést és a dekódolást tárgyalja. Ez az oldal a két gazdafelületet és a hozzájuk tartozó teszteket hasonlítja össze.
Mi az USB HID billentyűzet-ékelés?
USB HID billentyűzet módban az olvasó billentyűzetként számlálja fel magát. Az operációs rendszer a szokásos billentyűzet-illesztőprogramját tölti be. Dekódolás után az olvasó a karaktereket billentyűleütésekként küldi annak a vezérlőnek, amelynek billentyűzetfókusza van. Egy webes űrlap, egy POS-tételmező vagy egy asztali szövegdoboz felveheti ezt a bemenetet olvasóra írt kód nélkül.
A fókusz dönti el a célt. Ha a szánt mező nincs fókuszban, a karakterek másik vezérlőbe kerülnek, vagy elvesznek. Az olvasó nem kattint, és a mutatót sem mozgatja.
Beállított utótag követheti a hasznos adatot. Az Enter sok egymezős űrlapot elküld. A Tab a fókuszt a következő vezérlőre viszi. Egyik billentyű sem garantált. Az utótagválasztást az ENTER és TAB utótagok ismerteti.
A szokásos billentyűzetesemények nem tartalmazzák az olvasó gyártóját, sorozatszámát, sem olyan jelzőt, amely szerint a billentyűk olvasóból jöttek. A WebHID-et megvalósító böngészők a billentyűzetfelületeket továbbra is elutasítják, ezért az oldal nem nyithatja meg az ékeléses eszközt, és nem olvashat nyers HID-jelentéseket.
Mi az USB soros vonalkódolvasó mód?
USB soros módban az olvasó nem gépel. Soros felületet kínál USB-n. Az operációs rendszer ezt a felületet általában virtuális COM-portként mutatja: COM-névként Windowson, cu vagy tty eszközként macOS-en, illetve ttyACM vagy ttyUSB eszközként Linuxon. A nevet az illesztőprogram adja, és megváltozhat, miután az olvasót kihúzzák.
A virtuális COM-port nem fizikai RS-232 port. Az RS-232 elektromos felület, saját csatlakozóval és feszültségszintekkel, amelyet a számítógép UART-on keresztül olvas. Az USB soros USB-kábelt használ. Az alkalmazás továbbra is soros portot nyit és bájtokat olvas, de a vezetéken az USB jelez. Egyes termékek valódi RS-232 olvasó és USB–soros átalakító. Mások USB CDC-t valósítanak meg, és egyáltalán nem beszélnek RS-232-t. Azt a portot kezelje integrációs pontként, amelyet az operációs rendszer mutat, és ne feltételezze, hogy az elektromos részletek egyeznek.
Az alkalmazás megnyitja a portot, olvassa a bájtfolyamot, és eldönti, hol kezdődik és hol végződik egy üzenet. Gyakori keret a vonalkód szövege, majd CR (0x0D), LF (0x0A), vagy CR és utána LF. Ez a keretezés eszközbeállítás, nem az USB szabálya. Előtagbájt, például STX, szintén lehetséges. Az előtag és utótag útmutatója elválasztja ezeket a bájtokat attól az Enter billentyűtől, amelyet az ékeléses olvasó küld.
A baudsebesség, az adatbitek, a paritás és a stopbitek számítanak valódi UART-on és sok USB–soros átalakítón. A hibás sebesség szemetet ad tiszta hiba helyett. Egyes USB CDC virtuális COM-eszközök figyelmen kívül hagyják a gazda által kért baudsebességet, és mégis kézbesítik a bájtokat. Nincs egyetlen beállítás, amely minden virtuális soros olvasóra illik. Használja az adott modell kézikönyvében szereplő sebességet és keretet, majd ismert vonalkóddal erősítse meg.
Az a folyamat kapja az adatot, amely nyitva tartja a portot. A billentyűzetfókusz nem választ célt. Egy másik program, amely már megnyitotta a portot, megakadályozza a második megnyitást. Az olvasó kihúzása eltünteti a portot. A visszacsatlakoztatás új nevet hozhat létre, és az alkalmazásnak újra meg kell nyitnia azt a portot.
HID és soros
| Jellemző | HID billentyűzet-ékelés | USB soros |
|---|---|---|
| Adatkézbesítés | Billentyűzet jellegű bemenet | Soros bájtfolyam |
| Kell bemeneti fókusz | Igen. A leütések a fókuszban lévő vezérlőt követik | Nem. A bájtok ahhoz a folyamathoz mennek, amely megnyitotta a portot |
| Böngészős integráció | Közönséges bemenet és billentyűzetesemények | Web Serial, ahol a böngésző támogatja, vagy a lapon kívüli szoftver |
| Az alkalmazás irányítása | A billentyűzet viselkedésére, a fókuszra és az utótagokra korlátozódik | Az alkalmazás olvassa és keretezi a folyamot |
| Eszközazonosítás | Közönséges billentyűzeteseményekből nem érhető el | Az operációs rendszer mutathat portnevet. A stabil azonosság továbbra is az illesztőprogramtól függ |
| Beállítás | Az olvasó beállításai, beleértve az utótagot és a billentyűzetkiosztást | Az olvasó beállításai, plusz a gazdaport azon beállításai, amelyeket az eszköz ténylegesen használ |
| Jellemző használat | Űrlapok és tételek bevitele a POS-ban | Külön integrációk, amelyek birtokolják az eszközt |
Ezek a szokásos esetek. Egy adott modell, operációs rendszer és illesztőprogram eltérhet. A Bluetooth-olvasó HID billentyűzet módban az alkalmazásrétegen az ékelés oszlopát követi. A Bluetooth SPP a soros oszlopot követi.
Hogyan működnek a HID-olvasók webes alkalmazásokban
Az ékeléses leolvasás frissíti a fókuszban lévő elemet. A nyomtatható karakterek keydown, majd input eseményt váltanak ki. Az Enter és a Tab keydown eseményt vált ki, és nem szúr karaktert egy közönséges szövegmezőbe. Az event.key értéke ezekre a billentyűkre "Enter" vagy "Tab", nyomtatható karakternél pedig egykarakteres karakterlánc. Az event.code a fizikai billentyűt nevezi meg, és változatlan maradhat, amikor a billentyűzetkiosztás eltérése megváltoztatja az event.key értékét.
Az alábbi figyelő csak akkor rögzíti a mezőt, amikor az Enter megérkezik. Az Enter utótag nélküli olvasó a szöveget a mezőben hagyja.
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 = ''
})
A leolvasás előtt fókuszálja a #barcode elemet. A preventDefault() megakadályozza, hogy a szülő űrlap másodszor is elküldődjön. Ha az olvasó helyette Tabot küld, olvassa az értéket abban a keydown eseményben, és hagyja, hogy a böngésző vigye a fókuszt. Ha egyiket sem küldi, küldje el a mezőt egy gombról vagy más kifejezett műveletből. A gépelés szünete csak találgatás a leolvasás végéről.
Ezekben az eseményekben semmi nem azonosítja az USB-eszközt. Egy személy, egy makró vagy az emulátor ugyanazt a sorozatot előállíthatja. Az ellenőrzés a hasznos adatra tartozik. A böngészős munkafolyamat, beleértve a Tabot és az üres bemenetet, a Hogyan tesztelhetők a vonalkódolvasók webes alkalmazásokban útmutatóban van.
Hogyan működnek a soros olvasók az alkalmazásokban
A soros integráció megnyit egy portot, bájtokat olvas, üzenetekre bontja őket, és kezeli a port eltűnését. Az asztalon ez az operációs rendszer soros API-ja vagy a gyártó könyvtára. Böngészőben az egyetlen beépített lehetőség a Web Serial API, és csak azokban a böngészőkben, amelyek megvalósítják.
A Web Serial a Chromium-alapú böngészőkben érhető el. A Firefox és a Safari nem biztosítja. Az oldalnak biztonságos környezetnek kell lennie, vagyis HTTPS-nek vagy localhostnak. A requestPort() hívásnak felhasználói gesztusból kell futnia, és a felhasználónak ki kell választania a portot a böngésző kérdésében. A billentyűzet-ékeléses olvasó nem jelenik meg a listán, mert nem soros eszköz. A Web Serial azt a soros portot sem látja, amelyet az operációs rendszer nem tett láthatóvá.
A példában szereplő baudsebesség kiindulópont, amelyet a kézikönyv értékére cserél. A ciklus a CR-t vagy az LF-et az üzenet végének tekinti, és a CRLF párost egy lezáróként fogyasztja. Ha az olvasó más keretet használ, ez a bontás akkor is hibás, amikor a port nyitva van.
<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>
Az olvasási ciklus addig fut, amíg a folyam véget nem ér, vagy az olvasás el nem bukik. Az olvasó kihúzása jellemzően elutasítja az olvasást. A releaseLock() és a close() a finally blokkban fut. Az ehhez az eredethez korábban jóváhagyott portok a navigator.serial.getPorts() hívással listázhatók a kérdés újbóli megjelenítése nélkül. Az első jóváhagyáshoz továbbra is kell a felhasználó.
Az asztali alkalmazás ugyanezt az elvet követi a platform soros API-jával: megnyitás, olvasás, keretezés, majd újranyitás, amikor az eszköz visszatér. Ez az oldal nem talál ki gyártói parancsokat. Ha az olvasó saját protokollt vár, az a protokoll a gyártó dokumentációjában van.
Melyik a jobb: a HID vagy a soros?
Egyik mód sem jobb minden termékhez. Azt a módot használja, amelyet az olvasó ténylegesen kínál, és azt, amelyet az alkalmazás olvasni tud.
A HID-et válassza, ha
- Az alkalmazás már fogad billentyűzetbemenetet egy fókuszban lévő mezőben.
- Azt szeretné, hogy egy űrlap vagy POS-képernyő eszközkód nélkül működjön.
- A munkafolyamat garantálni tudja a fókuszt minden leolvasás előtt.
- Az Enter vagy a Tab illeszkedik ahhoz, ahogyan az űrlap rögzít vagy továbblép.
A sorost fontolja meg, ha
- A leolvasásoknak akkor kell megérkezniük, amikor a fókusz egy párbeszédablakban, egy gombon vagy sehol sincs.
- Az olvasó bájtjainak a gépeléstől elkülönítve kell maradniuk.
- Az alkalmazás meg tud nyitni egy portot, keretezni tudja az üzeneteket, és helyre tud állni, amikor az eszközt kihúzzák.
- A gazda engedélyt adhat arra a portra, és más folyamatnak nincs rá szüksége ugyanakkor.
Az az olvasó, amely csak billentyűzetként számlálja fel magát, a gazda szoftverében nem kapcsolható sorosra. Erősítse meg a módokat a kézikönyvben, mielőtt megtervezi az integrációt.
Váltás a HID és a soros között
Egyes olvasók módot váltanak, amikor a gyártó kézikönyvéből beolvas egy beállító vonalkódot, vagy amikor a gyártó segédprogramjával profilt ír. Mások egyetlen felületként készültek, és nincs mit váltani.
Nincs olyan beállító vonalkód, amely minden márkát megváltoztat. Egy másik modellhez nyomtatott sorozat tehet semmit, vagy váratlan módban hagyhatja az olvasót. Minden változtatás után nézze meg, mit mutat az operációs rendszer: billentyűzetet, COM-portot vagy mindkettőt. Ezután tesztelje azt az utat, amelyet az alkalmazása használ. A beállítási útmutató a szokásos beállításcsoportokat írja le. Nem helyettesíti a kézikönyvet.
HID-olvasó tesztelése
- Csatlakoztassa az olvasót, és erősítse meg, hogy billentyűzet-ékelés módban van. Egy szövegszerkesztőnek karaktereket kell kapnia, amikor egy mező abban a szerkesztőben fókuszban van.
- Nyissa meg a vonalkódbevitel-tesztelőt.
- Kattintson a Teszt indítása gombra, vagy kattintson a beolvasási területre. Kékre vált, amikor kész. Az oldal magától nem veszi át a fókuszt.
- Olvasson be egy vonalkódot, amelynek hasznos adatát már ismeri.
- Hasonlítsa össze a rögzített értéket és a karakterszámot azzal a hasznos adattal.
- Olvassa az utótagot: ENTER, TAB vagy Nincs. Az Enter és a Tab nem része a vonalkód karakterláncának.
A tesztelő azokat a billentyűzeteseményeket rögzíti, amelyeket a böngésző lát. Soros portot nem tud olvasni, és az USB-eszközt sem tudja azonosítani. Ha a karakterek közötti átlagos rés 100 ms alatt van, jelzi ezt az időzítést. Az időzítés nem hardverazonosítás. Minden keydown eseményhez, beleértve a key és a code értékét, használja a billentyűzetesemény-tesztelőt. Szélesebb QA-áttekintés a A vonalkódolvasó bemenetének tesztelése útmutatóban van.
Soros olvasó tesztelése
A vonalkódbevitel-tesztelő nem nyit COM-portot. A soros teszthez olyan program kell, amely meg tudja nyitni az olvasó által kínált portot.
- Erősítse meg, hogy az olvasó soros módban van, és hogy az operációs rendszer listáz egy portot, amikor csatlakoztatva van. Húzza ki, és ellenőrizze, hogy a port eltűnik.
- Jegyezze fel a port nevét. Operációs rendszerhez kötött, és a következő csatlakoztatáskor megváltozhat.
- Nyissa meg a portot kompatibilis alkalmazásból: soros terminálból, az asztali alkalmazásából, vagy a fenti Web Serial példából egy Chromium-böngészőben, HTTPS-en vagy localhoston.
- Állítsa be a baudsebességet, az adatbiteket, a paritást és a stopbiteket, ha a kézikönyv megadja őket. A kitalált értékeket hagyja ki.
- Olvasson be egy ismert vonalkódot.
- Hasonlítsa össze a bájtokat vagy a dekódolt szöveget azzal a hasznos adattal.
- Ellenőrizze a keretezést. Keressen előtagot, valamint CR-t, LF-et vagy CRLF-et az adat után, csak ha a kézikönyv ezt állította be.
Ha a port megnyitása azért hiúsul meg, mert foglalt, zárja be a másik programot, amely tartja. Ha a szöveg szemét, a vonalbeállítások nem illenek az eszközhöz. Ha a port sosem jelenik meg, az olvasó még billentyűzet módban lehet, hiányozhat az illesztőprogram, vagy az operációs rendszer felhasználója nem nyithat soros eszközöket.
Gyakori problémák
Az olvasó a szövegszerkesztőben működik, a célalkalmazásban nem. Az eszköz gépel. A célnak nincs fókusza, vagy egy keydown figyelő eldobja a billentyűket. Kezdje itt: Az olvasó Notepadben működik, POS-ban nem.
Az olvasó egyetlen szövegmezőbe sem gépel. Lehet soros módban, kikapcsolva, vagy nem olvassa a jelet. A soros módú olvasó nem gépel. Keressen COM-portot, mielőtt a mezőt vizsgálja. A vonalkódolvasó nem működik elválasztja a halott olvasót a rossz felülettől.
A soros port hiányzik. A billentyűzet mód nem hoz létre COM-portot. Hiányzó illesztőprogram, csak töltő kábel vagy soros mód nélküli olvasó ugyanazt a tünetet adja. Figyelje az operációs rendszer eszközlistáját, miközben csatlakoztatja az olvasót.
A soros port már használatban van. Csak egy folyamat olvashatja. Zárja be a terminált vagy az alkalmazás másik példányát, majd nyissa meg újra.
A kommunikációs beállítások hibásak. Az eltérő baud, paritás vagy stopbit véletlenszerű karaktereknek látszik. Állítsa be az értékeket az adott modell kézikönyvéből, majd olvasson be újra egy ismert kódot.
Az ENTER vagy a TAB sosem érkezik meg. Ez az ékelés utótagbeállítása. A beviteltesztelő Nincs értéket jelez. Lásd: A vonalkódolvasóról hiányzik az ENTER és a fent hivatkozott utótagútmutató. A soros olvasó nem küldi az Enter billentyűt. Helyette CR- vagy LF-bájtokat küldhet.
A karakterek hibásak egy ékeléses olvasón. Az olvasó billentyűzetkiosztása és az operációs rendszer kiosztása eltérhet. A soros bájtokat ez a kiosztás nem képezi újra. Lásd: A vonalkódolvasó billentyűzetkiosztása hibás.
A böngésző nem fér hozzá az olvasóhoz. Az ékeléses olvasó nem jelenik meg a Web Serial kérdésében. A Firefoxnak és a Safarinak nincs Web Serial API-ja. A nem HTTPS vagy localhost oldal nem használhatja. A felhasználó a portkérdést is elutasíthatja.
Az alkalmazás elveszíti az olvasót a kihúzás után. Az ékeléses olvasó billentyűzetként tér vissza, és a következő leolvasáshoz továbbra is kell a fókusz. A soros port addig nincs meg, amíg az alkalmazás meg nem nyitja az új portot. A név nem feltétlenül egyezik az előzővel.
Integrációs helyzetek
Webes alkalmazások
A billentyűzet-ékelés a fókuszált bemenethez és a közönséges DOM-eseményekhez illik. A lapon belüli soros elérés Web Serialt jelent támogató böngészőben, biztonságos környezetet és a felhasználó által választott portot. Az az oldal, amelynek a Firefoxot, a Safarit és a felügyelet nélküli kioszkokat is támogatnia kell, nem támaszkodhat egyedül a Web Serialra. Egy helyi segéd birtokolhatja a COM-portot, és a kész vonalkódokat továbbíthatja az oldalnak. Ez a segéd külön szoftver. Az oldalnak továbbra sem szabad azt várnia, hogy egy ékelésteszt gyakoroltatja.
POS-rendszerek
Az a POS, amely a tételmezőbe teszi a fókuszt és Enterre rögzít, ékeléses integráció. Az a POS, amelynek nyitott modális ablak mellett kell leolvasnia, vagy amelynek figyelmen kívül kell hagynia a billentyűzetet, soros integráció. A keverésük leolvasást ad a rossz mezőbe, vagy olyan leolvasást, amely sosem érkezik meg. Igazítsa az olvasó módját ahhoz a képernyőhöz, amely ténylegesen szolgálatban van.
Asztali alkalmazások
Az asztali alkalmazás felveheti az ékeléses bemenetet abban a vezérlőben, amely fókuszban van, vagy megnyithatja a virtuális COM-portot, és a folyamat élettartamára munkamenetet tarthat. A port birtoklása, az újrakapcsolódás és a keretezés ehhez a munkamenethez tartozik. A fókusz nem.
QA-automatizálás
A Barcode Scanner Emulator egy Ön által választott értéket gépel a fókuszban lévő alkalmazásba, és küldhet ENTER-t, TAB-ot vagy utótag nélkül. Ez lefedi a billentyűzet-ékelés regresszióit: a fókuszt, az ellenőrzést és az utótag kezelését. Nem hoz létre virtuális COM-portot, nem számlál fel USB-eszközöket, és nem állítja elő a baudot és a keretezést. A soros tesztekhez továbbra is kell soros port és olvasó, vagy egy tesztkettős, amely ugyanazt a bájtkeretet írja, amelyet az alkalmazás értelmez.
Kioszkalkalmazások
Az ékeléses bemenetet használó kioszknak a leolvasó mezőt fókuszban kell tartania a párbeszédablakokon, a képernyővédőkön és a hibaüzeneteken át. Egy elveszett fókusz, és a következő leolvasás parancsikont ér, vagy semmit. A soros kioszk a portot e fókusz nélkül is olvashatja, és meg kell tartania az eszköz engedélyét, valamint újra kell nyitnia a portot áramkimaradás vagy kábelkihúzás után.
Hová illik a Barcode Scanner Emulator
A Barcode Scanner Emulator asztali alkalmazás Windowsra, macOS-re és Linuxra. Azt a billentyűzetutat állítja elő, amelyet az ékeléses olvasó használ. Beírja a szöveget, gépelési késleltetést választ, és utótagnak a nincs, az ENTER vagy a TAB egyikét választja. Egy globális gyorsbillentyű ezt a szöveget a fókuszban lévő alkalmazásba gépel.
Akkor használja HID-jellegű űrlapok fejlesztésére és regressziójára, amikor az olvasó nincs az asztalon. Párosítsa a vonalkódbevitel-tesztelővel, hogy lássa az értéket, az előtagbillentyűket és az utótagot, amelyet a böngésző kapott.
Nem emulál USB soros eszközt, virtuális COM-portot, USB-felsorolást vagy optikai dekódolást. Ezek a viselkedések továbbra is a hardverhez tartoznak, vagy egy Ön által irányított soros tesztkettőshöz.