Distance Time Altitude Speed Heart Rate

GPSpeedOMeter UserManual

screen shot

This application packs over 20 separate functions with a well laid out, customisable user interface. Designed for cycling it can also be used for walking, jogging, skiing, and any other sport where real time gps logging may be of use. All of the functions and calculations are explained in the paragraphs below.

The application is designed to package all the functions of existing cyclo computers and online logging websites into one application on your Blackberry Smartphone, although the application does also integrate seamlessly with ridewithgps.com, and will also output KML and GPX files to be used on other logging/tracking websites too.

You can download the application from MobiHand

last modified on January 26, 2011


This application requires that you have a blackberry Smartphone O/S 4.5 or later with a built in or external gps receiver. (Verizon do block gps applications on some of its older blackberries so please check with support before ordering this application if your carrier is verizon)

Please note that this application is constantly growing with new features and add-ons so your version may differ slightly from the manual below. If you have an older version you can update for free from the MobiHand store. If you feel you have a newer version please be patient as we update the manual. Feel free to email support for help that�s not covered in this manual.

Current Version of the application is 3.0.0

Screens & Functions

Main Screen

The Main screen is shown on the right of this paragraph. On launching the application this is the first screen that you will see. It is the real-time dashboard screen which is updated every second with new data. The screen consists of 2 panes. A speed pane showing the speed and an average speed indicator and a scrollable second pane showing all other values.

Here are the values displayed on the main screen and their meanings (how they are calculated are explained later in this manual).

1) Speed - Current speed in mph/kph.
2) Average speed Indicator - Arrow showing current speed to average speed comparison.
3) Dist - Distance travelled in miles or kilometres.
4) Time - Time taken since starting the trip minus stops.
5) Avg - Average speed (distance/time).
6) Max - Maximum speed recorded.
7) Ele - Elevation or Height above sea level (Ellipsoid corrected).
8) Grad - Average Gradient for the previous 30 seconds travelled.
9) TAsc - Total Ascent, Accumulated climbing.
10) TDsc - Total Descent, like TAsc.
11) MEle - Maximum Elevation recorded.
12) Cal - Calories burned.
13) Pace - Minute per Mile/Kilometre.
14) AvgP - Average pace.

Additional values
D +/- - Distance Ahead/Behind, used in race mode (Explained later)
T +/- - Time Ahead/Behind, used in race mode (Explained later)

Menu Items
1) View Map - This opens a live Mapping screen (Shortcut Volume Key to toggle between map and main screen)
2) View Graph - This opens up a graph screen showing Distance/Elevation so far.
3) View History - This opens up a history of previous trips saved
4) Reset Trip - Resets the current trip to Zero. If a trip has taken place and values have been recorded on the main screen it will give you options to save, save & sync, discard or cancel. These are explained below.
5) Settings - Opens the settings screen
6) Email Support - Opens an email with the To defaulted to GPSpeedOMeter support

Auto Start/Pause/Stop
On launching the application you will notice that all the values are set to null and the speed reading is set to Acquiring Satellite, also the let indicator will flash. This will remain the case until a GPS signal can be obtained. Please ensure that you are outside in an open area while using the application to ensure a gps signal is obtained. Once a signal is obtained all the values will be set to 0.

By default the app is set to start recording once a speed of above 1.5 meters per second is recorded and stop recording when a speed of 1 meter per second is recorded. These values are roughly 3.3mph and 2.5mph respectively. These values can be changed in the settings screen, explained below, which may be of use to walkers using the application.

Resetting a Trip
When you reset a trip in the application it will give you a list of options. You can save, save and sync, discard or cancel.

Save will save your trip to the phones internal memory, this can then be later viewed and synced online from the history screen (see blow for history screen details)

Save and sync will firstly do a save to your phones memory, but will also upload your trip to which ever online settings you have set up in your settings, (Twitter,RideWithGPS,Facebook (facebook is in your ridewithgps settings)). If no settings are present it will produce a login screen where you can enter your Twitter/RideWithGPS login information.

