Simplifying System IntegrationTM 73S12xxF USB-CCID Host GUI Users Guide April 27, 2009 Rev. 1.
73S12xxF USB-CCID Host GUI Users Guide UG_12xxF_037 © 2009 Teridian Semiconductor Corporation. All rights reserved. Teridian Semiconductor Corporation is a registered trademark of Teridian Semiconductor Corporation. Simplifying System Integration is a trademark of Teridian Semiconductor Corporation. Microsoft is a registered trademark of Microsoft Corporation. Windows XP is a registered trademark of Microsoft Corporation. Visual Studio is a registered trademark of Microsoft Corporation.
UG_12xxF_037 73S12xxF USB-CCID Host GUI Users Guide Table of Contents 1. Introduction ......................................................................................................................................... 5 1.1 Scope ............................................................................................................................................ 5 1.2 Setup ........................................................................................................................
73S12xxF USB-CCID Host GUI Users Guide UG_12xxF_037 Figures Figure 1: USB CCID System ......................................................................................................................... 5 Figure 2: Add New Hardware Wizard Showing TSC CCID and Microsoft Drivers ....................................... 5 Figure 3: USB CCID Host Application Window .............................................................................................
UG_12xxF_037 1. 73S12xxF USB-CCID Host GUI Users Guide Introduction 1.1 Scope This user guide describes the use of the USB CCID host application (USB-CCID.exe). This software provides users with a Windows-based GUI application to communicate to the Teridian USB CCID reader firmware running on 73S12xxF-based smart card reader devices.
73S12xxF USB-CCID Host GUI Users Guide UG_12xxF_037 driver provides CCID compliant APDU level transfer of data and additionally addresses many of the shortcomings of the Microsoft driver, including: • Support for multiple reader slots. • PIN pad support. • LCD support. • Vendor/device-specific string name support in the device manager. • Support for mechanical features. The Device Reader should be powered up and ready to run. The USB-CCID.
UG_12xxF_037 2. 73S12xxF USB-CCID Host GUI Users Guide Operation The application window has several different functional frames. A transaction/text window displays all the USB communication traffic based on the USB CCID command/response exchange. The architecture software is defined as a master/slave configuration where the host PC is the master and the reader device is the slave.
73S12xxF USB-CCID Host GUI Users Guide UG_12xxF_037 Figure 4: USB CCID Host Application Window after Connecting 2.1.2.2 Reconnect Configuration Frame The Reconnect Configuration frame has three buttons: Warm Reset, Cold Reset and Leave. These are parameter selection flags used with the ScardReconnect() PC/SC command. Refer to the Microsoft Developer Network for a full explanation of these parameters. In most cases, these selections can be left at the default setting. 2.1.2.
UG_12xxF_037 2.1.3 73S12xxF USB-CCID Host GUI Users Guide APDU Command Frame The APDU command frame contains controls to transmit an APDU command to the current smart card slot and to allow repetition based on a specified time interval. The APDU command frame is shown in Figure 5. Figure 5: APDU Command Frame 2.1.3.1 APDU Command Text Box The APDU command text box allows the user to configure a ScardTransmit() PC/SC command. The APDU command may be manually entered into this text box.
73S12xxF USB-CCID Host GUI Users Guide UG_12xxF_037 Figure 6: EMV/ISO Mode Frame It is recommended that the loop delay be set to at least 20 seconds. Teridian’s internal EMV Level I test has shown better results with delay setting at 25 seconds. This is due to the long cycle of some tests and especially the way Windows’ Resource Manager handles automatic retry activations of Smart Card.
UG_12xxF_037 73S12xxF USB-CCID Host GUI Users Guide 2.1.4.3 Start Button When the Start button is clicked, a sequence of commands is sent to the Device. The Device needs to be configured to go into EMV Test Mode and which Test Mode it should process. This process is done via the CCID’s Escape(*) command. Windows requires that a Smart Card be activated BEFORE any commands are acceptable with a functional Smart Card inserted into slot 0.
73S12xxF USB-CCID Host GUI Users Guide UG_12xxF_037 2.1.5.1 Predefined Message The predefined message frame allows the selection of four pre-defined messages. The Message Index dropdown box has three indexes listed as 0, 1 and 2. When each index is selected, the message is displayed in the LCD display box exactly as it appears on a 2 row by a 16 column LCD display. Messages are shown in Figure 8.
UG_12xxF_037 2.1.6 73S12xxF USB-CCID Host GUI Users Guide KeyPad Tests Frame The KeyPad Tests frame contains two sub-frames, one that displays a six row by a five column image matrix and the other to configure the keypad matrix. Figure 9 shows the KeyPad Tests Frame. The number of rows and columns configuration must be configured before any keypad operations can be initiated. The image matrix remains grayed until the configuration is sent to the device.
73S12xxF USB-CCID Host GUI Users Guide 2.1.8 UG_12xxF_037 DFU Frame The DFU frame is divided into two sub-frames. The Detach sub-frame is used to initiate a DFU process. The DFU Requests sub-frame consists of five DFU command buttons that can be used to test DFU requests individually. Additionally, the DFU frame displays the version numbers of the boot loader and firmware application that are currently running in the smart card reader.
UG_12xxF_037 73S12xxF USB-CCID Host GUI Users Guide Figure 11: DFU Request Sub-frame Is Activated after a DFU Device Has Been Selected 2.1.8.2 DFU Requests Sub-frame A smart card reader that has transitioned into the DFU mode is referred as a DFU device by the host application program. The DFU Requests sub-frame is enabled only after a DFU device in the Card Reader list box has been selected.
73S12xxF USB-CCID Host GUI Users Guide 2.1.8.2.1 UG_12xxF_037 Download Clicking the Download button starts the operation of firmware download. A file browser window appears, allowing the user to specify a CCID firmware image file that will be downloaded to the DFU device. The firmware image file should be in Intel hex format with a .hex file name extension. Upon the file selection, the host application displays a warning message requesting a confirmation from the user to proceed with the download.
UG_12xxF_037 2.1.8.2.5 73S12xxF USB-CCID Host GUI Users Guide Abort The host application sends out a DFU_ABORT request to the DFU device when the Abort button is pressed. This request forces the DFU device to exit from its current state and return to the DFU Idle state. 2.1.9 Terminate Button To cancel any of the loopback tests, click the Terminate button – it becomes gray and the other controls will be restored to the state before clicking the associated Start button.
73S12xxF USB-CCID Host GUI Users Guide UG_12xxF_037 Figure 15: Time Stamp Selection Dialog Box The Time tab enables or disables a time and date stamp when running loopback tests. This is applicable to both the transaction window and log files. The second tab configures the log file as shown in Figure 16. It enables or disables the log file and allows the log file to be named. Figure 16: Log Dialog Box . 18 Rev. 1.
UG_12xxF_037 3.
73S12xxF USB-CCID Host GUI Users Guide UG_12xxF_037 Appendix A – EMV Level I Certification Test EMV compliant test suite follows its specification written for Payment System Environment. There are several test labs, listed on EMVco.com website, qualified to perform these tests. At this writing, there are two available Protocol test suites that either one, will/can be used to qualify for EMV Level I compliance. In other words, passing either one of these suites will qualify as EMV Level I compliance.
UG_12xxF_037 73S12xxF USB-CCID Host GUI Users Guide Initialization Yes SingleShot? Enter (M/m) Multior (anykey) Single Shot? No M/m Enter Delay Time (in Secs) EMV Power Down Delay Time Wait Any other Key EMV Power Up in Test Mode No No Power-Up Ok (Good ATR)? Inform Device via Escape command with EMV Test Mode and Test Environment (MCI, VISA 1, VISA 2) No Yes Start Test by sending a Block Transfer (0x6F) with 0 Lenth data Figure 17: Invoking the EMV PSE Test Environment Rev. 1.
73S12xxF USB-CCID Host GUI Users Guide UG_12xxF_037 Revision History Revision Date Description 1.0 2/27/2009 First publication. 1.1 4/27/2009 Added Section 2.1.7 LED Frame and Section 2.1.8 DFU Frame. Reformatted document in Teridian style. 22 Rev. 1.