GAUGE: HSI Multifunction Gauge
Gauge v2.6.000 - Current Version 9th Feb 2024

Features:
1) Compass
2) Heading bug set on right dial
3) CRS set on left dial with ILS indicator
4) Glide slope indicator
5) VOR & ADF Pointers
6) MAP and ATC buttons
7) Lighting changes with panel lights
8) Mini Menu
9) Built in Side Buttons
10) AP APR Toggle
11) To/From Flags operational
12) Brightness Control (Physical FIP)
13) Variable toggle to turn off ADF/VOR1/VOR2
 
Softcoded:
CDI (Default: NAV CDI:1)
GSI (Default: NAV GSI:1)
CRS (Default: NAV OBS:1)
Heading Bug (Default: Autopilot heading lock dir)
Heading Bug (Alternativves: PMDG 737: [ngx_HDGWindow])

Aircraft Compatibility:
Simulator: Fully Compatible
3rd Party: Fully Compatible
Please report any 3rd Party incompatibility via our discord channel

Buttons & Dials Summary:
[S1] Menu:
[S6] ATC:
[L Dial] CRS and Menu Value -/+ CRS and Menu Value:
[R Dial] HDG and Menu Function -/+ HDG and Menu Function:

About HSI Multifunction Gauge:
The HSI Gauge (Horizontal Situation Indicator) is another essential navigation gauge that combines a heading indicator with a VHF omnidirectional range-instrument landing system (VOR-ILS) display.
 
The left dial operates the CouRSe (CRS) needle and the Right dial operates the heading bug used by the autopilot. There are various indicators including ADF & VOR pointers Glide slope Needles etc
 
There are heading and distance values shown digitally on the left should you opt not to use the optional side buttons.
 
Because both dials are used for gauge functions the HSI gauges uses [S1] to activated and deactivate the menu.

The Main Gauge:
CDI and GSI have been softcoded to provide 3rd party compatibility. Open the scripts found anchored to the [S1] Button (Double Click on them one at a time) and edit the right hand variable. You must change the SIMCONNECT Variable on BOTH the Condition AND the Action. Repeat for the other script. Do NOT change the lead FG_HSI_NAV_xxx variable entries.
 
Condition: FG_HSI_NAV_CDI (Session) unequal NAV CDI:1
Action: Set FG_HSI_NAV_CDI (Session) to value of NAV CDI:1
 
Condition: FG_HSI_NAV_GSI (Session) unequal NAV GSI:1
Action: Set FG_HSI_NAV_GSI (Session) to value of NAV GSI:1
 
Condition: FG_HSI_NAV_CRS (Session) unequal NAV OBS:1
Action: Set FG_HSI_NAV_CRS (Session) to value of NAV OBS:1
 
Condition: FG_HSI_NAV_HEADING_BUG (Session) unequal AUTOPILOT HEADING LOCK DIR
Action: Set FG_HSI_NAV_HEADING_BUG (Session) to value of AUTOPILOT HEADING LOCK DIR
 
To hide any of the navigation pointers toggle the following variables:
 
FG_HSI_HIDE_ADF (Profile)
     Toggle ADF pointer visible (0 = Shown, 1 Hide)
 
FG_HSI_HIDE_VOR1 (Profile)
     Toggle VOR1 pointer visible (0 = Shown, 1 Hide)
 
FG_HSI_HIDE_VOR2 (Profile)
     Toggle VOR2 pointer visible (0 = Shown, 1 Hide)

The Sidebar:
If the blanking plate is used instead of the sidebar, then colour of the plate can now be changed by editing variable [FG_GLOBAL_BLANKING_COLOUR] in SPAD.neXt data monitor.

Variables:
FG_HSI_MENU (Session)
     Menu Item Index (0 to 8)
     0 = Menu Closed
     1 = Version & Info
     2 = Side Buttons
     3 = AP APR On/Off
     4 = Glass Reflections
     5 = Background Colour
     6 = LCD - LED - CUSTOM Colours
     7 = Brightness Control
     8 = Panel Lights control
 
FG_HSI_HIDE_ADF (Profile)
     Toggle ADF pointer visible (0 = Shown, 1 Hide)
 