There are two different types of outputs to twitter depending on your settings.

1) Simply output your trips summary details, speed, distance, average speed etc
2) Output a link to your RideWithGPS synced data.

Discard will reset all the trip values to zero and will not save or sync any data; therefore all data in the current trip will be lost.

Cancel cancels the current selection and returns you to the main screen with no values changed and no data saved or synced.

Tips & Tricks
1) The application is designed to replace existing cyclo computers so to get the full benefit of the application its best to mount it to the handle bars of your bike. I will link to some DIY blogs that show how to do this or you can go out and buy handle bar mounts for blackberries but I have found the DIY method to be easier.
2) The second pane on the screen is scrollable so scroll to see more values if less than 6 rows are visible.
3) The volume key will toggle between the Main screen and the Map screen.
4) By default the application leaves the backlight always on. If you are not mounting the blackberry to the handlebars its probably best to change this in the settings (explained later).
5) If the font is too small on some of the secondary values change the settings to show less rows on the main screen, this will increase the font size automatically.

Map Screen

The Map screen requires that you have BBMaps installed in order to function. If its not installed the map screen will not be displayed. The map screen contains two panes one small one on top, which shows current speed, distance, and time taken. The other pane shows a map with your current position cantered and marked by a yellow dot. It also shows a route marker showing where you have travelled so far on the current trip. The green dot represents your starting point.
When in race mode the map will also show a red dot and an orange line indicating the course ahead and your position at the current time taken for the previous trip. This is all explained in a later paragraph.

Navigation & zooming
Navigation and zooming of the map screen can be done in a number of ways depending on which you prefer and which device you are using.
1) From within the Map screen if you click the menu key there are several panning and zooming options.
2) If you click the navigation button (track pad or track wheel) you will notice a mode indicator on the top left of the map screen appearing. Modes include Zoom Mode and Pan Mode. While in either mode move the navigation key to change your zoom or panning.
3) If using a touch screen device you can simply tap the screen to switch modes then swipe north/south to zoom and simply hold and move your finger along the screen to pan (map will pan to where ever you lift your finger from the screen).

Graph Screen / History Detail Screen

graphThe graph screen can be used anytime during a trip, and also becomes the history detail screen after a trip has been saved. This screen contains a graphical view of the elevation over distance of the trip and also a summary of the trip's recorded data such as distance, time, average speed etc.

The graph shows the distance on the x-axis and the elevation on the y-axis. These are either in miles/kilometres and Meters/Feet depending on your settings.

Depending on the distance travelled the increment in distance will be 2, 5 or 10 miles/kilometres. The elevation will depend on font size, screen height and your maximum-recorded elevation.

The graph is also scrollable so if you do more than about 25 miles you will have to scroll across using the track pad or swipe screen if on a touch screen, to see the remainder of the trip.

The pane containing all the other data is also scrollable for users with devices, which may not be able, hold all the data on one screen.

Menu Items
1) Show On Map - Clicking this will bring you to the map screen showing the route travelled. If you are in a live trip it will also show your speed/distance/time on the top but if in history mode it will just show the map and route taken in full screen mode.

History List Screen

historyThe history screen shows all your saved trips, Routes are created automatically.

Routes are the first thing shown on the screen, in a drop down menu. The name of a route is defaulted to the date the first trip of that route was taken. This can be changed from the menu. Routes are groups of trips, which follow the same course. The starting point and end point of a trip must be within 200 meters to be in the same route.

Trips are shown in a double line Selectable list. The first line shows the date/time the trip was taken. The second line shows the distance/time taken/average speed of the trip.
Highlighting and clicking a trip will bring you to the Graph/History detail screen explained above.

If you choose a route from the route drop down, you will notice that the history list will only contain trips for that route. It will also place a green tick indicator on the fastest trip for the route. The fastest trip is not always the trip with the fastest time, as trips can start and finish up to 200 meters apart, so the fastest trip is always the trip with the fastest average speed.

