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
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.
D +/- - Distance Ahead/Behind, used in race mode (Explained later)
T +/- - Time Ahead/Behind, used in race mode (Explained later)
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
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
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
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
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
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.
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
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
The 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
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.
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
History List Screen
The 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
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
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.
1) 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
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.
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.
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.
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.
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.
Similar to Twitter, as above.
Add To Tweet - select this if you want your twitter post to show a link to the RideWithGPS
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.
-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
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
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
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
BackLight on, Brightness 20%
BackLight on, Brightness 70%
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
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.