OBID PC/SC-Driver Serial · 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

MANUAL

finalpublic (B)2009-05-14H70401-1e-ID-B.doc

OBID® classic-pro

OBID®

PC/SC-Driver Serial

up from Version 2.08

OBID® classic-pro Manual OBID® PC/SC-Driver SERIAL

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

Note

© Copyright 2009 byFEIG ELECTRONIC GmbHLange Strasse 4D-35781 Weilburg-WaldhausenTel.: +49 6471 3109-0http://www.feig.de

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

Copying of this document, and giving it to others and the use or communication of the contents thereof areforbidden without express authority. Offenders are liable to the payment of damages. All rights are reservedin 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. FEIGELECTRONIC GmbH does not guarantee the correctness and completeness of the details given in thismanual 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 ELECTRONICGmbH does not give any guarantee promise for perfect function in cross environments and does not giveany 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 designedwith components and testing methods for a level of reliability suitable for use in or in connection with surgicalimplants or as critical components in any life support systems whose failure to perform can reasonably beexpected to cause significant injury to a human. To avoid damage, injury, or death, the user or applicationdesigner 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 docu-ment and makes no representation that they free of patent infringement. FEIG ELECTRONIC GmbH doesnot 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 SemiconductorsTag-itTM is a registered trademark of Texas Instruments IncorporatedMicrosoft® and Windows® are registered trademark of Microsoft Corporation

http://www.feig.de/



Contents

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



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

This is an agreement between you and FEIG ELECTRONIC GmbH (hereafter "FEIG") for use ofprovided software including the installation software setup_serial.exe, and the Driver SoftwareFEPCSCB.SYS, FEPCSCS.SYS, FEPCSCB.INF, FEPCSCS.INF, FEPCSCB.CAT and ,FEPCSCS.CAT, hereafter called licensing material. By installing and using the licensing materialyou agree to all terms and conditions of this agreement without exception and without limitation. Ifyou are not or not completely in agreement with the terms and conditions, you may not install thelicensing 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 touse it under the following conditions.

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

3. The licensing material may only be used in conjunction with devices which are developedand / 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 protectedin accordance with copyright, international agreements and relevant national statutes where it isused. The structure, organization and code of the software are a valuable business secret andconfidential information of FEIG and its suppliers.

2. You agree not to change, modify, adapt, translate, reverse engineer, decompile, disas-semble 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 otherlegal restrictions in the licensing material, you agree to keep these unchanged and to use themunchanged in all complete or partial copies which you make.

4. The publication and transmission to third parties of licensed material prohibited as longas 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 pro-grams such that they are without defect for all application conditions. FEIG calls explicit attention tothe fact that the installation of a new program may affect already existing software, including soft-ware which does not run simultaneous with the new software. In no event will FEIG be liable to youfor any consequential, incidental or special damages, including any lost profits or lost savings. Ifyou want to be sure that no already installed program will be affected, you may not install the li-censed material.



2. FEIG calls explicit attention to the fact that the use of the licensed material may result ir-reversible settings and adjustments to devices which may in turn destroy or otherwise make themunusable. 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 theperformance or the results you obtain from using the licensed material. FEIG assumes no liabilityor guarantee that the protection rights of third parties are not violated, nor that the software is suit-able for a particular purpose.

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

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

§4 final clause

1. This Agreement contains the complete licensing terms and conditions and supersedesany 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 declaredto be invalid or of no effect, the remaining provisions shall be in no manner affected thereby butshall remain in full force and effect. Both parties agree to replace the invalid provision with onewhich comes closest to its original intention.

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



Document Revision History

Revision Description

0 • First published edition

1 • Improvements and adaptations for new driver version 02.08.00



Driver Revision History

Version Description

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

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



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 Reader-Firmware max Baudrate

ID CPR.M02.VP/AB-B TCL ≥ 02.08.00 38.400

ID CPR.M02.VP/AB-BA TCL ≥ 02.08.00 38.400

ID CPR.M02.VP/AB-C TCL ≥ 02.08.00 230.400

ID CPR.M02.VP/AB-CA TCL ≥ 02.08.00 230.400

ID CPR.M02.VP/AB-CA TCL ≥ 02.08.00 230.400

ID CPR.02.VP/AB-BID CPR.02.10-B

TCL ≥ 02.06.00 38.400

ID CPR.02.VP/AB-AID CPR.02.10-AD

ID CPR.02.VP/AB-ATTCL ≥ 02.06.00 38.400

ID CPR40.0x-A ≥ 01.07.00 230.400

ID CPR40.0x-CD 3.3 ≥ 01.07.00 230.400

ID CPR40.0x-CDUSB ≥ 01.07.00 230.400

ID CPR40.30-A ≥ 01.07.00 230.400

The OBID® PC/SC-Driver structure in details:

• PC/SC serial DriverSmartCard RFID ReaderSmartCard 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 canbe 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 Transponder Type PC/SC Command Set

