Считывание QR-кодов

Версия 14.1 от admin на 2026/09/21 18:12

В данном разделе приведены сведения о настройке сервиса ввода данных посредством считывателя QR-кодов.

Общие сведения

Платформа НЕЙРОСС обеспечивает считывание QR-кодов. Передача информации из внешней системы посредством QR-кодов предпочтительна в ситуации наличия жестких сетевых ограничений и политик безопасности. Посредством QR-кода информация может быть передана из внешнего контура системы безопасности во внутренний без нарушения изоляции контуров друг от друга, тем самым нивелировав возможность взлома системы извне. Так например, может быть передана информация о владельце пропуска от внешней заявочной пропускной системы в АРМ НЕЙРОСС Доступ, исключив прямую передачу персональных данных.

Порядок действий

Для реализации возможности ввода данных владельца пропуска посредством считывания QR-кода вам потребуется:

  1. Настроить сканер QR-кодов для работы в режиме клавиатуры;
  2. Установить сервис обмена данными между физическим оборудованием (сканером QR-кодов) и веб-приложением Платформы НЕЙРОСС через протокол WebSocket;
  3. Настроить шаблон формы владельца пропуска с функционалом ввода данных с QR-кода.

Проверка проводилась на сканере АТОЛ SB2108 Plus,  настроенном в режим работы «виртуальный последовательный порт USB». 

Окружение

Обеспечивается работа на рабочем месте АРМ НЕЙРОСС Доступ под управлением ОС семества Linux. Сервис считывания QR-кодов устанавливается непосредственно на рабочем месте оператора и работает локально.

Настройка сканера QR-кодов

Порядок настройки зависит от используемого оборудования и осуществляется согласно инструкции производителя. Важно настроить работу сканера в режиме клавиатуры. Требуется поддержка передачи данных данных в формате vCard. Для проверки правильности настройки рекомендуется:

  1. Открыть любой текстовой редактор;
  2. Отсканировать QR-код;
  3. Проверить соответствие полученных данных образцу ниже.
BEGIN:VCARD
 VERSION:4.0
 FN:Иванов Иван Иванович
 N:Иванов Иван Иванович
 BDAY:1968-01-02
 BIRTHPLACE:гор. Ленинград
 TITLE:Грузчик Оператор Перронной Техники
 ADR:г Санкт-Петербург, р-н Фрунзенский, ул Будапештская, д 1 к 1, кв 1
 NALITY:RU
 ORG:ООО "ВОЗДУШНЫЕ ВОРОТА СЕВЕРНОЙ СТОЛИЦЫ"
 TEL:+79215555555
 X-PASSPORT-NUMBER:4013770000
 X-PASSPORT-ISSUED:2014-02-04
 X-PASSPORT-AUTHORITY:ТП № 139 ОУФМС России по Санкт-Петербургу и Ленинградской обл. в Центральном районе г. Санкт-Петербурга
END:VCARD

Настройка сервиса COM-порта

Warning

Сервис устанавливается и настраивается на компьютере, к которому подключен считыватель QR-кодов, и на котором установлено приложение АРМ НЕЙРОСС Доступ.

Сервис поставляется в виде dep-пакета.

neyross-com-to-websocket-1.0.79.deb 

Номер версии  может отличаться.

Установите и запустите сервис. При работе в среде ОС Ubuntu используйте следующий набор команд:

sudo dpkg -i package_name.deb
sudo systemctl enable com-to-websocket-service.service
sudo systemctl start com-to-websocket-service.service
sudo systemctl status com-to-websocket-service.service

Настройка сервиса осуществляется посредством веб-интерфейса. доступном по порту 3002. 

Введите в адресной строке браузера: 

localhost:3002

Откроется окно интрерфейса.

 QR-reader-service.png

По умолчанию настройка сервиса не требуется, но при необходимости вы можете выполнить требуемые настройки. 

Настройки сохраняются в файле config.yaml в директории приложения:

usr/share/neyross-com-to-websocket/

Формат файла приведен ниже.

# Пример конфигурационного файла для com-to-websocket-service

# Настройки COM-порта
com:
  # Путь к COM-порту (для Linux: /dev/ttyACM0)
  port: /dev/ttyACM0
  # Скорость передачи данных (baud rate)
  baudrate: 115200
  # Таймаут чтения из COM-порта (в миллисекундах)
  timeout: 100

# Настройки HTTP сервера
server:
  # Хост, на котором будет запущен сервер
  # По умолчанию: 127.0.0.1 (только локальные подключения)
  # Для доступа с других машин: 0.0.0.0
  host: 127.0.0.1
  # Порт сервера
  port: "3002"

При изменении номера порта потребуется скорректировать шаблоны форм.

Настройка шаблонов формы владельца пропуска

 Шаблон формы поставляется в виде готового файла формата JSX. Загрузите полученный файл шаблона для требуемой группы пропусков [Готовый шаблон формы].

QR-form_template.png

Сканирование данных

Запустите АРМ НЕЙРОСС Доступ.

Выберите группу пропусков, для которой настроен шаблон формы.

Нажмите на кнопку Создать владельца пропуска.

В форме нажмите на кнопку Сканировать QR-код. Отобразится окно ожидания данных.

 

Платформа НЕЙРОСС