Troubleshooting: Difference between revisions

From FSFO Support Hub
No edit summary
 
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
Common setup, connectivity, and configuration issues for Flight Simulator First Officer (FSFO).
__NOTOC__
= FSFO Troubleshooting Guide =


<div style="margin:0.8em 0; padding:0.8em 1em; background:#eef3fb; border-left:6px solid #1f4fa3;">
Common setup, connectivity, speech recognition, aircraft-specific, and crash-reporting issues for '''Flight Simulator First Officer (FSFO)'''.
Use this page when something is not working as expected before contacting support.
 
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;">
<strong>Use this page first</strong> when FSFO is not working as expected. Most issues are caused by startup order, FSUIPC7 connection problems, missing LVARs, microphone permissions, or aircraft-specific configuration.
</div>
</div>


<div style="margin:0.6em 0; padding:0.8em 1em; background:#fdf7f2; border-left:6px solid #f0ad4e;">
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fdf7f2; border-left:6px solid #f0ad4e; border-radius:8px;">
Unless a section says otherwise, always start programs in this order: <strong>MSFS → FSUIPC7 → FSFO</strong>.
<strong>Recommended startup order:</strong><br />
Start programs in this order unless a section says otherwise:<br />
<strong>Microsoft Flight Simulator → FSUIPC7 → FSFO</strong>
</div>
</div>


