OBID classic-pro PC/SC driver Manual

PDF

Dokument

Reklama

OBID

classic-pro MANUAL

OBID

®

PC/SC-Driver Serial

up from Version 2.08

final public (B)

2009-05-14

H70401-1e-ID-B.doc

OBID

classic-pro Manual OBID

PC/SC-Driver SERIAL

Note

FEIG ELECTRONIC GmbH

Lange Strasse 4

D-35781 Weilburg-Waldhausen

Tel.: +49 6471 3109-0 http://www.feig.de

With the edition of this document, all previous editions become void. Indications made in this manual may be changed without previous notice.

Copying of this document, and giving it to others and the use or communication of the contents thereof are forbidden without express authority. Offenders are liable to the payment of damages. All rights are reserved in the event of the grant of a patent or the registration of a utility model or design.

Composition of the information in this document has been done to the best of our knowledge. FEIG

ELECTRONIC GmbH does not guarantee the correctness and completeness of the details given in this manual and may not be held liable for damages ensuing from incorrect or incomplete information. Since, despite all our efforts, errors may not be completely avoided, we are always grateful for your useful tips.

The instructions given in this manual are based on advantageous boundary conditions. FEIG ELECTRONIC

GmbH does not give any guarantee promise for perfect function in cross environments and does not give any guaranty for the functionality of the complete system which incorporates the subject of this document.

FEIG ELECTRONIC call explicit attention that devices which are subject of this document are not designed with components and testing methods for a level of reliability suitable for use in or in connection with surgical implants or as critical components in any life support systems whose failure to perform can reasonably be expected to cause significant injury to a human. To avoid damage, injury, or death, the user or application designer must take reasonably prudent steps to protect against system failures.

FEIG ELECTRONIC GmbH assumes no responsibility for the use of any information contained in this document and makes no representation that they free of patent infringement. FEIG ELECTRONIC GmbH does not convey any license under its patent rights nor the rights of others.

OBID

and OBID i-scan

is a registered trademark of FEIG ELECTRONIC GmbH.

I-CODE

and mifare

is a registered trademark of NXP Semiconductors

Tag-it

is a registered trademark of Texas Instruments Incorporated

Microsoft

and Windows

are registered trademark of Microsoft Corporation

FEIG ELECTRONIC GmbH Page 2 of 22 H70401-1e-ID-B.doc

OBID

classic-pro Manual OBID

PC/SC-Driver SERIAL

Licensing Agreement Concerning Use of OBID PC/SC-Driver Software ......................4

Document Revision History ..............................................................................................6

Driver Revision History .....................................................................................................7

1. Introduction...................................................................................................................8

1.1. System Requirements.........................................................................................................9

2. Installation of the PC/SC-Driver................................................................................. 10

2.1. Installation under Windows XP........................................................................................11

2.2. Removing the OBID

PC/SC-Driver .................................................................................15

3. Using the Driver .......................................................................................................... 16

3.1. Switching over between PC/SC - Mode and OBID

Standard Mode.............................16

3.2. Using of PC/SC - Mode .....................................................................................................17

4. PC/SC Storage Card Support..................................................................................... 18

4.1. Get UID ...............................................................................................................................18

4.2. Load Keys Command........................................................................................................18

4.3. Authenticate Command ....................................................................................................19

4.4. PC/SC Read Binary Command.........................................................................................19

4.5. Update Binary Command .................................................................................................20

5. Troubleshooting ......................................................................................................... 21

FEIG ELECTRONIC GmbH Page 3 of 22 H70401-1e-ID-B.doc

OBID

classic-pro Manual OBID

PC/SC-Driver SERIAL

Licensing Agreement Concerning Use of OBID PC/SC-Driver Software

This is an agreement between you and FEIG ELECTRONIC GmbH (hereafter "FEIG") for use of provided software including the installation software setup_serial.exe, and the Driver Software

FEPCSCB.SYS, FEPCSCS.SYS, FEPCSCB.INF, FEPCSCS.INF, FEPCSCB.CAT and ,

FEPCSCS.CAT, hereafter called licensing material. By installing and using the licensing material you agree to all terms and conditions of this agreement without exception and without limitation. If you are not or not completely in agreement with the terms and conditions, you may not install the licensing material or use it in any way.

§1 Subject and Scope of the Agreement

1. FEIG grants you the non exclusive right to install the licensing material provided and to use it under the following conditions.

2. You may install all components of the licensing material on a hard disk or an other storage medium. You may create backup copies of the licensing material.

