xarray tester user guide - sbrfid.comsbrfid.com/xarraytester_userguide.pdf · •...

xArray Tester User Guide

Version: v1.0.0.240

Notices:

Copyright © 2014, Impinj, Inc. All rights reserved.

The information contained in this document is confidential and proprietary toImpinj, Inc. This document is conditionally issued, and neither receipt norpossession hereof confers or transfers any right in, or license to, use the subjectmatter of any drawings, design, or technical information contained herein, norany right to reproduce or disclose any part of the contents hereof, without theprior written consent of Impinj and the authorized recipient hereof.

Impinj reserves the right to change its products and services at any time withoutnotice.

Impinj assumes no responsibility for customer product design or for infringementof patents and/or the rights of third parties, which may result from assistanceprovided by Impinj. No representation of warranty is given and no liability isassumed by Impinj with respect to accuracy or use of such information.

These products are not designed for use in life support appliances, devices, orsystems where malfunction can reasonably be expected to result in personalinjury.

This product is covered by one or more of the following U.S. patents. Otherpatents pending. 7283037, 7026935, 7049964, 7501953, 7030786, 7246751,7245213, 7408466, 7187290, 7304579, 7510117, 7107022, 7419096, 7382257,7405660, 7436308, 7417548, 7391329, 7391329, 7592897, 7589618

1

Table of Contents

• Purpose• Installation Procedure• Start the Application• About• Connect to One or More Readers• Configure Reader

– Configure Reader For WAM– Configure Reader For Locationing– Configure Reader For Utilities

• Tags of Interest Files• Wide Area Monitoring

– Configure GUI For WAM– WAM Log File

• Locationing

– Configure GUI For Locationing– Floor Plan File– Locationing Log File

• Reader Debug Data (RDD)• Uninstall xArray Tester• Software License

2

Purpose

This User Guide will explain how to install and use all of the features ofthe xArray Utility Application named xArray Tester. It will provide enoughdetails to explain each feature and how it should be used.

Installation Procedure

Grab the latest successful executable from the website:

• http://support.impinj.com/

The installation package is named as follows:

xArray Tester_vX.X.X.X.exe(Where vX.X.X.X represents the latest version number (e.g. v1.0.0.240)).

• Open the Installation Package.

• Click the “Run” Button

3

http://support.impinj.com/

• On the Welcome screen click the “Next >” button

4

• Select the Destination Folder Location• Click the “Next >” button

5

• Select the Start Menu Folder Location• Click the “Next >” button

6

• On the “Ready to Install” screen, click the “Install” button

7

• After the Installation finishes, click the “Finish” button

Start the Application

• On Windows 7, Click the Start Button• Navigate to Impinj/xArray Tester

• Click “xArray Tester”

8

About

• Click the “Help” menu option at the top of the Application Screen

9

• Click the “Open User Guide” button– Opens this document

• Click the “OK” button– Return to the prior screen

Connect to One or More Readers

• Click the “Reader Settings” menu option at the top of the ApplicationScreen

When the reader information is added, several buttons become enabled:

10

Bottom Button Operations:

• Click “Add reader” button

– Adds another reader to the end of the list

• Click “Remove selected row(s)” button

– Removes the selected reader(s)– The following popup will appear to confirm the action:

• Click “Compare Configurations” button

– Allows for viewing the Reader configurations in a table format sideby side with other selected readers:

11

• Click the “OK” button

– Applies the changes.– Reader and Profile Configurations will be saved to disk so the infor-

mation will be reloaded the next time the application starts up.

• Click the “Cancel” button

– Cancels the changes made.– Note: RDD Capture will continue to run even if the cancel button is

clicked (for most cases).

Row Operations:

• Check the Toggle box

– Set the checkboxes in all rows to whether the Toggle box is checkedor not.

• Check the box next to a row

– Checked rows will cause that reader to be used in the WAM, andLocationing reports.

• Enter the “Hostname” in the row

12

– Dictates the IP Address or HostName to the reader you want tocontrol

• Enter a “Nickname” to use for the reader

– The application will use the Nickname to identify the reader on thescreen.

– An automatic Nickname will be set using the hostname specified.– The automatic Nickname uses the last 2 hex numbers of the Impinj

Reader hostnames.– If you override the nickname, the automatic Nickname will be disabled.

• Enter a profile name for the reader.

– It allows for configuring the reader and also to switch between differentconfigurations

– The profile name is set to “default” to begin with.

• Click the “Start RDD” button

– xArray Tester will connect to the Reader on the RDD port and startstoring both the RDD and FDD data it receives in the “rdd” folderof the application.

– The File Name and Capture Data Time Window can be seton the Reader Setup -> Configure -> Utilities Tab

– Starting RDD will disable several textbox inputs from being modifiedsince that would cause a data integrity problem.

– Note: Clicking the Cancel button will stop the RDD and FDD captureonly in the case of a new reader being added.

• Click the “Stop RDD” button

– Stop a previously started RDD and FDD capture.

• Click the “Configure” button

– Configures the reader settings for WAM, Locationing, and Utilities

Configure Reader

• In the Reader Settings screen, click the “Configure” button to configurea reader for WAM, Locationing, and Utilities

13

Configure Reader for WAM

• Manual settings: Antennas:

– Specify a comma separate list of antennas to be used in WAM report-ing.

– Defaults to “1”

• Manual settings: Antennas: All Button:

– Click the “All” button to select all 52 Antennas on the xArray reader.

• Manual settings: Antennas: Clear Button:

– Click the “Clear” button to remove all antennas from WAM report-ing.

• Manual settings: Antennas: Select Button:

