Установка киоска 2.0

1. Подготовка образа

1.1. Подготовить USB-накопитель – загрузить образ кассы УКМ 5

Необходимо обратиться к команде техподдержки киоска за ссылкой на актуальный x64 образ кассы УКМ 5. (Текущая актуальная версия - 1.46.19)

При использовании selfie камеры, сервиса DS и Vision - необходимо не менее 4Гб памяти на кассе и 64 битный образ!

В данном документе представлена инструкция к версии кассы ukm5-pos-x64-1.46.19.iso и соответственно с сервера также должен быть обновлён до версии 1.46.7

Вставляем в свой компьютер USB-накопитель объёмом от 4GB.
Необходимо скопировать и вставить (Ctrl+C и Ctrl+V) программу Rufus в папку на ПК из данной инструкции:

Руфус: https://drive.google.com/file/d/1uULQTETKdQZzgHFXtW5kohr9qzpr2le6/view?usp=sharing

Если у вас есть версия от 2.5 (при старте программа сама предложит обновиться до актуальной версии):

Выбираем файл образа кассы УКМ 5, нажав кнопку ВЫБРАТЬ и выделяем нужный файл образа:

Выставляем остальные настройки как на картинках ниже, подтверждаем и нажимаем СТАРТ:

Дожидаемся окончания загрузки образа на носитель (надпись Готов) и нажимаем ЗАКРЫТЬ:

1.2. Установка адреса сервера

Производится заранее пред заливкой на Sherman и непосредственно перед заливкой для каждого магазина.

Открываем флешку и находим файл f:\ukm5\ukm5\connection.conf:

Меняем его содержимое на адрес нужного сервера УКМ 5:

Подключение к кассовому серверу на флешке:

srvIp=IP кассового сервера (или FQDN имя)
srvPort=9000
tmIp=IP кассового сервера
tmPort=9091

Если не поменять данные на флешке, то на кассе будет окно, с возможностью ввести параметры при регистрации кассы.

2. Заливка киоска с флешки (на объекте)

2.1. Простая загрузка

Выключить кассу.
Подключить на кассу USB-клавиатуру.
Подключить накопитель в свободный USB-порт.
Включить кассу.
При включении перейти в BIOS и нажать одну из клавиш F2/Delete/F1 (в зависимости от типа BIOS).
Изменить порядок загрузки, установить первое загрузочное устройство – USB-накопитель.
Перейти в раздел Save & Exit, подраздел Boot Override, выбрать Flash-накопитель и нажать клавишу Enter:
Должна начаться загрузка. Нужно выбрать пункт Install UKM5:

Примечание. Если загрузка не началась или в BIOS Flash-накопитель не видится, попробуйте п. 2.1.2.

2.2. Если не получилась простая загрузка

Выключить кассу.
Подключить на кассу USB-клавиатуру.
Подключить накопитель в свободный USB-порт.
Включаем кассу.
При включении перейти в BIOS нажать одну из клавиш Delete/F1/F2 (в зависимости от типа BIOS).
Изменить порядок загрузки, установить первое загрузочное устройство – USB-накопитель:
- Перейти в раздел Boot – Hard Drive BBS Prioriries:
- в Boot Option #1 назначить (+/-) Flash-накопитель:
- сохранить изменённые параметры в BIOS:
После сохранения параметров касса перезагрузится и на экране появится окно инсталляции. Нужно выбрать пункт Install UKM5:
По окончанию установки на экране появится следующее сообщение:
Необходимо извлечь загрузочный носитель и перезагрузить системный блок.
При последующей загрузке необходимо указать на кассе её уникальный идентификатор, который создаётся на сервере заранее:

3. Настройка дисплеев киоска (на объекте)

Если монитор настроен нормально, можно перейти к следующему пункту, закрыв приложение.

Примечание. На touch-киоске можно настроить, используя touch, но не нажимать кнопку Apply до сохранения конфигурации, т.к. touch не переприменяется сам! Лучше вообще не нажимать кнопку Apply!

При загрузке появится следующее окно Screen Layout Editor:
При необходимости повернуть дисплей нужно выбрать в меню пункт Outputs/VGA-1/Orientation/Left:
Нажать Save As:
Появится окно Save Layout:
Выбрать каталог .config:
Cохранить файл с названием sh, нажать Save (строго в каталог /ukm5/.config/):
Закрыть Screen Layout Editor нажатием на крестик, указано красной стрелкой:
Дождаться загрузки УКМ 5, а затем убедиться, что настройки сохранились и экран киоска отображается правильно.

4. Настройки серверной части УКМ 5

4.1. Настройка «Тип кассы»

