Кассовые места на Linux — обычное дело в сетевой рознице. Порядок установки ТС ПИоТ там тот же по смыслу, но выполняется командами, а не мастером установки.
Команды рассчитаны на показанный архив 1.6.4.0.375 и Ubuntu 22.04. Пакет ЕСМ под armhf в архиве есть, а контроллера под неё нет — то есть комплект неполный. Перед установкой проверьте совместимость всех четырёх компонентов, включая отдельно загружаемый ЛМ.
| Ветка | Проверка |
|---|---|
| Linux x64 | Инструкция LINUX64 1.7 и состав архива для соответствующей архитектуры |
| Linux Tiny | Отдельная инструкция LINUX_TINY 1.4; не копировать команды x64 без сверки |
| armhf | Наличие драйвера не доказывает наличие всех компонентов, включая контроллер, в архиве |
| Доступ к ККТ | Права пользователя рабочего процесса на устройство; не маскировать отказ постоянным запуском всего от root |
| После перезапуска | Службы стартуют, устройство доступно тому же пользователю, запрос проходит через нужный экземпляр |
Описанный DEB ЛМ рассчитан на указанную версию ОС. На Ubuntu 24.04 нельзя считать пакет для 22.04 совместимым только потому, что обе системы используют apt. Проверьте зависимости или отдельную контейнерную схему; это ограничение пакета, а не всех будущих выпусков ЛМ.
Требования
- Драйвер ККТ не ниже 10.10.8.24.
- Касса зарегистрирована на ФФД 1.2.
- Включён признак «Торговля маркированными товарами».
- Для работы с ЛМ ЧЗ версии 2.0 — модуль и контроллер не ниже 1.6.
В статье используется опубликованный архив 1.6.4.0.375. Перед установкой сопоставьте его содержимое с ОС, архитектурой и инструкцией; наличие более нового комплекта проверяйте у поставщика.
В архиве находятся ЕСМ, контроллер и вложенные архивы ДККТ. Сам ЛМ ЧЗ скачивается и устанавливается отдельно. Список пакетов ниже описывает содержимое архива, а не готовые совместимые комплекты для каждой архитектуры.
| Компонент | Что лежит в архиве |
|---|---|
| Модуль ЕСМ | deb под amd64, arm64, armhf и i386; rpm под x86_64 и i686 |
| Контроллер ЛМ ЧЗ | deb под amd64, arm64 и i386; rpm под i686 |
| Драйвер ККТ | каталог DKKT: 10.10.8.24-deb.zip и 10.10.8.24-rpm.zip |
| Сборка для смарт-терминалов АТОЛ | esm_1.6.4.0_atol_ubuntu22.run |
Устанавливайте согласованные версии компонентов из подходящего комплекта. Одинаковые номера ЕСМ, драйвера и контроллера не требуются; важны документированные зависимости.
Установка драйвера и модуля
Скопируйте архив на кассу — через WinSCP или любым удобным способом — и подключитесь по SSH, например через PuTTY.
Распакуйте архив:
unzip esmpack_linux64_1.6.4.0.375.zipУстановите драйвер ККТ. Перейдите в папку с драйверами и распакуйте вложенный архив:
cd DKKT
unzip 10.10.8.24-deb.zip
sudo apt update
sudo apt install -yf ./*$(dpkg --print-architecture)*.debИмя вложенного архива может отличаться. Если команда unzip ругается, наберите unzip 10.10. и нажмите Tab — оболочка подставит фактическое имя.
Подстановка dpkg —print-architecture выбирает суффикс, но не проверяет наличие и совместимость пакета. Перед запуском команды убедитесь, что соответствующие файлы всех компонентов действительно присутствуют в каталоге.
Вернитесь из DKKT в каталог распакованного комплекта и установите ЕСМ:
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» блока «ГИС МТ».
Признаки успеха — три статуса:
| Блок | Что должно быть |
|---|---|
| ЕСМ | Лицензия: «Активна до» с датой |
| ЛМ ЧЗ | Статус: «Готов к работе» |
| ГИС МТ | Статус: «Стабильно» |
Заполнение полей занимает время. Для обновления картины пользуйтесь кнопкой «Обновить информацию» — статусы не всегда подтягиваются сами.
Адрес локального модуля настраивается кнопкой «Настроить адрес» в блоке «ЛМ ЧЗ»: 127.0.0.1, если он на этом же компьютере, либо IP сервера. Адрес системы маркировки — кнопка «Настроить адрес» в левой нижней части окна, по умолчанию https://ts-reg.crpt.ru:19100.
Порт в блоке «ЛМ ЧЗ» менять нельзя ни при каком расположении модуля. Там всегда 50063 — это порт контроллера, а не самого локального модуля. Порт 5995 принадлежит модулю и в интерфейсе ЕСМ не указывается: подставите его — связка перестанет работать. Это самая частая ошибка настройки.
Другие сборки Linux
Базовый порядок одинаков, различаются пути и способ доставки пакетов.
Tiny Core Linux и SetRetail — для них есть отдельные инструкции сервисной платформы. Логика та же, но файловая система устроена иначе, и пакеты ставятся не через apt.
УКМ 4 и УКМ 5 отличаются в основном расположением файлов. Логи ТС ПИоТ в УКМ 5, например, лежат в /home/ukm5/piot/logs-tspiot, а логи драйвера — в /home/ukm5/sp-kkt-driver/logs.
Что открыть в межсетевом экране
Заблокированные адреса ЦРПТ и сервисной платформы дают ошибки, которые выглядят как поломка модуля, хотя всё установлено правильно. Список адресов приводится в руководстве по установке.
Для работы с фискальным накопителем:
ts-reg.crpt.ru:19100cdn01.crpt.ru…cdn11.crpt.ruна порту19101cdn01-ts.crpt.ru…cdn11-ts.crpt.ruна порту19101stats.ao-esp.ruиapi.ao-esp.ru
Для работы с МГМ:
cdn01.am.crptech.ruна портах19100и19101cdn02.am.crptech.ruиcdn03.am.crptech.ruна порту19101
Для удалённого контроллера предусмотрите доступ от узла ЕСМ к хосту контроллера/ЛМ на 50063 и 5063. Это два интерфейса контроллера; в поле адреса ЛМ интерфейса ЕСМ используется 50063. Сам контроллер размещается на хосте ЛМ.
Сетевые порты принадлежат процессам на узлах установки, а не обязательно самой ККТ. Для процессов на одном хосте оставляйте локальный доступ; удалённые связи разрешайте только между требуемыми узлами по документации схемы.
Где искать логи
| Что | Путь |
|---|---|
| Модуль ЕСМ | /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. Разбор — в шести правилах кассового узла.
Коды ошибок тоже общие: разбор кодов ЕСМ.
Частые вопросы
Установка сообщает об ошибке зависимостей. Проверьте ОС, архитектуру и доступность репозиториев, затем причину ошибки apt. Флаг -f может помочь разрешить зависимости, но не делает пакет для одной версии ОС совместимым с другой. Не продолжайте при незавершённой установке.
Не запускается fptr10_t. Проверьте, что драйвер установился: пакет должен появиться в списке dpkg -l | grep -i atol. И что вы работаете в графической сессии — утилита оконная.
Где взять дистрибутив? В личном кабинете клиента ЕСП, раздел «Скачать ПО», с выбором типа кассы, вендора и операционной системы. Прямая ссылка на сборку 1.6.4.0.375 — в начале статьи. Установщики для Windows собраны на странице загрузки.
Ошибка 514: не удалось получить ответ от ГИС МТ или ЛМ ЧЗ. Код не удалось проверить ни онлайн, ни офлайн. Убедитесь, что локальный модуль и контроллер стоят на одной машине, что порт обращения к контроллеру — 50063, и что адреса ЦРПТ не закрыты межсетевым экраном.
Можно ли работать без графического интерфейса? Регистрация выполняется в окне модуля. Часть настроек меняется запросами к API — например, таймаут проверки кода правится через curl.
Обязательно ли ставить контроллер? Только если нужна офлайн-проверка. Она нужна почти всем: связь падает не по расписанию.
Коротко
Выберите пакет по поддерживаемой ОС и фактической архитектуре; подстановка dpkg не создаёт отсутствующий пакет. После установки проверьте права пользователя службы, доступ к устройству, процессы и порты. Регистрация ЕСМ, готовность ЛМ и контрольный запрос — отдельные этапы. После согласованного перезапуска повторите проверку, чтобы исключить зависимость от ручного запуска.
Материал носит информационный характер. Сайт atoldriver.ru не является представительством компании АТОЛ или АО «ЕСП» и не оказывает услуг по обслуживанию оборудования.