Создание устройств через конфигурационные файлы

В кассовом ПО Artix реализована возможность настройки и добавления устройств через конфигурационные файлы. Для этого необходимо:

1. В каталоге /linuxcash/cash/conf/ncash.ini.d/ создать файл с соответствующим названием и расширением .ini: 

   Примеры конфигурации устройств:

   • для весов – scales.ini,
   • для сканера – scanners.ini,
   • для ридеров магнитных карт – readers.ini,
   • для QR-дисплея – qrdisplays.ini,
   • для дисплея покупателя – customerdisplays.ini,
   • для камеры – cameras.ini,
   • для ФР – frs.ini,
   • для денежного ящика – cashdrawers.ini.

2. В файле создать секцию [Hw.<Тип устройства>.<Имя модели>.<Id>], где:

   • Hw – обязательный префикс,
   • <Тип устройства> – тип устройства,

   • <Имя модели> – название драйвера,

   • <Id> – номер устройства.

     Id должен быть уникален в рамках типа устройств.

3. Указать тип и свойства транспорта:

   Наименование	Тип данных	Возможные значения	Описание	Примечания
   transport	строковый	serial tcp udp usb usbserial	Транспорт	По умолчанию serial
   host	строковый		Хост	По умолчанию "" Для tcp/upd
   port	целочисленный		Порт	По умолчанию 0 Для tcp/upd
   vid	целочисленный		VendorID устройства	По умолчанию 0 Для usb
   pid	целочисленный		ProductID устройства	По умолчанию 0 Для usb
   hub	строковый		Шлюз	По умолчанию "" Для usb/hid
   device	строковый		Порт устройства	По умолчанию "" Для serial

4. Указать свойства устройства. Свойства можно посмотреть в примерах конфигурации устройств.

; Тип устройства: 'ФР', название: 'Атол' (номер '1')

[Hw.fiscalregister.Atol.1]
speedEnumerate = true    # Перебор скорости
protocol = Атол 5.0      # Протокол
transport = serial
device = /dev/ttyS0      # Порт
baudrate = 115200        # Скорость
accessCode = 0           # Пароль доступа
userCode = 30            # Пароль пользователя
denyBeeps = false        # Сигнал
offsetCliche = 1         # Смещение текстового клише (Атол 5.0)
offsetGraphicCliche = 1  # Смещение графического клише (Атол 5.0)
mergeReceipt = Не объединять позиции # Объединение позиций
grpcServerPort = 4041    # grpcServerPort

; Тип устройства: 'ФР', название: 'Штрих-М' (номер '13')

[Hw.fiscalregister.ShtrihM.13]
speedEnumerate = true    # Перебор скорости
transport = serial
device = /dev/ttyS0      # Порт
baudrate =               # Скорость
accessCode = 30          # Пароль доступа
denyBeeps = false        # Сигнал
denyCountersCompare = false # Сравнение счетчиков
serviceCode = 0          # Пароль ЦТО
useCutter = true         # Отрезчик
cutAfterChecksClosing = false # Отрез при закрытии
useBandWidthFromFont = false # Учитывать размер шрифта при печати
recvTimeout = 250        # Таймаут ожидания ответа (мсек)
commandRecvTimeout = 40000 # Таймаут ожидания выполнения команды ФР (мсек)
timeoutBetweenQrPrint = 0 # Таймаут печати QR-кода (мсек)
useQuantityOneInBackBySale = false # Использовать количество 1.000 в чеке возврата
checkCountersTries = 3   # Количество запросов на получение денежных регистров ФР при регистрации чека

; Тип устройства: 'Камера', название: 'Video4Linux' (номер '1')

[Hw.Camera.Video4Linux.1]
Порт устройства
По умолчанию ""
device = /dev/video1

Разрешение камеры
По умолчанию 600x480
resolution = 600x480

; Тип устройства: 'ФР', название: 'Заглушка' (номер '4')

[Hw.fiscalregister.Dummy.4]
developerMode = false    # Режим разработчика
 
; Тип устройства: 'ФР', название: 'ПКС «iKassa»' (номер '9')

[Hw.fiscalregister.Ikassa.9]
printer = fiscalregister_1
url = http://localhost:1828/tsrv # Адрес
pincode = "372501"               # ПИН-код

Для изменения свойств всех устройств с одинаковым типом и моделью нужно добавить секцию с названием драйвера, например [Hw.<Тип устройства>.<Имя модели>], где:

• Hw – обязательный префикс,
• <Тип устройства> – тип устройства,
• <Имя модели> – название драйвера.

; Тип устройства: 'Весы', название: 'DIGI'
[Hw.scale.Digi]
timeout = 100            # Таймаут

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

Правила считывания настроек

/linuxcash/cash/bin/currentsettings

1. Сначала считываются настройки из XML-файлов директории /linuxcash/cash/conf/drivers/.
   

   XML-файлы с настройками больше не генерируются автоматически при добавлении устройства через менеджер оборудования, но их использование поддерживается.

2. Во вторую очередь считываются настройки из сгенерированного файла /linuxcash/cash/conf/drivers/hw.ini.

3. Затем считываются настройки из конфигурационных файлов директории /linuxcash/cash/conf/ncash.ini.d/.

4. В последнюю очередь считываются настройки из конфигурационных файлов директории /linuxcash/cash/conf/ncash.ini.d/puppet/.

Настройки из директории /linuxcash/cash/conf/ncash.ini.d/puppet/, являются самыми приоритетными, они будут применены для кассового ПО Artix.