Configuration

From TrekBuddy

Contents 1 Model-independent / Setup explained 1.1 Basic 1.2 Desktop 1.3 Location 1.4 Navigation 1.5 Misc 2 Model-specific 2.1 Motorola 2.2 BlackBerry 2.3 Siemens 2.4 Sony Ericsson 2.5 Windows Mobile 2.5.1 IBM J9 (WEME) using serial port 2.5.2 IBM J9 (WEME) using bluetooth 2.5.3 Esmertec Jbed or IBM J9 using using serial port 2.5.4 Esmertec Jbed or IBM J9 using device-local socket connection 2.5.5 Samsung OMNIA 2.5.6 Samsung OMNIA II 2.5.7 Samsung Pixon 2.6 Palm 2.7 Sony Ericsson HGE-100 2.8 Nokia 2.8.1 Nokia 5800 xpressmusic 2.8.2 Nokia N73

[edit] Model-independent / Setup explained

[edit] Basic

• Startup map - map or atlas to be loaded upon start. It is full URL, example: file:///E:/trekbuddy/maps/map.tar (file on memory card in Nokia). It is not necessary to set the URL by hand - if loading via Options -> Load Map / Load Atlas succeeds, you are asked whether you want it to use as a default. For default map, leave the field empty. Default: empty
• Default Datum - default map datum (used when not detected). Default: WGS 84
• Coordinates - selects display coordinates format. Default: <Map Lat/Lon>
• Unit System - unit system to use (metric, imperial, nautical). Default: metric
• Startup screen - shall map or compass/HPS or CMS be shown after startup? Default: map
• Data Dir (since v0.9.94) - root data directory for maps, tracks, waypoint and tracklogs. It is directory URL, example file:///E:/TrekBuddy/ (Nokia, SE) or file:///fs/tb (internal memory on Siemens SXG75). See below and Installation for more more information for your mobile device. Default: best guess for given device.

[edit] Desktop

