cockpit.cfg

The cockpit.cfg file is an optional aircraft file for defining different cockpit behaviors and instruments. Below you can find information on the different sections used in the cockpit.cfg file as well as what parameters and values are expected within them.

 

 

[VERSION]

The [VERSION] section provides version information for the configuration file. In Microsoft Flight Simulator, major versions should always be at least equal to 1. Note that this section information is mandatory and should always be included.

 

Parameter Description Type Required
major Major CFG file version number, values must be greater than 0. Integer Yes
minor Minor CFG file version number, values must be greater than 0. Integer Yes

 

 

[FUEL_FLOW]

This section controls the fuel flow glass cockpit display. Available parameters are:

 

Parameter Description Type Required
min      
lowLimit      
green_start      
green_end      
highLimit      
max      

 

 

[FUEL_QUANTITY]

This section controls the fuel quantity glass cockpit display. Available parameters are:

 

Parameter Description Type Required
min      
lowLimit      
green_start      
green_end      
yellow_start      
yellow_end      
red_start      
red_end      
highLimit      
max      

 

 

[FUEL_TEMPERATURE]

This section controls the glass cockpit display related to fuel temperature. Available parameters are:

 

Parameter Description Type Required
min      
lowLimit      
low_red_start      
low_red_end      
low_yellow_start      
low_yellow_end      
green_start      
green_end      
yellow_start      
yellow_end      
red_start      
red_end      
highLimit      
max      

 

 

[FUEL_PRESSURE]

This section controls the fuel pressure glass cockpit display. Available parameters are:

 

Parameter Description Type Required
min      
lowLimit      
low_red_start      
low_red_end      
low_yellow_start      
low_yellow_end      
green_start      
green_end      
yellow_start      
yellow_end      
red_start      
red_end      
highLimit      
max      

 

 

[OIL_TEMPERATURE]

This section controls the oil temperature glass cockpit display. Available parameters are:

 

Parameter Description Type Required
min      
lowLimit      
low_red_start      
low_red_end      
low_yellow_start      
low_yellow_end      
green_start      
green_end      
yellow_start      
yellow_end      
red_start      
red_end      
highLimit      
max      

 

 

[OIL_PRESSURE]

This section controls the oil pressure glass cockpit display. Available parameters are:

 

Parameter Description Type Required
min      
lowLimit      
low_red_start      
low_red_end      
low_yellow_start      
low_yellow_end      
green_start      
green_end      
yellow_start      
yellow_end      
red_start      
red_end      
highLimit      
max      

 

 

[EGT_TEMPERATURE]

This section controls the exhaust gas temperature glass cockpit display. Available parameters are:

 

Parameter Description Type Required
min      
lowLimit      
highLimit      
max      

 

 

 

[CHT_TEMPERATURE]

This section controls the CHT glass cockpit display. Available parameters are:

 

Parameter Description Type Required
min      
lowLimit      
green_start      
green_end      
yellow_start      
yellow_end      
red_start      
red_end      
highLimit      
max      

 

 

[VACUUM]

This section controls the vacuum glass cockpit display. Available parameters are:

 

Parameter Description Type Required
min      
lowLimit      
green_start      
green_end      
highLimit      
max      

 

 

[MANIFOLD_PRESSURE]

This section controls the manifold pressure glass cockpit display. Available parameters are:

 

Parameter Description Type Required
min      
lowLimit      
green_start      
green_end      
highLimit      
max      

 

 

[AIRSPEED]

This section controls the airspeed indicator glass cockpit display. Available parameters are:

 

Parameter Description Type Required
min      
lowLimit      
white_start      
white_end      
green_start      
green_end      
yellow_start      
yellow_end      
red_start      
red_end      
highLimit      
max      

 

 

[TORQUE]

This section controls the torque indicator glass cockpit display. Available parameters are:

 

Parameter Description Type Required
min      
lowLimit      
green_start      
green_end      
yellow_start      
yellow_end      
red_start      
red_end      
highLimit      
max      

 

 

[RPM]

This section controls the RPM indicator glass cockpit display. Available parameters are:

 

Parameter Description Type Required
min      
lowLimit      
green_start      
green_end      
yellow_start      
yellow_end      
red_start      
red_end      
highLimit      
max      

 

 

[TURBINE_NG]

This section controls the turbine engine indicator glass cockpit display. Available parameters are:

 

Parameter Description Type Required
min      
lowLimit      
green_start      
green_end      
yellow_start      
yellow_end      
red_start      
red_end      
highLimit      
max      

 

 

[ITTEngineOff]

This section controls the engine off glass cockpit display. Available parameters are:

 

