Установка Document Reader SDK для аппаратного считывателя в Linux

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

Эта инструкция описывает два способа работы с устройством считывания документов на Linux OS: напрямую через библиотеки и с использованием Local Service SDK.

• Работа напрямую с библиотеками
• Работа с Local Service SDK для Linux

Требования

• Операционная система Linux (Ubuntu, Debian, CentOS)
• Доступ к интернету для загрузки необходимых пакетов
• Права администратора для установки

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

Вариант 1. Работа напрямую с библиотеками

1. Перейдите по ссылке на документацию: Linux - Desktop SDK
2. Установите следующие пакеты:
   • regula-reader — библиотеки
   • regula-reader-dev — набор для разработки
3. Ознакомьтесь с примером RegulaDocumentReader, в котором показан процесс обработки и получения результатов в формате XML. Файл примера находится по пути:

   /usr/share/regula/Examples/RegulaDocumentReader-src/documentreader.cpp

4. В разделе documentreader.cpp вы найдёте пример работы с оптической частью (PasspR) и RFID.
5. Пример кода:

   long DocumentReader::ConnectPasspr() // подключение к PasspR
   
   long DocumentReader::ConnectRFID // подключение к RFID
   
   long DocumentReader::Process(intptr_t processingMode) // обработка оптической части и RFID

Документация

• Programmers Guide (en).pdf
• RFID SDK Programmer's Guide

Вариант 2. Работа с Local Service SDK

1. Перейдите по ссылке на документацию: Linux - Desktop SDK (regulaforensics.com)
2. Установите следующие пакеты:
   • regula-reader
   • regula-reader-service
3. Пример взаимодействия с Local Service с использованием JavaScript и библиотеки Socket.IO находится в каталоге:

   /usr/share/regula/Examples/LocalServiceExample

4. Откройте тестовую страницу сервиса, чтобы проверить соединение: http://localhost:3000/

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

• При использовании библиотек: убедитесь, что функции ConnectPasspr, ConnectRFID и Process возвращают успешные коды выполнения.
• При использовании Local Service: проверьте доступность страницы http://localhost:3000/ и работу демо-страницы.

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

• Файл documentreader.cpp не найден → Убедитесь, что установлен пакет regula-reader-dev.
• Сервис не запускается → Проверьте статус сервиса с помощью команды systemctl status regula-reader-service.
• Нет подключения к устройству → Проверьте USB-соединение и права доступа к устройствам.