Pāriet uz saturu

Barcode Scanner Emulator

USB HID un seriālie svītrkodu skeneri

USB HID tastatūras ķīļa skeneris ieraksta atkodēto svītrkodu fokusētajā lietojumprogrammā. USB seriālais skeneris atver seriālo saskarni, bieži kā virtuālo COM portu, un lietojumprogrammai jāatver šis ports un jālasa baiti. USB ir kabelis un kopne. HID un seriālais ir atšķirīgi datu pasniegšanas veidi.

Izvēlieties saskarni, kuru lietojumprogramma patiešām var lasīt. Kases lauks, kas jau pieņem rakstīšanu, ir tastatūras ķīļa uzdevums. Pakalpojums, kam jāsaņem skenējumi, kamēr neviens teksta lauks nav fokusā, vai kam skenera baiti jātur atsevišķi no tastatūras, ir seriālais uzdevums. Daudzi skeneri piedāvā tikai vienu no šiem režīmiem. Dažus var pārslēgt. Šī modeļa rokasgrāmata ir režīmu saraksts, ko varat testēt.

Ceļvedis HID tastatūras ķīlis sīki izskaidro taustiņu spiedienu ceļu. Kā darbojas svītrkodu skeneri? aptver tveršanu un atkodēšanu. Šī lapa salīdzina divas resursdatora saskarnes un testus, kas pieder katrai.

Kas ir USB HID tastatūras ķīļa režīms?

USB HID tastatūras režīmā skeneris uzskaita sevi kā tastatūru. Operētājsistēma ielādē savu parasto tastatūras draiveri. Pēc atkodēšanas skeneris sūta rakstzīmes kā taustiņu spiedienus vadīklai, kurai ir tastatūras fokuss. Tīmekļa veidlapa, POS preces lauks vai darbvirsmas tekstlodziņš var pieņemt šo ievadi bez skenerim paredzēta koda.

Fokuss izlemj mērķi. Ja iecerētais lauks nav fokusā, rakstzīmes nonāk citā vadīklā vai pazūd. Skeneris neklikšķina un nekustina rādītāju.

Konfigurēts piedēklis var sekot kravai. Enter iesniedz daudzas viena lauka veidlapas. Tab pārvieto fokusu uz nākamo vadīklu. Neviens no šiem taustiņiem nav garantēts. Piedēkļa izvēles ir aplūkotas ceļvedī ENTER un TAB piedēkļi svītrkodu skeneros.

Parastie tastatūras notikumi neietver skenera ražotāju, sērijas numuru vai karodziņu, kas teiktu, ka taustiņi nāca no skenera. Pārlūki, kas īsteno WebHID, joprojām atsakās no tastatūras saskarnēm, tāpēc lapa nevar atvērt ķīļa ierīci un lasīt neapstrādātus HID ziņojumus.

Kas ir USB seriālā svītrkodu skenera režīms?

USB seriālajā režīmā skeneris neraksta. Tas atver seriālo saskarni pa USB. Operētājsistēma šo saskarni parasti rāda kā virtuālo COM portu: COM nosaukumu sistēmā Windows, cu vai tty ierīci macOS vai ttyACM vai ttyUSB ierīci Linux. Nosaukumu piešķir draiveris, un tas var mainīties pēc skenera atvienošanas.

Virtuālais COM ports nav fizisks RS-232 ports. RS-232 ir elektriska saskarne ar savu savienotāju un sprieguma līmeņiem, ko dators lasa caur UART. USB seriālais izmanto USB kabeli. Lietojumprogramma joprojām atver seriālo portu un lasa baitus, bet signāls vadā ir USB. Daži izstrādājumi ir īsts RS-232 skeneris kopā ar USB uz seriālo adapteri. Citi īsteno USB CDC un nekad nerunā RS-232. Uztveriet portu, ko rāda operētājsistēma, kā integrācijas punktu un nepieņemiet, ka elektriskās detaļas sakrīt.

Lietojumprogramma atver portu, lasa baitu plūsmu un izlemj, kur ziņojums sākas un beidzas. Parasts rāmis ir svītrkoda teksts, kam seko CR (0x0D), LF (0x0A) vai CR un tad LF. Šī kadrēšana ir ierīces iestatījums, nevis USB noteikums. Iespējams arī priedēkļa baits, piemēram STX. Priedēkļa un piedēkļa ceļvedis atdala šos baitus no Enter taustiņa, ko sūta ķīļa skeneris.

