
===========================
BSAPI SDK for Linux 4.3
===========================


Changes:
--------
=====================
version 4.3
=====================
ADD: New device property ABS_DEVPROP_SENSOR_TYPE flags ABS_DEVPROP_SENSOR_TYPE_FLAG_xxxx documented and can be used with ABSGetDeviceProperty.
CHG: New biometric library included (3.13.0.292) – TCD51 support, Faint finger image enhancement (FFE) for swipe sensors
ADD: New device property ABS_DEVPROP_SENSOR_VARIANT was added and can be used with ABSGetDeviceProperty.
ADD: New global property ABS_PARAM_IMAGE_ENHANCEMENT was added for FFE enable/disable
ADD: FFE control flags for raw grab for area readers: ABS_PKEY_REC_FLAG_DISABLE_FFE_381 and ABS_PKEY_REC_FLAG_DISABLE_FFE_508
ADD: New device property ABS_DEVPROP_NVM_TYPE was added and can be used with ABSGetDeviceProperty.
ADD: New Finger detection functionality - There is new function ABSDetectFinger which allows detecting whether finger is present on the sensor and allows waiting until finger is present or until finger is removed.


=====================
version 4.0
=====================
ADD: New device properties were added and can be used with ABSGetDevicePropery.
- ABS_DEVPROP_USAGE 
- ABS_DEVPROP_SYSTEM_ID and ABS_DEVPROP_SYSTEM_NAME

ADD: New global parameters
- ABS_PARAM_CONSOLIDATION_COUNT_MIN and ABS_PARAM_CONSOLIDATION_COUNT_MAX which replace now obsolete ABS_PARAM_CONSOLIDATION.
- ABS_PARAM_POWER_SAVE_ACTIVE_TO_SLEEP_TIMEOUT and ABS_PARAM_POWER_SAVE_RESET_ON_OPERATION_START, which allow some detailed settings for power control management.
- ABS_PARAM_IGNORE_BIOMETRIC_TIMEOUT specifies whether biometric situation is reported as ABS_MSG_QUALITY_TOO_FAST via ABS_CALLBACK.

ADD: Advanced Support for LEDs - more versatil functions for controling blinking with LEDs. See description of functions ABSSetLedEx and ABSGetLedEx and related structures, and also the chapter LED blinking
ADD: Support asymetric encryption on Linux (as supported by TCD50).
ADD: Support flag ABS_SWIPE_FLAG_TOO_LIGHT in ABS_SWIPE_INFO.
CHG: Removed dependency on libusb
CHG: bclib 1.1-0039
CHG: biohelper 2.3-0012
CHG: biolib 4.7-0176
CHG: tfm 3.11.0.0242 (Support for TCS5D)

=====================
version 3.6
=====================
- Support for anti-latent checking in raw grab (new profile key 
  ABS_PKEY_DETECT_LATENT)
- RawGrab with area sensors is able to work in grab-now mode, i.e. when 
  it does not wait for any finger (controlled with profile key
  ABS_PKEY_WAIT_FOR_ACCEPTABLE). 
    
=====================
version 3.5
=====================
- Dynamic enrollment.
- Grabbing with dynamic image formats
- ABS_CALLBACK is guaranteed to be called in a context of the same thread 
  the biometric operation is called in.
- BSSRV.DLL added.
- BCLIB.LIB added (only light version, converting only among UPEK formats. 
  ANSI and ISO are not supported in the light variant)
- Support for x86_64 architecture on Linux.
    
=====================
version 3.0
=====================
- ADD global antispoofing parameters
- ADD support for TCS4E

Known problems: 
- Sending ABS_MSG_QUALITY_BACKWARD message from the ABSRawGrab function
  to callbacks does not work properly.

=====================
version 2.5
=====================

Notes:
------
* The process using BSAPI (libbsapi.so) must have rights to use the
  usb device. This means some complications because most of Linux distros
  use udev for managing /dev/... directory tree and new
  devices are created ad-hoc when system detects them. The system  
  sets rights to the device according to configuration of udev, which is 
  quite complex and might differ for various distributions.
  So the easiest way how to do it is to run the process as root, which can 
  (by default) uses all USB devices.

* There is no libbsgui.so (corresponding to bsgui.dll on windows).

Installation:
-------------
Requirements:
  -- Only x86 (32bit) is supported.
  -- Kernel has to support USB. All modern distributions and their default
     prebuilt kernels should meet this condtion.
  -- libusb should be installed on the system. In most not-so-old distros 
     it should be there by default (check existance of /usr/lib/libusb.so).

