background image

© 1996-2005 RF IDeas, Inc. All rights reserved

 

 

Overview 

This document will guide the user through the various documents, specifications, and the contents of the 
AIR ID Writer

 Contactless Read/Write Smart Card Reader. 

 
The 

USB

 and 

RS-232

 serial port contactless read/write reader are fully supported in an optional SDK 

(software developer’s kit).   
 
The 

AIR ID Enroll

 read-only reader may access only the serial number on the iCLASS contactless smart 

card.  No ability to write to the memory is supported with this reader. 
 

NOTE: The Configuration Application, included at no charge, is for use with the reader/writer to 
demonstrate the AIR ID features and functionality.  RF IDeas offers a SDK (software developer’s 
kit) for third party software developers to develop more serious applications around the AIR ID 
platform. 

 

iCLASSAPI.DLL 

 
The 

-USB

 and 

RS-232

 uses drivers supplied with the operating system, however there is a DLL library 

required that is supplied by RF IDeas.  The configuration application makes use of this DLL, 

"iClassAPI.dll"

, which is required for use with the device.  

 
The file: "iClassAPI.dll" is the DLL that manages all operations necessary to:  

1.  Read and Write device configuration items and retrieve a card ID when a card is presented to 

the reader,  

2.  It also provides a means to program HID iCLASS smart cards with application data and read it 

back, and  

3.  To change master keys in the reader and cards.  

 
The reader’s configuration items are grouped according to their general function and are handled 
through structures defined in this document. 
 
Before the configuration items are accessible, the application must be instructed to ‘Connect’ to the 
device and told to ‘Read’ all configuration items.  Once the items have been read into local storage, the 
user may then access them through the four groups of ‘Get’ and ‘Set’ functions.  The configuration items 
are sent back to the device for permanent storage only when the ‘Write’ function is called. 
 
The device may be reset to factory default values by pressing ‘Reset to Defaults’ under the Connect tab.  
This is a fast method to bring the device to a known state.  
 
To read an ID from an iCLASS card/token, it is only necessary to ‘Connect’ to the device.  No 
configuration is necessary if the user is confident that the device is already configured appropriately. 
 
The majority of the discussion within this document will be focused on using the AIR ID reader with HID 
iCLASS contactless smart cards. 
 
The iCLASS cards have two primary areas for the user to work with: 

 

Read-Only card data, typically known as proximity card data used in the building access control 
world.  This information is held in Page 0, Application Area 1 with secure keys known only to 
HID.  There are several ‘configuration parameters associated with this data that may be saved 
within the reader. 

 

Read/Write card data that is held in Application Areas 2 and above.   

 

Summary of Contents for RFID1356i-232

Page 1: ......

Page 2: ...ou may install and use one copy of the SOFTWARE PORTION OF THE PRODUCT on the COMPUTER Network Services If the SOFTWARE PORTION OF THE PRODUCT includes functionality that enables the COMPUTER to act a...

Page 3: ...PRODUCT only in conjunction with that upgraded product unless you destroy the upgraded product If the SOFTWARE PORTION OF THE PRODUCT is an upgrade of a RF IDeas product you now may use that upgraded...

Page 4: ...RF IDeas Inc 1997 2003 All rights reserved Reproduction or distribution of this document in whole or in part or in any form is prohibited without express written permission from RF IDeas Inc Trademar...

Page 5: ...arty application for any serious purposes RF IDeas offers a SDK software developer s kit for third party software developers to develop more serious applications around the AIR ID platform We at RF ID...

Page 6: ...or RS 232 FCC ID iCLASS version M9MRFID1356I100 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 interface an...

Page 7: ...ound 18 Reset To Defaults 18 Timing 19 Get Set Internal Timing 19 Data is valid for 19 Inter key Press time 19 Inter key Release time 19 Sets USB inter key Release time delay in msecs This is the dela...

Page 8: ...onfiguration 27 Get Card CFG 27 Card SN 28 Card Context 28 Key Management 28 New Key ASCII 28 Key in Hex 28 Write to Card 28 Write to Reader 28 Write Default to Reader 28 Read Write 28 Start Block 28...

Page 9: ...Tracker to Configuration Application Version 2 0 0 May 1 2003 Further pre release refinement Version 1 2 0 April 30 2003 Further pre release refinement Consolidation of some confusing function order...

Page 10: ...a and read it back and 3 To change master keys in the reader and cards The reader s configuration items are grouped according to their general function and are handled through structures defined in th...

