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

### Описание 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. Сохраните изменения.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aamsystems.ru/passoffice/terminal-doc/admin-guide-terminal/terminal-settings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
