background image

 

 

 

 

Reference Manual – version 0.1 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

@MAXX lite 

Multifunctional token (smartcard, flash, antenna)

 

Summary of Contents for @MAXX lite

Page 1: ...Reference Manual version 0 1 MAXX lite Multifunctional token smartcard flash antenna ...

Page 2: ...Reference manual MAXX lite contact smartcard reader masstorage RF antenna USB Stick SCM Microsystems Oskar Messter Strasse 13 85737 Ismaning Germany Phone 49 89 9595 5000 Fax 49 89 9595 5555 ...

Page 3: ...ion of change Responsible person 30 09 2009 0 1 Creation Stephan Rasch Contact information http www scmmicro com products services smart card readers terminals multifunctional token html For sales information please email sales scmmicro com ...

Page 4: ...stomization options 10 3 5 Hardware features and their principle usage 11 3 5 1 Contact Smart Card Reader 12 3 5 2 Internal RF antenna 13 3 5 3 Embedded Flash 14 3 6 Applications 14 3 6 1 General 14 3 6 2 Applications provided by SCM Microsystems 16 4 MAXX lite characteristics 17 4 1 MAXX lite high level architecture 17 4 1 1 Block diagram 17 4 2 Quick reference data 19 4 2 1 MAXX lite dimensions ...

Page 5: ...R_ON_RESET_ORDER 26 6 1 8 CCID_ESC_EMV_LOOPBACK 26 6 1 9 CCID_ESC_APDU_TRANSFER 26 6 1 10 CCID_ESC_CLK_FREQUENCY 27 6 1 11 CCID_ESC_GET_SET_ETU 27 6 1 12 CCID_ESC_GET_SET_WAITTIME 27 6 1 13 CCID_ESC_GET_SET_GUARDTIME 28 6 1 14 CCID_ESC_GET_SET_EGT 28 6 1 15 CCID_ESC_GET_SET_ATR_TIMEOUT 28 6 1 16 CCID_ESC_POWER 28 6 1 17 CCID_ESC_ROUGH_TANSFER 29 6 1 18 CCID_ESC_GET_SET_PROTOCOL 29 6 1 19 CCID_ESC_...

Page 6: ... the provided documentation please provide your feedback to support scmmicro com 1 2 Licenses If the document contains source code examples they are provided for illustrative purposes only and subject to the following restrictions You MAY at your own risk use or modify the source code provided in the document in applications you may develop You MAY distribute those applications ONLY in form of com...

Page 7: ...M interface 3 14 Linux Driver for SIM Interface 5 0 2 2 4 Definition of various terms and acronyms Term Expansion APDU Application Protocol Data Unit ATR Answer to Reset defined in ISO IEC 7816 ATS Answer to select defined in ISO IEC 14443 Byte Group of 8 bits CCID Chip Card Interface Device CID Card Identifier CL Contactless DFU Device Firmware Upgrade DR Divider receive used to determine the bau...

Page 8: ...cal interface and transmission protocols ISO IEC ISO IEC 7816 4 Identification cards Integrated circuit s cards with contacts Part 4 Interindustry commands for interchange ISO IEC 7816 4 1995 E ISO IEC ISO IEC 14443 3 Identification cards Contactless integrated circuit s cards Proximity cards Part 3 Initialization and anticollision ISO IEC ISO IEC 14443 4 Identification cards Contactless integrate...

Page 9: ... 163 decimal number is represented in hexadecimal as 0xA3 in binary as 10100011 b The least significant nibble of 0xA3 is 0x3 in hexadecimal 0011 b in binary The most significant nibble of xA3 is 0xA in hexadecimal 1010 b in binary ...

Page 10: ... features 8 pin ISO7816 compliant contact smart card reader for ID 000 smartcards o PC SC v2 0 compliant o CCID compatible Unique serial number for the Mass Storage interface Can be plugged into any USB slot on a PC without having to re install the driver embedded flash memory 2GB other capacities on request internal passive RF antenna connected to C4 C8 of the smartcard connector 3 3 MAXX lite or...

Page 11: ...ig application field It can be used for one application or for a combination of several applications In the following paragraphs the usage recommendations are outlined to ensure best user experience 1 Contact Smart Card Reader for dual interface Smart Cards with antenna connection on C4 C8 2 Internal RF antenna 3 On board flash memory MAXX lite schematics ...

Page 12: ...river as standard driver already installed If Windows XP is used as operating system the USB CCID driver is available as optional update Contact Designation Use C1 Vcc Power connection through which operating power is supplied to the microprocessor chip in the card C2 RST Reset line through which the IFD can signal to the smart card s microprocessor chip to initiate its reset sequence of instructi...