3. The licensing material may only be used in conjunction with devices which are developed and / or produced by FEIG.

§2 Protection of the licensing material

1. The licensed material is the intellectual property of FEIG and its suppliers. It is protected in accordance with copyright, international agreements and relevant national statutes where it is used. The structure, organization and code of the software are a valuable business secret and confidential information of FEIG and its suppliers.

2. You agree not to change, modify, adapt, translate, reverse engineer, decompile, disassemble or otherwise attempt to discover the source code of the licensed material.

3. To the extent that FEIG has applied protection marks, such as copyright marks and other legal restrictions in the licensing material, you agree to keep these unchanged and to use them unchanged in all complete or partial copies which you make.

4. The publication and transmission to third parties of licensed material prohibited as long as no explicit agreement to the contrary has been established between you and FEIG .

§3 Warranty and liability limitations

1. You agree with FEIG that it is not possible to develop electronic data processing programs such that they are without defect for all application conditions. FEIG calls explicit attention to the fact that the installation of a new program may affect already existing software, including software which does not run simultaneous with the new software. In no event will FEIG be liable to you for any consequential, incidental or special damages, including any lost profits or lost savings. If you want to be sure that no already installed program will be affected, you may not install the licensed material.

FEIG ELECTRONIC GmbH Page 4 of 22 H70401-1e-ID-B.doc

OBID

classic-pro Manual OBID

PC/SC-Driver SERIAL

2. FEIG calls explicit attention to the fact that the use of the licensed material may result irreversible settings and adjustments to devices which may in turn destroy or otherwise make them unusable. FEIG assumes no liability for such actions whether knowingly or unknowingly.

3. FEIG provides the software "as is“ and without any warranty. FEIG cannot guarantee the performance or the results you obtain from using the licensed material. FEIG assumes no liability or guarantee that the protection rights of third parties are not violated, nor that the software is suitable for a particular purpose.

4. FEIG call explicit attention the licensed material is not designed with components and testing for a level of reliability suitable for use in or in connection with surgical implants or as critical components in any life support systems whose failure to perform can reasonably be expected to cause significant injury to a human.

To avoid damage, injury, or death, the user or application designer must take reasonably prudent steps to protect against system failures.

§4 final clause

1. This Agreement contains the complete licensing terms and conditions and supersedes any prior agreements and terms. Changes and additions must be made in writing.

2. If any provision in this agreement is declared to be void, or if for any reason is declared to be invalid or of no effect, the remaining provisions shall be in no manner affected thereby but shall remain in full force and effect. Both parties agree to replace the invalid provision with one which comes closest to its original intention.

3. This agreement is subject to the laws of the Federal Republic of Germany. Place of jurisdiction is Frankfurt a. M.

FEIG ELECTRONIC GmbH Page 5 of 22 H70401-1e-ID-B.doc

OBID

classic-pro Manual

Document Revision History

Revision

•

First published edition

Description

•

Improvements and adaptations for new driver version 02.08.00

OBID

PC/SC-Driver SERIAL

FEIG ELECTRONIC GmbH Page 6 of 22 H70401-1e-ID-B.doc

OBID

classic-pro

Driver Revision History

Manual

Version

01.00.00

•

First released version

•

Supported reader:

- ID CPR.M02.VP/AB-x

- ID CPR.02.VP/AB-x; ID CPR.02.10-x

Description

01.09.00

•

Adding of support of SR176, SRIxx Transponder

02.08.00

•

Bugfix for longer transmitted APDUs

•

Adding of support for 2 SAM card slots.

•

Improvement for longer transmitted APDUs

•

Supported reader:

- ID CPR.M02.VP/AB-B - TCL

≥ 02.08.00

- ID CPR.M02.VP/AB-BA - TCL

≥ 02.08.00

- ID CPR.M02.VP/AB-C - TCL

≥ 02.08.00

- ID CPR.M02.VP/AB-CA - TCL

≥ 02.08.00

- ID CPR.M02.VP/AB-CA - TCL

≥ 02.08.00

- ID CPR.02.VP/AB-B - TCL

≥ 02.06.00

- ID CPR.02.10-B - TCL

≥ 02.06.00

- ID CPR.02.VP/AB-A - TCL

≥ 02.06.00

- ID CPR.02.10-AD - TCL

≥ 02.06.00

- ID CPR.02.VP/AB-AT - TCL

≥ 02.06.00

- ID CPR40.0x-A -

≥ 01.07.00

- ID CPR40.0x-CD 3.3 -

≥ 01.07.00

- ID CPR40.0x-CDUSB -

≥ 01.07.00

-ID CPR40.30-A -

≥ 01.07.00

OBID

PC/SC-Driver SERIAL

FEIG ELECTRONIC GmbH Page 7 of 22 H70401-1e-ID-B.doc

OBID

classic-pro Manual OBID

PC/SC-Driver SERIAL

1. Introduction

This manual will give you a guideline for installation and possibilities of the OBID

PC/SC-Driver.

The manual describes the installation procedure for Windows XP

The OBID

PC/SC-Driver serial supports the following OBID

classic-pro Readers :

Device

ID CPR.M02.VP/AB-B

ID CPR.M02.VP/AB-BA

ID CPR.M02.VP/AB-C

ID CPR.M02.VP/AB-CA

Reader-Firmware

TCL

≥ 02.08.00

TCL

≥ 02.08.00

TCL

≥ 02.08.00

TCL

≥ 02.08.00

TCL

≥ 02.08.00

max Baudrate

38.400

230.400

ID CPR.02.VP/AB-B

ID CPR.02.10-B

ID CPR.02.VP/AB-A

ID CPR.02.10-AD

ID CPR.02.VP/AB-AT

ID CPR40.0x-A

ID CPR40.0x-CD 3.3

ID CPR40.0x-CDUSB

ID CPR40.30-A

TCL

≥ 02.06.00

TCL

≥ 02.06.00

≥ 01.07.00

38.400

230.400

The OBID

PC/SC-Driver structure in details:

• PC/SC serial Driver

SmartCard RFID Reader

SmartCard RFID Slot

After the OBID

PC/SC-Driver is installed it can used in PC/SC-Mode or in OBID

Standard Mode.

The PC/SC Mode is designed for your PC/SC Application whereas the OBID

Standard Mode can be used for service and testing purposes and firmware updates as well.

The following Transponder Types are supported by the OBID

PC/SC-Driver:

ISO Standard

ISO 14443-3, Type A

ISO 14443-4, Type A

ISO 14443-4, Type B

Transponder Type

mifare ultraligth mifare standard 1k mifare standard 4k my-d SLE55Rxx mifare DESFire all common cards like SmartMX,

SLE66CL, etc. are suppouted all common cards like SLE66CL,

ST19WR66, Sharp etc.

are suppouted

PC/SC Command Set

Storage Card Commands

Processor Card Commands

* The storage Card support is implemented on basis of PC/SC specification, Part 3, Revision 2.01.07 (December 2005)

FEIG ELECTRONIC GmbH Page 8 of 22 H70401-1e-ID-B.doc

OBID

classic-pro Manual OBID

PC/SC-Driver SERIAL

1.1. System Requirements

The following system requirements are needed for the PC/SC Driver:

• Operating System:

Windows 32Bit Systems

(Windows 2000 SP4, Windows Server 2003, Windows XP SP2,

Vista)

• serial RS232 Interface

FEIG ELECTRONIC GmbH Page 9 of 22 H70401-1e-ID-B.doc

OBID

classic-pro Manual OBID

PC/SC-Driver SERIAL

2. Installation of the PC/SC-Driver

The installation of the PC/SC-Driver will be done in two steps:

1. Start the setup software setup_serial.exe and follow the instructions of the setup assistant.

2. Installation of the “SmartCard RFID Slot” driver after a reader is connected with the PC

It is important to close all the other programs before beginning the installation of the driver.

FEIG ELECTRONIC GmbH Page 10 of 22 H70401-1e-ID-B.doc

OBID

classic-pro Manual

2.1. Installation under Windows XP

The following steps are necessary for the installation:

Start the setup software setup_serial.exe and follow the instructions of the setup assistant.

OBID

PC/SC-Driver SERIAL

Choose the COM-Port that should be alocated for the connection with the reader.

For the installation of the driver you need administrative-rights!

FEIG ELECTRONIC GmbH Page 11 of 22 H70401-1e-ID-B.doc

OBID

classic-pro

Choose a target folder for the driver installation.

Manual OBID

PC/SC-Driver SERIAL

The installation process will be displayed.

During the installation you will get messages, which you must accept.

FEIG ELECTRONIC GmbH Page 12 of 22 H70401-1e-ID-B.doc

OBID

classic-pro

After that two windows the installation of the PC/SC-Driver for the serial reader is completed.

Manual OBID

PC/SC-Driver SERIAL

After successful installation of the complete PC/SC-Driver the device manager shows the following device entry.

Choose:

Settings

⇒

Control Panel

⇒

System

⇒

Hardware

⇒

