Troubleshooting: Difference between revisions
No edit summary |
|||
| (15 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
__NOTOC__ | |||
= FSFO Troubleshooting Guide = | |||
Common setup, connectivity, speech recognition, aircraft-specific, and crash-reporting issues for '''Flight Simulator First Officer (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 | |||
<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 near the Windows clock. | |||
# Right-click the icon. | |||
# 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 | <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 | |||
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 | === Step 3: Confirm the aircraft profile and checklist === | ||
# 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: | <span id="lvars-fail-to-load"></span> | ||
=== 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> | |||
<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 | After saving the file, restart in this order: | ||
# Start | # 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. | ||
<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. | |||
If problems continue, perform a clean FSUIPC7 reinstall: | |||
# 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> | |||
<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> | |||
[[File:Fsuipc7Setup.png|center|thumb|800x800px|FSUIPC7 installer options]] | |||
[[Troubleshooting#top|Back to top]] | [[Troubleshooting#top|Back to top]] | ||
---- | ---- | ||
== FSUIPC Error #12 | == FSUIPC Error #12: FSUIPC_ERR_SENDMSG == | ||
# Right-click FSFO | <div style="margin:0.8em 0; padding:0.9em 1.1em; background:#fdf7f2; border-left:6px solid #f0ad4e; border-radius:8px;"> | ||
# Select Properties → Compatibility. | FSFO and FSUIPC7 must run at the same Windows permission level. | ||
# | </div> | ||
# Restart | |||
# 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]] | [[Troubleshooting#top|Back to top]] | ||
---- | ---- | ||
== FSUIPC Error #2 == | == FSUIPC Error #2 == | ||
This error | |||
<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 | # Close FSFO, FSUIPC7, and Microsoft Flight Simulator. | ||
# Reboot Windows. | # Reboot Windows. | ||
# Start | # Start Microsoft Flight Simulator and load fully into a cockpit. | ||
# Start FSUIPC7 | # Start FSUIPC7 and confirm it is running. | ||
# Start FSFO and click Connect. | # Start FSFO and click Connect. | ||
=== Additional checks === | === 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: | |||
<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 unresolved, perform a clean FSUIPC7 reinstall. | * 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 == | ||
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> | |||
=== Recommended fix === | |||
Reinstall the latest FSUIPC7 installer. The installer includes matching WASM and WAPI components. | |||
=== Manual fix for advanced users === | |||
<div style="margin:0.8em 0; padding:0.9em 1.1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;"> | |||
Use this only if reinstalling FSUIPC7 does not resolve the mismatch. | |||
</div> | |||
# 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. | |||
# Paste | |||
# Go to | |||
# | |||
[[Troubleshooting#top|Back to top]] | [[Troubleshooting#top|Back to top]] | ||
---- | ---- | ||
= | <span id="simulator-settings"></span> | ||
=== FBW A320 or Headwind A330 | = 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> | </pre> | ||
</div> | |||
Save the file and restart Microsoft Flight Simulator. | |||
Copy:<pre> | |||
[[Troubleshooting#top|Back to top]] | |||
---- | |||
== 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 | </pre> | ||
</div> | |||
Restart Microsoft Flight Simulator. | |||
[[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. | ||
# Add | # 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> | <pre> | ||
[SDK] | [SDK] | ||
EnableDataBroadcast=1 | EnableDataBroadcast=1 | ||
</pre>Save | 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 == | ||
If English is not installed | <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 requires at least one English speech language pack. Your Windows display language and region can be anything. | |||
</div> | |||
=== If English is not installed === | |||
# Open Settings | # Open '''Settings → Time & language → Language & region'''. | ||
# Click Add a language. | # Click '''Add a language'''. | ||
# Search for English | # 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 | After restarting, FSFO should detect an <code>en-*</code> speech recognizer. | ||
If English is already | === If English is already installed === | ||
# Click the three dots | # 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 == | ||
<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> | |||
* | |||
=== Basic microphone checks === | |||
# 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 === | |||
# 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 === | |||
* | * Lower <code>Input_VoiceAccuracy</code> if commands are being missed. | ||
* | * 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. | |||
''' | |||
Close applications | === 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.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. | |||
</div> | |||
=== 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]] | ||
---- | ---- | ||
= | <span id="crashes"></span> | ||
= FSFO Crashes = | |||
== FSFO crashes or closes unexpectedly == | |||
[[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 252: | 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
- Simulator Settings Issues
- Aircraft-Specific Issues
- Speech Recognition and Microphone Issues
- FSFO Crashes
- Still Need Help?
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
- Open the FSUIPC7 tray icon near the Windows clock.
- Right-click the icon.
- Select Show.
- Confirm FSUIPC7 reports Connected.
- Confirm LVARs are available.
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.
If no FSUIPC7 version is shown, FSFO is not connected to FSUIPC7.
Step 3: Confirm the aircraft profile and checklist
- 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.
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.
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
- Close Microsoft Flight Simulator, FSUIPC7, and FSFO.
- Open the
FSUIPC_WASM.inifile in the WASM persistence/work folder. - Do not edit the copy in the Community folder.
- 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:
- Start Microsoft Flight Simulator and load into the cockpit.
- Start FSUIPC7 and confirm it shows Connected.
- 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:
- 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.
If problems continue, perform a clean FSUIPC7 reinstall:
- Uninstall FSUIPC7.
- Delete the FSUIPC7 install folder.
- Remove the FSUIPC WASM folder from the MSFS Community directory:
*\AppData\Local\Packages\Microsoft.FlightSimulator_8wekyb3d8bbwe\LocalCache\Packages\Community\fsuipc-lvar-module
- Reboot Windows.
- Download the latest FSUIPC7 from:
- Unzip the installer.
- Right-click
Install_FSUIPC7.exe. - 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.
After reinstalling, start programs in this order:
- Start Microsoft Flight Simulator and load into a cockpit.
- Start FSUIPC7 and confirm it shows Connected.
- Start FSFO last.

FSUIPC Error #12: FSUIPC_ERR_SENDMSG
FSFO and FSUIPC7 must run at the same Windows permission level.
- 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.
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
- 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
Program Filesor 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.
WASM version mismatch
Example error:
WASM version X while WAPI expects Y
Recommended fix
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.
- Close FSFO, Microsoft Flight Simulator, and FSUIPC7.
- Go to:
- Select Products → All Products.
- Download the latest FSUIPC WASM Module and WAPI package.
- Open the downloaded ZIP file.
- Go to:
FSUIPC_WAPI.zip > FSUIPC_WAPI > dll
- Copy:
FSUIPC_WAPID.dll
- Paste it into the main FSFO V6 directory, where
FSFO_V6.exeis located. - Go back to the downloaded ZIP file.
- Copy the
fsuipc-lvar-modulefolder. - Paste it into your Microsoft Flight Simulator Community folder and overwrite the existing folder.
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.
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.
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.
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.
- Exit Microsoft Flight Simulator.
- Open Windows File Explorer.
- 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
- Open the
{aircraft_name}_Options.inifile in Notepad. - Add the following lines to the very end of the file:
[SDK] EnableDataBroadcast=1 EnableCDUBroadcast.0=1
- Save the file.
- 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.
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
- 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.
After restarting, FSFO should detect an en-* 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.
Voice recognition troubleshooting
Use this section for microphone, Windows permissions, and voice recognition accuracy problems.
Basic microphone checks
- 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:
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
- 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
- Lower
Input_VoiceAccuracyif commands are being missed. - Increase
Input_VoiceAccuracyif 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
No microphones found
Use these steps if FSFO shows no available input devices.
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:
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
- 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.
FSFO Crashes
FSFO crashes or closes unexpectedly

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
- 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
FSFO.exeis listed in the General field. - Click the Details tab.
- Copy the contents.
- Email the details to support.
Still Need Help?
If your issue is not resolved after following the steps above, see Support.