Выбираем магазин, из которого будем копировать «Тип кассы»:
В магазине переходим во вкладку Типы касс и в данной вкладке выбираем уже заранее настроенный тип касс Киоск 2,0 (111), после чего нажимаем кнопку Клонировать:
Потом в верхней части меню, возле иконки УКМ 5, нажимаем на текущее название магазина:
В выпавшем списке в меню Выбор магазина выбираем магазин, в который приехал инженер для работ по переоборудованию решения Киоск 1.0 в решение Киоск 2.0:
В магазине переходим во вкладку Типы касс. В данном разделе появляется новая касса, в названии которой присутствует слово Копия. Данная касса называется Киоск 2.0 (Копия):
Выбираем кассу Киоск 2.0 (Копия), нажимаем Настройки и в появившемся меню Настройки типов касс выполняем настройки, специфичные для данного магазина. (Это такие настройки, как - адрес сервера ЕГАИС, идентификатор магазина в системе лояльности (если используется), и т.д. ).
Самое главное - для использования Киоска 2.0 - нужно установить Тип типа кассы - КСО, для Киоска 1.0 - DP- киоск

вводим проверенные данные ЕГАИС-сервера (данные можно взять из другого Типа касс в текущем магазине):
В меню Настройки типов касс ввести проверенные данные сервера валидации (данные можно взять из другого Типа касс в текущем магазине):
В меню Настройки типов касс необходимо настроить СуперМаг Vision, как представлено на картинке ниже:

4.2. Настройка «Кассы»

В разделе Магазин необходимо войти в подраздел Кассы и нажать кнопку +Добавить:
В меню Редактирование кассы прописать Тип и Шаблон оборудования, как представлено на рисунке ниже:
В созданной кассе в полях Номер, Название и GUID вносим новые названия киосков? которые должны называться как 111 (так называется первый киоск), 112 ( так называется второй киоск):
В созданной кассе, в разделе Настройки типов касс, в разделе vision.conf необходимо прописать номер камеры СуперМаг Vision, непосредственно физически находящейся на данной кассе:
После перевода всех киосков из варианта Киоск 1.0 в Киоск 2.0, необходимо войти в старые киоски и на каждом нажать кнопку ЗАБЛОКИРОВАТЬ:
Во вкладке Кассы получаем список из устройств, очень похожий на ниже преставлений рисунок. Все киоски со словом Открытие в названии должны быть также заблокированы:
Таким же образом настраивается второй киоск в магазине. Используется тот же шаблон и тип кассы, что и в первом случае.

4.3. Настройка селфи-камеры (камера с отображением окна безопасности)

В разделе Оборудование необходимо перейти во вкладку Шаблоны и создать новый шаблон оборудования (если он ещё не создан), к примеру, Киоск 2.0:

Используем нижеуказанные параметры:

kiosk2: {

 useVideoSelfie = true

 frontCameraName = "USB 2.0"

 rotateFrontCamera = "left"

}

Нажимаем Сохранить.
Примечание. При возникновении проблем с распределением камер (камеры выполняют не свои функции), ознакомится с пунктом 4.2. НЕТ ТАКОГО ПУНКТА В ОРИГИНАЛЕ ИНСТРУКЦИИ!!!

4.4. Настройка работы звука на Киоске 2.0

В разделе Оборудование необходимо перейти во вкладку Шаблоны и создать новый шаблон оборудования (если он ещё не создан), к примеру, Киоск 2.0:

В данном шаблоне необходимо в файле sound настроить конфигурационный файл input.conf, указав следующие параметры:

defaultSoundCard = alsa_card.pci-0000_00_1b.0 # Основная звуковая карта. Параметр не изменять!

defaultProfile = analog-stereo # Основной профиль ввода, поддерживаемые варианты: analog-stereo, hdmi-stereo

defaultDevice = analog-input-mic # Основное устройство ввода, поддерживаемые варианты: analog-input-mic, analog-input-internal-mic, hdmi-output-0, hdmi-output-1

defaultDeviceVolume = 100 # Громкость звука основного устройства ввода, от 0 до 150 (в процентах)

Нажимаем Сохранить.

Дополнительно, необходимо в файле sound настроить конфигурационный файл output.conf, указав следующие параметры:

defaultSoundCard = alsa_card.pci-0000_00_1b.0 # Основная звуковая карта. Параметр не изменять!

defaultProfile = hdmi-stereo # Основной профиль вывода, поддерживаемые варианты: analog-stereo, hdmi-stereo

defaultDevice = hdmi-output-0 # Основное устройство вывода, поддерживаемые варианты: analog-output-headphones, analog-output-speaker, hdmi-output-0, hdmi-output-1

defaultDeviceVolume = 100 # Громкость звука основного устройства вывода, от 0 до 150 (в процентах)

Нажимаем Сохранить.
Примечание. При возникновении проблем с выводом звука (звука на киоске нет), ознакомится с пунктом №4.1. НЕТ ТАКОГО ПУНКТА В ОРИГИНАЛЕ ИНСТРУКЦИИ!!!

4.5. Проверка

После всех настроек, перезапустить киоск и проверить, что все работает корректно.

5. Дополнительные настройки

5.1. Настройка звука Realtek Audio Codec ALC662 в Sherman-J