Page 13: ... signal for the communication between the reader and the card It is also used as a fundamental clock input for the integrated circuit microprocessor to function To send data to the user token the reader modulates the amplitude of the field There are several amplitude modulation and data encoding rules defined in ISO IEC 14443 The reader should should be ISO 14443 compliant reader To answer to the ...

Page 14: ...s energy is available for each of them and that the system is detuned The communication between a contactless reader and the MAXX is sensitive to the geometry of the system reader MAXX Parameters like the geometry and specially the relative size of the reader and MAXX antennas directly influence the inductive coupling and therefore the communication 3 5 3 Embedded Flash Also the embedded flash mem...

Page 15: ...In this case the host is not seen The contactless reader is installed beside the door MAXX lite itself handles the communication protocol but not the application related to the token The application specific logic has to be implemented by software developers on the host ...

Page 16: ...lone application that enables the user to read and write NFC forum compliant records into NFC forum compatible tags It is an easy to use tool to configure rapidly NFC forum tag demonstrations Note MAXX lite supports NFC forum tag type 2 and 4 only Smart card commander version 1 1 provides NFC forum record parsing functionality of NDEF records in XML format as well as scripting functionality which ...

Page 17: ...link between MAXX lite and the host to which it is connected is the USB interface providing both the power and the communication channel MAXX lite contains the SCM Mask ROM Controller for the SIM Interface The Mask ROM firmware can handle all the ISO7816 contact protocol and the PC SC communication protocol with the host ...

Page 18: ...NCE MANUAL 18 Software architecture Applications can interface with the driver directly through the PC SC interface The MAXX lite driver implements PC SC v2 0 API towards upper layers and full CCID for the contact slot ...

Page 19: ...ED behavior MAXX lite is equipped with a red LED MAXX lite LED Indication red Just after plug in with drivers already installed flashing MAXX connected Idle State ON Reader card errors OFF Read or write on smartcard flash storage Flashing Suspend State OFF 4 2 3 Other data 4 2 3 1 General Parameter Value Description Clock of the device controller 24 MHz API PC SC 2 0 CCID Operating temperature ran...

Page 20: ...h 5116 SIM and 03F3 Hub VID 04E6 4 2 3 3 Contact interface Parameter Value Description Smart card operating frequency 4 8Mhz Maximum supported card baud rate 500Kbps Cards supported Class A Class B and Class C smart cards Synchronous smart cards ISO 7816 compliant Yes EMV 2000 compliant Not applicable F w is EMV ready but isn t applicable for this product CT API compliant Support Available Number ...

Page 21: ...ng the resource manager A tool called PC SC Diag capable of providing basic information about the reader and a card through PC SC stack 5 3 Driver 5 3 1 MAXX listing MAXX lite is listed by PC SC applications as SCM Microsystems Inc SCR33x USB Smart Card Reader 0 USB Mass Storage Device SCMMICRO MAXX Lite FlashDrive 5 3 2 Supported operating systems Operating systems supported by the driver Windows...

Page 22: ...yte header followed by the message specific data that have been implemented List of CCID bulk messages supported PC_to_RDR_IccPowerOn PC_to_RDR_IccPowerOff PC_to_RDR_GetSlotStatus PC_to_RDR_XfrBlock PC_to_RDR_GetParameters PC_to_RDR_SetParameters PC_to_RDR_Escape PC_to_RDR_Abort PC_to_RDR_SetDataRateAndClockFreqeuncy PC_to_RDR_T0APDU PC_to_RDR_ResetParameters PC_to_RDR_IccClock List of CCID bulk m...

Page 23: ...r is detected This error code has been defined in the error code table 6 2 2 of the CCID specification 5 4 1 3 2 ICC_MUTE This error code is returned when the card does not respond until the reader time out occurs This error will be reported in the response to PC_to_RDR_XfrBlock message and PC_to_RDR_IccPowerOn messages This error code has been defined in the error code table 6 2 2 of the CCID spe...

Page 24: ...e MAXX lite has to be unplugged and plugged again or the application can send again the same escape command The following escape commands are supported by MAXX lite for the contact interface S No Escape message ID Value 1 CCID_ESC_GETINFO 0x00 2 CCID_ESC_SETMODE 0x01 3 CCID_ESC_GETMODE 0x02 4 CCID_ESC_GET_FW_VERSION 0x03 5 CCID_ESC_SET_POWER_ON_RESET_ORDER 0x04 6 CCID_ESC_EMV_LOOPBACK 0x05 7 CCID_...

Page 25: ...6 1 4 CCID_ESC_SETMODE This escape message ID sets the current mode of the reader Applications may call this function to set the desired mode Typically this call is used to switch between the EMV and ISO7816 operation The first byte of the input buffer will contain the escape function value and the second one will contain the value for the desired mode of operation The output buffer field shall be...

