ClarIDy UHF USB Reader Demo Program for Linux ClarIDy UHF USB Reader Demo Program User’s Manual for Linux Product Name: UHF USB Reader Module Model No.: UEE006 Applicant: ClarIDy Solutions, Inc. Version: A.1-01 2008-12-09 ClarIDy Solutions, Inc. 1/28 © Copyright 2008 ClarIDy Solutions, Inc. All rights reserved.
ClarIDy UHF USB Reader Demo Program for Linux Copyright Notice © Copyright 2008 ClarIDy Solutions, Inc. All rights reserved. No part of this document may be reproduced without the prior written permission of ClarIDy Solutions, Inc. Disclaimer The information of this document is subject to change without notice and does not represent a commitment on any part of ClarIDy Solutions, Inc. Trademarks Intel is a registered trademark of Intel Corporation.
ClarIDy UHF USB Reader Demo Program for Linux Change Log Revision Date Author Description A.1 2008.11.07. Jun-Rong Chang Create the ClarIDy UHF SDK Demo Program User’s Manual for Linux A.1-01 3/28 2008.12.09 Jun-Rong Chang Added the application of Lock Tag and Kill Tag © Copyright 2008 ClarIDy Solutions, Inc. All rights reserved.
ClarIDy UHF USB Reader Demo Program for Linux Table of Contents 1. Introduction..................................................................................................................5 2. Installation ...................................................................................................................6 2.0 Prerequisites to Installation ................................................................................6 2.0.1 Hardware Platform Requirements ..............................
ClarIDy UHF USB Reader Demo Program for Linux 1. Introduction This document describes the demo program for ClarIDy UHF RFID Reader. The demo program provides “Setting”, “Algorithm”, “Inventory”, “Read/Write”, “Filter Inventory”, “Filter Read/Write” and “Lock/Kill” functions. Users can use those applications to control the ClarIDy UHF RFID Reader to communicate with EPC RFID tags. The operational procedures are described as the following chapters. 5/28 © Copyright 2008 ClarIDy Solutions, Inc.
ClarIDy UHF USB Reader Demo Program for Linux 2. Installation Before Installing the USB Driver and ClarIDy UHF Demo program, please see prerequisites first. 2.0 Prerequisites to Installation In order to run ClarIDy UHF Demo program as smoothly as possible, we recommend some conditions as following. 2.0.1 Hardware Platform Requirements The following hardware Platforms are supported by ClarIDy UHF RFID Reader CPU: Intel® Pentium® 4 or AMD® Athlon™ processor, 1.4 GHz or above RAM: 512MB or above 2.
ClarIDy UHF USB Reader Demo Program for Linux Figure 2 extract the “ClarIDy_UHF_SDK_Linux.tar.gz” from tarball Figure 3 Run “source setup.sh” 7/28 © Copyright 2008 ClarIDy Solutions, Inc. All rights reserved.
ClarIDy UHF USB Reader Demo Program for Linux 3. Demo Program Operation Guide The following sections will describe the usage of the ClarIDy UHF Demo application.First run the "ClarIDy_UHF_Demo". The application is include two Controls, “Setting” and “Operation”, as Figure 4. Figure 4 Run “ClarIDy_UHF_Demo” 3.1 Setting The ClarIDy UHF Demo Program support two configure (as Figure 5) as follows: 1. Set Reader Current Configure 2. Set Algorithm Configure Figure 5 Setting 2.2.
ClarIDy UHF USB Reader Demo Program for Linux 1. Link Profile: Sets the current link profile for the reader module, as figure 6. The option is as follows: 0: DSB ASK / MO / 40 khz 1: DSB_ASK / M1 / 160 khz 2: PR_ASK / M2 / 25U khz 3: PR_ASK / M2 / 300 khz 4: DSB_ASK / MO / 400 khz 5: PR_ASK / M1 / 250 khz Figure 6 Set to Link Profile 2. Data Format: Sets the operation response data reporting mode for tag-protocol operations, as figure 7.
ClarIDy UHF USB Reader Demo Program for Linux Figure 7 Set to Data Format 3. Operation Mode: Sets the reader's operation mode, as figure 8. The option is as follows: 0: CONTINUOUS: In continuous mode, when a tag-protocol-operation cycle (i.e., one iteration through all enabled antenna ports) has completed, the reader module will begin a new tag-protocol-operation cycle with the first enabled antenna port and will continue to do so until the operation is explicitly cancelled by the application.
ClarIDy UHF USB Reader Demo Program for Linux Figure 8 Operation Mode 4. Inventory Algorithm: Allows the application to set the currently-active singulation algorithm, as figure 9. The option is as follows: 0: ALGORITHM_FIXEDQ 1: DYNAMICQ 2: DYNAMICQ_ADJUST 3: DYNAMICQ_THRESHOLD Figure 9 Set to Inventory Algorithm 11/28 © Copyright 2008 ClarIDy Solutions, Inc. All rights reserved.
ClarIDy UHF USB Reader Demo Program for Linux 2.2.2 Algorithm Configure The Algorithm Configure page allows the user to configure the following items (as figure 10): Figure 10 Algorithm Configure 1. FixedQ (as figure 11): Fixed Q algorithm. The items as follows: 1: qValue: The Q value to use. Valid values are 0 to 15, inclusive.
ClarIDy UHF USB Reader Demo Program for Linux Figure 11 Set to FixedQ 2. DynamicQ (as figure 12): Adjusts the Q value based on the presence or absence of tags. The items as follows: 1: startQValue: The starting Q value to use. minQValue <= Valid values are 0 to 15, inclusive. startQValue <= maxQValue 2: minQValue: The minimum Q value to use. Valid values are 0 to 15, inclusive. minQValue <= startQValue <= maxQValue 3: maxQValue: The maximum Q value to use. Valid values are 0 to 15, inclusive.
ClarIDy UHF USB Reader Demo Program for Linux Figure 12 Set to DynamicQ 3. DynamicQAdjust (as figure 13): This algorithm modifies the previous dynamic Q algorithm by issuing ISO 18000-6C Query Adjust commands instead of ISO 18000-6C Query commands when adjusting the Q value. The items as follows: 1: startQValue: The starting Q value to use. minQValue <= Valid values are 0 to 15, inclusive. startQValue <= maxQValue 2: minQValue: The minimum Q value to use. Valid values are 0 to 15, inclusive.
ClarIDy UHF USB Reader Demo Program for Linux Figure 13 Set to DynamicQAdjust 4. DynamicQThreshold (as figure 14): This algorithm uses a Q-modification algorithm that allows the application to control the change of the Q-adjustment-threshold value. The items as follows: 1: startQValue: The starting Q value to use. minQValue <= Valid values are 0 to 15, inclusive. startQValue <= maxQValue 2: minQValue: The minimum Q value to use. Valid values are 0 to 15, inclusive.
ClarIDy UHF USB Reader Demo Program for Linux Figure 14 Set to DynamicQThreshold 3.2 Operation The ClarIDy UHF Demo Program supports six Operations as follows (as figure 15): 1. Inventory 2. Read 3. Write 4. Filter Inventory 5. Filter Read 6. Filter Write Figure 15 Operation 16/28 © Copyright 2008 ClarIDy Solutions, Inc. All rights reserved.
ClarIDy UHF USB Reader Demo Program for Linux 3.2.1 Inventory Inventory step by step as the following instructions: 1. When the user select "1: Inventory" then showed the "Input interval time (second)", as figure 16. 2. Input interval time. 3. Place the RFID tag in the RF field of the ClarIDy UHF RFID Reader. 4. The PC (“PC”), EPC (EPC), CRC16 (CRC), number of reads (“Count”), and Receive Signal Strength Indicator (“RSSI”) will be shown on the table, as figure 16.
ClarIDy UHF USB Reader Demo Program for Linux Figure 17 Read EPC 2. Read User Memory (as figure 18): Input “StartOffset” and “Count” then showed the user memory data. Figure 18 Read User Memory Note : StartOffset: The offset of the first 16-bit word to read. Count: The nubmer of 16-bit words to read. 3.2.3 Write The Write page allows the user to configure the following items: 1. Write EPC (as figure 19): input 24 nibble to Write Tag EPC Data. 18/28 © Copyright 2008 ClarIDy Solutions, Inc.
ClarIDy UHF USB Reader Demo Program for Linux Figure 19 Write EPC 2. Write User Memory (as figure 20): Input “StartOffset”, “Count” and “WriteData” then write the data to user memory. Figure 20 Write User Memory Note : StartOffset: The offset of the first 16-bit word to write. Count: The nubmer of 16-bit words to write. WriteData: The Write data length is Count * 4 nibble. 19/28 © Copyright 2008 ClarIDy Solutions, Inc. All rights reserved.
ClarIDy UHF USB Reader Demo Program for Linux 3.2.4 Filter Inventory Follow the instructions step by step as following: 1. When the user select "4: Filter Inventory", the system shows the input dialogs: “Mask bank”, “Mask start”, “Mask Length”, “Mask data”, “match or unmatched” and “interval time”, as figure 21. 2. Place the RFID tag in the RF field of the ClarIDy UHF RFID Reader. 3.
ClarIDy UHF USB Reader Demo Program for Linux Interval time: Runs out the FlterInventory total time 3.2.5 Filter Read Follow the instructions step by step as following: 1. Place the RFID tag in the RF field of the ClarIDy UHF RFID Reader. 2. Selects "5: Filter Read" , the system shows the input dialogs: “Mask bank”, “Mask start”, “Mask Length”, “Mask data”, “match or unmatched”, “Start offset” and “Count”, as figure 22. 3. The system will show the filtered tag’s memory data, as figure 20.
ClarIDy UHF USB Reader Demo Program for Linux Figure 22 Filter Read 3.2.6 Filter Write Follow the instructions step by step as following: 1. Place the RFID tag in the RF field of the ClarIDy UHF RFID Reader. 2. Selects "6: Filter Write" , the system shows the input dialogs: “Mask bank”, “Mask start”, “Mask Length”, “Mask data”, “match or unmatched”, “Start offset”, “Count” and “WriteData”, as figure 23. 3. The system will show the write OK or failed, as figure 23.
ClarIDy UHF USB Reader Demo Program for Linux Figure 23 Filter Write 3.2.7 Lock Tag Follow the instructions step by step as following: 1. Place the RFID tag in the RF field of the ClarIDy UHF RFID Reader. 2. Selects "7: Lock Tag" , the system shows the input dialogs: “Mask bank”, “Mask start”, “Mask Length”, “Mask data” and “match or unmatched”. 3. Select “KillPassword”,” AccessPassword”, “EPC Memory Bank”, “TID Memory Bank” and “User Memory Bank” state. 4. Input the AccessPassword. 5.
ClarIDy UHF USB Reader Demo Program for Linux Figure 25 Set Lock Tag State Note : Mask bank: The memory bank to match against ( 0: Reserved, 1: EPC, 2: TID, 3: USER Memory). Mask start offset: The offset of the first byte to match. Mask Length: The number of bits in the mask. Mask data: The byte pattern to match. Match or unmatched: selected to match or unmatched (0: none 2: unmatched, 3: match ). 24/28 © Copyright 2008 ClarIDy Solutions, Inc. All rights reserved.
ClarIDy UHF USB Reader Demo Program for Linux AccessPassword: The access password for the tags. A value of zero indicates no access password. The state of “KillPassword” and “AccessPassword” as follows: Accessible: The password may be read and written when the tag is in either the open or secured states. Accessible Permanently: The password may be read and written when the tag is in either the open or secured states and this access permission should be set permanently.
ClarIDy UHF USB Reader Demo Program for Linux Mask start offset: The offset of the first byte to match. Mask Length: The number of bits in the mask. Mask data: The byte pattern to match. Match or unmatched: selected to match or unmatched (0: none 2: unmatched, 3: match ). AccessPassword: The access password for the tags. A value of zero indicates no access password. KillPassword: The kill password for the tags. Figure 26 Kill Tag 26/28 © Copyright 2008 ClarIDy Solutions, Inc. All rights reserved.
ClarIDy UHF USB Reader Demo Program for Linux 4. Error Code The following lists provide error codes of demo program. These values are defined in the description.
ClarIDy UHF USB Reader Demo Program for Linux -7999 Fail to find reader -7998 Fail to allocate memory -7997 Write Data failure -7996 Read Data failure -7995 Lock Tag failure -7994 Kill Tag failure 28/28 © Copyright 2008 ClarIDy Solutions, Inc. All rights reserved.