Menu Items
1)sendto send to, shown on the screen shot to the right. Allow you to send trips data to a number of places.
    - SDCard - if an sdcard is present it will place a GPX file in the folder \SDCard\BBSpeedOMeter\GPX and will place a KML file in \SDCard\BBSpeedOMeter\KML
    - Email - will open an email with a summary of the trips details and attach both a kml and gpx file to the email. It will also print a link to the RideWithGPS trip if the data has been synced to RideWithGPS already.
       - Sync Online- will do the same as the sync from the reset menu item on the main dashboard screen. sync to ridewithgps.com and or twitter depending on your settings.
   - Cancel - cancels the current selection returning to the history list screen

2) View Stats - This will bring up a small screen showing overall Distance, Time and Average Speed. If the route selected is show all it will show overall values for all routes, if a route is selected it will show overall data for just that route.

3) View Route - While route is in show all mode, Highlight a trip, click show route from the menu and it will filter the trips by the highlighted trips route.

4) Rename Route - This will allow you to rename the currently selected route. Note: Show all cannot be renamed.

5) Race against Trip - Clicking this option will allow you to race against the selected trip. It will return you to the main screen with the two additional values added (see main screen description). You must start within 200 meters of the saved trip. Your progress against the saved trip will be shown on the 2 additional values and also visually on the map.

6) Backup/Restore - Allows you to backup or restore data to and from the SDCard. This will get the trip data saved and back them up in .dat files on the SDCard in the folder SDCard\BBSpeedOMeter\Data. This is useful to do if you update your phones OS allot or if you want to uninstall GPSpeedOMeter and reinstall it again for whatever reason. It can also be used to import data onto another device. From the settings you can choose to auto backup each time a trip is saved.

7) Delete Entry - This will delete a trip from the current history list screen. It will not delete the trips from your backup folder if you have backed up the trip.

8) Delete All History - similar to above but it will delete all history, and routes.

9) Restart Trip - this allows you to restart a saved trip, i.e. if you cycle 20 miles then stop for an hour for lunch. You can turn the app off and save the trip. Then after lunch you can restart the same trip. Note, works best if you start from more or less the exact place you stopped the first segment of the trip.

Settings Screen
There are a number of settings within the application to help you customise it to work, as you want it. From the menu within the setting screen you can reset to default or save changes you make.

Units Of Measure
These values allow you to change between miles/kilometres and feet/meters for distance and altitude. This setting will affect all data current and saved.

This setting allows you to auto backup data to the sdcard on saving a trip. Useful in case data gets wiped from your phone somehow or if you want to transfer trips from one blackberry to another.

Main Screen
Number of rows Visible - this allows you to set how many secondary rows you want visible on the main screen. Use this to increase font size if your blackberry has a small screen.
The following drop downs allow you to set the position of the values on the main screen, e.g. joggers might prefer to have pace/average pace on top while cyclists probably prefer Distance/Time to be on top.

Auto Start/Stop
These values are in Meters per second, and are used to start and stop the application recording on a current trip. These values can be lowered from the defaults for people using the application while walking.

Font style and size are used to change the font within the application, although Font size on the main screen is determined as the max font size available so setting the size only sets font size for other values within the application.
Carbon Background - For devices os 4.7 and later there is the option to add a carbon background, this will change from the black/grey-rounded look to a carbon look and feel to the main screen.

Twitter Login
Add your twitter login details here to post trip data to twitter. Click the signup button to launch a browser to the twitter signup page.

RideWithGPS Login
Similar to Twitter, as above.
Add To Tweet - select this if you want your twitter post to show a link to the RideWithGPS trip details.

Back Light Always On - selecting this will ensure that the backlight is always on in the application. Useful if you mount your blackberry to your handlebars. If not, it�s probably best to unselect this to save on battery life.