ISO 14443-3, Type A mifare ultraligth Storage Card Commands(*

ISO 14443-3, Type A mifare standard 1k Storage Card Commands(*

ISO 14443-3, Type A mifare standard 4k Storage Card Commands(*

ISO 14443-3, Type A my-d SLE55Rxx Storage Card Commands(*

ISO 14443-4, Type A mifare DESFire Processor Card CommandsISO 14443-4, Type A all common cards like SmartMX,

SLE66CL, etc. are suppoutedProcessor Card Commands

ISO 14443-4, Type B all common cards like SLE66CL,ST19WR66, Sharp etc.

are suppouted

Processor Card Commands

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



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



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.



2.1. Installation under Windows XP1

The following steps are necessary for the installation:

Start the setup softwaresetup_serial.exe and follow theinstructions of the setup assistant.

Choose the COM-Port that shouldbe alocated for the connection withthe reader.

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



Choose a target folder for thedriver installation.

The installation process will be dis-played.

During the installation you will getmessages, which you must accept.



After that two windows the installa-tion of the PC/SC-Driver for the se-rial reader is completed.

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

Choose:

Settings ⇒ Control Panel ⇒ System ⇒ Hardware ⇒ Device Manager



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

The operating system automatically startsthe installation wizard for the installation ofthe “SmartCard RFID Slot” Driver.

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

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



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 Se-rial v2.8.0”. Then press the button “Remove”.

The assistant for the uninstall routinewill start.

Follow the instructions of the assis-tant.



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 Modecan be used for processing a firmware update or other special device testing e.g. in connectionwith OBID® ISOStart Software.

Using the reader in standardmode you must disable theSmartcard RFID Reader (serial)in the device manager. So thechoosen COM-Port is not longerreserved by the PC/SC serviceand 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 theentry “Enable” out of the contextmenu of the SmartCard RFIDReader.

The choosen COM-Port will bereserved again for the PC/SC-Service

For Configuation of the Smart-Card RFID Reader Interfacechoose the entry “Properties” outof the context menu

Here you have the possibility to config-ure the COM-Port and the maximumbaud rate which is used to communi-cate with the reader



3.2. Using of PC/SC - Mode

After the Driver is installed on your PC System it starts running in PC/SC Mode. To communicatewith the connected OBID® ID CPR-Reader make sure that the Smart Card Service of your Win-dows operating system is enabled.

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

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

ID CPR.M02:LED Status Description

off The Reader is not powered or not connected with the PCgreen

flashing The Reader is powered off No Transponder is in the reading range of the Reader

redon Indicates an active communication between the Reader and a Transponder

ID CPR.02:LED Status Description

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

orange(red/green)

flashing Reader is ready for operation but has currently no communication with the PC.

ID CPR40.0x-xx:LED Status Description

off The Reader is not powered or not connected with the PCflashing The Reader is powered green

on Indicates an active communication between the Reader and the PCoff No Transponder is in the reading range of the Reader

redon Indicates a active communication between the Reader and a Transponder

ID CPR40.30-xx:LED Status Description

off The Reader is not powered or not connected with the PCflashing The Reader is powered blue

on Indicates an active communication between the Reader and the PCred off No Transponder is in the reading range of the Reader



4. PC/SC Storage Card Support

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

The following table gives a short overview about the supported Storage Card commandsTransponder TypePC/SC Command

mifare ultralight mifare standard 1kmifare standard 4k

my-d SLE55Rxx

Get UID • • •

Load Keys - • -

Authenticate - • -

Read Binary • • •

Update Binary • • •

4.1. Get UID

Command Class INS P1 P2 Lc Data In LeLoad Keys 0xFF 0xCA 0x00 0x00 - - XX

Content

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

4.2. Load Keys Command

Command Class INS P1 P2 Lc Data In LeLoad Keys 0xFF 0x82 Key

StructureKey Number Key Lenght Key -

Content 001x xxxx 0...31 0x06

Key Number (0...31):Even number (0, 2, 4,....30): Mifare Key AOdd number: (1, 3, 5..31): Mifare Key B



4.3. Authenticate Command

Command Class INS P1 P2 P3 Data In LeAuthenticate 0xFF 0x88 Address

MSBAddress

LSBKey Type Key No -

Content 0x00 0x600x61

0...15

Key Type:0x60: Mifare Key A0x61: Mifare Key B

4.4. PC/SC Read Binary Command

Command Class INS P1 P2 Lc Data In LeReadBinary

0xFF 0xB0 AddressMSB

AddressLSB

- - xx

Content 0x00 0...255 max 128

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

Address Range File Start Address Block Size max.File Size

Mifare Ultra light 0...15 0 4 byte 64 byteMifare Standard 1K 0...63 0, 4, 8, 12, ... 60 16 byte 64 byte

0...127 0, 4, 8, 12, ...124 16 byte 64 byteMifare Standard 4K

128...255 128, 144, 160...240 16 byte 256 byeSLE55Rxxxx 0...255 0 8 byte 2048 byte



4.5. Update Binary Command

Command Class INS P1 P2 Lc Data In LeUpdateBinary

0xFF 0xD6 AddressMSB

AddressLSB

XX Data -

Content 0x00 0...255 max. 128

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

Address Range File Start Address Block Size Lc max.Mifare Ultra light 0...15 0 4 byte 64 byteMifare Standard 1K 0...63 0, 4, 8, 12, ... 60 16 byte 64 byte

0...127 0, 4, 8, 12, ...124 16 byte 64 byteMifare Standard 4K

128...255 128, 144, 160...240 16 byte 256 byeSLE55Rxxxx 0...255 0 8 byte 2048 byte



5. Troubleshooting

Error What to do

Reader doesn’t workcorrectly in the operatingsystem

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

Please contact the FEIG OBID® Support:

Phone: +49 (6471) 3109-0Email: [email protected]

The OBID® Support Team need further details, which you can find inthe List of Events of your operating system.

Settings ⇒ Control Panel ⇒ Administrative Tools ⇒ Event Viewer

List of Events:

mailto:[email protected]



Error What to do

Application gets no datafrom the PC/SC interface

Check whether the SmartCard Service has been activated in your sys-tem 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.

Documents

OBID PC/SC-Driver Serial · 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