• fullscreen - fullscreen display (restart required). Default: ON
• safe colors - force hardcoded colors to be used for waypoints/tracks files and waypoints lists, otherwise phone theme colors will be used. Needed only on some phones (like SE K550i) when you see the waypoint list just as black background and white text, and you don't see which item is selected. Default: OFF
• no sounds - turns off provider status change acoustics. Default: OFF
• no questions (since v0.9.94) - no "Do you want to quit?" nor "Use as default map?" question (a workaround for some Samsungs where Yes/No dialog hangs). Default: OFF
• (old version only) nautical view - distance is shown in knots
• show trail - Show trail (=track, historic positions)? Default: OFF
• decimal precision - when showing lat/lon in degrees: Shall only the integer part of seconds be shown or also fractions? Default: OFF
• HPS true wpt azimuth (old naming "HPS wpt true north)" - azimuth to a waypoint is north-oriented. Default: ON
• OSD basic - display 1st line in OSD (ie. coordinates). Default: ON
• OSD extended - display 2nd OSD line (time, speed and altitude or, during navigation, distance and delta). Default: ON
• OSD scale - show scale (eg. |---| equals 700m) in bottom left of map? Default: ON
• OSD no background - no grey background. Default: OFF
• (old version only) OSD medium font - medium font. Default: OFF
• OSD bold font - bold font. Default: OFF
• OSD black color - ON for black colored text in OSD, OFF for white color. Default: OFF
• Font size - size of font in OSD. Default: 0
• OSD Transparency - transparency of grey background, 0 = fully transparent equals OSD no background=ON, max (4 or 16) = no transparency. Default: 2 of 4 respectively 6 of 16
• Lists font - Font used for lists (e.g. waypoints). Usable fonts depend on device and OS, perhaps you have to try some values. Format is FFSSZZ (hex values). Default: 200008 (which means: monospace,plain,small)
  • FF: 00 = system, 20 = monospace, 40 = proportional
  • SS: 00 = plain, 01 = bold, 02 = italic, 04 = underlined
  • ZZ: 00 = medium, 08 = small, 10 = big
• CMS rotate (sec) - if multiple CMS are present, profiles are switched automatically. If this value is 0 the profiles don't switch automatically. Default: 0
• Trail line - Style of the trail shown in map. Left menu key opens options dialog to set color, thickness and cycles through available styles. Default is cyan thin line.

[edit] Location

• Provider - GPS provider type selection (Bluetooth, Internal, Stream, Simulator, O2 Germany). Default: best guess for given device

Note: O2 Germany has to be manually enabled before installing the midlet by adding the following line to trekbuddy.jad file:
App-Flags: provider_o2_germany

• For internal provider:
  • Location Timings - internal provider parameters. Default: 2,2,-1 for Motorola A780, 9999,1,2000 for Motorola E1000, 5,-1,-1 seems to be a good choice for 5800 (as time updates seem to work better, by default time updates are incorrect in CMS screen for example), and 1,-1,-1 for other devices. This number means: interval, timeout, maxAge.
    More info about in function in: setLocationListener(LocationListener, interval, timeout, maxAge)
  • assisted GPS - enables assisted GPS. When enabled, you can still control it in suite settings. The option only exists because on some devices support has to be disabled at code level, otherwise internal GPS did not work. Default: OFF.
  • time fix - on some devices (eg. LG Arena) position timestamp is incorrect (typically shown as 1970-01-01 00:00). This option allows TrekBuddy to use phone's clock instead. Default: OFF.
  • power usage - together with assisted GPS affect how fast is the fix acquired, and what the position source is. Default: MEDIUM. For Blackberry, HIGH can be better choice. See [1] how critetia combination may work.
• For Bluetooth provider:
  • exact time match TODO. Default: ON.
  • reliable input (since v0.9.94) - could make bluetooth (or serial) GPS connection more stable; to verify that it works, enable it, start tracking and after a while check the value of maxavail attribute in Info->Technical->ProviderStatus. If it is non-zero then it is good and you can (should?) keep the option set. Most users won't see any difference, though. Default: OFF.
  • do service search After bluetooth GPS is discovered, service is searched as well; usually not needed. Default: OFF.
  • address fix On some devices (eg. Samsung S5230), reported GPS device address is incorrect and TrekBuddy is not able to connect it. This turns on address fix. Default: OFF.
  • Keep-alive (ms) TODO
• Tracklog - when TB starts a device, shall trackloging never/always start or the user be asked? Default: never

Only displayed if tracklog is other than never

• Tracklog Format - tracklog format selection (GPX / NMEA). NMEA does not work for some internal devices. See Using for more format information. Default: GPX 1.1
• If GPX is set: GPX Options
  • log only valid - ToDo. Default: OFF
  • log gsm info - adds current cellid and lac to recorded pt. Default: OFF (hexadecimal to v0.9.83, since .89 decimal)
  • log time ms (since v0.9.94) - TODO. Default: ON
  • GPX dt (s) - record a location at least every N sec. Default: 60
  • GPX ds (m) - record a location at least every N meters. Default: 0 (since v0.9.94) or -1 (older versions) meaning "switch off"

Only for some providers

• Simulator delay - controls the speed of NMEA track replay

[edit] Navigation

• Wpt Proximity - used in route navigation. When distance between current position and active wpt drops below this value (in metres), the notification sound ./sounds/wpt.amr (or ./sounds/wpt.wav or ./sounds/wpt.mp3 - depends on phone model) is played and next wpt in route is selected as active. Default: 50
• Route Line
  • dotted - route line is drawn dotted, not solid. Default: OFF
  • (old version only) red - red line instead of black. Default: OFF
  • POI icons - drawn POI icons. Default: ON
  • Route line (since v0.9.94) - Style of the route shown in map. Left menu key opens options dialog to set color, thickness and cycles through available styles. Default is black thin line.
• Waypoints
  • File revisions - perform file backup before altering modifying a waypoint file (edit / delete wpt)? Default: ON
  • prefer GC name - use wpt name from the Groundspeak extra info if available. Default: ON
• Sort by - TODO. Default: Position.
• Location SMS (or Sharing)
  • receive - enables location SMS reception (restart required). Default: OFF
  • autohide notification - notification dialog on received message hides automatically when this option is enabled. Default: ON

[edit] Misc

• Tweaks
  • broken I/O - some (most?) Siemens and Samsung phones require this in order to handle tar-ed maps. Default: OFF
  • lowmem I/O - on some Samsung phones (eg. S5230), tar-ed map consume too much memory and users may experience OutOfMemoryError while scrolling such maps. The option reduces memory consumption, but scrolling can be much slower then. Default: OFF.
  • safe renderer - turns on safe map rendering method; very probably will be removed in the future and the midlet will work as if it is on. You may try to uncheck it and see whether map rendering is faster or not. Default: ON
  • forced GC - enables forced garbage collections in several situation; may help to workaround memory leaks in some (old) devices, where it may help, for example, to avoid out-of-memory errors during map browsing. Be careful with this on BlackBerry devices, for if GC runs, nothing else runs for 0,5s to 30s depending on the kind of GC that is done and an hourglass is shown (see [2]) for details. Default: OFF
  • power save - in 0.9.81+ it disables vibration when 1) wpt is reached or 2) keyboard is locked/unlocked. Positive effect on battery life... is uncertain so far. Default: OFF
  • 1-tile scrolling - turns on alternative scrolling method that may help to avoid out-of-memory errors on some devices. When switched on, scrolling does not follow smoothly your cursor movement, but the screen stays until you would leave it and then the next tile (more a less a screen) is displayed. Default: OFF
  • large atlases - disables maps meta info caching. Use it when you use atlases with many maps and are low on memory. Default: OFF
  • use native service (since 0.9.96, Symbian only) - enables TrekBuddy to use TrekBuddyService for faster tar maps/atlases access. Default: ON (on UIQ3 and S60 3rd until FP2+) Note: TB always tries to use the service for backlight control.
  • lazy GPX parsing (since 0.9.96) - enables lazy parsing of Groundspeak data in GPX, which saves memory for large GPX files. Only cache id and name is parsed when this option is on. The remaining info is parsed when waypoint details are about to be shown. Such partially parsed file cannot be modified - waypoints cannot be edited nor you can add a new wpt to the file. Default: OFF
  • hide menubar cmd (since v0.9.95) - on Sony Ericsson JP8: Hiding of menu bar that does not dissapear sometimes is less annoying (without autohiding dialog); enables fake command labeled as ... that maps to right soft key; option effective after restart.