Page 11: ...or standard access control applications Application Area 2 is limited to 104 bytes of read write data The key that secures the data cannot be updated 16kbits 2kBytes iCLASS credentials The 16K is a hi...

Page 12: ...ll rights reserved template sizes are estimated and vary between manufacturers template sizes provided by manufacturers and are subject to change these are approximate numbers actual usage depends on...

Page 13: ...special area of memory for the programmed iCLASS cards As can be seen above Application Area 1 is essentially reserved for HID Access Control Application i e proximity card Wiegand data such as parity...

Page 14: ...0 is open for users to read and write To access this area using the supplied demo applications for C and Visual Basic you would set the Card Context to Page 0 Appl Area 2 iCLASS 16 K 16 Appl Memory M...

Page 15: ...y in the reader Here are a few macro type operations you will use in working with the iCLASS cards Each operation is shown to indicate the proper sequence of events for executing the given task Read O...

Page 16: ...the card using the Procedure Find Free Page 3 Place the correct Key value into the New Key field unless you are using the Default Key 4 Write this Key to the Card Write to Card or if using the defaul...

Page 17: ...df Page 0 Application Area 1 of the iCLASS contactless smart card is holding information typically associated with the Access Control Industry s proximity card This file documents the read only identi...

Page 18: ...auto detects the AIR ID first on the USB and then if no reader is found it searches on communications ports 1 through 8 Device Found When the connection is successful the Device Found checkbox will i...

Page 19: ...y in msecs This is how long the key is held down Inter key Release time Sets USB inter key Release time delay in msecs This is the delay between keystrokes Lock out time for repetitive reads The lock...

Page 20: ...information Proximity Cards To better understand this reserved area of read only card memory we are including this discussion of proximity cards and formats There are several bits constructed together...

Page 21: ...nown before the read in order to verify its validity How to determine your format and masking Rule1 1st Convert to Binary Rule 2 Card data format in binary is typically something like parity facility...

Page 22: ...ally associated with the Access Control Industry s proximity card Specifically the iCLASS identification number is also known as the proximity card number see Proximity Card Formats above This screen...

Page 23: ...ading and Trailing parity bits Enable FAC ID character This checkbox indicates that a separator character will be used between the FAC and ID codes This char sent between FAC ID This field holds the c...

Page 24: ...at is used for building access control Wiegand cards usually have a parity bit s at each end of the data stream Often users want to strip these bits and simply retrieve the site code or ID code from t...

Page 25: ...you have written the unique address you can selectively communicate with each device to learn which reader sent the card data stream SDK users will use this address field to enter the address for the...

Page 26: ...ent of the bits defined by an F in the Filter Mask ID Code The ID Code will represent the decimal equivalent of the bits defined by an I in the Filter Mask Enable Output as Hexadecimal This checkbox a...

Page 27: ...ng the Get Card Cfg button will read the entire card s configuration and memory The application will read and determine the free pages those pages that are using the default keys as well as the memory...

Page 28: ...not to leave an access key for someone else to use New Key ASCII Enter a new Key in this field that you will send to either the card reader or both Pressing either the Write Key to Card or Write Key...

Page 29: ...This section contains useful higher level procedures Find Free Page This routine is valid for 16k cards only It searches each page 1 7 for memory pages that are protected with the default key When a p...

Page 30: ...mation the station PC can insert before top section or after bottom section the data read from a specific area middle section of the screen below of the card s memory The concept is to have a series o...

Page 31: ...card Delimiter The user can choose delimiters None Comma or Tab The delimiter is inserted after each field or date time stamp Station Label The user may type in any identifier The first information k...

Page 32: ...1996 2005 RF IDeas Inc All rights reserved ICLASS Memory Map Please refer to the iCLASS Memory Map discussion above...

Page 33: ...1996 2005 RF IDeas Inc All rights reserved About...

Page 34: ...1996 2005 RF IDeas Inc All rights reserved OK Leave the AIR ID Dialog Screen...

Page 35: ...1996 2005 RF IDeas Inc All rights reserved...

Page 36: ...an out of devices 8 SetupDiGetDeviceInterfaceDetail ERROR_INSUFFICIENT_BUFFER GetLastError 9 Failed pDevIFDetail LocalAlloc 10 VendorID and or ProductID not found 11 CreateFile failed 12 SetupDiGetDev...

Reviews: