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:
|
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:
. For example: turn_indicator.0 = 1,1 You can define multiple turn indicators where N starts at |
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)
|
No |
induction_compass.N |
Defines 1 or more induction compasses, where N starts at 0 and goes up to compass-number - 1 . |
Integer:
|
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 |
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 IMPORTANT! when referencing any altimeter using the appropriate SimVars (for example |
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:
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 |
---|---|---|---|
to
|
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 |
to
|
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 " NOTE: This option is only applicable when the |
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 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 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 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 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 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 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 |
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:
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 |