Портал документации Рутокен

Page tree

О программе

Тестовая утилита FSSM — консольная утилита, предназначенная для демонстрации возможностей библиотеки fssm.dll (Fingerprint Scanner Support Module). Библиотека является модулем поддержки сканеров отпечатков пальцев разных производителей. 

Условия применения

Поддерживаемые ОС

  • Windows (64-бит и 32-бит);
  • Linux (64-бит). 

Поддерживаемые сканеры

  • ZKTeco ZK9500 (только Windows);
  • Futronic FS80H / FS80;
  • Папилон ДС-21C.

Начало работы

Установка тестовой утилиты не требуется.

 Для корректной работы утилиты:

  1. Поместите библиотеку  fssm.dll в ту же директорию, где находится исполняемый файл fssm-demo.
  2. Установите драйверы используемых сканеров в соответствии с Инструкцией по настройке сканеров разных производителей для работы с FSSM.
  3. Подключите сканер отпечатков пальцев.

Чтобы запустить утилиту, запустите исполняемый файл fssm-demo.

В результате откроется главное меню утилиты:

=== Menu ===
1. Get scanner list
2. Scan from specific scanner with 10 sec timeout
3. Scan from any scanner with 10 sec timeout
4. Scan from specific scanner without timeout, in a separate thread
5. Scan from any scanner without timeout, in a separate thread
6. Cancel scanning
7. Get adapter list
8. Get full adapter list
9. Check that finger is on the specific scanner
10. Check that finger is on any scanner
11. Interactive check that finger is on any scanner (press ENTER to stop)
0. Exit

Select an option:

Получить список подключенных сканеров

Чтобы вывести список подключенных сканеров, в главном меню выберите пункт 1.

В результате отобразится список подключенных сканеров в формате "<Порядковый номер>. <Вендор > - ID: <Идентификатор>".

Пример работы:

Select an option: 1

=== Get scanner list ===
  1. Futronic   - ID: 0
  2. ZKTeco     - ID: 1 
Done!

Выполнить сканирование с выбранного сканера с тайм-аутом 10 секунд

Чтобы выполнить сканирование:

  1. В главном меню выберите пункт 2. После выбора опции утилита выведет список подключенных сканеров.
  2. Введите порядковый номер сканера, с которого нужно начать сканирование.

  3. Приложите палец к выбранному сканеру.

    Если не приложить палец к сканеру в течение 10 секунд, то сканирование отменится и утилита перейдет в главное меню.

В результате утилита сохранит изображение отпечатка пальца в папке с утилитой. Название у файла генерируется как "N_fingerprint.jpg", где N — номер изображения. 

Пример работы:

Select an option: 2

=== Scan from specific scanner with 10 sec timeout ===
  1. Futronic   - ID: 0
Enter the scanner number from which you want to get the fingerprint: 1

Place your finger on the selected scanner.
Image saved in 0_fingerprint.jpg
Image size (bytes): 153600
Done!

Выполнить сканирование с первого активного сканера с тайм-аутом 10 секунд

Чтобы выполнить сканирование:

  1. В главном меню выберите пункт 3.

  2. Приложите палец к любому подключенному сканеру. Утилита автоматически определит активный сканер и выполнит сканирование.

    Если не приложить палец к сканеру в течение 10 секунд, то сканирование отменится и утилита перейдет в главное меню.

В результате утилита сохранит изображение отпечатка пальца в папке с утилитой. Название у файла генерируется как "N_fingerprint.jpg", где N — номер изображения. 

Пример работы:

Select an option: 3

=== Scan from any scanner with 10 sec timeout ===

Place your finger on any of the scanners.
Image saved in 1_fingerprint.jpg
Image size (bytes): 153600
Done!

Выполнить сканирование с выбранного сканера без тайм-аута в отдельном потоке

Чтобы выполнить сканирование:

  1. В главном меню выберите пункт 4. После выбора опции утилита выведет список подключенных сканеров.
  2. Введите порядковый номер сканера, с которого нужно начать сканирование. 

  3. Приложите палец к выбранному сканеру.

    Чтобы отменить сканирование в главном меню выберите пункт 6 ("6. Cancel scanning").

В результате утилита сохранит изображение отпечатка пальца в папке с утилитой. Название у файла генерируется как "N_fingerprint.jpg", где N — номер изображения. 