Baudātrums, datu biti, paritāte un stopbiti ir svarīgi īstā UART un daudzos USB uz seriālo adapteros. Nepareizs ātrums dod jucekli, nevis tīru kļūdu. Dažas USB CDC virtuālās COM ierīces ignorē resursdatora pieprasīto baudātrumu un baitus tomēr piegādā. Nav viena iestatījuma, kas derētu katram virtuālajam seriālajam skenerim. Izmantojiet ātrumu un kadrēšanu no šī modeļa rokasgrāmatas, pēc tam apstipriniet tos ar zināmu svītrkodu.

Datus saņem process, kas tur portu atvērtu. Tastatūras fokuss mērķi neizvēlas. Cita programma, kurai ports jau ir atvērts, bloķēs otro atvēršanu. Skenera atvienošana noņem portu. Pieslēdzot to atpakaļ, var rasties jauns nosaukums, un lietojumprogrammai šis ports jāatver vēlreiz.

HID un seriālais

Īpašība HID tastatūras ķīlis USB seriālais
Datu piegāde Tastatūras stila ievade Seriāla baitu plūsma
Nepieciešams ievades fokuss Jā. Taustiņu spiedieni seko fokusētajai vadīklai Nē. Baiti nonāk procesā, kas atvēra portu
Integrācija pārlūkā Parasta ievade un tastatūras notikumi Web Serial tur, kur pārlūks to atbalsta, vai programmatūra ārpus lapas
Lietojumprogrammas vadība Ierobežota ar tastatūras uzvedību, fokusu un piedēkļiem Lietojumprogramma lasa plūsmu un to kadrē
Ierīces identifikācija No parastiem tastatūras notikumiem nav pieejama Operētājsistēma var parādīt porta nosaukumu. Stabila identitāte joprojām ir atkarīga no draivera
Konfigurācija Skenera iestatījumi, tostarp piedēklis un tastatūras izkārtojums Skenera iestatījumi un resursdatora porta iestatījumi, ko ierīce patiešām izmanto
Tipiska lietošana Veidlapas un POS preču ievade Īpašas integrācijas, kas pārvalda ierīci

Tie ir parastie gadījumi. Konkrēts modelis, operētājsistēma un draiveris var atšķirties. Bluetooth skeneris HID tastatūras režīmā lietojumprogrammas slānī seko ķīļa kolonnai. Bluetooth SPP seko seriālajai kolonnai.

Kā HID skeneri darbojas tīmekļa lietojumprogrammās

Ķīļa skenējums atjaunina fokusēto elementu. Drukājamas rakstzīmes izraisa keydown un pēc tam input. Enter un Tab izraisa keydown un neievieto rakstzīmi parastā teksta ievadē. event.key šiem taustiņiem ir "Enter" vai "Tab", bet drukājamai rakstzīmei – vienas rakstzīmes virkne. event.code nosauc fizisko taustiņu un var palikt tāds pats, kad tastatūras izkārtojuma neatbilstība maina event.key.

Klausītājs zemāk apstiprina lauku tikai tad, kad pienāk Enter. Skeneris bez Enter piedēkļa atstāj tekstu laukā.

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

Fokusējiet #barcode pirms skenēšanas. preventDefault() neļauj vecāka veidlapai iesniegties otrreiz. Ja skeneris sūta Tab, nolasiet vērtību šajā keydown un ļaujiet pārlūkam pārvietot fokusu. Ja tas nesūta nevienu, iesniedziet lauku no pogas vai citas skaidras darbības. Pauze rakstīšanā ir tikai heiristika skenējuma beigām.

Šajos notikumos nav nekā, kas identificētu USB ierīci. Cilvēks, makro vai emulators var radīt to pašu secību. Pārbaude pieder kravai. Pārlūka darbplūsma, tostarp Tab un tukša ievade, ir ceļvedī Kā testēt svītrkodu skenerus tīmekļa lietojumprogrammās.

Kā seriālie skeneri darbojas lietojumprogrammās

Seriālā integrācija atver portu, lasa baitus, sadala tos ziņojumos un tiek galā ar porta pazušanu. Darbvirsmā tā ir operētājsistēmas seriālā API vai ražotāja bibliotēka. Pārlūkā vienīgā iebūvētā iespēja ir Web Serial API, un tikai pārlūkos, kas to īsteno.

