---------------------Door Unlocking Application----------------------



*The installation information is towards the bottom of this document.

Please read the descriptions first in order to understand what the

program does and to make installation easier.



Purpose - 

	This application was developed as a demo for the Discover, Interaction,

	and Payment Protocol (DIPP) [http://paul.rutgers.edu/~nravi/spsm03.pdf]

	technology developed at DiscoLab [http://disco-lab.rutgers.edu], 

	Rutgers University [www.rutgers.edu].



Quick Description -

	Allows a user with a smartphone that has bluetooth, java midp, and

	internet connectivity to unlock his doors from his smartphone; essentially 

	replacing his keychain.



How it Works -

	The system operates on three components: a central control server, 

	local bluetooth server for each door, and the users' smartphones.

	Each smartphone holds a personal profile that the user fills in.

	The values can be set by the admin of the system.  For example, 

	the values may be the person's name, social security number, and 

	credit card number.  These are used to verify that the person is who

	he says he is.  When he wants to open a particular door, the phone

	scans the area to find the local doors.  The user then selects the door

	he'd like to open.  The phone contacts the door which returns its name 

	and central control server's address.  Over GPRS, the phone sends its 

	profile and, if his profile is in the server's database, he's given a key.

	The phone then contacts the local door server with his key which forwards 

	the key to the central server, which then opens the door.



	Our implementation uses a servlet as the central control server and

	java midp smartphones for both the door server and users' phones.



Installation-

	I apologize beforehand.  This is a very early version of the application,

	so there will be bugs.	Sorry.



	System we KNOW it works on-

		-Windows 2003 (any version of windows would probably be fine)

		-Sony Ericsson P900 smart phone

		-Belkin USB Bluetooth Dongle

		-Serial port



		Software-

			to run-

				-PC Connectivity Suite (comes with Sony Ericsson P900)

				-Java JRE (get the SDK if you plan to compile)

				-Apache Tomcat (any servlet container will work)

				-Java Comm API

			to compile-

				-Java SDK

				-J2EE

				-Java Comm API

				-J2ME Wireless toolkit

				-Sony Ericsson P900 J2ME SDK 

				(available from Sony Ericsson's developer website)	

		Hardware-

			- 2 Sony Ericsson P900s 

			- Serial Port



	From source-

		1. Compile the Serial Port Server.

			-Go into the SerialPortServer/src directory

			-Compile DoorOpenThread.java then SerialServer.java



		2. Compile the Phone Client and Phone Server 

			-Copy the PhoneClient/DoorOpen and PhoneServer/DoorServer folders 

				into the apps folder of the J2ME wireless toolkit

			-open the 'DoorOpen' project in the toolkit

			-in the toolkit, click on Projects - Package - Create Package

			-now repeat the process with the DoorServer project.



		3. Compile the Servlet.

			-go into the servlet/src directory and type 'make' in the command prompt

		       OR, execute:

				javac -d ../bin/ ConfigFileException.java

				javac -d ../bin/ StatusCodes.java

				javac -d ../bin/ Event.java

				javac -d ../bin/ Profile.java

				javac -d ../bin/ DoorLog.java

				javac -d ../bin/ Door.java

		

		4. Continue with the "From binary" instructions.

	

	From binary-

		

		1.  Set up all the Servlet binary files in a servlet container

			(eg. Apache Tomcat) and start the servlet container.

			-Set up the doorConfig.txt file according the examples given 

				in the file.  In Apache Tomcat, the doorConfig.txt file needs

				to be in the 'Tomcat 5.0/' directory.

			-Door.class is the class that's executed.

			-To see if the servlet's running, go to the servlet's address

				in an internet browser, and you should see the Door entry log

				page.  From here you can also see the record of when the

				door was opened and by whom.



		2.  Start the Serial Port Server.

			- In the SerialPortServer/bin directory type 'java SerialServer'



		3.  Install the .jar files in the /PhoneClient/DoorOpen and PhoneServer/DoorServer

			directories to seperate phones.



		4.  Get a GPRS plan OR follow steps 5-8.



		5.  Pair your phones and PC.



		6.  Right click on the PC connectivity suite icon in the bottom right hand

			corner of your screen (it looks like the line on a heart monitor),

			and click on properties.



		7.  In properties, select Bluetooth, and deselect any other boxes.



		8.  Open bluetooth serial port connections with the phones.

			-Right click on the bluetooth icon in the lower right hand corner

				of your screen.

			-Quick connect - Bluetooth Serial Port - Phone's name

			-Accept the connection on the phone and PC.



		9.  Start the DoorServer application on one of the phones.



		10.  Enter Servlet's URL when the application asks for it.

			-Be careful!  This will be the source of many problems.

				If you have any connection problems, check the URL first.



		11.  Start the Server.



		12.  Start the DoorOpen application on the other phone.



		13.  Fill out the profile according to the way you set up the servlet's config file.



		14.  Click on 'open door.'



		12.  Follow the on-screen instructions.