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

Настройка ФР

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

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

Параметры подключения ФР

Подключение по протоколу TCP

Модели ФР Штрих, оборудованные ФН, могут быть подключены к кассе через USB порт и использовать протокол TCP для передачи данных от кассовой программы в ККМ. Для обмена данными необходимо настроить протокол RNDIS.

Для подключения ФР по протоколу TCP необходимо:

  1. Посмотреть параметры ФР:
  2. При подключении ФР к кассе через менеджер оборудования в качестве порта указать TCP:

Автопоиск

Начиная с версии 4.6.210 реализована возможность автопоиска для ФР Штрих-М.

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

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

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


; Список id ФР для автоматического поиска.
; Значения могут быть указаны через запятую
. . . 
[FR.ShtrihM]
ids = 18d1:4ee4

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

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

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

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

При выборе двух и более устройств Штрих-М на экран будет выведено сообщение:

После перезагрузки кассы будет подключено первое из списка устройств Штрих-М.

Поддерживаемые шрифты

Драйвер Штрих-М поддерживает печать документов следующими шрифтами:

ФР MSTAR TSP700II использует при печати другие шрифты, поэтому в программе настроено соответствие шрифтов драйвера и принтера:

Шрифты драйвера Штрих-М
Шрифты принтера MSTAR
NormalNormal
EnlargeEnlarge
CompressedDoubleWidth
DoubleWidthDoubleHeigth
SmallertNormal

Отображение уведомлений об окончании чековой ленты в ФР

Начиная с версии 4.6.204 реализована возможность вывода уведомлений об окончании чековой ленты в верхней части экрана, на красном фоне.


Данный функционал не поддержан для интерфейса tui.

Проверка наличия чековой ленты осуществляется:

Возможность показа уведомления определяется параметром notifyPaperNearEnd, который задается в конфигурационном файле /linuxcash/cash/conf/ncash.ini в секции [Misc]:

НаименованиеТип данныхВозможные значенияОписаниеПримечания
notifyPaperNearEnd

логический

  • true
  • false
Показывать уведомление об окончании чековой ленты

По умолчанию false


[Misc]
...
; Показывать уведомление об окончании чековой ленты
; По умолчанию false
;notifyPaperNearEnd = false

Связь ФН с ОФД

Протокол RNDIS используется для передачи данных в ОФД только ККМ Штрих.

Протокол RNDIS представляет собой сетевой интерфейс, предназначенный для передачи данных от ККМ в кассовую программу по USB подключению с целью дальнейшей передачи данных в ОФД.

Передача данных от ККМ осуществляется по двум каналам:

Подготовка к настройке обмена данными

Перед настройкой обмена данными с ОФД через RNDIS необходимо:

  1. Просмотреть настройки ККМ командой:

    /linuxcash/cash/bin/frinit -gp on

    В результате выполнения команды в файл /linuxcash/logs/current/frinit.log будут выведены таблицы с существующими параметрами ФР.

    В таблице 16 заданы сетевые настройки:

    В таблице 19 заданы параметры ОФД:В таблице 21 задан статус активности RNDIS:

  2. Просмотреть параметры сети, к которой подключена касса.

    Настройки сети в кассовой программе не должны совпадать с настройками сети ФР, так как обмен данными ККМ-касса и ККМ-ОФД должен выполняться в разных интерфейсах.


Настройка передачи данных

Для настройки передачи данных от ККМ в ОФД по usb-кабелю необходимо:

  1. Запрограммировать параметры таблиц 16, 19, 21 в конфигурационном файле  /linuxcash/cash/conf/ncash.ini.d/fr.ini  в секции [HW.FR.commons.params].

    В большинстве случаев для передачи данных могут быть использованы параметры по умолчанию и не требуется их дополнительного программирования.


  2. Установить пакет artix-rndis, выполнив команду:

    aptitude install artix-rndis

    Вместе с пакетом artix-rndis автоматически устанавливается пакет iptables, который используется для настройки маршрутизации пакетов с интерфейса ФР на интерфейс кассы.

  3. В конфигурационном файле /opt/RNDIS/conf.ini указать:

    1. Для подключения одного ФР – настройки шлюза, которые запрограммированы в ФР (строки 16.7.1 – 16.10.1):

      ...
# Настройки интерфейса без привязки к MAC адресу
# IP адрес устройства
ADDRESS=192.168.137.1
# Маска сети
MASK=255.255.255.0 
...


    2. Для подключения от двух до десяти ФР – настройки шлюза, а также MAC-адрес каждого из ФР:

      ...
