# Установка встроенного приложения на Konica Minolta

## На примере аппарата Konica Minolta bizhub C227

Перед началом работ убедитесь, что прошивка МФУ соответствует рекомендуемой для установки сторонних приложений. При необходимости обратитесь в сервисный центр Konica Minolta.

## Рекомендуемые прошивки по моделям

| Модель | Версия прошивки | Параметры | Настройка функциональной версии |
|--------|-----------------|-----------|--------------------------------|
| bizhub c227 | GCH-Y2 | Special ROM, Function version 4.2, OpenAPI 5.1 / IWS 2.5.6 | System2 > Software Switch Settings, NO. 25 = HEX B0 |
| bizhub 227 | GCH-Y3 | Special ROM, Function version 4.2, OpenAPI 5.1 / IWS 2.5.6 | System2 > Software Switch Settings, NO. 25 = HEX B0 |
| bizhub c300i | G00-Q6 | Function Version 2.2, OpenAPI 5.6 / IWS 3.10.0 | System2 > Software Switch Settings, NO. 25 = HEX 30 |
| bizhub C368 / C308 / C258 (ZeusS 1/2 series) | GCH-X4 | Special ROM, Function version 4.2, OpenAPI 5.1 / IWS 2.5.6 | System2 > Software Switch Settings, NO. 25 = HEX B0 |
| bizhub c284e / bizhub c224e | GDU-M1 | Special ROM MR, Function version 7, OpenAPI 4.7 / IWS 2.0.4 | System2 > Software Switch Settings, NO. 25 = HEX 60 |
| bizhub C250i | G00-Q6 | Function Version 2.2, OpenAPI 5.6 / IWS 3.10.0 | — |
| bizhub C454e | GDU-M1 | — | System2 > Software Switch Settings, NO. 25 = HEX 60 |
| bizhub C308 | GCH-X4 | — | System2 > Software Switch Settings, NO. 25 = HEX B0 |
| bizhub C364 / C284 / C224 (Zeus 1/2/3 series) | GBR-M0 (MSG99) | — | System2 > Software Switch Settings, NO. 25 = HEX 60 |
| bizhub C458 / C558 / C658 | GCH-Y2 | — | System2 > Software Switch Settings, NO. 25 = HEX B0 |
| bizhub C450i / C251i / C301i / 301i | GC4-RB | Function Version 2.3, OpenAPI 5.7.1 / IWS 4.0.0 | System2 > Software Switch Settings, NO. 25 = HEX 40 |

> **ВАЖНО:** При установке нового МФУ bizhub 227 с оранжевой маркировкой на коробке (июнь 2021 и позднее) нельзя использовать версии прошивки ниже Y0.

## Настройки в сервисном режиме

Приложение предназначено для МФУ, обслуживаемых в европейской маркетинговой зоне. При попытке установить приложение на МФУ, настроенном на другой регион, возникает ошибка **CMS Validity Check Error**.

Необходимо проверить настройку маркетинговой зоны в сервисном режиме:

1. Войдите в сервисный режим.
2. Выберите System 1.
3. Проверьте настройку Marketing Area — должен быть установлен регион **Europe**.
4. При необходимости измените настройку.

> **Примечание:** Если с установленным регионом Europe ошибка **CMS Validity Check Error** сохраняется — измените регион на Africa, перезагрузите МФУ, снова измените на Europe и перезагрузите.
>
> Ошибка также может возникать при изменённом **KONICA_SOLUTION_KEY** — в этом случае укажите корректный ключ.
>
> При проблемах с ключом упоминается **Code 25** или **Code 26**; при проблемах с регионом — **Code 23**.

## Предварительные настройки МФУ

Пароль по умолчанию: `1234567812345678`.

