Драйвер используется для подключения к кассе фискальных регистраторов, работающих по протоколу Атол или Атол 5.0.

При подключении ФР Атол кассовое ПО переключает протокол работы ФР в соответствии с выбранным драйвером.

Подключение и настройка фискального регистратора осуществляется через менеджер оборудования.

Подключение ФР

Для подключения ФР в списке драйверов выберите ФР Атол и сохраните его в списке устройств.

Настройка ФР

  • Номер ФР – номер устройства.
  • Перебор скорости – перебор скорости подключения к ФР при потере связи с ним:

    • вкл – осуществляется перебор всех скоростей подключения (поведение по умолчанию),
    • выкл – при первоначальной попытке установить связь с ФР осуществляется перебор всех скоростей. Скорость, на которой было установлено подключение, запоминается. При повторных попытках установить связь с ФР перебор осуществляется между скоростью по умолчанию и скоростью последнего успешного подключения.
  • Протокол – протокол обмена данными с фискальным регистратором. Возможные значения:
      • Атол,
      • Атол 5.0 (используется по умолчанию).
  • Порт – порт, к которому подключается устройство. Порт может быть выбран из списка или задан вручную.
  • Скорость – предпочтительная скорость подключения ФР. Скорость подключения может быть выбрана из списка или задана вручную. 
  • Пароль доступапароль оператора для выполнения команд фискального регистратора. Пароль доступа используется для связи ФР с кассой.
  • Пароль пользователяпароль пользователя для входа в один из установленных режимов работы ККМ, кроме режима доступа к фискальной памяти.
  • Сигнал – включение подачи звукового сигнала ФР. Сигнал срабатывает только при условии, если это разрешено настройками кассовой программы. Подробнее о подаче звукового сигнала можно прочитать в разделе "Добавление товара".
  • Смещение текстового клише – номер строки в области клише, начиная с которой печатается текстовое клише. Только для ФР Атол 5.0, значения от 1 до 10.

    Максимальная длина клише, включая спецсимволы, не должна превышать 250 символов.

  • Смещение графического клише – номер строки в области клише, начиная с которой печатается графическое клише. Только для ФР Атол 5.0, значения от 1 до 10.

    Настройка смещения графического клише применяется только в случае первичной настройки клише или замены файла клише. Если клише уже настроено и файл не менялся, то смещение не применяется.

  • Объединение позиций – объединять позиции в ПФ чека. Возможные значения:
    • Не объединять позиции,
    • Объединять все позиции,
    • Объединять только КМ.

Настройка опций драйвера ФР

Для драйвера Атол реализована возможность настройки опций ФР. Для этого в конфигурационный файл /linuxcash/cash/conf/ncash.ini.d/fr.ini в секцию драйвера [HW.FR.Atol.<номер устройства>] необходимо вручную добавить параметр driverOptions с указанием нужных настроек опций.

Правило задания опций (могут быть указаны несколько через запятую):

<индекс опции>:<значение опции>

Возможные значения опций:

  • 0 – выключена,
  • 1 – включена.

Список поддержанных опций ФР:

Индекс опцииОписаниеПоведение
0Открывать смену операцией внесения/выема 

При настройке 0:1 смена в ККМ будет открыта после выполнения операции внесения/выема.

При настройке 0:0 смена в ККМ не будет открыта.

4Регистрировать каждую позицию отдельно

При настройке 4:1 чек будет закрыт, позиции регистрируются в ФР по отдельности.

При настройке 4:0 чек будет невозможно закрыть, позиции не регистрируются в ФР по отдельности.

11Поддержана печать ФД

При настройке 11:1 ФД будет напечатан.

При настройке 11:0 ФД не будет напечатан (будет напечатан программный чек).

17Поддержан программный рекламный текст

При настройке 17:1 запрограммированный рекламный текст будет напечатан.

При настройке 17:0 рекламный текст не будет напечатан.

28Поддержан чек коррекции

При настройке 28:1 чек коррекции будет закрыт.

При настройке 28:0 чек коррекции будет невозможно закрыть.

31Печать последнего документа из ФН

При настройке 31:1 после печати последнего документа из ФН будет распечатан ФД.

При настройке 31:0 ФД не будет распечатан.

36Проверять код маркировки

При настройке 36:1 код маркировки будет проверен.

При настройке 36:0 код маркировки не будет проверен.

Пример задания настройки для одного устройства
[HW.fiscalregister.Atol.1]  
driverOptions = 0:1, 28:0, 11:1
Пример настройки для всех устройств
[HW.fiscalregister.Atol]  
driverOptions = 0:1, 28:0, 11:1

Подробнее о работе с оборудованием через ini-файлы можно прочитать в разделе "Создание устройств".

Выбор протокола

Для подключения драйвера ФР Атол может использоваться протокол Атол или Атол 5.0. Выберите необходимый протокол в параметрах ФР:

Подключение к кассе

По протоколу Атол

При выборе протокола Атол ФР подключается к кассе через порт "Последовательный":

По протоколу Атол 5.0

При выборе протокола Атол 5.0 ФР может быть подключен к кассе по USB или TCP:

  • Для подключения по USB выберите соответствующий порт:

    Выберите устройство из списка:
  • Для подключения по TCP выберите соответствующий порт:

    Укажите хост и порт:

Автопоиск

Автопоиск позволяет автоматически находить и настраивать ФР Атол, подключенные к кассе.

Настройки для поиска оборудования задаются в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/devicemanager.ini в секции [FR.Atol].

НаименованиеТип данныхВозможные значенияОписаниеПримечания
idsстроковыйVID:PIDСписок id ФР для автоматического поискаЗначения VID:PID могут быть указаны через запятую
Пример настройки
; Список id ФР для автоматического поиска.
; Значения могут быть указаны через запятую

