**Permissions**
This file is part of the Southend "Curbside Diaries" project.
"Curbside Diaries" is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, version 3 (and later) of the License.

"Curbside Diaries" is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with "Curbside Diaries".  If not, see <http://www.gnu.org/licenses/>.

This code has been written by:
Tom Keene: www.theanthillsocial.co.uk | tom[at]theanthillsocial.co.uk
and
Gareth Foote: www.garethfoote.co.uk | gareth [at] garethfoote.co.uk

For a project produced by:
YoHa: www.yoha.co.uk
Open Systems Association: www.opensystem.org.uk

KERBSIDE DIARIES

This project provides a collection of scripts and build instructions for an android phone device that transmits GPS, GSR and other sensor data to a central server. The scripts and devices used include:

• Phonegap android application with custom java modules.
• IOIO device with attached light and GSR sensors.
• PHP code to recieve posted data tracks (see below).
• Rudimentary track management interface.
• Map to display tracks using Leaflet Javascript library.

Using the device

On the android phone check:

• Debugging mode is on.
• The phone has a data connection.

When the 'southend transport' application is started up:

• Check that the yellow led on the IOIO device is flashing as this tells you the phone is in commminication with it.
• If the yellow led isn't flashing then replug the usb cable.
• Write a track description (click on the field and a popup text box will appear).
• Click start.

To stop the application:

• Click the left hand menu touch-pad area on the phone.
• Click 'Stop Activity'.
• Click 'Exit application'

Sometimes the application doesn't exit cleanly so if weirdness is occuring:

• Select 'Task manager'.
• Exit all applications.
• Clear ram.
• Then swipe down from the top of the screen & make sure the IOIO service is not running.

UPLOAD

• Upload images to the correct directory
• Use this script to resize: mogrify -resize 200x150 *.jpg

Data Structure

{
	"track" : {
        "title": "A track name",
        "tag": "Describe this track"
        "author": "Your Name", 
        "starttime": "000",
        "endtime": "000",
        "imagerotate":0,
        "device" : {
        	"name": "???",   
            "cordova": "???",
            "platform": "???",
            "version": "???",
            "uuid": "???"
        },
        "points" : {
              "elapsed" 		: [ [1],[6],[11],[16] ],
              "gps" 		: [ [lat,lng],[lat,lng],[lat,lng],[lat,lng] ],
              "gps_accuracy"	: [100, 10, 20, 30],
              "gps_timestamp"	: [125757,454545,45454545,4545455]
              "image" 		: ["name2.jpg",0,0,"name2.jpg"],
              "accelerometer" 	: [ [x,y,z], [x,y,z], 0, [x-y-z] ],
              "shakeevent" 		: [0,1,0,0]
              "IOIOlight"   	: [0.0, 0.5555, 0.777, 1.0],
              "IOIOlightevent"   	: [0,1,0,1],
              "IOIOgsr"   		: [0.0, 0.5555, 0.777, 1.0],
              "IOIOgsrevent"   	: [0,1,0,1] 
        }
}
}               

Folder Structure

New tracks with associate files can be directly added to the folder structure. When a new track is uploaded to the server the following folder structure is generated which the leaflet.js scripts generates visualisations from:

tracks
	device.uuid
		yyyy-mm-dd_h-m-s
			data.json
			timestamp.jpg
			timestamp2.jpg
		2013-2-21_23-26-2
		    	data.json
			timestamp1.jpg
			timestamp2.jpg
			timestamp3.jpg
		2013-2-21_23-26-5
		    	data.json
			timestamp1.jpg
	device.uuid
		2013-2-21_23-26-5
			data.json
		2013-2-21_23-26-34
		        data.json
			timestamp1.jpg

Integration of ioio board

The IOIO exmaples have been tested with

• Android phone: The Samsung Gallaxy GT-19000
• Android version: Android 2.3.6
• IOIO hardware: SPRK0020
• IOIO bootloader: IOIO0400
• IOIO Firmware: IOIO0330
• Connection: Socket(ADB)

With the configeration above, the IOIO hello world example worked with the IOIO 0330 libraries.

Parts list

• Android phone: Samsung Gallaxy GT-19000
• IOIO-OTG board
• 2x 8 way screw fit headers 2.45mm
• 3x 3 way screw fit headers 2.45mm
• 1x 2 way screw fit headers 2.45mm
• 1x 8 gange choc box screw connectors
• 3x led's (red, green, yellow)
• 2x 10k resitors (for light sensor & Galvanic Skin Response)
• 1x 0.1uf Capacitor (for GSR sensor)
• 1x light depeneded resistor (for light sensor)
• Peforated protyping board 2.45mm
• battery

Power
We have used 7.5v 1300mah li-Po batteries. The Amps drawn by the IOIO board with 3 leds and a small speaker attached the phone reached a maximum of 0.28 Amps so this battery should last around three hours or so. We use the following calculations to work this out:

• (BatteryMilliAmpHours/1000)/deviceAmp = Hours device will be powered.
• Our battery provides 1300 MilliAmps for one hour (1300mah).
• Or 1.3 Amps for one hour (1300mah/1000=1.3Ah).
• So 1.3A/0.28A = 4.6 hours this battery will last (though in real life, it probably wont be this long)

Usefull links
IOIO downloads: https://github.com/ytai/ioio/wiki/Downloads
IOIO Hardware tester: https://play.google.com/store/apps/details?id=ioio.example.ioiohardwaretester&hl=en
Trouble shooting eclipse: https://github.com/ytai/ioio/wiki/Eclipse-Troubleshooting
Local messaging in an android app: http://www.intertech.com/Blog/Post/Using-LocalBroadcastManager-in-Service-to-Activity-Communications.as