Troubleshooting: Difference between revisions

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


<div style="margin:0.8em 0; padding:0.8em 1em; background:#eef3fb; border-left:6px solid #1f4fa3;">
Use this page when something is not working as expected before contacting support.
Use this page when something is not working as expected before contacting support.
</div>


Unless a section says otherwise, always start programs in this order: MSFS → FSUIPC7 → FSFO.
<div style="margin:0.6em 0; padding:0.8em 1em; background:#fdf7f2; border-left:6px solid #f0ad4e;">
Unless a section says otherwise, always start programs in this order: <strong>MSFS → FSUIPC7 → FSFO</strong>.
</div>


<span id="top"></span>
<span id="top"></span>
Line 9: Line 13:


== 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;">
This usually indicates a communication issue between FSFO, FSUIPC7, and the aircraft LVAR system.
This usually indicates a communication issue between FSFO, FSUIPC7, and the aircraft LVAR system.
</div>


=== Step 1: Verify FSUIPC7 is connected ===
=== Step 1: Verify FSUIPC7 is connected ===
Line 19: Line 26:
[[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;">
If LVARs are missing or the menu is disabled, the WASM module is not loaded.
If LVARs are missing or the menu is disabled, the WASM module is not loaded.
</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 display 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;">
If no version is shown, FSFO is not connected.
If no version is shown, FSFO is not connected.
</div>


=== Step 3: Confirm aircraft profile selection ===
=== Step 3: Confirm aircraft profile selection ===
On the Start Flight page, ensure the correct Aircraft Profile and Checklist are selected.
On the Start Flight page, ensure the correct Aircraft Profile and Checklist are selected.


Line 36: Line 49:


=== Step 4: Reinstall FSUIPC7 if needed ===
=== Step 4: Reinstall FSUIPC7 if needed ===
If the steps above fail:
If the steps above fail:


Line 48: Line 62:
## Allow the WASM module to install when prompted.
## Allow the WASM module to install when prompted.


<div style="margin:0.6em 0; padding:0.8em 1em; background:#eef3fb; border-left:6px solid #1f4fa3;">
After reinstall, start programs in this order:
After reinstall, start programs in this order:
 
<ol>
# Start MSFS and load into a cockpit.
<li>Start MSFS and load into a cockpit.</li>
# Start FSUIPC7 and confirm it shows Connected.
<li>Start FSUIPC7 and confirm it shows Connected.</li>
# Start FSFO last.
<li>Start FSFO last.</li>
</ol>
</div>


[[Troubleshooting#top|Back to top]]
[[Troubleshooting#top|Back to top]]
Line 58: Line 75:


== FSFO does not stay on top ==
== FSFO does not stay on top ==
<div style="margin:0.6em 0; padding:0.8em 1em; background:#eef3fb; border-left:6px solid #1f4fa3;">
This behavior is caused by Windows process-level restrictions.
This behavior is caused by Windows process-level restrictions.
</div>


Reasons:
Reasons:
Line 65: Line 85:
* Another application may re-assert its “Always on Top” flag after FSFO.
* 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;">
Restarting FSFO reapplies its topmost flag, but FSFO cannot remain above an admin-level window unless it is also run as Administrator.
Restarting FSFO reapplies its topmost flag, but FSFO cannot remain above an admin-level window unless it is also run as Administrator.
</div>


Workaround:
Workaround:
Line 76: Line 98:


== FSUIPC Error #12 (FSUIPC_ERR_SENDMSG) ==
== FSUIPC Error #12 (FSUIPC_ERR_SENDMSG) ==
<div style="margin:0.6em 0; padding:0.8em 1em; background:#fdf7f2; border-left:6px solid #f0ad4e;">
FSFO and FSUIPC7 must run at the same permission level.
FSFO and FSUIPC7 must run at the same permission level.
</div>


# Right-click FSFO and FSUIPC7.
# Right-click FSFO and FSUIPC7.
Line 87: Line 112:


== FSUIPC Error #2 ==
== FSUIPC Error #2 ==
<div style="margin:0.6em 0; padding:0.8em 1em; background:#fdf7f2; border-left:6px solid #f0ad4e;">
This error indicates a failed or incomplete FSUIPC connection.
This error indicates a failed or incomplete FSUIPC connection.
</div>


=== Quick restart sequence ===
=== Quick restart sequence ===
Line 109: Line 137:


== WASM version mismatch ==
== WASM version mismatch ==
<div style="margin:0.6em 0; padding:0.8em 1em; background:#fdf7f2; border-left:6px solid #f0ad4e;">
Error example: “WASM version X while WAPI expects Y”.
Error example: “WASM version X while WAPI expects Y”.
</div>


Recommended fix:
Recommended fix:
Line 115: Line 146:
* Reinstall the latest FSUIPC7 installer, which includes matching WASM and WAPI components.
* Reinstall the latest FSUIPC7 installer, which includes matching WASM and WAPI components.


<div style="margin:0.6em 0; padding:0.8em 1em; background:#eef3fb; border-left:6px solid #1f4fa3;">
Manual fix (advanced users):
Manual fix (advanced users):
</div>


# Close FSFO, MSFS and FSUIPC7
# Close FSFO, MSFS and FSUIPC7
Line 121: Line 154:
# Select Products > All Products > Download FSUIPC WASM Module 1.0.7 + WAPI 1.0.4 (version numbers will be different)
# 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
# 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)
# 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
# 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)
# Paste fsuipc-lvar-module folder in MSFS Community Folder (overwrite the existing folder)


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


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


=== FBW A320 or Headwind A330 – MCDU not programming ===
=== FBW A320 or Headwind A330 – MCDU not programming ===
Edit:<pre>
 
<div style="margin:0.6em 0; padding:0.8em 1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;">
Edit:
<pre>
Community\fsuipc-lvar-module\FSUIPC_WASM.ini
Community\fsuipc-lvar-module\FSUIPC_WASM.ini
</pre>Set:<pre>
</pre>
Set:
<pre>
UseAirLocForHvars=Yes
UseAirLocForHvars=Yes
</pre>Save and restart MSFS.
</pre>
Save and restart MSFS.
</div>
 
----


=== Headwind A330 – FCU or MCDU not responding ===
=== Headwind A330 – FCU or MCDU not responding ===
Copy:<pre>
 
<div style="margin:0.6em 0; padding:0.8em 1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;">
Copy:
<pre>
Community\fsuipc-lvar-module\modules\A320.hvar
Community\fsuipc-lvar-module\modules\A320.hvar
</pre>Rename the copy to:<pre>
</pre>
Rename the copy to:
<pre>
A330.hvar
A330.hvar
</pre>Restart MSFS.
</pre>
Restart MSFS.
</div>
 
----
 
=== 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;">
<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 and navigate to the appropriate PMDG work folder below.
 
==== MSFS 2020 Work Folder (per aircraft) ====
 
'''Store / Xbox Version'''
<div style="margin:0.4em 0; padding:0.7em 0.9em; 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.4em 0; padding:0.7em 0.9em; 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 (per aircraft) ====
 
'''Store / Xbox Version'''
<div style="margin:0.4em 0; padding:0.7em 0.9em; 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.4em 0; padding:0.7em 0.9em; 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>


=== PMDG aircraft – enable SDK data broadcast ===
# Open the <code>{aircraft_name}_Options.ini</code> file in a text editor such as Notepad.
# Add the following lines to the very end of the file:


# '''MSFS 2020''': C:\Users\****\AppData\Local\Packages\Microsoft.FlightSimulator_8wekyb3d8bbwe\LocalState\Packages\pmdg-aircraft-738\work\737_options.ini or '''MSFS 2024''': C:\Users\****\AppData\Local\Packages\Microsoft.Limitless_8wekyb3d8bbwe\LocalState\Packages\pmdg-aircraft-738\work\737_options.ini
<div style="margin:0.6em 0; padding:0.8em 1em; background:#f4f9f6; border-left:6px solid #5cb85c; border-radius:8px;">
# Right-click 737_options.ini → Open with → Notepad
# Add this to the very end of the file:
<pre>
<pre>
[SDK]
[SDK]
EnableDataBroadcast=1
EnableDataBroadcast=1
</pre>Save and restart MSFS.
EnableCDUBroadcast.0=1
</pre>
</div>
 
# Save the file and restart Microsoft Flight Simulator.
 
<div style="margin:0.6em 0; padding:0.8em 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>).''
</div>


[[Troubleshooting#top|Back to top]]
[[Troubleshooting#top|Back to top]]
Line 158: Line 261:


== No English speech recognizer installed ==
== No English speech recognizer installed ==
If you’re using the Microsoft Speech Engine, FSFO relies on English phrases to perform specific actions. Therefore, at least one English speech language pack must be installed. (Your Windows display language/region can be anything.)
 
<div style="margin:0.6em 0; padding:0.8em 1em; background:#fdf7f2; border-left:6px solid #f0ad4e;">
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.
</div>


If English is not installed:
If English is not installed:
Line 164: Line 270:
# 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, e.g., English (United States), English (United Kingdom)).
# Search for English (any variant is fine, for example English (United States) or English (United Kingdom)).
# Select the English language > Next.
# Select the English language > Next.
# Ensure Language pack and Speech are checked → Install.
# Ensure Language pack and Speech are checked → Install.
Line 171: Line 277:
After restart, FSFO should detect an <code>en-*</code> recognizer.
After restart, FSFO should detect an <code>en-*</code> recognizer.


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


# Click the three dots … next to the English language > Language options > under Speech, click Download (if not already installed).  
# Click the three dots … next to the English language > Language options > under Speech, click Download (if not already installed).
# Settings > Time & Language > Language > Add a preferred language > choose an English variant > make sure Speech is included in the install options.
# Settings > Time & Language > Language > Add a preferred language > choose an English variant > make sure Speech is included in the install options.


Line 181: Line 287:
== Voice recognition troubleshooting ==
== Voice recognition troubleshooting ==


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


'''Basic Checks:'''
* Microphone works?
* Microphone works?
** Open Voice Recorder (Windows) and make a short recording. If you can’t record, fix the mic first.
** Open Voice Recorder (Windows) and make a short recording. If you can’t record, fix the mic first.
Line 199: Line 308:


* Reasonable gain
* Reasonable gain
** In the same Levels tab, set between 70–90 to start. Avoid 100 + “boost” unless your mic is very quiet.  
** 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): ===


'''English Speech Pack Installed (required):'''
* FSFO relies on English phrases. At least one English speech recognizer must be installed.
* FSFO relies on English phrases. At least one English speech recognizer must be installed.
** Windows 11: Settings → Time & language → Language & region → Add a language → English → ensure Language pack and Speech are selected → Install → Restart.
** Windows 11: Settings → Time & language → Language & region → Add a language → English → ensure Language pack and Speech are selected → Install → Restart.
** Your Windows display language can be anything; only the English speech component is required.
** 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.
* Lower <code>Input_VoiceAccuracy</code> if commands are missed.
* Increase it if false triggers occur.
* Increase it if false triggers occur.
* To change accuracy setting go to FSFO > Settings > Train Speech > Next > Next > Next
* To change the accuracy setting go to FSFO > Settings > Train Speech > Next > Next > Next


=== Known Conflicts ===
'''Known Conflicts'''
Close applications such as Discord, Teams, NVIDIA Broadcast, Voicemeeter, or audio enhancement tools while testing.
Close applications such as Discord, Teams, NVIDIA Broadcast, Voicemeeter, or audio enhancement tools while testing.


Line 220: Line 327:


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


* '''Confirm Windows can see your mic'''
* '''Confirm Windows can see your mic'''
Line 227: Line 338:
* '''Allow microphone permissions'''
* '''Allow microphone permissions'''
** Windows Settings > Privacy & security > Microphone
** Windows Settings > Privacy & security > Microphone
** Turn ON:  
** Turn ON:
*** Microphone access
*** Microphone access
*** Let apps access your microphone
*** Let apps access your microphone
*** Let desktop apps access your microphone
*** Let desktop apps access your microphone
* '''Enable it in Control Panel (and set default)'''
* '''Enable it in Control Panel (and set default)'''
** Open Control Panel > Sound > Recording  
** Open Control Panel > Sound > Recording
** Right-click your microphone > Enable
** Right-click your microphone > Enable
** Right-click it again > Set as Default Device
** Right-click it again > Set as Default Device
** (Optional) Set as Default Communication Device too.
** (Optional) Set as Default Communication Device too.
* '''Basic Hardware Checks'''
* '''Basic Hardware Checks'''
** Make sure the mic isn’t muted (hardware switch / inline mute / headset button).
** Make sure the mic isn’t muted (hardware switch, inline mute, or headset button).
** Unplug/replug, try a different USB port (avoid hubs while testing).
** Unplug and replug, try a different USB port (avoid hubs while testing).
** If it’s Bluetooth, reconnect it and confirm the Headset/Hands-Free input is selected in Sound > Input.
** If it’s Bluetooth, reconnect it and confirm the Headset or Hands-Free input is selected in Sound > Input.


[[Troubleshooting#top|Back to top]]
[[Troubleshooting#top|Back to top]]
Line 245: Line 356:


== FSFO crashes ==
== FSFO crashes ==
When reporting crashes, include Windows Event Viewer logs.
 
[[File:EventView.png|left|thumb|186x186px]]
[[File:EventView.png|left|thumb|186x186px]]
<div style="margin-left:200px; margin-bottom:0.6em; padding:0.8em 1em; background:#fdf7f2; border-left:6px solid #f0ad4e;">
<strong>When reporting crashes, include Windows Event Viewer logs.</strong>
</div>


# Type Event Viewer in the Windows Search Bar
# Type Event Viewer in the Windows Search Bar
# Click on the Event Viewer App
# Click on the Event Viewer App
# Expand Windows Log > Expand Application
# Expand Windows Log > Expand Application
# Look for any Error messages associated with FSFO; FSFO.exe should be listed in the General field.  
# 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
# Click The Details Tab, Copy and Email the contents to support


[[Troubleshooting#top|Back to top]]
[[Troubleshooting#top|Back to top]]
Line 260: Line 373:
----
----


<div style="margin:1em 0; padding:0.8em 1em; background:#eef3fb; border-left:6px solid #1f4fa3;">
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 19:42, 8 February 2026

Common setup, connectivity, and configuration issues for Flight Simulator First Officer (FSFO).

Use this page when something is not working as expected before contacting support.

Unless a section says otherwise, always start programs in this order: MSFS → FSUIPC7 → FSFO.


Copilot does not move any switches

This usually indicates a communication issue between FSFO, FSUIPC7, and the aircraft LVAR system.

Step 1: Verify FSUIPC7 is connected

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

FSUIPC7 showing connected state and available LVARs

If LVARs are missing or the menu is disabled, the WASM module is not loaded.

Step 2: Verify FSFO is connected to FSUIPC7

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

FSFO showing FSUIPC7 version in the status bar

If no version is shown, FSFO is not connected.

Step 3: Confirm aircraft profile selection

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.

Aircraft profile selection on Start Flight page

Step 4: Reinstall FSUIPC7 if needed

If the steps above fail:

  1. Close MSFS, FSFO, and FSUIPC7.
  2. Reinstall the latest FSUIPC7 installer over the existing installation.
  3. If problems persist, 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.
    4. Reboot Windows.
    5. Install the latest FSUIPC7 as Administrator.
    6. Allow the WASM module to install when prompted.

After reinstall, start programs in this order:

  1. Start MSFS and load into a cockpit.
  2. Start FSUIPC7 and confirm it shows Connected.
  3. Start FSFO last.

Back to top


FSFO does not stay on top

This behavior is caused by Windows process-level restrictions.

Reasons:

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

Restarting FSFO reapplies its topmost flag, but FSFO cannot remain above an admin-level window unless it is also run as Administrator.

Workaround:

  • Run FSFO and FSUIPC7 at the same permission level.
  • Or disable Always-On-Top in competing applications.

Back to top


FSUIPC Error #12 (FSUIPC_ERR_SENDMSG)

FSFO and FSUIPC7 must run at the same permission level.

  1. Right-click FSFO and FSUIPC7.
  2. Select Properties → Compatibility.
  3. Ensure “Run as administrator” is either enabled for both or disabled for both.
  4. Restart both applications.

Back to top


FSUIPC Error #2

This error indicates a failed or incomplete FSUIPC connection.

Quick restart sequence

  1. Close FSFO, FSUIPC7, and MSFS.
  2. Reboot Windows.
  3. Start MSFS and load into a cockpit.
  4. Start FSUIPC7 (verify only one instance).
  5. Start FSFO and click Connect.

Additional checks

  • Ensure only one FSUIPC7 instance is running.
  • Disable Auto-Connect in FSFO temporarily and connect manually.
  • Whitelist FSFO and FSUIPC7 in antivirus or firewall software.

If unresolved, perform a clean FSUIPC7 reinstall.

Back to top


WASM version mismatch

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

Recommended fix:

  • Reinstall the latest FSUIPC7 installer, which includes matching WASM and WAPI components.

Manual fix (advanced users):

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

Back to top


Aircraft-specific issues

These issues apply only to specific aircraft or families.

FBW A320 or Headwind A330 – MCDU not programming

Edit:

Community\fsuipc-lvar-module\FSUIPC_WASM.ini

Set:

UseAirLocForHvars=Yes

Save and restart MSFS.


Headwind A330 – FCU or MCDU not responding

Copy:

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

Rename the copy to:

A330.hvar

Restart MSFS.


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 and navigate to the appropriate PMDG work folder below.

MSFS 2020 Work Folder (per aircraft)

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 (per aircraft)

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 a text editor such as Notepad.
  2. Add the following lines to the very end of the file:
[SDK]
EnableDataBroadcast=1
EnableCDUBroadcast.0=1
  1. Save the file and restart Microsoft Flight Simulator.

Where {username} is your Windows username and {aircraft_name} is the specific PMDG aircraft you are using (for example, 737).

Back to top


No English speech recognizer installed

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 English is not installed:

  1. Open Settings > Time & language > Language & region.
  2. Click Add a language.
  3. Search for English (any variant is fine, for example English (United States) or English (United Kingdom)).
  4. Select the English language > Next.
  5. Ensure Language pack and Speech are checked → Install.
  6. Restart Windows.

After restart, FSFO should detect an en-* recognizer.

If English is already listed or installed:

  1. Click the three dots … next to the English language > Language options > under Speech, click Download (if not already installed).
  2. Settings > Time & Language > Language > Add a preferred language > choose an English variant > make sure Speech is included in the install options.

Back to top


Voice recognition troubleshooting

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

Basic Checks:

  • Microphone works?
    • Open Voice Recorder (Windows) and make a short recording. If you can’t record, fix the mic first.
  • Privacy permissions (Windows 11):
    • Settings > Privacy & security > Microphone
      • Microphone access: On
      • Let desktop apps access your microphone: On
  • Correct input device
    • Settings > System > Sound > Input > Select the mic you’re using. Speak and confirm the input level moves.
  • No “exclusive mode” lock
    • Control Panel > Sound > Recording > [Your Mic] > Properties > Advanced
      • Uncheck Allow applications to take exclusive control (as a test)
  • Reasonable 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):

  • FSFO relies on English phrases. At least one English speech recognizer must be installed.
    • Windows 11: Settings → Time & language → Language & region → Add a language → English → ensure Language pack and Speech are selected → Install → Restart.
    • Your Windows display language can be anything; only the English speech component is required.

Accuracy Tuning

  • Lower Input_VoiceAccuracy 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 Close applications such as Discord, Teams, NVIDIA Broadcast, Voicemeeter, or audio enhancement tools while testing.

Back to top


No microphones found

Use these steps if FSFO shows no available input devices.

  • Confirm Windows can see your mic
    • Windows Settings > System > Sound > Input
    • Select your microphone under Choose a device for speaking or recording
    • Speak and verify the input level meter moves.
  • Allow microphone permissions
    • Windows Settings > Privacy & security > Microphone
    • Turn ON:
      • Microphone access
      • Let apps access your microphone
      • Let desktop apps access your microphone
  • Enable it in Control Panel (and set default)
    • Open Control Panel > Sound > Recording
    • Right-click your microphone > Enable
    • Right-click it again > Set as Default Device
    • (Optional) Set as Default Communication Device too.
  • Basic Hardware Checks
    • 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).
    • If it’s Bluetooth, reconnect it and confirm the Headset or Hands-Free input is selected in Sound > Input.

Back to top


FSFO crashes

When reporting crashes, include Windows Event Viewer logs.

  1. Type Event Viewer in the Windows Search Bar
  2. Click on the Event Viewer App
  3. Expand Windows Log > Expand Application
  4. Look for any Error messages associated with FSFO; FSFO.exe should be listed in the General field.
  5. Click The Details Tab, Copy and Email the contents to support

Back to top


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