Установка ЕСМ на Linux: драйвер АТОЛ и ТС ПИоТ на Ubuntu

Кассовые места на Linux — обычное дело в сетевой рознице. Порядок установки ТС ПИоТ там тот же по смыслу, но выполняется командами, а не мастером установки.

Разберём вариант на Ubuntu — он же базовый для большинства стандартных дистрибутивов.

Требования

  • Драйвер ККТ не ниже 10.10.8.24.
  • Касса зарегистрирована на ФФД 1.2.
  • Включён признак «Торговля маркированными товарами».
  • Для работы с ЛМ ЧЗ версии 2.0 — модуль и контроллер не ниже 1.6.

Дистрибутив скачивается в личном кабинете клиента ЕСП архивом вида esmpack_linux64_<версия>.zip.

Установка драйвера и модуля

Скопируйте архив на кассу — через WinSCP или любым удобным способом — и подключитесь по SSH, например через PuTTY.

Распакуйте архив:

unzip esmpack_linux64-<версия>.zip

Установите драйвер ККТ. Перейдите в папку с драйверами и распакуйте вложенный архив:

cd DKKT
unzip 10.10.<версия>-deb.zip
sudo apt update && sudo apt install -yf ./*$(dpkg --print-architecture)*.deb

Имя вложенного архива может отличаться. Если команда unzip ругается, наберите unzip 10.10. и нажмите Tab — оболочка подставит фактическое имя.

Конструкция $(dpkg --print-architecture) подставляет архитектуру системы, так что подбирать пакет под неё вручную не нужно.

Установите модуль ЕСМ, не выходя из той же директории:

cd ..
sudo apt install -yf ./esm_*$(dpkg --print-architecture).deb

Установите контроллер ЛМ ЧЗ, если локальный модуль работает на этом же компьютере:

sudo apt install -y ./esm-*$(dpkg --print-architecture).deb

Контроллер размещается на той же машине, где стоит локальный модуль «Честного знака» — это требование регламента, а не рекомендация. Если ЛМ ЧЗ живёт на отдельном сервере, контроллер ставится туда, а его установщик поставляется отдельно, архивом вида Atol-lin-<версия>.zip.

Обновление

Отдельной процедуры нет: обновление — это повторение шагов установки с новыми пакетами. Скопируйте свежий дистрибутив на кассу и выполните те же команды.

Настройка

Запустите утилиту драйвера. Через меню приложений: Appmenu → Other → ATOL Fiscal Printer Test v.10. Либо командой в терминале:

fptr10_t

Установите соединение с кассой — найдите её на COM-порту или по IP. В поле «Порт сервера GRPC» задайте 4041, выполните проверку связи и закройте окно свойств.

Включите флаг «Включено» в правом верхнем углу.

Откройте смену, если она закрыта: раздел «Чек» → «Открыть смену». Текущее состояние смены видно в разделе «Информация о ККТ».

Настройка модуля выполняется только при открытой смене — это условие, а не пожелание.

Запустите интерфейс модуля. Appmenu → Other → ESP ESM Setting and Control. Либо командой:

esm-gui

Регистрация экземпляра

В окне модуля нажмите «Обновить список». В блоке «Информация о кассе» появятся модель, заводской номер, номер ФН, регистрационный номер, ИНН и состояние смены.

Нажмите «Зарегистрировать» в блоке «ЕСМ». Модуль запросит лицензию с серверов сервисной платформы и получит идентификатор экземпляра в системе маркировки — он появится в поле «id» блока «ГИС МТ».

Признаки успеха — три статуса:

Окно «Единый сервисный модуль» со статусами лицензии, ЛМ ЧЗ и ГИС МТ
Окно модуля: снимок сделан в Windows, но на Linux это то же приложение и те же три статуса
БлокЧто должно быть
ЕСМЛицензия: «Активна до» с датой
ЛМ ЧЗСтатус: «Готов к работе»
ГИС МТСтатус: «Стабильно»

Заполнение полей занимает время. Для обновления картины пользуйтесь кнопкой «Обновить информацию» — статусы не всегда подтягиваются сами.

Адрес локального модуля настраивается кнопкой «Настроить адрес» в блоке «ЛМ ЧЗ»: 127.0.0.1, если он на этом же компьютере, либо IP сервера. Адрес системы маркировки — кнопка «Настроить адрес» в левой нижней части окна, по умолчанию https://ts-reg.crpt.ru:19100.

Другие сборки Linux

Базовый порядок одинаков, различаются пути и способ доставки пакетов.

Tiny Core Linux и SetRetail — для них есть отдельные инструкции сервисной платформы. Логика та же, но файловая система устроена иначе, и пакеты ставятся не через apt.

УКМ 4 и УКМ 5 отличаются в основном расположением файлов. Логи ТС ПИоТ в УКМ 5, например, лежат в /home/ukm5/piot/logs-tspiot, а логи драйвера — в /home/ukm5/sp-kkt-driver/logs.

Где искать логи

ЧтоПуть
Модуль ЕСМ/var/log/esp
Драйвер АТОЛ/var/log/ATOL, /var/log/uem, /var/log/epc, ~/.atol
Локальный модуль/var/log/regime/yenisei.log, /var/log/regime/regime.log
Идентификатор ЛМ ЧЗ/etc/regime/local.ini, параметр instance_id

Полный разбор с путями для Windows — в статье про логи драйвера.

Что дальше

Правила эксплуатации на Linux те же, что и на Windows, и нарушаются так же часто: драйвер запускается на всю смену, проверка кодов идёт последовательно, контроллер стоит рядом с локальным модулем, порт контроллера в интерфейсе модуля — 50063. Разбор — в шести правилах кассового узла.

Коды ошибок тоже общие: разбор кодов ЕСМ.

Частые вопросы

Команда установки ругается на зависимости. Флаг -f в apt install -yf как раз для того и нужен, чтобы их доустановить. Если ошибка осталась, сначала выполните sudo apt update.

Не запускается fptr10_t. Проверьте, что драйвер установился: пакет должен появиться в списке dpkg -l | grep -i atol. И что вы работаете в графической сессии — утилита оконная.

Где взять дистрибутив? В личном кабинете клиента ЕСП, раздел «Скачать ПО», с выбором типа кассы, вендора и операционной системы. Установщики для Windows собраны на странице загрузки.

Можно ли работать без графического интерфейса? Регистрация выполняется в окне модуля. Часть настроек меняется запросами к API — например, таймаут проверки кода правится через curl.

Обязательно ли ставить контроллер? Только если нужна офлайн-проверка. Она нужна почти всем: связь падает не по расписанию.

Коротко

Драйвер и модуль ставятся из архива esmpack_linux64 командами apt, с автоподстановкой архитектуры через dpkg --print-architecture. Утилита драйвера запускается командой fptr10_t, интерфейс модуля — esm-gui. Порядок настройки тот же, что на Windows: порт GRPC 4041, открытая смена, кнопка «Зарегистрировать», три зелёных статуса. Контроллер ЛМ ЧЗ ставится на ту же машину, где локальный модуль. Логи модуля — в /var/log/esp, логи локального модуля — в /var/log/regime.


Материал носит информационный характер. Сайт atoldriver.ru не является представительством компании АТОЛ или АО «ЕСП» и не оказывает услуг по обслуживанию оборудования.