Към съдържанието

Barcode Scanner Emulator

USB HID и серийни баркод скенери

Баркод скенер USB HID в режим на клавиатурен клин въвежда декодирания баркод в приложението с фокус. Сериен баркод скенер по USB открива сериен интерфейс, често като виртуален порт COM, и приложението трябва да отвори този порт и да прочете байтовете. USB е кабелът и шината. HID и серийният режим са различни начини да се представят данните.

Изберете интерфейса, който приложението наистина може да прочете. Поле на каса, което вече приема писане, е задача за клавиатурен клин. Услуга, която трябва да получава сканирания, когато нито едно текстово поле не е на фокус, или която трябва да държи байтовете на скенера отделно от клавиатурата, е серийна задача. Много скенери предлагат само един от тези режими. Някои могат да се превключат. Ръководството на този модел е списъкът с режимите, които можете да проверите.

Ръководството Клавиатурен клин HID обяснява подробно пътя на натисканията. Как работят баркод скенерите? разглежда заснемането и декодирането. Тази страница сравнява двата интерфейса откъм компютъра и проверките, които принадлежат на всеки от тях.

Какво е режим на клавиатурен клин USB HID?

В режим на клавиатура USB HID скенерът се изброява като клавиатура. Операционната система зарежда обичайния си драйвер за клавиатура. След декодиране скенерът изпраща знаците като натискания на клавиши към контролата, която има фокус на клавиатурата. Уеб формуляр, поле за артикул в POS или текстово поле на работния плот приемат този вход без код, написан специално за скенера.

Фокусът решава къде отиват знаците. Ако предвиденото поле не е на фокус, знаците попадат в друга контрола или се губят. Скенерът не щрака и не мести показалеца.

След полезния товар може да следва настроена наставка. Enter изпраща много формуляри с едно поле. Tab премества фокуса към следващата контрола. Нито един от тези клавиши не е гарантиран. Изборът на наставка е разгледан в Наставки ENTER и TAB при баркод скенери.

Обикновените клавиатурни събития не съдържат производителя на скенера, серийния номер или флаг, че клавишите идват от скенер. Браузърите с WebHID пак отказват интерфейсите за клавиатура, затова страницата не може да отвори устройството в режим на клин и да прочете суровите доклади HID.

Какво е сериен режим на баркод скенер по USB?

В сериен режим по USB скенерът не пише. Той открива сериен интерфейс през USB. Операционната система обикновено показва този интерфейс като виртуален порт COM: име COM в Windows, устройство cu или tty в macOS, или устройство ttyACM или ttyUSB в Linux. Името се дава от драйвера и може да се промени след изваждане на скенера.

Виртуалният порт COM не е физически порт RS-232. RS-232 е електрически интерфейс със собствен конектор и нива на напрежение, който компютърът чете през UART. Серийният USB използва кабел USB. Приложението пак отваря сериен порт и чете байтове, но сигналът по жицата е USB. Едни изделия са истински скенер RS-232 плюс преходник от USB към сериен порт. Други реализират USB CDC и изобщо не говорят RS-232. За точка на интеграция вземете порта, който показва операционната система, и не приемайте, че електрическите подробности съвпадат.

Приложението отваря порта, чете потока от байтове и решава къде съобщението започва и свършва. Обичайна рамка е текстът на баркода, следван от CR (0x0D), LF (0x0A) или първо CR, а после LF. Тази рамка е настройка на устройството, а не правило на USB. Възможен е и байт за представка, например STX. Ръководството Префикс и наставка при баркод скенери: пълно ръководство отделя тези байтове от клавиша Enter, който изпраща скенерът в режим на клин.

Скоростта, битовете за данни, четността и стоп битовете имат значение при истински UART и при много преходници от USB към сериен порт. Грешна скорост дава боклук, а не чиста грешка. Някои виртуални устройства COM с USB CDC пренебрегват скоростта, която хостът иска, и пак доставят байтове. Няма една настройка за всеки виртуален сериен скенер. Вземете скоростта и рамката от ръководството на този модел, после ги потвърдете с познат баркод.

Данните получава процесът, който държи порта отворен. Фокусът на клавиатурата не избира получателя. Друга програма, която вече е отворила порта, ще блокира второ отваряне. Изваждането на скенера премахва порта. Повторното включване може да създаде ново име и приложението трябва да отвори този порт отново.

HID и сериен режим