– Click the “Select” button to graphically specify which of the 52Antennas to use for WAM reporting.

– The following Bullseye screen will appear:

14

• Click any of the 1-52 numbered check boxes

– Toggles the inclusion of that antenna.

• Click the “Sector1” button

– Toggles antennas 1, 2, 3, and 4


– Toggles antennas 5, 13, 21, 29, 37, and 45













15



• Click the “Ring 1” button

– Toggles antennas 5, 6, 7, 8, 9, 10, 11, and 12











• Click the “All” button

– Toggles all the antennas .


– Solidifies your selection.


– Returns to the prior screen without any changes taking place.

• Manual settings: Mode:

– Selects one of the Reader Operation Modes:∗ Mode 0 - Max Throughput - High Speed 640k bps - fastestread rate (Max Throughput)

∗ Mode 1 - Hybrid Mode (High throughput (M=2)) - Hy-brid 80k/160k bps** - intermediate read rate (Hybrid Mode (Highthroughput (M=2))

∗ Mode 2 - Dense Reader M=4 - max 200 reads/sec∗ Mode 3 - Dense Reader M=8 - max 100 reads/sec∗ Mode 4 - Max Miller (High throughput (M=4)) - max450 reads/sec (High throughput (M=4))

∗ Mode 1000 - Autopilot - It chooses the fastest RF mode thatthe channel condition allows.

• Manual settings: Estimated population:

16

– Specifies an estimate of the expected number of tags.– Set this to a power of two and as closely to the actual number of tags

expected to be read– Default value is set to 256– The value must be a 16 bit positive integer

• Manual settings: Session:

– Specifies the Session setting– Session 0 - Reserved for testing– Session 1 - Use where you want tags to quickly forget their singulated

state (forgets state sometime between 0.5 and 5 seconds after de-energizing.)

– Session 2 - Typically use for a reader on one side of a doorway(forgets state at least 2 seconds after power is off)

– Session 3 - Typically use for a reader on the other side of a doorway(forgets state at least 2 seconds after power is off.)

• Manual settings: Target:

– Specifies the Tag Search Mode:– Single Target Inventory:- In Single Target, the reader reads all ‘A’ tags then moves all ‘A’ tagsinto ‘B’ and allows tags to stay quiet once they are inventoried.

∗ This mode is good for high population, dynamic environments.– Dual Target:- Instructs the reader to read all tags in ‘A’ state and move themfrom state ‘A’ into ‘B’. The Reader then reads all tags in ‘B’ stateand move them from state ‘B’ back to state ‘A’. The Reader repeatsthis process.- ‘Manual settings: Session’ has no influence as the reader willimmediately ‘push’ tags back into ‘A’ state.

∗ This mode is good for small populations or static environments.– Single Target w/ suppression:

∗ Same as Single Target Inventory but provides the advantage ofSessions 2 and 3 in that it will remain quiet while in the read fieldonce inventoried thus allowing other tags which may be “quieter”(not reflecting as much power) to be read.

∗ It also provides the advantage of Session 1 in that it will revertalmost immediately back to the ‘A’ state and be available for areader query upon leaving the read field.

• Power settings: Power (dBm):

– Specifies the RF power of the reader.

17

– Defaults to 30 dbM = 4W EIRP– On certain frequencies you may want to use lower power to reduce

spectrum congestion.– Only use this if you are certain of the frequencies to choose.

• Optional settings: Filter:

– Specifies one of the Gen2 EPC Filters– This hexadecimal value (e.g. “F71F8F22”) is tested against the

tag EPC.– When the EPC value matches the tag it will be reported in the WAM

report.

• Optional settings: Memory Bank:

– Drop down list of Memory Bank options for the Gen2 EPC Filters– EPC refers to the EPC of the Tag.– Tid refers to the Tag Identifier.– User refers to the Tag User Memory.– Reserved is reserved.

• Optional settings: Bit Pointer:

– Bit Pointer for the Gen2 EPC Filters– Default value is set to 32– The value must be a 32-bit positive integer

• Optional settings: Length:

– Length of the Mask for the Gen2 EPC Filters– Default value is set to 16– The value must be a 32-bit positive integer

• Optional settings: Fast ID:

– Dictates whether to acquire and display the TID on the WAM ListView.


– Applies the configuration settings to the selected reader.


– Reverts the changes and goes back to the previous screen.

18

Configure Reader for Locationing

• Gen 2 parameters: Mode:

– Select one of the Reader Operation Modes:∗ Mode 0 - Max Throughput - High Speed 640k bps - fastestread rate (Max Throughput)

∗ Mode 1 - Hybrid Mode (High throughput (M=2)) - Hy-brid 80k/160k bps** - intermediate read rate (Hybrid Mode (Highthroughput (M=2))

∗ Mode 2 - Dense Reader M=4 - max 200 reads/sec∗ Mode 3 - Dense Reader M=8 - max 100 reads/sec∗ Mode 4 - Max Miller (High throughput (M=4)) - max450 reads/sec (High throughput (M=4))

∗ Mode 1000 - Autopilot - It chooses the fastest RF mode thatthe channel condition allows.

– Defaults to “Mode 0 : Max Throughput”

• Gen 2 parameters: Session:

– Specifies the Session setting– Session 0 - Reserved for testing

19

– Session 1 - Use where you want tags to quickly forget their singulatedstate (forgets state sometime between 0.5 and 5 seconds after de-energizing.)

– Session 2 - Typically use for a reader on one side of a doorway(forgets state at least 2 seconds after power is off)

– Session 3 - Typically use for a reader on the other side of a doorway(forgets state at least 2 seconds after power is off.)

• Gen 2 parameters: Filter:

– Specifies one of the Gen2 EPC Filters– This hexadecimal value (e.g. “F71F8F22”) is tested against the

tag EPC.– When the EPC value matches the tag it will be reported in the

Location report.

• Gen 2 parameters: Memory Bank:

– Drop down list of Memory Bank options for the Gen2 EPC Filters– EPC refers to the EPC of the Tag.– Tid refers to the Tag Identifier.– User refers to the Tag User Memory.– Reserved is reserved.

• Gen 2 parameters: Bit Pointer:

– Bit Pointer for the Gen2 EPC Filters– Default value is set to 32– The value must be a 32-bit positive integer

• Gen 2 parameters: Length:

– Length of the Mask for the Gen2 EPC Filters– Default value is set to 16– The value must be a 32-bit positive integer

• Location configuration: Motion Window (s):

– Time over which the location is computed– Answers the question “How much back in time the current location is

computed on?”– Defaults to 10 seconds.– The value must be between 1 and 255 seconds.

• Location configuration: Tag age interval (s):

– Answers the question “How long does the reader keep the tag in thedatabase before issuing the Tag Exit Report?”

– Defaults to 20 seconds.– The value must be between 1 and 255 seconds.

20

• Placement configuration: Height (cm):

– Specifies how high off the ground the reader has been placed incentimeters minus the average height of the tags.

– In other words, if the average height of all tags is 300 cm and theheight from the floor to the reader is 1000 cm, then the height needsto be set to 700 cm.

– The value must be between 100 and 1000 cm.

• Placement configuration: X Location (cm):

– Specifies how far into the X axis this reader is from the central pointin centimeters.

– Defaults to 0 cm– The value must be contained within a 32 bit integer.

• Placement configuration: Y Location (cm):

– Specifies how far into the Y axis this reader is from the central pointin centimeters.

– Defaults to 0 cm– The value must be contained within a 32 bit integer.

• Placement configuration: Orientation degrees:

– Specifies the physical orientation of the reader.– It is the anti-clockwise degree of rotation with respect to the 0 orien-

tation that is defined as xArray having the LEDs in the positive YAxis.

– Defaults to 0 degrees– The value must be between -180 and 180.

21

• In the image above,

– The row of LEDs on the XArray are closest to the Y axis side andwould indicate a 0 degree orientation.

– If the row of LEDs on the XArray were closest to the X axis side, thiswould indicate a -90 degree orientation.

• Location reporting: Report interval (s):

– The amount of time between location reports from the reader.– When you see a tag in-between this, it waits the report interval period

before sending out the report.– Defaults to 5 seconds.– The value must be between 1 and 65535 seconds.

• Location reporting: Enable location update report:

– Report generated when the location of the tag is updated and occursat the reporting interval.

• Location reporting: Enable location entry report:

– Report generated when a tag is first seen.

22

• Location reporting: Enable location exit report:– Report generated when a tag expires at the tag age interval.

Configure Reader For Utilities

• RDD Capture: RDD File name:– Specifies the name of the file to place all Reader Debug Data (RDD).– Defaults to “rdd_capture”

• RDD Capture: Capture window:– Specifies how long of a window RDD logs should be captured.– In other words, if 10 minutes is specified, then only the last 10 minutes

of RDD capture will be saved, everything before 10 minutes will beremoved.

– Defaults to 1 minute.– Must be a positive 31-bit value.

Tags of Interest Files

• Tags of Interest (ToI) refers to the Tags the xArray Tester Applicationshould be locating and reporting in the WAM and Location reports.

23

• The way to add these ToI is by uploading one or more files to the Applica-tion.

• At this time, these ToI files are a csv containing both the tag EPC anda color to be used in the GUI to represent the tag.

• A ToI File looks something like:

999908290000000000000001,Color=Green999908290000000000000002,Color=Black999908290000000000000003,Color=Purple999908290000000000000004,Color=Blue999908290000000000000005,Color=Red999908290000000000000006,Color=Yellow999908152014000000000001,Color=Green999908152014000000000002,Color=Black999908152014000000000003,Color=Purple999908152014000000000004,Color=Blue999908152014000000000005,Color=Red999908152014000000000006,Color=Yellow

• The list above shows all supported color strings.• It is also possible to use hex strings in the form #XXXXXX to denote a

color.• Any unknown color string will be set to a tag color of light gray

instead.• One can add one or more ToI files by following the instructions below:• Click the ToI Files Menu Item Link at the top of the Application to get:

24

• Click the “Add file” button

– Inserts a new file entry to the end of the list.

• After the “Add file” button has been pressed a few times, the screen willlook like:

25

• Check the Toggle box

– Set the checkboxes in all rows to whether the Toggle box is checkedor not.

• Check the box next to any row

– That rows ToI csv File will be represented in the WAM, and/orLocationing reports.

• Click the “Browse” button

– Allows the user to navigate to a folder to add ToI csv files.

• Give the ToI csv file a nickname

– The nickname will be used to refer to that ToI csv file in multiplereports.

– The default nickname is the name of the file selected in the row.

26

• Click the “Remove file(s)” button– Removes the selected file(s) entries from the list.– The following popup will appear to confirm the action:

• Click the “OK” button– Applies the Tags of Interest to the system.

• Click the “Cancel” button– Returns to the previous screen without modifying any Tags of Interest

previously setup.

27

Wide Area Monitoring

• The Wide Area Monitoring (WAM) Report starts out blank like:

• Click the “Start” button:

– Kicks off Wide Area Monitoring (WAM) Report to start reading tagsand reporting them to the screen.

• The following is an example of what you may see when running list view:

28

• In the screen image above• EPC:

– Each row has the EPC of the tag read– White rows indicate the tag was seen within the last second.– Pink rows indicate the tag was seen between 1 and 2 seconds ago.– Red rows indicate the tag was seen over 2 seconds ago.

• TID:

– If any readers Fast ID is checked, the Tag Identifier (TID) columnwill appear with data if reported by the reader.

– Only Tag IDs will appear for those readers that have the Fast IDfeature enabled in the xArray Tester configuration.

• Read #:

– Represents the number of times the tag was read across all readers.

• d8-fa:

– Represents the alias for the reader and the value is the number oftimes that tag was read on that reader.

– A column will be created for each active reader

• Average RSSI:

29

– The Average Received Signal Strength Indication value

• Max RSSI:

– The Maximum Received Signal Strength Indication value

• Min RSSI:

– The Minimum Received Signal Strength Indication value

• First timestamp:

– The time stamp of when the tag was first read

• Last timestamp:

– The time stamp of when the tag was last read

• Time since last seen:

– The time delta since the tag was last read

• Antenna:

– The last antenna that picked up the tag.– When more than one reader is present, this value does NOT indicate

which reader and antenna last read it.– Each row that has a white background color means that tag had been

read within the last second.– Each row that has a pink background color means that tag had been

read within the last two seconds but not within the last second.– Each row that has a red background color means that tag had been

read greater than two seconds ago.

• The following is an example of what you may see when running table view:

30

• In the screen image above

– d8-fa is the reader alias∗ A row will be created for each active reader and the corresponding

alias will appear in the Reader column.– Shoes - Is the alias of one of the ToI files– Shoes % - Is the percent of all the tags found that match the EPCs

in the Shoes ToI file– Pants - Is the alias of one of the ToI files– Pants % - Is the percent of all the tags found that match the EPCs

in the Pants ToI file– Shirts - Is the alias of one of the ToI files– Shirts % - Is the percent of all the tags found that match the EPCs

in the Shirts ToI file– Strays - Is the number of tags found that are not from any ToI files.– All files - Count of all tags found that match all ToI files.– All files % - Percent found in all ToI files.– Overall total - Count of all ToI tags and Strays found.

• Stop button:

– Stops a previously running WAM Report.

31

• Time:

– Represents how long the WAM Report has been running.

• Rat X tags/se:

– Represents the incoming rate of tags per seconds in WAM Mode.

• Continuous operation:

– Select this option if you want WAM to run continuously when theStart Button is clicked

• Timed run:

– Select this option if you want WAM to run for a specific amount oftime (Default 10 seconds).

• Advanced:- For those people interested in doing a Power Sweep (aka Margin Test),the Advanced option will allow for this capability.

– Click the “Configure” button to have the following appear:

• Time: Start delay (s):

32

– Specifies how much time to delay before starting an increment.– Default is 1 second.– Must be a positive 32-bit integer in seconds.

• Time: On time (s):– Specifies how much time the reader should be on during each incre-

ment.– Default is 10 seconds.– Must be a positive 32-bit integer in seconds.

• Time: Off time (s):– Specifies how much time the reader should be off during each incre-

ment.– Default is 1 second.– Must be a positive 32-bit integer in seconds.

• Time: Start power:– Specifies the start power value to start incrementing from.– Defaults to 29

• Time: End power:– Specifies the final power value to end incrementing at.– Defaults to 30

• Time: Power step:– Specifies how much to increase the current power by during each

increment.– Defaults to 0.25

• OK Button:– Apply the Power Sweep/Margin Test Changes.

• Cancel Button:– Cancel any changes.

• Log file:– Enter the name of a log file to store all of the tag reads during WAM

Mode.– Log files are saved in the xArray Tester X.X.X.Xdirectory.– The Log is created with a different time stamp.– Refer to the WAM Log File section below for more details.

• Stop all RDD button:– Click the stop previously running RDD runs for all readers.– The Label to the right of this button indicates whether a RDD capture

is taking place

33

Configure GUI for WAM

• Click “GUI Settings -> WAM” tab

• There are two views List view and Table view. The following options areavailable depending on the view:

List view:

• Average RSSI:

– When checked, will display a column with the Average Received SignalStrength Indication

• Max RSSI:

– When checked, will display a column with the Maximum ReceivedSignal Strength Indication

• Min RSSI:

– When checked, will display a column with the Minimum ReceivedSignal Strength Indication

• First timestamp:

34

– When checked, will display a column with a time stamp of when thetag was first read

• Last timestamp:

– When checked, will display a column with a time stamp of when thetag was last read

• Time since last seen:

– When checked, will display the time delta since the tag was last read

• Antenna:

– When checked, will display a column identifying which antenna pickedup the tag

• Power:

– When checked, will display a column identifying the power level ofthe reader for that tag.

• Update interval (ms):

– Specifies how often to update the List View

• OK Button:

– Click to apply the settings

• Cancel Button:

– Click to cancel the setting changes

Table view:

• Show totals row:

– Show the sum of all the columns in a row by itself.

WAM Log File

• When a csv file is specified in the bottom left corner ofthe screen, a log file will be generated in the logs folder of theapplication.

• This file will contain:• Lines that start with two forward slashes (//) are comments.• The first line is a human readable timestamp comment of

when the file was created.• The second line is a comment that lists out all of the pa-

rameters you set in the reader profile configuration for WAM.

35

– e.g. Population Estimate, Inventory Mode, PowerIndex

• The third row is the comment headers for each column inthe rest of the file.

– e.g. Timestamp, EPC, Antenna, RSSI, Channel,Reader Name

• The rest of the log file will contain rows with data in thesame format defined by the third row header comment.

Locationing

• The Locationing Report starts out blank like:

• Start button:

– Kicks off Location Report to start reading tags and reporting themto the screen

– The following is an example of what you may see when running withdisplay only computed values:

36


– There are four readers reading tag locations.– There are six tags that are present in an active ToI file(s).– These six tags have been mapped to colors in the actve ToI file(s).– The calculated location of these tags are seen for each colored tag(colored square).

• The following is an example of what you may see when running withdisplay all reported and computed positions:

37


– There are four readers reading tag locations.– There are five tags that are present in an active ToI file(s).– These five tags have been mapped to colors in the actve ToI file(s).– Both the calculated location (colored square) of these tags and raw

reader seen location(s) (colored circle) of these tags are seen.– Lines are drawn from the raw reader seen locations (colored circles)

and form a shape.– You can see the line (red) and triangle shape (green) in this example.– There are even single calculated locations (purple) from one reader.

• Stop button:

– Stops a previously running Location Report.

• Time:

– Represents how long the Location Report has been running.

• Log file:

– Enter the name of a log file to store all of the tag reads duringLocationing Mode.

– Log files are saved in the xArray Tester X.X.X.Xdirectory.– The Log is created with a different time stamp.

38

– Refer to the Locationing Log File section below for more details.

• Stop all RDD button:

– Click the stop previously running RDD runs for all readers.– The Label to the right of this button indicates whether a RDD capture

is taking place

• Rate X tags/s:

– Displays the number of tag reads per second in Locationing Mode.

Configure GUI for Locationing

• Click “GUI Settings -> Location” tab

• Point display settings: Display only computed position:

– When selected, the computed position of the tag will be displayed.– The location is computed using reported reported locations provided

by all readers.

• Point display settings: Display all reported positions:

39

– When selected, positions reported from all readers will be displayed.– Lines are drawn from the raw reader seen locations and form a shape(e.g. lines or trangles).

• Point display settings: Display all reported locations and computedpositions:

– When selected, displays both computed position and positions re-ported by all readers.

– Lines are drawn from the raw reader seen locations and form a shape(e.g. lines or trangles).

• Custom plot dimensions: Enable custom dimensions:

– When checked, will cause the Location Report to surround all readerswith the distance value in centimeters. If this value is set to 0, thesurrounding readers on the screen would be cut in half by the gridsides. Setting this value makes sure there is enough space around thereaders to see the tags in those areas.

• Custom plot dimensions: Distance (cm):

– Specifies the minimum cm in both the X and Y directions to surroundall readers.

• Custom Floor Plan: Enable Floor Plan:

– When checked, will use the floor plan specified as the backgroundimage of the Location Report. This is useful for displaying xArray’sin their actual space.

• Custom Floor Plan: Floor Plan:

– Specifies the file name to load into the background image of theLocation Report.

– Images and Floor Plan (.fpn) text files can be specified.– More details about Floor Plan files can be seen in the Floor Plan File

section below.

• Custom Floor Plan: Browse Button

– Click to pop-up a File navigator to choose the appropriate floor planfile name.

• Custom Floor Plan: X:

– Specifies the center X location in centimeters where the image shouldbe placed.

40

• Custom Floor Plan: Y:

– Specifies the center Y location in centimeters where the image shouldbe placed.

• Custom Floor Plan: Width:

– Specifies the width in centimeters of how wide the image should bein the grid.

• Custom Floor Plan: Height:

– Specifies the heigh in centimeters of how long the image should be inthe grid.

• Custom Floor Plan: Rotation:- Specifies the rotation of the image within the Location Report. The valuemust be between -180 and 180 with a value of 0 meaning no rotation.

• OK Button:

– Click to apply the settings

• Cancel Button:

– Click to cancel the setting changes

Floor Plan File

One file type that can quickly be used to draw shapes in the backgroundof the Location report is the Floor Plan File with a .fpn file extension. Thefollowing is an example of the contents of such a file and what it displays on thescreen:

CIRCLE,200,200,100,1ELLIPSE,-200,-200,50,100,4LINE,1,1,500,50,10POLYGON,0,0,150,0,150,150,0,150,4RECTANGLE,100,100,50,50,3SQUARE,-300,200,100,2TRIANGLE,300,300,0,100,-100,200,1

41

Each line in the file represents a comma separated list of names and values.The first item in the comma separated list identifies what shape to draw (e.g.CIRCLE, ELLIPSE, LINE, POLYGON, RECTANGLE, SQUARE, orTRIANGLE). The last item specifies the width of the lines to draw. The itemsbetween the first and last item are used to give the dimensions of the shape inquestion. The following explains what are the items in the middle:

• CIRCLE– The first number is the x position in centimeters of the

circles’ center.– The second number is the y position in centimeters of the

circles’ center.– The third number is the circles’ diameter in centimeters.

• ELLIPSE– The first number is the x position in centimeters of the

ellipses’ center.– The second number is the y position in centimeters of the

ellipses’ center.– The third number is the width in centimeters of the ellipses’

center.– The fourth number is the height in centimeters of the ellipses’

center.• LINE

42

– The first number is the x position in centimeters of thelines’ first point.

– The second number is the y position in centimeters of thelines’ first point.

– The third number is the x position in centimeters of thelines’ second point.

– The fourth number is the y position in centimeters of thelines’ second point.

• POLYGON– The middle items are made up of one or more x and y

points in centimeters. For example:∗ The first number is the x position in centimeters of thepolygons’ first point.

∗ The second number is the y position in centimeters ofthe polygons’ first point.

∗ The third number is the x position in centimeters ofthe polygons’ second point.

∗ The fourth number is the y position in centimeters ofthe polygons’ second point.

∗ etc. . .• RECTANGLE

– The first number is the x position in centimeters of therectangles’ center.

– The second number is the y position in centimeters of therectangles’ center.

– The third number is the width in centimeters of the rectan-gles’ center.

– The fourth number is the height in centimeters of the rect-angles’ center.

• SQUARE– The first number is the x position in centimeters of the

squares’ center.– The second number is the y position in centimeters of the

squares’ center.– The third number is the width in centimeters of the squares’

center.– The fourth number is the height in centimeters of the

squares’ center.• TRIANGLE

– The first number is the x position in centimeters of thetriangle’ first point.

– The second number is the y position in centimeters of thetriangle’ first point.

43

– The third number is the x position in centimeters of thetriangle’ second point.

– The fourth number is the y position in centimeters of thetriangle’ second point.

– The fifth number is the x position in centimeters of thetriangle’ third point.

– The sixth number is the y position in centimeters of thetriangle’ third point.

Locationing Log File

• When a csv file is specified in the bottom left corner ofthe screen, a log file will be generated in the logs folder of theapplication.

• This file will contain:• Lines that start with two forward slashes (//) are comments.• The first line is a human readable timestamp comment

of when the file was created.• The second line is a comment that lists out all of the pa-

rameters you set in the reader profile configuration forlocation.

– e.g. Height, X, Y, Orientation• There are two types of lines that can appear in the rest of the

log file.– The first type of line details the Location TagReport with columns:

∗ Timestamp∗ Report Type∗ EPC∗ X Location (in cms)∗ Y Location (in cms)∗ Read Count∗ Confidence Factor Data (It is a list of inter-nal diagnostic values used for debug.)

∗ Reader Address– The second type of line contains calculatedupdates of the tag location. In other words,the location specified is calculated from all activereaders. The columns of this line include:

∗ Algorithm Name∗ Update Type (Virual Update)

44

∗ EPC∗ Calculated X (in cms)∗ Calculated Y (in cms)∗ Last Cycle Time

Reader Debug Data

• Click the following link for instructions on how to configure RDD

– Configure Reader For Utilities (RDD)

• To Start RDD, Click the “Reader Settings” menu item.

• Click the “Start RDD” button next to each reader you want to startcapturing Reader Debug Data.

• xArray Tester will start saving RDD and FDD Files beneath the “rdd”folder of the Application.

• To Stop RDD, Either click the “Reader Settings” menu item or clickthe “Stop all RDD” button on the main xArray Tester Window.

45

• Click the “Stop RDD” button next to each reader you want to stopcapturing Reader Debug Data.

Uninstall xArray Tester

• On Windows 7, Click the Start Button• Navigate to Impinj/xArray Tester X.X.X.X

• Click “Uninstall xArray Tester”

46

• Click the “Yes” button


Software License

XArrayTester Gen2 RFID Utility

Copyright (C) 2005-2014 IMPINJ, Inc.

All Rights Reserved

*** IMPINJ STANDARD LICENSE ***

This license applies to the standard-licensed version of XArrayTester.

XARRAYTESTER LICENSE

IMPINJ, INC.

PLEASE READ THIS XARRAYTESTER LICENSE AGREEMENT (“AGREE-MENT”) CAREFULLY BEFORE USING THE XARRAYTESTER SOFT-WARE AND ASSOCIATED DOCUMENTATION (“SOFTWARE,” “DOCU-MENTATION,” AND COLLECTIVELY, “LICENSED MATERIALS”).

BY USING ANY LICENSED MATERIALS, YOU ACKNOWLEDGE THATYOU HAVE READ AND UNDERSTOOD ALL THE TERMS AND CONDI-TIONS OF THIS AGREEMENT AND YOU WILL BE CONSENTING TOBE BOUND BY THEM. IF YOU DO NOT ACCEPT THESE TERMS ANDCONDITIONS, DO NOT USE THE LICENSED MATERIALS AND RETURNTHE LICENSED MATERIALS UNUSED IN THE ORIGINAL SHIPPINGCONTAINER TO THE PLACE OF PURCHASE FOR A FULL REFUND IFYOU PAID A LICENSE FEE FOR THE SOFTWARE. YOUR RIGHT TORETURN AND REFUND EXPIRES 30 DAYS AFTER PURCHASE FROMIMPINJ OR AN AUTHORIZED IMPINJ RESELLER AND APPLIES ONLYIF YOU ARE THE ORIGINAL END USER CUSTOMER.

47

The following terms govern your use and access of the Licensed Materials, exceptto the extent there is a separate signed agreement between you and Impinjgoverning your use of the Software. To the extent of a conflict among theprovisions of the foregoing documents, the order of precedence is: (i) the signedagreement; and (ii) this Agreement.

1. License.

(a) Subject to the terms and conditions of this Agreement, Impinj, Inc. (“Impinj”),grants to you (“Licensee”) a limited, non-exclusive, non-transferable license,without the right to sublicense: (i) to install and use one (1) copy of the Software,in object code format only, on computer hardware for which all correspondinglicense fees (if any) have been paid and only in conjunction with Licensee’sproper use of an Impinj Gen2 RFID reader, each solely in accordance with theDocumentation for Licensee’s internal business purposes. (b) The license setforth above does not include any rights to and Licensee shall not (i) reproduce(except as set forth in Section 1(c)), modify, make error corrections, translate orcreate any derivative work of all or any portion of the Licensed Materials, (ii)sell, rent, lease, loan, provide, distribute or otherwise transfer all or any portionof the Licensed Materials, (iii) reverse engineer, reverse assemble or otherwiseattempt to gain access to the source code of all or any portion of the LicensedMaterials, (iv) use the Licensed Materials for third-party training, commercialtime-sharing or service bureau use, (v) remove, alter, cover or obfuscate anycopyright notices, trademark notices or other proprietary rights notices placedor embedded on or in the Licensed Materials, (vi) use any component of theSoftware other than solely in conjunction with operation of the Software andImpinj Gen2 RFID reader, (vii) unbundle any component of the Software, (viii)use any component of the Software for the development of or in conjunction withany software application intended for resale that employs any such component,(ix) use the Licensed Materials in life support systems, human implantation,nuclear facilities or systems or any other application where failure could lead toa loss of life or catastrophic property damage, or (x) cause or permit any thirdparty to do any of the foregoing.

If Licensee is a European Union resident, Licensee acknowledges that informationnecessary to achieve interoperability of the Software with other programs isavailable upon request.

(c) Licensee may make a single copy of the Software and Documentation solelyfor its back-up purposes; provided that any such copy is the exclusive property ofImpinj and its suppliers and includes all copyright and other intellectual propertyright notices that appear on the original.

(d) Impinj is not obligated under this Agreement to provide any updates, cor-rections, enhancements, modifications or bug fixes to the Licensed Materials(“Updates”) to Licensee. If Impinj provides any Update to Licensee, such Updateshall be deemed part of the Licensed Materials and subject to the license and all

48

other terms and conditions hereunder, unless Impinj provides other terms alongwith the Update. Licensee shall have no license or right to use any Upgradeunless Licensee, at the time of acquiring any such Update, already holds avalid license to the original Software and has paid the applicable fees for, or isotherwise authorized to use, the Update.

(e) Licensee acknowledges that the Software may contain or is provided withcopyrighted software of Impinj’s suppliers as identified in associated documen-tation or other printed or electronic materials (“Third Party Software”) whichare obtained under a license from such suppliers. Licensee’s use of any ThirdParty Software shall be subject to and Licensee shall comply with the applicablerestrictions and other terms and conditions set forth in such documentation ormaterials.

2. Ownership. Impinj or its suppliers own and shall retain all right, title andinterest (including without limitation all intellectual property rights), in andto the Licensed Materials and any Update, whether or not made by Impinj.Licensee acknowledges that the licenses granted under this Agreement do notprovide Licensee with title to or ownership of the Licensed Materials, but only aright of limited use under the terms and conditions of this Agreement. Except asexpressly set forth in Section 1, Impinj reserves all rights and grants Licensee nolicenses of any kind hereunder. All information or feedback provided by Licenseeto Impinj with respect to the Software shall be Impinj’s property and deemedconfidential information of Impinj.

3. Confidentiality. Licensee agrees that the Licensed Materials contain confiden-tial information, including trade secrets, know-how, and information pertainingto the technical structure or performance of the Software, that is the exclu-sive property of Impinj as between Licensee and Impinj. In addition, Impinj’sconfidential information includes any confidential or trade secret informationrelated to the Licensed Materials. During the period this Agreement is in ef-fect and at all times thereafter, Licensee shall maintain Impinj’s confidentialinformation in confidence and use the same degree of care, but in no event lessthan reasonable care, to avoid disclosure of Impinj’s confidential informationas it uses with respect to its own confidential and proprietary information ofsimilar type and importance. Licensee agrees to only use Impinj’s confidentialinformation incidentally in the customary operation of the Software. Licenseeshall not sell, license, sublicense, publish, display, distribute, disclose or other-wise make available Impinj’s confidential information to any third party nor usesuch information except as authorized by this Agreement. Licensee agrees toimmediately notify Impinj of the unauthorized disclosure or use of the LicensedMaterials and to assist Impinj in remedying such unauthorized use or disclosure.It is further understood and agreed that any breach of this Section 3 or Section1(b) is a material breach of this Agreement and any such breach would causeirreparable harm to Impinj and its suppliers, entitling Impinj or its suppliers toinjunctive relief in addition to all other remedies available at law.

4. Disclaimer. THE LICENSED MATERIALS ARE PROVIDED “AS IS”,

49

AND IMPINJ AND ITS SUPPLIERS MAKE NO WARRANTY, EXPRESS,IMPLIED, STATUTORY OR OTHERWISE, WITH RESPECT TO LICENSEDMATERIALS OR ANY PART THEREOF, INCLUDING WITHOUT LIMI-TATION ANY IMPLIED WARRANTY OF TITLE, MERCHANTABILITY,FITNESS FOR A PARTICULAR PURPOSE, NONINFRINGEMENT, ORTHOSE ARISING FROM COURSE OF PERFORMANCE, DEALING, USAGEOR TRADE. IMPINJ’S SUPPLIERS MAKE NO DIRECT WARRANTY OFANY KIND TO LICENSEE FOR THE LICENSED MATERIALS. NEITHERIMPINJ NOR ANY OF ITS SUPPLIERS WARRANT THAT THE LICENSEDMATERIALS OR ANY PART THEREOF WILL MEET LICENSEE’S RE-QUIREMENTS OR BE UNINTERRUPTED, OR ERROR-FREE, OR THATANY ERRORS IN THE LICENSED MATERIALS WILL BE CORRECTED.SOME STATES/JURISDICTIONS DO NOT ALLOW THE EXCLUSION OFIMPLIED WARRANTIES SO THE ABOVE EXCLUSIONS MAY NOT APPLYTO LICENSEE. THIS LIMITED WARRANTY GIVES LICENSEE SPECIFICLEGAL RIGHTS. LICENSEE MAY ALSO HAVE OTHER RIGHTS, WHICHVARY FROM STATE/JURISDICTION TO STATE/JURISDICTION.

5. Term and Termination. This Agreement is effective until terminated. Licenseemay terminate this Agreement at any time by destroying all copies of the Software.This Agreement and all licenses granted hereunder will terminate immediatelywithout notice from Impinj if Licensee fails to comply with any provision ofthis Agreement. Upon any termination, Licensee must destroy all copies of theLicensed Materials. Sections 1(b), 2, 3, 4, 5, 6, 7, 8 and 9 shall survive anytermination of this Agreement.

6. Export. The Software is specifically subject to U.S. Export AdministrationRegulations. Licensee agrees to strictly comply with all export, re-export andimport restrictions and regulations of the Department of Commerce or otheragency or authority of the United States or other applicable countries, and notto transfer, or authorize the transfer of, directly or indirectly, the Software orany direct product thereof to a prohibited country or otherwise in violationof any such restrictions or regulations. Licensee’s failure to comply with thisSection is a material breach of this Agreement. LICENSEE ACKNOWLEDGESTHAT LICENSEE IS NOT A NATIONAL OF CUBA, IRAN, IRAQ, LIBYA,NORTH KOREA, SUDAN OR SYRIA OR A PARTY LISTED IN THE U.S.TABLE OF DENIAL ORDERS OR U.S. TREASURY DEPARTMENT LISTOF SPECIALLY DESIGNATED NATIONALS.

7. Government Restricted Rights. As defined in FAR section 2.101, DFARsection 252.227-7014(a)(1) and DFAR section 252.227-7014(a)(5) or otherwise,the Software provided in connection with this Agreement are “commercialitems,” “commercial computer software” and/or “commercial computer softwaredocumentation.” Consistent with DFAR section 227.7202, FAR section 12.212and other sections, any use, modification, reproduction, release, performance,display, disclosure or distribution thereof by or for the U.S. Government shall begoverned solely by the terms of this Agreement and shall be prohibited except

50

to the extent expressly permitted by the terms of this Agreement. Any technicaldata provided that is not covered by the above provisions shall be deemed“technical data-commercial items” pursuant to DFAR section 227.7015(a). Anyuse, modification, reproduction, release, performance, display or disclosure ofsuch technical data shall be governed by the terms of DFAR section 227.7015(b).

8. Limitation of Liability. TO THE MAXIMUM EXTENT PERMITTED BYAPPLICABLE LAW, IN NO EVENT SHALL IMPINJ OR ITS SUPPLIERS BELIABLE FOR THE COST OF PROCUREMENT OF SUBSTITUTE GOODSOR SERVICES, LOSS OF PROFITS, OR FOR ANY SPECIAL, CONSEQUEN-TIAL, INCIDENTAL, PUNITIVE OR INDIRECT DAMAGES (OR DIRECTDAMAGES IN THE CASE OF IMPINJ’S SUPPLIERS) ON ANY THEORYOF LIABILITY, WHETHER IN CONTRACT, TORT (INCLUDING WITH-OUT LIMITATION NEGLIGENCE), STRICT LIABILITY OR OTHERWISEARISING OUT OF OR UNDER THIS AGREEMENT OR ANY USE ORINABILITY TO USE THE LICENSED MATERIALS, OR FOR BREACHOF THIS AGREEMENT. IMPINJ’S TOTAL LIABILITY ARISING OUTOF OR UNDER THIS AGREEMENT, OR USE OR INABILITY TO USETHE LICENSED MATERIALS, OR FOR BREACH OF THIS AGREEMENT,WHETHER IN CONTRACT, TORT (INCLUDING WITHOUT LIMITATIONNEGLIGENCE), STRICT LIABILITY OR OTHERWISE, SHALL NOT EX-CEED THE GREATER OF THE PRICE PAID FOR THE SOFTWARE (IFANY) OR TEN U.S. DOLLARS (US$10.00). THE LIMITATIONS SET FORTHIN THIS SECTION SHALL APPLY EVEN IF IMPINJ AND/OR ITS SUP-PLIERS ARE ADVISED OF THE POSSIBILITY OF SUCH DAMAGE, ANDNOTWITHSTANDING THE FAILURE OF ESSENTIAL PURPOSE OF ANYLIMITED REMEDY.

9. General. This Agreement is governed and interpreted in accordance withthe laws of the State of Washington, U.S.A. without reference to conflicts oflaws principles and excluding the United Nations Convention on Contracts forthe Sale of Goods. The parties consent to the exclusive jurisdiction of, andvenue in, King County, Washington, U.S.A. Licensee shall not transfer, assignor delegate this Agreement or any rights or obligations hereunder, whethervoluntarily, by operation of law or otherwise, without the prior written consentof Impinj. Subject to the foregoing, the terms and conditions of this Agreementshall be binding upon and inure to the benefit of the parties to it and theirrespective heirs, successors, assigns and legal representatives. This Agreementconstitutes the entire agreement between Impinj and Licensee with respect tothe subject matter hereof, and merges all prior negotiations and drafts of theparties with regard thereto. No modification of or amendment to this Agreement,nor any waiver of any rights under this Agreement, by Impinj shall be effectiveunless in writing. If any of the provisions of this Agreement is held by a courtof competent jurisdiction to be invalid or unenforceable under any applicablestatute or rule of law, such provision shall, to that extent, be deemed omitted.

51

xarray tester user guide - sbrfid.comsbrfid.com/xarraytester_userguide.pdf · •...

Documents