Версия: 1.x
burger close
Установка на Linux

Оглавление

Для Linux Касса ReadyScript распространяется в виде пакетов .deb (Debian, Ubuntu и производные).

Требования к системе:

  • Ubuntu 20.04, 22.04, 24.04 и новее

Порядок установки пакета .deb:

  1. Скачайте установочный файл ReadyScriptPOS_amd64.deb
  2. Откройте терминал в папке с загруженным дистрибутивом Кассы ReadyScript и выполните команду:
sudo apt-get install ./readyscript-pos.deb

После установки приложение "Касса ReadyScript" появится в меню Прочее.

Установка драйверов периферийных устройств

Для полноценной работы кассы может потребоваться установить на Linux драйвера и ПО периферийных устройств (ККТ АТОЛ, PAX терминал, ПО DualConnector, сканнер штрихкода)

Сканер штрихкодов

Для подключения стандартного проводного USB-сканера штрихкодов АТОЛ SB1208 Plus - драйвера не требуются, достаточно только перевести сканер в режим работы "Виртуальный последовательный порт USB" с помощью штрихкода из инструкции.

Устройство обычно доступно под именем /dev/ttyACM*, где * - это число 0,1,2...

В случае, если возникает ошибка "Отказано в доступе" при попытке открыть выбранный порт, необходимо добавить текущего пользователя к группе управления последовательными портами (dialout) с помощью команды:

sudo usermod -a -G dialout $USER

Чтобы система применила новые права, обязательно выйдите из системы (Log Out) и зайдите снова, либо полностью перезагрузите компьютер.

Заметки
В случае использования иного устройства для сканирования штрихкодов, необходимо уточнять драйвера для Linux, а также инструкцию по установке драйвера у производителя.

Драйвер АТОЛ ДККТ 10

Драйвер АТОЛ ДККТ 10 с сервисом Web Requests поддерживается в полной функциональности и для операционных систем семейства Ubuntu Linux.

  • Скачайте последнюю версию драйвера АТОЛ на сайте fs.atol.ru в разделе Программное обеспечение -> ДТО -> 10.x -> Драйвер ККТ 10.10.9.0.zip (номер актуальной версии может отличаться)
  • Распакуйте архив в папку /tmp
unzip ./10.10.9.0.zip -d /tmp
  • Перейдите в папку /installer/deb
cd /tmp/10.10.9.0/installer/deb
  • Установите последовательно все необходимые пакеты
sudo apt install ./mdl_1.1.1.0_amd64.deb -y
sudo apt install ./upd_1.1.0.0_amd64.deb -y
sudo apt install ./libfptr10_10.10.9.0_amd64.deb -y
sudo apt install ./libfptr10-gui_10.10.9.0_amd64.deb -y
sudo apt install ./fptr10-web-requests_1.0.6.0_amd64.deb -y
sudo apt install ./fptr10-rpc-server_10.10.9.0_amd64.deb -y
sudo apt install ./epc-bridge_10.10.9.0_amd64.deb -y

Перезагрузите компьютер после успешной установки пакетов, а затем создайте пользователя для сервиса АТОЛ WebRequests. Вместо user1 и Password123456 - укажите ваш логин и пароль.

sudo atol-fptr-web-requests-users add user1 Password123456

После данных манипуляций, у вас уже должен быть доступен из браузера адрес: http://127.0.0.1:16732 , далее необходимо настроить ККТ в сервисе АТОЛ WebRequests (см Настройка АТОЛ WebRequests )

Заметки
В случае, если вы продаете маркированные товары, вам необходимо установить и настроить ТСПИоТ в виде модуля ЕСМ для Linux. Воспользуйтесь сервисом и инструкциями от компании АО ЕСП.

DualConnector и драйвер терминала PAX

Скачайте DualConnector для Linux с официального файлового хранилища INPAS в разделе Integrirovannye kassovye resheniya -> Distributions for SmartSale -> Linux.

  • Распакуйте файл "Dual Connector Service Linux 2.0.15.7.zip" (номер актуальной версии может отличаться) в папку /opt/inpass
unzip "./Dual Connector Service Linux 2.0.15.7.zip" -d /opt/inpass
  • Перейдите в папку и Запустите установку сервиса
cd /opt/inpass
sudo ./service.sh

После установки, перезапустите компьютер и проверьте статус службы DualConnector

systemctl status dualconnector

Далее необходимо приступить к установке драйвера для терминала. Скачайте драйвер для вашего устройства от компании INPAS в разделе Integrirovannye kassovye resheniya -> Distributions for SmartSale -> Linux -> USB Drivers for Linux. Выполните последовательно следующие команды:

unzip LinuxDriver_V317_20240625.zip -d pax_driver
cd pax_driver
sudo apt update
sudo apt install build-essential linux-headers-$(uname -r)
sudo make
sudo make install

В результате выполнения вышеперечисленных команд, появится файл ttyPos.ko. Для запуска драйвера прямо из папки, выполните команду.

sudo insmod ttyPos.ko

Чтобы драйвер запускался автоматически при перезапуске ОС, необходимо выполнить следующее:

Скопируйте файл драйвера в систему. Файл модуля ядра ttyPos.ko нужно перенести в системную директорию модулей

cp ttyPos.ko /lib/modules/$(uname -r)/kernel/drivers/misc/

Обновите список зависимостей модулей. Запустите команду, чтобы ядро «увидело» новый добавленный драйвер.

sudo depmod -a

Добавьте модуль в автозагрузку, чтобы система автоматически загружала драйвер при старте, добавьте его имя в конфигурационный файл. Имя указывается без расширения .ko.

Откройте файл конфигурации (или создайте новый):

sudo nano /etc/modules-load.d/pax.conf

Впишите туда одну строку (название вашего модуля):

ttyPos

Сохраните файл (в nano: нажмите Ctrl+O, затем Enter, для выхода — Ctrl+X).

Проверьте, что в системе присутствует устройство по идентификатору /dev/ttyPos0 с помощью команды:

ls -la /dev/ttyPos*

Команда должна вернуть как минимум одну строку с идентификатором устройства /dev/ttyPos0.

После того, как DualConnector и драйвер терминала PAX установлены, необходимо запустить утилиту dccontrol и произвести настройку и тестирование терминала.

dccontrol

В поле номер порта впишите адрес устройства PAX (/dev/ttyPos0).

install_linux_dccontrol_settings.png
Настройка DcControl
Нажмите на кнопку Сохранить, утилита создаст файл connector.xml в папке /etc. Перейдите на вкладку Проверка связи и запустите тест терминала. Все тесткейсы должны пройти успешно.

install_linux_dccontrol_test.png
Тестирование терминала PAX