Перейти к основному контенту

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

Пошаговая инструкция для установки программного обеспечения на компьютер киоска.


Что понадобится

  • Доступ в админку системы (раздел «Устройства»).
  • Компьютер с Windows 10/11.
  • Яндекс Браузер или Google Chrome.
  • Считыватель карт, подключённый по USB.
  • Права на установку драйверов и запись на рабочий стол.

Шаг 1. Зарегистрировать киоск в админке

  1. Откройте админку и перейдите на страницу «Устройства».
  2. Нажмите «Добавить» и создайте новое устройство типа «Киоск».
  3. Задайте уникальный код устройства (DeviceCode) — его будет проще запомнить, если привязать к месту установки, например:
    • korpus-1
    • k2
  4. Привяжите конфигурацию — именно она будет отображаться на экране этого киоска.
  5. Запишите код — он понадобится на шаге 6.

Важно. Каждый киоск должен иметь свой уникальный код.

Код в админке и в файле kiosk-config.json на компьютере киоска должны совпадать.


Шаг 2. Подключить считыватель

  1. Подключите считыватель к USB до запуска установки.
  2. Убедитесь, что Windows видит устройство (Диспетчер устройств → Порты COM и LPT).

Скрипт попытается автоматически определить тип считывателя и COM-порт. Поддерживаются типы: ACS, SL500, CRT, Z2.

Шаг 3. Установить драйвер считывателя (если нужно)

Устанавливайте драйвер, только если считыватель ещё не работал на этом компьютере (ReadCard раньше не запускался или устройство не видно в системе).

  1. Подключите считыватель к USB.
  2. Откройте папку Драйвера в каталоге установки.
  3. Отключите проверку подписанных драйверов в windows по инструкции в kiosk-install\Драйвера\Win10_DRV_z-2_rd-all
  4. Для Windows 10/11 используйте драйвер из:
    Драйвера\Win10_DRV_z-2_rd-all\DRV_Win_All\
  5. Установите драйвер через Диспетчер устройств:
    • правый клик по неопознанному устройству → Обновить драйвер → Выполнить поиск на этом компьютере → указать папку DRV_Win_All.
  6. После установки в Диспетчере устройств → Порты (COM и LPT) должно появиться устройство с номером порта (например, COM3).

Если драйвер уже стоял и ReadCard ранее работал — этот шаг можно пропустить.


Шаг 3.4. Установить браузер

Установите один из браузеров (достаточно одного):

Скрипт установки сам найдёт браузер в стандартных папках. Если браузер установлен в нестандартное место — путь можно указать вручную (см. раздел «Если что-то пошло не так»).


Шаг 4. Подключить считыватель

  1. Подключите считыватель к USB до запуска установки.
  2. Убедитесь, что Windows видит устройство (Диспетчер устройств → Порты COM и LPT).

Скрипт попытается автоматически определить тип считывателя и COM-порт. Поддерживаются типы: ACS, SL500, CRT, Z2.


Шаг 5. Настроить файл конфигурации

В папке установки откройте файл kiosk-config.json (если его нет — скопируйте kiosk-config.example.json и переименуйте).

Обязательно заполните три поля:

Поле Что указать Пример
DeviceCode Уникальный код из шага 1 "korpus-1"
ServiceUrl Адрес сервера приложения "192.168.1.10" или "kiosk.example.ru"
ServicePort Порт сервера "3000"

Пример готового файла:

{
  "EnableReadCardActions": true,
  "EnableBrowserShortcutActions": true,
  "EnableWindowsStartupSync": true,
  "ServiceUrl": "192.168.1.10",
  "ServicePort": "3000",
  "DeviceCode": "korpus-1"
}

Остальные поля можно не трогать — скрипт подставит их сам.


Шаг 6. Запустить установку

  1. Дважды щёлкните по файлу Install-Kiosk.bat в папке установки.
  2. Дождитесь сообщения Done. в окне.
  3. Нажмите любую клавишу, чтобы закрыть окно.

Запускайте от имени пользователя, под которым будет работать киоск (обычно это учётная запись на рабочем столе).


Что должно получиться

После успешной установки:

Что Где
Папка KIOSK Рабочий стол
Программа ReadCard Рабочий стол\KIOSK\ReadCard\
Ярлык браузера (режим киоска) Рабочий стол\KIOSK\startup\Kiosk.lnk
Ярлык ReadCard Рабочий стол\KIOSK\startup\ReadCard.lnk
Автозапуск при включении ПК Оба ярлыка копируются в папку автозагрузки Windows