İçeriğe atla

Barcode Scanner Emulator

USB HID ve Seri Barkod Okuyucular

USB HID keyboard wedge okuyucu, çözümlenen barkodu odaktaki uygulamaya yazar. USB seri okuyucu bir seri arabirim sunar, çoğu zaman sanal bir COM bağlantı noktası olarak, ve uygulamanın bu bağlantı noktasını açıp baytları okuması gerekir. USB kablo ve veri yoludur. HID ve seri, veriyi sunmanın farklı yollarıdır.

Uygulamanın gerçekten okuyabildiği arabirimi seçin. Zaten yazmayı kabul eden bir kasa alanı bir keyboard wedge sorunudur. Hiçbir metin alanı odakta değilken tarama alması gereken ya da okuyucu baytlarını klavyeden ayrı tutması gereken bir hizmet bir seri sorunudur. Birçok okuyucu bu kiplerden yalnızca birini sunar. Bazıları geçiş yapabilir. O modelin kılavuzu, test edebileceğiniz kiplerin listesidir.

HID Keyboard Wedge kılavuzu tuş vuruşu yolunu ayrıntılı açıklar. Barkod Okuyucular Nasıl Çalışır? yakalama ve çözümlemeyi ele alır. Bu sayfa iki ana bilgisayar arabirimini ve her birine düşen testleri karşılaştırır.

USB HID keyboard wedge modu nedir?

USB HID klavye modunda okuyucu klavye olarak numaralanır. İşletim sistemi olağan klavye sürücüsünü yükler. Çözümlemeden sonra okuyucu karakterleri, klavye odağına sahip denetime tuş vuruşu olarak gönderir. Bir web formu, bir POS ürün alanı veya bir masaüstü metin kutusu bu girdiyi okuyucuya özel kod olmadan kabul edebilir.

Hedefi odak belirler. Amaçlanan alan odakta değilse karakterler başka bir denetime düşer ya da kaybolur. Okuyucu tıklamaz ve işaretçiyi hareket ettirmez.

Yapılandırılmış bir sonek yükü izleyebilir. Enter birçok tek alanlı formu gönderir. Tab odağı sonraki denetime taşır. İki tuş da garanti değildir. Sonek seçimleri Barkod Okuyucularda ENTER ve TAB Sonekleri kılavuzunda ele alınır.

Olağan klavye olayları okuyucunun üreticisini, seri numarasını veya tuşların bir okuyucudan geldiğini söyleyen bir bayrak içermez. WebHID uygulayan tarayıcılar klavye arabirimlerini yine reddeder, bu yüzden bir sayfa wedge aygıtını açıp ham HID raporlarını okuyamaz.

USB seri barkod okuyucu modu nedir?

USB seri modda okuyucu yazmaz. USB üzerinden bir seri arabirim sunar. İşletim sistemi bu arabirimi genellikle sanal bir COM bağlantı noktası olarak gösterir: Windows üzerinde bir COM adı, macOS üzerinde bir cu veya tty aygıtı ya da Linux üzerinde bir ttyACM veya ttyUSB aygıtı. Adı sürücü atar ve okuyucu sökülünce değişebilir.

Sanal bir COM bağlantı noktası fiziksel bir RS-232 bağlantı noktası değildir. RS-232, kendine ait konektörü ve gerilim düzeyleri olan, bilgisayarın bir UART üzerinden okuduğu elektriksel bir arabirimdir. USB seri bir USB kablosu kullanır. Uygulama yine bir seri bağlantı noktası açar ve bayt okur, fakat kablo üzerindeki sinyal USB’dir. Bazı ürünler gerçek bir RS-232 okuyucu ile bir USB-seri dönüştürücünün birleşimidir. Diğerleri USB CDC uygular ve hiç RS-232 konuşmaz. İşletim sisteminin gösterdiği bağlantı noktasını bütünleştirme noktası sayın ve elektriksel ayrıntıların uyduğunu varsaymayın.

Uygulama bağlantı noktasını açar, bayt akışını okur ve bir iletinin nerede başlayıp nerede bittiğine karar verir. Yaygın bir çerçeve, barkod metninin ardından CR (0x0D), LF (0x0A) veya önce CR sonra LF gelmesidir. Bu çerçeveleme bir aygıt ayarıdır, USB’nin bir kuralı değildir. STX gibi bir önek baytı da olanaklıdır. Barkod Okuyucuda Önek ve Sonek: Tam Kılavuz bu baytları, bir wedge okuyucunun gönderdiği Enter tuşundan ayırır.

