-------------------------------------------------------------------
DigitalPersona
One Touch for Windows SDK
Version 1.3.0
Readme File
June 2008
-------------------------------------------------------------------
(c) 1996-2008 DigitalPersona, Inc. All Rights Reserved.
This document provides late-breaking or other information that supplements the DigitalPersona One Touch for Windows SDK documentation.
-------------------------
How to Use This Document
-------------------------
To view the Readme file on-screen in Windows Notepad, maximize the Notepad window. On the Format menu, click Word Wrap. To print the Readme file, open it in Notepad or another word processor, and then use the Print command on the File menu.
---------
CONTENTS
---------
1. INSTALLATION
2. COMPATIBILITY
3. SYSTEM REQUIREMENTS
4. RELEASE NOTES
5. KNOWN ISSUES
6. SUPPORT AND FEEDBACK
----------------
1. INSTALLATION
----------------
You must have local administrator rights to install this product on the supported Windows systems.
CD-ROM:
1- Insert the Product CD in the CD-ROM drive.
2- Run Setup.exe located in the "SDK" folder on the CD.
3- Follow the installation instructions.
4- Restart the computer and log on to your Windows account.
5- Connect the U.are.U Fingerprint Reader.
Download:
1- Download the zipped version of the One Touch for Windows SDK.
2- Extract the files.
3- Run Setup.exe located in the "SDK" folder.
4- Follow the installation instructions.
5- Restart the computer and log on to your Windows account.
6- Connect the U.are.U Fingerprint Reader.
-----------------
2. COMPATIBILITY
-----------------
DigitalPersona One Touch for Windows Version 1.3.0 is compatible with the following DigitalPersona products:
- DigitalPersona Pro for AD WS 4.2.0 and later
- DigitalPersona Pro Kiosk 4.2.0 and later
- DigitalPersona One Touch I.D. SDK 1.0.0
Fingerprint templates produced by the One Touch for Windows SDK are also compatible with the following DigitalPersona SDKs:
- Gold CE SDK
- One Touch for Windows SDK, all editions
- One Touch for Linux SDK, all distributions
Platinum SDK registration templates must be converted to a compatible format to work with these SDKs.
DigitalPersona One Touch for Windows Version 1.3.0 is not compatible with any DigitalPersona product other than those listed above.
-----------------------
3. SYSTEM REQUIREMENTS
-----------------------
- x86-based processor or better
- CD/DVD drive (for CD-ROM installation)
- JRE or JDK 1.5 or 1.6 (needed to run samples and completed applications)
- USB port on the computer where the fingerprint reader is to be connected
- Microsoft Windows XP, 32-bit and 64-bit versions; Microsoft Windows XP Embedded, 32-bit version; or Microsoft Windows Vista, 32-bit and 64-bit versions
- DigitalPersona U.are.U 4000B or U.are.U 2500 fingerprint reader.
-----------------
4. RELEASE NOTES
-----------------
4.1 Support for fingerprint authentication on a remote computer, including Citrix connection.
This version includes support for fingerprint authentication through Windows Terminal Services (including Remote Desktop Connection) and through a Citrix connection to Metaframe Presentation Server using a client from the Citrix Presentation Server Client package. The library file needed for Citrix support is not installed.
To deploy the DP library for Citrix support:
- Locate the DPICACnt.dll file on the DP Product CD in the "Misc\Citrix Support" folder, and copy it to the folder on the client computer where the Citrix client components are located (i.e. for the Program Neighborhood client it might be the "Program Files\Citrix\ICA Client" folder).
- Using the regsvr32.exe program, register the DPICACnt.dll library.
- If you have several Citrix clients installed on a computer, deploy the DPICACnt.dll library to the Citrix client folder for each client.
The SDK sample code can be run through Remote Desktop or a Citrix session.
The following types of Citrix clients are supported for fingerprint authentication:
- Program Neighborhood
- Program Neighborhood Agent
- Web Client
4.2 To deploy your application, you will need to include the DigitalPersona One Touch for Windows Runtime Environment (RTE)located in the "RTE" folder on the Product CD. This installs the components required to support One Touch features included in your application, but does not install the sample code and documentation files.
4.3 In order for Pro Workstation 4.2.0 and later or Pro Kiosk 4.2.0 and later to work with an application developed with the One Touch for Windows SDK Version 1.3.0, the Administrator needs to enable two Group Policies Objects (GPOs):"Use DigitalPersona Pro Server for authentication" and "Allow Fingerprint Data Redirection". For more information on how to enable these policies, see the "DigitalPersona Pro for AD Guide.pdf" located on the DigitalPersona Pro Server installation CD.
4.4 This product supports the Windows Vista operating system. Developers may need to modify application services and driver services to run in Windows Vista. Refer to the Microsoft document: "Impact of Session 0 Isolation on Services and Drivers in Windows Vista" included on the product CD in the Docs folder. The filename is "Session0_Vista.doc".
4.5 If you have JDK or JRE 1.5 or 1.6 installed and do not have the JAVA_HOME environment variable defined, the setup program will automatically set the variable to the JDK or JRE root folder. For example: set JAVA_HOME=c:\Program Files\Java\jre1.6.0_03.
4.6 Silent installation requires the .NET Framework 2.0 or later. However, you can run a silent installation without the .NET Framework by modifying the InstallOnly.bat file to bypass installation of the .NET components. For example:
msiexec /i Setup.msi ADDLOCAL="FpRecLibs,ThinClientRDP,ActiveXFpRecLibs,ActiveXThinClientRDP,JavaFpRecLibs,JavaThinClientRDP" /qn /l*v c:\msi.trace.
----------------
5. KNOWN ISSUES
----------------
5.1 You may be required to manually locate the usbdpfp.sys file (fingerprint reader driver) when installing this product on an XP Embedded computer. The file is located in the \Windows\DPDrv folder.
5.2 You may encounter the message "component comdlg32.ocx or one of its dependencies not correctly registered" when running the Enrollment.exe sample code for COM/ActiveX on some systems. For 32-bit operating systems, locate the comdlg32.ocx file and place it in the Windows\system32 folder. For 64-bit operating systems, locate the comdlg32.ocx file and place it in the Windows\sysWOW64 folder then manually register this component. This file is already installed on systems running Visual Basic 6.
5.3 The Java Console sample application will not run if you have Pro Workstation/Kiosk installed.
------------------------
6. SUPPORT AND FEEDBACK
------------------------
Technical support is available through the DigitalPersona Developer Connection at www.digitalpersona.com/webforums, where you can search for answers to questions posted by other developers and post your own questions. You can also purchase a Developer Support package at our web store, http://buy.digitalpersona.com.
Download Driver Pack
After your driver has been downloaded, follow these simple steps to install it.
Expand the archive file (if the download file is in zip or rar format).
If the expanded file has an .exe extension, double click it and follow the installation instructions.
Otherwise, open Device Manager by right-clicking the Start menu and selecting Device Manager.
Find the device and model you want to update in the device list.
Double-click on it to open the Properties dialog box.
From the Properties dialog box, select the Driver tab.
Click the Update Driver button, then follow the instructions.
Very important: You must reboot your system to ensure that any driver updates have taken effect.
For more help, visit our Driver Support section for step-by-step videos on how to install drivers for every file type.