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 Blackberry 2.1.1 OS 4.1 2.2 Siemens 2.3 Sony Ericsson 2.4 Windows Mobile 2.4.1 IBM J9 (WEME) using serial port 2.4.2 IBM J9 (WEME) using bluetooth 2.4.3 Esmertec Jbed / IBM J9 using network 2.5 Palm 2.6 Sony Ericsson HGE-100 2.7 Nokia N95

[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>
• Units - unit system (metric, imperial, nautical). Default: metric
• Data Dir - root data directory for maps, tracks, waypoint and tracklogs. It is full URL, example file:///fs/tb (internal memory on Siemens SXG75). See below and Installation for more more information for your mobile device. Default: empty

[edit] Desktop

• fullscreen - fullscreen display (restart required). Default: ON
• no sounds - turns off provider status change acoustics. Default: OFF
• nautical view - distance is shown in knots - option not present for TrekBuddy 0.9.79 on Siemens SXG75! Was it removed / moved to basic/units?
• 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 wpt true wpt (or 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
• OSD medium font - medium font. Default: OFF
• OSD bold font - bold font. Default: OFF
• OSD black color - black color for OSD. Default: OFF
• OSD Transparency - ToDo. Default: 2 of 4
• CMS rotate (sec) - ToDo. Default: 0
• Trail line - Style of the trail shown in map. LEFT/RIGHT cycles through options. Default: Cyan

[edit] Location

• Provider - provider type selection (Bluetooth, Internal, Stream, Simulator, O2 Germany). Default: internal

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

• Location Timings - internal provider parameters. Default: 2,2,-1 for Motorola A780, 9999,1,2000 for Motorola E1000, and 1,-1,-1 for other devices
• 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. 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
  • 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: -1 (means: 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 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
  • red - red line instead of black. Default: OFF
  • POI icons - drawn POI icons. Default: ON
• Location SMS (or Sharing) - enables location SMS reception (restart required). Default: OFF

[edit] Misc

• Tweaks
  • Siemens I/O - ToDo. Default: OFF
  • safe renderer - ToDo. Default: ON
  • forced GC - Forced Java Garbage Collection may help to workaround memory leaks in some devices. Default: ON
  • 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 - ToDo. Default: OFF
  • (old version only) Optimistic I/O - may improve file loading performance. Default:
  • (old version only) S60 renderer - may improve rendering performance and/or help to workaround memory leaks in some devices. Default:
• Capture Locator - locator for taking pictures linked to a recorded waypoint. Default: capture://video
• Capture Format - specify non-default picture quality like size, eg. encoding=jpeg&width=640&height=480 (see Options->Info->Snapshot encoding for supported encodings). Default: encoding=jpeg

[edit] Model-specific

[edit] Blackberry

• have Settings->Tweaks->S60 renderer on

[edit] OS 4.1

There's no support for file access, and no "standard" (JSR-82) bluetooth support, but bluetooth 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/mapdata/wpts/
• file:///E:/other/mapdata/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/mapdata/ 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 / IBM J9 using network

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] 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 N95