Установка и использование считывателя документов Regula на операционной системе Linux Ubuntu

• Краткое описание
• Требования
• Необходимые шаги
• Проверка результата
• Частые ошибки

Краткое описание

Эта инструкция описывает два способа установки и запуска демонстрационного приложения Regula Document Reader:

• через преднастроенный пакет regula-reader
• через ручную сборку примера с помощью CMake и Qt

Требования

• ОС Linux (Debian, Ubuntu, RHEL)
• Права администратора (sudo)
• Интернет-доступ для установки пакетов

Необходимые шаги

Вариант 1: Установка через пакет

1. Установите основной или пакет разработчика:

   sudo apt-get install regula-reader

   или

   sudo apt-get install regula-reader-dev

2. Перейдите в папку с приложением:

   cd /usr/lib/regula/

3. Запустите демонстрационное приложение:

   ./RegulaDocumentReader

4. Нажмите Connect для подключения считывателя:

   

Вариант 2: Ручная сборка с использованием собственной сборки Qt

1. Установите CMake и пакет разработки Qt:

   sudo apt-get install cmake qtbase5-dev

   Для RHEL:

   sudo yum install cmake qt5-qtbase-devel

   Если используется собственная сборка Qt, убедитесь, что настроены переменные окружения QTDIR или PATH.

2. Выполните сборку:

   cmake -DCMAKE_BUILD_TYPE=Release -S /usr/share/regula/Examples/RegulaDocumentReader-src -B <BUILD_PATH>

   • <BUILD_PATH> — путь, в который будут помещены файлы сборки
3. Перейдите в директорию сборки:

   cd <BUILD_PATH>

4. Запустите приложение:

   ./RegulaDocumentReader

5. Нажмите Connect для подключения считывателя:

   

Проверка результата

• Приложение запускается без ошибок.
• Считыватель подключается при нажатии Connect.
• Разместите документ и нажмите Process:

  

• Появятся результаты сканирования и бинарные данные RFID:

  

Частые ошибки

• Приложение не отвечает при подключении → Убедитесь, что в рабочей зоне считывателя нет посторонних предметов. Нажмите Wait:

  

• CMake не находит Qt → Укажите путь к Qt вручную через флаг -DCMAKE_PREFIX_PATH:

  cmake -S ... -DCMAKE_PREFIX_PATH=/opt/Qt/5.15.2/gcc_64