LICENSE AGREEMENT TM End-User License Agreement for RF IDeas SOFTWARE and HARDWARE – AIR iD Writer, AIR ID Enroll, AIR ID Playback, ® ® ® RFID1356i, RF IDeas’ AIR ID , AIR ID LT, pcProx USB, and pcProx Contactless and Proximity Activated Readers, Software Developer’s Kit, and Proximity Reader Protocol(s).
* Limitations on Reverse Engineering, Decompilation and Disassembly. You may not reverse engineer, decompile, or disassemble the PRODUCT, except and only to the extent that such activity is expressly permitted by applicable law notwithstanding this limitation. * You may not reproduce or otherwise emulate, in whole or in part, any form the protocol(s) defined within this PRODUCT for use without a RF IDeas PRODUCT. * Redistributable Code.
Returns RF IDeas products which require Limited Warranty service during the warranty period shall be delivered to the nearest authorized dealer or sent directly to RF IDeas at the address below with proof of purchase and a Return Materials Authorization (RMA) Number provided by RF IDeas technical support Dept. Replacement parts or complete boards become the property of RF IDeas.
Congratulations on the purchase of your RFID1356i-USB-ID, RFID1356i-USB, or RFID1356i-232 with the Configuration Application. The Configuration Application included at no charge is for use with the reader/writer to demonstrate the AIR ID features and functionality. The reader/writer is intended to be used with a third party application for any serious purposes.
FCC Compliance Statements AIR ID (formerly RFID1356i) Base Unit(USB 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, and (2) This device must accept any interference that may cause undesired operation. CE Mark for European operation © 1996-2005 RF IDeas, Inc.
Table of Contents LICENSE AGREEMENT .............................................................................................................................2 SOFTWARE PRODUCT LICENSE .............................................................................................................2 Limited Warranty ...............................................................................................................................3 Returns............................................................
SDK Controls LED ..........................................................................................................................24 Red LED..........................................................................................................................................25 Green LED ......................................................................................................................................25 AIR ID USB Readers on this Machine ........................................
AIR ID Release Information Version 3.03 Adding iCLASS 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 and timing. Version 1.1.0 - April. 19, 2003 Further pre-release refinement. Version 1.0.0 - April. 12, 2003 © 1996-2005 RF IDeas, Inc.
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.
The ‘Get ID’ button may be pressed when the ‘Software Developer Kit Mode is checked (Advanced tab). It is independent of configuration activity, except that it should not be called directly (within 1 second) after performing a ‘Write’ to memory function. When the user application is finished, the ‘Disconnect’ function should be pressed. The ‘GetLibVersion’ function does not require that a ‘Connect’ be performed first. It only requires that the Library DLL was successfully loaded into memory.
*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 application configuration. © 1996-2005 RF IDeas, Inc.
iCLASS Read/Write Memory The read/write memory for the iCLASS cards is accessible by using a key you place in one of the reader’s 7 key storage memory areas. The key you reference in the reader must agree with the key already in the card in order for access to be granted. If the two keys (card and reader) do not agree, access is denied. iCLASS Page 0 Memory Map Blocks (8 bytes each) 0 through 5 in each page contain various configuration information.
Open Memory Areas Application Area 2 in Page 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 Map Pages 1 Through 7 For the 16k card, the remaining memory is structured as shown above, © 1996-2005 RF IDeas, Inc.
Memory Operations When you access a given area of memory on the card your reader key must agree with the key in the card. If the keys do not agree, you will receive the error message: indicating the iCLASS card was not identified. The card was not identified since AIR ID could not gain access using the Key as defined in the reader.
Erase and Free Memory Area When you want to clear and free an area of memory from the card, you must perform the following in order: 1. Get the Card Configuration: Get Card Cfg. 2. Find a Free are on 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 default Key do nothing 5.
Disk Contents AIRID-Config.pdf – This document. pcProx.pdf - 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 identification configuration parameters. license.txt – License Agreement for AIR ID hardware and software. © 1996-2005 RF IDeas, Inc.
Configuration Application Included is a complete application exerciser. Connect The DLL 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 indicate which device was found. Reset To Defaults Applies to the read-only access control data stored as configuration information. © 1996-2005 RF IDeas, Inc.
Timing Get/Set Internal Timing Data is valid for The time the card ID remains valid in the device. Once this time elapses, the card data is discarded. The minimum value is 900. Inter-key 'Press' time Sets USB inter-key Press' time delay 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.
Proximity Card Formats This tab section is included since the 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 screen shot shows how the typical proximity card bit-stream is presented. Background 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 actually 24 bits of usable information as the first and last bits are really parity bits to ensure data integrity. This is typical layout for a 26-bit card. PARITY BIT The leading and trailing 1-3 bits are usually the parity bits. For a 26-bit card, only 1 leading and 1 trailing parity bit is used. IDENTIFICATION CODE Immediately following is the identification code. For a 26-bit card this is 16 bits. FACILITY CODE The next bits are normally used as the facility code.
Set Proximity Configuration The next two tabs ‘Set Proximity Configuration’ and ‘Advanced’ manage the traditional proximity card data. This tab section is included since the Page 0 Application Area 1 of the iCLASS contactless smart card is holding information typically 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).
Strip Leading Parity bit count The indicated number of Leading Parity bit(s) are ignored. There are typically only 1 or 2 leading parity bits. Strip Trailing Parity bit count The indicated number of Trailing Parity bit(s) are ignored. There is typically only 1 trailing parity bit. The following keystrokes are sent ahead of card data You may specify up to 2 keystroke characters that will be inserted in front of the card data. Note there are 3 special characters (hex 01, 02, 03) that can be specified.
Advanced Configuration The AIR ID reader has a memory storage area that holds configuration information related to how to handle the card’s Wiegand ID that 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 the card.
Normally, the reader goes from red to green when a proximity card is read (i.e. HID proximity card being read by a pcProxH reader). This can be restricted by the bit count. For example, if the user configures the reader to ‘read only 26 bit cards’ the LED will go green when any HID 26 bit card is placed on the reader. A HID 34 bit card, will not turn green. Selecting this feature will cause the LED colors to come under the control of the SDK, not the independent card reading function.
Get ID This button is active when the ‘Disable Sending keystrokes as data’ is selected. Pressing this button, while a proximity card is present on the reader, will read the card’s data and display the result in the field next to the button. Raw Data This field will contain the number of bits read from the card (less the parity bits stripped) and show the card’s data in hexadecimal format. Filter Mask If the Filter Mask field is empty, the program will try to ‘guess’ at the format for the card.
Contactless Read/Write To begin to work with the read/write section, you must 1st place the iClass contactless card on the reader and perform a ‘Get Card Cfg.’ by pressing this button. This will retrieve the cards complete configuration and memory. Card Configuration Get Card CFG Pressing the Get Card Cfg button will read the entire card’s configuration and memory.
Card SN Each iCLASS contactless smart card has a unique serial number. When you press the Get Card Cfg button, this number is retrieved. Card Context This section describes the area of memory on the card you intend to work with along with the specific key location (1-7) in the reader that will be used to attempt to gain access. See Memory Map above for additional details. Key Management In order to successfully read or write to an iCLASS card the correct security key must be written to the reader.
Number of Bytes Set to write 8 bytes. If you enter less than 8 bytes, the VB application will append “ “ spaces, to fill in 8 bytes worth of data to write. Write ASCII Press this button to write the data shown in the ASCII field to the memory area designated by the Card Context and Starting Block field. HEX Shows the hex value of the data entered in the ASCII field. Procedures This section contains useful, higher level, procedures. Find Free Page This routine is valid for 16k cards only.
ICLASS Tracker The iCLASS Tracker Tab allows the user to use the iCLASS cards to automatically keystroke data to any application by reading the memory from specific areas of the card. The iCLASS Tracker supports only the iCLASS 16k/16 Application area cards – part number: BDG-2002. The iCLASS Tracker screen layout shows information 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.
Productivity Tracker Example In a manufacturing environment the stations would collect user information from various workers throughout the day. At the end of the day, the text files from each station would be imported into an application such as MS Access. The Access application macros could calculate and report on User time durations between events on a given station as well as time durations between stations as a way to measure productivity.
ICLASS Memory Map Please refer to the iCLASS Memory Map discussion above. © 1996-2005 RF IDeas, Inc.
About © 1996-2005 RF IDeas, Inc.
OK Leave the AIR ID Dialog Screen. © 1996-2005 RF IDeas, Inc.
© 1996-2005 RF IDeas, Inc.
Library Error Codes Returned from GetLastLibErr() Public Interface Error bits: USBConnect ReadCfg WriteCfg ResetFactoryDflts Get(Structure) NULL Pointer ReadCfg not called Set(Structure) NULL Pointer GetActiveID CommCnct 0x0001xxxx 0x0002xxxx 0x0004xxxx 0x0008xxxx 0x0010xxxx 0x00100001 0x00100002 0x0020xxxx 0x00200001 0x0100xxxx 0x0200xxxx where ‘xxxx’ represents Private Interface Error Bits. Private Interface Error bits: USBDeviceConnect 0x00xx, xx= 1:Couldn't open SETUPAPI.DLL 2:Unresolved SETUPAPI.