Baud hızı, veri bitleri, eşlik ve dur bitleri gerçek bir UART üzerinde ve birçok USB-seri dönüştürücüde önemlidir. Yanlış hız, temiz bir hata yerine anlamsız karakter üretir. Bazı USB CDC sanal COM aygıtları ana bilgisayarın istediği baud hızını yok sayar ve baytları yine iletir. Her sanal seri okuyucuya uyan tek bir ayar yoktur. O modelin kılavuzundaki hızı ve çerçeveyi kullanın, sonra bilinen bir barkodla doğrulayın.

Bağlantı noktasını açık tutan süreç veriyi alır. Klavye odağı hedefi seçmez. Bağlantı noktasını önceden açmış başka bir program ikinci açılışı engeller. Okuyucuyu sökmek bağlantı noktasını kaldırır. Yeniden takmak yeni bir ad oluşturabilir ve uygulamanın o bağlantı noktasını yeniden açması gerekir.

HID ve seri

Özellik HID keyboard wedge USB seri
Veri iletimi Klavye tarzı girdi Seri bayt akışı
Girdi odağı gerekir Evet. Tuş vuruşları odaktaki denetimi izler Hayır. Baytlar bağlantı noktasını açan sürece gider
Tarayıcı bütünleştirmesi Olağan girdi ve klavye olayları Tarayıcının desteklediği yerde Web Serial ya da sayfanın dışındaki yazılım
Uygulama denetimi Klavye davranışı, odak ve soneklerle sınırlıdır Uygulama akışı okur ve çerçeveler
Aygıt kimliği Olağan klavye olaylarından alınamaz İşletim sistemi bir bağlantı noktası adı gösterebilir. Kararlı kimlik yine sürücüye bağlıdır
Yapılandırma Sonek ve klavye düzeni dahil okuyucu ayarları Okuyucu ayarları ve aygıtın gerçekten kullandığı ana bilgisayar bağlantı noktası ayarları
Tipik kullanım Formlar ve POS ürün girişi Aygıtın sahibi olan özel bütünleştirmeler

Bunlar olağan durumlardır. Belirli bir model, işletim sistemi ve sürücü farklı olabilir. HID klavye modundaki bir Bluetooth okuyucu, uygulama katmanında wedge sütununu izler. Bluetooth SPP seri sütunu izler.

HID okuyucular web uygulamalarında nasıl çalışır?

Bir wedge taraması odaktaki öğeyi günceller. Yazdırılabilir karakterler önce keydown, sonra input ateşler. Enter ve Tab keydown ateşler ve normal bir metin girişine karakter eklemez. Bu tuşlar için event.key "Enter" veya "Tab" değeridir; yazdırılabilir bir karakter için tek karakterlik bir dizidir. event.code fiziksel tuşu adlandırır ve bir klavye düzeni uyuşmazlığı event.key değerini değiştirdiğinde aynı kalabilir.

Aşağıdaki dinleyici alanı yalnızca Enter geldiğinde işler. Enter soneki olmayan bir okuyucu metni alanda bırakır.

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

Taramadan önce #barcode alanını odaklayın. preventDefault() üst formun ikinci kez gönderilmesini engeller. Okuyucu bunun yerine Tab gönderirse değeri o keydown içinde okuyun ve tarayıcının odağı taşımasına izin verin. İkisini de göndermezse alanı bir düğmeden veya başka bir açık eylemden gönderin. Yazmadaki bir duraklama, taramanın bittiğine dair yalnızca bir sezgisel tahmindir.

Bu olayların hiçbirinde USB aygıtı tanımlanmaz. Bir kişi, bir makro veya emülatör aynı diziyi üretebilir. Doğrulama yüke aittir. Tab ve boş girdi dahil tarayıcı iş akışı Web Uygulamalarında Barkod Okuyucular Nasıl Test Edilir kılavuzundadır.

Seri okuyucular uygulamalarda nasıl çalışır?

Bir seri bütünleştirme bir bağlantı noktası açar, baytları okur, onları iletilere böler ve bağlantı noktasının kaybolmasını ele alır. Masaüstünde bu, işletim sisteminin seri API’si veya bir üretici kitaplığıdır. Tarayıcıda yerleşik tek seçenek Web Serial API’dir ve yalnızca onu uygulayan tarayıcılarda vardır.

