Gemalto Prox-DU Reference Manual

Gemalto Prox-DU Reference Manual

Dual interface usb smart card reader
Hide thumbs Also See for Prox-DU:
Table of Contents

Advertisement

Reference Manual
Preliminary
Prox–DU & Prox–SU
Prox–DU & Prox–SU
Dual interface USB smart card reader
Reference Manual (preliminary)
Release for first samples
Do not use for final design
www.gemalto.com
DOC118569A
Public Use
Page 1/134

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the Prox-DU and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Gemalto Prox-DU

  • Page 1 Reference Manual Preliminary Prox–DU & Prox–SU Prox–DU & Prox–SU Dual interface USB smart card reader Reference Manual (preliminary) Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 1/134...
  • Page 2 All information herein is either public information or is the property of and owned solely by Gemalto NV. and/or its subsidiaries who shall have and keep the sole right to file patent applications or any other kind of intellectual property protection in connection with such information.
  • Page 3 Reference Manual Preliminary Prox–DU & Prox–SU REVISION HISTORY Date Release Comments First release for pre-production run samples January 2010 V1.01-GXD14 version and before Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 3/134...
  • Page 5: Table Of Contents

    CRC control......................35 MAD CRC calculation program ................35 USING PC/SC APPLICATION ....................37 PC/SC O ......................37 VERVIEW _PC/SC .................... 40 SOFTWARE TOOL Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 5/134...
  • Page 6 PC_to_RDR_XfrBlock command ................68 PC_to_RDR_GetParameters command ..............69 PC_to_RDR_ResetParameters command............... 69 PC_to_RDR_SetParameters command..............69 PC_to_RDR_Escape command................71 Switch interface....................71 Card movement notification enable ..............72 Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 6/134...
  • Page 7 FIRMWARE VERSIONING RULES ..................97 ................... 97 EADER FIRMWARE STRING VERSION ................... 97 LOADER STRING VERSION USB DESCRIPTORS ......................98 USB D ................... 98 TANDARD ESCRIPTORS Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 7/134...
  • Page 8 MIFARE 4K M ..................122 EMORY APPING ® MIFARE UL M ..................124 EMORY APPING Serial Number Area ....................124 Lock Bytes Area......................125 Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 8/134...
  • Page 9 Table 34 – USB HID Class Descriptor ................100 Table 35 – USB HID Interface Endpoint Descriptor............100 Table 36 – USB HID Report Descriptor ................101 Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 9/134...
  • Page 10 Figure 26 – Prox–SU PC/SC name..................41 Figure 27 – Prox–DU and Prox–SU PC/SC names .............. 41 Figure 28 – Two Prox–DU PC/SC names................41 Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 10/134...
  • Page 11 Figure 29 - Information provided by T0 ................. 59 Figure 30 - Information provided by TDi................59 Figure 31 – Push button PCB location (S1) ................ 110 Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 11/134...
  • Page 12: Introduction

    Contact Our Hotline If you do not find the information you need in this document, or if you find errors, contact the Gemalto hotline at http://support.gemalto.com/. Please note the document reference number, your job function, and the name of your company.
  • Page 13: Overview

    Preliminary Prox–DU & Prox–SU Overview Description The Prox–DU and the Prox–SU are Gemalto smart card reader/writers embedding the Prox and the GemCore technologies developed by Gemalto to interface contactless and contact smart cards: • The Prox–DU is a dual interface (contact and contactless) USB smart card...
  • Page 14: Main Features

    Embedded protection against dual interface smart card damage and switch feature to select the active interface (contact or contactless) Prox and GemCore are Gemalto proprietary technologies developed for contactless and contact reader/writers. It is based on a specific operating system that interfaces with contactless and contact smart cards.
  • Page 15: Prox-Du And Prox-Su Differences

    Dual interface protection Can be disabled according to No management device configuration Switch interface command Available Not useful Product name in the string Gemalto Prox-DU Gemalto Prox-SU version Product string in USB Prox Dual USB Prox SU USB descriptor PC Link Reader...
  • Page 16: Smart Card Protection And Switch Feature

    Note: As it is not possible to have a dual interface SIM/SAM card, the smart card protection is not active with the Prox–SU device. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 16/134...
  • Page 17: Using Smart Cards

    To activate the contactless smart card when it is fully inserted into the slot, the switch feature of the device should be activated. Refer to the switch feature paragraph below for more information. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 17/134...
  • Page 18: Figure 10 – The Contact Smart Card Is Fully Inserted Into The Prox–Du Slot

    Figure 12 – The contact SIM/SAM card is inserted into the Prox–SU connector Note: the SIM/SAM card cannot be installed or removed without opening the casing. The SIM/SAM card is permanently installed into the Prox–SU reader. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 18/134...
  • Page 19: Environmental Characteristics

    Operating RF Off Power Supply Current < 2.5 mA Suspend EMC Regulations FCC Part 15 Class B Safety UL 60950 Recognized Table 3 - Environmental Characteristics Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 19/134...
  • Page 20: Interface Capability

    Contactless card (No connector) (No connector) One blue LED One blue LED Visual Indicators One yellow LED One yellow LED Table 4 – Interface capability Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 20/134...
  • Page 21: Interface Features

    This contactless interface complies with the ISO14443-A&B standard. The characteristics for the contactless interface are as follows: Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 21/134...
  • Page 22: Contact Interface

    Figure 16 – ID-1 and ID-000 card size • Card baud rate: up to 500 kbps (TA1 = 97h for a clock frequency of 4 MHz) Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 22/134...
  • Page 23: Led Interface

    Flashing The card communication is in progress Note: When no SIM/SAM card is inserted into the Prox–SU, the yellow indicator will always be off. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 23/134...
  • Page 24: Installing The Reader/Writer

    Use the latest CCID package (CCID driver V1.3.11 minimum) available in Mac OS X Tiger (10.4) Inbox the web site http://support.gemalto.com Use the latest CCID package (CCID Mac OS X Leopard (10.5) Inbox driver V1.3.11 minimum) available in Release for first samples Do not use for final design www.gemalto.com...
  • Page 25 Prox–DU & Prox–SU the web site http://support.gemalto.com Note that Gemalto is actively involved in the development and improvement of the Linux and Mac libraries. Note that all the drivers needed for the Prox–DU and the Prox–SU reader/writer are the standard drivers available into the operating system. No Gemalto proprietary drivers are needed, Microsoft Windows CE R5.0 &...
  • Page 26: Windows Xp Installation

    Found New Hardware Found New Hardware USB Human Interface Device USB Human Interface Device Found New Hardware Found New Hardware Prox-DU Contactless Interface Prox-DU Contactless Interface Found New Hardware Found New Hardware USB Smart Card reader USB Smart Card reader...
  • Page 27: Windows Xp Installation Using The Windows Update Procedure

    When the USB cable is plugged into the USB port of the computer the following wizard will appear: • Click the “Yes, this time only” button to start the Windows Update procedure • Click the “Next” button to continue Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 27/134...
  • Page 28 Now the installation is finished. Your Prox–DU or Prox–SU device is ready to use. Note: depending on the network configuration, the Windows Update procedure can take a long time. Please wait until the end of the procedure. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 28/134...
  • Page 29: Checking The Installation

    The smart card used for the check should be of course ISO14443–A or ISO14443–B compliant. Otherwise, no LED change will occur. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 29/134...
  • Page 30: Figure 22 – Contact Smart Card Check

    The smart card used for the check should be of course ISO7816-3 compliant. Otherwise, no LED change will occur. The second test is not available for the Prox–SU model. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 30/134...
  • Page 31: Configuring The Reader/Writer

    RFU (4 bytes) RF parameters for ISO14443-A cards RxThreshold for 106 kbps RxThreshold for 212 kbps RxThreshold for 424 kbps RxThreshold for 848 kbps Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 31/134...
  • Page 32: Control Parameters

    Note: The Prox–SU reader does not use this parameter. Card notification delay This byte defines the minimum time between the notifications of card movement: Time unit = 100 ms Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 32/134...
  • Page 33: Communication Time Out With Gemcore Pos Pro

    212 kbps card to reader allowed 424 kbps card to reader allowed 848 kbps card to reader allowed Only the same bit rate for both direction is allowed Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 33/134...
  • Page 34: T=Cl Card Presence Check Behavior

    0Fh: user defined values for the antenna output driver conductance are used. (GsN, CWGsP and ModGsP) Note: The user defined values must be used only for tuning purpose. RF parameters for ISO14443-A cards Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 34/134...
  • Page 35: Rf Parameters For Iso14443-B Cards

    * ERR_OK compute CRC is OK * ERR_MAD_CRC compute CRC is not OK (last byte on input must be the supposed CRC of the preceding bytes) Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 35/134...
  • Page 36 *_puc_out = *_puc_out << 1; if (*_puc_out) uc_status = ERR_MAD_CRC; return (uc_status); // 0x00 if last byte is the CRC of the previous bytes Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 36/134...
  • Page 37: Using Pc/Sc Application

    Smart Card - Aware Applications Service Provider Smart Card Resource Manager Smart Card Reader Handler Smart Card Reader Smart Card Figure 23 – PC/SC Architecture Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 37/134...
  • Page 38: Table 6 - Smart Card Database Query Functions

    SCardEstablishContext Establishes a context for accessing the smart card database SCardReleaseContext Closes an established context Table 8 - Resource Manager Context Functions Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 38/134...
  • Page 39: Table 9 - Resource Manager Support Function

    Set reader attribute Table 12 - Direct Card Access Functions To get more information about these commands please refer to the MSDN website: http://msdn.microsoft.com. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 39/134...
  • Page 40: Gem_Pc/Sc Software Tool

    Reference Manual Preliminary Prox–DU & Prox–SU Gem_PC/SC software tool The Gemalto Gem_PCSC tool may help to become familiar with the PC/SC environment: Figure 24 – Gem_PCSC window The Gem_PCSC tool is available for download in the Gemalto support website: http://support.gemalto.com.
  • Page 41: Prox-Du And Prox-Su Pc/Sc Reader Name

    The Prox–DU and the Prox–SU device will be recognized using their PC/SC name. The name will comply with the following string format: • “Gemalto Prox-DU Contactless Interface N1” for the Prox–DU contactless interface • “Gemalto Prox-DU Contact Interface N2” for the Prox–DU contact interface •...
  • Page 42: Pc/Sc Limitations

    The communication with the contactless interface and the contact interface shall be exclusive. Consequently the application shall not use the two interfaces simultaneously. Else communication errors can occur. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 42/134...
  • Page 43: Interfacing With Contactless Cards

    When a smart card removal is detected, a CCID removal notification message will be generated and the blue LED of the contactless reader/writer will blink slowly. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 43/134...
  • Page 44: Atr For Contactless Smart Cards

    3Bh 8Fh 80h 01h 80h 80h 65h B0h 07h 02h 02h 89h 83h 00h 90h 00h 00h 00h 00h With: n = Fh (15 historical bytes) Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 44/134...
  • Page 45 The ATR returned by a GemCombi CDLite smart card will be: 3Bh 80h 80h 01h 01h With: n = 0h (no historical byte) UU = 01h (TCK) Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 45/134...
  • Page 46: Interfacing With Mifare ® Cards

    (HistByte 0 to HistByte N-1). • Higher nibble 8 means no TA2, TB2, TC2 only TD2 is following. • Lower nibble 0 means T = 0. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 46/134...
  • Page 47: Table 15 – Ss Byte For Standard

    MIFARE Standard 1K 00h 01h ® MIFARE Standard 4K 00h 02h ® MIFARE Ultralight 00h 03h Table 16 – NN Bytes for Card Name Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 47/134...
  • Page 48: Get Data Command

    The command is formatted as follows: Data 1 byte 1 byte 1 byte 1 byte 1 byte Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 48/134...
  • Page 49: Load Keys Command

    Up to 160 keys can be loaded to support all the keys pairs needed for the Mifare 4K cards (2 keys for each sector): Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 49/134...
  • Page 50 The byte order must be the same as the byte order in the card sector trailer (A0h first for the key A0h A1h A2h A3h A4h A5h) Gemalto default Key A A0h A1h A2h A3h A4h A5h Gemalto default Key B B0h B1h B2h B3h B4h B5h...
  • Page 51: General Authenticate Command

    1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 1 byte 1byte The response is formatted as follows: Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 51/134...
  • Page 52: Read Binary Command

    The Read Binary command is used to read data from a MIFARE memory block. Data consist of a memory block (16 bytes). This command is formatted as follows: Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 52/134...
  • Page 53: Update Binary Command

    The Update Binary command is used to write data into a MIFARE memory block. Data consist of a memory block (16 bytes). This command is formatted as follows: DATA ABLM ABLL Data Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 53/134...
  • Page 54: Error Code List Summary

    Wrong parameter P1-P2 Wrong length (wrong number Le; XX is the exact number) if Le is less than the available data length Instruction code not supported Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 54/134...
  • Page 55: Table 17 – Memory Card Error Codes

    Update Binary error codes Wrong length Security not satisfied Address out of range Function not supported Table 17 – Memory card error codes Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 55/134...
  • Page 56: Interfacing With Contact Cards

    The Prox–DU and the Prox–SU will return the smart card ATR after a smart card power up. The ATR is as follows: Byte Value Designation Description Number Initial header (Mandatory) 3Bh or Direct or inverse convention Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 56/134...
  • Page 57 Specific to T after T from 0 to 14 in TDi–1 Global after T=15 in TDi–1 Interface characters (Optional) Y3-T Interface characters (Optional) Structural, encodes Yi+1 and T Historical characters (Optional): max 15 bytes Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 57/134...
  • Page 58: Structures And Content

    ONE the presence of subsequent characters TA1, TB1, TC1, TD1 respectively. • The least significant half byte (b3 to b0) is named K and indicates the number (0 to 15) of historical characters. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 58/134...
  • Page 59: Interface Characters Tai, Tbi, Tci, Tdi

    Historical characters T1, T2, ... ,TK When K is not null, the answer to reset is continued by transmitting K historical characters T1, T2, ... , TK. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 59/134...
  • Page 60: Check Character Tck

    1860 Fs (max) 1000 1001 1010 1011 1100 1101 1110 1111 1024 1536 2048 Fs (max) Table 19 - Clock rate conversion factor F Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 60/134...
  • Page 61: Tb1 And Tb2

    If bit 4 is set to 1, then implicit values (not defined by the interface bytes) shall apply. Bits 3 to 0 encode a type T. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 61/134...
  • Page 62: The First Ta1 For T=15

    1). The value '00' indicates that the smart card does not use SPU. Any other value where bit 7 is set to 0 are reserved for future use. For additional information about the ATR contents please refer to the ISO7816-3 standard. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 62/134...
  • Page 63: Ccid Devices

    • A bulk-in and bulk-out pipe The host command is sent on the bulk-out endpoint The device sends the answer on the bulk-in endpoint Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 63/134...
  • Page 64: Ccid Protocol And Parameters Selection

    Command TPDU = CLA INS P1 P2 Le, Le=P3 from 00h to FFh (00h means 100h) Response TPDU = Data(Le) SW1 SW2, Data(Le) is for the Le data Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 64/134...
  • Page 65: Apdu Level Of Exchange

    Character level of exchanges is selected when none of the TPDU, Short APDU or Short and extended APDU is selected. The CCID sends the characters in the command (maybe none) then waits for the number of Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 65/134...
  • Page 66: Suspend Behavior

    The following CCID commands are not implemented: • PC_to_RDR_IccClock • PC_to_RDR_T0APDU • PC_to_RDR_Secure • PC_to_RDR_Mechanical • PC_to_RDR_SetDataRateAndClockFrequency In the following paragraphs for all the command messages: Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 66/134...
  • Page 67: Pc_To_Rdr_Iccpoweron Command

    The response to this command message is RDR_to_PC_DataBlock response message. PC_to_RDR_IccPowerOff command This command powers off the smart card. Offset Field Size Value Description bMessageType PC_to_RDR_IccPowerOff bwLength 00000000h bSlot Slot 0 Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 67/134...
  • Page 68: Pc_To_Rdr_Getslotstatus Command

    PPSS PPS0 [PPS1] [PPS2] [PPS3] PCK With PPSS = FFh Refer to ISO 7816-3 for more information. Offset Field Size Value Description bMessageType PC_to_RDR_XfrBlock Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 68/134...
  • Page 69: Pc_To_Rdr_Getparameters Command

    The response to this command message is the RDR_to_PC_Parameters response message. PC_to_RDR_SetParameters command This command is used to change the slot parameters such as the baud rate, the protocol, Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 69/134...
  • Page 70 = 1b – Checksum CRC b1 = 0 - direct convention b1 = 1 - inverse convention CCID ignores bit b1 bGuardTimeT1 00-FFh Extra Guard Time between two Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 70/134...
  • Page 71: Pc_To_Rdr_Escape Command

    XX XX Command Status execution 2, 3 wLength 0000h Size of the Data field The abStatus field can report a possible execution error. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 71/134...
  • Page 72: Card Movement Notification Enable

    The response to this message is the RDR_to_PC_SlotStatus response message. Response pipe bulk-in for the contact card interface The following CCID messages are implemented for the contact interface: • RDR_to_PC_DataBlock • RDR_to_PC_SlotStatus Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 72/134...
  • Page 73: Rdr_To_Pc_Datablock

    Value Description bMessageType RDR_to_PC_SlotStatus bwLength 00000000h bSlot Slot number : Same as Bulk-OUT message bSeq 00-FFh Sequence number : Same as Bulk- OUT message Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 73/134...
  • Page 74: Rdr_To_Pc_Parameters

    12 etu. FFh is the same as 00h bWaitingIntegerT0 00h-FFh WI for T=0 used to define WWT bCLockStop ICC clock stop support Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 74/134...
  • Page 75: Rdr_To_Pc_Escape

    Reporting slot error and slot status registers in bulk-in messages for the contact interface Each bulk-in message contains the values of the Slot Error register (bError) and the Slot Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 75/134...
  • Page 76: Table 23 : Slot Error Register When Bmcommandstatus = 1

    Value Description bmICCStatus 2 bits 0, 1, 2 0 – An ICC is Present and active (power is on and stable, RST is Inactive) Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 76/134...
  • Page 77: Interrupt In Messages For The Contact Card Interface

    Bulk-Out message and is waiting for a Bulk-In message in response, and one of these events occurs, then the Bulk-In message may heave duplicate information Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 77/134...
  • Page 78: Rdr_To_Pc_Notifyslotchange

    02h: no present, slot changed state since last RDR_to_PC_NotifySlotChange message was sent 03h: ICC present, slot changed state since last RDR_to_PC_NotifySlotChange message was sent Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 78/134...
  • Page 79: Ccid Device For The Contactless Interface

    00h-03h Voltage that is applied to the ICC 00h – automatic voltage selection 01h – 5.0V 02h – 3.0v 03h – 1.8V Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 79/134...
  • Page 80: Pc_To_Rdr_Iccpoweroff Command

    TPDU level of exchange (as reported in the dwFeature parameter in the CCID functional descriptor) and only for T=1 transfers. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 80/134...
  • Page 81: Pc_To_Rdr_Getparameters Command

    PC_to_RDR_SetParameter or set to default value with the command PC_toRDR_ResetParameter to be send back in the response message RDR_to_PC_Parameters. The response to this command message is the RDR_to_PC_Parameters response message. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 81/134...
  • Page 82: Pc_To_Rdr_Resetparameters Command

    Protocol data structure for protocol T=0 (bProtocolNum = 0) (dwLength = 00000005h): Offset Field Size Value Description bmFindexDindex b7-4 – FI selecting a clock rate conversion factor b3-0 – DI selecting a baud rate Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 82/134...
  • Page 83: Pc_To_Rdr_Escape Command

    Slot 0 bSeq 00-FFh Sequence number for the command abRFU 000000h Reserved for Future Used abData Byte Data block sent to the CCID array Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 83/134...
  • Page 84: Switch Interface

    0000h Size of the Data field Firmware version This command is useful for the Gemalto CCID driver. The format is the same than the command of the GemCore POS Pro chip. abData field = 0x02 The response is the Prox–DU or SU string version as defined in the “Firmware Versioning Rules”...
  • Page 85: Response Pipe Bulk-In Messages For The Contactless Interface

    Short APDU level, this field is RFU = 00h abData Byte This field contains the data Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 85/134...
  • Page 86: Rdr_To_Pc_Slotstatus Command

    0Xh = no error 41h, 42h 4Xh = command failed X = 0 card present and active X = 1 card present and inactive Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 86/134...
  • Page 87 Extra Guard Time between two characters. If value FFh, then guard time is reduced by 1 etu. bWaitingIntegersT1 00-9Fh b7-b4 = BWI value 0-9 valid Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 87/134...
  • Page 88: Rdr_To_Pc_Escape Command

    CCID. If the host has sent a Bulk-Out message and is waiting for a Bulk-In message in response, and Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 88/134...
  • Page 89: Rdr_To_Pc_Notifyslotchange Message

    02h: no present, slot changed state since last RDR_to_PC_NotifySlotChange message was sent 03h: ICC present, slot changed state since last RDR_to_PC_NotifySlotChange message was sent Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 89/134...
  • Page 90: Hid Devices

    The Prox–DU and Prox–SU reader/writers use a vendor defined HID interface for the device administration. Gemalto proprietary commands The HID interface is used for device administration using Gemalto proprietary commands. The commands are coded using the following format: Offset Field...
  • Page 91: Proprietary Commands

    Offset Field Size Value Description abStatus XX XX Command Status execution 2, 3 wLength XXXX Size of the Data field abData firmware version string Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 91/134...
  • Page 92: Read Eeprom Parameters Command

    XX XX Command Status execution 2, 3 wLength 0000h Size of the Data field The abStatus field can report a possible execution error. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 92/134...
  • Page 93: Switch Interface Command

    Current interfaces switch state = 02h when no contactless card is detected and a contact card is inserted in the reader slot. This corresponds to the state 2 of the dual power security manager. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 93/134...
  • Page 94: Reset Reader Command

    The abStatus field can report a possible execution error. Download firmware file command This command is used to download the file that contains the reader firmware data. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 94/134...
  • Page 95: End Download Command

    FE8Dh Wrong PPS response Error during card activation exchange (WUPB, REQB, SLOT_MARKER, ATTRIB) ERR_ATQB FE8Eh Wrong ATQB response ERR_HALTB FE8Fh Wrong Halt B response Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 95/134...
  • Page 96: Table 26 : Contactless Commands Error Code

    Wrong number of expected bits received ERR_MFRC_SERNR FDB9h Wrong serial number DCC byte ERR_MFRC_TIME_OUT FDFEh RF time out Table 28 : Contactless exchange error codes Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 96/134...
  • Page 97: Firmware Versioning Rules

    “Gemalto_Prox_SU” product name of Prox SU reader Separator: "-" Release version: "Vx.yz" release version number x.yz Separator: "-" Customer: "G" Gemalto Casing/Usage: "XD" Official release "W" working release Order number: "nn" incremental number for each version. "00" to "99 It restarts to 00 when the release version number is...
  • Page 98: Usb Descriptors

    The device is “Bus Powered” (delivered from the USB cable, no external power). The device doesn’t support remote wake. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 98/134...
  • Page 99: Interfaces Descriptors

    (index to interface string descriptor = 6) Table 32 – USB Contactless Smart Card Interface Descriptor The interface for the contact smart card has three endpoints. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 99/134...
  • Page 100: Device Class Descriptors

    0xFE bInterval (254ms) Table 35 – USB HID Interface Endpoint Descriptor HID report descriptor HID Report Descriptor Offset Value Field Usage page (Vendor defined) Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 100/134...
  • Page 101: Contactless Smart Card Device Class Descriptor

    Feature (Data, Variable, Absolute) End of Collection (Application) Table 36 – USB HID Report Descriptor Contactless smart card device class descriptor Contactless Smart Card Device Class Descriptor Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 101/134...
  • Page 102 00000002h: Automatic parameter configuration based on ATR data 00000010h: Automatic ICC clock frequency change 00000020h: Automatic baud rate according to parameters 0x06 00000040h: Automatic parameters negotiation made by the CCID Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 102/134...
  • Page 103: Contactless Smart Card Interface Endpoint Descriptors

    (8 bytes max) 0x00 0x18 bInterval (Polling Interval = 24 ms) Table 40 – USB Contactless Smart Card Interface Endpoint Descriptor (Interrupt In) Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 103/134...
  • Page 104: Contact Smart Card Device Class Descriptor

    (254 bytes) 0x00 0x00 0x00 0x00 dwSynchProtocols (no synchronous card) 0x00 0x00 0x00 0x00 dwMechanical (no special characteristics) 0x00 0x00 TPDU/ISO mode 0x30 Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 104/134...
  • Page 105: Contact Smart Card Interface Endpoint Descriptors

    Table 43 – USB Contact Smart Card Interface Endpoint Descriptor (Bulk In) Contact Smart Card Interface Endpoint Descriptor (endpoint 7 Interrupt IN) Offset Value Field 0x07 bLength (7 bytes) Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 105/134...
  • Page 106: String Descriptors

    Offset Value Field 0x10 bLength 0x03 bDescriptorType (String) ‘G,0 ‘e’,0 ‘m’,0 ‘a’,0 bString = "Gemalto" ‘l’,0 ‘t’,0 ‘o’,0 Table 46 – USB Manufacturer String Descriptor Product string descriptor String02 (index iProduct of device descriptor) Offset Value Field 0x3A bLength (58 bytes for Prox DU or 54 bytes for Prox SU )
  • Page 107: Serial Number String Descriptor

    = "SN7 SN6 SN5 SN4 SN3 SN2 SN1 SN0" SN3,0x00, SN3,0x00, SN2,0x00, SN2,0x00, SN1,0x00, SN1,0x00, SN0,0x00, SN0,0x00, Table 48 – USB Serial Number String Descriptor Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 107/134...
  • Page 108: Hid Interface String Descriptor

    Contactless smart card interface string descriptor String05 (index iInterface of interface descriptor) (Contactless smart card interface) Offset Value Field 0x3C bLength (60 bytes) 0x03 bDescriptorType (String) bString = ‘P’,0x00 “Prox-DU Contactless interface” ‘r’,0x00 ‘o’,0x00 “Prox-SU Contactless interface” ‘x’,0x00 ‘-‘,0x00 ‘D’,0x00 ‘U’,0x00 ‘ ‘,0x00 ‘C’,0x00, ‘o’,,0x00, ‘n’,0x00,...
  • Page 109: Contact Smart Card Interface String Descriptor

    0x03 bDescriptorType (String) ‘P’,0x00 ‘r’,0x00 ‘o’,0x00 ‘x’,0x00 ‘-’,0x00 ‘D’,0x00, ‘U’,0x00, ‘ ’,0x00, ‘C’,0x00, ‘o’,0x00, ‘n’,0x00, bString = ‘t’,0x00, “Prox-DU Contact interface” ‘a’,0x00, ‘c’,0x00, “Prox-SU Contact interface” ‘t’,0x00, ‘ ’,0x00, ‘i’,0x00, ‘n’,0x00, ‘t’,0x00, ‘e’,0x00, ‘r’,0x00, ‘f’,0x00, ‘a’,0x00, ‘c’,0x00, ‘e’,0x00, Table 51 – USB Contact Smart Card Interface String Descriptor...
  • Page 110: Boot-Loader

    2 - If the push button is activated (rescue start up) The device is not started and the boot-loader continues to run. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 110/134...
  • Page 111: Boot-Loader Download Operations

    The command format is the following: Offset Field Size Value Description bCommandFamily Bootloader command bCommandType Download Management bCommand Load firmware file Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 111/134...
  • Page 112: End Download Command

    = 0x0000 and reboots. If the two CRC are different, the bootloader answers with abStatus = FB9Bh and stay in the boot mode. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 112/134...
  • Page 113: Boot-Loader Version Request Command

    • The “End download” command is used to complete the download operation • The “Reset reader” command is used to activate the new firmware. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 113/134...
  • Page 114: Downloaded File Format

    This is the same descriptor than the HID class descriptor for the reader firmware. Refer to the “USB Descriptors” paragraph for more information. HID endpoint descriptor Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 114/134...
  • Page 115: Hid Report Descriptor

    (String) ‘H’,0x00, bString = “HID Download Interface” ‘I’,0x00, ‘D’,0x00, ‘ ’,0x00, ‘D’,0x00, ‘o’,0x00, ‘w’,0x00, ‘n’,0x00, ‘l’,0x00, ‘o’,0x00, ‘a’,0x00, ‘d’,0x00, ‘ ’,0x00, ‘I’,0x00, ‘n’,0x00, ‘t’,0x00, Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 115/134...
  • Page 116: Leds States For The Boot-Loader

    Blink 3: 50 ms on every 100 ms. (When the yellow LED is on, the blue LED is on). Blink 4: the yellow LED is on and the blue LED is off for 400 ms every 500 ms. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 116/134...
  • Page 117: Downloading A Firmware

    The latest firmware binary file to download should be used (.bin extension file). The two items are available in the following web link http://support.gemalto.com. The Gemalto downloader tool performs the operations listed in the “Typical download operations” with additional commands to display the firmware and the boot-loader string version.
  • Page 118 (SWF118323F.bin in the example hereafter): • Click the “Download” button. The download process is running until its termination. The next figure will be displayed: Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 118/134...
  • Page 119 Then a reset of the device is performed to start the new firmware. • Click the “Get Version” button to check the new string version of the device. The next figure displays the new string “Gemato_Prox_DU-V1.01-GXD05”: Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 119/134...
  • Page 120 Reference Manual Preliminary Prox–DU & Prox–SU The download operation is now completed. Note: the download duration is about 15 seconds. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 120/134...
  • Page 121: Mifare ® Cards Mapping

    The first block of the first sector contains manufacturing information. The last block of each sector is the sector trailer containing the keys and the access conditions of the blocks. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 121/134...
  • Page 122: Mifare ® 4K M Emory M Apping

    – – – – – Data Data Data Key A Access Bits Key B Sector Trailer 31 Data Data Data Data Data Data Data Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 122/134...
  • Page 123 The first block of the first sector contains manufacturing information. The last block of each sector is the sector trailer containing the keys and the access Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 123/134...
  • Page 124: Mifare ® Ul Memory Mapping

    BCC0 and BCC1 are the check bytes according to ISO14443-3. Internal byte is reserved for internal data. These 10 bytes are write-protected after having been programmed by the chip manufacturer after production. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 124/134...
  • Page 125: Lock Bytes Area

    UL Read/Write Operation ® ® The MIFARE Ultralight chip does not embed the MIFARE Classic security. So no authentication operation is required before any read/write operation. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 125/134...
  • Page 126: Read Operation

    Data16 Data17 Data18 Data19 Data20 Data21 Data22 Data23 Data24 Data25 Data26 Data27 Data28 Data29 Data30 Data31 90h 00h • For ABLL = 0Ch: Data32 Data33 Data34 Data35 Data36 Data37 Data38 Data39 Data40 Data41 Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 126/134...
  • Page 127: Write Operation

    Data44 Data45 Data46 Data47 00h 00h 00h 00h 00h 00h 00h 00h 00h 00h 00h Note: Page 0 and Page 1 have read-only bytes that are write-protected. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 127/134...
  • Page 128 Reference Manual Preliminary Prox–DU & Prox–SU Page 2 and Page 3 have specific features (Lock and OTP). Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 128/134...
  • Page 129: Mifare ® M Emory O Rganization

    Key A, user can set the access bits where the memory space of the optional authentication Key B can be used for data storage. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 129/134...
  • Page 130: Access Bits

    The access condition for every block is dependant on the sector number as explained in the following table: Sector Block Description - C2 - C1 (0 – 31) - C2 - C1 Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 130/134...
  • Page 131 Key A | B Never Never Key A | B /Subtract Value block A or B Read only Key A | B Never Never Never memory block Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 131/134...
  • Page 132: Sector Trailer Access Conditions

    Key A | B indicates the access for this sector is only possible after an authentication using either Key A or Key B. Access Bits Access Condition Comments Authentication Access Bits Authentication Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 132/134...
  • Page 133: Table 60 - Access To Sector Trailer

    The access bits can also be blocked by the user to prohibit any further changes to the access conditions. As the access bits can be altered by the user, special care should be taken during personalization phase. Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 133/134...
  • Page 134: For More Information

    Circuit(s) Cards Interface Devices - Revision 1.1 • PC/SC V2 specifications: Part 3. Requirements for PC-Connected Interface Devices - Revision 2.01.09 End of Document Release for first samples Do not use for final design www.gemalto.com DOC118569A Public Use Page 134/134...

This manual is also suitable for:

Prox-su

Table of Contents

Save PDF