RifidiWiki - User contributions [en]

Talk:Emulator User's Guide

2010-05-10T00:16:13Z

Romoore: Removed and posted to forums. Sorry for making the changes... --Rob Moore

Talk:Emulator User's Guide

2010-05-10T00:07:07Z

Romoore: /* Trouble running Emulator 1.6 in Ubuntu 9.10 */ Added extra info related to Emulator installer.

==Trouble running Emulator 1.6 in Ubuntu 9.10==
I just downloaded RifidiEmulator-1.6-linux-installer.bin and ran the installer from a bash prompt. Everything seemed to be going fine, though there were a few warnings as the installer started-up. After installation, I tried running the "emulator" binary, but it failed with the output below. Note that I am using Ubuntu 9.10 with all updates applied and Sun Java JDK SE 1.6u20. I also have "libequinox-osgi-java" installed, version 3.5.1+repack~1-0ubuntu3.

<pre>
romoore@host:~/rifidi/RifidiEmulator-1.6$ ls -lha
total 2.4M
drwxr-xr-x 6 romoore romoore 4.0K 2010-05-09 20:11 .
drwxr-xr-x 3 romoore romoore 4.0K 2010-05-09 19:40 ..
drwxr-xr-x 2 romoore romoore 4.0K 2010-05-09 19:40 about_files
-rw-r--r-- 1 romoore romoore 577 2009-11-09 19:04 about.html
drwxr-xr-x 7 romoore romoore 4.0K 2010-05-09 20:11 configuration
-rw-r--r-- 1 romoore romoore 121 2009-11-09 19:04 .eclipseproduct
-rwxr-xr-x 1 romoore romoore 52K 2009-11-09 19:04 emulator
-rw-r--r-- 1 romoore romoore 260K 2009-11-09 19:04 libcairo-swt.so
drwxr-xr-x 3 romoore romoore 4.0K 2010-05-09 19:40 plugins
-rw-r--r-- 1 romoore romoore 882 2009-11-09 19:27 Readme.txt
-rwx------ 1 romoore romoore 2.1M 2010-05-09 19:40 uninstall
-rw-r--r-- 1 romoore romoore 216 2010-05-09 19:40 Uninstall RifidiEmulator.desktop
drwxr-xr-x 3 romoore romoore 4.0K 2010-05-09 19:53 workspace
romoore@host:~/rifidi/RifidiEmulator-1.6$ java -version
java version "1.6.0_20"
Java(TM) SE Runtime Environment (build 1.6.0_20-b02)
Java HotSpot(TM) 64-Bit Server VM (build 16.3-b01, mixed mode)
romoore@host:~/rifidi/RifidiEmulator-1.6$ ./emulator
Registered org.rifidi.emulator.reader.alien
Registered org.rifidi.emulator.reader.awid
Registered org.rifidi.emulator.reader.epc
Registered org.rifidi.emulator.reader.llrp
Registered org.rifidi.emulator.reader.sirit local
Registered org.rifidi.emulator.reader.symbol
Registered org.rifidi.emulator.reader.thingmagic
Starting org.rifidi.ui.ide
ERROR [SpringOsgiExtenderThread-1] (DependencyWaiterApplicationContextExecutor.java:548) - Expecting state (resolving-dependencies) not (interrupted) for context
[OsgiBundleXmlApplicationContext(bundle=org.rifidi.emulator, config=osgibundle:/META-INF/spring/*.xml)]; assuming an interruption and bailing out
Stopping org.rifidi.ui.ide
Shutting down org.rifidi.emulator.reader.llrp
Shutting down org.rifidi.emulator.reader.alien
Shutting down org.rifidi.emulator.reader.awid
Shutting down org.rifidi.emulator.reader.epc
Shutting down org.rifidi.emulator.reader.sirit
Shutting down org.rifidi.emulator.reader.symbol
Shutting down org.rifidi.emulator.reader.thingmagic
romoore@host:~/rifidi/RifidiEmulator-1.6$ ls -la
total 2408
drwxr-xr-x 6 romoore romoore 4096 2010-05-09 20:12 .
drwxr-xr-x 3 romoore romoore 4096 2010-05-09 19:40 ..
drwxr-xr-x 2 romoore romoore 4096 2010-05-09 19:40 about_files
-rw-r--r-- 1 romoore romoore 577 2009-11-09 19:04 about.html
drwxr-xr-x 7 romoore romoore 4096 2010-05-09 20:12 configuration
-rw-r--r-- 1 romoore romoore 121 2009-11-09 19:04 .eclipseproduct
-rwxr-xr-x 1 romoore romoore 52932 2009-11-09 19:04 emulator
-rw-r--r-- 1 romoore romoore 287 2010-05-09 20:12 emulator.log
-rw-r--r-- 1 romoore romoore 266168 2009-11-09 19:04 libcairo-swt.so
drwxr-xr-x 3 romoore romoore 4096 2010-05-09 19:40 plugins
-rw-r--r-- 1 romoore romoore 882 2009-11-09 19:27 Readme.txt
-rwx------ 1 romoore romoore 2099309 2010-05-09 19:40 uninstall
-rw-r--r-- 1 romoore romoore 216 2010-05-09 19:40 Uninstall RifidiEmulator.desktop
drwxr-xr-x 3 romoore romoore 4096 2010-05-09 19:53 workspace
romoore@host:~/rifidi/RifidiEmulator-1.6$ cat emulator.log
20:12:03,600 (DependencyWaiterApplicationContextExecutor.java:548) - Expecting state (resolving-dependencies) not (interrupted) for context [OsgiBundleXmlApplicationContext(bundle=org.rifidi.emulator, config=osgibundle:/META-INF/spring/*.xml)]; assuming an interruption and bailing out
romoore@host:~/rifidi/RifidiEmulator-1.6$

</pre>

One last note, I experienced the following error message while running the installer "RifidiEmulator-1.6.-linux-installer.bin" on my machine. These appeared while the Rifidi logo was displayed, before the interactive installer appeared.
<pre>
romoore@host:~/Download$ ./RifidiEmulator-1.6-linux-installer.bin
/usr/lib/gio/modules/libgiogconf.so: wrong ELF class: ELFCLASS64
Failed to load module: /usr/lib/gio/modules/libgiogconf.so
/usr/lib/gio/modules/libgvfsdbus.so: wrong ELF class: ELFCLASS64
Failed to load module: /usr/lib/gio/modules/libgvfsdbus.so
/usr/lib/gio/modules/libgioremote-volume-monitor.so: wrong ELF class: ELFCLASS64
Failed to load module: /usr/lib/gio/modules/libgioremote-volume-monitor.so
</pre>

Talk:Emulator User's Guide

2010-05-10T00:02:46Z

Romoore: Added comments about problem launching emulator as per instructions on the page.

Emulator User's Guide

2010-05-09T23:47:27Z

Romoore: /* Launching Rifidi */ Added note about making binary executable for Linux installation. --Rob Moore (9 May, 2010)

[[category:userDoc]]

=Quick Start Video=
A quick start video is available at http://rifidi.org/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
**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.

# Download the latest version of Rifidi Emulator from http://sourceforge.net/projects/rifidi/
# 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:
**# 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).
**# 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=

# Once the program is loaded, the main GUI will be present.
[[Image:Quickstart-1-initial.png |none|thumb|800px|The Rifidi Emulator GUI]]
#To start the reader, click the 'add reader button'.
#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.[[Image:Quickstart-2-reader.png |none|thumb|400px|Select the kind of reader]]
#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. [[Image:Quickstart-3-createReader.png|none|thumb|400px|Supply the reader's IP and port]]
#Right click the reader and press start [[Image:Quickstart-4-startReader.png |none|thumb|800px|Rightclick on the reader to begin]]
#The reader may be stopped at any time right clicking and pushing stop.

=Adding and Removing Tags=

#First you will need to create the tags. There are two ways to do this:
##Manual entry may be done by entering tags into the provided text field and clicking add.
###Click on the add multiple tags button
###Follow the steps in the tag creation wizard [[Image:Quickstart-5-createTags.png |none|thumb|400px|Tag creation wizard]]
###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.
##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.
#Next Add the tags by dragging and dropping them onto a reader [[Image:Quickstart-6-tagsOnAntenna.png |none|thumb|800px|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.

<pre>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</pre>

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.org/rifidipackage/rif_out.html