TourGuide instructions.
------------------------------
by Bogdan Blaszczak, May 2004.


The TourGuide program was developed on Windows XP.
You may notice that in file formats and naming conventions.
I used the following directories:
- my development was in C:\ddj\TourGuide
- NRG SDK was installed in C:\ddj\nrgsdk

I did not try to compile or run on Unix.
However, I would not expect any major difficulties beyond some script tweaks.

TourGuide requires Java 1.4 because of javax.imageio package used.
However, NRG simulator needs Java 1.3.
You will need both on your system.
On Windows, the install for NRG will offer Java 1.3 installation. Take it.


1. Installation.
----------------
Decide on a directory structure that will accommodate TourGuide and NRG SDK.
You are welcome to use mine.

Download NRG software from:
http://www.ericsson.com/mobilityworld/sub/open/technologies/parlay/index.html
You will need both the NRG simulator and the NRG SDK files.

The location of the NRG simulator installation is not essential
(use the default offered by the installation program, at least on Windows).

Unzip TourGuide to its location.

Install NRG SDK.

Then modify env.bat to reflect the directory structure.
This batch file (script) sets up the environment for build.xml.

See C:\ddj\TourGuide\doc\index.html for source docs (JavaDoc).


2. Compile & Run.
-----------------
run.bat invokes ant with build.xml.
That should compile and run TourGuide.

run-log.bat also captures the console output to the ant.log file.


3. Test.
--------
You will need to run the NRG simulator to test TourGuide.
Otherwise the NRG access will fail with a 
'fatal error' message (and a stack dump).

To send SMS to TourGuide you will need to create a 'virtual phone' in 
the simulator. You can do it by clicking in the phone icon or by going to 
the 'Edit.Add phone' menu option.

The 'Edit.Show map' menu option will show a map and allow you to 
set the phone location.
To see the same map that TourGuide uses, point to 
C:\ddj\TourGuide\maps\DallasMapSmall.gif in 'Edit.Options.Location.Map image'.

The latitude and longitude parameters should be set to 0, 1.0, 0, 1.0 (this
is the default).