# Настройки интерфейсов с привязкой к MAC адресу 
# MAC адрес устройства
MAC1=00:60:37:ac:8c:90
# IP адрес устройства
ADDRESS1=192.168.137.1
# Маска сети
MASK1=255.255.255.0
# MAC адрес устройства
MAC2=00:60:37:4a:25:03
# IP адрес устройства
ADDRESS2=192.168.138.1
# Маска сети
MASK2=255.255.255.0
...

      Посмотреть MAC-адрес подключенных ФР можно в логе rndis.log, который находится в директории /linuxcash/logs/current/:

      ...
2018-07-03 15:05:48.131 – Подключен RNDIS интерфейс RNDIS16, MAC=00:60:37:ac:8c:90
...


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

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

Доступность сетевого интерфейса RNDIS

Статус сетевого интерфейса RNDIS проверяется с периодичностью в 10 минут. При отсутствии связи с ФР программа переподключает сетевой интерфейс. Данные проверки записываются в файл /linuxcash/logs/current/rndis.log. Переподключить сетевой интерфейс вручную можно путем перезагрузки кассы. 

Проверка потоварных счетчиков в ФР

При пробитии большого количества данных на ФР Штрих могут возникать ситуации, в которых при добавлении позиции ФР не отвечает, команда добавления позиции отправляется повторно и в результате позиция задваивается. Проверка потоварных счетчиков в ФР Штрих активируется в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/fr.ini .

НаименованиеТип данныхВозможные значенияОписаниеПримечания

checkPositionCounters

логический
  • true
  • false
Проверка потоварных счетчиков в ФР ШтрихПо умолчанию false


[HW.FR]

; Проверка потоварных счетчиков на ФР.
; Если ФР поддерживает проверку счетчиков и включена настройка, то после
; добавления всех позиций в ФР будет происходить проверка на кол-во товаров в программе и ФР
; По умолчанию выключено
;checkPositionCounters = false

Добавление товарных позиций в ФР осуществляется при закрытии кассового чека в программе.

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

 При закрытии чека кассовая программа сравнивает счетчики в программе и в ФР.

ФР Штрих позволяет использовать 16 логических отделов.

В кассовой программе сформирован чек:

ТоварКоличествоОтдел
Консервы14
Хлеб104
Молоко14
Колбаса5-
Печенье20

В ФР записаны позиции:

ТоварКоличествоОтдел
Колбаса, печенье21
Консервы, хлеб, молоко34

Чек в ФР закрывается корректно.

Загрузка лицензии на ФР Штрих

Для загрузки лицензии на ФР Штрих необходимо:

  1. Создать директорию /linuxcash/cash/conf/frlicense/.

  2. Поместить в директорию json-файл:

    [
  {
    "serialnum" : "120938185732",
    "license" : "FC120982103AB2913192312",
    "sign" : "B1213012958098328" 
  },
  {
    "serialnum" : "905683450",
    "license" : "982103AB2913192312",
    "sign" : "3012958098328" 
  }
]

    , где:

При наличии нескольких json-файлов загружается первый попавшийся. В файле последовательно считываются все json-объекты. Если серийный номер ФР и серийный номер в json-файле совпадёт, то будет произведено сравнение лицензии из ФР и из файла:

Проверка лицензии происходит после установки скорости с устройством, но перед перерегистрацией ККТ с заменой СНО.

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

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

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

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

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

Особенности ФР "ШТРИХ-СИТИ-Ф" при отправке чеков на адрес покупателя

После закрытия чека с отказом от печати и отправкой на адрес покупателя ФР "ШТРИХ-СИТИ-Ф" не возвращает значение параметра печати чека в исходное состояние, из-за чего последующие чеки не печатаются.

Для решения данной проблемы необходимо в утилите администрирования Yuki:

  1. Настроить действие "Команда ФР: печатать чек" с командой  COMMAND_OPERATION, с параметром  url  и значением  frcommand://setparam?producer=shtrihm&model=47&table=17&row=1&field=7&value=0.
    О настройке действий подробнее можно прочитать в разделе "Настройка действий".
  2. Настроить макрос "Закрытие чека" с действием "Команда ФР: печатать чек".
  3. На событие "Действия после закрытия документа" назначить макрос "Закрытие чека".
    О настройке макросов и событий подробнее можно прочитать в разделе "События и макросы".