Barcode Scanner Emulator
USB HID jämfört med seriella streckkodsläsare
En läsare med USB HID keyboard wedge skriver den avkodade streckkoden i programmet som har fokus. En USB-seriell läsare exponerar ett seriellt gränssnitt, ofta som en virtuell COM-port, och programmet måste öppna den porten och läsa byten. USB är kabeln och bussen. HID och seriellt är olika sätt att presentera data.
Välj det gränssnitt som programmet faktiskt kan läsa. Ett kassafält som redan tar emot tangenttryckningar är en fråga om keyboard wedge. En tjänst som måste ta emot avläsningar utan att något textfält har fokus, eller som måste hålla läsarens byte åtskilda från tangentbordet, är en seriell fråga. Många läsare erbjuder bara ett av lägena. Vissa kan växla. Handboken för den modellen är listan över lägen du kan testa.
Guiden om HID keyboard wedge förklarar tangentvägen i detalj. Hur fungerar streckkodsläsare tar upp avläsning och avkodning. Den här sidan jämför de två värdgränssnitten och de tester som hör till vart och ett.
Vad är USB HID keyboard wedge?
I USB HID-tangentbordsläge räknas läsaren upp som ett tangentbord. Operativsystemet laddar sin vanliga tangentbordsdrivrutin. Efter en avkodning skickar läsaren tecknen som tangenttryckningar till den kontroll som har tangentbordsfokus. Ett webbformulär, ett artikelfält i en POS eller en textruta på skrivbordet kan ta emot den inmatningen utan läsarspecifik kod.
Fokus avgör vart tecknen hamnar. Om det avsedda fältet inte har fokus landar tecknen i en annan kontroll, eller så försvinner de. Läsaren klickar inte, och den flyttar inte pekaren.
Ett konfigurerat suffix kan följa efter nyttolasten. Enter skickar många formulär med ett enda fält. Tab flyttar fokus till nästa kontroll. Inget av tangenterna är garanterat. Valen av suffix beskrivs i Suffixen ENTER och TAB.
Vanliga tangentbordshändelser innehåller inte läsarens tillverkare, serienummer eller en flagga som säger att tangenterna kom från en läsare. Webbläsare som implementerar WebHID vägrar fortfarande tangentbordsgränssnitt, så en sida kan inte öppna wedge-enheten och läsa råa HID-rapporter.
Vad är ett USB-seriellt läge för streckkodsläsare?
I USB-seriellt läge skriver läsaren inte. Den exponerar ett seriellt gränssnitt över USB. Operativsystemet visar vanligen det gränssnittet som en virtuell COM-port: ett COM-namn i Windows, en cu- eller tty-enhet i macOS, eller en ttyACM- eller ttyUSB-enhet i Linux. Namnet tilldelas av drivrutinen och kan ändras efter att läsaren kopplats ur.
En virtuell COM-port är inte en fysisk RS-232-port. RS-232 är ett elektriskt gränssnitt, med egen kontakt och egna spänningsnivåer, som en dator läser genom en UART. USB-seriellt använder en USB-kabel. Programmet öppnar ändå en seriell port och läser byte, men signaleringen på ledningen är USB. Vissa produkter är en riktig RS-232-läsare plus en USB-till-seriell-adapter. Andra implementerar USB CDC och talar aldrig RS-232. Behandla den port som operativsystemet visar som integrationspunkten, och utgå inte från att de elektriska detaljerna stämmer överens.
Programmet öppnar porten, läser byteströmmen och avgör var ett meddelande börjar och slutar. En vanlig ram är streckkodstexten följd av CR (0x0D), LF (0x0A) eller CR och därefter LF. Den inramningen är en enhetsinställning, inte en regel i USB. En prefixbyte som STX är också möjlig. Guiden om prefix och suffix skiljer de byten från Enter-tangenten som en wedge-läsare skickar.
Baudhastighet, databitar, paritet och stoppbitar spelar roll på en riktig UART och på många USB-till-seriell-adaptrar. Fel hastighet ger skräp i stället för ett tydligt fel. Vissa virtuella COM-enheter med USB CDC struntar i den baudhastighet värden begär och levererar ändå byte. Det finns ingen enda inställning som passar varje virtuell seriell läsare. Använd hastigheten och inramningen i den modellens handbok, och bekräfta dem sedan med en känd streckkod.
Den process som håller porten öppen tar emot data. Tangentbordsfokus väljer inte mottagaren. Ett annat program som redan har porten öppen blockerar ett andra öppningsförsök. När läsaren kopplas ur försvinner porten. När den kopplas in igen kan ett nytt namn skapas, och programmet måste öppna den porten på nytt.
HID jämfört med seriellt
| Egenskap | HID keyboard wedge | USB-seriellt |
|---|---|---|
| Dataleverans | Inmatning i tangentbordsstil | Seriell byteström |
| Kräver inmatningsfokus | Ja. Tangenttryckningarna följer den fokuserade kontrollen | Nej. Byten går till den process som öppnade porten |
| Integrering i webbläsaren | Vanlig inmatning och tangentbordshändelser | Web Serial där webbläsaren stöder det, eller program utanför sidan |
| Programmets kontroll | Begränsad till tangentbordsbeteende, fokus och suffix | Programmet läser och ramar in strömmen |
| Identifiering av enheten | Inte tillgänglig från vanliga tangentbordshändelser | Operativsystemet kan visa ett portnamn. Stabil identitet beror ändå på drivrutinen |
| Konfiguration | Läsarinställningar, inklusive suffix och tangentbordslayout | Läsarinställningar plus de värdportinställningar som enheten faktiskt använder |
| Typisk användning | Formulär och artikelinmatning i POS | Egna integrationer som äger enheten |
Det här är de vanliga fallen. En given modell, ett operativsystem och en drivrutin kan avvika. En Bluetooth-läsare i HID-tangentbordsläge följer wedge-kolumnen i programlagret. Bluetooth SPP följer den seriella kolumnen.
Hur HID-läsare fungerar i webbprogram
En wedge-avläsning uppdaterar elementet som har fokus. Utskrivbara tecken utlöser keydown och sedan input. Enter och Tab utlöser keydown och infogar inte ett tecken i ett vanligt textfält. event.key är "Enter" eller "Tab" för de tangenterna, och en sträng med ett tecken för ett utskrivbart tecken. event.code namnger den fysiska tangenten och kan vara oförändrad när en felaktig tangentbordslayout ändrar event.key.
Lyssnaren nedan bekräftar fältet bara när Enter kommer. En läsare utan Enter-suffix lämnar texten kvar i fältet.
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 = ''
})
Ge #barcode fokus före avläsningen. preventDefault() hindrar ett överordnat formulär från att skickas en andra gång. Om läsaren skickar Tab i stället, läs värdet i den keydown och låt webbläsaren flytta fokus. Om den inte skickar något av dem, skicka fältet från en knapp eller en annan uttrycklig åtgärd. En paus i skrivandet är bara en gissning om att avläsningen är slut.
Ingenting i de händelserna identifierar USB-enheten. En person, ett makro eller emulatorn kan åstadkomma samma följd. Valideringen hör hemma på nyttolasten. Arbetsflödet i webbläsaren, inklusive Tab och tom inmatning, finns i Så testar du streckkodsläsare i webbprogram.
Hur seriella läsare fungerar i program
En seriell integration öppnar en port, läser byte, delar upp dem i meddelanden och hanterar att porten försvinner. På skrivbordet är det operativsystemets seriella API eller ett bibliotek från tillverkaren. I en webbläsare är det enda inbyggda alternativet Web Serial API, och bara i webbläsare som implementerar det.
Web Serial finns i Chromium-baserade webbläsare. Firefox och Safari tillhandahåller det inte. Sidan måste vara en säker kontext, vilket betyder HTTPS eller localhost. requestPort() måste köras från en användargest, och användaren måste välja porten i webbläsarens fråga. En keyboard wedge-läsare syns inte i den listan, eftersom den inte är en seriell enhet. Web Serial kan inte heller se en seriell port som operativsystemet inte har exponerat.
Baudhastigheten i exemplet är en startpunkt som du byter mot värdet i handboken. Slingan behandlar CR eller LF som slutet på ett meddelande och förbrukar ett CRLF-par som en enda avslutare. Om din läsare använder en annan ram är den här uppdelningen fel även när porten är öppen.
<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>
Lässlingan kör tills strömmen tar slut eller läsningen misslyckas. När läsaren kopplas ur avvisas läsningen vanligen. releaseLock() och close() körs i finally. Portar som redan godkänts för det här ursprunget kan listas med navigator.serial.getPorts() utan att frågan visas igen. Det första godkännandet kräver fortfarande användaren.
Ett skrivbordsprogram följer samma idé med plattformens seriella API: öppna, läs, rama in och öppna på nytt när enheten kommer tillbaka. Den här sidan hittar inte på tillverkarens kommandon. Om läsaren förväntar sig ett proprietärt protokoll står det protokollet i tillverkarens dokumentation.
Vilket är bättre: HID eller seriellt?
Inget läge är bättre för varje produkt. Använd det läge som läsaren faktiskt erbjuder och det läge som programmet kan läsa.
Välj HID när
- Programmet redan tar emot tangentbordsinmatning i ett fält med fokus.
- Du vill att ett formulär eller en POS-skärm ska fungera utan enhetskod.
- Arbetsflödet kan garantera fokus före varje avläsning.
- Enter eller Tab stämmer med hur formuläret bekräftar eller går vidare.
Överväg seriellt när
- Avläsningar måste komma fram medan fokus ligger i en dialog, på en knapp eller ingenstans.
- Läsarens byte måste hållas åtskilda från inskrivning.
- Programmet kan öppna en port, rama in meddelanden och återhämta sig när enheten kopplas ur.
- Värden kan ge behörighet till den porten och ingen annan process behöver den samtidigt.
En läsare som bara räknas upp som tangentbord kan inte växlas till seriellt i programvara på värden. Bekräfta lägena i handboken innan du utformar integrationen.
Växla mellan HID och seriellt
Vissa läsare byter läge när du läser av en konfigurationsstreckkod ur den tillverkarens handbok, eller när du skriver en profil med tillverkarens verktyg. Andra är byggda som ett enda gränssnitt och har inget att växla.
Det finns ingen konfigurationsstreckkod som ändrar varje märke. En sekvens som är tryckt för en annan modell kan göra ingenting, eller lämna läsaren i ett oväntat läge. Efter varje ändring, kontrollera vad operativsystemet visar: ett tangentbord, en COM-port eller båda. Testa sedan den väg som ditt program använder. Konfigurationsguiden beskriver de vanliga inställningsgrupperna. Den ersätter inte handboken.
Testa en HID-läsare
- Anslut läsaren och bekräfta att den är i keyboard wedge-läge. En textredigerare ska ta emot tecken när ett fält i den redigeraren har fokus.
- Öppna streckkodsinmatningstestaren.
- Klicka på Starta test, eller klicka i avläsningsytan. Den blir blå när den är redo. Sidan tar inte fokus av sig själv.
- Läs av en streckkod vars nyttolast du redan känner till.
- Jämför det infångade värdet och antalet tecken med den nyttolasten.
- Läs suffixet: ENTER, TAB eller Ingen. Enter och Tab ingår inte i streckkodssträngen.
Testaren registrerar de tangentbordshändelser som webbläsaren kan se. Den kan inte läsa en seriell port, och den kan inte identifiera USB-enheten. När det genomsnittliga mellanrummet mellan tecken är under 100 ms rapporterar den den tidtagningen. Tidtagningen är inte en identifiering av hårdvaran. För varje keydown, inklusive key och code, använd tangentbordshändelsetestaren. En bredare QA-genomgång finns i Så testar du inmatning från streckkodsläsare.
Testa en seriell läsare
Streckkodsinmatningstestaren öppnar inte en COM-port. Ett seriellt test behöver ett program som kan öppna den port läsaren exponerar.
- Bekräfta att läsaren är i ett seriellt läge och att operativsystemet listar en port när den är ansluten. Koppla ur den och kontrollera att porten försvinner.
- Anteckna portnamnet. Det är specifikt för operativsystemet och kan ändras vid nästa inkoppling.
- Öppna porten från ett kompatibelt program: en seriell terminal, ditt skrivbordsprogram eller Web Serial-exemplet ovan i en Chromium-webbläsare på HTTPS eller localhost.
- Ställ in baudhastighet, databitar, paritet och stoppbitar när handboken anger dem. Hoppa över påhittade värden.
- Läs av en känd streckkod.
- Jämför byten eller den avkodade texten med den nyttolasten.
- Kontrollera inramningen. Leta efter ett prefix, och efter CR, LF eller CRLF efter data, bara om det är vad handboken konfigurerade.
Om porten inte går att öppna för att den är upptagen, stäng det andra programmet som håller den. Om texten är skräp stämmer linjeinställningarna inte med enheten. Om porten aldrig dyker upp kan läsaren fortfarande vara i tangentbordsläge, drivrutinen kan saknas, eller så kanske OS-användaren inte får öppna seriella enheter.
Vanliga problem
Läsaren fungerar i en textredigerare men inte i målprogrammet. Enheten skriver. Målet har inte fokus, eller så kastar en keydown-lyssnare tangenterna. Börja med Läsaren fungerar i Notepad men inte i POS.
Läsaren skriver inte i något textfält. Den kan vara i seriellt läge, avstängd eller så läser den inte symbolen. En läsare i seriellt läge skriver inte. Leta efter en COM-port innan du felsöker fältet. Streckkodsläsaren fungerar inte skiljer en död läsare från fel gränssnitt.
Den seriella porten saknas. Tangentbordsläge skapar ingen COM-port. En saknad drivrutin, en kabel som bara laddar eller en läsare utan seriellt läge ger samma symptom. Titta på enhetslistan i operativsystemet medan du kopplar in läsaren.
Den seriella porten används redan. Bara en process kan läsa den. Stäng terminalen eller den andra kopian av programmet, och öppna sedan porten igen.
Kommunikationsinställningarna är fel. Baud, paritet eller stoppbitar som inte stämmer ser ut som slumpmässiga tecken. Sätt värdena från handboken för den modellen, och läs sedan av en känd kod igen.
ENTER eller TAB kommer aldrig fram. Det är en suffixinställning för wedge. Inmatningstestaren rapporterar Ingen. Se Streckkodsläsaren saknar ENTER och suffixguiden som är länkad ovan. En seriell läsare skickar inte Enter-tangenten. Den kan skicka CR- eller LF-byte i stället.
Tecknen är fel på en wedge-läsare. Läsarens tangentbordslayout och operativsystemets layout kan vara oense. Seriella byte mappas inte om av den layouten. Se Fel tangentbordslayout på streckkodsläsaren.
Webbläsaren kommer inte åt läsaren. En wedge-läsare syns inte i frågan från Web Serial. Firefox och Safari har inget Web Serial API. En sida som inte är HTTPS eller localhost kan inte använda det. Användaren kan också avvisa portfrågan.
Programmet tappar läsaren efter att den kopplats ur. En wedge-läsare kommer tillbaka som ett tangentbord, och nästa avläsning kräver fortfarande fokus. En seriell port är borta tills programmet öppnar den nya porten. Namnet behöver inte stämma med det föregående.
Scenarier för integration
Webbprogram
Keyboard wedge passar ett fokuserat fält och vanliga DOM-händelser. Seriell åtkomst inne på sidan betyder Web Serial i en webbläsare som stöder det, en säker kontext och en port som användaren valt. En sida som måste stödja Firefox, Safari och obemannade kiosker kan inte förlita sig på enbart Web Serial. En lokal hjälpare kan äga COM-porten och vidarebefordra kompletta streckkoder till sidan. Den hjälparen är separat programvara. Sidan ska fortfarande inte förvänta sig att ett wedge-test övar den.
POS-system
En POS som lägger fokus i artikelfältet och bekräftar på Enter är en wedge-integration. En POS som måste läsa av medan en modal är öppen, eller som måste ignorera tangentbordet, är en seriell integration. Att blanda dem ger avläsningar i fel fält eller avläsningar som aldrig kommer fram. Matcha läsarens läge mot den skärm som faktiskt är i tjänst.
Skrivbordsprogram
Ett skrivbordsprogram kan ta emot wedge-inmatning i den kontroll som har fokus, eller öppna den virtuella COM-porten och hålla en session under processens livstid. Portägande, återanslutning och inramning ingår i den sessionen. Fokus gör det inte.
Automatisering för QA
Barcode Scanner Emulator skriver ett värde du väljer i programmet som har fokus och kan skicka ENTER, TAB eller inget suffix. Det täcker regressioner för keyboard wedge: fokus, validering och suffixhantering. Den skapar inte en virtuell COM-port, räknar inte upp USB-enheter och återskapar inte baud och inramning. Seriella tester behöver fortfarande en seriell port och en läsare, eller en testdubblett som skriver samma byteinramning som ditt program tolkar.
Kioskprogram
En kiosk som använder wedge-inmatning måste hålla avläsningsfältet i fokus över dialoger, skärmsläckare och felmeddelanden. Ett förlorat fokus och nästa avläsning träffar en genväg eller ingenting. En kiosk som använder seriellt kan läsa porten utan det fokuset, och den måste behålla behörighet till enheten och öppna porten igen efter strömavbrott eller en utdragen kabel.
Var Barcode Scanner Emulator passar
Barcode Scanner Emulator är ett skrivbordsprogram för Windows, macOS och Linux. Det återskapar den tangentbordsväg som en wedge-läsare använder. Du skriver in texten, väljer en skrivfördröjning och väljer ett suffix som är inget, ENTER eller TAB. En global genväg skriver den texten i programmet som har fokus.
Använd det för att utveckla och regressa formulär i HID-stil när läsaren inte står på skrivbordet. Para ihop det med streckkodsinmatningstestaren för att se värdet, prefixtecknen och suffixet som webbläsaren tog emot.
Det emulerar inte en USB-seriell enhet, en virtuell COM-port, USB-uppräkning eller en optisk avkodning. De beteendena hör fortfarande till hårdvaran, eller till en seriell testdubblett som du styr.