Възможност Клавиатурен клин HID Сериен USB
Доставяне на данни Въвеждане в стил на клавиатура Сериен поток от байтове
Нужен е фокус на въвеждането Да. Натисканията следват контролата на фокус Не. Байтовете отиват в процеса, който е отворил порта
Връзка с браузъра Обикновено въвеждане и клавиатурни събития Web Serial там, където браузърът го поддържа, или програма извън страницата
Управление в приложението Ограничено до поведението на клавиатурата, фокуса и наставките Приложението чете потока и сглобява съобщения от него
Разпознаване на устройството Недостъпно от обикновени клавиатурни събития Операционната система може да покаже име на порт. Стабилната самоличност пак зависи от драйвера
Настройка Настройки на скенера, включително наставка и подредба на клавиатурата Настройки на скенера плюс онези настройки на порта на хоста, които устройството наистина ползва
Типична употреба Формуляри и въвеждане на артикули в POS Отделни интеграции, които притежават устройството

Това са обичайните случаи. Даден модел, операционна система и драйвер могат да се различават. Скенер с Bluetooth в режим на клавиатура HID на нивото на приложението върви по колоната на клина. Bluetooth SPP върви по серийната колона.

Как скенерите HID работят в уеб приложения

Сканиране с клин обновява елемента на фокус. Печатаемите знаци пускат keydown, а после input. Enter и Tab пускат keydown и не вмъкват знак в обикновено текстово поле. За тези клавиши event.key е "Enter" или "Tab", а за печатаем знак е низ от един знак. event.code назовава физическия клавиш и може да остане същото, когато разминаване в подредбата промени event.key.

Слушателят по-долу потвърждава полето едва когато пристигне Enter. Скенер без наставка Enter оставя текста в полето.

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

Преди сканирането дайте фокус на #barcode. preventDefault() не позволява на родителския формуляр да се изпрати втори път. Ако скенерът изпраща Tab, прочетете стойността в този keydown и оставете браузъра да премести фокуса. Ако не изпраща нито Enter, нито Tab, изпратете полето с бутон или с друго явно действие. Пауза в писането е само евристика за края на сканирането.

В тези събития няма нищо, което разпознава устройството USB. Същата поредица може да създаде човек, макрос или емулаторът. Проверката се отнася до полезния товар. Сценарият в браузъра, включително Tab и празен вход, е в Как да тествате баркод скенери в уеб приложения.

Как серийните скенери работят в приложения

Серийната интеграция отваря порт, чете байтове, разделя ги на съобщения и обработва изчезването на порта. На работния плот това е серийният API на операционната система или библиотека на производителя. В браузъра единствената вградена възможност е Web Serial API, и само в браузърите, които го реализират.

Web Serial е наличен в браузъри, основани на Chromium. Firefox и Safari не го предоставят. Страницата трябва да е в защитен контекст, тоест HTTPS или localhost. requestPort() трябва да тръгне от жест на потребителя и потребителят трябва да избере порта в подканата на браузъра. Скенер в режим на клавиатурен клин не се появява в този списък, защото не е серийно устройство. Web Serial също не вижда сериен порт, който операционната система не е показала.

Скоростта в примера е отправна точка, която заменяте със стойността от ръководството. Цикълът приема CR или LF за край на съобщението и изразходва двойка CRLF като един завършек. Ако скенерът ползва друга рамка, това разделяне е грешно дори когато портът е отворен.

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

Цикълът на четене върви, докато потокът не свърши или четенето не се провали. Изваждането на скенера обикновено отхвърля четенето. releaseLock() и close() се изпълняват в finally. Портове, одобрени по-рано за този произход, могат да се изброят с navigator.serial.getPorts() без нова подкана. Първото одобрение пак изисква потребителя.

Настолно приложение следва същата идея със серийния API на платформата: отваряне, четене, сглобяване на рамка и повторно отваряне, когато устройството се върне. Тази страница не измисля команди на производителя. Ако скенерът очаква собствен протокол, този протокол е в документацията на производителя.

Кое е по-добро: HID или сериен режим?

Нито един режим не е по-добър за всеки продукт. Ползвайте режима, който скенерът наистина предлага, и режима, който приложението може да прочете.

