Page 1
Reference Manual for uTrust 4701F Dual Interface Reader uTrust 4711F Contactless Reader with SAM For Part #: 905504-1 and 905565-1 Document Version: 1.2, Last Revised On: 2017-09-26...
Page 2
Reference Manual for uTrust 4701F and uTrust 4711F Readers Abstract This document contains in-depth information about the hardware and software features of the uTrust 4701 F Dual Interface Reader and uTrust 4711F Contactless Reader with SAM. Audience This document is intended for system integrators and software developers.
1.1. Disclaimers The content published in this document is believed to be accurate. However, Identiv does not provide any representation or warranty regarding the accuracy or completeness of its content, or regarding the consequences of your use of the information contained herein.
Open Source Software. If the document contains technical drawings related to Identiv Inc. products, they are provided for documentation purposes only. Identiv Inc. does not grant you any license to its designs.
Reference Manual for uTrust 4701F and uTrust 4711F Readers 2. Introduction to the manual 2.1. Objective of the manual This manual provides an overview of the hardware and software features of the uTrust 47x1 F dual interface smart card readers (uTrust 4701 F and uTrust 4711 F).
Reference Manual for uTrust 4701F and uTrust 4711F Readers 2.4. Definition of various terms and acronyms Term or Acronym Expansion APDU Application Protocol Data Unit Answer to Reset, defined in ISO7816 Answer to select, defined in ISO/IEC 14443 Byte Group of 8 bits...
Reference Manual for uTrust 4701F and uTrust 4711F Readers 2.5. References Document reference in the Description of the referenced document Document Issuer manual ISO/IEC 7816-3 Identification cards — Integrated circuit ISO / IEC cards —Part 3:Cards with contacts — Electrical interface and transmission protocols...
Reference Manual for uTrust 4701F and uTrust 4711F Readers 2.6. Conventions for Bits and Bytes Bits are represented by lower case ‘b’ where followed by a numbering digit. Bytes are represented by upper case ‘B’ where followed by a numbering digit.
4711 F perfectly fits environments where access to contactless cards with simultaneous access to a contact SAM card is required. As for all Identiv Inc. products, uTrust 47xx F is designed to offer best in class interoperability. 3.2.
The color of the casing ● The logo ● The product label ● The USB strings Terms and conditions apply, please contact your local Identiv representative or send an email to sales@identiv.com. Document Version 1.2 Last revised on Page 13 of 92 2017-09-26...
Reference Manual for uTrust 4701F and uTrust 4711F Readers 3.6. Contactless communication principles and uTrust 47xx F usage recommendations uTrust 47xx F is a dual interface reader capable of reading both contact smart cards and contactless user tokens. The following paragraph focuses on a few specifics of contactless communication to outline usage recommendations in order to ensure best user experience.
3.7.2. Applications provided by Identiv Inc. Identiv Inc. does not provide payment or transport applications or PKI or CAC applications. Identiv Inc. provides a few applications for development and evaluation purposes that can function with uTrust 47X0 F. There are many tools provided; here are two of them: ●...
● An RF front-end that handles the RF communication The controller embeds flash memory that contains the firmware developed by Identiv to handle all the ISO7816 contact protocol, the RF communication protocols and the PC/SC communication protocol with the host. The flash can be upgraded once the device is deployed in the field, hence enabling firmware upgrades to add and potentially patch features.
If there is none, the driver may always be downloaded from the webpage of the maintainer, Ludovic Rousseau, https://alioth.debian.org/frs/?group_id=30105. Additionally, Identiv provides a proprietary driver for all the supported OSs. Document Version 1.2 Last revised on...
Reference Manual for uTrust 4701F and uTrust 4711F Readers 4.2. Quick reference data 4.2.1. uTrust 47xx F dimensions Item Characteristi Value 143g without stand Weight Stand: 52g External 126 mm X 93 mm X 22 mm dimensions Cable length 1.5 meter long with USB type A connector...
Reference Manual for uTrust 4701F and uTrust 4711F Readers 4.2.2. LED behavior uTrust 47x1 F is equipped with one bicolor LED. Its behavior is described in the table below. Reader states GREEN Just after plug-in (with drivers already installed) Just after DFU operation...
Reference Manual for uTrust 4701F and uTrust 4711F Readers 4.2.3.2. Parameter Value/Description High bus powered (uTrust 47xx F draws power from USB bus) Voltage: 5V DC characteristics Avg.. Current : 110mA (RF on, no cards present) Suspend Current: 400µA USB 2.0 FS Device...
Nevertheless, due to some limitations of the available CCID drivers under some circumstances, Identiv does provide a dedicated driver for this reader, as well, which is available through Windows Update or on the Identiv support pages.
Reference Manual for uTrust 4701F and uTrust 4711F Readers 5.3.3.1. ATR for contactless storage user tokens The ATR of the credential is composed as described in the table below. In order to allow the application to identify the storage card properly, it’s Standard and Card name describing bytes must be interpreted according to the Part 3 Supplemental Document, maintained by PC/SC.
Reference Manual for uTrust 4701F and uTrust 4711F Readers 5.3.3.2. ATR for ISO/IEC 14443-4 user tokens The credential exposes its ATS or application information which is mapped to an ATR. The table describes how this mapping is done. Byte# Value...
Reference Manual for uTrust 4701F and uTrust 4711F Readers 5.4. Firmware 5.4.1. CCID transport protocol uTrust 47xx F 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.
Page 26
Reference Manual for uTrust 4701F and uTrust 4711F Readers The following sub-sections discuss when and why these error codes are returned: 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.
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6. Commands description 6.1. Generic APDU 6.1.1. Working with DESFire and MIFARE Plus tokens To work with DESFire EV1 and MIFARE Plus tokens, please refer to the according application notes [AN337] and [AN338], respectively.
Page 28
Reference Manual for uTrust 4701F and uTrust 4711F Readers Example: 1) To issue the “READER_GETIFDTYPE (0x12)” escape command , this pseudo APDU would be used: Command APDU: FF CC 00 00 01 12 Response 20 57 90 00 2) To issue the “READER_SETMODE (0X01)” escape command, this pseudo APDU would be...
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.2. Supported Pseudo APDU (Contactless Interface) All Pseudo APDUs specific to Contactless Interface supported in the reader are explained in this section 6.2.1. PAPDU_MIFARE_READ_BINARY This command is used to read data from a Mifare card. Refer to section 3.2.2.1.8 of [PCSC3] for details.
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.2.2. PAPDU_MIFARE_UPDATE_BINARY This command is used to update the non-volatile memory of a Mifare card. Refer to section 3.2.2.1.9 of [PCSC3] for further details. Command APDU: Command Data Update Binary 0xFF...
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.2.3. PAPDU_MIFARE_LOAD_KEYS This command is used to load the key to the volatile memory of the reader. It can be used for all kinds of contactless cards. Refer to section 3.2.2.1.4 of [PCSC3] for further details.
Reference Manual for uTrust 4701F and uTrust 4711F Readers Examples Load Keys – Card – Non-Secure “FF FFFFFFFFFF” is The command to load Mifare key A FF82006006 FFFFFFFFFFFF Load Keys – Card – Secure: If the default AES128 reader is key is...
Reference Manual for uTrust 4701F and uTrust 4711F Readers Example: decrement block 4 by 1 (key loading and authentication not shown) (block 4 has got to be set up as value block prior to executing this command, see datasheet for Mifare...
Reference Manual for uTrust 4701F and uTrust 4711F Readers Error Status Description XX SW1 SW2 XX = number of the bad data object in the APDU; 00 = general error of APDU; 01 = error in the 1 data object;...
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.2.11. PAPDU_ISO14443_PART3_PASS_THRU (Mifare Pass Thru) This command is used to send raw data using Type A standard framing to a card. CRC bytes will be appended automatically. The reader will not add transport protocol data to the raw data – e.g. PCB, NAD, CID etc.
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.2.14. PAPDU_FELICA_REQ_SERVICE This command issues a REQ SERVICE as defined in JIS 9.6.2. P1. On receiving this command an NFC Forum tag type 3 will respond with the area key version of the specified area and the service key version of the specified service.
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.2.17. PAPDU_FELICA_WRITE_BLK This command issues a WRITE as defined in JIS 9.6.4 ● P1 specifies the number of service ● P2 specifies the number of blocks When an NFC Forum tag type 3 receives this command, it writes the records of the specified service.
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.2.19. PAPDU_NFC_TYPE1_TAG_RID This command issues a RID to get the tag’s identification data. Command APDU: Command Data TYPE1 Tag RID Response APDU: Data Status Word HR0 HR1 UID0 UID1 UID2 UID3...
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.2.21. PAPDU_NFC_TYPE1_TAG_READ This command issues a READ to read a single EEPROM memory byte within the static memory model area of blocks 0x0-0xE. Command APDU: Command Data TYPE1 Tag READ Byte Addr...
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.2.23. PAPDU_NFC_TYPE1_TAG_WRITE_NE This command issues a WRITE-NE to write a byte value to one byte within the static memory model area of blocks 0x0-0xE. It does not erase the value of the targeted byte before writing the new data.
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.2.25. PAPDU_NFC_TYPE1_TAG_READ8 This command issues a READ8 to read out a block of eight bytes. Please note that this command only works on Topaz tags in dynamic memory model. Command APDU:...
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.2.27. PAPDU_NFC_TYPE1_TAG_WRITE_NE8 This command issues a WRITE8 to write a block of eight bytes. It does not erase the value of the targeted byte before writing the new data. Using this command, EEPROM bits can be set but not reset.
REG_DWORD value named ‘EscapeCommandEnable’ in the registry to a value of ‘1’. When using the Identiv supplied driver, this will not be necessary. For Windows XP and Windows Vista, the key to hold the value for uTrust 4701 F, contact part would be HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Enum\USB\VID_04E6&PID_5724&MI_00\...
Page 46
Reference Manual for uTrust 4701F and uTrust 4711F Readers For Windows 7 and Windows 8, the value for uTrust 4701 F, contact part, would be HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Enum\USB\VID_04E6&PID_5724&MI_00\Devic e-Instance-xxxx \Device Parameters\WUDFUsbccidDriver that for uTrust 4701 F, contactless part would be HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Enum\USB\VID_04E6&PID_5724&MI_01\Devic e-Instance-xxxx \Device Parameters\WUDFUsbccidDriver The one for uTrust 4711 F, SAM part, would be HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Enum\USB\VID_04E6&PID_5725&MI_00\...
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.3.2. Escape command codes Escape commands can be used by an application to configure uTrust 47xx F to function in a mode that is not its default configured mode or to get specific information. To put the uTrust 47xx F back into its default mode, it either has to be unplugged and plugged again or the application can send the same Escape command again.
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.3.3.1. READER_SETMODE This Escape command 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 ISO7816, EMV, Memory card and NFC test mode operations.
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.3.3.2. READER_GETMODE This Escape command retrieves the current mode of the reader. Input: The input buffer contains the escape code value. Byte0 Escape code(0x02) Output: The currently active reader mode will be returned as a byte value...
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.3.3.4. READER_LED_CONTROL This Escape command is used to toggle the LED state. LED control by firmware should be disabled using the escape command READER_LED_CONTROL_BY_FW to see proper LED change when using this IOCTL.
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.3.3.5. READER_GET_INFO_EXTENDED This Escape command is used to get the firmware version, reader capabilities, and Unicode serial number of the reader. Input: The first byte of the input buffer contains the escape code.
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.3.3.6. READER_LED_CONTROL_BY_FW This Escape command is used to enable/disable LED control by firmware. Input: The first byte of the input buffer contains the escape code. The second byte specifies if LED control by firmware should be disabled or enabled.
Byte2 and Byte3 constitute the world wide unique vendor ID as assigned by the USB organization. For Identiv based readers Byte2 = 0x04 and Byte3 = 0xE6 since it USB Vendor ID is 0x04E6 Output: If the command is successful, a single byte is returned. This byte indicates the status of contact slot which needs to be interpreted as below.
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.3.4.1. CNTLESS_GET_CARD_INFO This Escape command is used to get information about the contactless card placed in the field of the reader. Input: The first byte of input buffer contains the escape code.
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.3.4.2. CNTLESS_GET_ATS_ATQB This Escape command retrieves the ATS for Type A T= CL or the ATQB for Type B cards. Input: The first byte of input buffer contains the escape code.
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.3.4.4. READER_CNTLESS_SET_TYPE This escape command configures the type of cards the reader will poll for. Using this command can improve the polling efficiency for applications where only specific types of cards are expected.
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.3.4.5. CNTLESS_CONTROL_PPS This Escape command disables the automatic PPS done by the firmware/device for contactless cards. Input: The first byte of input buffer contains the escape code. The second byte either sets the mode or contains a code to retrieve the setting.
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.3.4.7. CNTLESS_SWITCH_RF_ON_OFF This Escape command is used to switch the RF field ON or OFF when a contact smart card is inserted into the reader. By default, the RF field is always in the ON state and when a contact smart card is inserted in the reader, the RF field is turned OFF.
Reference Manual for uTrust 4701F and uTrust 4711F Readers If B1 of the input buffer is 0xFF, the output buffer is a BYTE buffer with following possible values Output buffer Description 0x00 848Kbps is disabled 0x01 848Kbps is enabled 6.3.4.9.
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.3.4.10. CNTLESS_CONTROL_RETRIES This Escape command is used to enable/disable CRC/PROTOCOL/TIMEOUT error retries which are enabled by default for contactless cards. Input: The first byte of input buffer contains the escape code.
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.3.4.12. CNTLESS_FORCE_BAUDRATE This escape command can be used to restrict the baud rate for contactless cards to certain values. The input buffer is Byte # Value Description 0xAD Escape command code...
Page 63
Reference Manual for uTrust 4701F and uTrust 4711F Readers 0x43 FeliCa 0x44 Topaz 0x45 B-prime 0x46 i-Class ‘xx’ ‘xx’ is the PUPI / UID Length 0x08 For FeliCa cards THEN EITHER PUPI/UID bytes B3-B12 0x00 byte padding used if length smaller than 10...
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.3.4.14. CNTLESS_SET_CONFIG_PARAMS This Escape command is used to configure RXGAIN and RXTHRESHOLD of the RF receiver for different baud rates and card types. All configured parameters are volatile. Input: The first byte of input buffer contains the escape code. The following 16 bytes contain the below defined parameters.
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.3.4.15. CNTLESS_IS_COLLISION_DETECTED This Escape command is used to identify if multiple Type A cards are detected in the field. Input: The first byte of input buffer contains the escape code. Byte0...
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.3.4.17. CNTLESS_P2P_SWITCH_MODES This Escape command is used to switch the device between the reader/writer and P2P modes of operation and to query the current mode. By default, the device is in the reader/writer mode.
Page 68
Reference Manual for uTrust 4701F and uTrust 4711F Readers Output Buffer: ● Initiator Mode : On successful detection of target, the entire ATR_RES buffer from the target device would be given to the host computer ● Target Mode : On successful detection by the initiator the entire ATR_REQ buffer from the initiator device would be given to the host computer ●...
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.3.4.18. CNTLESS_P2P_TARGET_RECEIVE This Escape command is used to receive data from the initiator device. Prior to using this command, device should have been successfully switched target mode using CNTLESS_P2P_SWITCH_MODES (E9). Input Buffer:...
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.3.4.19. CNTLESS_P2P_TARGET_SEND This Escape command is used to send data to an initiator device. Prior to using this command, the device should have been successfully switched to target mode using CNTLESS_P2P_SWITCH_MODES (E9).
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.3.4.21. CNTLESS_P2P_INITIATOR_TRANCEIVE This Escape command is used to send data to a target device. Prior to using this command, the device should have been successfully switched to initiator mode using CNTLESS_P2P_SWITCH_MODES (E9).
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.3.4.22. CNTLESS_NFC_SINGLESHOT This Escape command is used to switch the device to Single-shot mode. Input: Offset Description Detailed description 0xEC NFC Single-shot NFC_DEP supported. 0x01 If a value other than 0x01 is given, NFC_DEP is not supported in the preceding I-Blocks.
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.3.4.24. CNTLESS_GET_SET_NFC_PARAMS This Escape command is supported through the READER_GENERIC_ESCAPE command. During NFC operation, number parameters like DID, LRi, PSL_REQ_BRS and PSL_REQ_FSL can be controlled from application. Input: To set the parameters the command syntax is:...
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.3.4.25. CNTLESS_GET_P2P_EXTERNAL_RF_STATE This Escape command is supported through the READER_GENERIC_ESCAPE message. This command is used to check if external RF is reset after the reader got detected in target mode. Input:...
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.3.5.1. CONTACT_GET_SET_PWR_UP_SEQUENCE This Escape command is used to get or set the following parameters: ● Smart card Power-on sequence ● Delay between successive Activation retires ● Enable/Disable any Voltage Class As soon as card insertion is detected and Power ON message is received from the host, the firmware will start Activation with the configured voltage sequence.
Reference Manual for uTrust 4701F and uTrust 4711F Readers Output: For retrieving all settings (0xFE), the output will be: Byte0 Byte2 Byte 1 Description Value 0x00 Starts with Class C voltage. Time delay between Bit Map of all Voltage (1.8V – 3V – 5V order)
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.3.5.5. CONTACT_APDU_TRANSFER This Escape command exchanges a short APDU with the smart card. The user has to ensure that a card is inserted and powered before issuing this Escape command. This Escape command mostly is used by the MCard API to access synchronous memory cards.
Reference Manual for uTrust 4701F and uTrust 4711F Readers Byte0 Byte1 Byte2 Byte3 Byte4 Byte 5 onwards Escape LSB of send MSB of send LSB of expected MSB of Raw data to code(0x10) length length length expected the card length...
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.3.5.9. CONTACT_CONTROL_ATR_VALIDATION This Escape command is used to enable or disable the ATR validation by the firmware in ISO/IEC 7816 mode. In case the card would emit an ATR that is not ISO/IEC 7816 compliant, the card reader may fail to power up the card.
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.3.5.11. CONTACT_GET_SET_ETU This Escape command is used by the HOST to get/set the current ETU for smart cards. Once set, the new ETU value will take effect immediately. Input: The input buffer contains the Escape code followed by an 8 bit GET/SET identifier. For SET ETU, a DWORD specifying the value to be set is following.
Reference Manual for uTrust 4701F and uTrust 4711F Readers 6.3.5.12. CONTACT_GET_SET_WAITTIME This Escape command is used to get/set the Character/Block Waiting Time for smartcards. The wait time is specified in terms of ETU. Once set, the new Wait time will take effect from the next card communication.
Reference Manual for uTrust 4701F and uTrust 4711F Readers Output: For Get/Set guard time, the output will be the Character/Block Guard Time value. Byte0 Byte1 Byte2 Byte3 Character Guard time in ETU BIT31-BIT24 BIT23-BIT16 BIT15-BIT8 BIT7-BIT0 DataIn = 82 00 01 DataOut: 00 00 00 18 (4 bytes) 6.3.5.14.
Reference Manual for uTrust 4701F and uTrust 4711F Readers 7. Annexes 7.1. Annex A – Status words table Description 0x90 0x00 NO ERROR 0x63 0x00 NO INFORMATION GIVEN 0x65 0x81 MEMORY FAILURE 0x67 0x00 LENGTH INCORRECT 0x68 0x00 CLASS BYTE INCORRECT...
Reference Manual for uTrust 4701F and uTrust 4711F Readers 7.3. Annex C – Mechanical drawings 7.3.1. Reader(s) Outline and cable positions Document Version 1.2 Last revised on Page 89 of 92 2017-09-26...
Reference Manual for uTrust 4701F and uTrust 4711F Readers 7.3.3. Reader mounted to Stand Document Version 1.2 Last revised on Page 91 of 92 2017-09-26...
Reference Manual for uTrust 4701F and uTrust 4711F Readers 7.3.4. uTrust 4711 F - SAM slot Document Version 1.2 Last revised on Page 92 of 92 2017-09-26...