Introduction

Rifidi Tag Streamer is a load testing utility. It is primarily used to simulate large sets of tags and readers.

Requirements

• Microsoft Windows 2000/XP/2003 or Linux (Ubuntu, Red Hat, SuSe)
• Sun Java Runtime Environment 1.5 (J2SE 5.0)

Installation

Rifidi Streamer is available as a Installer package and in it's sources. You can pick the choice you want. The Installers representing the stable versions. The source code is under heavy development so it might happen that changes break functionality or that the product is not working at all.

• You can download the latest installer version of Rifidi Streamer from http://sourceforge.net/projects/rifidi/
• You can get the sources from http://rifidi.googlecode.com/svn

After you downloaded the installer double click to run the install. Then follow instructions on screen.

Launching Rifidi Streamer

• Windows Users: Simply click the shortcut located in the Rifidi folder in the Start Menu/Programs folder.
• Linux Users: Double click the executable file located in the installation directory.

Getting Started

This is a short tutorial to get started with the Rifidi Streamer Application. The tree important parts in the Rifidi Streamer are:

• Readers
• Batches
• Segments

Add a Reader

You will need to add a reader to simulate the underlying architecture. Currently we support the following reader types:

• LLRP Reader
• Symbol XR400
• Alien ALR 9800
• EPC Reader Protocol V1.1
• Awid MPR

For adding a reader to the Rifidi Streamer you right click on the ReaderView and the popup menu for creating a new reader will show up.

After that a new Wizard will lead you through the reader creation process. There you will be asked about the required attributes the reader should have. The Wizard will ask you for the type, name and some reader specific values of the reader model you picked.

Select the readertype

enter the name of the reader and select the attributes

GPIO Settings (optional)

Add a Batch

The Batches representing a collection of RFID Tags. To create a batch right click on the BatchView or click the create batch icon () in the right corner of the BatchView.

After that the Batch Wizard for creating new a Batch will be started.

enter a name for the batch	add multiple tags to the batch
select the type of tags you want to generate	finish screen all tags a generated

Add a Segment

The Segments describing the events occuring during the simulation. A Segment consists of:

• Duration Time
• Tag appear events
• Tag remove events
• GPI events

To create a new segment click "create new segment"-button () in the right corner of the SegmentView.

create a new segment

set the attributes and create the events for the segment

Duration Time

The duration time is the time the segment will execute. If you start the simulation in infinite mode it will redo the scheduled events after this period of time. You can select a min and a max value, if you do so, the application will take a random number between these two values and execute. Every time the segment will be executed another time is calculated.

Tag appear Event

The "Tag Appear" event is basically adding a batch to an antenna of a reader. Every time the segment is executed these batch (RFID Tag Collection) will be added to the specified antenna.

Tag remove Event

The "Tag Remove" event removes previously added tags form a reader. This is executed every time the segment runs. It's not good to remove and add tags in the same segment. It might make sense to create to segments. The first segment is adding tags to the antenna of a specific reader and the second segment remove these tags later on.

GPI Event

The GPI Event sets an input port of the reader to a certain level. There a two levels available:

• High (gpi port input signal is set)
• Low (gpi port input signal is not set)

How it works

General

After you have specified a Reader, Batches and Segments you can run the simulation tool. The application will execute every segment you defined and add tags, remove tags or set GPI events.

UI

XML

Start Simulation

You have two possibilities to run the Rifidi Streamer

• run it once
• run it infinite

You can see the buttons for both options in the toolbar under the filemenu. Press the "run once" button to run all segments once or press "run infinite" button to run the segments until the "stop" button is pressed.

Pause/Stop Simulation

When the application is running the buttons for stopping and pausing the current execution will become enabled. If you want to pause the simulation press the "pause" button. If you want to stop the simulation and loose all the current data press the "stop" button.

Reset Simulation

Currently we do not support a reset of the Simulation. We apologize for the inconvenience. That feature will be added in the future.

Turn On All Readers

There is a button in the reader view which will switch all readers on.

Turn Off All Readers

There is a button "turn off all readers" in the toolbar of the so called ReaderView to turn off all readers at once.

Details

Readers

Batches

Segments