MobileSense Installation and Execution
--------------------------------------

This document explains how to compile and run the MobileSense system. 

MobileSense is composed of a client-side J2ME program (MobileSense MIDlet) and a J2SE server program (MobileSenseServer). Client and server side communicate through a Bluetooth channel.

In the server-side we make use of Blue Cove: "an open source implementation of the JSR-82 Bluetooth API for Java, which supports the Windows XP SP2 Bluetooth stack" (http://sourceforge.net/projects/bluecove/). In fact, we have used the patched version of this library available from Benhui.net (http://www.benhui.net/modules.php?name=Bluetooth&page=Connect_PC_Phone_Part_1.html).

Our Bluetooth communication code is based on the sample SPP (Serial Port Protocol) example developed by Ben Hui and available at http://www.benhui.net/modules.php?name=Downloads&d_op=getit&lid=9. 


Acknowledgments
---------------

The following open source tools are used by MobileSense:
1) GOCR, open source OCR system: http://jocr.sourceforge.net/
2) FreeTTS, open source TTS system: http://freetts.sourceforge.net/docs/index.php
3) ImageMagick open source image processing tools (convert.exe): http://www.imagemagick.org/ 
4) The TRIP barcode recognition system: http://paginaspersonales.deusto.es/dipina/tripweb/


System Requirements
-------------------

1) Windows XP Service Pack 2
2) Java SDK 1.4 or higher available from: http://java.sun.com/j2se
3) A MIDP 2.0 phone with the optinal Bluetooth package, such as the Nokia 6660.
4) A USB Bluetooth dongle such as the DBT 120 from D-Link.


How to compile MobileSenseServer
--------------------------------

0) Extract MobileSenseServer.zip into a directory. 
1) cd <dir-where-you-extracted-MobileSenseServer>
2) compile.bat


HOW TO GENERATE TRIP TAGS
-------------------------

1) cd tagGenerator
2) python generateTarget.py <num-code> -r <size-radius-tag> -l <label>, e.g. python generateTarget.py 239808 -r 10 -l "Diego Ipina"

As a result of the above command the file: TRIP239808L.ps will be generated
You have tags with TRIP ringcodes in the directory: TRIPtags


How to create the database for MobileEye
----------------------------------------
1) Install MySQL to store the data for MobileEye objects, download it from: http://dev.mysql.com/get/Downloads/MySQL-4.1/mysql-4.1.8-essential-win.msi/from/pick#mirrors
2) Execute the script to create the mobileeye database:
<dir-where-you-intalled-mysql>\bin\mysql -u < sql\create_db_and_users_mobileeye.sql


How to execute MobileSenseServer
--------------------------------
1) cd <dir-where-you-extracted-MobileSenseServer>
2) run.bat
3) Insert '0' and press return (insert '1' if you want to exit the server)
4) Start up the MobileSense MIDlet


How to compile the MobileSense MIDlet
-------------------------------------
1) Open the KToolbar utility available within the J2ME Wireless Tookilt 2.2. Download this tool from http://java.sun.com/j2me/
2) Click on New Project, name it 'MobileSense' and choose as midlet class 'es.deusto.ctme.mobilesense.CameraMIDlet'
3) Close the KToolbar, and extract MobileSenseMIDlet.zip into <dir-where-wireless-toolkit-2.2-is>\apps\MobileSense
4) Open KToolbar again and click on Build
5) Click on Project\Package\Create Package
6) Transfer the file <dir-where-wireless-toolkit-2.2-is>\apps\MobileSense\bin\MobileSense.jar to your phone
7) Execute the MIDlet


How to run the MobileSense MIDlet
---------------------------------
1) Install the MobileSense MIDlet in the phone: transfer the file MobileSense.jar through Bluetooh or Infrared
2) Start up the MIDlet
3) Wait till a device, your PC with a Bluetooth dongle is found (around 10 seconds)
4) Select the device found
5) Start capturing images and issuing processing commands.


LICENSE
-------

This code is licensed under GPL. (See http://www.gnu.org/copyleft/gpl.html)
Copyright Diego López de Ipiña González de Artaza (http://paginaspersonales.deusto.es/dipina)