- **Установить дату и время:** [Maintenance] > [Date/Time Settings] > [Manual Setting].
- **Отключить таймер недельного выключения:** [Maintenance] > [Timer Setting] > [Weekly Timer Settings] — отключить "Use Weekly Time".
- **Создать сертификат устройства:** [Security] > [PKI Settings] > [Device Certificate Setting] > [New Registration] > [Create and install a self-signed Certificate] — заполнить информацию и нажать [OK].
- **Включить все версии SSL:** [Security] > [PKI Settings] > [SSL Setting] — отметить от TLS 1.0 до TLS 1.3.
- **Указать DNS-сервер:** [Network] > [TCP/IP Setting] > [TCP/IP Setting 1] — в блоке "DNS server settings" указать основной сервер DNS.
- **Включить SSL/TLS:** [Network] > [TCP Socket Setting] — включить "SSL/TLS".
- **Включить SSL-only для OpenAPI:** [Network] > [OpenAPI Setting] > [Use SSL/TLS] — включить "SSL Only".
- **Включить удалённую панель управления:** [Network] > [Remote Panel Settings] > [Remote Panel Server Settings] — включить "Server Setting ON".
- **Включить автопреобразование формата:** [Print Settings] > [Basic Setting] — включить "A4/A3<->LTR/LGR Auto Switch ON".
- **Включить непрерывное сканирование:** [System Settings] > [Separate Scan from Platen] — включить "Separate Scan from Platen ON" (настройка может отсутствовать на других моделях).
- **Выбрать Classic Style:** [System Settings] > [Def. operation mode set.] — включить "Classic Style".

## Настройки в Личном кабинете

Перейдите в Личный кабинет: "Управление" → "Устройства", выберите МФУ, вкладка "Настройка".

Обязательно нужно указать:
- **Логин МФУ** — по умолчанию `administrator`.
- **Пароль МФУ** — по умолчанию `1234567812345678`.

## Установка и удаление приложения

### Через Личный кабинет

Раздел "Управление" → "Устройства", выберите МФУ, нажмите "Приложение не установлено" → "Установить приложение".

Также можно установить через панель администратора Мониторинга: "МФУ" → "Настройки МФУ" — в окне редактирования МФУ нажмите "Установить приложение".

### Через консоль

Перед установкой убедитесь, что токен приложения сгенерирован (в административной панели Мониторинга: "МФУ" → "Настройки МФУ") и появился в ПринтМенеджере.

При установке через консоль можно выбрать приложение сканирования:

```
cd /opt/printmanager
sudo docker-compose exec app bash
python ./manage.py km_install <printer_id> <scan_app_type>
```

где:
- `printer_id` — идентификатор МФУ в базе ПринтМенеджера;
- `scan_app_type` — выбор приложения сканирования:
  - `native` — только родное приложение;
  - `all` — оба приложения;
  - `printum` или пустое значение — только приложение Printum.

Если при установке возникают ошибки (на МФУ уже установлены одноимённые приложения), просмотрите список:

```
python ./manage.py km_app_list <printer_id>
```

Пример вывода:
```
Installed Apps:
1: Authentication
2: Скан
3: Копия
4: Архив
5: Печать
```

Если на МФУ установлены только приложения Printum, удалите их:

```
python ./manage.py km_uninstall <printer_id>
```

Для переустановки используйте:

```
python ./manage.py km_reinstall <printer_id>
```

Если список содержит сторонние приложения, используйте:

```
python ./manage.py km_dev_auth <printer_id> <app_auth_id>
python ./manage.py km_app_del <printer_id> <app_id>
```

где `app_id` — идентификатор приложения из списка.

После удаления приложений Printum повторите процедуру установки.

### Удаление через консоль

```
cd /opt/printmanager
sudo docker-compose exec app bash
python ./manage.py km_uninstall <printer_id>
```

Если на МФУ установлены сторонние приложения, удаление осуществляйте через:

```
python ./manage.py km_app_del <printer_id> <app_id>
```

## Использование приложения

### Авторизация

После установки приложения аппарат блокируется. Разблокировка доступна по карте авторизации или ПИН-коду.