Изберете HID, когато

  • Приложението вече приема въвеждане от клавиатура в поле на фокус.
  • Формуляр или екран на POS трябва да работят без код за устройството.
  • Процесът може да гарантира фокус преди всяко сканиране.
  • Enter или Tab съвпадат с начина, по който този формуляр потвърждава стойност или продължава нататък.

Обмислете сериен режим, когато

  • Сканиранията трябва да пристигат, докато фокусът е в диалог, върху бутон или никъде.
  • Байтовете на скенера трябва да останат отделно от писането.
  • Приложението може да отвори порт, да сглоби съобщения и да се възстанови, когато устройството се извади.
  • Хостът може да даде разрешение за този порт и никой друг процес не се нуждае от него по същото време.

Скенер, който се изброява само като клавиатура, не може да се превключи към сериен режим със софтуер на хоста. Потвърдете режимите в ръководството, преди да проектирате интеграцията.

Превключване между HID и сериен режим

Някои скенери сменят режима, когато сканирате конфигурационен баркод от ръководството на този производител или когато запишете профил с помощната програма на производителя. Други са направени като един интерфейс и няма какво да се превключва.

Няма конфигурационен баркод, който сменя режима при всички марки. Поредица, отпечатана за друг модел, може да не направи нищо или да остави скенера в неочакван режим. След всяка промяна вижте какво показва операционната система: клавиатура, порт COM или и двете. После изпробвайте пътя, който ползва приложението. Ръководство за конфигурация на баркод скенер описва обичайните групи настройки. То не замества ръководството на модела.

Тестване на скенер HID

  1. Свържете скенера и потвърдете, че е в режим на клавиатурен клин. Текстовият редактор трябва да получава знаци, когато полето в този редактор е на фокус.
  2. Отворете тестера за въвеждане на баркод.
  3. Щракнете върху Старт на теста или щракнете в областта за сканиране. Тя става синя, когато е готова. Страницата не взима фокуса сама.
  4. Сканирайте баркод, чийто полезен товар вече знаете.
  5. Сравнете заснетата стойност и броя знаци с този полезен товар.
  6. Прочетете наставката: ENTER, TAB или None. Enter и Tab не са част от низа на баркода.

Тестерът записва клавиатурните събития, които браузърът вижда. Не може да чете сериен порт и не може да разпознае устройството USB. Когато средната пауза между знаците е под 100 ms, той съобщава това време. Времето не е разпознаване на хардуера. За всяко keydown, включително key и code, ползвайте тестера за клавишни събития. По-широк преглед има в Как да тествате въвеждането от баркод скенер.

Тестване на сериен скенер

Тестерът за въвеждане на баркод не отваря порт COM. Серийният тест се нуждае от програма, която може да отвори порта, показан от скенера.

  1. Потвърдете, че скенерът е в сериен режим и че операционната система показва порт, когато скенерът е свързан. Извадете го и проверете, че портът изчезва.
  2. Запишете името на порта. То зависи от операционната система и може да се промени при следващото включване.
  3. Отворете порта от съвместимо приложение: сериен терминал, вашето настолно приложение или примерът за Web Serial по-горе в браузър, основан на Chromium, през HTTPS или localhost.
  4. Задайте скорост, битове за данни, четност и стоп битове, когато ръководството ги посочва. Стойности, които липсват в ръководството, не измисляйте.
  5. Сканирайте познат баркод.
  6. Сравнете байтовете или декодирания текст с този полезен товар.
  7. Проверете рамката. Търсете представка и CR, LF или CRLF след данните, само ако точно това е настроено в ръководството.

Ако отварянето на порта не успее, защото е зает, затворете другата програма, която го държи. Ако текстът е боклук, параметрите на линията не съвпадат с устройството. Ако портът изобщо не се появи, скенерът може все още да е в режим на клавиатура, драйверът може да липсва или потребителят на ОС може да няма право да отваря серийни устройства.

Чести проблеми

Скенерът работи в текстов редактор, а не в целевото приложение. Устройството пише. Целта няма фокус или слушател на keydown отхвърля клавишите. Започнете със Скенерът работи в Notepad, но не в POS.

Скенерът не пише в нито едно текстово поле. Може да е в сериен режим, изключен или да не чете символа. Скенер в сериен режим няма да пише. Проверете за порт COM, преди да търсите грешка в полето. Баркод скенерът не работи отделя неработещ скенер от грешен интерфейс.