Web Serial, Chromium tabanlı tarayıcılarda kullanılabilir. Firefox ve Safari bunu sunmaz. Sayfa güvenli bir bağlamda olmalıdır; bu HTTPS veya localhost demektir. requestPort() bir kullanıcı hareketinden çalışmalıdır ve kullanıcı bağlantı noktasını tarayıcı isteminde seçmelidir. Keyboard wedge okuyucu bu listede görünmez, çünkü seri bir aygıt değildir. Web Serial, işletim sisteminin açığa çıkarmadığı bir seri bağlantı noktasını da göremez.

Örnekteki baud hızı, kılavuzun değeriyle değiştireceğiniz bir başlangıç noktasıdır. Döngü CR veya LF’yi bir iletinin sonu sayar ve bir CRLF çiftini tek sonlandırıcı olarak tüketir. Okuyucunuz farklı bir çerçeve kullanıyorsa, bağlantı noktası açık olsa bile bu bölme yanlıştır.

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

Okuma döngüsü akış bitene veya okuma başarısız olana kadar sürer. Okuyucuyu sökmek genellikle okumayı reddeder. releaseLock() ve close() finally içinde çalışır. Bu kaynak için daha önce onaylanmış bağlantı noktaları, istem yeniden gösterilmeden navigator.serial.getPorts() ile listelenebilir. İlk onay yine kullanıcıyı gerektirir.

Bir masaüstü uygulaması aynı düşünceyi platformun seri API’si ile izler: aç, oku, çerçevele ve aygıt geri gelince yeniden aç. Bu sayfa üretici komutları uydurmaz. Okuyucu özel bir protokol bekliyorsa o protokol üreticinin belgelerindedir.

Hangisi daha iyi: HID mi, seri mi?

Hiçbir kip her ürün için daha iyi değildir. Okuyucunun gerçekten sunduğu ve uygulamanın okuyabildiği kipi kullanın.

HID’yi şu durumda seçin

  • Uygulama odaktaki bir alanda klavye girdisini zaten kabul ediyordur.
  • Bir formun veya POS ekranının aygıt kodu olmadan çalışmasını istiyorsunuzdur.
  • İş akışı her taramadan önce odağı garanti edebiliyordur.
  • Enter veya Tab, o formun nasıl işlendiğine veya ilerlediğine uyar.

Seriyi şu durumda düşünün

  • Taramalar odak bir iletişim kutusundayken, bir düğmedeyken veya hiçbir yerde değilken gelmelidir.
  • Okuyucu baytları yazmadan ayrı kalmalıdır.
  • Uygulama bir bağlantı noktası açabilir, iletileri çerçeveleyebilir ve aygıt sökülünce toparlanabilir.
  • Ana bilgisayar o bağlantı noktasına izin verebilir ve aynı anda başka hiçbir sürecin ona ihtiyacı yoktur.

Yalnızca klavye olarak numaralanan bir okuyucu, ana bilgisayar üzerindeki yazılımla seriye geçirilemez. Bütünleştirmeyi tasarlamadan önce kipleri kılavuzda doğrulayın.

HID ile seri arasında geçiş

Bazı okuyucular, o üreticinin kılavuzundaki bir yapılandırma barkodunu taradığınızda veya üreticinin aracıyla bir profil yazdığınızda kip değiştirir. Diğerleri tek arabirim olarak üretilmiştir ve geçirilecek bir şey yoktur.

Her markayı değiştiren bir yapılandırma barkodu yoktur. Başka bir model için basılmış bir dizi hiçbir şey yapmayabilir ya da okuyucuyu beklenmedik bir kipte bırakabilir. Her değişiklikten sonra işletim sisteminin ne gösterdiğine bakın: bir klavye, bir COM bağlantı noktası veya ikisi. Sonra uygulamanızın kullandığı yolu test edin. Barkod Okuyucu Yapılandırma Kılavuzu olağan ayar gruplarını anlatır. Kılavuzun yerini tutmaz.

Bir HID okuyucuyu test etmek

  1. Okuyucuyu bağlayın ve keyboard wedge kipinde olduğunu doğrulayın. O düzenleyicide bir alan odaktayken bir metin düzenleyici karakter almalıdır.
  2. Barkod Giriş Test Aracı sayfasını açın.
  3. Start Test düğmesine tıklayın veya tarama alanına tıklayın. Hazır olduğunda maviye döner. Sayfa odağı kendiliğinden almaz.
  4. Yükünü önceden bildiğiniz bir barkod tarayın.
  5. Yakalanan değeri ve karakter sayısını o yükle karşılaştırın.
  6. Soneki okuyun: ENTER, TAB veya None. Enter ve Tab barkod dizisinin parçası değildir.