Page 26: ...oint to a byte and shall return the current RESET SEQUENCE selected S No Mode Value Remarks 1 Class C 0x00 Starts with Class C voltage This is the default mode of the reader 2 Class A 0x01 Starts with Class A voltage 3 QUERY 0xFF This is used to retrieve the current mode of operation 6 1 8 CCID_ESC_EMV_LOOPBACK This escape message ID lets the host force the library to perform an EMV Loop back appl...

Page 27: ...used by the reader to get and set the current ETU The ETU is specified in terms of smart card clock cycles The input buffer shall point to the escape code followed by a DWORD specifying the value to be set The output buffer shall point to NULL 6 1 12 CCID_ESC_GET_SET_WAITTIME This function code shall be used to set and get the character block waiting time of the reader The wait time is specified i...

Page 28: ... The buffer shall point to the escape code followed by a structure given below typedef struct _EGT uint8 byGetSetIdentifier uint32 dwEGT EGT 6 1 15 CCID_ESC_GET_SET_ATR_TIMEOUT This function is used to change the delay in ms between the power up attempts in the class A class B and class C sequence The buffer shall point to the escape code followed by a BYTE containing the timeout value 6 1 16 CCID...

Page 29: ...ssion protocol for the reader The buffer shall point to the escape code followed by a BYTE The supported protocols are define PROTOCOL_T0 0x00 define PROTOCOL_T1 0x01 define PROTOCOL_UNDEFINED 0xFF 6 1 19 CCID_ESC_GET_SET_TA1_RFU Since the reader is compliant to ISO 7816 3 1997 it will reject cards having a TA1 value which is RFU in respect to this version of the specification Using this escape fu...

Page 30: ...81 MEMORY FAILURE 0x68 0x00 CLASS BYTE INCORRECT 0x6A 0x81 FUNCTION NOT SUPPORTED 0x6B 0x00 WRONG PARAMETER P1 P2 7 2 Annex B Sample code using escape commands through Escape IOCTL File Name T_hbr H ifdef __cplusplus extern C endif define IOCTL_CCID_ESCAPE SCARD_CTL_CODE 0xDAC define CCID_GET_848KBPS_STATUS 0xFF9D define CCID_SET_848KBPS_ON 0x019D define CCID_SET_848KBPS_OFF 0x009D define MINTIMEO...

Page 31: ...fLen ResLen ULONG ret SCARD_READERSTATE Reader 1 please add the name of the used reader here or use SCardListReaders to find the right reader name char ReaderName SCM Microsystems Inc MAXX lite Contactless Reader 0 NULL ContextHandle 1 ret SCardEstablishContext SCARD_SCOPE_USER NULL NULL ContextHandle if ret SCARD_S_SUCCESS ret SCardConnect ContextHandle ReaderName 0 SCARD_SHARE_SHARED SCARD_PROTO...

Page 32: ...CurrentState SCARD_STATE_UNAWARE Reader 0 dwEventState SCARD_STATE_UNAWARE Reader 0 szReader ReaderName 0 ret SCardGetStatusChange ContextHandle MINTIMEOUT Reader 1 printf nATR for i 0 i Reader cbAtr i printf 2x Reader rgbAtr i printf n n enable 848KBPS ON printf nEnable 848kbps InBufLen 2 InWord CCID_SET_848KBPS_ON ret SCardControl CardHandle IOCTL_CCID_ESCAPE InWord InBufLen OutByte 1 ResLen ret...

Page 33: ... InBufLen OutByte 1 ResLen printf n Get 848kbps status lx 2x ret OutByte Reader 0 dwCurrentState SCARD_STATE_UNAWARE Reader 0 dwEventState SCARD_STATE_UNAWARE Reader 0 szReader ReaderName 0 ret SCardGetStatusChange ContextHandle MINTIMEOUT Reader 1 printf nATR for i 0 i Reader cbAtr i printf 2x Reader rgbAtr i printf n n Disable 848Kbps OFF printf nDisable 848KBPS InBufLen 2 InWord CCID_SET_848KBP...

Page 34: ... 1 ResLen printf n Get 848KBPS status lx 2x ret OutByte Reader 0 dwCurrentState SCARD_STATE_UNAWARE Reader 0 dwEventState SCARD_STATE_UNAWARE Reader 0 szReader ReaderName 0 ret SCardGetStatusChange ContextHandle MINTIMEOUT Reader 1 printf nATR for i 0 i Reader cbAtr i printf 2x Reader rgbAtr i printf n n ret SCardDisconnect CardHandle SCARD_RESET_CARD else printf n SCardConnect failed with 0x 8lX ...

Reviews: