Emulator User's Guide

From RifidiWiki

Jump to: navigation, search


Quick Start Video

A quick start video is available at http://rifidi.net/www/videos/emulator/emulator.swf

Requirements

  • Microsoft Windows 2000/XP/2003 or Linux (Ubuntu, Red Hat, SuSe)
  • Java
    • For Emulator 1.5.1 and above: Sun Java Runtime Environment 1.6 update 4 or higher Note: Not yet supported on Java 1.8 on product backlog
    • For Emulator 1.5 and below: Sun Java Runtime Environment 1.5

Installation

Emulator is completely written in Java so installation is very easy. Additionally, Emulator is packaged in a standard installer.

  1. Download the latest version of Rifidi Emulator from http://sourceforge.net/projects/rifidi/
  2. Double click to run the install. Follow the on screen instructions.

Launching Rifidi

  • 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.
    • Note: If the application binary does not have the correct permissions after installation (not marked executable), you can use one of the following steps to correct this:
      1. From a terminal:
        • Change to the application directory (e.g., "cd /home/user/rifidi/RifidiEmulator1.6/")
        • Add executable permissions to the application file: "chmod +x emulator" (without the quotes).
      2. Within the Ubuntu File Manager (nautilus):
        • Navigate to the application directory (e.g., /home/user/rifidi/RifidiEmulator1.6/)
        • Right-click on the "emulator" application, and select "Properties" from the context menu.
        • Click on the "Permissions" tab at the top and mark the checkbox "Allow executing file as program", then click "Close."

Starting a Virtual Reader

  1. Once the program is loaded, the main GUI will be present.
The Rifidi Emulator GUI
  1. To start the reader, click the 'add reader button'.
  2. Select the reader type to be emulated and pick the address to start the reader on. For the purposes of this quickstart guide, start an Alien Reader.
    Select the kind of reader
  3. Select the Reader's IP and port address. 127.0.0.1:1000, will use the loopback address of the current system and start listening on port 30000.
    Supply the reader's IP and port
  4. Right click the reader and press start
    Rightclick on the reader to begin
  5. The reader may be stopped at any time right clicking and pushing stop.

Adding and Removing Tags

  1. First you will need to create the tags. There are two ways to do this:
    1. Manual entry may be done by entering tags into the provided text field and clicking add.
      1. Click on the add multiple tags button
      2. Follow the steps in the tag creation wizard
        Tag creation wizard
      3. Removal may also be done in the similar manner by clicking remove tag after either selecting tags from the list or manually entering the tag.
    2. Tags may also be added from an XML file. A few example tag files are included with the program installation. Loading tag files are not additive, however, and will replace any data already present in the reader.
  2. Next Add the tags by dragging and dropping them onto a reader
    Tags on an Antenna

Viewing Results

To view the results of adding tags on the fly, one may either have a supporting tool open, such as the Alien RFID Gateway, or simply use telnet to perform command interaction with the reader. To telnet into the reader, simply connect to the address given to the reader when it was started. Once connected, the following commands may be useful.

get TagList - Displays the tags currently detected by the reader.
get $PROPERTY - Returns the value for the passed property.
set $PROPERTY=$VALUE - Sets the passed property to the passed value.
q - Close the connection

If you would like to see how to write a client tool connect to the reader, see our Alien Example Client

Quickstart Video

A video of these installation steps can be seen here: http://www.rifidi.net/www/rifidipackage/rif_out.html

Personal tools