Common aircraft properties

Work in progress This article or section will be worked on in the upcoming hours or days. See history for the latest developments.

WORK IN PROGRESS

TODO: standardise locations most common to existing aircraft to ease transition

With common aircraft properties found in uncommon locations, assigning buttons in joysticks to certain functions became mostly a hit or miss affair. e.g. Speedbrakes and thrust reversers are found in different location in the property tree, even across official FlightGear planes! Without standard locations, joystick code tends to be aircraft specific.

There was an attempt to unify it all with a nasal script but after consulation and comments with others, this attempt was replaced with the solution to standardise common aircraft properties in standardised locations.

This document will exhaustively list property tree locations where aircraft developers should store their common aircraft properties (if not alias them).

Gear

Properties marked with an '✲' are standard across all aircraft and should always be set. For example, an old aircraft without any autobrakes should still define /controls/gear/autobrake although set it to 0

States

• In /controls/gears
  • /controls/gears/brake-parking ✲
    0 = Off
    1 = On
  • /controls/gears/brake-chokes ✲
    0 = Off
    1 = On
  • /controls/gears/antiskid ✲
    0 = Off
    1 = On
  • /controls/gears/autobrake ✲
    0 = Fully Off
    1 = Fully On
  • /controls/gears/launcbar ✲
  • /controls/gears/servicable ✲
  • /controls/gears/brake-servicable
  • /controls/gears/brake-temperature
  • /controls/gears/brake-hydraulic-pressure
  • /controls/gears/tyre-temperature
  • /controls/gears/tyre-pressure
  • /controls/gears/brake-available ✲
  • /controls/gears/retractable ✲
  • /controls/gears/brake ✲
  • /controls/gears/gear-down
    0 = Retracted
    1 = Extended
• In /controls/gears/gear[n]

compression-ft compression-norm steering-norm tailhook wheel speed

Transitions

• In /gears/gear[n]
  • /gears/gear[n]/position-norm
    0 = Fully Retracted
    0.x = Transitioning
    1 = Fully Extended
• In /controls/gears/gear[n]

brake-pressure 0 0.x 1 friction-ground friction-ground-real friction-bearing friction-bearing-real friction-side-slip friction-side-slip-real

Speedbrakes

engine --thrust reversers

flaps

tailhook

radios - /instrumentation/nav

fuel

implementation with custom locations: if you require your values be stored in a custom location, be sure to alias them in the standard location: <property alias="../../params/n1"/>h