• Multimedia
  • Capture Locator - locator for taking pictures linked to a recorded waypoint. Enter either capture://image or capture://video depending on your device. See Using, too. Default: capture://video
  • Capture Format - specify non-default picture properties like image format, size, etc. encoding=image/jpg should work for most users, another option is encoding=image/gif. To specify the resolution of the snapshot add width and height variables in the Capture Format field, e.g. encoding=image/jpg&width=1280&height=1024. See Using, too. Default: encoding=jpeg

[edit] Model-specific

[edit] Motorola

After installing and starting TrekBuddy application need to change data directory in the Settings from file:///E:/Trekbuddy/ to one of the following values:

• file:///b/trekbuddy - in case if memory card used
  
• file:///a/trekbuddy - otherwise

[edit] BlackBerry

• have Settings -> Tweaks -> safe renderer on
• have Settings -> Desktop -> safe colors on
• The DataDir location should look like this: file:///SDCard/TrekBuddy/
• It's highly recommended to install a Keymap, so you don't have to press the ALT key with your command keys, see http://wiki.trekbuddy.net/index.php/Customization#Keymap for details

BT GPS Receivers on BlackBerry may work if serial port profile is supported, so if you know your BT GPS network address, you can use Serial provider, and specify btspp URL as Connection URL, eg. btspp://000276FD79DA:1 where 000276FD79DA is BT GPS bluetooth address.

[edit] Siemens

• have Tweaks->Siemens I/O off
• On SXG75 NMEA track format is not working

[edit] Sony Ericsson

Saving way points and track logs

TrekBuddy will error when you try to save way points and routes unless you create the directories it needs. It needs two directories inside the main directory for saving map data.

This is a sample directory structure for it:

• file:///E:/Other/TrekBuddy/wpts/
• file:///E:/Other/TrekBuddy/tracks-gpx

