Fenix2GSX

<img src="img/icon.png" width="196"><br/> Full and proper GSX Integration and Automation for the Fenix A320 (all Variants, so including the 319/321)! <br/>

• The Refuel Service is filling the Tanks as planned (or more correctly GSX and Fenix are "synched")
• Calling Boarding load's Passengers and Cargo, as does Deboarding for unloading (or more correctly GSX and Fenix are "synched")
• Ground Equipment (GPU, Chocks, PCA) is automatically set or removed
• All Service Calls except Pushback, De-Ice and Gate-Selection can be automated
• Using the INT/RAD Switch as a Shortcut for certain GSX Interactions (i.e. call / confirm Pushback)
• GSX Audio and ATC Volume can be controlled via the INT/VHF1-Knob from the ACP in the Cockpit
• Applications can be freely mapped to Audio-Channels
• Can be used, within certain Limits, with the native Integration
• Supports to use the Volume Control without having GSX installed or running (or to solely use the native Integration)

<br/><br/>

1 - Introduction

1.1 - Requirements

• Windows 10/11, MSFS 2020/2024, Fenix latest :wink:
• A properly working and updated GSX Installation
• Capability to actually read the Readme up until and beyond this Point :stuck_out_tongue_winking_eye:
• The Installer will install the following Software automatically:
  • .NET 8 Desktop Runtime (x64) - Reboot your System if it was installed for the first Time

<br/>

Download here

(Under Assests, the Fenix2GSX-Installer-vXYZ.exe File) <br/>

1.2 - Installation, Update & Removal

Just Download & Run the Installer Binary! It will check and install all Requirements the App (or remove it). Your existing Configuration persists through Updates.<br/> On the second Installer Page you can select if Auto-Start should be set up for Fenix2GSX (recommended for Ease of Use).<br/> You do not need to remove the old Version for an Update (unless instructed) - using 'Remove' in the Installer completely removes Fenix2GSX and removes it from Auto-Start. This also removes your Configuration including Aircraft Profiles and saved Fuel!<br/><br/>

It is highly likely that you need to Unblock/Exclude the Installer & App from BitDefender and other AV-/Security-Software.<br/> DO NOT run the Installer or App "as Admin" - it might work, it might fail.<br/><br/>

When Upgrading from Versions before 0.5.0:

• Remove the old Version first (with the new Installer)!
• You only need to backup your old Config if you want to go back (the old and new Config Formats are incompatible)
• The MobiFlight Module is not required anymore, the Installer will offer an Option to remove it - if MF Connector and PilotsDeck are not detected.
• Even then it is your Responsibility to know if the MobiFlight Module is not required for other Addons on your System and safe to remove!

<br/>

Fenix2GSX will display a little Exclamation Mark on its SysTray/Notification Area Icon if a new Version (both Stable and Development) is available. There is no Version Pop-Up and there will never be. <br/><br/>

1.3 - Auto-Start

When starting it manually, please do so when MSFS is loading or in the Main Menu.<br/> To automatically start it with FSUIPC or MSFS, select the respective Option in the Installer. Just re-run it if you want to change if and how Fenix2GSX is auto started. Selecting one Option (i.e. MSFS) will also check and remove Fenix2GSX from all other Options (i.e. FSUIPC), so just set & forget.<br/> For Auto-Start either your FSUIPC7.ini or EXE.xml (MSFS) is modified. The Installer does not create a Backup (not deemed neccessary), so if you want a Backup, do so yourself.<br/><br/>

1.3.1 - Addon Linker

If you use Addon Linker to start your Addons/Tools, you can also add it there:<br/> Program to launch C:\Users\YOURUSERNAME\AppData\Roaming\Fenix2GSX\bin\Fenix2GSX.exe<br/> Wait for simconnect checked<br/> The Rest can be left at Default. <br/><br/>

1.4 - Release & Dev/Beta Versions

There are two Version Channel for Updates to be released:

1. The "Dev" or "Beta" Version is located in the Source Files as Fenix2GSX-Installer-latest<br/> (Click 'View Raw' or the Download Icon to the Right to download)
2. The "Release" or "Stable" Version is located under Releases<br/> (Under Assests, the Fenix2GSX-Installer-vXYZ.exe File)

Whenever there is a new Commit to Code, the -latest Installer will contain these Changes (the Description of the Commit(s) summarizes what has changed). For example Fixes to open Issues, Changes for Fenix or GSX Updates or new Features added. So that these Changes & Fixes can be tested publicly.<br/> After some Time and positive/good Feedback, all these Changes will be published as the Release Version.<br/> So some general Rule-of-Thumbs:

• Most Users should use the Release Version
• If experiencing an Issue, then try if the Dev Versions works better
• When eager to test new Stuff as soon as possible, you're welcome to use the Dev Version, as long as you understand it as something that is being worked on 😉

<br/><br/><br/>

2 - Configuration

2.1 - Fenix EFB

Make sure your Default State is set to either Cold & Dark or Turn-Around with GPU or APU - GSX won't provide any Services when the Engines are running.<br/> All other relevant EFB Options will automatically be disabled by Fenix2GSX (including Audio Mappings). Note that they are not re-enabled!<br/>

<br/><br/>

2.2 - GSX Pro

• Make sure you do not have a customized Aircraft Profile (GSX In-Game Menu -> Customize Aircraft -> should show as used Profile "Developer provided" or "Internal GSX Database"). A fair Chunk of Problems come from People having an outdated Custom Profile without knowing it. Just hit the "Reset" Button in the Customize Aircraft Dialog to delete the custom Profile (needs to be done on each Variant!)
• It is recommended (but not required) to enter your SimBrief Username and have Iore Time checked to have correct Information on the VDGS Displays.
• For Automated staircases semi-automatic (half-checked) is recommended - but it should work with all Modes.
• It is not recommended to use the Always ask for pushback Option (and if you use it: Fenix2GSX will default to auto-answer with 'Yes')
• The De-/Boarding Speed of Passengers is dependant on the Passenger Density Setting (GSX In-Game Menu -> GSX Settings -> Timings). Higher Density => faster De/Boarding (But "Extreme" can be to extreme in some Cases).
• Ensure the other two Settings under Timings are on their Default (15s, 1x).
• As with GSX itself, Fenix2GSX runs best when you have a proper Airport Profile installed!
• Some Users have reported they also need to disable Estimate passengers number.
• Up to everyone's Preference, but disabling the Aural Cues (GSX In-Game Menu -> GSX Settings -> Audio) and setting Message verbosity to "only Important" (GSX In-Game Menu -> GSX Settings -> Simulation) can improve Immersion! 😉

<br/><br/>

2.3 - Fenix2GSX

The Configuration is done through the GUI, open it by clicking on the System-Tray/Notification-Icon. You do not need to configure anything to start using Fenix2GSX - although it is recommended to get yourself familiar with the Settings. Change them to your Preferences in order to improve your Experience. The default Settings aim to maximize Automation respectively minimize GSX Interaction. All Options have ToolTips to explain them further.<br/> Everything is stored persistently in the AppConfig.json File in the Application's Folder - so backup that File in order to backup your Settings!<br/>

<br/><br/> <img src="img/ui.png"><br/><br/> Allmost all Settings regarding GSX, Fenix and the general Automation can be found in the 'Automation' View. All Settings in this View are stored in a Profile.<br/> You can have many different Profiles which are automatically loaded depending on the current Aircraft's Registration, Title or Airline. To manage these Profiles use the 'Aircraft Profiles' View.<br/> In order map Applications to the different ACP Audio Channels, use the 'Volume Control' View. The Volume Control Settings are global - thay apply to all Profiles. Volume Control is generally independent from the GSX Integration/Automation.<br/> All central Settings regarding the Application (so applying to all Profiles) are found in the 'App Settings' View.<br/><br/> Most Settings can be changed dynamically on the Fly, BUT: only change Settings not relevant in the current Automation/Flight Phase. For Example do not change the Departure Services in the Departure Phase and do not change Profiles while Services are active.<br/><br/> In general, it is up to your Preference how much Automation you want. I you want to keep Control of when Services are Called and/or the Jetway is connected, you can still enjoy the (De-)Boarding and Refueling Syncronization when the Automation-Options are disabled. The only Automation which can not be disabled: The Removal of the Ground-Equipment is always active to assist with Departure & Push-Back and Arrival.

<br/><br/>

2.3.1 - Automation

These are basically the core Settings to customize the Automation to your own Service-Flow. All Settings in this View are associated to an Aircraft Profile. The currently loaded Profile's Name is displayed on the Category Selection.<br/> The Settings are grouped into different Categories:<br/><br/>

Gate & Doors

Handling if and when the Jetway and or the Stairs are called or removed.<br/> It also allows you to completely disable the Door Automation. But even then the Doors will automatically be closed when Pushbac