Device Manager

FEIG ELECTRONIC GmbH Page 13 of 22 H70401-1e-ID-B.doc

OBID

classic-pro Manual OBID

PC/SC-Driver SERIAL

If you have connected a reader with the choosen COM-Port, the “Reader Slot” driver will be installed as well.

The operating system automatically starts the installation wizard for the installation of the “SmartCard RFID Slot” Driver.

Now the installation is complete and you can use your reader in PC/SC-Mode.

In the device manager you should find the following device entry for your reader:

FEIG ELECTRONIC GmbH Page 14 of 22 H70401-1e-ID-B.doc

OBID

classic-pro Manual OBID

PC/SC-Driver SERIAL

2.2. Removing the OBID

PC/SC-Driver

Choose: Settings

⇒

Control Panel

⇒ Add or Remove Programs

For removing the OBID

PC/SC-Driver open the and choose the entry “FEIG PC/SC Driver for Serial v2.8.0”. Then press the button “Remove”.

The assistant for the uninstall routine will start.

Follow the instructions of the assistant.

FEIG ELECTRONIC GmbH Page 15 of 22 H70401-1e-ID-B.doc

OBID

classic-pro Manual OBID

PC/SC-Driver SERIAL

3. Using the Driver

3.1. Switching over between PC/SC - Mode and OBID

Standard Mode

In OBID

Standard - Mode the driver can used with non PC/SC - Application. The Standard Mode can be used for processing a firmware update or other special device testing e.g. in connection with OBID

ISOStart Software.

Using the reader in standard mode you must disable the

Smartcard RFID Reader (serial) in the device manager. So the choosen COM-Port is not longer reserved by the PC/SC service and can be used as usual.

The functionality of the reader in this mode is documented in the OBID

ID CPR-Family Manual.

For switching on the PC/SC-

Mode again, you must choose the entry “Enable” out of the context menu of the SmartCard RFID

Reader.

The choosen COM-Port will be reserved again for the PC/SC-

Service

For Configuation of the Smart-

Card RFID Reader Interface choose the entry “Properties” out of the context menu

Here you have the possibility to configure the COM-Port and the maximum baud rate which is used to communicate with the reader

FEIG ELECTRONIC GmbH Page 16 of 22 H70401-1e-ID-B.doc

OBID

classic-pro Manual OBID

PC/SC-Driver SERIAL

3.2. Using of PC/SC - Mode

After the Driver is installed on your PC System it starts running in PC/SC Mode. To communicate with the connected OBID

ID CPR-Reader make sure that the Smart Card Service of your Windows operating system is enabled.

Just as the PC/SC - Mode is running and the reader is connect to your PC the reader is polled permanently by the PC/SC-Driver.

The LED of the reader indicates some processing statuses of the system.

ID CPR.M02:

LED

green red

Status Description

off The Reader is not powered or not connected with the PC flashing The Reader is powered off No Transponder is in the reading range of the Reader on Indicates an active communication between the Reader and a Transponder

ID CPR.02:

LED

orange

(red/green)

Status

off on

Description

The Reader is not powered or not connected with the PC

Indicates an active communication between the Reader and the PC flashing Reader is ready for operation but has currently no communication with the PC.

ID CPR40.0x-xx:

LED

green red

Status Description

off The Reader is not powered or not connected with the PC flashing The Reader is powered on Indicates an active communication between the Reader and the PC off on

No Transponder is in the reading range of the Reader

Indicates a active communication between the Reader and a Transponder

ID CPR40.30-xx:

LED

blue red

Status

off flashing The Reader is powered

Description

The Reader is not powered or not connected with the PC on off

Indicates an active communication between the Reader and the PC

No Transponder is in the reading range of the Reader

FEIG ELECTRONIC GmbH Page 17 of 22 H70401-1e-ID-B.doc

OBID

classic-pro Manual OBID

PC/SC-Driver SERIAL

4. PC/SC Storage Card Support

This chapter describes the implementation of PC/SC Storage Card commands in relation to the supported Transponder Types.

The following table gives a short overview about the supported Storage Card commands

PC/SC Command

Get UID

Load Keys

Authenticate

Read Binary

Update Binary mifare ultralight

•

Transponder Type mifare standard 1k mifare standard 4k

•

my-d SLE55Rxx

•

4.1. Get UID

Command

Load Keys

Content

Class

0xFF

INS

0xCA

0x00

Data In

Le:

0x00: Returns the full length of the UID. The usage of this Le value is recommended.

4.2. Load Keys Command

Command

Load Keys