FG_HSI_HIDE_VOR1 (Profile)
     Toggle VOR1 pointer visible (0 = Shown, 1 Hide)
 
FG_HSI_HIDE_VOR2 (Profile)
     Toggle VOR2 pointer visible (0 = Shown, 1 Hide)
 
FG_HSI_BUTTONS (Profile)
     Side Buttons (Off = 0, On = 1)
  
FG_HSI_LABELS (Profile)
     Side Button Labels (Off = 0, On = 1)
  
FG_HSI_INSTRUCTIONS (Session)
     Instructions Page (Off = 0,
   
FG_PROFILE_LED_COLOUR_FORE_ON (Profile)
     Foreground colour of fonts while power is on (default = "#dd0000")
 
FG_PROFILE_LED_COLOUR_BACK_ON (Profile)
     Background colour of fonts while power is on (default = "#000000")
 
FG_PROFILE_LED_COLOUR_FORE_OFF (Profile)
     Foreground colour of fonts while power is off (default = "#000000")
 
FG_PROFILE_LED_COLOUR_BACK_OFF (Profile)
     Background colour of fonts while power is off (default = "#000000")
 
FG_PROFILE_LED_COLOUR_FORE_ON_CUSTOM (Profile)
     Foreground colour of fonts while power is on (default = "#00DD00")
 
FG_PROFILE_LED_COLOUR_BACK_ON_CUSTOM (Profile)
     Background colour of fonts while power is on (default = "TRANSPARENT")
 
FG_PROFILE_LED_COLOUR_FORE_OFF_CUSTOM (Profile)
     Foreground colour of fonts while power is off (default = "#001100")
 
FG_PROFILE_LED_COLOUR_BACK_OFF_CUSTOM (Profile)
     Background colour of fonts while power is off (default = "TRANSPARENT")
 
FG_VARIABLES_LEDCOLOUR (Profile)
     Side panel LED Style Index (1 - 3)
     1 = LED Style
     2 = LCD Style (Default)
     3 = Custom
   
[S1] SCRIPTED CUSTOM VARIABLE MAPPINGS:
FG_HSI_NAV_CDI (Session)
FG_HSI_NAV_GSI (Session)
FG_HSI_NAV_HEADING_BUG (Session)
FG_HSI_NAV_CRS (Session)
 
SIMCONNECT Vars Used:
NAV obs:1,degrees
AUTOPILOT HEADING LOCK DIR,degrees
Plane heading degrees magnetic,degrees
NAV DME:1,nmiles
Plane heading degrees magnetic,radians
NAV TOFROM:1,enum
NAV obs:1,radians
NAV CDI:1,number
AUTOPILOT APPROACH HOLD,bool
AUTOPILOT GLIDESLOPE HOLD,bool
ADF SIGNAL:1,number
ADF radial:1,radians
NAV HAS NAV:1,bool
NAV RADIAL:1,radians
NAV HAS NAV:2,bool
NAV radial:2,radians
Autopilot heading lock dir,radians
NAV GSI:1,number
 
fipgauges.com GLOBAL VARIABLES:
(not all vars used in every gauge)
 
FG_GLOBAL_DIAL_SPEED (Session)
     Variable used for dial acceleration (Off = 0, On = 1)
 
FG_GLOBAL_GAUGE_BRIGHTNESS (Profile)
     Brightness value of physical FIP's. Affects all physical gauges (20-250)
 
FG_GLOBAL_GLASS (Profile)
     Glass Reflection (Off = 0, On = 1)
 
FG_GLOBAL_HIDE_MENU_LED (Profile)
     Toggle visibility of Mini Menu LED (0 = On, 1 = Off)
 
FG_GLOBAL_JET_COLOUR (Profile)
     Background Colour (0 to 3)
     1 = Grey panel with grey gauge face
     2 = Blue grey panel with grey gauge face
     3 = Dark grey panel with black gauge face
     4 = Dark blue panel with black gauge face.  
 
FG_GLOBAL_JET_BACKGROUND_COLOUR (Profile)
     Background Colour (Black = 0, Blue = 1 )
 
FG_GLOBAL_MIN_VOLTAGE (Profile)
     Minimum voltage before gauge electronics turns off (-1 to 150)
     -1 = Disabled
     0 - 150 = Off Voltage Level
 
FG_GLOBAL_MIN_VOLTAGE_CACHE (Profile)
     Internal Variable - Used to store off voltage value - do not edit
  
FG_GLOBAL_PANEL_LIGHTS (Profile)
     Night Lit Mode (Off = 0, On = 1)
 
FG_GLOBAL_PRESSURE (Profile)
     Shared variable for switching inHg and MB (0 to 1)
     0 = inHg
     1 = Millbars
 
FG_GLOBAL_STYLE (Profile)
  Background Colour (0 to 6)
     0 = Grey
     1 = Black Dial Face
     2 = Darker Gauge & Dial Face
     3 = Black & No Gauge GFX
     4 = Grey - Original Design
     5 = Black Dial Face - Original Design
     6 = Darker Gauge & Dial Face - Original Design
   
FG_GLOBAL_VOLTAGE (Session)
     Internal variable used to read current voltage
 
FG_GLOBAL_BLANKING_COLOUR (Profile)
     Text Variable used to set blanking plate colour

Release Notes:
2.6.000
     1) SPAD.neXt 0.9.15 Compatibility (Convert "PRESS" to "PRESSSHORT") Fixes short and long press both firing on long press.
     2) Menu system upgraded
     3) New gauge brightness code using SPAD brightness variables.
     4) Can control global or individual gauge brightness in gauge (Profile saved settings)
     5) Better use of button lights
     6) Added Custom Colour for blanking plate - Edit colour index for variable FG_GLOBAL_BLANKING_COLOUR
