CMS
From TrekBuddy
Contents |
[edit] CMS
[edit] Presentation
CMS is a view of GPS data, accessed by the # key.
Here is how it can look like:
(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):
| 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 ...
| 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 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