Parameter Description Type Required
min      
lowLimit      
low_red_start      
low_red_end      
low_yellow_start      
low_yellow_end      
green_start      
green_end      
yellow_start      
yellow_end      
red_start      
red_end      
highLimit      
max      

 

 

[ITTEngineOn]

This section controls the engine on glass cockpit display. Available parameters are:

 

Parameter Description Type Required
min      
lowLimit      
low_red_start      
low_red_end      
low_yellow_start      
low_yellow_end      
green_start      
green_end      
yellow_start      
yellow_end      
red_start      
red_end      
highLimit      
max      

 

 

[MAIN_BUS_VOLTAGE]

This section controls the main bus voltage indicator glass cockpit display. Available parameters are:

 

Parameter Description Type Required
min      
lowLimit      
low_red_start      
low_red_end      
low_yellow_start      
low_yellow_end      
green_start      
green_end      
yellow_start      
yellow_end      
red_start      
red_end      
highLimit      
max      

 

 

[HOT_BATTERY_BUS_VOLTAGE]

This section controls the hot battery bus voltage indicator glass cockpit display. Available parameters are:

 

Parameter Description Type Required
min      
lowLimit      
low_red_start      
low_red_end      
low_yellow_start      
low_yellow_end      
green_start      
green_end      
yellow_start      
yellow_end      
red_start      
red_end      
highLimit      
max      

 

 

[BATTERY_BUS_AMPS]

This section controls the hot battery bus amps indicator glass cockpit display. Available parameters are:

 

Parameter Description Type Required
min      
lowLimit      
green_start      
green_end      
yellow_start      
yellow_end      
red_start      
red_end      
highLimit      
max      

 

 

[GENALT_BUS_AMPS]

This section controls the generator alternator bus amps indicator glass cockpit display. Available parameters are:

 

Parameter Description Type Required
min      
lowLimit      
green_start      
green_end      
yellow_start      
yellow_end      
red_start      
red_end      
highLimit      
max      

 

 

[COOLANT_LEVEL]

This section controls the coolant level indicator glass cockpit display. Available parameters are:

 

Parameter Description Type Required
min      
lowLimit      
highLimit      
max      

 

 

[COOLANT_TEMPERATURE]

This section controls the coolant temperature indicator glass cockpit display. Available parameters are:

 

Parameter Description Type Required
min      
lowLimit      
low_red_start      
low_red_end      
low_yellow_start      
low_yellow_end      
green_start      
green_end      
yellow_start      
yellow_end      
red_start      
red_end      
highLimit      
max      

 

 

[GEAR_OIL_TEMPERATURE]

This section controls the gear oil temperature glass cockpit display. Available parameters are:

 

Parameter Description Type Required
min      
lowLimit      
green_start      
green_end      
yellow_start      
yellow_end      
red_start      
red_end      
highLimit      
max      

 

 

[CABIN_ALTITUDE]

This section controls the cabin altitude indicator glass cockpit display. Available parameters are:

 

Parameter Description Type Required
min      
lowLimit      
green_start      
green_end      
highLimit      
max      

 

 

[CABIN_ALTITUDE_CHANGE_RATE]

This section controls the cabin altitude change rate indicator glass cockpit display. Available parameters are:

 

Parameter Description Type Required
min      
lowLimit      
highLimit      
max      

 

 

[CABIN_PRESSURE_DIFF]

This section controls the cabin pressure differential glass cockpit display. Available parameters are:

 

Parameter Description Type Required
min      
lowLimit      
green_start      
green_end      
highLimit      
max      

 

 

[ATTITUDE_INDICATORS]

This section is used to define the characteristics of the attitude indicators on the instrument panels, where each indicator is defined in order, starting at 0 and incrementing by 1. Available parameters are:

 

Parameter Description Type Required
attitude_indicator.N The system which drives the attitude indicator.

Integer:

  1. 0 = none
  2. 1 = Vacuum driven gyro
  3. 2 = Electrically driven gyro
No

 

 

[TURN_INDICATORS]

This section controls the cockpit glass cockpit display turn indicators. Available parameters are:

 

Parameter Description Type Required
turn_indicator.N

This parameter requires two values which define the system on which the turn indicators are dependent. The first value is for turn, the second for bank, and they should be set to one of the following values:

  1. 0 = none
  2. 1 = Vacuum driven gyro
  3. 2 = Electrically driven gyro

. For example:

turn_indicator.0 = 1,1

You can define multiple turn indicators where N starts at 0 and going up to number-of-indicators - 1.

1D Table of Floats

(see Data Types for more information)

No

 

