CMS

From TrekBuddy

Jump to: navigation, search

Contents

[edit] CMS

[edit] Presentation

CMS is a view of GPS data, accessed by the # key. Here is how it can look like: Image:240x320_panel_cms_blue_423.png

(CMS made by MaleSMurf for phones with a 240x320 screen)

the CMS view is fully customizable according to your tastes and to your device. Trekbuddy is not supplied with a default CMS.

Instructions to get one for your device are on the forum, under the "Theme" subsection: [[[1]]] check often for user-contributed CMS profiles ! Put the CMS-profile of your choice in the ui-profiles directory with all png files for panels and fonts.

You can install multiple CMS profiles at the same time and switch between them with the right arrow or 6. See Using/CMS for more info. In Settings --> Desktop you can give a value to CMS Rotate (sec), then the profiles are switched automatically. If this value is 0 the profiles don't switch automatically.

[edit] Technical

A CMS is composed of one XML file, all instructions about item placement goes in this very file. If the profile you have chosen use special fonts, you will also need the image file of the fonts, along the XML file.

[edit] XML layout

You can make file with a static background image where all the variables are filled in. You can also design your own 'font' to show graphic elements. With the {timer} variable and your self-designed fonts the CMS changes every second. First you have to define the colors of the CMS, you can make a difference between the night and the day view. Then you define the fonts that you are using and in the next part you start designing your CMS. To show variables you have to define an area where they will be shown.

[edit] Variables available

Here is a set of variables availables for CMS interface (as of version 0.9.80):

numeric
variable description format
Position
coords current location see coordinates formats table below
lat actual latitude see coordinates formats table below
lon actual longitude see coordinates formats table below
alt actual altitude 0000m
time current time hh:mm
time-t total time hh:mm:ss
time-t-auto total moving time hh:mm:ss
course current course
dist-t distance travelled 0000
Speed
spd speed km/h or kn(nautical)
spd-d dec/acceleration m/s²
spd-max max speed km/h,kn or mi/h
spd-avg average speed km/h,kn or mi/h
spd-avg-auto "auto" average speed (average "moving" speed) km/h,kn or mi/h
spd.i speed (integer part) 000
spd.i-max speed max (integer part) 000
spd.i-avg average speed (integer part) 000
spd.i-avg-auto "auto" average speed (integer part) 000
spd.d speed (decimal part) 000
spd.d-max speed max (decimal part) 000
spd.d-avg average speed (decimal part) 000
spd.d-avg-auto "auto" average speed (decimal part) 000
alt-d vertical speed m/s
Navigation
wpt-alt waypoint altitude 0000
wpt-alt-diff difference between current and waypoint altitude
wpt-azi azimuth to wpt
wpt-dist distance to wpt
wpt-eta waypoint estimated time of arrival (based on current speed and direction)
wpt-coords waypoint coordinates see coordinates formats table below
wpt-lat waypoint's latitude see coordinates formats table below
wpt-lon waypoint's longitude see coordinates formats table below
wpt-vmg Velocity Made Good ([2])
Satelites information (**)
sat number of satelites 0.....12
fix fix quality
snr0..11 strength of each satellite signal (to be confirmed)
prn0..11 satellites numbers 1.....32
satv number of sats in view 0.....12
pdop, hdop, vdop dilution of precision (see [Wikipedia]) 0..50
Other
timer counts from 0 to 9 can be used for animation of CMS

(**) = some of these variables won't work with internal GPS like in BlackBerry 8800 (for tb v0.9.78), SE C702 ...


Graphical
variable description
status display a blue dot (establishing GPS connection), red dot (no GPS device), orange dot (GPS device but no fix), or green dot (fix)

[edit] Coordinates format

Trekbuddy currently display coordinates in 4 formats (defined in Options -> Basic -> Coordinates)

TODO : to be confirmed

Coordinates display
Coordinates setting example description
Map Lat/Lon N 179°59'59" hemisphere (N/S or E/W) followed by degrees-minutes-seconds (seconds can be 59.9 if decimal precision is checked), current map datum
Map Grid N 179°59'59" depends on current map, can be either spherical (lat/lon) or cartesian (eg. easting/northing) coordinates, current map datum
UTM 9999999N 7 digits followed by E (easting) or N (northing)
Geocaching Lat/Lon N 179°59.999 hemisphere followed by degrees-decimal minutes, WGS-84 datum

As kruch release new versions, he may also release new variables availables for CMS programming. This set of variables is according to version 0.9.81

Most of this information come from the forum thread initiated by kruch

[edit] Links

A German CMS-Guide by MartinZ can be found here: CMS-Schemata-TrekBuddy

Personal tools
others