SDK Readers 1.0.1
SDK для связи со считывателями Iron logic
Установка

Подготовка USB считывателей

  1. Для считывателей с чипом FTDI: Z-2 (мод. RD_ALL) (артикул 7716), Z-2 (мод. MF), Z-2 (мод. E HTZ RF) / Z-2 EHR, Z-2 (мод. E HT Hotel) / Z-2 RF-1996 установите стандартный PID = 0x6001 (если ещё не установлен):
  • В ОС Windows скачайте и установите программу FT_Prog для изменения PID по ссылке https://ironlogic.ru/il_new.nsf/file/ru_ftdi-ft_prog.zip/$FILE/ftdi-ft_prog.zip или https://ftdichip.com/utilities/#ft_prog.
  • Подключите устройство, в котором хотим сменить PID. Установите драйверы, которые шли в комплекте или скачайте с сайта https://ironlogic.ru/il_new.nsf/file/ru_drv_z397_2.12.26.zip/$FILE/drv_z397_2.12.26.zip. Инструкция по установке драйверов находится в файле архива драйвера.
  • Во избежание ошибок отключите “лишние” устройства (если есть).
  • Запустите FT_Prog. В меню "Devices" выберите "Scan and Parse" (или нажмите F5). Появляется список найденных устройств.
  • Для нужного устройства выберите слева пункт "USB_Device_Descriptor".
  • Затем справа в свойствах "Custom VID/PID" выбираем "FTDI_Default".
  • В меню "Devices" выберите "Program" (или нажмите Ctrl+P).
  • Появляется окно записи. В окне установите галочку напротив устройства в списке "Device List".
  • Внизу снимите галочку с "Only Program Blank Device".
  • Нажмите кнопку "Program".
  • Отключаем устройство. Теперь оно будет опознаваться как "FTDI Serial port".
  1. Для работы с USB считывателями дайте доступ к порту По умолчанию к устройствам /dev/tty* имеют доступ пользователи из группы dialout. В этом можно убедиться, набрав
    ls -l /dev/ttyUSB0
    В ответ появится
    crw-rw---- 1 root dialout 188, 0 фев 25 20:56 /dev/ttyUSB0
    откуда можно увидеть, что доступ открыт на чтение и запись для пользователя root и для группы dialout.

Добавьте себя в эту группу:

sudo usermod -a -G dialout $USER
sudo reboot

где $USER - имя пользователя, например administrator. Перезагружать систему не обязательно, достаточно выйти из системы и снова войти.

Если вы не хотите добавлять пользователя в группу коммутации, вы можете изменить права доступа к файлу последовательного порта, чтобы программа могла получить к нему доступ. Например, вы можете использовать следующую команду, чтобы изменить права доступа к файлу /dev/ttyUSB0 на 666:

sudo chmod 666 /dev/ttyUSB0

Подготовка считывателя Z-2 MF CCID

  1. Установите компоненты libccid, opensc и pcsc-tools:
    sudo apt install libccid opensc pcsc-tools
  2. Подключите Z-2 MF CCID к компьютеру и проверьте находится ли он системой с помощью команды:
    pcsc_scan
    или
    opensc-tool --list-readers
  3. Если считыватель не находится, то откройте от имени администратора в текстовом редакторе файл "/usr/lib/pcsc/drivers/ifd-ccid.bundle/ContentsInfo.plist", в этом файле:
  • Найдите массив <key>ifdVendorID</key> и добавьте в него строку <string>0x3168</string>
  • Найдите массив <key>ifdProductID</key> и добавьте в него строку <string>0x1356</string>
  • Найдите массив <key>ifdFriendlyName</key> и добавьте в него строку <string>IronLogic Z-2 CCID</string>
  • Убедитесь, что строки добавлены на одинаковые позиции относительно начала соответствующего массива. Сохраните изменения в файле.
  • Отключите считыватель от компьютера.
  • Перезагрузите систему.
  • Подключите считыватель к компьютеру и снова проверьте работу считывателя командой pcsc_scan.

Зависимости

Эта библиотека зависит от библиотеки udev (для получения информации об USB устройствах) и от библиотеки libpcsclite1 (для работы со считывателем Z-2 (мод. MF CCID)).

sudo apt install udev
sudo apt install libpcsclite1