Test aracı, tarayıcının görebildiği klavye olaylarını kaydeder. Bir seri bağlantı noktası okuyamaz ve USB aygıtını tanıyamaz. Karakterler arasındaki ortalama aralık 100 ms altındaysa bu zamanlamayı bildirir. Zamanlama bir donanım kimliği değildir. key ve code dahil her keydown için Klavye Olayı Test Aracı kullanın. Daha geniş bir QA geçişi Barkod Okuyucu Girişi Nasıl Test Edilir kılavuzundadır.

Bir seri okuyucuyu test etmek

Barkod Giriş Test Aracı bir COM bağlantı noktası açmaz. Seri bir test, okuyucunun sunduğu bağlantı noktasını açabilen bir program gerektirir.

  1. Okuyucunun bir seri kipte olduğunu ve bağlıyken işletim sisteminin bir bağlantı noktası listelediğini doğrulayın. Sökün ve bağlantı noktasının kaybolduğunu kontrol edin.
  2. Bağlantı noktası adını not edin. Ada işletim sistemi özgüdür ve sonraki takışta değişebilir.
  3. Bağlantı noktasını uyumlu bir uygulamadan açın: bir seri terminal, masaüstü uygulamanız veya yukarıdaki Web Serial örneği, HTTPS ya da localhost üzerinde bir Chromium tarayıcıda.
  4. Kılavuz belirtiyorsa baud hızını, veri bitlerini, eşliği ve dur bitlerini ayarlayın. Uydurulmuş değerleri atlayın.
  5. Bilinen bir barkod tarayın.
  6. Baytları veya çözümlenen metni o yükle karşılaştırın.
  7. Çerçeveyi kontrol edin. Kılavuz öyle yapılandırdıysa bir önek arayın ve veriden sonra CR, LF veya CRLF arayın.

Bağlantı noktası meşgul olduğu için açılış başarısız olursa onu tutan diğer programı kapatın. Metin anlamsızsa hat ayarları aygıtla uyuşmuyordur. Bağlantı noktası hiç görünmezse okuyucu hâlâ klavye kipinde olabilir, sürücü eksik olabilir veya işletim sistemi kullanıcısının seri aygıt açmasına izin verilmiyor olabilir.

Sık karşılaşılan sorunlar

Okuyucu bir metin düzenleyicide çalışır, hedef uygulamada çalışmaz. Aygıt yazıyordur. Hedefin odağı yoktur veya bir keydown dinleyicisi tuşları atıyordur. Okuyucu Notepad’de Çalışıyor ama POS’ta Çalışmıyor ile başlayın.

Okuyucu hiçbir metin alanına yazmaz. Seri kipte, kapalı veya simgeyi okumuyor olabilir. Seri kipli bir okuyucu yazmaz. Alanı ayıklamadan önce bir COM bağlantı noktası arayın. Barkod Okuyucu Çalışmıyor ölü bir okuyucuyu yanlış arabirimden ayırır.

Seri bağlantı noktası yok. Klavye kipi bir COM bağlantı noktası oluşturmaz. Eksik bir sürücü, yalnızca şarj eden bir kablo veya seri kipi olmayan bir okuyucu aynı belirtiyi verir. Okuyucuyu takarken işletim sisteminin aygıt listesini izleyin.

Seri bağlantı noktası zaten kullanımda. Onu yalnızca bir süreç okuyabilir. Terminali veya uygulamanın diğer kopyasını kapatın, sonra yeniden açın.

İletişim ayarları yanlış. Uyuşmayan baud, eşlik veya dur bitleri rastgele karakter gibi görünür. O modelin kılavuzundaki değerleri ayarlayın, sonra bilinen bir kodu yeniden tarayın.

ENTER veya TAB hiç gelmiyor. Bu bir wedge sonek ayarıdır. Giriş test aracı None bildirir. Barkod Okuyucuda ENTER Eksik sayfasına ve yukarıda bağlanan sonek kılavuzuna bakın. Seri bir okuyucu Enter tuşunu göndermez. Bunun yerine CR veya LF baytları gönderebilir.