[FR.Atol]
ids = 2912:0005
...

По нажатию кнопки "Автопоиск" осуществляется поиск подключенного оборудования. Результат поиска отображается в виде списка:

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

Для корректной работы необходимо выбрать из списка все устройства, которые планируется использовать.

При выборе только одного устройства остальные ФР невозможно добавить при следующем запуске автопоиска. В этом случае для добавления остальных устройств необходимо:
  • удалить добавленное устройство,
  • перезапустить devicemanager,
  • запустить автопоиск.

Оборудование, выбранное из списка, добавляется в список устройств. Параметры ФР по умолчанию имеют значения:

Связь ФН с ОФД

Подключение ФР по протоколу Атол

Связь фискального накопителя (ФН) с оператором фискальных данных (ОФД) обеспечивается сервисом EthOverUSB, для которого необходимо установить пакет ethoverusb-atol, выполнив команду:

aptitude install ethoverusb-atol

При установке пакета в директории /linuxcash/cash/bin/startup/ создается скрипт 55_ethoverusb_atol, который при каждом старте программы запускает сервис EthOverUSB.

Проверка статуса работы процесса выполняется по команде:

pidof EthOverUsb

Остановку процесса можно выполнить по команде:

pkill EthOverUsb

Запуск процесса EthOverUSB осуществляется после перезапуска кассовой программы.

Сборки с 4.6.64 по 4.6.106-8

Для данных сборок возможно подключение только одного ФР.

При подключении ФР Атол в конфигурационном файле сервиса /opt/Atol/EthernetOverUsb/settings.ini прописывается значение идентификатора устройства pid.

Логи работы сервиса записываются в файл /opt/Atol/EthOverUsb/EoU.log.

Сборки с 4.6.106-9 и выше

В качестве конфигурационного файла выступает /opt/Atol/EthernetOverUsb/settings.xml.

При установке пакета создается файл settings.xml. Если кассовое ПО или пакет были обновлены, то прежний конфигурационный файл settings.ini сохраняется в директории, но данные из него при работе не учитываются.

ТегВозможные значенияОписаниеПримечания

<logs><dir>/opt/Atol/EthernetOverUsb/logs</dir></logs>


Директория файла логов

Если указанной директории не существует, то запись логов не производится.

По умолчанию /opt/Atol/EthernetOverUsb/logs. Каталог создается автоматически при первом обращении к сервису.

При изменении каталога записи файлов его необходимо создать до внесения изменений в settings.xml.

<hotplug>auto</hotplug>

  •  auto
Автоматический поиск подключенных ККТ
Пример настройки
<?xml version="1.0" encoding="utf-8" ?>
<settings>
    <logs>
        <dir>/opt/Atol/EthernetOverUsb/logs</dir>
    </logs>
    <hotplug>auto</hotplug>
</settings>

Подключение ФР по протоколу Атол 5.0

Для Атол 5.0 связь ФН с ОФД осуществляется автоматически, если у кассы есть подключение к Интернету.

Отправка данных на сервер ОФД логируется в linuxcash/logs/current/atol5/ofd.log.


Типы оплат для ФР, работающего по протоколу Атол 5.0

Для ФР, работающего по протоколу Атол 5.0, используются следующие коды оплат:

  • 0 – оплата наличными,
  • 1 – оплата по безналу,
  • 2 – предоплата,
  • 3 – кредит,
  • 4 – оплата встречным предоставлением.

По умолчанию – оплата наличными.

Идентификация устройства при подключении двух ФР

В кассовом ПО Artix реализован функционал идентификации ФР по серийному номеру.

Приоритет идентификации следующий: полное совпадение (vid pid hub serial), совпадение по serial, совпадение по hub, совпадение по vid pid.

Для корректной работы функционала необходимо после обновления кассового ПО перенастроить порты ФР.

Чтобы проверить достоверность серийного номера, выполните команду:

lsusb -v

Настройка таймаута проверки кода маркировки

Для настройки таймаута проверки кода маркировки (КМ) необходимо в утилите тест-драйвера ККТ установить следующие значения:

Проверка кода маркировки (тег 2106)

Для проверки кода маркировки (тег 2106) необходимо в утилите тест-драйвера ККТ настроить следующие параметры:

НаименованиеОписаниеПримечания
Адрес ИСМURL или IP-адрес сервера ИСМПараметр может принимать значения из диапазона от 0 до 64 символов
Порт ИСМПоследовательный номер порта, через который будет осуществляться обмен данными с ИСМ
Адрес ОКПАдрес сервера для выполнения обновления ключей проверкиПараметр может принимать значения из диапазона от 0 до 64 символов
Порт ОКППоследовательный номер TCP-порта, через который будет осуществляться обмен данными
Количество портов при проверке КМКоличество повторов выполнения проверки КМ

По умолчанию – 0 повторов

Параметр может принимать значения из диапазона от 0 до 10

Время открытия соединения при проверке КМВремя ожидания открытия соединения в секундахПараметр может принимать значения из диапазона от 0 до 60
Время ожидания ответа при проверке КМВремя ожидания ответа от сервера в секундах

По умолчанию – 0 = 5 секунд

Параметр может принимать значения из диапазона от 0 до 180

Время задержки перед повтором при проверке КМВремя задержки в секундах, по истечении которого будет выполнена повторная проверка КМПараметр может принимать значения из диапазона от 0 до 30
Время открытого соединения при проверке КМВремя открытого соединения с сервером в секундах

По умолчанию 0 = 30 секунд

Параметр может принимать значения из диапазона от 0 до 300

Значения параметров необходимо запросить в ОФД.
  • No labels