Content

Class

0xFF

INS

0x82

Key

Structure

001x xxxx

P2 Lc

Key Number Key Lenght

0...31

0x06

Data In

Key

Key Number (0...31):

Even number (0, 2, 4,....30):

Odd number: (1, 3, 5..31):

Mifare Key A

Mifare Key B

FEIG ELECTRONIC GmbH Page 18 of 22 H70401-1e-ID-B.doc

OBID

classic-pro

4.3. Authenticate Command

Manual OBID

PC/SC-Driver SERIAL

Command

Authenticate

Content

Class

0xFF

Key Type:

0x60: Mifare Key A

0x61: Mifare Key B

INS

0x88

Address

MSB

0x00

Address

LSB

Key Type

0x60

0x61

Data In

Key No

0...15

4.4. PC/SC Read Binary Command

Command

Read

Binary

Content

Class

0xFF

INS

0xB0

Address

MSB

0x00

Address

LSB

0...255

Data In

Le xx max 128

Le:

The Le parameter must match to the Block Size of the Transponder.

Mifare Ultra light

Mifare Standard 1K

Mifare Standard 4K

SLE55Rxxxx

Address Range

0...15

0...63

0...127

128...255

0...255

File Start Address

0, 4, 8, 12, ... 60

0, 4, 8, 12, ...124

128, 144, 160...240

Block Size

4 byte

16 byte

8 byte

max.

File Size

64 byte

256 bye

2048 byte

FEIG ELECTRONIC GmbH Page 19 of 22 H70401-1e-ID-B.doc

OBID

classic-pro

4.5. Update Binary Command

Manual OBID

PC/SC-Driver SERIAL

Command

Update

Binary

Content

Class

0xFF

INS

0xD6

Address

MSB

0x00

Address

LSB

0...255

XX max. 128

Data In

Data

Lc:

The Lc parameter must match to the Block Size of the Transponder.

Mifare Ultra light

Mifare Standard 1K

Mifare Standard 4K

SLE55Rxxxx

Address Range File Start Address Block Size

0...15

0 4 byte

0...63

0...127

0, 4, 8, 12, ... 60

0, 4, 8, 12, ...124

16 byte

128...255

0...255

128, 144, 160...240

16 byte

8 byte

Lc max.

64 byte

256 bye

2048 byte

FEIG ELECTRONIC GmbH Page 20 of 22 H70401-1e-ID-B.doc

OBID

classic-pro

5. Troubleshooting

Manual OBID

PC/SC-Driver SERIAL

Error What to do

Reader doesn’t work correctly in the operating system

Check the entries in the device manager after you’ve plugged in the reader device (find correct device manager entries: End of Chapter 2.1,

page 6)

Please contact the FEIG OBID

Support:

Phone: +49 (6471) 3109-0

Email: [email protected]

The OBID

Support Team need further details, which you can find in the List of Events of your operating system.

Settings

⇒

Control Panel

⇒

Administrative Tools

⇒

Event Viewer

List of Events:

FEIG ELECTRONIC GmbH Page 21 of 22 H70401-1e-ID-B.doc

OBID

classic-pro Manual OBID

PC/SC-Driver SERIAL

Error What to do

Application gets no data from the PC/SC interface

Check whether the SmartCard Service has been activated in your system environment:

Settings

⇒

Control Panel

⇒

Administrative Tools

⇒

Services

The service which must be running is called „Smart Card“

If this service is not marked as „Started“, then click on the „Smart Card“ entry and the following window will appear.

Here you have the possibility to start the service by pressing the „Start“ button.

FEIG ELECTRONIC GmbH Page 22 of 22 H70401-1e-ID-B.doc

Dobrý den! Jsem AI chatbot speciálně vyškolený, abych vám pomohl s OBID classic-pro PC/SC driver Manual. Důkladně jsem prošel dokument a mohu vám pomoci najít přesné informace, které potřebujete, nebo vysvětlit obsah jasně a jednoduše. Ať už hledáte pokyny ke konkrétním funkcím, kroky pro odstraňování problémů nebo obecné použití, neváhejte se zeptat. Čím více podrobností uvedete o svých obavách nebo potřebách, tím přesněji a efektivněji vám mohu pomoci!

Asistent píše

Asistent je mimo klávesnici. Zkuste to prosím později.

Obsah

Zdá se, že jste narazili na dokument, který je napsán ve více jazycích, včetně jazyka, který není váš rodný. Pomocí následujících odkazů můžete dočasně skrýt stránky bez jazyka, kterému dáváte přednost.