Wedge okuyucuda karakterler yanlış. Okuyucunun klavye düzeni ile işletim sistemi düzeni uyuşmayabilir. Seri baytlar bu düzen tarafından yeniden eşlenmez. Bkz. Barkod Okuyucuda Yanlış Klavye Düzeni.

Tarayıcı okuyucuya erişemiyor. Wedge okuyucu Web Serial isteminde görünmez. Firefox ve Safari’de Web Serial API yoktur. HTTPS veya localhost olmayan bir sayfa onu kullanamaz. Kullanıcı bağlantı noktası istemini de kapatabilir.

Uygulama, okuyucu sökülünce onu kaybeder. Wedge okuyucu klavye olarak geri gelir ve sonraki tarama yine odak ister. Seri bağlantı noktası, uygulama yeni bağlantı noktasını açana kadar yoktur. Ad bir öncekiyle uyuşmayabilir.

Bütünleştirme senaryoları

Web uygulamaları

Keyboard wedge, odaktaki bir girdiye ve olağan DOM olaylarına uyar. Sayfanın içindeki seri erişim, destekleyen bir tarayıcıda Web Serial, güvenli bir bağlam ve kullanıcının seçtiği bir bağlantı noktası demektir. Firefox, Safari ve gözetimsiz kioskları desteklemesi gereken bir sayfa yalnızca Web Serial’a dayanamaz. Yerel bir yardımcı COM bağlantı noktasının sahibi olup tamamlanmış barkodları sayfaya iletebilir. Bu yardımcı ayrı bir yazılımdır. Sayfa, bir wedge testinin onu çalıştıracağını beklememelidir.

POS sistemleri

Odağı ürün alanına koyan ve Enter ile işleyen bir POS bir wedge bütünleştirmesidir. Bir iletişim penceresi açıkken taraması gereken veya klavyeyi yok sayması gereken bir POS bir seri bütünleştirmedir. İkisini karıştırmak taramaları yanlış alana düşürür veya hiç gelmeyen taramalar üretir. Okuyucu kipini gerçekten görevde olan ekranla eşleştirin.

Masaüstü uygulamaları

Bir masaüstü uygulaması, odağı olan denetimde wedge girdisini kabul edebilir veya sanal COM bağlantı noktasını açıp sürecin ömrü boyunca bir oturum tutabilir. Bağlantı noktası sahipliği, yeniden bağlanma ve çerçeveleme o oturumun parçasıdır. Odak değildir.

QA otomasyonu

Barcode Scanner Emulator seçtiğiniz bir değeri odaktaki uygulamaya yazar ve ENTER, TAB veya sonek yok gönderebilir. Bu, keyboard wedge regresyonlarını kapsar: odak, doğrulama ve sonek işleme. Sanal bir COM bağlantı noktası oluşturmaz, USB aygıtlarını numaralandırmaz veya baud ile çerçevelemeyi yeniden üretmez. Seri testler yine bir seri bağlantı noktası ve bir okuyucu ya da uygulamanızın ayrıştırdığı bayt çerçevesini yazan bir test ikizi gerektirir.

Kiosk uygulamaları

Wedge girdisi kullanan bir kiosk, tarama alanını iletişim kutuları, ekran koruyucular ve hata iletileri boyunca odakta tutmalıdır. Bir kez kaybolan odak, sonraki taramayı bir kısayola veya hiçbir yere düşürür. Seri kullanan bir kiosk bu odak olmadan bağlantı noktasını okuyabilir ve aygıta izni elinde tutup güç kesintisi veya kablo çekilmesinden sonra bağlantı noktasını yeniden açmalıdır.

Barcode Scanner Emulator nereye oturur

Barcode Scanner Emulator, Windows, macOS ve Linux için bir masaüstü uygulamasıdır. Bir wedge okuyucunun kullandığı klavye yolunu yeniden üretir. Metni girersiniz, bir yazma gecikmesi seçersiniz ve yok, ENTER veya TAB soneklerinden birini seçersiniz. Genel bir kısayol bu metni odaktaki uygulamaya yazar.

Okuyucu masada değilken HID tarzı formları geliştirmek ve regresyonunu almak için onu kullanın. Tarayıcının aldığı değeri, önek tuşlarını ve soneki görmek için Barkod Giriş Test Aracı ile eşleştirin.

Bir USB seri aygıtı, sanal bir COM bağlantı noktasını, USB numaralandırmasını veya optik bir çözümlemeyi öykünmez. Bu davranışlar yine donanıma veya sizin denetlediğiniz bir seri test ikizine aittir.