> For the complete documentation index, see [llms.txt](https://docs.aamsystems.ru/passoffice/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aamsystems.ru/passoffice/terminal-doc/admin-guide-terminal/terminal-settings.md).

# Дополнительные настройки терминала

### Описание Web Driver Manager (WDM)

**Web Driver Manager (WDM)** — служба, необходимая для работы оборудования в **PassOffice Terminal**, включая:

* Сканеры паспортов (**PassportBox**, **Regula**).
* Считыватели карт **OMNIKEY**.
* Карт-диспенсеры.

### Запуск и остановка менеджера драйверов

#### Через интерфейс терминала

1. Войдите в панель администратора **PassOffice Terminal**.
2. Перейдите в раздел **Диагностика**.
3. В пункте **Служба менеджера драйверов** проверьте статус службы:
   * **Online**: Служба работает.
   * **Offline**: Служба неактивна.
4. Для управления:
   * Нажмите **Запустить** для активации службы.
   * Нажмите **Остановить** для остановки службы.

#### Через диспетчер задач

1. Откройте **Диспетчер задач** Windows.
2. Перейдите на вкладку **Службы**.
3. Найдите службу **ApcWebDriverManager**.
4. Щелкните правой кнопкой мыши и выберите:
   * **Запустить** для активации.
   * **Остановить** для деактивации.

### Сбор логов

* **Путь к логам**: В папке менеджера драйверов перейдите в папку **Logs**.
* **Формат файлов**: Логи имеют формат год\_месяц\_день\_wdm-число\_число.log (например, 2025\_06\_19\_wdm-1\_0.log).
* **Применение:** Используются для диагностики ошибок и анализа работы службы.

### Перерегистрация службы

1. Перейдите в папку менеджера драйверов, затем в папку **bin**.
2. Найдите файлы:
   * **ApcWebDrvManagerServiceUnReg** (для удаления регистрации службы).
   * **ApcWebDrvManagerServiceReg** (для регистрации службы).
3. Выполните последовательно:
   * Запустите **ApcWebDrvManagerServiceUnReg** от имени администратора.
   * Запустите **ApcWebDrvManagerServiceReg** от имени администратора.
4. Проверьте наличие службы **ApcWebDriverManager** в **Диспетчере задач** → **Службы**.

### Регистрация службы

* Для регистрации службы:
  1. Перейдите в папку **bin** менеджера драйверов.
  2. Найдите файл **ApcWebDrvManagerServiceReg**.
  3. Запустите его от имени администратора.
* После успешной регистрации служба появится в **Диспетчере задач** → **Службы** под именем **ApcWebDriverManager**.

### Ошибки при запуске

#### Ошибка ключа аппаратной защиты

* **Описание**: Служба не запускается из-за отсутствия или неисправности ключа Sentinel.
* **Решение**:
  1. Проверьте наличие ключа Sentinel в браузере по адресу: <http://localhost:1947/int/config.html>.
  2. На вкладке **Products** убедитесь, что ключи отображаются.
  3. Если ключ отсутствует, проверьте физическое подключение или переустановите драйвер ключа Sentinel.

### Служба модуля подсветки

1. Подключитесь к модулю подсветки через SSH:
   * В командной строке (cmd) введите: ssh имя\_пользователя@адрес\_модуля\_подсветки -p 2222.
   * Введите пароль пользователя.
2. Проверьте статус службы подсветки:
   * Выполните команду: systemctl status passoffice-rpi.service.
3. Если служба неактивна, запустите ее:
   * Выполните команду: systemctl start passoffice-rpi.service.

### Настройка сканера PassportBox

#### Режимы работы

* **Описание**: **PassportBox** поддерживает два режима работы, задаваемых в файле конфигурации.
* **Путь к файлу**: Settings\ApcSysExt\ApcPassportBox\ApcPassportBoxStartUpActions.json.
* **Настройка**:
  1. В секции drv\_creation найдите конфигурацию сканера (по умолчанию: passport\_box\_01).
  2. Измените поле autocapture\_mode:
     * **0**: Режим сетевого опроса сканера.
     * **1**: Режим автоматического обнаружения документа через уведомления (рекомендуемый для терминала).
* **Применение**: Режим **1** обеспечивает корректную работу терминала с автоматическим распознаванием документов.

### Настройка карт-диспенсера

#### Настройка COM-порта

* **Путь к файлу**: Settings\ApcSysExt\ApcSSCT\ApcSSCTStartUpActions.json.
* **Настройка**:
  1. Если файл пуст, скопируйте пример конфигурации из ApcSSCTStartUpActions.json.sample.
  2. В поле com\_port\_name укажите нужный COM-порт для диспенсера карт.
* **Применение**: Обеспечивает взаимодействие терминала с карт-диспенсером.

### Настройка сканера Regula

#### Установка Regula Document Reader SDK

1. Скачайте дистрибутив с сайта: <https://regulaforensics.com>.
2. Установите SDK в папку (по умолчанию):
   * C:\Program Files (x86)\Regula\Document Reader SDK (32-бит).
   * C:\Program Files\Regula\Document Reader SDK (64-бит).
3. Подключите сканер к компьютеру и проверьте его работу с помощью утилиты **Document Reader**:
   * Убедитесь, что внутри сканера нет документов, и закройте крышку.
   * Запустите утилиту: **Пуск → Regula → Document Reader**.
   * Нажмите **Connect**, положите документ в сканер, затем нажмите **Process**.
   * Проверьте качество сканирования в трех типах освещения.
4. Если сканирование некорректно:
   * Запустите калибровку (Ctrl+R).
   * Распечатайте две тестовые картинки из документации Regula.
   * Положите первую картинку в сканер, затем вторую по запросу программы.
   * После калибровки повторите проверку сканирования.
5. Закройте утилиту **Document Reader** через меню **File → Exit** (свертывание в трей не освобождает сканер).

#### Размещение документов

* **Правило**: Паспорт размещается в сканере **надписями вверх**.
* **Применение**: Обеспечивает корректное распознавание данных.

### Настройка форматов карт OMNIKEY

* **Путь к файлу**: Settings\ApcSysExt\ApcOmniKey\OMNIKEYReader.ini.
* **Настройка**:
  * Отредактируйте форматы карт (например, W26, W35, W40).
  * В полях CardNumberBits и FacilityCodeBits указаны биты для номера карты и кода организации.
  * Биты нумеруются с 0 (младший бит — самый правый).
  * Пример для формата W26:

    ```ini
    [W26]
    Length=26
    CardNumberBits=9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24
    FacilityCodeBits=1 2 3 4 5 6 7 8
    EvenBit=0
    OddBit=25
    ```
* **Применение**: Настраивает считыватель для работы с картами определенного формата.

### Смена порта приложения PassOffice Terminal

1. Подключитесь к веб-интерфейсу маршрутизатора Mikrotik:
   * Адрес: 192.168.88.1.
   * Логин: admin, пароль: superpassword.
2. Перейдите в раздел: **WebFig → IP → Firewall → NAT**.
3. Найдите правило **Terminal Application Port**.
4. Измените поле **Dst. Port** на нужный порт.
5. Сохраните изменения.