Серийният порт липсва. Режимът на клавиатура не създава порт COM. Липсващ драйвер, кабел само за зареждане или скенер без сериен режим дават същия признак. Следете списъка с устройства на ОС, докато включвате скенера.

Серийният порт вече се ползва. Само един процес може да го чете. Затворете терминала или другото копие на приложението, после отворете порта отново.

Настройките за връзка са грешни. Разминаване в скоростта, четността или стоп битовете изглежда като случайни знаци. Задайте стойностите от ръководството на този модел, после сканирайте познат код отново.

ENTER или TAB така и не пристигат. Това е настройка на наставката на клина. Тестерът за въвеждане съобщава None. Вижте На баркод скенера липсва ENTER и ръководството за наставки по-горе. Сериен скенер не изпраща клавиша Enter. Може да изпрати байтове CR или LF.

Знаците при скенер в режим на клин са грешни. Подредбата на клавиатурата на скенера и подредбата на операционната система могат да не съвпадат. Серийните байтове тази подредба не пренарежда. Вижте Грешна подредба на клавиатурата при баркод скенера.

Браузърът не може да достигне скенера. Скенер в режим на клин няма да се появи в подканата на Web Serial. Firefox и Safari нямат Web Serial API. Страница, която не е на HTTPS или localhost, не може да го ползва. Потребителят може и да затвори подканата за порта.

Приложението губи скенера след изваждане. Скенерът в режим на клин се връща като клавиатура и следващото сканиране пак иска фокус. Серийният порт го няма, докато приложението не отвори новия порт. Името може да не съвпадне с предишното.

Сценарии за интеграция

Уеб приложения

Клавиатурният клин подхожда на поле на фокус и на обикновени събития DOM. Серийният достъп вътре в страницата означава Web Serial в браузър, който го поддържа, защитен контекст и порт, избран от потребителя. Страница, която трябва да поддържа Firefox, Safari и павилиони без оператор, не може да разчита само на Web Serial. Локален помощник може да притежава порта COM и да препраща готови баркодове към страницата. Този помощник е отделен софтуер. Тестът на клина не упражнява тази програма.

Системи POS

POS, който слага фокус в полето за артикул и потвърждава стойността с Enter, е интеграция с клин. POS, който трябва да сканира, докато е отворен модален прозорец, или който трябва да пренебрегва клавиатурата, е серийна интеграция. Смесването дава сканирания в грешното поле или сканирания, които не пристигат. Съгласувайте режима на скенера с екрана, който наистина е на смяна.

Настолни приложения

Настолно приложение може да приеме вход от клин в контролата, която е на фокус, или да отвори виртуалния порт COM и да държи сесия за живота на процеса. Притежаването на порта, повторното свързване и рамката са част от тази сесия. Фокусът не е.

Автоматизация на QA

Barcode Scanner Emulator въвежда избрана от вас стойност в приложението с фокус и може да изпрати ENTER, TAB или да мине без наставка. Това покрива регресиите на клавиатурния клин: фокус, проверка и обработка на наставката. Той не създава виртуален порт COM, не изброява устройства USB и не възпроизвежда скорост и рамка. Серийните тестове пак се нуждаят от сериен порт и четяща програма, или от тестови двойник, който записва същата байтова рамка, която приложението разглобява.

Павилионни приложения

Павилион с вход от клин трябва да държи полето за сканиране на фокус през диалози, скрийнсейвъри и съобщения за грешка. Един изгубен фокус и следващото сканиране удря клавишна комбинация или нищо. Павилион със сериен режим може да чете порта без този фокус и трябва да държи разрешението за устройството и да отвори порта отново след загуба на захранване или издърпване на кабела.

Къде се вписва Barcode Scanner Emulator

Barcode Scanner Emulator е настолно приложение за Windows, macOS и Linux. То възпроизвежда клавиатурния път, който ползва скенерът в режим на клин. Въвеждате текста, избирате закъснение на писането и избирате наставка: няма, ENTER или TAB. Глобална комбинация въвежда този текст в приложението с фокус.

Ползвайте го, за да разработвате формуляри в стил HID и да хващате техните регресии, когато скенерът не е на бюрото. Свържете го с тестера за въвеждане на баркод, за да видите стойността, клавишите на представката и наставката, които браузърът е получил.

Той не емулира серийно устройство USB, виртуален порт COM, изброяване по USB или оптично декодиране. Това поведение пак принадлежи на хардуера или на сериен тестов двойник, който вие управлявате.