Troubleshooting: Difference between revisions

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


Use this page when something is not working as expected before contacting support.
Common setup, connectivity, speech recognition, aircraft-specific, and crash-reporting issues for '''Flight Simulator First Officer (FSFO)'''.


Unless a section says otherwise, always start programs in this order: MSFS → FSUIPC7 → FSFO.
<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 style="margin:0.8em 0; padding:0.9em 1.1em; background:#fdf7f2; border-left:6px solid #f0ad4e; border-radius:8px;">
<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>


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


If LVARs are missing or the menu is disabled, the WASM module is not loaded.
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fdf7f2; border-left:6px solid #f0ad4e; border-radius:8px;">
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]].
</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]]


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


After starting the flight, the active aircraft profile appears in the lower-left corner.
# 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.


[[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]]


=== Step 4: Reinstall FSUIPC7 if needed ===
<span id="lvars-fail-to-load"></span>
If the steps above fail:
 
=== Step 4: LVARs fail to load ===
 
# Make sure Microsoft Flight Simulator is fully loaded into the cockpit before starting FSFO.
# Confirm FSUIPC7 shows '''Connected'''.
# If using a complex aircraft, give the aircraft extra time to finish loading its systems.
# Start FSFO only after FSUIPC7 is already connected.
# If the issue continues, close everything and restart in this order:
## Start Microsoft Flight Simulator and load into the cockpit.
## Start FSUIPC7 and confirm it shows '''Connected''' with LVARs loaded.
## Start FSFO last.
 
<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>
 
==== Adjust FSUIPC WASM scan settings ====
 
# 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:
 
<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>


# Close MSFS, FSFO, and FSUIPC7.
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;">
# Reinstall the latest FSUIPC7 installer over the existing installation.
<strong>What these settings do:</strong><br />
# If problems persist, perform a clean FSUIPC7 reinstall:
<code>LvarScanDelay=15</code> gives the aircraft more time to initialize before FSUIPC scans for LVARs.<br />
## Uninstall FSUIPC7.
<code>LvarScanFrequency=0</code> disables repeated rescans, which may help if WASM is unstable or LVARs stop updating.
## Delete the FSUIPC7 install folder.
</div>
## Remove the FSUIPC WASM folder from the MSFS Community directory.
## Reboot Windows.
## Install the latest FSUIPC7 as Administrator.
## Allow the WASM module to install when prompted.


After reinstall, start programs in this order:
After saving the file, restart in this order:


# Start MSFS and load into a 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.