Web Serial ir pieejams pārlūkos, kuru pamatā ir Chromium. Firefox un Safari to nepiedāvā. Lapai jābūt drošā kontekstā, kas nozīmē HTTPS vai localhost. requestPort() jādarbojas no lietotāja žesta, un lietotājam ports jāizvēlas pārlūka uzvednē. Tastatūras ķīļa skeneris šajā sarakstā neparādās, jo tā nav seriāla ierīce. Web Serial arī neredz seriālo portu, ko operētājsistēma nav atvērusi.

Baudātrums piemērā ir sākumpunkts, ko aizstājat ar rokasgrāmatas vērtību. Cilpa uztver CR vai LF kā ziņojuma beigas un patērē CRLF pāri kā vienu noslēdzēju. Ja jūsu skeneris izmanto citu rāmi, šis sadalījums ir nepareizs pat tad, kad ports ir atvērts.

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

Lasīšanas cilpa darbojas, līdz plūsma beidzas vai lasīšana neizdodas. Skenera atvienošana parasti noraida lasīšanu. releaseLock() un close() darbojas finally. Iepriekš apstiprinātos šīs izcelsmes portus var uzskaitīt ar navigator.serial.getPorts(), vairs nerādot uzvedni. Pirmais apstiprinājums joprojām prasa lietotāju.

Darbvirsmas lietojumprogramma seko tai pašai idejai ar platformas seriālo API: atvērt, lasīt, kadrēt un atvērt no jauna pēc ierīces atgriešanās. Šī lapa neizgudro ražotāja komandas. Ja skeneris sagaida īpašnieka protokolu, šis protokols ir ražotāja dokumentācijā.

Kurš ir labāks: HID vai seriālais?

Neviens režīms nav labāks katram izstrādājumam. Izmantojiet režīmu, ko skeneris patiešām piedāvā, un režīmu, ko lietojumprogramma var lasīt.

Izvēlieties HID, kad

  • Lietojumprogramma jau pieņem tastatūras ievadi fokusētā laukā.
  • Vēlaties, lai veidlapa vai POS ekrāns darbotos bez ierīces koda.
  • Darbplūsma var garantēt fokusu pirms katra skenējuma.
  • Enter vai Tab atbilst tam, kā šī veidlapa apstiprina vai virzās tālāk.

Apsveriet seriālo, kad

  • Skenējumiem jāienāk, kamēr fokuss ir dialoglodziņā, uz pogas vai nekur.
  • Skenera baitiem jāpaliek atsevišķi no rakstīšanas.
  • Lietojumprogramma var atvērt portu, kadrēt ziņojumus un atkopties, kad ierīce tiek atvienota.
  • Resursdators var piešķirt atļauju šim portam, un neviens cits process to vienlaikus neprasa.

Skeneri, kas uzskaita sevi tikai kā tastatūru, resursdatora programmatūrā nevar pārslēgt uz seriālo. Pirms integrācijas projektēšanas apstipriniet režīmus rokasgrāmatā.

Pārslēgšanās starp HID un seriālo

Daži skeneri maina režīmu, kad noskenējat konfigurācijas svītrkodu no šī ražotāja rokasgrāmatas vai kad ar ražotāja utilītu ierakstāt profilu. Citi ir būvēti kā viena saskarne, un tiem nav ko pārslēgt.

Nav konfigurācijas svītrkoda, kas mainītu katru zīmolu. Citam modelim drukāta secība var neko nedarīt vai atstāt skeneri negaidītā režīmā. Pēc jebkuras izmaiņas pārbaudiet, ko rāda operētājsistēma: tastatūru, COM portu vai abus. Pēc tam testējiet ceļu, ko izmanto jūsu lietojumprogramma. Svītrkodu skenera konfigurēšanas ceļvedis apraksta parastās iestatījumu grupas. Tas neaizstāj rokasgrāmatu.

HID skenera testēšana

  1. Pievienojiet skeneri un apstipriniet, ka tas ir tastatūras ķīļa režīmā. Teksta redaktoram jāsaņem rakstzīmes, kad šajā redaktorā lauks ir fokusā.
  2. Atveriet svītrkoda ievades testētāju.
  3. Noklikšķiniet uz Sākt testu vai noklikšķiniet skenēšanas apgabalā. Tas kļūst zils, kad ir gatavs. Lapa pati nepaņem fokusu.
  4. Noskenējiet svītrkodu, kura kravu jau zināt.
  5. Salīdziniet tverto vērtību un rakstzīmju skaitu ar šo kravu.
  6. Izlasiet piedēkli: ENTER, TAB vai Nav. Enter un Tab nav svītrkoda virknes daļa.