Пример работы:

Select an option: 4

=== Scan from specific scanner without timeout, in a separate thread ===
  1. Futronic   - ID: 0
Enter the scanner number from which you want to get the fingerprint: 1

Place your finger on the selected scanner.
Image saved in 2_fingerprint.jpg
Image size (bytes): 153600
Done!

Выполнить сканирование с первого активного сканера без тайм-аута в отдельном потоке

Чтобы выполнить сканирование:

  1. В главном меню выберите пункт 5.

  2. Приложите палец к любому подключенному сканеру. Утилита автоматически определит активный сканер и выполнит сканирование.

    Чтобы отменить сканирование в главном меню выберите пункт 6 ("6. Cancel scanning").

В результате утилита сохранит изображение отпечатка пальца в папке с утилитой. Название у файла генерируется как "N_fingerprint.jpg", где N — номер изображения. 

Пример работы:

Select an option: 5

=== Scan from any scanner without timeout, in a separate thread ===

Place your finger on any of the scanners.
Image saved in 3_fingerprint.jpg
Image size (bytes): 153600
Done!

Остановить сканирование

Чтобы получить остановить сканирование во всех отдельных потоках, в главном меню выберите пункт 6.

Пример работы:

Select an option: 6

=== Cancel scanning ===

Operation was canceled
Done!

Получить список доступных адаптеров

Чтобы вывести список доступных адаптеров, в главном меню выберите пункт 7.

Адаптер — это динамически подключаемая библиотека, служащая мостом между унифицированным программным интерфейсом библиотеки FSSM и специфическим, уникальным API конкретного сканера (или семейства сканеров) от производителя.

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

Чтобы адаптер считался доступным:

  1. Установите драйвер сканера отпечатков пальцев.
  2. Найдите готовый адаптер или создайте свой и реализуйте в нем все необходимые функции.
  3. Поместите файл адаптера в папку adapters.

Пример работы:

Select an option: 7

=== Get adapter list ===
  1. Futronic
  2. ZKTeco
Done!

Получить список всех адаптеров

Чтобы вывести список доступных адаптеров, в главном меню выберите пункт 8.

В отличие от пункта 7 ("7. Get loaded adapter list"), данный пункт выведет все адаптеры, даже если драйверы для сканера не установлены.

В результате отобразится список всех адаптеров, находящихся в папке adapters и реализующих все нужные для адаптера функции.

Пример работы:

Select an option: 8

=== Get full adapter list ===
  1. Anviz
  2. Futronic
  3. Papilon
  4. ZKTeco
Done!

Проверить, приложен ли палец к выбранному сканеру

Чтобы выполнить проверку:

  1. В главном меню выберите пункт 9. После выбора опции утилита выведет список подключенных сканеров.

  2. Введите порядковый номер сканера, для которого нужно выполнить проверку. 

В результате утилита выдаст "YES", если палец приложен, и "NO" в противном случае.

Пример работы:

Select an option: 9

=== Check that finger is on the specific scanner ===
 1. Futronic   - ID: 0
Enter the scanner number which you want to check: 1

YES
Done!

Проверить, приложен ли палец к первому активному сканеру.

Чтобы выполнить проверку в главном меню выберите пункт 10. Утилита автоматически определит активный сканер и выполнит проверку.

Функция может быть не реализована в зависимости от API производителя сканера.

В результате утилита выдаст "YES", если палец приложен, и "NO" в противном случае.

Пример работы:

Select an option: 10

=== Check that finger is on any scanner ===

YES
Done!

Проверить, приложен ли палец к первому активному сканеру без тайм-аута в отдельном потоке

Чтобы выполнить проверку в главном меню выберите пункт 11. Утилита автоматически определит активный сканер и выполнит проверку. Чтобы отменить проверку нажмите Enter. 

Функция может быть не реализована в зависимости от API производителя сканера.

В результате утилита выдаст "YES", если палец приложен, и "NO" в противном случае.

Пример работы:

Select an option: 11

=== Interactive check that finger is on any scanner (press ENTER to stop) ===

YES
Done!

Завершить работу утилиты

Чтобы завершить работу утилиты, в главном меню выберите пункт 0.

В результате утилита завершит свою работу.

Пример работы:

Select an option: 0

=== Exit from program ===
Done!
  • No labels