Drive E is the phone's memory stick while drive C is the phone's internal memory. In Settings, set the Data Dir to be file:///E:/Other/TrekBUddy/ and all should be fine. However in P1i model phone's memory stick must be referenced by "Ms", not by "E:". The sample path pointing the folder on Memory Stick will look like this: file://Ms/Other/mapdata/

note: on the P990i (and most likely other Sony Ericsson P models) the system may nationalize the folder names in the file browser, but the names on the memory stick are always the same (eg. if you have a polish translation and see the folder "Inne" while browsing the memory stick you should still use "OTHER" when setting TrekBuddy Data Dir). Also, you may encounter a security exception if the mapdata folder isn't a subfolder of one of the "original" folders (eg. file:///Ms/myfolder/mapdata/ will not work even if the folder myfolder exists) Another issue is that if you just install the JAR file, Symbian OS may block all writing attemps (like recording a track) with a security exception. So always install JAD and JAR file for proper certificates and capabilities.

Map tile size

On SE K750i/W800i tiles larger than approx. 300*380 pixels cause unexpected and random program freezing

[edit] Windows Mobile

[edit] IBM J9 (WEME) using serial port

Pair bluetooth GPS with the device, and create outgoing port for the GPS (eg. COM5). Then configure TrekBuddy to use Serial provider:

• Select Setting->Location
• Location Provider: Serial
• Connection URL: comm:COM5 or comm:COM5;baudrate=19200 (or whatever baudrate you wish and the device supports)

[edit] IBM J9 (WEME) using bluetooth

• Update J9 with bluecove
• Run TB
• Select Settings->Location
• Location Provider: Bluetooth
• Apply/Save
• After Start select your BT-GPS device

[edit] Esmertec Jbed or IBM J9 using using serial port

• Select Setting->Location
• Location Provider: Serial
• Location Timings: 1,-1,-1

[edit] Esmertec Jbed or IBM J9 using device-local socket connection

Find COM port for your GPS (bluetooth, integrated, ...). Run a program that "redirects" COM port data to TCP/IP socket (eg. GpsGate or GpsPort). Then configure TrekBuddy to use Stream provider:

• Select Setting->Location
• Location Provider: Stream
• Connection URL: socket://127.0.0.1:20175 (or whatever TCP port you set up in the COM->TCP/IP redirecting application)

[edit] Samsung OMNIA

• Data Dir: Change data directory in the Settings from file:///E:/Trekbuddy/ to file:///root1/trekbuddy - which points to /My Documents/trekbuddy/; or try to use real directory like file:///Moja%20pamiec/My%20Documents/trekbuddy - which is real way to Dir
• Internal GPS: There is no Provider "Serial", try to use "Stream" together with GPSPortPPC.exe. Connection URL: "socket://127.0.0.1:xxxxx", where "xxxxx" is Output in GPSPort.

[edit] Samsung OMNIA II

• Data Dir: Change data directory in the Basic Settings to file:///Storage Card/trekbuddy/.
• Create folder maps inside.

Warning: names is case sensitive!

[edit] Samsung Pixon

• Data Dir: Change data directory in the Settings from file:///E:/Trekbuddy/ to file:///mmc/trekbuddy - which points to the SD-Card

[edit] Palm

Basic configuration: Settings->Basic

• Data Dir: file:////TrekBuddy/ (assumes TrekBuddy would be your folder on sd-card)

Location configuration: Settings->Location

• Provider configuration: Setting->Location
• Location Provider: Serial
• Connection URL: comm:rfcm;baudrate=4800

[edit] Sony Ericsson HGE-100

Provider configuration: Setting->Location

Since 0.9.74 there is a special location provider called... HGE-100 :-)

Or setup Stream provider manually:

• Location Provider: Serial
• Connection URL: comm:AT5;baudrate=9600

On latest SE phones, HGE-100 should be available with Internal provider as well (according to some SE document).

[edit] Nokia

[edit] Nokia 5800 xpressmusic

To disable the virtual joypad that is shown, edit the suite settings in the application manager:

• setup
• application manager - installed apps - trekbuddy
• options - suite settings
• on screen keyboard: off

[edit] Nokia N73

To enable taking image snapshots of waypoints:

• Go to Settings->Misc
• Set Capture Locator to capture://video
• Set Capture Format to encoding=image/jpeg