BlackBerry App World Release Notes

This page gives some notes and further information specific to the BlackBerry version of TMJ-Mobile, available for download from this site and also from the BlackBerry App World storefront.

BlackBerry App World Version Info

Version v0.8.2 (13 Feb 2013)

Changes as for v0.8.1 with minor additions for BlackBerry release.

Version v0.8.0 (23 Nov 2011)

Changes as noted here. Please note that phones running BlackBerry OS 7 (eg Torch 9810, Bold 9900 etc)) may need the Menu/GPS/GPS Options/Force 1 Sec Refresh option ticked.

Version v0.7.9 (27 Jan 2011)

Interim release due to changes to the webserver.

Version v0.7.8 (4 Jan 2011)

Changes as for v0.7.7.

Version v0.7.6 (29 Sep 2010)

Changes as for v0.7.5.

Version v0.7.4 (15 Feb 2010)

Changes as for v0.7.3 with minor additional changes to BlackBerry Help menu and addition of Shortcut Menu/Start-Stop Routing function.

Version v0.7.1 (29 Sep 2009)

See this thread for release notes on v0.7.0 - the App World version is essentially identical but with a new version number.

Troubleshooting

Please see the FAQs, User Guide, Tutorials and Forum for general troubleshooting problems. Also, the following pages give further information regarding BlackBerry-specific GPS and Internet connection issues:
- TMJ-Mobile GPS Connection Problems
- TMJ-Mobile Internet/Web Connection Problems

Keypad Mappings

Menu Button

Since a QWERTY-based BlackBerry handset offers a different keypad layout from 'conventional' phones, operation of TMJ-Mobile is slightly different. The BlackBerry MENU button brings up the TMJ-Mobile Main Menu in the usual way, but further menu screens are then displayed using the TMJ-Mobile menu system, providing Check-Boxes, Selection Lists and other items not available in the standard BlackBerry interface. The P key can also be used to open the Main Menu.

Back Button

The BlackBerry BACK button is mapped directly to the TMJ-Mobile Context Menu, allowing quick access to these functions. This is rather unconventional compared with other BlackBerry apps, but works quite well once it becomes familiar. (If preferred, this option can be disabled in Menu/Settings/Other Settings, the Context Menu is then accessible via the Main Menu)

Other Keys

[P] and [DEL] are directly mapped to the Main Menu and Context Menu. (These are not really needed now that the MENU and BACK keys are also mapped to these functions, but are preserved for consistency with previous versions of TMJ)

The TrackPad, [*], [#] and [0]-[9] work the same as on other phones, for scrolling, selecting, zooming and screen selection.

Preset Shortcuts

Full QWERTY-keypad BlackBerrys (eg 8300, 8500, 8800, 8900, Curve and Bold series) have several other key shortcuts mapped to common functions. These can be altered via the Menu/Settings/Define Shortcut Keys menu, but the defaults are as follows:
I/M/J/L/K keys are also mapped to Up/Down/Left/Right/Fire which is occasionally useful for precise control of the view panning (sometimes difficult with the trackball alone).
B=BackLight On/Off
N=Toggle Night Colours
Space=Shortcut Menu,
[Enter]=Add New Waypoint at Current Location
$=Select Nearest Waypoint
V=Start Slideshow
U=Enable Web Upload
O=Update 'Temporary Location' Waypoint
G=Start/Stop Routing (when a route is loaded)

General Notes

Geotagging Photos

TMJ-Mobile's builtin geotagging functions are limited to a low resolution and have no control over the focussing, flash, etc. Therefore in the BlackBerry version the 'Capture Geotagged Photo' function simply invokes the standard BlackBerry Camera Application, since (on recent BlackBerrys at least) this automatically adds geo-EXIF tags to the JPEG file and so does a better job than TMJ anyhow!

BlackBerry-Specific Menus

- The Menu/Settings/Backlight Brightness defines the brightness of the screen when Menu/Display/Backlight On is enabled. Keeping the backlight on will drain the battery faster, so reducing the brightness can help extend the battery life.
- Menu/Display/Lock Keypad invokes the standard BlackBerry keypad lock, rather than the (more fiddly) TMJ functions.
- Menu/Web/BlackBerry Web Settings allows the connection settings to be customised.
- Menu/Settings/Debug/Select Map Cache Folder allows the Vector and Raster map cache to be stored directly on the memory card, rather than within TMJ-Mobile's 'private' memory store. This allows for a virtually unlimited cache (dependant on memory card size) and can marginally speed up map loading.

Application Permissions

After installing TMJ-Mobile check the phones Permissions settings so that the app doesn't persistently prompt for permission to access the memory card, location data, etc. Under the BlackBerry Options/Advanced Options/Applications/TMJ-Mobile/Edit Permissions, ideally set all options to 'Allow', or at least these ones as a minimum (if available):
- Connections (Bluetooth, Location Data, Internet, Wi-Fi): Allow
- Interactions (Recording): Allow (to enable Geotagged Audio Recordings)
- User Data (Files): Allow

Upgrading from Previous Versions

In general, when upgrading from an older version the previous versions settings should be maintained (note that the Track and Route will be cleared). Occasionally upgrading can result in all settings being reset, so in general it is recommended to follow these steps before upgrading:
- use the Menu/Settings/Debug Options/Save Settings to Backup File function to save all settings to a file on the memory card.
- use the Menu/Web/Waypoint Synchronisation functions to ensure that all Waypoints are stored on the website.
- ensure that TMJ-Mobile isn't running when installing the upgrade.
- reboot the phone immediately after upgrading.
- if the settings have been reset, then use the Menu/Settings/Debug Options/Load Settings from Backup File to restore the previous settings, and the Waypoint Synchronisation functions to re-download the Waypoints.