DESKO NFCREADER2 Integration Manual

Page 1
Functional Description - CONFIDENTIAL - Page 1 of 16 DESKO RFID Reader Module Doc # 7 001 17 07 Doc.-Rev.: 2019-06-04
Manual
(Functional Description/ Integration Guide)
DESKO RFID Reader Module
DESKO GmbH Gottlieb-Keim-Str. 56 95448 Bayreuth GERMANY
Tel.: +49 (0)921/79279-0 Fax: +49 (0)921/79279-14 E-mail: info@desko.com Web: http://www.desko.com
Technical Support: E-mail: support@desko.com | Phone: +49 (0) 921 79279-69
Page 2
Functional Description - CONFIDENTIAL - Page 2 of 16 DESKO RFID Reader Module Doc # 7 001 17 07 Doc.-Rev.: 2019-06-04
Table of Contents
0 Introduction ...................................................................................................... 3
0.1 Key Features of the DESKO RFID Reader Module ..................................................... 3
0.2 Package Content ................................................................................................................. 3
1 Technical Overview ........................................................................................... 4
1.1 Technical Data .................................................................................................................... 4
1.2 Connectors ........................................................................................................................... 4
1.3 Dimensions .......................................................................................................................... 5
1.3.1 RFID Reader Module ............................................................................. 5
1.3.2 Antennas .............................................................................................. 5
1.4 Regulation Information .................................................................................................... 7
2 Software Integration .......................................................................................... 8
2.1 Driver Information ............................................................................................................. 8
2.2 Usage of Escape Commands (DESKO Specific APDUs) ............................................ 9
2.3 Microsoft Windows Smart Card Plug&Play Service ................................................... 9
2.4 Specific Application Antenna Handling ..................................................................... 11
3 Hardware Integration Rules ............................................................................. 12
3.1 Hardware Integration in Metal Environment ............................................................ 12
4 DESKO Specific APDUs ..................................................................................... 12
4.1 Features APDUs ................................................................................................................ 12
4.2 Settings APDUs ................................................................................................................. 14
Page 3
Functional Description - CONFIDENTIAL - Page 3 of 16 DESKO RFID Reader Module Doc # 7 001 17 07 Doc.-Rev.: 2019-06-04
0 Introduction
The DESKO RFID Reader Module is an RFID reading unit which supports reading of different contactless smart card technologies. Depending on the configuration, up to two antennas can be connected to the device.
The DESKO RFID Reader Module supports reading of smart card technologies/RFID-documents according to the following standards:
ISO14443A
ISO14443B
Other smart card technologies upon request.
0.1 Key Features of the DESKO RFID Reader Module
The integrated RFID Module is a dual antenna design that is especially designed for passport reading. The RFID module is able to read RFID documents according to ISO 14443 (A/B), ISO 7816 (incl. US passport), ICAO 9303 as well as full NFC support.
0.2 Package Content
RFID Reader Module
USB 2.0 cable
Manual of the DESKO RFID Reader Module
Page 4
Functional Description - CONFIDENTIAL - Page 4 of 16 DESKO RFID Reader Module Doc # 7 001 17 07 Doc.-Rev.: 2019-06-04
1 Technical Overview
1.1 Technical Data
Supply Voltage:
5V DC +/- 5%
Supply Current:
300mA max, 200mA typ
Storage Temperature:
-10°C to +50°C
Operating Temperature:
0°C to +40°C
Humidity:
20% to 80% (R.H. non condensing)
Reliability:
MTBF = 80.000 hours (24/7 operation mode)
RF / EMI Compliance:
Test report available upon request.
CE and FCC
1.2 Connectors
The DESKO RFID Reader Module has the following connectors.
1
PCI-Express
USB Full Speed + Maintanance
2
Antenna Connector 1
3 Antenna Connector 2
4
Connector for Contact Reader
optional
2 3 4
1
Page 5
Functional Description - CONFIDENTIAL - Page 5 of 16 DESKO RFID Reader Module Doc # 7 001 17 07 Doc.-Rev.: 2019-06-04
1.3 Dimensions
1.3.1 RFID Reader Module
1.3.2 Antennas
Antenna Penta Scanner Large:
Page 6
Functional Description - CONFIDENTIAL - Page 6 of 16 DESKO RFID Reader Module Doc # 7 001 17 07 Doc.-Rev.: 2019-06-04
Antenna Penta Scanner Small:
Antenna Penta Scanner Cube (containing 2 Antennnas):
Page 7
Functional Description - CONFIDENTIAL - Page 7 of 16 DESKO RFID Reader Module Doc # 7 001 17 07 Doc.-Rev.: 2019-06-04
1.4 Regulation Information
This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions: (1) this device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation.
NOTE: This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant to part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference in a residential installation. This equipment generates, uses and can radiate radio frequency energy and, if not installed and used in accordance with the instructions, may cause harmful interference to radio communications. However, there is no guarantee that interference will not occur in a particular installation. If this equipment does cause harmful interference to radio or television reception, which can be determined by turning the equipment off and on, the user is encouraged to try to correct the interference by one or more of the following measures:
- Reorient or relocate the receiving antenna.
- Increase the separation between the equipment and receiver.
- Connect the equipment into an outlet on a circuit different from that to which
the receiver is connected.
The users manual or instruction manual for an intentional or unintentional radiator shall caution the user that changes, or modifications not expressly approved by the party responsible for compliance could void the user's authority to operate the equipment. In cases where the manual is provided only in a form other than paper, such as on a computer disk or over the Internet, the information required by this section may be included in the manual in that alternative form, provided the user can reasonably be expected to have the capability to access information in that form.
For the integration of the RFID Reader Module, the specification of KDB 996369 D04 need to be observed.
End Product Labeling: The final end product utilizing the approved module must be labeled on the outside in a visible area with the following statement:
Contains FCC ID WTM-NFCREADER2
Contains IC 7998A-NFCREADER2
If the size of the end product is larger than 8x10cm, then the following FCC part
15.19 statement has to also be available on the label:
Page 8
Functional Description - CONFIDENTIAL - Page 8 of 16 DESKO RFID Reader Module Doc # 7 001 17 07 Doc.-Rev.: 2019-06-04
The device complies with part 15 of the FCC Rules. Operation is subject to the following two conditions: (1) This device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation
Important Note: The OEM integrator is still responsible for the FCC compliance requirement of the end product, which integrates this module. Appropriate measurements (eg. 15B compliance) an if applicable additional equipment authorizations (sDoC) of the host device to be addressed by the integrator/manufacturer. This RF Module must not be sold to the general public.”
This device complies with Industry Canada license-exempt RSS standard(s). Operation is subject to the following two conditions: (1) This device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation.
Le présent appareil est conforme aux CNR d'Industrie Canada applicables aux appareils radio exempts de licence. L'exploitation est autorisée aux deux conditions suivantes : (1) l'appareil ne doit pas produire de brouillage, et (2) l'utilisateur de l'appareil doit accepter tout brouillage radioélectrique subi, même si le brouillage est susceptible d'en compromettre le fonctionnement.
CAUTION: Any changes or modifications not expressly approved by DESKO GmbH
could void the user’s authority to operate the equipment.
2 Software Integration
2.1 Driver Information
Information on driver and device
Driver:
MS Windows CCID Driver
Driver name:
DESKO GmbH SmartCard Reader 0
Device-ID:
1.00
For the latest firmware version, please contact our DESKO support team via e-mail support@desko.com, by phone +49 (0) 921 79279-69 or online
www.desko.com/support.
Page 9
Functional Description - CONFIDENTIAL - Page 9 of 16 DESKO RFID Reader Module Doc # 7 001 17 07 Doc.-Rev.: 2019-06-04
2.2 Usage of Escape Commands (DESKO Specific APDUs)
In order to receive or send an Escape command to a reader, the entry “EscapeCommandEnable” must be added to the Windows registry and set to a non-zero value under one of the following keys:
HKLM\SYSTEM\CCS\Enum\USB\VID_1AC2&PID_0300\1.00\Device
Parameters (prior to Windows 7).
HKLM\SYSTEM\CCS\Enum\USB\ VID_1AC2&PID_0300\1.00\Device
Then the vendor IOCTL for the Escape command is defined as follows:
IOCTL_CCID_ESCAPE SCARD_CTL_CODE(3500).
To set the DWORD registry value, the device needs to be connected, so that the driver can be included in the Windows registry. As soon as the value is set, the device must be logged on to the USB interface once again. This can either be done by connecting/disconnecting the USB cable or by disabling and re-activating the driver.
2.3 Microsoft Windows Smart Card Plug&Play Service
We recommend disabling Microsoft Windows Smart Card Plug&Play Service (Windows Smart Card PnPS) before using the DESKO Smart Card Reader, since it can cause a misbehavior. If Windows Smart Card PnPS is active, an error message referring to an unsuccessfully installed smart card driver software appears in the latest Windows versions.
Page 10
Functional Description - CONFIDENTIAL - Page 10 of 16 DESKO RFID Reader Module Doc # 7 001 17 07 Doc.-Rev.: 2019-06-04
How to disable Windows Smart Card PnPS
To disable Windows Smart Card PnP Service, please follow these steps:
1. Click on “Start“, type
gpedit msc
in the “search programs and files” box.
Confirm with ENTER.
2. In the Local Group Policy Editor Navigation pane, select Computer Configuration“, and then “Administrative Templates.”
3. In the details pane, double-click “Windows Components”, and then double-click Smart Card.
4. Turn on Smart Card Plug and Play service by clicking the right mouse button and then click Edit.
5. Select Disabled, and then click OK.
6. Reboot the PC to activate the changed settings.
For details on deactivating Windows Smart Card PnP, please refer to the following link:
http://support.microsoft.com/kb/976832/en-us.
Page 11
Functional Description - CONFIDENTIAL - Page 11 of 16 DESKO RFID Reader Module Doc # 7 001 17 07 Doc.-Rev.: 2019-06-04
2.4 Specific Application Antenna Handling
Usually, the DESKO RFID Reader Module searches automatically for smart card technologies at the antennas. Nevertheless, in some cases it may be necessary to disable/enable the antennas or to search with only one antenna at a time.
The following example shows, how enabling or disabling of the antenna can be used to optimize the read result:
Page 12
Functional Description - CONFIDENTIAL - Page 12 of 16 DESKO RFID Reader Module Doc # 7 001 17 07 Doc.-Rev.: 2019-06-04
3 Hardware Integration Rules
3.1 Hardware Integration in Metal Environment
When integrating a DESKO Smart Card Reader, please make sure that there are no metal objects close to the device. Any metal object near the DESKO Smart Card Reader detunes the RFID antennas and therefore reduces the RFID reading performance.
Should you want to integrate a DESKO Smart Card Reader in a metal environment, please contact your DESKO contact person or our DESKO support team via e-mail under support@desko.com, by phone +49 (0) 921 79279-69 or online www.desko.com/support to discuss specific integration instructions.
4 DESKO Specific APDUs
An Application Protocol Data Unit (APDU) is defined as a communication unit between a smart card and a smart card application according to ISO 7816 standard.
Before using proprietary APDUs, the “EscapeCommandEnable” entry must be
made in the Windows registry. For a detailed description concerning the usage of escape commands, see chapter 2.2.
4.1 Features APDUs
Features APDUs
Description
Send: FF680001010001 Response: NULL terminated ASCII string
Example:
Response:
30383035303130312E303030303030313500
=
08050101.00000015
Get Firmware Version
Shows latest Firmware version.
Send: FF680010010001 Response: NULL terminated ASCII string
Get compile date
Page 13
Functional Description - CONFIDENTIAL - Page 13 of 16 DESKO RFID Reader Module Doc # 7 001 17 07 Doc.-Rev.: 2019-06-04
Example:
Response: 4A756E202036203230313600
=
Jun 6 2016
Shows compile date.
Send: FF680011010001
Response: NULL terminated ASCII string
Example:
“Response: 31303A30333A353000
=
10:03:50
Get compile time
Shows compile time.
Send: FF680012010001 Response: NULL terminated ASCII string
Example:
Response: 303000
=
00
Get Protocol Version
Shows latest protocol version.
Shows latest protocol version of DESKO specific APDUs.
Default: 00
Page 14
Functional Description - CONFIDENTIAL - Page 14 of 16 DESKO RFID Reader Module Doc # 7 001 17 07 Doc.-Rev.: 2019-06-04
4.2 Settings APDUs
The following APDUs are only temporarily stored. After rebooting the device, you get the values of the default setting again.
Settings APDUs
Description
Send: FF680009010001
Response: 1 Byte
Example:
Response: 03
=
Antenna 0 und Antenna1
Get Antenna Selection
Determines which antennas are used to search for smart card technologies.
Values: 00 none 01 Antenna 0 02 Antenna 1 03 Antenna 0 und antenna 1
Default: 03
Antenna 0: Antenna auf der Reader LP Antenna 1: External antenna
Send: FF680008010201
Response: none
Example:
02
=
Antenna 1
Set Antenna Selection
Returns which antennas shall be used to search for smart card technologies.
Values: 00 none 01 Antenna 0 02 Antenna 1 03 Antenna 0 und antenna 1
Default: 03
Antenna 0: Antenna on Reader LP Antenna 1: External antenna
Send: FF68000B010001
Response: 1 Byte
Example:
Get Maximum TX Bitrate
Shows currently set maximum TX Bitrate.
Default: 02 = 424 kBit
Page 15
Functional Description - CONFIDENTIAL - Page 15 of 16 DESKO RFID Reader Module Doc # 7 001 17 07 Doc.-Rev.: 2019-06-04
Response: 02
=
424kBit
Values: 00 106 kBit 01 212 kBit 02 424 kBit
Send: FF68000A010201
Response: none
Example:
02
=
424kBit
Set Maximum TX Bitrate ²
Sets maximum TX Bitrate.
Values: 00 106 kBit 01 212 kBit 02 424 kBit
Send: FF68000D010001
Response: 1 Byte
Example:
Response: 02
=
424kBit
Get Maximum RX Bitrate
Returns currently set maximum RX Bitrate.
Default: 02 = 424 kBit
Values: 00 106 kBit 01 212 kBit 02 424 kBit
Send: FF68000C010201
Response: none
Example:
02
=
424kBit
Set Maximum RX Bitrate ²
Sets maximum RX Bitrate.
Values: 00 106 kBit 01 212 kBit 02 424 kBit
Send: FF68000E010001
Response: 2 Byte short value
Example:
“Response: 0003
=
ISO14443A und ISO14443B
Get Supported Technologies
Indicates which smart card technologies are searched for. This value is coded bit by bit.
Default: 0003
Values: 00 none 01 ISO14443A 02 ISO14443B
Page 16
Functional Description - CONFIDENTIAL - Page 16 of 16 DESKO RFID Reader Module Doc # 7 001 17 07 Doc.-Rev.: 2019-06-04
03 ISO 14443A + ISO 14443B
Send: FF68000F02000101
Response: 00
Example:
0001
=
ISO14443A only
Set Supported Technologies
Returns which smart card technologies shall be searched for. This value is coded bit by bit.
Values: 00 none 01 ISO14443A 02 ISO14443B
Loading...