Skip to content

Latest commit

 

History

History
167 lines (144 loc) · 6 KB

README.md

File metadata and controls

167 lines (144 loc) · 6 KB
**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