Testētājs reģistrē tastatūras notikumus, ko pārlūks var redzēt. Tas nevar lasīt seriālo portu un nevar identificēt USB ierīci. Kad vidējā atstarpe starp rakstzīmēm ir mazāka par 100 ms, tas ziņo šo laiku. Laiks nav aparatūras identifikācija. Katram keydown, ieskaitot key un code, izmantojiet tastatūras notikumu testētāju. Plašāka QA pārbaude ir ceļvedī Kā testēt svītrkodu skenera ievadi.

Seriālā skenera testēšana

Svītrkoda ievades testētājs neatver COM portu. Seriālajam testam vajag programmu, kas var atvērt portu, kuru atver skeneris.

  1. Apstipriniet, ka skeneris ir seriālajā režīmā un ka operētājsistēma uzskaita portu, kad tas ir pievienots. Atvienojiet to un pārbaudiet, ka ports pazūd.
  2. Pierakstiet porta nosaukumu. Tas ir atkarīgs no operētājsistēmas un nākamajā pieslēgšanā var mainīties.
  3. Atveriet portu no saderīgas lietojumprogrammas: seriālā termināļa, savas darbvirsmas lietojumprogrammas vai augstāk esošā Web Serial piemēra Chromium pārlūkā, izmantojot HTTPS vai localhost.
  4. Iestatiet baudātrumu, datu bitus, paritāti un stopbitus, kad rokasgrāmata tos norāda. Izlaidiet izdomātas vērtības.
  5. Noskenējiet zināmu svītrkodu.
  6. Salīdziniet baitus vai atkodēto tekstu ar šo kravu.
  7. Pārbaudiet kadrēšanu. Meklējiet priedēkli un CR, LF vai CRLF pēc datiem tikai tad, ja rokasgrāmata konfigurēja tieši to.

Ja porta atvēršana neizdodas, jo tas ir aizņemts, aizveriet otru programmu, kas to tur. Ja teksts ir juceklis, līnijas iestatījumi neatbilst ierīcei. Ja ports nekad neparādās, skeneris joprojām var būt tastatūras režīmā, var trūkt draivera vai operētājsistēmas lietotājam var nebūt atļauts atvērt seriālās ierīces.

Biežas problēmas

Skeneris darbojas teksta redaktorā, bet ne mērķa lietojumprogrammā. Ierīce raksta. Mērķim nav fokusa, vai keydown klausītājs atmet taustiņus. Sāciet ar Skeneris darbojas piezīmju blokā, bet ne POS.

Skeneris neraksta nevienā teksta laukā. Tas var būt seriālajā režīmā, izslēgts vai nelasa simbolu. Seriālā režīma skeneris neraksta. Pirms lauka atkļūdošanas meklējiet COM portu. Svītrkodu skeneris nedarbojas atdala nedzīvu skeneri no nepareizas saskarnes.

Seriālā porta nav. Tastatūras režīms nerada COM portu. Trūkstošs draiveris, kabelis, kas tikai uzlādē, vai skeneris bez seriālā režīma dod to pašu simptomu. Skatieties operētājsistēmas ierīču sarakstu, kamēr pieslēdzat skeneri.

Seriālais ports jau tiek lietots. To var lasīt tikai viens process. Aizveriet termināli vai otru lietojumprogrammas kopiju un tad atveriet to no jauna.

Sakaru iestatījumi ir nepareizi. Nesakritīgs baudātrums, paritāte vai stopbiti izskatās pēc nejaušām rakstzīmēm. Iestatiet šī modeļa vērtības no rokasgrāmatas un tad vēlreiz noskenējiet zināmu kodu.

ENTER vai TAB nekad nepienāk. Tas ir ķīļa piedēkļa iestatījums. Ievades testētājs ziņo Nav. Skatiet Svītrkodu skenerim trūkst ENTER un augstāk saistīto piedēkļa ceļvedi. Seriālais skeneris nesūta Enter taustiņu. Tas var sūtīt CR vai LF baitus.

Rakstzīmes ķīļa skenerī ir nepareizas. Skenera tastatūras izkārtojums un operētājsistēmas izkārtojums var nesakrist. Seriālos baitus šis izkārtojums nepārkartē. Skatiet Nepareizs svītrkodu skenera tastatūras izkārtojums.