[DIRECTION_INDICATORS]

This section controls the glass cockpit display direction indicators, not including the magnetic compass. Available parameters are:

 

Parameter Description Type Required
direction_indicator.N Sets the type of indicator. If the indicator is type 4, then there must be two entries separated by a comma - the indicator, and the indicator to which this one is slaved.

Integer

or

1D Table of Integers

(see Data Types for more information)

  1. 0 = None
  2. 1 = Vacuum gyro
  3. 2 = Electric gyro
  4. 3 = Electro-mag slaved compass
  5. 4 = Slaved to another indicator
No
induction_compass.N Defines 1 or more induction compasses, where N starts at 0 and goes up to compass-number - 1.

Integer:

  1. 1 = Electric
  2. 2 = Anemometer driven
No

 

 

[AIRSPEED_INDICATORS]

This section is used to define the characteristics of the different airspeed indicators on the instrument panel, where these characteristics define the calibration between calibrated airspeed and indicated airspeed.

 

Available parameters are:

 

Parameter Description Type Required
airspeed_indicator.N

This is a two value table used to define airspeed indicator N. The first parameter in the table is a scalar on the calibrated airspeed, and the second is an offset in Knots, where the offset is applied first, then the scalar. By default the value for the scalar is 1.0 and the offset is 0.0. This means that by default the indicated airspeed will be equal to calibrated airspeed.

There can be multiple entries for this parameter, one for each indicator, with N starting at 0 going up to number of indicators - 1.

1D Table of Floats

(see Data Types for more information)

Yes

 

 

[ALTIMETERS]

This section can be used to instantiate cockpit altimeters and set their position. Available parameters are:

 

Parameter Description Type Required
altimeter.N

When set to TRUE (1), this will instantiate an altimeter, which will operate independently of other altimeters, and can have failures applied to it. There can be multiple entries for this parameter, one for each altimeter, with N starting at 0 going up to number of altimeters - 1.

IMPORTANT! when referencing any altimeter using the appropriate SimVars (for example KOHLSMAN_SETTING_HG) the SimVar index starts at 1 not 0. So altimeter.0 is accessed by SimVar:1, altimeter.1 is SimVar:2, etc...

Boolean Yes
altimeter_position.N Sets the position of the altimeter N on the aircraft control panel using a table of values formatted as: Lateral, Vertical, Longitudinal. Values are relative to the Datum Reference Point. There can be multiple entries for this parameter, one for each altimeter, with N starting at 0 going up to number of altimeters - 1.

1D Table of Floats

(see Data Types for more information)

Yes

 

 

[ANEMOMETERS]

This section controls the position of the cockpit anemometers. Available parameters are:

 

Parameter Description Type Required
anemometer.N Sets the position of the anemometer N on the aircraft control panel using a table of values formatted as: Lateral, Vertical, Longitudinal. Values are relative to the Datum Reference Point. There can be multiple entries for this parameter, one for each anemometer, with N starting at 0 going up to number of anemometers - 1.

1D Table of Floats

(see Data Types for more information)

Yes

 

 

[MAGNETICCOMPASS]

This section controls the cockpit magnetic compass. Available parameters are:

 

Parameter Description Type Required
compass.0 Set to 1 for a vertical compass (with no dip errors). Bool No

 

 

[GPWS]

This section controls the cockpit GPWS. Available parameters are:

 

Parameter Description Type Required
max_warning_height The height below which a warning is activated, in ft. Float Yes
sink_rate_fpm If an aircraft exceeds this rate of descent (in ft per minute) a warning is activated. Float Yes
excessive_sink_rate_fpm If an aircraft exceeds this rate of descent (in ft per minute) an urgent warning is activated. Float Yes
climbout_sink_rate_fpm If an aircraft starts to descend during takeoff, and exceeds this rate of descent (in ft per minute), a warning is activated. Float Yes
flap_and_gear_sink_rate_fpm If an aircraft is landing, and exceeds this rate of descent (in ft per minute) without flaps or gear extended, a warning is activated. Float Yes

 

 

[THROTTLE_LEVELS]

This section controls the cockpit throttle levels. Available parameters are:

 

Parameter Description Type Required
level_1_min

Set the minimum throttle percentage for each detent and the corresponding name. For example, for the A320, level 1 is -100 REV, level 2 is 0 IDLE, etc...

Available names are:

  • "REV" - reverse
  • "IDLE" - idle
  • "A/THR" - auto
  • "CL" - climb
  • "FLX" - flex
  • "TOGA" - toga

Default level is 0. Default name is "".