[[Troubleshooting#top|Back to top]]
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fdf7f2; border-left:6px solid #f0ad4e; border-radius:8px;">
----
If LVARs still fail to load, check whether the FSUIPC WASM module is missing or has crashed. Continue to Step 5.
</div>
 
<span id="reinstall-fsuipc7"></span>
 
=== Step 5: Reinstall FSUIPC7 if needed ===
 
If the steps above fail:
 
# Close Microsoft Flight Simulator, FSFO, and FSUIPC7.
# Reinstall the latest FSUIPC7 installer over the existing installation.
# Restart Windows.
# Start Microsoft Flight Simulator.
# Start FSUIPC7.
# Start FSFO.


== FSFO does not stay on top ==
If problems continue, perform a clean FSUIPC7 reinstall:
This behavior is caused by Windows process-level restrictions.


Reasons:
# Uninstall FSUIPC7.
# Delete the FSUIPC7 install folder.
# Remove the FSUIPC WASM folder from the MSFS Community directory:


* Windows prevents non-admin apps from staying above admin-level apps.
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fbfcff; border-left:6px solid #1f4fa3; border-radius:8px;">
* Another application may re-assert its “Always on Top” flag after FSFO.
<pre>
*\AppData\Local\Packages\Microsoft.FlightSimulator_8wekyb3d8bbwe\LocalCache\Packages\Community\fsuipc-lvar-module
</pre>
</div>


Restarting FSFO reapplies its topmost flag, but FSFO cannot remain above an admin-level window unless it is also run as Administrator.
# 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.


Workaround:
<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>
<li>Start Microsoft Flight Simulator and load into a cockpit.</li>
<li>Start FSUIPC7 and confirm it shows Connected.</li>
<li>Start FSFO last.</li>
</ol>
</div>


* Run FSFO and FSUIPC7 at the same permission level.
[[File:Fsuipc7Setup.png|center|thumb|800x800px|FSUIPC7 installer options]]
* Or disable Always-On-Top in competing applications.


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


== FSUIPC Error #12 (FSUIPC_ERR_SENDMSG) ==
== FSUIPC Error #12: FSUIPC_ERR_SENDMSG ==
FSFO and FSUIPC7 must run at the same permission level.
 
<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 and FSUIPC7.
# Right-click FSFO.
# Select Properties → Compatibility.
# Select '''Properties → Compatibility'''.
# Ensure “Run as administrator” is either enabled for both or disabled for both.
# Check whether '''Run this program as an administrator''' is enabled.
# Restart both applications.
# 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]]
[[Troubleshooting#top|Back to top]]
----
----


== FSUIPC Error #2 ==
== FSUIPC Error #2 ==
This error indicates a failed or incomplete FSUIPC connection.
 
<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 ===
=== Quick restart sequence ===


# Close FSFO, FSUIPC7, and MSFS.
# Close FSFO, FSUIPC7, and Microsoft Flight Simulator.
# Reboot Windows.
# Reboot Windows.
# Start MSFS and load into a cockpit.
# Start Microsoft Flight Simulator and load fully into a cockpit.
# Start FSUIPC7 (verify only one instance).
# Start FSUIPC7 and confirm it is running.
# Start FSFO and click Connect.
# Start FSFO and click Connect.


=== Additional checks ===
=== Additional checks ===


* Ensure only one FSUIPC7 instance is running.
# Make sure only one instance of FSUIPC7 is running.
* Disable Auto-Connect in FSFO temporarily and connect manually.
# Check the system tray near the Windows clock.
* Whitelist FSFO and FSUIPC7 in antivirus or firewall software.
# 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:


If unresolved, perform a clean FSUIPC7 reinstall.
<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>
 
* 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.


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


== WASM version mismatch ==
== WASM version mismatch ==
Error example: “WASM version X while WAPI expects Y”.


Recommended fix:
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fdf7f2; border-left:6px solid #f0ad4e; border-radius:8px;">
Example error:<br />
<code>WASM version X while WAPI expects Y</code>
</div>


* Reinstall the latest FSUIPC7 installer, which includes matching WASM and WAPI components.
=== Recommended fix ===


Manual fix (advanced users):
Reinstall the latest FSUIPC7 installer. The installer includes matching WASM and WAPI components.


# Close FSFO, MSFS and FSUIPC7
=== Manual fix for advanced users ===
# 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)
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;">
# Go to FSUIPC-WASMv1.0.7.zip > FSUIPC_WAPI.zip > FSUIPC_WAPI > dll > copy FSUIPC_WAPID.dll
Use this only if reinstalling FSUIPC7 does not resolve the mismatch.
# Paste FSUIPC_WAPID.dll in the main FSFO_V6 directory. (note – this is the same directory where your FSFO_V6.exe is located)
</div>
# Go to FSUIPC-WASMv1.0.7.zip > fsuipc-lvar-module.zip > copy fsuipc-lvar-module folder
 
# Pastefsuipc-lvar-module folder in MSFS Community Folder (Overwrite the existing Folder)
# Close FSFO, Microsoft Flight Simulator, and FSUIPC7.
# Go to:
#: https://www.fsuipc.com
# Select '''Products All Products'''.
# Download the latest FSUIPC WASM Module and WAPI package.
# Open the downloaded ZIP file.
# Go to:
 
<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>
 
# Copy:
 
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fbfcff; border-left:6px solid #1f4fa3; border-radius:8px;">
<pre>
FSUIPC_WAPID.dll
</pre>
</div>
 
# 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.


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


== Aircraft-specific issues ==
<span id="simulator-settings"></span>


=== FBW A320 or Headwind A330 MCDU not programming ===
= Simulator Settings Issues =
Edit:<pre>
 
== Copilot executes actions at incorrect altitudes ==
 
<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.
</div>
 
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.8em 0; padding:0.9em 1.1em; background:#fdf7f2; border-left:6px solid #f0ad4e; border-radius:8px;">
If your simulator Units of Measurement setting is set to Metric, your copilot may perform some actions using meters instead of feet.
</div>
 
=== 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'''.
 
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;">
Hybrid mode is commonly used in aviation because altitude is shown in feet while most other measurements can remain metric.
</div>
 
[[Troubleshooting#top|Back to top]]
 
----
 
<span id="aircraft-specific"></span>
 
= Aircraft-Specific Issues =
 
<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>
 
== FBW A320 or Headwind A330: MCDU not programming ==
 
Edit this file:
 
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fbfcff; border-left:6px solid #1f4fa3; border-radius:8px;">
<pre>
Community\fsuipc-lvar-module\FSUIPC_WASM.ini
Community\fsuipc-lvar-module\FSUIPC_WASM.ini
</pre>Set:<pre>
</pre>
</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>
UseAirLocForHvars=Yes
UseAirLocForHvars=Yes
</pre>Save and restart MSFS.
</pre>
</div>
 
Save the file and restart Microsoft Flight Simulator.
 
[[Troubleshooting#top|Back to top]]


=== Headwind A330 FCU or MCDU not responding ===
----
Copy:<pre>
 
== Headwind A330: FCU or MCDU not responding ==
 
Copy this file:
 
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fbfcff; border-left:6px solid #1f4fa3; border-radius:8px;">
<pre>
Community\fsuipc-lvar-module\modules\A320.hvar
Community\fsuipc-lvar-module\modules\A320.hvar
</pre>Rename the copy to:<pre>
</pre>
</div>
 
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>
A330.hvar
A330.hvar
</pre>Restart MSFS.
</pre>
</div>


=== PMDG aircraft – enable SDK data broadcast ===
Restart Microsoft Flight Simulator.
Edit the aircraft options file and add:<pre>
 
[[Troubleshooting#top|Back to top]]
 
----
 
== PMDG aircraft: Enable SDK Data Broadcast ==
 
<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.
</div>
 
# Exit Microsoft Flight Simulator.
# Open Windows File Explorer.
# Navigate to the appropriate PMDG work folder below.
 
=== MSFS 2020 Work Folder ===
 
'''Store / Xbox Version'''
 
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fbfcff; border-left:6px solid #1f4fa3; border-radius:8px;">
<pre>
C:\Users\{username}\AppData\Local\Packages\Microsoft.FlightSimulator_8wekyb3d8bbwe\LocalState\Packages\pmdg-aircraft-{aircraft_name}\work
</pre>
</div>
 
'''Steam Version'''
 
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fbfcff; border-left:6px solid #1f4fa3; border-radius:8px;">
<pre>
C:\Users\{username}\AppData\Roaming\Microsoft Flight Simulator\Packages\pmdg-aircraft-{aircraft_name}\work
</pre>
</div>
 
=== MSFS 2024 Work Folder ===
 
'''Store / Xbox Version'''
 
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fbfcff; border-left:6px solid #1f4fa3; border-radius:8px;">
<pre>
C:\Users\{username}\AppData\Local\Packages\Microsoft.Limitless_8wekyb3d8bbwe\LocalState\WASM\MSFS2024\pmdg-aircraft-{aircraft_name}\work
</pre>
</div>
 
'''Steam Version'''
 
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fbfcff; border-left:6px solid #1f4fa3; border-radius:8px;">
<pre>
C:\Users\{username}\AppData\Roaming\Microsoft Flight Simulator 2024\WASM\MSFS2024\pmdg-aircraft-{aircraft_name}\work
</pre>
</div>
 
# Open the <code>{aircraft_name}_Options.ini</code> file in Notepad.
# Add the following lines to the very end of the file:
 
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#f4f9f6; border-left:6px solid #5cb85c; border-radius:8px;">
<pre>
[SDK]
[SDK]
EnableDataBroadcast=1
EnableDataBroadcast=1
</pre>Save and restart MSFS.
EnableCDUBroadcast.0=1
</pre>
</div>
 
# Save the file.
# Restart Microsoft Flight Simulator.
 
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;">
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>


[[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 ==
FSFO requires at least one English speech recognizer.


# Windows Settings → Time & language → Language & region.
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fdf7f2; border-left:6px solid #f0ad4e; border-radius:8px;">
# Add an English language (any variant).
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.
# Ensure Speech is selected.
</div>
 
=== If English is not installed ===
 
# Open '''Settings → Time & language → Language & region'''.
# Click '''Add a language'''.
# Search for English.
# Select any English variant, such as English (United States) or English (United Kingdom).
# 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 installed ===
 
# Open '''Settings → Time & language → Language & region'''.
# 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 ==


=== Quick checks ===
<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, Windows permissions, and voice recognition accuracy problems.
</div>


* Test your microphone using Windows Voice Recorder.
=== Basic microphone checks ===
* Verify microphone permissions are enabled.
 
* Confirm the correct input device is selected.
# Open Windows Voice Recorder.
* Disable exclusive mode in microphone advanced settings.
# 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 ===
 
# Open '''Settings → System → Sound → Input'''.
# Select the microphone you are using.
# Speak into the microphone.
# Confirm the input level meter moves.
 
=== Exclusive mode test ===
 
# Open '''Control Panel → Sound → Recording'''.
# Select your microphone.
# Click '''Properties'''.
# Open the '''Advanced''' tab.
# Temporarily uncheck '''Allow applications to take exclusive control of this device'''.
# Apply the change and test FSFO again.
 
=== Recommended microphone gain ===
 
# Open the microphone '''Levels''' tab.
# Start with a level between '''70 and 90'''.
# Avoid setting the level to 100 with boost enabled unless your microphone is very quiet.


=== Accuracy tuning ===
=== Accuracy tuning ===


* Lower <code>Input_VoiceAccuracy</code> if commands are missed.
* Lower <code>Input_VoiceAccuracy</code> if commands are being missed.
* Increase it if false triggers occur.
* 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 ===
=== Known conflicts ===
Close applications such as Discord, Teams, NVIDIA Broadcast, Voicemeeter, or audio enhancement tools while testing.
 
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 ==


# Select your microphone in Windows Sound settings and verify input levels.
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;">
# Enable microphone permissions in Privacy settings.
Use these steps if FSFO shows no available input devices.
# Enable and set the mic as default in Control Panel → Sound.
</div>
# Reconnect the microphone or try a different USB port.
 
=== Confirm Windows can see your microphone ===
 
# Open '''Settings → System → Sound → Input'''.
# Select your microphone under '''Choose a device for speaking or recording'''.
# Speak into the microphone.
# Confirm the input level meter moves.
 
=== Allow 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>
 
Turn on:
 
* 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>
When reporting crashes, include Windows Event Viewer logs.


# Open Event Viewer.
= FSFO Crashes =
# Navigate to Windows Logs Application.
 
# Locate the error referencing <code>FSFO.exe</code>.
== FSFO crashes or closes unexpectedly ==
# Copy the Details tab contents and send them to support.
 
[[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 style="clear:both;"></div>
 
=== How to collect Event Viewer logs ===
 
# 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 208: Line 653:
----
----


<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>

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.