Pārlūks nevar piekļūt skenerim. Ķīļa skeneris neparādīsies Web Serial uzvednē. Firefox un Safari nav Web Serial API. Lapa, kas nav HTTPS vai localhost, to nevar izmantot. Lietotājs var arī noraidīt porta uzvedni.

Lietojumprogramma pazaudē skeneri pēc atvienošanas. Ķīļa skeneris atgriežas kā tastatūra, un nākamajam skenējumam joprojām vajag fokusu. Seriālā porta nav, līdz lietojumprogramma atver jauno portu. Nosaukums var nesakrist ar iepriekšējo.

Integrācijas scenāriji

Tīmekļa lietojumprogrammas

Tastatūras ķīlis der fokusētai ievadei un parastiem DOM notikumiem. Seriālā piekļuve lapas iekšienē nozīmē Web Serial atbalstošā pārlūkā, drošu kontekstu un lietotāja izvēlētu portu. Lapa, kurai jāatbalsta Firefox, Safari un neuzraudzīti kioski, nevar paļauties tikai uz Web Serial. Vietējais palīgs var pārvaldīt COM portu un pārsūtīt pabeigtus svītrkodus lapai. Šis palīgs ir atsevišķa programmatūra. Lapai joprojām nevajadzētu gaidīt, ka ķīļa tests to izpildīs.

POS sistēmas

POS, kas liek fokusu preces laukā un apstiprina ar Enter, ir ķīļa integrācija. POS, kam jāskenē, kamēr modālais logs ir atvērts, vai kam jāignorē tastatūra, ir seriālā integrācija. Tos sajaucot, skenējumi nonāk nepareizā laukā vai nekad nepienāk. Saskaņojiet skenera režīmu ar ekrānu, kas patiešām ir dežūrā.

Darbvirsmas lietojumprogrammas

Darbvirsmas lietojumprogramma var pieņemt ķīļa ievadi tajā vadīklā, kas ir fokusā, vai atvērt virtuālo COM portu un turēt sesiju procesa mūža garumā. Porta īpašums, atkārtota savienošana un kadrēšana ir šīs sesijas daļa. Fokuss nav.

QA automatizācija

Barcode Scanner Emulator ieraksta jūsu izvēlēto vērtību fokusētajā lietojumprogrammā un var sūtīt ENTER, TAB vai nevienu piedēkli. Tas aptver tastatūras ķīļa regresijas: fokusu, pārbaudi un piedēkļa apstrādi. Tas nerada virtuālo COM portu, neuzskaita USB ierīces un neatveido baudātrumu un kadrēšanu. Seriālajiem testiem joprojām vajag seriālo portu un lasītāju vai testa dubultnieku, kas raksta to pašu baitu kadrēšanu, ko jūsu lietojumprogramma analizē.

Kioska lietojumprogrammas

Kioskam, kas izmanto ķīļa ievadi, skenēšanas lauks jātur fokusā pāri dialogiem, ekrānsaudzētājiem un kļūdu ziņojumiem. Viens pazaudēts fokuss, un nākamais skenējums trāpa saīsnei vai nekam. Kiosks, kas izmanto seriālo, var lasīt portu bez šī fokusa, un tam jātur atļauja ierīcei un ports jāatver no jauna pēc strāvas zuduma vai kabeļa izraušanas.

Kur iederas Barcode Scanner Emulator

Barcode Scanner Emulator ir darbvirsmas lietojumprogramma operētājsistēmām Windows, macOS un Linux. Tā atveido tastatūras ceļu, ko izmanto ķīļa skeneris. Ievadāt tekstu, izvēlaties rakstīšanas aizkavi un izvēlaties piedēkli: nav, ENTER vai TAB. Globāls saīsnis ieraksta šo tekstu fokusētajā lietojumprogrammā.

Izmantojiet to, lai izstrādātu un regresijas testētu HID stila veidlapas, kad skenera nav uz galda. Savienojiet to ar svītrkoda ievades testētāju, lai redzētu vērtību, priedēkļa taustiņus un piedēkli, ko saņēma pārlūks.

Tas neemulē USB seriālo ierīci, virtuālo COM portu, USB uzskaiti vai optisko atkodēšanu. Šī uzvedība joprojām pieder aparatūrai vai seriālajam testa dubultniekam, ko jūs kontrolējat.