Sari la conținut

Barcode Scanner Emulator

Scanere de coduri de bare USB HID și seriale

Un scaner USB HID în modul pană de tastatură tastează codul de bare decodificat în aplicația focalizată. Un scaner serial USB expune o interfață serială, adesea ca port COM virtual, iar aplicația trebuie să deschidă acel port și să citească octeții. USB este cablul și magistrala. HID și modul serial sunt moduri diferite de a prezenta datele.

Alegeți interfața pe care aplicația o poate citi cu adevărat. Un câmp de casă care acceptă deja tastarea este o problemă de pană de tastatură. Un serviciu care trebuie să primească scanări când niciun câmp de text nu este focalizat, sau care trebuie să țină octeții scanerului separați de tastatură, este o problemă serială. Multe scanere oferă doar unul dintre aceste moduri. Unele pot comuta. Manualul acelui model este lista modurilor pe care le puteți verifica.

Ghidul Pană de tastatură HID explică în detaliu calea apăsărilor. Cum funcționează scanerele de coduri de bare? acoperă captarea și decodificarea. Această pagină compară cele două interfețe de pe calculator și testele care aparțin fiecăreia.

Ce este modul pană de tastatură USB HID?

În modul tastatură USB HID scanerul se enumeră ca tastatură. Sistemul de operare încarcă driverul obișnuit de tastatură. După decodificare, scanerul trimite caracterele ca apăsări către controlul care are focalizarea tastaturii. Un formular web, un câmp de articol din POS sau o casetă de text de pe desktop pot accepta acea introducere fără cod scris special pentru scaner.

Focalizarea decide destinația. Dacă câmpul dorit nu este focalizat, caracterele ajung într-un alt control sau se pierd. Scanerul nu dă clic și nu mută indicatorul.

După conținut poate urma un sufix configurat. Enter trimite multe formulare cu un singur câmp. Tab mută focalizarea la controlul următor. Niciuna dintre aceste taste nu este garantată. Alegerea sufixului este tratată în Sufixe ENTER și TAB la scanerele de coduri de bare.

Evenimentele obișnuite de tastatură nu includ producătorul scanerului, numărul de serie sau un indicator care să spună că tastele au venit de la un scaner. Browserele care implementează WebHID refuză în continuare interfețele de tastatură, așa că o pagină nu poate deschide dispozitivul pană și nu poate citi rapoartele HID brute.

Ce este modul serial al unui scaner de coduri de bare USB?

În modul serial USB scanerul nu tastează. Expune o interfață serială prin USB. Sistemul de operare prezintă de obicei acea interfață ca port COM virtual: un nume COM în Windows, un dispozitiv cu sau tty în macOS, ori un dispozitiv ttyACM sau ttyUSB în Linux. Numele este atribuit de driver și se poate schimba după ce scanerul este deconectat.

Un port COM virtual nu este un port fizic RS-232. RS-232 este o interfață electrică, cu conector și niveluri de tensiune proprii, pe care un calculator o citește printr-un UART. Serialul USB folosește un cablu USB. Aplicația tot deschide un port serial și citește octeți, dar semnalul de pe fir este USB. Unele produse sunt un scaner RS-232 real plus un adaptor de la USB la serial. Altele implementează USB CDC și nu vorbesc deloc RS-232. Luați ca punct de integrare portul pe care îl arată sistemul de operare și nu presupuneți că detaliile electrice coincid.

Aplicația deschide portul, citește fluxul de octeți și decide unde începe și unde se termină un mesaj. Un cadru obișnuit este textul codului de bare urmat de CR (0x0D), LF (0x0A) sau CR și apoi LF. Acest cadru este o setare a dispozitivului, nu o regulă a USB. Este posibil și un octet de prefix, cum ar fi STX. Ghidul Prefix și sufix la scanerele de coduri de bare: ghid complet separă acești octeți de tasta Enter pe care o trimite un scaner pană.

Viteza, biții de date, paritatea și biții de stop contează pe un UART real și pe multe adaptoare de la USB la serial. O viteză greșită produce gunoi, nu o eroare curată. Unele dispozitive COM virtuale cu USB CDC ignoră viteza cerută de gazdă și tot livrează octeți. Nu există o singură setare care să se potrivească fiecărui scaner serial virtual. Folosiți viteza și cadrul din manualul acelui model, apoi confirmați-le cu un cod de bare cunoscut.

Procesul care ține portul deschis primește datele. Focalizarea tastaturii nu alege destinatarul. Un alt program care are deja portul deschis va bloca a doua deschidere. Deconectarea scanerului elimină portul. Reconectarea poate crea un nume nou, iar aplicația trebuie să deschidă din nou acel port.

HID și modul serial