Для ввода ПИН-кода нажмите кнопку ввода — откроется программная клавиатура. По окончании ввода нажмите кнопку подтверждения. Для разблокировки нажмите "Зарегистрир."

### Режим печати

Для запуска печати нажмите соответствующую кнопку. Откроется окно заданий. Для отправки задания на печать выберите его (выбранные задания подсвечены жёлтым) и нажмите аппаратную кнопку "Старт".

### Режим копирования

Для запуска нажмите "Копия" в главном окне. Поведение зависит от настроек ПринтМенеджера (параметр `COPY_WITH_ARCHIVE`): при режиме копирования с архивом откроется окно сканирования с последующей печатью; без архива — окно копирования с быстрыми настройками.

### Режим сканирования

Нажмите "Скан" — откроется окно выбора места назначения. Кнопки "Settings" и "Настройки сканирования" позволяют настроить тему письма и параметры сканирования.

Для начала сканирования нажмите аппаратную кнопку "Старт". По завершении аппарат предложит продолжить или отправить результат. Нажмите "Старт" для продолжения или "Готово" и затем "Старт" для отправки.

> **Важно:** МФУ не заблокирует доступ к панели управления по таймауту, если процедура копирования или сканирования не завершена.

## Настройка МФУ для работы с картридерами Elatec и YSoft

**Чек-лист перед началом работ:**

1. Убедитесь, что на МФУ стоит рекомендованная прошивка и соответствующая функциональная версия — проверьте версию в "Maintenance" > "ROM Version" (строки "MFP Controller" и "MFP Controller System").
2. Убедитесь, что выбранный картридер корректно считывает карты авторизации:
   - Для Elatec: ПО **TWN4 DevPack**.
   - Для YSoft: ПО **YSoft Card Reader Tool**.

### Настройка ридеров Elatec

Подключите картридер к компьютеру, запустите AppBlaster, выберите "Configurable Project". В разделе "Application Template" выберите шаблон в зависимости от метода работы (режим клавиатуры или считывания). Выберите протоколы для чтения карт (например, EM-Marine или Mifare).

### Настройка ридеров YSoft

Подключите картридер к компьютеру, запустите **YSoft Card Reader Tool**, во вкладке "Configuration" нажмите "Reload Readers", убедитесь, что картридер виден.

При необходимости обновите прошивку картридера (кнопки "Update service FW" и "Update FW") и настройте режим чтения в разделе Advanced Configuration.

Для настройки картридера нажмите "Configure":
- В "Configuration protocol" выберите "Select available protocol".
- В "Available protocol" выберите протокол для используемых карт.
- В "USB mode" выберите "USB reader for KM MFP".
- Нажмите "Configure".

### Установка драйвера картридера

Для корректной установки драйверов обратитесь к сертифицированному инженеру, передав:
- Модель МФУ
- Серийный номер МФУ
- Версии прошивки (MFP Controller и MFP Controller System)
- Полное название модели картридера

После установки драйвера подключите картридер к МФУ, установите/переустановите встроенное приложение, проверьте авторизацию по карте.

## Удаление MarketPlace с МФУ

ПО MarketPlace мешает корректной работе встроенного приложения, вызывая ошибку 500. Для отключения перейдите в настройки IWS (через поиск), отключите "Настройки IWS" и перезагрузите устройство.

## Управление опциями печати

Приложение позволяет управлять опциями для заданий в очереди:
- Количество копий
- Односторонняя/двусторонняя печать
- Формат бумаги
- Цветность
- Ориентация
- Разбор по копиям
- Перфорация
- Способ сшивания

## Устранение проблем с кириллическими символами экранной клавиатуры

Если на экранной клавиатуре неправильно отображаются русские символы, выполните языковую настройку: в меню МФУ выберите "Утилиты" > "Настройки пользователя" > "Настройки системы" > "Выбор языка" и поставьте русский язык в "Настройке языка экранной клавиатуры".