Float Yes
level_1_name String Yes
level_2_min Float Yes
level_2_name String Yes
level_3_min Float Yes
level_3_name String Yes
level_4_min Float Yes
level_4_name String Yes
level_5_min Float Yes
level_5_name String Yes
level_6_min Float Yes
level_6_name String Yes

 

 

[FLAPS_LEVELS]

This section controls the cockpit flaps levels. Available parameters are:

 

Parameter Description Type Required

slats_level_1

to

slats_level_10

The slats/flaps angle for each level in the flaps lever levels (in degrees).

Default values for both slats and flaps at all levels is 0.

Float No

flaps_level_1

to

flaps_level_10

Float No
slats_level_full Float No
flaps_level_full Float No

 

 

[MISC]

This section controls certain HUD elements that will be visible when the user is in "3rd person mode" as well as the style that will be used to display them. Available parameters are:

 

Parameter Description Type Required
g_meter

When set to 1 (TRUE) a G-meter will be displayed on the external HUD, and if set to 0 (FALSE), none will be displayed.

Default value is (FALSE).

Bool No
vcockpit_hud

This can be set to 1 (TRUE) to have a "vcockpit-style" external HUD, or it can be set to 0 (FALSE) to have a "steamgauge-style" external HUD.

Default value is (FALSE).

Bool No
hud_airspeed_color_from_lvar

When defining your aircraft, you can select this option to set custom colours for the airspeed indicator using local variables, meaning that these colours can be changed dynamically using the using the "L:" var identifier in Reverse Polish Notation. For more information, please see here: HUD_Airspeed_Colour_from_Lvar.

NOTE: This option is only applicable when the vcockpit_hud is set to 1 (TRUE).

Bool No
hud_show_fuel

When set to 1 (TRUE) the HUD will display the fuel meter.

Default value is 1 (TRUE).

Bool No
hud_show_aoa

When set to 1 (TRUE) the HUD will display the AoA indicator.

Default value is 1 (TRUE).

Bool No
hud_show_variometer

When set to 1 (TRUE) the HUD will display the variometer. Note that this is only used by gliders, and will only show 0 for all other aircraft.

NOTE: This option is only applicable when the vcockpit_hud is set to 0 (FALSE).

Default value is 0 (FALSE).

   
hud_show_tachometer

When set to 1 (TRUE) the HUD will display the tachometer. Note that visually this will change depending on whether the vcockpit_hud option is true or not.

Default value is 1 (TRUE).

Bool No
hud_show_trim

When set to 1 (TRUE) the HUD will display the fuel meter.

Default value is 1 (TRUE).

Bool No
hud_speed_in_mach

When set to 1 (TRUE) a mach speed will always be displayed on the external HUD, and if set to 0 (FALSE), then it won't be displayed.

NOTE: This option is only applicable when the vcockpit_hud is set to 1 (TRUE).

Default value is 0 (FALSE).

Bool No
hud_helicopter_mode

When set to 1 (TRUE) the tachometer will be displayed in a way more appropriate for helicopter.

NOTE: This option is only applicable when the vcockpit_hud is set to 0 (FALSE).

Default value is 0 (FALSE).

Bool No
equivalent_airspeed_hud

When this is is set to 1 (TRUE), airspeed will be shown as EAS., instead of IAS when 0 (FALSE).

NOTE: This option is only applicable when the vcockpit_hud is set to 1 (TRUE).

Default value is 0 (FALSE).

Bool No
hud_navy_aoa

This can be used to enabled (1, TRUE) or disable (0, FALSE) the navy-style AoA indicator.

NOTE: This option is only applicable when the vcockpit_hud is set to 1 (TRUE).

Default value is 0 (FALSE).

Bool No
gps_altimeter_hud

This can be used to enable (1, TRUE) or disable (0, FALSE) using GPS for the altitude indicator instead of the indicated altitude value (based on air pressure).

NOTE: This option is only applicable when the vcockpit_hud is set to 1 (TRUE).Default value is 0 (FALSE).

Bool No

 

 

[TAKEOFF_SPEEDS]

This section controls . Available parameters are:

 

Parameter Description Type Required
take_off_speed_min_val Default value is 0. Integer No
take_off_speed_max_val Default value is 0. Integer No
take_off_speed_min_weight Default value is 200. Integer No
take_off_speed_max_weight Default value is 1000000. Integer No

 

 

Glass Cockpit Settings Struct

The contents of the cockpit.cfg file can be accessed from HTML gauges using JavaScript. In this case the returned value will be a struct (of the GlassCockpitSettings unit type) with the following contents:

 