Altitude & Climbing
Invert Negative Altitude - This is a fix for a known blackberry issue on some older devices where altitude is correct but it is shown as a minus value.
Count elevation change > - By default TAsc in the main screen only counts hills greater than 30 meters in elevation change, set this value to whatever you want your smallest climb to be.

Memory Management
-GPS Sampling Interval - This sets the interval in seconds between GPS readings. the default is 1 second, set this higher if you want to save on battery. Warning: it does affect accuracy so try out some different options and stick with what works best for you.
-Save every Recording - this sets the save interval. i.e if you set this to 5th then every 5th recorded gps location gets saved on reset. Use this to save on memory. Warning if the interval is set too high the outputed KML/GPX may may be affected(not follow roads). 
Calculations & Technical Info

Below is a list of values and how they are calculated in the application (Obviously I am not going to give away every secret, just enough for you to understand how the application is working)

Speed - The GPS Receiver in your blackberry is polled every second for a new location object, this contains your speed in meters per second, the application simply gets this value and converts it to mph/kph depending on your settings

Dist - Distance is calculated as distance = distance + distance last point

Avg - Average Speed is just Distance divided by Time

Ele - Elevation is received from the GPS receiver which uses WSG84 (this value can be incorrect up to 90 meters), The app contains a lookup table which corrects this value to 1 meter, Most other apps will only show you the WSG84 value which is wrong. Note: this depends on your gps accuracy also.

Grad - This shows the average gradient for the previous 30 seconds travelled. The average is calculated for 6 overlapping periods within the 30 seconds for extra accuracy. 

TAsc - This is the total accumulated climbing meters/feet within the trip. By default a climb must have an elevation gain of more than 30 meters to start the counter and maintain a gradient of 1% for each mile there after to continue to add to the total. After the first 30 meters the count gets updated every 5 meters. It doesn�t update for every 1 meter as this proves to be less accurate. The counter stops and you need to gain another 30 meters in elevation to start again if you drop below 15 meters from the peak elevation climbed

TDsc - This works exactly the same as TAsc just in reverse

Cal - Without heart rate calories becomes an estimate more than an accurate value. The app does use some complicated logic though to try to make the estimate more accurate. It works off the basis that you burn 500 calories per hour exercising, and then it accounts for things like average speed and meters climbed to add or subtract from that 500 calories. It also uses your previous history saved to gauge at what percent you are training, i.e. if you averaged 20mph yesterday but are averaging 15mph today on the same course you are probably taking it easy so the application takes away a little of the calories burned for that hour.

Pace - This is just calculated in the same way as speed

Here are a couple of other things about the application which may be of interest

Battery Life
This application has been designed to save as much battery as possible but still work effectively. The screens are deliberately dark with bright Text as this reduces battery consumption. A general tip for battery life is to go to your phone settings and set your backlight brightness to something between 0 and 30% whatever works best for you. In extremely bright weather you might need to set it a little higher.

Testing on this application has shown that with 100% battery you can expect to get


  Torch 9800 Bold 9700
BackLight on, Brightness 20% 9 hours 14 hours
BackLight on, Brightness 70% 7 hours 10 hours
BackLight Off 20+ Hours 20+ Hours 

Note: these numbers probably will vary greatly between different phones, the phones that were used for these tests were less than 1 year old so the batteries were still good.

This application does use a couple of different areas on your phone to store data, i.e. the phones internal persistent store and the SDCard.

Trips are stored as Java objects in the persistent store and really do not take up much space at all. The application records every second to get accurate readings for speed, distance etc, but for mapping only 1 record every 5 seconds needs to be stored, resulting in a smaller memory footprint. A whole years training can fit in a couple of MB. This default value can be set in the settings screen if you want to save even more momory.

The SDCard is used mostly for backing up data if you choose to, and for storing KML/GPX files of your trips if you email/upload them. You can delete these whenever you want and it won�t effect the running of the application. Note the files in the folder SDCard\BBSpeedOMeter\Data contain your backup files, deleting these means they won�t be backed up if you lose your data.