Palmsecure SDK v02
Palmsecure SDK v02
Sensor Driver
Installation Guide
◆ Revision History
Issued Revised
Revision Modification Details
Date Page
Entire
1st Rev. Oct 2013 Newly created
document
i
◆ Introduction
Thank you for purchasing PalmSecure™ SDK V02 (hereinafter called "this
product").
This document describes how to install the Sensor driver for users who have the
following knowledge:
• Basic knowledge of Windows or Linux operations
Screens shown in this document may be a little different from the screens actually
displayed depending on your environment.
October 2013
ii
Regarding to High Safety Required Usage
This Product is designed, developed and manufactured as contemplated for
general use, including without limitation, general office use, personal use,
household use, and ordinary industrial use, but is not designed, developed and
manufactured as contemplated for use accompanying fatal risks or dangers that,
unless extremely high safety is secured, could lead directly to death, personal
injury, severe physical damage or other loss (hereinafter “High Safety Required
Use”), including without limitation, nuclear reaction control in nuclear facility,
aircraft flight control, air traffic control, mass transport control, medical life
support system, missile launch control in weapon system. You shall not use this
Product without securing the sufficient safety required for the High Safety
Required Use. If you wish to use this Product for High Safety Required Use,
please consult with the sales representatives in charge before such use.
Warnings
• Reprinting or reproducing this document in part or in whole without
permission is forbidden.
• Items described in this document are subject to change without prior notice.
PalmSecure is a trademark of Fujitsu Ltd.
Microsoft, Windows, and Windows Vista are registered trademarks of Microsoft Corporation
Other company names and product names described in this document are trademarks or
All Rights Reserved, Copyright © 2013 Fujitsu Limited and Fujitsu Frontech Limited
iii
◆ Composition of This Document
iv
◆ Abbreviations and Common Terms
Abbreviation/
Description
Common Term
This product Abbreviation for "PalmSecure™ SDK V02".
PalmSecure
Abbreviation for "PalmSecure™ Sensor".
Sensor
PalmSecure Abbreviation for "PalmSecure™ Sensor V2".
Sensor V2 This Sensor is the successor of PalmSecure Sensor.
Common term for "PalmSecure Sensor" and "PalmSecure
Sensor
Sensor V2".
Windows XP Abbreviation for "Microsoft® Windows® XP".
Windows Vista Abbreviation for "Microsoft® Windows Vista®".
Windows 7 Abbreviation for "Microsoft® Windows® 7".
Windows 8 Abbreviation for "Microsoft® Windows® 8".
Windows 8.1 Abbreviation for "Microsoft® Windows® 8.1".
Common term for "Windows XP", "Windows Vista",
Windows
"Windows 7", "Windows 8", and "Windows 8.1".
Authentication Abbreviation for "Authentication library V32
library (Professional Edition)".
"Authentication
Abbreviation for the "Authentication Library V32
Library Reference
Reference Guide".
Guide"
◆ Notations
Symbol Description
Describes things that you have to look out for.
!Caution You must read it.
Provides reference information.
★Tip Read it as necessary.
v
◆ Table of Contents
Section Ⅰ Overview
Section Ⅱ
vi
Chapter4 Applying Modification to the Sensor Driver
Manually which is Installed
by Using Archive version ························ 37
Section Ⅲ
(Windows Version)
vii
Section Ⅳ
(Linux Version)
viii
Section Ⅰ
Overview
1
Chapter1 Preliminary Steps before
Installing the Sensor Driver
3
Chapter1 Preliminary Steps before Installing the Sensor Driver
Application
Authentication library
Sensor driver
USB driver
Sensor
This is the previous Sensor driver that was supplied with PalmSecure™ SDK
since V01.
This Sensor driver does not have a WHQL (Windows Hardware Quality Lab)
signature.
The conventional Sensor driver for Windows can be used for both PalmSecure
Sensor and PalmSecure Sensor V2; however, extended functions of the Sensor
are not available if you use this Sensor driver.
>See> For information on extended functions of the Sensor, refer to the
"System Development Guide".
There are two types of conventional Sensor driver for Windows as follows.
Select one which is more suitable for your requirements.
• Installer version (Execution file form)
Use this in case installing the Sensor driver first.
The following table indicates installers included in the installer version and
their names.
4
1.1 Overview of the Sensor Driver
• Archive version
Use this in case installing the Sensor driver manually or in case applying
modification to the installed Sensor driver manually.
The following table indicates installers included in the archive version and
their names.
>See> For details of the archive version, refer to “Chapter3 Installing the
Sensor Driver Manually by Using Archive Version” or “Chapter4
Applying Modification to the Sensor Driver Manually which is
Installed by Using Archive version”.
5
Chapter1 Preliminary Steps before Installing the Sensor Driver
You can use the Sensor driver for extended function for Windows when you are
connecting PalmSecure Sensor V2.
The Sensor driver for extended function for Windows is provided as an installer
(MSI package).
The following table indicates installers of the Sensor driver for extended function
for Windows and their names.
>See> For details of the Sensor driver for extended function for Windows, refer to
“Chapter5 Installing the Sensor Driver for Extended Function (Windows
Version)”.
6
1.1 Overview of the Sensor Driver
The Sensor driver for extended function for Linux is provided as the source code.
The following table indicates the provided Sensor driver for extended function
for Linux and their files.
>See> For details of the Sensor driver for extended function for Linux, refer to
"Chapter6 Installing the Sensor Driver for Extended Function (Linux
Version)".
7
Chapter1 Preliminary Steps before Installing the Sensor Driver
The following describes hardware and software requirements for installing the
Sensor driver.
Note 1) Use an Intel® Core™ 2 Duo 2.40GHz or faster CPU when identifying or
using the detailed information notification function for the guidance
image display.
>See> For information on the identification, refer to the “System
Development Guide” and “Authentication Library Reference
Guide”.
>See> For information on the detailed information notification function
for the guidance image display, refer to the "Authentication
Library Reference Guide".
8
1.2 Hardware and Software Requirements
9
Chapter1 Preliminary Steps before Installing the Sensor Driver
10
1.2 Hardware and Software Requirements
11
Chapter1 Preliminary Steps before Installing the Sensor Driver
12
Section Ⅱ
(Windows Version)
13
Chapter2 Installing the Sensor Driver
by Using Installer Version
15
Chapter2 Installing the Sensor Driver by Using Installer Version
This section describes how to install the Sensor driver in Windows XP / Vista / 7
environments by using Installer version.
>See> For information on how to uninstall the Sensor driver, refer to "2.2
Uninstalling the Sensor Driver in Windows XP / Vista / 7 Environments".
Operation
Step1 Ensure that the Sensor is not connected to the target hardware.
Step3 Extract the downloaded installer version and copy the installer of the
Sensor driver “Setup.exe” from the folder created by the extraction to
any folder on the target hardware.
Step4 Double-click the Sensor driver installer (Setup.exe) that you copied to
the target hardware.
The installer launches and displays the Choose Setup Language screen.
16
2.1 Installing the Sensor Driver in Windows XP / Vista / 7 Environments
17
Chapter2 Installing the Sensor Driver by Using Installer Version
18
2.1 Installing the Sensor Driver in Windows XP / Vista / 7 Environments
19
Chapter2 Installing the Sensor Driver by Using Installer Version
20
2.1 Installing the Sensor Driver in Windows XP / Vista / 7 Environments
21
Chapter2 Installing the Sensor Driver by Using Installer Version
★Tip A dialog box indicating that the driver has not passed the
Windows Logo testing is displayed
A dialog box indicating that the driver has not passed the
Windows Logo testing may be displayed in a Windows XP
environment.
In that case, click the [Continue Anyway] button to continue
the process.
Step12 If there are multiple USB ports where the Sensor may be connected,
the Sensor must be detected on each USB port. Disconnect the Sensor
from the target hardware and repeat steps 9 to 11 again.
22
2.2 Uninstalling the Sensor Driver in Windows XP / Vista / 7 Environments
This section describes how to uninstall the Sensor driver in Windows XP / Vista / 7
environments.
Operation
Step1 Ensure that the Sensor is connected to the target hardware.
Step4 Delete device information of the Sensor driver from Device Manager.
<For Windows XP>
Right click [FUJITSU USB Capture Device] under [Universal Serial
Bus controllers] and select [Uninstall] from the menu.
<For Windows Vista / 7 (x86)>
Right click [FUJITSU USB Capture Device] under [Universal Serial
Bus controllers] and select [Uninstall] from the menu.
<For Windows Vista / 7 (x64)>
Right click [PalmSecure Sensor Device] under [PalmSecure] and select
[Uninstall] from the menu.
★Tip A check box [Delete the driver software for this device] is
displayed
The [Delete the driver software for this device] check box may
be displayed in a Windows Vista / 7 environment.
Check on the check box and click the [OK] button.
23
Chapter2 Installing the Sensor Driver by Using Installer Version
Step6 When there are multiple USB ports which have been used to connect
the Sensor, device information of the Sensor driver needs to be
deleted from each USB port. Reconnect the Sensor to the target
hardware and repeat steps 3 to 5.
Step7 Select [Add or Remove Programs] (for Windows XP), or [Programs and
Features] or [Uninstall a program] (for Windows Vista / 7) from Control
Panel. Follow the instructions on the screen to delete "FUJITSU
PalmSecure Sensor driver".
24
Chapter3 Installing the Sensor Driver
Manually by Using Archive
Version
25
Chapter3 Installing the Sensor Driver Manually by Using Archive Version
This section describes how to install the Sensor driver in Windows XP / Vista / 7
environments by using Archive version manually.
Operation
Step1 Ensure that the Sensor is not connected to the target hardware.
Step3 Extract the downloaded archive version and copy the following files
from the folder created by the extraction to the hardware you want to
install the Sensor driver.
The copy files and the folders to which the files copied are below,
26
3.1 Installing the Sensor Driver in Windows XP / Vista / 7 Environments Manually
27
Chapter3 Installing the Sensor Driver Manually by Using Archive Version
(3) Select [Search for the best driver in these locations.], check [Include
this location in the search:] and specify "C:\WINDOWS\system32".
Click the [Next] button.
★Tip A dialog box indicating that the driver has not passed the
Windows Logo testing is displayed
A dialog box indicating that the driver has not passed the
Windows Logo testing may be displayed in a Windows XP
environment.
In that case, click the [Continue Anyway] button to continue
the process.
(4) The [Completing the Found New Hardware Wizard] screen will be
displayed. Click the [Finish] button.
(5) If there are multiple USB ports where the Sensor may be connected,
the Sensor must be detected on each USB port. Disconnect the Sensor
from the target hardware and repeat steps (1) to (4) again.
28
3.1 Installing the Sensor Driver in Windows XP / Vista / 7 Environments Manually
(7) A message [The software for this device has been successfully
installed] will be displayed. Click the [Close] button.
29
Chapter3 Installing the Sensor Driver Manually by Using Archive Version
(6) A message [The software for this device has been successfully
installed] will be displayed. Click the [Close] button.
30
3.1 Installing the Sensor Driver in Windows XP / Vista / 7 Environments Manually
31
Chapter3 Installing the Sensor Driver Manually by Using Archive Version
This section describes how to uninstall the Sensor driver in Windows XP / Vista / 7
environments manually.
Operation
Step1 Ensure that the Sensor is connected to the target hardware.
Step4 Delete device information of the Sensor driver from Device Manager.
<For Windows XP>
Right click [FUJITSU USB Capture Device] under [Universal Serial
Bus controllers] and select [Uninstall] from the menu.
<For Windows Vista / 7 (x86)>
Right click [FUJITSU USB Capture Device] under [Universal Serial
Bus controllers] and select [Uninstall] from the menu.
<For Windows Vista / 7 (x64)>
Right click [PalmSecure Sensor Device] under [PalmSecure] and select
[Uninstall] from the menu.
★Tip A check box [Delete the driver software for this device] is
displayed
The [Delete the driver software for this device] check box may
be displayed in a Windows Vista / 7 environment.
Check on the check box and click the [OK] button.
32
3.2 Uninstalling the Sensor Driver in Windows XP / Vista / 7 Environments Manually
Step6 When there are multiple USB ports which have been used to connect
the Sensor, device information of the Sensor driver needs to be
deleted from each USB port. Reconnect the Sensor to the target
hardware and repeat steps 3 to 5.
33
Chapter3 Installing the Sensor Driver Manually by Using Archive Version
Step7 Delete 3 files of the Archive version copied at the installation from the
target hardware.
★Tip A dialog box is displayed to inform that the file access was
denied
The following dialog box may be displayed to inform that the
file access has been denied when deleting the above files in a
Windows 7 environment.
Continue the process by clicking the [Continue] button.
34
3.2 Uninstalling the Sensor Driver in Windows XP / Vista / 7 Environments Manually
35
Chapter4 Applying Modification to
the Sensor Driver Manually
which is Installed by Using
Archive version
37
Chapter4 Applying Modification to the Sensor Driver Manually which is Installed by Using Archive version
This section describes how to apply modification to the Sensor driver installed in
Windows XP / Vista / 7 environments by using Archive version manually.
>See> For information how to check version level information of the Sensor
driver, refer to the "System Development Guide".
Operation
Step1 Ensure that the Sensor is not connected to the target hardware.
Step3 Extract the downloaded archive version and copy the following files
from the folder created by the extraction to the hardware where the
Sensor driver is installed to overwrite the existing files.
The copy files and the folders to which the files copied are below.
38
4.1 Applying Modification to the Sensor Driver Installed in Windows XP / Vista / 7 Environments Manually
39
Section Ⅲ
(Windows Version)
41
Chapter5 Installing the Sensor Driver
for Extended Function
(Windows Version)
43
Chapter5 Installing the Sensor Driver for Extended Function (Windows Version)
This section describes how to install the Sensor driver for extended function
for Windows in Windows XP / Vista / 7 / 8 / 8.1 environments.
Operation
Step1 Ensure that the Sensor is not connected to the target hardware.
Step3 Extract the downloaded Sensor driver and copy the installer of the
Sensor driver “PSSD_32.msi” or “PSSD_64.msi” from the folder created
by the extraction to any folder on the target hardware.
44
5.1 Installing the Sensor Driver for Extended Function (Windows Version) in Windows XP / Vista / 7 / 8 / 8.1 Environments
45
Chapter5 Installing the Sensor Driver for Extended Function (Windows Version)
Step9 If there are multiple USB ports where the Sensor may be connected,
the Sensor must be detected on each USB port. Disconnect the Sensor
from the target hardware and repeat step 8 again.
46
5.2 Uninstalling the Sensor Driver for Extended Function (Windows Version) in Windows XP / Vista / 7 / 8 / 8.1 Environments
This section describes how to uninstall the Sensor driver for extended function
for Windows in Windows XP / Vista / 7 / 8 / 8.1 environments.
Operation
Step1 Ensure that the Sensor is not connected to the target hardware.
Step3 Select [Add or Remove Programs] (for Windows XP), or [Programs and
Features] or [Uninstall a program] (for Windows Vista / 7 / 8 / 8.1) from
Control Panel. Follow the instructions on the screen to delete "FUJITSU
PalmSecure Sensor Driver".
47
Chapter5 Installing the Sensor Driver for Extended Function (Windows Version)
This section explains the issues to be considered when using the Sensor driver
for extended function for Windows.
The Sensor driver for extended function for Windows is exclusively for the PalmSecure
Sensor V2. Do not connect a PalmSecure Sensor on target hardware on where you
have installed the Sensor driver for extended function for Windows. An error occurs
in the Sensor start sequence if you attempt to start the Authentication library while
a PalmSecure Sensor is connected. Also, if you once connect a PalmSecure Sensor,
the PalmSecure Sensor V2 may not operate properly when you re-connect it again
since information on the PalmSecure Sensor has been created in the Windows
device information.
Repair the Sensor driver for extended function for Windows as follows if the Sensor
has stopped operating properly due to the above reason.
Operation
Step1 Check that a PalmSecure Sensor V2 is connected as follows.
(4) Check the [Value] to ensure that the PalmSecure Sensor V2 is connected.
(“Rev_0200” indicates that a PalmSecure Sensor V2 is connected.)
48
5.3 Considerations and Notes
Step3 Repair the Sensor driver for extended function for Windows as follows.
(3) Click [Click here for support information] to display the support
information.
(4) Check [Version] to confirm that is the Sensor driver for extended
function for Windows. (“3.1.xxxx” indicates the Sensor driver
for extended function for Windows.)
(5) Click the [Repair] button at the bottom right of the screen to repair
the Sensor driver for extended function for Windows.
49
Chapter5 Installing the Sensor Driver for Extended Function (Windows Version)
(3) Check [Version] to confirm that is the Sensor driver for extended
function for Windows. (“3.1.xxxx” indicates the Sensor driver for
extended function for Windows.)
(4) Click [Repair] from the toolbar to repair the Sensor driver for extended
function for Windows.
50
Section Ⅳ
(Linux Version)
51
Chapter6 Installing the Sensor Driver
for Extended Function
(Linux Version)
53
Chapter6 Installing the Sensor Driver for Extended Function (Linux Version)
The Sensor driver for extended function for Linux is provided as the source code.
Modify and build the source code for the Senor driver for extended function
for Linux before installing on the target hardware.
The following steps describe how to modify and build the source code for the
Sensor driver for extended function for Linux.
Operation
Step1 Install the kernel-devel package of the target kernel version.
This step is not required if you have already installed.
Step2 Enter the full path to the folder where Makefile of the kernel is stored to
the following line within Makefile.
KERNDIR = # Set your target kernel source path.(Full path)
↑
Enter the path here
54
6.2 Installing the Sensor Driver for Extended Function (Linux Version)
This section describes how to install the Sensor driver for extended function
for Linux.
Operation
Step1 Ensure that the Sensor is not connected to the target hardware.
Step3 Use the “mkdir” command to create the “misc” folder under the
“/lib/modules/(kernel version)/” folder on the target hardware.
Command) mkdir /lib/modules/(kernel version)/misc
Step4 Copy the Sensor driver module you created in “6.1 Building the Sensor
Driver for Extended Function (Linux Version)” into the folder you
created in Step 3.
The following shows the file to be copied and the destination folder.
Step6 Use the “mknod” command to create a special file for sensor access
"fjveincam0”.
<When connecting one Senor>
Command) mknod -m 666 /dev/usb/fjveincam0 c 180 160
<When connecting more than one Sensor> (e.g. 2 Sensors)
Command) mknod -m 666 /dev/usb/fjveincam0 c 180 160
mknod -m 666 /dev/usb/fjveincam1 c 180 161
Step8 Use the “modprobe” command to load the Sensor driver module
“fjveincam”.
Command) /sbin/modprobe fjveincam
55
Chapter6 Installing the Sensor Driver for Extended Function (Linux Version)
Step9 Add the following lines to the start-up script (ex. /etc/rc.d/rc.local)
as necessary.
<When connecting one Senor>
mkdir -p /dev/usb
mknod -m 666 /dev/usb/fjveincam0 c 180 160
<When connecting more than one Sensor> (e.g. 2 Sensors)
mkdir -p /dev/usb
mknod -m 666 /dev/usb/fjveincam0 c 180 160
mknod -m 666 /dev/usb/fjveincam1 c 180 161
56
6.3 Uninstalling the Sensor Driver for Extended Function (Linux Version)
This section describes how to uninstall the Sensor driver for extended function
for Linux.
Operation
Step1 Disconnect the Sensor from the target hardware.
Step3 Use the “rm” command to delete a special file for sensor access
"fjveincam0”.
<When connecting one Senor>
Command) rm /dev/usb/fjveincam0
<When connecting more than one Sensor> (e.g. 2 Sensors)
Command) rm /dev/usb/fjveincam0
rm /dev/usb/fjveincam1
Step4 Delete the following lines from the start-up script (ex. /etc/rc.d/rc.local)
as necessary.
<When connecting one Senor>
mkdir -p /dev/usb
mknod -m 666 /dev/usb/fjveincam0 c 180 160
<When connecting more than one Sensor> (e.g. 2 Sensors)
mkdir -p /dev/usb
mknod -m 666 /dev/usb/fjveincam0 c 180 160
mknod -m 666 /dev/usb/fjveincam1 c 180 161
Step5 Use the “modprobe” command to delete the Sensor driver module
“fjveincam”.
Command) modprobe -r fjveincam
57