<span id="top"></span>
<span id="top"></span>
----
----
== Page Appearance Guide ==
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;">
<strong>Blue boxes</strong> are used for general notes, explanations, and helpful background information.
</div>
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fdf7f2; border-left:6px solid #f0ad4e; border-radius:8px;">
<strong>Orange boxes</strong> are used for warnings, important requirements, or likely causes of a problem.
</div>
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#f4f9f6; border-left:6px solid #5cb85c; border-radius:8px;">
<strong>Green boxes</strong> are used for confirmed fixes, required configuration entries, or values the user should copy exactly.
</div>
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fbfcff; border-left:6px solid #1f4fa3; border-radius:8px;">
<strong>Path boxes</strong> are used for Windows folder paths, configuration files, and other technical locations.
</div>
----
= Quick Navigation =
* [[#fsuipc-lvar-connection|FSUIPC7, LVAR, and Connection Issues]]
* [[#simulator-settings|Simulator Settings Issues]]
* [[#aircraft-specific|Aircraft-Specific Issues]]
* [[#speech-recognition|Speech Recognition and Microphone Issues]]
* [[#crashes|FSFO Crashes]]
* [[#support|Still Need Help?]]
----
<span id="fsuipc-lvar-connection"></span>
= FSUIPC7, LVAR, and Connection Issues =


== Copilot does not move any switches ==
== Copilot does not move any switches ==


<div style="margin:0.6em 0; padding:0.8em 1em; background:#fdf7f2; border-left:6px solid #f0ad4e;">
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fdf7f2; border-left:6px solid #f0ad4e; border-radius:8px;">
This usually indicates a communication issue between FSFO, FSUIPC7, and the aircraft LVAR system.
This usually means FSFO cannot properly communicate with FSUIPC7, the aircraft LVAR system, or the selected aircraft profile.
</div>
</div>


=== Step 1: Verify FSUIPC7 is connected ===
=== Step 1: Verify FSUIPC7 is connected ===


* Open the FSUIPC7 tray icon (system tray near the clock).
# Open the FSUIPC7 tray icon near the Windows clock.
* Right-click the icon and select '''Show'''.
# Right-click the icon.
* Confirm FSUIPC7 reports '''Connected''' and that LVARs are available.
# Select '''Show'''.
# Confirm FSUIPC7 reports '''Connected'''.
# Confirm LVARs are available.


[[File:FSUIPC7_Connected_Lvars.png|600x600px|FSUIPC7 showing connected state and available LVARs]]
[[File:FSUIPC7_Connected_Lvars.png|600x600px|FSUIPC7 showing connected state and available LVARs]]


<div style="margin:0.6em 0; padding:0.8em 1em; background:#fdf7f2; border-left:6px solid #f0ad4e;">
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fdf7f2; border-left:6px solid #f0ad4e; border-radius:8px;">
If the LVARs are missing (0 Lvars); please go to Step 4
If LVARs show as missing or display as <strong>0 Lvars</strong>, go to [[#lvars-fail-to-load|Step 4: LVARs fail to load]].<br />
 
If the WASM menu is disabled or missing, go to [[#reinstall-fsuipc7|Step 5: Reinstall FSUIPC7 if needed]].
If the menu is disabled (WASM is missing), please go to Step 5
</div>
</div>


=== Step 2: Verify FSFO is connected to FSUIPC7 ===
=== Step 2: Verify FSFO is connected to FSUIPC7 ===


Before starting your flight, FSFO should display the connected FSUIPC7 version in the lower-left corner.
Before starting your flight, FSFO should show the connected FSUIPC7 version in the lower-left corner.


[[File:FSFO_FSUIPC_Status.png|450x450px|FSFO showing FSUIPC7 version in the status bar]]
[[File:FSFO_FSUIPC_Status.png|450x450px|FSFO showing FSUIPC7 version in the status bar]]


<div style="margin:0.6em 0; padding:0.8em 1em; background:#fdf7f2; border-left:6px solid #f0ad4e;">
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fdf7f2; border-left:6px solid #f0ad4e; border-radius:8px;">
If no version is shown, FSFO is not connected.
If no FSUIPC7 version is shown, FSFO is not connected to FSUIPC7.
</div>
</div>


=== Step 3: Confirm aircraft profile selection ===
=== Step 3: Confirm the aircraft profile and checklist ===


On the Start Flight page, ensure the correct Aircraft Profile and Checklist are selected.
# Open the FSFO Start Flight page.
# Confirm the correct '''Aircraft Profile''' is selected.
# Confirm the correct '''Checklist''' is selected.
# Start the flight.
# Confirm the active aircraft profile appears in the lower-left corner.


After starting the flight, the active aircraft profile appears in the lower-left corner.
[[File:FSFO_Aircraft_Profile.png|450x450px|Aircraft profile selection on Start Flight page]]


[[File:FSFO_Aircraft_Profile.png|450x450px|Aircraft profile selection on Start Flight page]]
<span id="lvars-fail-to-load"></span>


=== Step 4: LVARs fail to load: ===
=== Step 4: LVARs fail to load ===


# Make sure MSFS is fully loaded into the cockpit before starting FSFO.
# Make sure Microsoft Flight Simulator is fully loaded into the cockpit before starting FSFO.
# Confirm FSUIPC7 shows Connected to the simulator (step 1).
# Confirm FSUIPC7 shows '''Connected'''.
# If you are using a complex aircraft, give it extra time to finish loading its systems.
# If using a complex aircraft, give the aircraft extra time to finish loading its systems.
# Start FSFO '''AFTER''' FSUIPC7 is already connected.
# Start FSFO only after FSUIPC7 is already connected.
# If the issue continues, close everything and restart in this order:
# If the issue continues, close everything and restart in this order:
## Start MSFS and load into the cockpit.
## Start Microsoft Flight Simulator and load into the cockpit.
## Start FSUIPC7 and confirm it shows Connected WITH LVARS LOADED (step 1) .
## Start FSUIPC7 and confirm it shows '''Connected''' with LVARs loaded.
## Start FSFO last.
## Start FSFO last.


If the LVARs still do not load, adjust the FSUIPC WASM scan settings (last resort):
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;">
If LVARs still do not load, adjust the FSUIPC WASM scan settings. This should be treated as a last-resort troubleshooting step.
</div>


# Close MSFS, FSUIPC7, and FSFO.
==== Adjust FSUIPC WASM scan settings ====
# Open the FSUIPC_WASM.ini file in the WASM persistence/work folder.
 
# Do not edit the copy in the Community folder.
# Close Microsoft Flight Simulator, FSUIPC7, and FSFO.
# Open the <code>FSUIPC_WASM.ini</code> file in the WASM persistence/work folder.
# Do '''not''' edit the copy in the Community folder.
# Set the following values:
# Set the following values:
## LvarScanDelay=15 //Increase as needed...start with 15
 
## LvarScanFrequency=0
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#f4f9f6; border-left:6px solid #5cb85c; border-radius:8px;">
<pre>
LvarScanDelay=15
LvarScanFrequency=0
</pre>
</div>
 
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;">
<strong>What these settings do:</strong><br />
<code>LvarScanDelay=15</code> gives the aircraft more time to initialize before FSUIPC scans for LVARs.<br />
<code>LvarScanFrequency=0</code> disables repeated rescans, which may help if WASM is unstable or LVARs stop updating.
</div>


After saving the file, restart in this order:
After saving the file, restart in this order:


# Start MSFS and load into the cockpit.
# Start Microsoft Flight Simulator and load into the cockpit.
# Start FSUIPC7 and confirm it shows Connected.
# Start FSUIPC7 and confirm it shows '''Connected'''.
# Start FSFO last.
# Start FSFO last.


LVARs still fail to load, check whether the FSUIPC WASM module crashed (move to step 5)
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fdf7f2; border-left:6px solid #f0ad4e; border-radius:8px;">
What these edits do:
If LVARs still fail to load, check whether the FSUIPC WASM module is missing or has crashed. Continue to Step 5.
</div>


* LvarScanDelay=15 gives the aircraft more time to finish initializing before FSUIPC scans for LVARs.
<span id="reinstall-fsuipc7"></span>
* LvarScanFrequency=0 disables repeated rescans, which can help if the WASM is unstable or LVARs stop updating.


=== Step 5: Reinstall FSUIPC7 if needed ===
=== Step 5: Reinstall FSUIPC7 if needed ===
Line 86: Line 147:
If the steps above fail:
If the steps above fail:


# Close MSFS, FSFO, and FSUIPC7.
# Close Microsoft Flight Simulator, FSFO, and FSUIPC7.
# Reinstall the latest FSUIPC7 installer over the existing installation.
# Reinstall the latest FSUIPC7 installer over the existing installation.
# If problems persist, perform a clean FSUIPC7 reinstall:
# Restart Windows.
## Uninstall FSUIPC7.
# Start Microsoft Flight Simulator.
## Delete the FSUIPC7 install folder.
# Start FSUIPC7.
## Remove the FSUIPC WASM folder from the MSFS Community directory.
# Start FSFO.
## Reboot Windows.
## Download the latest FSUIPC7 from here: https://fsuipc.com/fsuipc7/
## Unzip and Install the FSUIPC7 as Administrator.
### Right-Click Install_FSUIPC7.exe and select "Run as administrator."
### Ensure you select the sims you use - MSFS2020 and/or MSFS2024 (see picture below)
### Ensure the WASM module is selected (see picture below)!


<div style="margin:0.6em 0; padding:0.8em 1em; background:#eef3fb; border-left:6px solid #1f4fa3;">
If problems continue, perform a clean FSUIPC7 reinstall:
After reinstall, start programs in this order:
 
# Uninstall FSUIPC7.
# Delete the FSUIPC7 install folder.
# Remove the FSUIPC WASM folder from the MSFS Community directory:
 
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fbfcff; border-left:6px solid #1f4fa3; border-radius:8px;">
<pre>
*\AppData\Local\Packages\Microsoft.FlightSimulator_8wekyb3d8bbwe\LocalCache\Packages\Community\fsuipc-lvar-module
</pre>
</div>
 
# Reboot Windows.
# Download the latest FSUIPC7 from:
#: https://fsuipc.com/fsuipc7/
# Unzip the installer.
# Right-click <code>Install_FSUIPC7.exe</code>.
# Select '''Run as administrator'''.
# Make sure you select the simulator version you use: MSFS 2020, MSFS 2024, or both.
# Make sure the WASM module is selected during installation.
 
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;">
After reinstalling, start programs in this order:
<ol>
<ol>
<li>Start MSFS and load into a cockpit.</li>
<li>Start Microsoft Flight Simulator and load into a cockpit.</li>
<li>Start FSUIPC7 and confirm it shows Connected.</li>
<li>Start FSUIPC7 and confirm it shows Connected.</li>
<li>Start FSFO last.</li>
<li>Start FSFO last.</li>
</ol>
</ol>
</div>
</div>
[[File:Select The Correct Sims.png|left|thumb]]


[[File:Fsuipc7Setup.png|center|thumb|800x800px|FSUIPC7 installer options]]


[[Troubleshooting#top|Back to top]]


----


== FSUIPC Error #12: FSUIPC_ERR_SENDMSG ==


<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fdf7f2; border-left:6px solid #f0ad4e; border-radius:8px;">
FSFO and FSUIPC7 must run at the same Windows permission level.
</div>


# Right-click FSFO.
# Select '''Properties → Compatibility'''.
# Check whether '''Run this program as an administrator''' is enabled.
# Repeat the same check for FSUIPC7.
# Make sure administrator mode is either enabled for both applications or disabled for both applications.
# Restart FSFO and FSUIPC7.


[[Troubleshooting#top|Back to top]]


[[File:Setup2.png|left|thumb]]
----


== FSUIPC Error #2 ==


<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fdf7f2; border-left:6px solid #f0ad4e; border-radius:8px;">
This error usually means FSFO could not complete the connection to FSUIPC7.
</div>


=== Common causes ===


* FSUIPC7 is not running.
* More than one FSUIPC7 instance is open.
* Antivirus or firewall software is blocking communication.
* FSUIPC7 was installed in a protected Windows folder.
* FSFO is trying to connect before Microsoft Flight Simulator and FSUIPC7 are fully loaded.


=== Quick restart sequence ===


# Close FSFO, FSUIPC7, and Microsoft Flight Simulator.
# Reboot Windows.
# Start Microsoft Flight Simulator and load fully into a cockpit.
# Start FSUIPC7 and confirm it is running.
# Start FSFO and click Connect.


=== Additional checks ===


# Make sure only one instance of FSUIPC7 is running.
# Check the system tray near the Windows clock.
# Temporarily disable Auto-Connect in FSFO and connect manually.
# Whitelist FSFO and FSUIPC7 in your antivirus and firewall software.
# Make sure Microsoft Flight Simulator, FSUIPC7, and FSFO are running at the same permission level.


=== Installation checks ===


* Do not install FSUIPC7 inside <code>Program Files</code> or other protected Windows folders.
* Install FSUIPC7 to a simple folder such as:


[[Troubleshooting#top|Back to top]]
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fbfcff; border-left:6px solid #1f4fa3; border-radius:8px;">
----
<pre>
C:\FSUIPC7
</pre>
</div>


== FSFO does not stay on top ==
* If needed, reinstall FSUIPC7 and restart the PC.
* After reinstalling, launch Microsoft Flight Simulator first, then FSUIPC7, then FSFO.
* If unresolved, perform a clean FSUIPC7 reinstall.


<div style="margin:0.6em 0; padding:0.8em 1em; background:#eef3fb; border-left:6px solid #1f4fa3;">
[[Troubleshooting#top|Back to top]]
This behavior is caused by Windows process-level restrictions.
</div>


Reasons:
----


* Windows prevents non-admin apps from staying above admin-level apps.
== WASM version mismatch ==
* Another application may re-assert its “Always on Top” flag after FSFO.


<div style="margin:0.6em 0; padding:0.8em 1em; background:#fdf7f2; border-left:6px solid #f0ad4e;">
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fdf7f2; border-left:6px solid #f0ad4e; border-radius:8px;">
Restarting FSFO reapplies its topmost flag, but FSFO cannot remain above an admin-level window unless it is also run as Administrator.
Example error:<br />
<code>WASM version X while WAPI expects Y</code>
</div>
</div>


Workaround:
=== Recommended fix ===


* Run FSFO and FSUIPC7 at the same permission level.
Reinstall the latest FSUIPC7 installer. The installer includes matching WASM and WAPI components.
* Or disable Always-On-Top in competing applications.


[[Troubleshooting#top|Back to top]]
=== Manual fix for advanced users ===
----
 
== FSUIPC Error #12 (FSUIPC_ERR_SENDMSG) ==


<div style="margin:0.6em 0; padding:0.8em 1em; background:#fdf7f2; border-left:6px solid #f0ad4e;">
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;">
FSFO and FSUIPC7 must run at the same permission level.
Use this only if reinstalling FSUIPC7 does not resolve the mismatch.
</div>
</div>


# Right-click FSFO and FSUIPC7.
# Close FSFO, Microsoft Flight Simulator, and FSUIPC7.
# Select Properties Compatibility.
# Go to:
# Ensure “Run as administrator” is either enabled for both or disabled for both.
#: https://www.fsuipc.com
# Restart both applications.
# Select '''Products All Products'''.
# Download the latest FSUIPC WASM Module and WAPI package.
# Open the downloaded ZIP file.
# Go to:


[[Troubleshooting#top|Back to top]]
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fbfcff; border-left:6px solid #1f4fa3; border-radius:8px;">
----
<pre>
FSUIPC_WAPI.zip > FSUIPC_WAPI > dll
</pre>
</div>


== FSUIPC Error #2 ==
# Copy:


<div style="margin:0.6em 0; padding:0.8em 1em; background:#fdf7f2; border-left:6px solid #f0ad4e;">
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fbfcff; border-left:6px solid #1f4fa3; border-radius:8px;">
This error indicates a failed or incomplete FSUIPC connection.
<pre>
FSUIPC_WAPID.dll
</pre>
</div>
</div>


=== Common Cause ===
# Paste it into the main FSFO V6 directory, where <code>FSFO_V6.exe</code> is located.
# Go back to the downloaded ZIP file.
# Copy the <code>fsuipc-lvar-module</code> folder.
# Paste it into your Microsoft Flight Simulator Community folder and overwrite the existing folder.


* FSUIPC7 is not running
[[Troubleshooting#top|Back to top]]
* More than one FSUIPC7 instance is open
* Antivirus or firewall is blocking communication
* FSUIPC7 was installed in a protected folder
* FSFO is trying to connect before MSFS and FSUIPC7 are fully loaded


=== Quick Restart Sequence ===
----


# Close FSFO, FSUIPC7, and MSFS.
<span id="simulator-settings"></span>
# Reboot Windows.
# Start MSFS and load fully into a cockpit.
# Start FSUIPC7 and confirm it is running.
# Start FSFO and click Connect.


=== Additional Checks ===
= Simulator Settings Issues =


# Ensure only one instance of FSUIPC7 is running (review your system tray).
== Copilot executes actions at incorrect altitudes ==
# Disable Auto-Connect in FSFO temporarily and connect manually.
# Whitelist FSFO and FSUIPC7 in antivirus and firewall software.
# Make sure MSFS, FSUIPC7, and FSFO are all running at the same permission level.


=== Installation Checks ===
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;">
 
This issue is usually caused by the simulator’s Units of Measurement setting being set to Metric.
* Do not install FSUIPC7 inside Program Files or other protected Windows folders.
</div>
* Install FSUIPC7 to a simple folder such as C:\FSUIPC7.
* If needed, reinstall FSUIPC7 and then restart the PC.
* After reinstalling, launch MSFS first, then FSUIPC7, then FSFO.
* If unresolved, perform a clean FSUIPC7 reinstall.
 
[[Troubleshooting#top|Back to top]]
----


== WASM version mismatch ==
When Microsoft Flight Simulator is set to Metric, altitude-related values may be reported or interpreted in meters instead of feet. FSFO expects altitude-related values to be in feet. If the simulator is using Metric units, the copilot may execute altitude-based actions too early or too late.


<div style="margin:0.6em 0; padding:0.8em 1em; background:#fdf7f2; border-left:6px solid #f0ad4e;">
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fdf7f2; border-left:6px solid #f0ad4e; border-radius:8px;">
Error example: “WASM version X while WAPI expects Y”.
If your simulator Units of Measurement setting is set to Metric, your copilot may perform some actions using meters instead of feet.
</div>
</div>


Recommended fix:
=== Fix ===


* Reinstall the latest FSUIPC7 installer, which includes matching WASM and WAPI components.
* '''MSFS 2024:''' Go to '''General Options → Language → Units of Measurement''' and change the setting to '''Hybrid'''.
* '''MSFS 2020:''' Go to '''General Options → MISC → Units of Measurement''' and change the setting to '''Hybrid'''.


<div style="margin:0.6em 0; padding:0.8em 1em; background:#eef3fb; border-left:6px solid #1f4fa3;">
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;">
Manual fix (advanced users):
Hybrid mode is commonly used in aviation because altitude is shown in feet while most other measurements can remain metric.
</div>
</div>


# Close FSFO, MSFS and FSUIPC7
[[Troubleshooting#top|Back to top]]
# Go to www.fsuipc.com
# Select Products > All Products > Download FSUIPC WASM Module 1.0.7 + WAPI 1.0.4 (version numbers will be different)
# Go to FSUIPC-WASMv1.0.7.zip > FSUIPC_WAPI.zip > FSUIPC_WAPI > dll > copy FSUIPC_WAPID.dll
# Paste FSUIPC_WAPID.dll in the main FSFO_V6 directory. (note: this is the same directory where your FSFO_V6.exe is located)
# Go to FSUIPC-WASMv1.0.7.zip > fsuipc-lvar-module.zip > copy fsuipc-lvar-module folder
# Paste fsuipc-lvar-module folder in MSFS Community Folder (overwrite the existing folder)


[[Troubleshooting#top|Back to top]]
----
----


== <big>Aircraft-specific issues</big> ==
<span id="aircraft-specific"></span>


<div style="margin:0.8em 0; padding:0.8em 1em; background:#eef3fb; border-left:6px solid #1f4fa3;">
= Aircraft-Specific Issues =
These issues apply only to specific aircraft or families.
 
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;">
These issues apply only to specific aircraft or aircraft families.
</div>
</div>


=== FBW A320 or Headwind A330 MCDU not programming ===
== FBW A320 or Headwind A330: MCDU not programming ==


<div style="margin:0.6em 0; padding:0.8em 1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;">
Edit this file:
Edit:
 
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fbfcff; border-left:6px solid #1f4fa3; border-radius:8px;">
<pre>
<pre>
Community\fsuipc-lvar-module\FSUIPC_WASM.ini
Community\fsuipc-lvar-module\FSUIPC_WASM.ini
</pre>
</pre>
Set:
</div>
 
Set this value:
 
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#f4f9f6; border-left:6px solid #5cb85c; border-radius:8px;">
<pre>
<pre>
UseAirLocForHvars=Yes
UseAirLocForHvars=Yes
</pre>
</pre>
Save and restart MSFS.
</div>
</div>
Save the file and restart Microsoft Flight Simulator.
[[Troubleshooting#top|Back to top]]


----
----


=== Headwind A330 FCU or MCDU not responding ===
== Headwind A330: FCU or MCDU not responding ==


<div style="margin:0.6em 0; padding:0.8em 1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;">
Copy this file:
Copy:
 
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fbfcff; border-left:6px solid #1f4fa3; border-radius:8px;">
<pre>
<pre>
Community\fsuipc-lvar-module\modules\A320.hvar
Community\fsuipc-lvar-module\modules\A320.hvar
</pre>
</pre>
</div>
Rename the copy to:
Rename the copy to:
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#f4f9f6; border-left:6px solid #5cb85c; border-radius:8px;">
<pre>
<pre>
A330.hvar
A330.hvar
</pre>
</pre>
Restart MSFS.
</div>
</div>
Restart Microsoft Flight Simulator.
[[Troubleshooting#top|Back to top]]


----
----


=== PMDG aircraft Enable SDK Data Broadcast ===
== PMDG aircraft: Enable SDK Data Broadcast ==


<div style="margin:0.6em 0; padding:0.8em 1em; background:#fdf7f2; border-left:6px solid #f0ad4e; border-radius:8px;">
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fdf7f2; border-left:6px solid #f0ad4e; border-radius:8px;">
<strong>Important:</strong> The aircraft must be loaded past the <strong>Ready to Fly</strong> screen at least once before these files exist.
<strong>Important:</strong> The aircraft must be loaded past the <strong>Ready to Fly</strong> screen at least once before these files exist.
</div>
</div>


# Exit Microsoft Flight Simulator.
# Exit Microsoft Flight Simulator.
# Open Windows File Explorer and navigate to the appropriate PMDG work folder below.
# Open Windows File Explorer.
# Navigate to the appropriate PMDG work folder below.


==== MSFS 2020 Work Folder (per aircraft) ====
=== MSFS 2020 Work Folder ===


'''Store / Xbox Version'''
'''Store / Xbox Version'''
<div style="margin:0.4em 0; padding:0.7em 0.9em; background:#fbfcff; border-left:6px solid #1f4fa3; border-radius:8px;">
 
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fbfcff; border-left:6px solid #1f4fa3; border-radius:8px;">
<pre>
<pre>
C:\Users\{username}\AppData\Local\Packages\Microsoft.FlightSimulator_8wekyb3d8bbwe\LocalState\Packages\pmdg-aircraft-{aircraft_name}\work
C:\Users\{username}\AppData\Local\Packages\Microsoft.FlightSimulator_8wekyb3d8bbwe\LocalState\Packages\pmdg-aircraft-{aircraft_name}\work
Line 290: Line 410:


'''Steam Version'''
'''Steam Version'''
<div style="margin:0.4em 0; padding:0.7em 0.9em; background:#fbfcff; border-left:6px solid #1f4fa3; border-radius:8px;">
 
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fbfcff; border-left:6px solid #1f4fa3; border-radius:8px;">
<pre>
<pre>
C:\Users\{username}\AppData\Roaming\Microsoft Flight Simulator\Packages\pmdg-aircraft-{aircraft_name}\work
C:\Users\{username}\AppData\Roaming\Microsoft Flight Simulator\Packages\pmdg-aircraft-{aircraft_name}\work
Line 296: Line 417:
</div>
</div>


==== MSFS 2024 Work Folder (per aircraft) ====
=== MSFS 2024 Work Folder ===


'''Store / Xbox Version'''
'''Store / Xbox Version'''
<div style="margin:0.4em 0; padding:0.7em 0.9em; background:#fbfcff; border-left:6px solid #1f4fa3; border-radius:8px;">
 
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fbfcff; border-left:6px solid #1f4fa3; border-radius:8px;">
<pre>
<pre>
C:\Users\{username}\AppData\Local\Packages\Microsoft.Limitless_8wekyb3d8bbwe\LocalState\WASM\MSFS2024\pmdg-aircraft-{aircraft_name}\work
C:\Users\{username}\AppData\Local\Packages\Microsoft.Limitless_8wekyb3d8bbwe\LocalState\WASM\MSFS2024\pmdg-aircraft-{aircraft_name}\work
Line 306: Line 428:


'''Steam Version'''
'''Steam Version'''
<div style="margin:0.4em 0; padding:0.7em 0.9em; background:#fbfcff; border-left:6px solid #1f4fa3; border-radius:8px;">
 
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fbfcff; border-left:6px solid #1f4fa3; border-radius:8px;">
<pre>
<pre>
C:\Users\{username}\AppData\Roaming\Microsoft Flight Simulator 2024\WASM\MSFS2024\pmdg-aircraft-{aircraft_name}\work
C:\Users\{username}\AppData\Roaming\Microsoft Flight Simulator 2024\WASM\MSFS2024\pmdg-aircraft-{aircraft_name}\work
Line 312: Line 435:
</div>
</div>


# Open the <code>{aircraft_name}_Options.ini</code> file in a text editor such as Notepad.
# Open the <code>{aircraft_name}_Options.ini</code> file in Notepad.
# Add the following lines to the very end of the file:
# Add the following lines to the very end of the file:


<div style="margin:0.6em 0; padding:0.8em 1em; background:#f4f9f6; border-left:6px solid #5cb85c; border-radius:8px;">
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#f4f9f6; border-left:6px solid #5cb85c; border-radius:8px;">
<pre>
<pre>
[SDK]
[SDK]
Line 323: Line 446:
</div>
</div>


# Save the file and restart Microsoft Flight Simulator.
# Save the file.
# Restart Microsoft Flight Simulator.


<div style="margin:0.6em 0; padding:0.8em 1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;">
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;">
''Where <code>{username}</code> is your Windows username and <code>{aircraft_name}</code> is the specific PMDG aircraft you are using (for example, <code>737</code>).''
Replace <code>{username}</code> with your Windows username.<br />
Replace <code>{aircraft_name}</code> with the specific PMDG aircraft you are using, such as <code>737</code>, <code>777</code>, or another PMDG aircraft folder name.
</div>
</div>


[[Troubleshooting#top|Back to top]]
[[Troubleshooting#top|Back to top]]
----
----
<span id="speech-recognition"></span>
= Speech Recognition and Microphone Issues =


== No English speech recognizer installed ==
== No English speech recognizer installed ==


<div style="margin:0.6em 0; padding:0.8em 1em; background:#fdf7f2; border-left:6px solid #f0ad4e;">
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fdf7f2; border-left:6px solid #f0ad4e; border-radius:8px;">
If you are using the Microsoft Speech Engine, FSFO relies on English phrases to perform specific actions. At least one English speech language pack must be installed. Your Windows display language or region can be anything.
If you are using the Microsoft Speech Engine, FSFO requires at least one English speech language pack. Your Windows display language and region can be anything.
</div>
</div>


If English is not installed:
=== If English is not installed ===


# Open Settings > Time & language > Language & region.
# Open '''Settings Time & language Language & region'''.
# Click Add a language.
# Click '''Add a language'''.
# Search for English (any variant is fine, for example English (United States) or English (United Kingdom)).
# Search for English.
# Select the English language > Next.
# Select any English variant, such as English (United States) or English (United Kingdom).
# Ensure Language pack and Speech are checked → Install.
# Click '''Next'''.
# Make sure '''Language pack''' and '''Speech''' are selected.
# Click '''Install'''.
# Restart Windows.
# Restart Windows.


After restart, FSFO should detect an <code>en-*</code> recognizer.
After restarting, FSFO should detect an <code>en-*</code> speech recognizer.


If English is already listed or installed:
=== If English is already installed ===


# Click the three dots next to the English language > Language options > under Speech, click Download (if not already installed).
# Open '''Settings → Time & language → Language & region'''.
# Settings > Time & Language > Language > Add a preferred language > choose an English variant > make sure Speech is included in the install options.
# Click the three dots next to the English language.
# Select '''Language options'''.
# Under Speech, click '''Download''' if it is not already installed.
# Restart Windows.


[[Troubleshooting#top|Back to top]]
[[Troubleshooting#top|Back to top]]
----
----


== Voice recognition troubleshooting ==
== Voice recognition troubleshooting ==


<div style="margin:0.6em 0; padding:0.8em 1em; background:#eef3fb; border-left:6px solid #1f4fa3;">
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;">
Use this section for microphone, permissions, and recognition accuracy problems.
Use this section for microphone, Windows permissions, and voice recognition accuracy problems.
</div>
</div>


'''Basic Checks:'''
=== Basic microphone checks ===
* Microphone works?
 
** Open Voice Recorder (Windows) and make a short recording. If you can’t record, fix the mic first.
# Open Windows Voice Recorder.
# Make a short test recording.
# If you cannot record audio, fix the microphone issue in Windows before troubleshooting FSFO.
 
=== Windows 11 microphone permissions ===
 
Go to:
 
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fbfcff; border-left:6px solid #1f4fa3; border-radius:8px;">
<pre>
Settings → Privacy & security → Microphone
</pre>
</div>
 
Make sure these are turned on:
 
* Microphone access
* Let apps access your microphone
* Let desktop apps access your microphone
 
=== Correct input device ===


* Privacy permissions (Windows 11):
# Open '''Settings → System → Sound → Input'''.
** Settings > Privacy & security > Microphone
# Select the microphone you are using.
*** Microphone access: On
# Speak into the microphone.
*** Let desktop apps access your microphone: On
# Confirm the input level meter moves.


* Correct input device
=== Exclusive mode test ===
** Settings > System > Sound > Input > Select the mic you’re using. Speak and confirm the input level moves.


* No “exclusive mode” lock
# Open '''Control Panel Sound Recording'''.
** Control Panel > Sound > Recording > [Your Mic] > Properties > Advanced
# Select your microphone.
*** Uncheck Allow applications to take exclusive control (as a test)
# Click '''Properties'''.
# Open the '''Advanced''' tab.
# Temporarily uncheck '''Allow applications to take exclusive control of this device'''.
# Apply the change and test FSFO again.


* Reasonable gain
=== Recommended microphone gain ===
** In the same Levels tab, set between 70–90 to start. Avoid 100 + “boost” unless your mic is very quiet.


'''English Speech Pack Installed (required):'''
# Open the microphone '''Levels''' tab.
* FSFO relies on English phrases. At least one English speech recognizer must be installed.
# Start with a level between '''70 and 90'''.
** Windows 11: Settings → Time & language → Language & region → Add a language → English → ensure Language pack and Speech are selected → Install → Restart.
# Avoid setting the level to 100 with boost enabled unless your microphone is very quiet.
** Your Windows display language can be anything; only the English speech component is required.


'''Accuracy Tuning'''
=== Accuracy tuning ===
* Lower <code>Input_VoiceAccuracy</code> if commands are missed.
* Increase it if false triggers occur.
* To change the accuracy setting go to FSFO > Settings > Train Speech > Next > Next > Next


'''Known Conflicts'''
* Lower <code>Input_VoiceAccuracy</code> if commands are being missed.
Close applications such as Discord, Teams, NVIDIA Broadcast, Voicemeeter, or audio enhancement tools while testing.
* Increase <code>Input_VoiceAccuracy</code> if false triggers occur.
 
To change the accuracy setting:
 
# Open FSFO.
# Go to '''Settings'''.
# Select '''Train Speech'''.
# Click '''Next → Next → Next'''.
# Adjust the voice accuracy setting.
 
=== Known conflicts ===
 
Close the following applications while testing voice recognition:
 
* Discord
* Microsoft Teams
* NVIDIA Broadcast
* Voicemeeter
* Audio enhancement tools
* Other applications that may take control of your microphone


[[Troubleshooting#top|Back to top]]
[[Troubleshooting#top|Back to top]]
----
----


== No microphones found ==
== No microphones found ==


<div style="margin:0.6em 0; padding:0.8em 1em; background:#eef3fb; border-left:6px solid #1f4fa3;">
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;">
Use these steps if FSFO shows no available input devices.
Use these steps if FSFO shows no available input devices.
</div>
</div>


* '''Confirm Windows can see your mic'''
=== Confirm Windows can see your microphone ===
** Windows Settings > System > Sound > Input
 
** Select your microphone under Choose a device for speaking or recording
# Open '''Settings System Sound Input'''.
** Speak and verify the input level meter moves.
# Select your microphone under '''Choose a device for speaking or recording'''.
* '''Allow microphone permissions'''
# Speak into the microphone.
** Windows Settings > Privacy & security > Microphone
# Confirm the input level meter moves.
** Turn ON:
 
*** Microphone access
=== Allow microphone permissions ===
*** Let apps access your microphone
 
*** Let desktop apps access your microphone
Go to:
* '''Enable it in Control Panel (and set default)'''
 
** Open Control Panel > Sound > Recording
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fbfcff; border-left:6px solid #1f4fa3; border-radius:8px;">
** Right-click your microphone > Enable
<pre>
** Right-click it again > Set as Default Device
Settings Privacy & security → Microphone
** (Optional) Set as Default Communication Device too.
</pre>
* '''Basic Hardware Checks'''
</div>
** Make sure the mic isn’t muted (hardware switch, inline mute, or headset button).
 
** Unplug and replug, try a different USB port (avoid hubs while testing).
Turn on:
** If it’s Bluetooth, reconnect it and confirm the Headset or Hands-Free input is selected in Sound > Input.
 
* Microphone access
* Let apps access your microphone
* Let desktop apps access your microphone
 
=== Enable the microphone in Control Panel ===
 
# Open '''Control Panel Sound Recording'''.
# Right-click your microphone.
# Select '''Enable'''.
# Right-click it again.
# Select '''Set as Default Device'''.
# Optional: Select '''Set as Default Communication Device'''.
 
=== Basic hardware checks ===
 
* Make sure the microphone is not muted.
* Check any headset mute button, inline mute switch, or hardware switch.
* Unplug and reconnect the microphone.
* Try a different USB port.
* Avoid USB hubs while testing.
* If using Bluetooth, reconnect the device and confirm the correct headset or hands-free input is selected in Windows Sound settings.


[[Troubleshooting#top|Back to top]]
[[Troubleshooting#top|Back to top]]
----
----


== FSFO crashes ==
<span id="crashes"></span>


[[File:EventView.png|left|thumb|186x186px]]
= FSFO Crashes =


<div style="margin-left:200px; margin-bottom:0.6em; padding:0.8em 1em; background:#fdf7f2; border-left:6px solid #f0ad4e;">
== FSFO crashes or closes unexpectedly ==
<strong>When reporting crashes, include Windows Event Viewer logs.</strong>
 
[[File:EventView.png|left|thumb|186x186px|Windows Event Viewer]]
 
<div style="margin-left:200px; margin-bottom:0.8em; padding:0.9em 1.1em; background:#fdf7f2; border-left:6px solid #f0ad4e; border-radius:8px;">
<strong>When reporting crashes, include Windows Event Viewer logs.</strong><br />
These logs help support identify the actual crash module, exception code, and faulting application details.
</div>
</div>


# Type Event Viewer in the Windows Search Bar
<div style="clear:both;"></div>
# Click on the Event Viewer App
 
# Expand Windows Log > Expand Application
=== How to collect Event Viewer logs ===
# Look for any Error messages associated with FSFO; FSFO.exe should be listed in the General field.
 
# Click The Details Tab, Copy and Email the contents to support
# Type '''Event Viewer''' in the Windows search bar.
# Open the '''Event Viewer''' app.
# Expand '''Windows Logs'''.
# Select '''Application'''.
# Look for any Error messages associated with FSFO.
# Confirm <code>FSFO.exe</code> is listed in the General field.
# Click the '''Details''' tab.
# Copy the contents.
# Email the details to support.


[[Troubleshooting#top|Back to top]]
[[Troubleshooting#top|Back to top]]
Line 445: Line 653:
----
----


<div style="margin:1em 0; padding:0.8em 1em; background:#eef3fb; border-left:6px solid #1f4fa3;">
<span id="support"></span>
 
= Still Need Help? =
 
<div style="margin:1em 0; padding:0.9em 1.1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;">
If your issue is not resolved after following the steps above, see [[Support]].
If your issue is not resolved after following the steps above, see [[Support]].
</div>
</div>

Latest revision as of 22:57, 5 June 2026

FSFO Troubleshooting Guide

Common setup, connectivity, speech recognition, aircraft-specific, and crash-reporting issues for Flight Simulator First Officer (FSFO).

Use this page first when FSFO is not working as expected. Most issues are caused by startup order, FSUIPC7 connection problems, missing LVARs, microphone permissions, or aircraft-specific configuration.

Recommended startup order:
Start programs in this order unless a section says otherwise:
Microsoft Flight Simulator → FSUIPC7 → FSFO


Page Appearance Guide

Blue boxes are used for general notes, explanations, and helpful background information.

Orange boxes are used for warnings, important requirements, or likely causes of a problem.

Green boxes are used for confirmed fixes, required configuration entries, or values the user should copy exactly.

Path boxes are used for Windows folder paths, configuration files, and other technical locations.


Quick Navigation


FSUIPC7, LVAR, and Connection Issues

Copilot does not move any switches

This usually means FSFO cannot properly communicate with FSUIPC7, the aircraft LVAR system, or the selected aircraft profile.

Step 1: Verify FSUIPC7 is connected

  1. Open the FSUIPC7 tray icon near the Windows clock.
  2. Right-click the icon.
  3. Select Show.
  4. Confirm FSUIPC7 reports Connected.
  5. Confirm LVARs are available.

FSUIPC7 showing connected state and available LVARs

If LVARs show as missing or display as 0 Lvars, go to Step 4: LVARs fail to load.
If the WASM menu is disabled or missing, go to Step 5: Reinstall FSUIPC7 if needed.

Step 2: Verify FSFO is connected to FSUIPC7

Before starting your flight, FSFO should show the connected FSUIPC7 version in the lower-left corner.

FSFO showing FSUIPC7 version in the status bar

If no FSUIPC7 version is shown, FSFO is not connected to FSUIPC7.

Step 3: Confirm the aircraft profile and checklist

  1. Open the FSFO Start Flight page.
  2. Confirm the correct Aircraft Profile is selected.
  3. Confirm the correct Checklist is selected.
  4. Start the flight.
  5. Confirm the active aircraft profile appears in the lower-left corner.

Aircraft profile selection on Start Flight page

Step 4: LVARs fail to load

  1. Make sure Microsoft Flight Simulator is fully loaded into the cockpit before starting FSFO.
  2. Confirm FSUIPC7 shows Connected.
  3. If using a complex aircraft, give the aircraft extra time to finish loading its systems.
  4. Start FSFO only after FSUIPC7 is already connected.
  5. If the issue continues, close everything and restart in this order:
    1. Start Microsoft Flight Simulator and load into the cockpit.
    2. Start FSUIPC7 and confirm it shows Connected with LVARs loaded.
    3. Start FSFO last.

If LVARs still do not load, adjust the FSUIPC WASM scan settings. This should be treated as a last-resort troubleshooting step.

Adjust FSUIPC WASM scan settings

  1. Close Microsoft Flight Simulator, FSUIPC7, and FSFO.
  2. Open the FSUIPC_WASM.ini file in the WASM persistence/work folder.
  3. Do not edit the copy in the Community folder.
  4. Set the following values:
LvarScanDelay=15
LvarScanFrequency=0

What these settings do:
LvarScanDelay=15 gives the aircraft more time to initialize before FSUIPC scans for LVARs.
LvarScanFrequency=0 disables repeated rescans, which may help if WASM is unstable or LVARs stop updating.

After saving the file, restart in this order:

  1. Start Microsoft Flight Simulator and load into the cockpit.
  2. Start FSUIPC7 and confirm it shows Connected.
  3. Start FSFO last.

If LVARs still fail to load, check whether the FSUIPC WASM module is missing or has crashed. Continue to Step 5.

Step 5: Reinstall FSUIPC7 if needed

If the steps above fail:

  1. Close Microsoft Flight Simulator, FSFO, and FSUIPC7.
  2. Reinstall the latest FSUIPC7 installer over the existing installation.
  3. Restart Windows.
  4. Start Microsoft Flight Simulator.
  5. Start FSUIPC7.
  6. Start FSFO.

If problems continue, perform a clean FSUIPC7 reinstall:

  1. Uninstall FSUIPC7.
  2. Delete the FSUIPC7 install folder.
  3. Remove the FSUIPC WASM folder from the MSFS Community directory:
*\AppData\Local\Packages\Microsoft.FlightSimulator_8wekyb3d8bbwe\LocalCache\Packages\Community\fsuipc-lvar-module
  1. Reboot Windows.
  2. Download the latest FSUIPC7 from:
    https://fsuipc.com/fsuipc7/
  3. Unzip the installer.
  4. Right-click Install_FSUIPC7.exe.
  5. Select Run as administrator.
  6. Make sure you select the simulator version you use: MSFS 2020, MSFS 2024, or both.
  7. Make sure the WASM module is selected during installation.

After reinstalling, start programs in this order:

  1. Start Microsoft Flight Simulator and load into a cockpit.
  2. Start FSUIPC7 and confirm it shows Connected.
  3. Start FSFO last.
FSUIPC7 installer options

Back to top


FSUIPC Error #12: FSUIPC_ERR_SENDMSG

FSFO and FSUIPC7 must run at the same Windows permission level.

  1. Right-click FSFO.
  2. Select Properties → Compatibility.
  3. Check whether Run this program as an administrator is enabled.
  4. Repeat the same check for FSUIPC7.
  5. Make sure administrator mode is either enabled for both applications or disabled for both applications.
  6. Restart FSFO and FSUIPC7.

Back to top


FSUIPC Error #2

This error usually means FSFO could not complete the connection to FSUIPC7.

Common causes

  • FSUIPC7 is not running.
  • More than one FSUIPC7 instance is open.
  • Antivirus or firewall software is blocking communication.
  • FSUIPC7 was installed in a protected Windows folder.
  • FSFO is trying to connect before Microsoft Flight Simulator and FSUIPC7 are fully loaded.

Quick restart sequence

  1. Close FSFO, FSUIPC7, and Microsoft Flight Simulator.
  2. Reboot Windows.
  3. Start Microsoft Flight Simulator and load fully into a cockpit.
  4. Start FSUIPC7 and confirm it is running.
  5. Start FSFO and click Connect.

Additional checks

  1. Make sure only one instance of FSUIPC7 is running.
  2. Check the system tray near the Windows clock.
  3. Temporarily disable Auto-Connect in FSFO and connect manually.
  4. Whitelist FSFO and FSUIPC7 in your antivirus and firewall software.
  5. Make sure Microsoft Flight Simulator, FSUIPC7, and FSFO are running at the same permission level.

Installation checks

  • Do not install FSUIPC7 inside Program Files or other protected Windows folders.
  • Install FSUIPC7 to a simple folder such as:
C:\FSUIPC7
  • If needed, reinstall FSUIPC7 and restart the PC.
  • After reinstalling, launch Microsoft Flight Simulator first, then FSUIPC7, then FSFO.
  • If unresolved, perform a clean FSUIPC7 reinstall.

Back to top


WASM version mismatch

Example error:
WASM version X while WAPI expects Y

Reinstall the latest FSUIPC7 installer. The installer includes matching WASM and WAPI components.

Manual fix for advanced users

Use this only if reinstalling FSUIPC7 does not resolve the mismatch.

  1. Close FSFO, Microsoft Flight Simulator, and FSUIPC7.
  2. Go to:
    https://www.fsuipc.com
  3. Select Products → All Products.
  4. Download the latest FSUIPC WASM Module and WAPI package.
  5. Open the downloaded ZIP file.
  6. Go to:
FSUIPC_WAPI.zip > FSUIPC_WAPI > dll
  1. Copy:
FSUIPC_WAPID.dll
  1. Paste it into the main FSFO V6 directory, where FSFO_V6.exe is located.
  2. Go back to the downloaded ZIP file.
  3. Copy the fsuipc-lvar-module folder.
  4. Paste it into your Microsoft Flight Simulator Community folder and overwrite the existing folder.

Back to top


Simulator Settings Issues

Copilot executes actions at incorrect altitudes

This issue is usually caused by the simulator’s Units of Measurement setting being set to Metric.

When Microsoft Flight Simulator is set to Metric, altitude-related values may be reported or interpreted in meters instead of feet. FSFO expects altitude-related values to be in feet. If the simulator is using Metric units, the copilot may execute altitude-based actions too early or too late.

If your simulator Units of Measurement setting is set to Metric, your copilot may perform some actions using meters instead of feet.

Fix

  • MSFS 2024: Go to General Options → Language → Units of Measurement and change the setting to Hybrid.
  • MSFS 2020: Go to General Options → MISC → Units of Measurement and change the setting to Hybrid.

Hybrid mode is commonly used in aviation because altitude is shown in feet while most other measurements can remain metric.

Back to top


Aircraft-Specific Issues

These issues apply only to specific aircraft or aircraft families.

FBW A320 or Headwind A330: MCDU not programming

Edit this file:

Community\fsuipc-lvar-module\FSUIPC_WASM.ini

Set this value:

UseAirLocForHvars=Yes

Save the file and restart Microsoft Flight Simulator.

Back to top


Headwind A330: FCU or MCDU not responding

Copy this file:

Community\fsuipc-lvar-module\modules\A320.hvar

Rename the copy to:

A330.hvar

Restart Microsoft Flight Simulator.

Back to top


PMDG aircraft: Enable SDK Data Broadcast

Important: The aircraft must be loaded past the Ready to Fly screen at least once before these files exist.

  1. Exit Microsoft Flight Simulator.
  2. Open Windows File Explorer.
  3. Navigate to the appropriate PMDG work folder below.

MSFS 2020 Work Folder

Store / Xbox Version

C:\Users\{username}\AppData\Local\Packages\Microsoft.FlightSimulator_8wekyb3d8bbwe\LocalState\Packages\pmdg-aircraft-{aircraft_name}\work

Steam Version

C:\Users\{username}\AppData\Roaming\Microsoft Flight Simulator\Packages\pmdg-aircraft-{aircraft_name}\work

MSFS 2024 Work Folder

Store / Xbox Version

C:\Users\{username}\AppData\Local\Packages\Microsoft.Limitless_8wekyb3d8bbwe\LocalState\WASM\MSFS2024\pmdg-aircraft-{aircraft_name}\work

Steam Version

C:\Users\{username}\AppData\Roaming\Microsoft Flight Simulator 2024\WASM\MSFS2024\pmdg-aircraft-{aircraft_name}\work
  1. Open the {aircraft_name}_Options.ini file in Notepad.
  2. Add the following lines to the very end of the file:
[SDK]
EnableDataBroadcast=1
EnableCDUBroadcast.0=1
  1. Save the file.
  2. Restart Microsoft Flight Simulator.

Replace {username} with your Windows username.
Replace {aircraft_name} with the specific PMDG aircraft you are using, such as 737, 777, or another PMDG aircraft folder name.

Back to top


Speech Recognition and Microphone Issues

No English speech recognizer installed

If you are using the Microsoft Speech Engine, FSFO requires at least one English speech language pack. Your Windows display language and region can be anything.

If English is not installed

  1. Open Settings → Time & language → Language & region.
  2. Click Add a language.
  3. Search for English.
  4. Select any English variant, such as English (United States) or English (United Kingdom).
  5. Click Next.
  6. Make sure Language pack and Speech are selected.
  7. Click Install.
  8. Restart Windows.

After restarting, FSFO should detect an en-* speech recognizer.

If English is already installed

  1. Open Settings → Time & language → Language & region.
  2. Click the three dots next to the English language.
  3. Select Language options.
  4. Under Speech, click Download if it is not already installed.
  5. Restart Windows.

Back to top


Voice recognition troubleshooting

Use this section for microphone, Windows permissions, and voice recognition accuracy problems.

Basic microphone checks

  1. Open Windows Voice Recorder.
  2. Make a short test recording.
  3. If you cannot record audio, fix the microphone issue in Windows before troubleshooting FSFO.

Windows 11 microphone permissions

Go to:

Settings → Privacy & security → Microphone

Make sure these are turned on:

  • Microphone access
  • Let apps access your microphone
  • Let desktop apps access your microphone

Correct input device

  1. Open Settings → System → Sound → Input.
  2. Select the microphone you are using.
  3. Speak into the microphone.
  4. Confirm the input level meter moves.

Exclusive mode test

  1. Open Control Panel → Sound → Recording.
  2. Select your microphone.
  3. Click Properties.
  4. Open the Advanced tab.
  5. Temporarily uncheck Allow applications to take exclusive control of this device.
  6. Apply the change and test FSFO again.
  1. Open the microphone Levels tab.
  2. Start with a level between 70 and 90.
  3. Avoid setting the level to 100 with boost enabled unless your microphone is very quiet.

Accuracy tuning

  • Lower Input_VoiceAccuracy if commands are being missed.
  • Increase Input_VoiceAccuracy if false triggers occur.

To change the accuracy setting:

  1. Open FSFO.
  2. Go to Settings.
  3. Select Train Speech.
  4. Click Next → Next → Next.
  5. Adjust the voice accuracy setting.

Known conflicts

Close the following applications while testing voice recognition:

  • Discord
  • Microsoft Teams
  • NVIDIA Broadcast
  • Voicemeeter
  • Audio enhancement tools
  • Other applications that may take control of your microphone

Back to top


No microphones found

Use these steps if FSFO shows no available input devices.

Confirm Windows can see your microphone

  1. Open Settings → System → Sound → Input.
  2. Select your microphone under Choose a device for speaking or recording.
  3. Speak into the microphone.
  4. Confirm the input level meter moves.

Allow microphone permissions

Go to:

Settings → Privacy & security → Microphone

Turn on:

  • Microphone access
  • Let apps access your microphone
  • Let desktop apps access your microphone

Enable the microphone in Control Panel

  1. Open Control Panel → Sound → Recording.
  2. Right-click your microphone.
  3. Select Enable.
  4. Right-click it again.
  5. Select Set as Default Device.
  6. Optional: Select Set as Default Communication Device.

Basic hardware checks

  • Make sure the microphone is not muted.
  • Check any headset mute button, inline mute switch, or hardware switch.
  • Unplug and reconnect the microphone.
  • Try a different USB port.
  • Avoid USB hubs while testing.
  • If using Bluetooth, reconnect the device and confirm the correct headset or hands-free input is selected in Windows Sound settings.

Back to top


FSFO Crashes

FSFO crashes or closes unexpectedly

Windows Event Viewer

When reporting crashes, include Windows Event Viewer logs.
These logs help support identify the actual crash module, exception code, and faulting application details.

How to collect Event Viewer logs

  1. Type Event Viewer in the Windows search bar.
  2. Open the Event Viewer app.
  3. Expand Windows Logs.
  4. Select Application.
  5. Look for any Error messages associated with FSFO.
  6. Confirm FSFO.exe is listed in the General field.
  7. Click the Details tab.
  8. Copy the contents.
  9. Email the details to support.

Back to top


Still Need Help?

If your issue is not resolved after following the steps above, see Support.