Configuration manual

Configuration

In the "AirNavigator" folder there is the "config.xml" file. In this file there are all the configuration parameters used by the program. If needed you can customize the parameters by opening end editing this file. In this file only the values can be changed the names of the elements and attributes must remain the same otherwise AirNavigator will not find them. Let's explain every element of this file:

Aircraft


<aircraft>

<!-- measure units: speed: Km/h, fuel consumption: liters/hour, fuel capacity: liters -->

<speeds cruise="100" Vx="90" Vy="100" Vs0="45" Vs="55" Vfe="86" Va="135" Vno="160" Vne="180" endScale="185" />

<fuel consumption="15" capacity="70" />

</aircraft>

In the "aircraft" element it is possible to configure the parameters of the plane where you intend to use the navigator: speeds and fuel. The cruise speed will be used as the average speed when there is still not enough data received to calculate the real average speed. Here the speeds must be expressed in Km/h, fuel capacity in liters and the fuel consumption in l/h.

Measure units


<measureUnits>

<!-- possible values for horizontal speed : Kmh, Knots, MPH  -->

<!-- possible values for vertical speed : FtMin, ms  -->

<speeds horizontal="Kmh" vertical="FtMin" />

<!-- possible values for distance : Km, NM, Mile  -->

<!-- possible values for track error : m, Ft, NM  -->

<distances distance="Km" trackError="m" />

</measureUnits>

Here is possible to choose the measure units for distances and speeds displayed on the screen.

Navigator


<navigator>

<!-- measure units: altitude and distances: meters, angles: degrees -->

<takeOff diffAlt="50" />

<navParameters trackErrorTolearnce="5" deptDistTolerance="1000" />

<sunZenith angle="96" />

</navigator>

takeOff diffAlt: it is the difference of altitude that once detected together with a speed higher than the stall speed will be considered as the start of the flight.
trackErrorTolearnce: if the track error (XTD) is smaller than trackErrorTolearnce the navigator will use an easier calculation algorithm in order to be faster we are already in route.
deptDistTolerance: if we are at distance less than deptDistTolerance from our departure location than AirNavigator will consider us still at the departure and starting the flight, else it will consider us away from the departure and the flight already started to the next way point
sunZenith angle: it is the sun Zenith angle in degrees used to calculate sunrise and sunset times:
- Official: 90° 50'
- Civil: 96°
- Nautical: 102°
- Astronomical: 108°

Track Recorder


<trackRecorder>

<!-- measure units: interval time: seconds, minimum distance: meters -->

<update timeInterval="5" distanceInterval="10" />

</trackRecorder>

distanceInterval: it is the minimum distance that we have to cover from the previous recorded position to allow the recorder to record a new one
timeInterval: it is the minimum interval of time that the recorder let to elapse between every recorded position

Colors schema


<colorSchema>

	<colors 

	background="0000"

	compassRose="FFFF"

	dirMarker="F000"

	magneticDir="00F0"

	routeIndicator="0F00"

	cdi="FF00"

	cdiScale="FFFF"

	altScale="FFFF"

	vsi="FFFF"

	altMarker="FFFF"

	text="0F00"

	ok="0F00"

	warning="F000"

	caution="F000"

	airplaneSymbol="FA00"

	buttonEnabled="00F0"

	buttonDisabled="00B0"

	buttonLabelEnabled="FFF0"

	buttonLabelDisabled="DDD0" />

</colorSchema>

Here it is possible to choose the color of everything AirNavigator will display on the screen of your TomTom, the colors must be encoded with a four digits hexadecimal number starting from 0000 that is black up to FFFF that is white. (Red=F000, green=0F00, blue=00F0, yellow=FF00)

background: the color of the background
compassRose: color of the compass and its scale
dirMarker: color of the marker on the top of the compass indicating the current direction
magneticDir: color of the numbers indicating the current magnetic heading
routeIndicator: color of the arrow in the HSI indicating the direction of the route
cdi: color of the course deviation indicator inside the HSI
cdiScale: color of the course deviation scale
altScale: color of the altitude/VSI scale
vsi: color of the VSI marker on the left pointing the route altitude
altMarker: color of the altitude marker pointing the current altitude
text: color of the textual information's displayed on the left
ok: color used to display information within the expected ranges
warning: color used to show some potential problem: 2D GPS fix but not 3D or got GPS UTC time but no fix
caution: color used to highlight important risk situations: CDI or VSI markers out of scale (too left or right or too high or low respect the route) or no GPS fix
airplaneSymbol: color of airplane symbol displayed in the center of HSI
buttonEnabled: color of enabled buttons
buttonDisabled: color of disabled buttons
buttonLabelEnabled: color of text label of enabled buttons
buttonLabelDisabled: color of text label of disabled buttons

GPS receiver configuration

<GPSreceiver devName="/var/run/gpsfeed" baudRate="115200" dataBits="8" stopBits="1" parity="0" />

This is the configuration about how AirNavigator connects to the internal GPS receiver of the device. Those settings should be the same for all the TomTom devices.
If you are running AirNavigator in parallel with the TomTom software the device name should be: /var/run/gpsfeed
Otherwise if you are running the application standalone the device name must be: /var/run/gpspipe

< Installation | Tests & results>