SCM Microsystems @MAXX lite Reference Manual

Multifunctional token (smartcard, flash, antenna)
Table of Contents

Advertisement

Quick Links

Reference Manual – version 0.1
@MAXX lite
Multifunctional token (smartcard, flash, antenna)

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the @MAXX lite and is the answer not in the manual?

Questions and answers

Summary of Contents for SCM Microsystems @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 Document history Date Version Description of change Responsible person 30/09/2009 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: Table Of Contents

    3.5.3. Embedded Flash ....................14 3.6. Applications ........................14 3.6.1. General ......................... 14 3.6.2. Applications provided by SCM Microsystems............16 @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.
  • Page 5 @MAXX L EFERENCE ANUAL ABLE ONTENTS Commands description ....................24 6.1. Escape commands for the contact interface ..............24 6.1.1. Sending escape commands to @MAXX lite ............24 6.1.2. Escape command codes..................24 6.1.3. CCID_ESC_GETINFO ..................25 6.1.4. CCID_ESC_SETMODE ..................25 6.1.5.
  • Page 6: Legal Information

    1.1. Disclaimers The content published in this document is believed to be accurate. SCM Microsystems does not, however, provide any representation or warranty regarding the accuracy or completeness of its content and regarding the consequences of the use of information contained herein. If this document has the status “Draft”, its content is still under internal review and yet to be formally...
  • Page 7: Introduction To The Manual

    @MAXX LITE EFERENCE ANUAL 2. Introduction to the manual 2.1. Objective of the manual This manual provides an overview of the hardware and software features of the @MAXX lite (contact smartcard reader, mass storage, RF-antenna) reader, hereafter referred to as “@MAXX lite”.
  • Page 8: References

    Distance coverage in the range of 5cm PUPI Pseudo unique PICC identifier Reserved for future use Radio Frequency STCII Smart card reader controller ASIC from SCM Microsystems Universal Serial Bus Vendor ID (xyz)b Binary notation of a number x, y, z ∈{0,1} 0xYY The byte value YY is represented in hexadecimal 2.5.
  • Page 9 @MAXX LITE EFERENCE ANUAL 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 •...
  • Page 10: General Information About @Maxx Lite

    @MAXX LITE EFERENCE ANUAL 3. General information about @MAXX lite 3.1. @MAXX lite key benefits The @MAXX lite is an all-in-one device and belongs to SCM’s @MAXX token family. Designed as a USB-stick the @MAXX lite is portable and can be connected to stationary PCs as well as Laptops.
  • Page 11: Hardware Features And Their Principle Usage

    @MAXX LITE EFERENCE ANUAL 3.5. Hardware features and their principle usage The @MAXX lite is a multifunctional token device, which can be used within a big 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.
  • Page 12: Contact Smart Card Reader

    @MAXX LITE EFERENCE ANUAL 3.5.1. Contact Smart Card Reader The contact smart card reader is an 8-pin, ISO7816 compliant contact smart card reader for ID- 000 smartcards. Its contacts C4 and C8 are connected with the internal RF antenna. Thus it is possible to use beside normal smartcards (microprocessor and memory cards) also dual interface smartcards with additional contacts on C4 / C8.
  • Page 13: Internal Rf Antenna

    @MAXX LITE EFERENCE ANUAL Smart Card insertion: 3.5.2. Internal RF antenna The internal RF antenna is connected with the pins C4 / C8 of the smartcard reader for the usage of dual interface cards. When a dual interface card is inserted in the @MAXX and the @MAXX is put in the magnetic field of any contactless reader, the internal RF antenna couples with the reader and an induction current appears in the antenna thus providing power to the integrated circuit.
  • Page 14: Embedded Flash

    @MAXX LITE EFERENCE ANUAL is the side where the label and the smartcard insertion slot can be found. Depending on the used contactless reader and the used dual interface card, the @MAXX lite establishes a read out distance between 2cm – 3cm. A little bit bigger antenna within the @MAXX pime A results to a bigger read out distance up to 3.5cm.
  • Page 15 @MAXX LITE EFERENCE ANUAL A similar use case is the door opener. 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.
  • Page 16: Applications Provided By Scm Microsystems

    3.6.2. Applications provided by SCM Microsystems SCM Microsystems does not provide payment or transport applications. SCM Microsystems provides a few applications for development and evaluation purposes that can function with @MAXX lite. There are many tools provided; here are two of them: •...
  • Page 17: Maxx Lite Characteristics

    @MAXX LITE EFERENCE ANUAL 4. @MAXX lite characteristics 4.1. @MAXX lite high level architecture 4.1.1. Block diagram The 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.
  • Page 18 @MAXX LITE EFERENCE ANUAL 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: Quick Reference Data

    @MAXX LITE EFERENCE ANUAL 4.2. Quick reference data 4.2.1. @MAXX lite dimensions Item Characteristic Value Weight 13,5 Grams External dimensions L 71,0 mm × W 26,0mm × H 10,4mm USB connector USB type A connector Default color Black rubberized @MAXX lite Default label Drawing with dimensions of the @MAXX lite and accessories can be found in annex.
  • Page 20 @MAXX LITE EFERENCE ANUAL 4.2.3.2. Parameter Value/Description High bus powered (@MAXX draws power from USB bus) Electrical Voltage: 5V Characteristics Max. Current : 500mA USB 2.0 Device USB specification USB Speed High Speed Device (480Mbit/s), Tolerance +- 240kbit/s 0417 (Flash) , 5116 (SIM) and 03F3 (Hub) 04E6 4.2.3.3.
  • Page 21: Software Modules

    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: •...
  • Page 22: Firmware

    @MAXX LITE EFERENCE ANUAL 5.4. Firmware 5.4.1. CCID transport protocol @MAXX lite implements a transport protocol that is compliant with USB Device Class: Smart Card CCID Specification for Integrated Circuit(s) Cards Interface Devices Revision 1.10 for the contact smart card interface and CCID-like transport protocol for the contactless interface. This paragraph describes the CCID specification features that are implemented and those that are not implemented.
  • Page 23 @MAXX LITE EFERENCE ANUAL 5.4.1.3.1. HW_ERROR This error code is returned when a hardware short circuit condition is detected, during application of power to the card or if any other internal hardware error 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.
  • Page 24: Commands Description

    @MAXX LITE EFERENCE ANUAL 6. Commands description 6.1. Escape commands for the contact interface 6.1.1. Sending escape commands to @MAXX lite A developer can use the following method to send escape commands to @MAXX lite for the contact interface • SCardControl method defined in PC/SC API 6.1.2.
  • Page 25: Ccid_Esc_Getinfo

    @MAXX LITE EFERENCE ANUAL 6.1.3. CCID_ESC_GETINFO This escape message ID gets static reader specific information from firmware to the host. Information includes the major and minor version, capabilities of the reader etc. The first byte of input buffer of shall have just one byte that will contain this escape function’s value. The output buffer shall point to an application allocated SCARD_READER_GETINFO_PARAMS structure mentioned below.
  • Page 26: Ccid_Esc_Get_Fw_Version

    @MAXX LITE EFERENCE ANUAL 6.1.6. CCID_ESC_GET_FW_VERSION This function code shall be used by the application / driver to retrieve the current firmware revision of the reader. The input buffer shall contain the escape code. The reader shall return a WORD parameter containing the firmware revision.
  • Page 27: Ccid_Esc_Clk_Frequency

    @MAXX LITE EFERENCE ANUAL 6.1.10. CCID_ESC_CLK_FREQUENCY In case when an application wants to change the clock frequency, this escape ID is used to inform the reader about the change in clock. The first byte of the input buffer will contain the escape function value;...
  • Page 28: Ccid_Esc_Get_Set_Guardtime

    @MAXX LITE EFERENCE ANUAL 6.1.13. CCID_ESC_GET_SET_GUARDTIME This function code shall be used to set and get the character / block guard time of the reader. The guard time is specified in terms of etus. The buffer shall point to the escape code followed by the guard time structure. typedef struct _GUARD_TIME uint8 byGetSetIdentifier;...
  • Page 29: Ccid_Esc_Rough_Tansfer

    @MAXX LITE EFERENCE ANUAL 6.1.17. CCID_ESC_ROUGH_TANSFER This command is used to perform raw exchange of data with the card. The input buffer for this command will contain the escape function value, low byte of the send length, high byte of the send length, low byte of the expected length, high byte of the expected length and the command.
  • Page 30: Annexes

    @MAXX LITE EFERENCE ANUAL 7. Annexes 7.1. Annex A – Status words table Description 0x90 0x00 NO ERROR 0x67 0x00 LENGTH INCORRECT 0x6D 0x00 INVALID INSTRUCTION BYTE 0x6E 0x00 CLASS NOT SUPPORTED 0x6F 0x00 UNKNOWN COMMAND 0x63 0x00 NO INFORMATION GIVEN 0x65 0x81 MEMORY FAILURE...
  • Page 31 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);...
  • Page 32 @MAXX LITE EFERENCE ANUAL /* get actual 848kbps status: ON/OFF */ InBufLen = 2; InWord = CCID_GET_848KBPS_STATUS; ret = SCardControl (CardHandle, IOCTL_CCID_ESCAPE, &InWord, InBufLen, &OutByte, &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];...
  • Page 33 @MAXX LITE EFERENCE ANUAL ret = SCardConnect (ContextHandle, ReaderName[0], SCARD_SHARE_SHARED, SCARD_PROTOCOL_T0 | SCARD_PROTOCOL_T1, &CardHandle, &ActiveProtocol); /* get actual 848KBPS status: ON/OFF */ InBufLen = 2; InWord = CCID_GET_848KBPS_STATUS; ret = SCardControl (CardHandle, IOCTL_CCID_ESCAPE, &InWord, InBufLen, &OutByte, &ResLen); printf ("\n Get 848kbps status: %lx: %.2x", ret,OutByte); Reader[0].dwCurrentState = SCARD_STATE_UNAWARE;...
  • Page 34 @MAXX LITE EFERENCE ANUAL ret = SCardDisconnect(CardHandle, SCARD_RESET_CARD); ret = SCardConnect(ContextHandle, ReaderName[0], SCARD_SHARE_SHARED, SCARD_PROTOCOL_T0 | SCARD_PROTOCOL_T1, &CardHandle, &ActiveProtocol); /* get actual 848KBPS status: ON/OFF */ InBufLen = 2; InWord = CCID_GET_848KBPS_STATUS; ret = SCardControl(CardHandle, IOCTL_CCID_ESCAPE, &InWord, InBufLen, &OutByte, 1, &ResLen); printf ("\n Get 848KBPS status: %lx: %.2x", ret,OutByte);...

Table of Contents