Caracteristică Pană de tastatură HID Serial USB
Livrarea datelor Introducere în stil de tastatură Flux serial de octeți
Focalizare cerută Da. Apăsările urmează controlul focalizat Nu. Octeții merg la procesul care a deschis portul
Integrare în browser Introducere obișnuită și evenimente de tastatură Web Serial acolo unde browserul îl oferă, sau software în afara paginii
Control în aplicație Limitat la comportamentul tastaturii, la focalizare și la sufixe Aplicația citește fluxul și îl împarte în mesaje
Identificarea dispozitivului Indisponibilă din evenimentele obișnuite de tastatură Sistemul de operare poate arăta un nume de port. Identitatea stabilă depinde în continuare de driver
Configurare Setările scanerului, inclusiv sufixul și dispunerea tastaturii Setările scanerului plus setările de port de pe gazdă pe care dispozitivul le folosește de fapt
Utilizare tipică Formulare și introducerea articolelor în POS Integrări dedicate care dețin dispozitivul

Acestea sunt cazurile obișnuite. Un model anume, sistemul de operare și driverul pot diferi. Un scaner Bluetooth în modul tastatură HID urmează coloana penei la nivelul aplicației. Bluetooth SPP urmează coloana serială.

Cum lucrează scanerele HID în aplicațiile web

O scanare pană actualizează elementul focalizat. Caracterele tipăribile declanșează keydown și apoi input. Enter și Tab declanșează keydown și nu inserează un caracter într-un câmp de text obișnuit. Pentru acele taste event.key este "Enter" sau "Tab", iar pentru un caracter tipăribil este un șir de un caracter. event.code numește tasta fizică și poate rămâne același când o nepotrivire de dispunere schimbă event.key.

Ascultătorul de mai jos confirmă câmpul numai când sosește Enter. Un scaner fără sufix Enter lasă textul în câmp.

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 = ''
})

Dați focalizare lui #barcode înainte de scanare. preventDefault() împiedică formularul părinte să se trimită a doua oară. Dacă scanerul trimite Tab, citiți valoarea în acel keydown și lăsați browserul să mute focalizarea. Dacă nu trimite nici Enter, nici Tab, trimiteți câmpul dintr-un buton sau dintr-o altă acțiune explicită. O pauză în tastare este doar o euristică pentru sfârșitul unei scanări.

În acele evenimente nu există nimic care să identifice dispozitivul USB. Aceeași secvență poate veni de la o persoană, de la un macro sau de la emulator. Validarea aparține conținutului. Fluxul din browser, inclusiv Tab și introducerea goală, este în Cum se testează scanerele de coduri de bare în aplicațiile web.

Cum lucrează scanerele seriale în aplicații

O integrare serială deschide un port, citește octeți, îi împarte în mesaje și tratează dispariția portului. Pe desktop, acesta este API-ul serial al sistemului de operare sau o bibliotecă a producătorului. Într-un browser, singura opțiune încorporată este Web Serial API, și numai în browserele care o implementează.

Web Serial este disponibil în browserele bazate pe Chromium. Firefox și Safari nu îl oferă. Pagina trebuie să fie un context securizat, adică HTTPS sau localhost. requestPort() trebuie să pornească dintr-un gest al utilizatorului, iar utilizatorul trebuie să aleagă portul în solicitarea browserului. Un scaner pană de tastatură nu apare în acea listă, pentru că nu este un dispozitiv serial. Web Serial nu poate vedea nici un port serial pe care sistemul de operare nu l-a expus.

Viteza din exemplu este un punct de pornire pe care îl înlocuiți cu valoarea din manual. Bucla tratează CR sau LF ca sfârșit de mesaj și consumă o pereche CRLF ca un singur terminator. Dacă scanerul folosește un alt cadru, această împărțire este greșită chiar și când portul este deschis.

<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>

Bucla de citire rulează până când fluxul se termină sau citirea eșuează. Deconectarea scanerului respinge de obicei citirea. releaseLock() și close() rulează în finally. Porturile aprobate anterior pentru această origine pot fi listate cu navigator.serial.getPorts() fără să se arate din nou solicitarea. Prima aprobare tot cere utilizatorul.

O aplicație desktop urmează aceeași idee cu API-ul serial al platformei: deschide, citește, încadrează și redeschide după ce dispozitivul revine. Această pagină nu inventează comenzi de producător. Dacă scanerul așteaptă un protocol propriu, acel protocol este în documentația producătorului.

Care este mai bun: HID sau serial?

Niciun mod nu este mai bun pentru orice produs. Folosiți modul pe care scanerul îl oferă cu adevărat și modul pe care aplicația îl poate citi.

Alegeți HID când

  • Aplicația acceptă deja introducere de la tastatură într-un câmp focalizat.
  • Un formular sau un ecran POS trebuie să funcționeze fără cod pentru dispozitiv.
  • Fluxul poate garanta focalizarea înainte de fiecare scanare.
  • Enter sau Tab corespund felului în care acel formular confirmă valoarea sau trece mai departe.

Luați în calcul serialul când

  • Scanările trebuie să sosească în timp ce focalizarea este într-un dialog, pe un buton sau nicăieri.
  • Octeții scanerului trebuie să rămână separați de tastare.
  • Aplicația poate deschide un port, poate încadra mesajele și se poate recupera când dispozitivul este deconectat.
  • Gazda poate acorda permisiunea pentru acel port și niciun alt proces nu are nevoie de el în același timp.

Un scaner care se enumeră doar ca tastatură nu poate fi trecut pe serial din software pe gazdă. Confirmați modurile în manual înainte să proiectați integrarea.

Comutarea între HID și serial

Unele scanere schimbă modul când scanați un cod de bare de configurare din manualul acelui producător sau când scrieți un profil cu utilitarul producătorului. Altele sunt construite ca o singură interfață și nu au ce comuta.

Nu există un cod de bare de configurare care să schimbe modul la orice marcă. O secvență tipărită pentru un alt model poate să nu facă nimic sau poate lăsa scanerul într-un mod neașteptat. După orice schimbare, verificați ce arată sistemul de operare: o tastatură, un port COM sau ambele. Apoi testați calea pe care o folosește aplicația. Ghid de configurare a scanerului de coduri de bare descrie grupurile obișnuite de setări. Nu înlocuiește manualul modelului.

Testarea unui scaner HID

  1. Conectați scanerul și confirmați că este în modul pană de tastatură. Un editor de text trebuie să primească caractere când un câmp din acel editor este focalizat.
  2. Deschideți testerul de introducere a codurilor de bare.
  3. Faceți clic pe Pornește testul sau faceți clic pe zona de scanare. Devine albastră când este gata. Pagina nu ia focalizarea de una singură.
  4. Scanați un cod de bare al cărui conținut îl cunoașteți deja.
  5. Comparați valoarea captată și numărul de caractere cu acel conținut.
  6. Citiți sufixul: ENTER, TAB sau None. Enter și Tab nu fac parte din șirul codului de bare.

Testerul înregistrează evenimentele de tastatură pe care browserul le poate vedea. Nu poate citi un port serial și nu poate identifica dispozitivul USB. Când intervalul mediu dintre caractere este sub 100 ms, raportează acel timp. Timpul nu este o identificare a hardware-ului. Pentru fiecare keydown, inclusiv key și code, folosiți testerul de evenimente de tastatură. O trecere mai largă este în Cum se testează introducerea de la scanerul de coduri de bare.

Testarea unui scaner serial

Testerul de introducere a codurilor de bare nu deschide un port COM. Un test serial are nevoie de un program care poate deschide portul expus de scaner.

  1. Confirmați că scanerul este într-un mod serial și că sistemul de operare listează un port când scanerul este conectat. Deconectați-l și verificați că portul dispare.
  2. Notați numele portului. Este specific sistemului de operare și se poate schimba la următoarea conectare.
  3. Deschideți portul dintr-o aplicație compatibilă: un terminal serial, aplicația dvs. de desktop sau exemplul Web Serial de mai sus într-un browser bazat pe Chromium, pe HTTPS sau localhost.
  4. Setați viteza, biții de date, paritatea și biții de stop când manualul le precizează. Nu inventați valori care lipsesc din manual.
  5. Scanați un cod de bare cunoscut.
  6. Comparați octeții sau textul decodificat cu acel conținut.
  7. Verificați cadrul. Căutați un prefix și CR, LF sau CRLF după date, numai dacă asta a configurat manualul.

Dacă deschiderea portului eșuează pentru că este ocupat, închideți celălalt program care îl ține. Dacă textul este gunoi, setările liniei nu se potrivesc cu dispozitivul. Dacă portul nu apare niciodată, scanerul poate fi încă în modul tastatură, driverul poate lipsi sau utilizatorul sistemului de operare poate să nu aibă voie să deschidă dispozitive seriale.

Probleme frecvente

Scanerul funcționează într-un editor de text și nu în aplicația țintă. Dispozitivul tastează. Ținta nu are focalizare sau un ascultător keydown aruncă tastele. Începeți cu Scanerul funcționează în Notepad, dar nu în POS.

Scanerul nu tastează în niciun câmp de text. Poate fi în modul serial, oprit sau nu citește simbolul. Un scaner în modul serial nu va tasta. Verificați un port COM înainte să depanați câmpul. Scanerul de coduri de bare nu funcționează separă un scaner mort de interfața greșită.

Portul serial lipsește. Modul tastatură nu creează un port COM. Un driver lipsă, un cablu doar pentru încărcare sau un scaner fără mod serial produc același simptom. Urmăriți lista de dispozitive a sistemului de operare în timp ce conectați scanerul.

Portul serial este deja folosit. Doar un proces îl poate citi. Închideți terminalul sau cealaltă copie a aplicației, apoi deschideți portul din nou.

Setările de comunicație sunt greșite. Viteza, paritatea sau biții de stop nepotriviți arată ca niște caractere aleatorii. Setați valorile din manualul acelui model, apoi scanați din nou un cod cunoscut.

ENTER sau TAB nu sosesc niciodată. Aceasta este o setare de sufix a penei. Testerul de introducere raportează None. Vedeți Scanerului de coduri de bare îi lipsește ENTER și ghidul de sufixe de mai sus. Un scaner serial nu trimite tasta Enter. Poate trimite octeți CR sau LF.

Caracterele sunt greșite la un scaner pană. Dispunerea tastaturii scanerului și dispunerea sistemului de operare pot să nu coincidă. Octeții seriali nu sunt remapați de acea dispunere. Vedeți Dispunere greșită a tastaturii scanerului de coduri de bare.

Browserul nu poate accesa scanerul. Un scaner pană nu va apărea în solicitarea Web Serial. Firefox și Safari nu au Web Serial API. O pagină care nu este HTTPS sau localhost nu îl poate folosi. Utilizatorul poate și închide solicitarea de port.

Aplicația pierde scanerul după deconectare. Un scaner pană revine ca tastatură, iar scanarea următoare tot cere focalizare. Portul serial lipsește până când aplicația deschide noul port. Numele poate să nu coincidă cu cel anterior.

Scenarii de integrare

Aplicații web

Pana de tastatură se potrivește unui câmp focalizat și evenimentelor DOM obișnuite. Accesul serial din interiorul paginii înseamnă Web Serial într-un browser care îl oferă, un context securizat și un port ales de utilizator. O pagină care trebuie să accepte Firefox, Safari și chioșcuri nesupravegheate nu se poate baza doar pe Web Serial. Un ajutor local poate deține portul COM și poate trimite către pagină coduri de bare complete. Acel ajutor este software separat. Un test de pană nu îl exersează.

Sisteme POS

Un POS care pune focalizarea în câmpul de articol și confirmă cu Enter este o integrare pană. Un POS care trebuie să scaneze în timp ce un dialog modal este deschis, sau care trebuie să ignore tastatura, este o integrare serială. Amestecul produce scanări în câmpul greșit sau scanări care nu sosesc. Potriviți modul scanerului cu ecranul care este efectiv de serviciu.

Aplicații desktop

O aplicație desktop poate accepta introducerea penei în controlul focalizat sau poate deschide portul COM virtual și poate ține o sesiune pe durata procesului. Deținerea portului, reconectarea și cadrul fac parte din acea sesiune. Focalizarea nu.

Automatizare QA

Barcode Scanner Emulator tastează o valoare aleasă de dvs. în aplicația focalizată și poate trimite ENTER, TAB sau niciun sufix. Asta acoperă regresiile penei de tastatură: focalizarea, validarea și tratarea sufixului. Nu creează un port COM virtual, nu enumeră dispozitive USB și nu reproduce viteza și cadrul. Testele seriale au în continuare nevoie de un port serial și de un cititor, sau de un dublu de test care scrie același cadru de octeți pe care îl analizează aplicația.

Aplicații de chioșc

Un chioșc care folosește introducerea penei trebuie să țină câmpul de scanare focalizat peste dialoguri, economizoare de ecran și mesaje de eroare. O focalizare pierdută și scanarea următoare nimerește o scurtătură sau nimic. Un chioșc care folosește serialul poate citi portul fără acea focalizare și trebuie să păstreze permisiunea pentru dispozitiv și să redeschidă portul după o pierdere de alimentare sau după smulgerea cablului.

Unde se potrivește Barcode Scanner Emulator

Barcode Scanner Emulator este o aplicație desktop pentru Windows, macOS și Linux. Reproduce calea de tastatură pe care o folosește un scaner pană. Introduceți textul, alegeți o întârziere de tastare și alegeți un sufix: niciunul, ENTER sau TAB. O scurtătură globală tastează acel text în aplicația focalizată.

Folosiți-l ca să dezvoltați formulare în stil HID și să prindeți regresiile lor când scanerul nu este pe birou. Asociați-l cu testerul de introducere a codurilor de bare ca să vedeți valoarea, tastele de prefix și sufixul pe care le-a primit browserul.

Nu emulează un dispozitiv serial USB, un port COM virtual, enumerarea USB sau o decodificare optică. Aceste comportamente aparțin în continuare hardware-ului sau unui dublu de test serial pe care îl controlați.