Parameter Description
FuelFlow ColorRangeDisplay Struct
FuelQuantity ColorRangeDisplay2 Struct
FuelTemperature ColorRangeDisplay3 Struct
FuelPressure ColorRangeDisplay3 Struct
OilPressure ColorRangeDisplay3 Struct
OilTemperature ColorRangeDisplay3 Struct
EGTTemperature ColorRangeDisplay2 Struct
CHTTemperature ColorRangeDisplay2 Struct
Vacuum ColorRangeDisplay Struct
ManifoldPressure ColorRangeDisplay Struct
AirSpeed ColorRangeDisplay4 Struct
Torque ColorRangeDisplay2 Struct
RPM ColorRangeDisplay2 Struct
TurbineNG ColorRangeDisplay2 Struct
TurbineN1 ColorRangeDisplay2 Struct
TurbineN2 ColorRangeDisplay2 Struct
ITTEngineOff ColorRangeDisplay3 Struct
ITTEngineOn ColorRangeDisplay3 Struct
MainBusVoltage ColorRangeDisplay3 Struct
HotBatteryBusVoltage ColorRangeDisplay3 Struct
BatteryBusAmps ColorRangeDisplay2 Struct
GenAltBusAmps ColorRangeDisplay2 Struct
CoolantLevel RangeDisplay Struct
CoolantTemperature ColorRangeDisplay3 Struct
GearOilTemperature ColorRangeDisplay2 Struct
CabinAltitude ColorRangeDisplay Struct
CabinAltitudeChangeRate RangeDisplay Struct
CabinPressureDiff ColorRangeDisplay Struct
ThrottleLevels ThrottleLevelsInfo
FlapsLevels FlapsLevelsInfo
TakeOffSpeeds TakeOffSpeedsInfo
Misc GlassCockpitMisc

 

RangeDisplay Struct
Parameter Default Value Type
__Type

"RangeDisplay"

String
Initialized

true

Boolean
min

0

Float
max

0

Float
lowLimit

0

Float
highLimit

0

Float

 

ColorRangeDisplay Struct
Parameter Default Value Type
__Type

"ColorRangeDisplay"

String
Initialized

true

Boolean
min

0

Float
max

0

Float
lowLimit

0

Float
highLimit

0

Float
greenStart 0 Float
greenEnd 0 Float

 

ColorRangeDisplay2 Struct
Parameter Default Value Type
__Type

"ColorRangeDisplay2"

String
Initialized

true

Boolean
min

0

Float
max

0

Float
lowLimit

0

Float
highLimit

0

Float
greenStart 0 Float
greenEnd 0 Float
yellowStart

0

Float
yellowEnd

0

Float
redStart 0 Float
redEnd 0 Float

 

ColorRangeDisplay3 Struct
Parameter Default Value Type
__Type

"ColorRangeDisplay3"

String
Initialized

true

Boolean
min

0

Float
max

0

Float
lowLimit

0

Float
highLimit

0

Float
greenStart 0 Float
greenEnd 0 Float
yellowStart

0

Float
yellowEnd

0

Float
redStart 0 Float
redEnd 0 Float
lowRedStart

0

Float
lowRedEnd

0

Float
lowYellowStart 0 Float
lowYellowEnd 0 Float

 

ColorRangeDisplay4 Struct
Parameter Default Value Type
__Type

"ColorRangeDisplay4"

String
Initialized

true

Boolean
min

0

Float
max

0

Float
lowLimit

0

Float
highLimit

0

Float
greenStart 0 Float
greenEnd 0 Float
yellowStart

0

Float
yellowEnd

0

Float
redStart 0 Float
redEnd 0 Float
whiteStart 0 Float
whiteEnd 0 Float

 

ThrottleLevelsInfo
Parameter Default Value Type
__Type

"ThrottleLevelsInfo"

String
Initialized

true

Boolean
minValues [0, 0, 0, 0, 0]

Array

(Floats)

names ["", "", "", "", ""]

Array

(Strings)

 

FlapsLevelsInfo
Parameter Default Value Type
__Type

"FlapsLevelsInfo"

String
Initialized

true

Boolean
slatsAngle [0, 0, 0, 0]

Array

(Floats)

flapsAngle [0, 0, 0, 0]

Array

(Floats)

 

TakeOffSpeedsInfo
Parameter Default Value Type
__Type

"FlapsLevelsInfo"

String
Initialized

true

Boolean
minVal 0 Float
minWeight 0 Float
maxVal 200 Float
maxWeight 1000000 Float

 

GlassCockpitMisc
Parameter Default Value Type
__Type

"GlassCockpitMisc"

String
Initialized

true

Boolean
hasGMeter false Boolean