TrekBuddy

[kruch]

User Guide (not only for K750i owners), with lots of screenshots(!), by Ranger:

tb_k750i_v2.pdf (950 kB)

[Ranger]

SE phones Installation Guide (based on k750i) - valid for TB 0.9.55 and later

1. Download TrekBuddy jar and jad files to PC (pls don't use other phones versions)
2. Connect phone to PC and copy two files to memory stick, ie E:\MSSEMC\Media files\other\tb folder. You can create it if not present.
Create DataDir folders structure in ie E:\MSSEMC\Media files\other\:
- maps for maps storage
- resources for user interface customization
- sounds for route point sound
- tracks-nmea for nmea logs
- tracks-gpx for gpx logs
- ui-profiles for CMS screen themes
- wpts for waypoints
This structure must be created by hand in selected DataDir location to have TB working !!!
Get CMS theme for your phone from forum Themes section and copy it unpacked to ui-profiles folder.
3. Disconnect phone from PC.
4. Open phone file manager and go to Other folder, you will see tb folder with app files.
5. Install using jad file. You can use Info option to be sure that file you install have jad extension. Choose Application folder as destination.
6. When manager ask to start app choose NO.
7 Go to Applications folder, select Trekbuddy and use More option.
9. In Permission menu choose Read User Data and set Never Ask, Write User Data and set Never Ask and if you would Local Connection to Never Ask.
(If you don't have such options you not installed from jad or java root certificate is not present.
No way to use signed TB without Thawte Premium certificate).
10. Start TB, make settings as described in Users Manual and enjoy.

Warning. For k750i DataDir should be set inTB settings as file:///E:/MSSEMC/Media%20files/other/. Remember, phone file system is case sensitive.

[Ranger]

As in post title, some map tips.

Map sources
1. Bought raster maps (in typical graphic file format, like jpeg, png, tiff etc). Don't buy map without calibration info.
2. Scanned paper maps suitable for GPS
3. Online services maps, like GM or local
4. Other bitmap sources

Map selection and preparation
1. Raster maps pictures should be choosed according to the phone screen resolution (mostly (150-200dpi, to have similar map scale on screen). Sometimes it means "by hand" rescaling of map pictures in graphic editor to have good effect. Online maps are adopted to computers screen resolution, so in this case choosing right zoom is all.
2. Map calibration
For TB use is good to prefer WGS84 map pictures with Lat/Lon grids, as native in GPS system.
But not only, if you have map pictures produced with other datums/projections, they can be used in TB too.
If you got ready map picture with proper calibration file, nothing more is to do at this point.
Maps for TB can be calibrated in PC programs like OziExplorer Trial or Map Calibrator (both free for calibration).
First read user manual or help how to use application. OziExplorer is number one, Map Calibrator don't save all necessary calibration info to the file in some cases.
If you already have map with calibration file and you rescaled picture, calibration must be updated. It is easy, you need move calibration points to correct positions on screen and save file. If not, you should produce calibration file yourself.

Simple calibration steps:
- load map picture for calibration
- set datum/projection
- set four calibration points in map corners (or near corners for TM grid calibration)
- save calibration file

For online maps the best way is to use automatic grabber/calibrator (if you find them).

3. Last step - map conversion, color reduction and cutting.
One simple tool for all this steps - TB Cutter (see tools section on forum).
Just choose source map and destination files paths, set tile size and start conversion.
If you prefer, you can use for this task TBMapper, it shows maps and calibration points before cutting.
Finally map should be copied to phone or memory stick.

[Ranger]

Some friends asked me how I prepared GPS working postcard maps I sent them for TB.
If you know some place interesting to enjoy, you can just share wpt gpx file with friends.
It is a little limited way, says nothing what you can find around such place.
So I decided to prepare a small maps with pictures showing more.
(You can find a sample attached below and see it in forum Screenshoot section; Potsdam datum needed).

To create TB postcard map you will need:
1. Map of place (scaled 1:25 000 or 1:10 000 and calibrated; I used no copyright old map)
2. Some (own) pictures taken on place.
3. File with waypoints you recorded.

Preparing map as background is simple. Just copy map picture file, open it in graphic editor and draw rectangle around the place (postcard size). Place resized camera pictures inside rectangle.
Open map with prepared picture in OziE and using drawn rectangle find calibration corners coordinates.
Cut picture to postcard size and recalibrate it using copy of old .map file.
Next with TBMapper or TBCutter produce postcard map.
Final step is to include ready map and wpts files in archive file. Have a fun.
If you would share something with TrekBuddy users, just do it

[Ranger]

Simply tutorial "How to use custom datums in TrekBuddy" for experienced users.

If you got calibrated map, there are few points you should check before map can be used in TB.

1. Check how map was calibrated.
Open calibration .map file content, ie using text editor or OziE. Check map datum and projection to be sure that they are supported in TB.

[Ranger]

New folders structure in TB0955

One of the new features in TB 0955 is folders structure necessary to save logs and waypoints.
The reason of change is to have files saved by TB ordered, ie wpts in wpts directory, nmea logs in tracks-nmea, gpx logs in tracks-gpx etc.
So instead of "tracklogs" directory known from previous versions, in 955 root folder is named "DataDir".

For SE phones, ie k750i, DataDir can be on memory stick, like this:
E:\MSSEMC\Media files\other\
to have files access from k750i file manager.
(inTB settings you should write this dir as file:///E:/MSSEMC/Media%20files/other/)
This way is possible to send wpts and logs via BT to PC or other phones.
Other models can require a little bit different settings. Pls remember, phone file system can use case sensitive names.

The easiest way to check that folders data structure works properly is to save a waypoint file to wpts directory and next try to see it in wpts store.

[Ranger]

A long awaited computer mode is available in TrekBuddy from 955 version.
To use it, just copy CMS profile from forum Themes section to phone ui-profiles folder.
Profile consists of xml definition file and fonts, should be selected according to phone screen size.
Without such profile CMS is just empty screen. Use #key to switch between map/HPS/CMS modes.

[rvs]

[Ranger]

No reason to use signed version in patched phone Although works too.
For some users it is easier to ask operator to have certificate installed.

[rvs]

[Ranger]

Yes, if you decided to patch phone, you know consequences (not acceptable for some users, as you can read on this forum).
BTW, you can find old info how to patch k750i on TB forum too.

[rvs]

At least , with new patch .vkd there is not necesary reset phone,
you will not lose any configuration.

I have seen patches only for SE K750 and W800.

[Ranger]

User Interface customization.
Starting from TB 0.956, it is possible to have some non standard elements of GUI, like crosshair, direction arrows or waypoint symbol.
It can be usefull for phones with large screen, ie 320x240.
Changing elements is easy. Just create in DataDir new folder named resources and copy selected elements from Themes forum section to this location. Enjoy.

[Ranger]

Long awaited route navigation on board in 0957Beta.
More info can be found
http://www.trekbuddy.net/forum/viewtopic.php?p=4309#4309

You can customize route points markers to own phone screen size, look at sample of such pois.png file in Themes section.
If you would use routes on roads, it is possible to put directions info to points descriptions. You can see pictures how it works here
http://www.trekbuddy.net/forum/viewtopic.php?p=4362#4362

[temptrekbuddy]

Before you begin make sure you:

1)
Download WEME from here
(you need to register)

Launch Weme 6.1.1 on your PC and obtain the .zip inside it
in my case weme-wm50-sp-arm-midp20_6.1.1.20061110-161633.zip

Choose:
“CLDC 1.1/MIDP 2.0 for Windows Mobile 5.0 Smartphone Edition/ARM” or the “CLDC 1.1/MIDP 2.0 for Windows Mobile 5.0/ARM”

2)
have Trekbuddy-j9.jar and .jad files

3)Download wscdd.jar
Download