Установить кассу версии 1.38 с ISO образа.
Для обновления с ранней версии, поставить звуковые пакеты командами в терминале (требуется подключение к Интернету):
```
sudo apt-get update

sudo apt-get -y install pavucontrol alsa-utils
```
Обновить кассу с помощью tgz.
Создать новую кассу с новым оборудованием или добавить в hardware папку sound с конфигурациями input.conf и output.conf.
Для DP-киоска звук идёт через колонки 3.5mm jack, настройка – по умолчанию (колонки определяются как analog-output-headphones).
После того, как настройки придут на кассу, необходимо полностью её перезапустить.
Запустить видео со звуком (например, проверить звуковыми оповещениями киоска), либо выполнить следующие команды в терминале (ТОЛЬКО Sherman-J):
```
Analog (например, DP-Kiosk)   aplay -D plughw:0,0 /usr/share/sounds/alsa/Front_Center.wav
```
Обязательно проверить на DP-киоске:

input.conf

# Файл конфигурации принимающего звук устройства

defaultSoundCard = alsa_card.pci-0000_00_1b.0 # Основная звуковая карта. Параметр не изменять! 
defaultProfile = analog-stereo # Основной профиль ввода, поддерживаемые варианты: analog-stereo, hdmi-stereo 
defaultDevice = analog-input-mic # Основное устройство ввода, поддерживаемые варианты: analog-input-mic, analog-input-internal-mic, hdmi-output-0, hdmi-output-1 
defaultDeviceVolume = 100 # Громкость звука основного устройства ввода, от 0 до 150 (в процентах)

output.conf

# Файл конфигурации выводящего звук устройства

defaultSoundCard = alsa_card.pci-0000_00_1b.0 # Основная звуковая карта. Параметр не изменять!
defaultProfile = analog-stereo # Основной профиль вывода, поддерживаемые варианты: analog-stereo, hdmi-stereo
defaultDevice = analog-output-headphones # Основное устройство вывода, поддерживаемые варианты: analog-output-headphones,
analog-output-speaker, hdmi-output-0, hdmi-output-1
defaultDeviceVolume = 100 # Громкость звука основного устройства вывода, от 0 до 150 (в процентах)

после полной перезагрузки:

5.2. Настройка нескольких одинаковых камер в драйвере uvcdriver

Установить кассу с ISO x64 версии 1.38* или выше.
В /conf/misc/vision.conf установить имя камеры в параметре frontCameraName и включить показ покупателя на киоске.
Подключить 2 камеры.

Зафиксировать камеры по портам, запустив следующие скрипты:

sudo cp -f /home/ukm5/mint/bin/etc/udev/rules.d/60-gst-usb-camera-v4l.rules /etc/udev/rules.d/60-gst-usb-camera-v4l.rules
~/mint/bin/manual_ascending_attaching_cameras.sh

Проверить, что в СуперМаг Vision и демонстрации покупателя есть картинка с камеры.
Если камеры не по тем портам, то запускаем скрипт смены камер и повторяем проверки:
```
~/mint/bin/manual_descending_attaching_cameras.sh
```

5.3. Настройка СуперМаг Vision на Sherman-J

Создаём конфигурационный файл камеры:

sudo cat >> /var/opt/camera_agent/config.yaml << 'EOF'
%YAML 1.2
---
schema_version: 2
web_api:
  recognition: https://vision.servplus.ru/v2.3/recognize/partner/
  upload: https://vision.servplus.ru/v2.3/upload/
devices:
  gst_device_usb:
    connection: v4l2src device=/dev/v4l/by-id/gst-usb-camera
    socket: /tmp/gst_dev_usb
    cap: image/jpeg,width=1920,height=1080,framerate=30/1
default_camera: <<cameraID>>
sources:
  <<cameraID>>:
    camera:
      classname: GStreamerSRBCamera
      stream: shmsrc socket-path={devices.gst_device_usb.socket} num-buffers=1 ! {devices.gst_device_usb.cap} ! appsink
      device: gst_device_usb
    transform:
      - Crop:
          box: [670, 280, 1270, 800]
EOF

Меняем отмеченные жёлтым выше параметры на те, что были в RPi.
Пример. В режиме редактирования файла F4 – в mc, проверяем, что в конце строк нет символов переноса; если есть, то удаляем.
Ниже пример правильного конфига:

А вот так быть не должно:
Настраиваем DNS:
```
sudo mcedit /etc/netplan/01-netcfg.yaml
```
Прописываем адреса dns-серверов, как в примере ниже:
```
sudo netplan apply
```

Настраиваем службы:

sudo sed -i -e 's/ukmclient/ukm5/g' /etc/systemd/system/camera_agent.service

sudo sed -i -e 's/ukmclient/ukm5/g' /etc/systemd/system/gst_camera@.service

sudo sed -i -e 's/ukmclient/ukm5/g' /etc/systemd/system/uni_worker@.service

cd /opt/camera_agent; sudo venv/bin/python3 -u devices.py

sudo systemctl enable --now uni_worker@camera_agent

sudo systemctl enable camera_agent.service

Каждую команду нужно выполнить отдельно, не все сразу.

После этого заменяем файл на кассе по адресу: /opt/camera_agent/tasks/upload.py файлом ниже:
ФАЙЛ БИТЫЙ, ВСТАВИТЬ НЕ МОГУ!!!

Запускаем службы:

sudo systemctl restart gst_camera@gst_device_usb.service
sudo systemctl restart camera_agent.service
sudo systemctl restart uni_worker@camera_agent.service