2.5.001 - Add new Hide ADF/VOR1/VOR2 pointer variables (see Manual)
2.5.000 - SPAD.neXt 0.9.13 Compatibility (Author ID)
     - 1) Added Softcoded CDI & GSI Scripts for 3rd Party Aircraft.
     - 2) New Custom Virtual Power supports ALL aircraft volt variables - See https://fipgauges.com/customfeatures.php
2.4.003 - Added sidebar blanking plate option
2.4.002 - Virtual Power Warning added to Menu
2.4.001 - Changed ILS localiser and Glide Slope Variables (More compatible)
2.4.000 - Added New Gauge Design and Panel Lighting control in Mini Menu
2.3.003 - Changed heading from gyro to magnetic
2.3.002 - Support for NEW 4 colour hue panel lights.
2.3.001 - Tweaked voltage monitoring to better support MSFS2020. Added Monitoring for Battery Bus
2.3.000 - SPAD.neXt 0.9.7.x Custom LED Foreground and Background Colours.
2.2.003 - Automatic Dial Acceleration added to CRS and HDG. Added Bug to Digital Display
2.2.002 - Added Brightness Control to Mini Menu
2.2.001 - PMDG 737 and 747 compatibility added [S2] toggle compatibility mode
2.2.000 - Panel Lights now controlled by local variable (FG_GLOBAL_PANEL_LIGHTS) 0=Off 1=On
2.1.002 - VOR1, VOR2 and ADF pointers only displayed when signal is received for each.
2.1.001 - Resized Text to become compliant with SPAD.neXt scaling changes.
2.0.000 - New colour schemes available in mini menu.
1.3.004 - TO/FROM now working (N/A ILS)
1.3.003 - SPAD.neXt offset compliancy changes (legacy code no longer supported)
1.3.002 - Unpublished & Undocumented changes
1.3.001 - Fixed bug turning glass off and fixed Blue LED Home position
1.3.000 - Improved graphics with shadows and transparency, Optional glass reflections.
1.2.002 - Panel Lights graphics glitch fixed
1.2.001 - Small bug fix where CRS = "360" and not "000"
1.2.000 - SPAD Enhanced with Mini Menu, Built in Side Buttons. Electric powered indicators off when no voltage.
1.1.000 - Lighting changes with panel lights
1.0.000 - Digital HSI side gauge added

Please report any bugs or feature requests via our discord channel


Document Published 09/02/2024

Copyright fipgauges.com 09/02/2024