Installation

1)
Pair GPS to your device.

For Smartphone:

Start/Settings/Connections/Bluetooth.
Make sure Bluetooth is set to "On".
Menu/Devices
Menu/New
Select your GPS device from the list and press Next.
Enter the passkey for the Bluetooth GPS. For example, 12345678.
Next
You should get a message box saying "Your Smartphone has connected".
OK
Next
Check the "Serial port" checkbox.
Done
Done
Menu/COM Ports
Select your GPS.
Menu/New Outgoing Port.
Select your device and press Select.
You will see a COM port that has been chosen for your GPS. For example, COM6.
Done
Done
Done
Now your GPS is set up on COM6. Start your GPS app and configure it to use COM6.

http://blogs.msdn.com/windowsmobile/archive/2006/06/07/620387.aspx


2) Preparing Trekbuddy
a) Create trekbuddy folder on Storage Card
b) Create subfolders in trekbuddy folder:
tracks-gpx
tracks-nmea
ui-profiles
wpts
c) Copied trekbuddy-j9.jad trekbuddy-j9.jar to trekbuddy folder on Storage Card

3) Preparing J9
a) create J9 folder on Storage Card
b) copy lib and bin folders which you obtain from .zip
c) Now you need the wscdd.jar. Extract it and:
Copy: fixed\ive-2.2\runtimes\wm2003\arm\midp2\bin\fileconn.dll into this folder on you mobile device: J9\bin\
Copy: fixed\ive-2.2\runtimes\wm2003\arm\midp2\lib\jclMidp20\ext\fc.jar into this folder on you mobile device: J9\lib\jclMidp20\ext\
(you need to create the ext subfolder since it doesnt exist)

a) Installing Trekbuddy
Launch emulator.exe in J9/bin/ with any file explorer

b)
In the prompt type in
file:///Storage%20Card/trekbuddy/trekbuddy-j9.jad

c)
If you installed Trekbuddy you can now set the permissions for the java app.
Highlight TB and choose Actions-> Permissions
Set the read, write and communication permissions for the java app

d) Now choose Launch from Actions menu
Launched TB

e)
Change in settings of TB
- the Data Dir to
file:///Storage%20Card/trekbuddy
- Changed the com port Connection URL to COM6 (in my case)