Documentazione della versione corrente FFB-Bridge 1.4.0 Hai trovato un’indicazione obsoleta? Segnalala nel modulo di feedback.

Microsoft Flight Simulator 2024 e 2020

FFB-Bridge comunica con Microsoft Flight Simulator tramite il trasporto TCP di SimConnect: entrambi MSFS 2024 e MSFS 2020 sono supportati. In una nuova installazione funziona immediatamente su Windows e richiede una singola modifica di configurazione in Linux/Proton. Quella del ponte Pagina di supporto (barra laterale → Supporto → Controlli di integrità) può fare la modifica per te: questa guida copre sia il percorso con un clic che quello manuale.

Solo Windows e Linux

MSFS si connette su Windows e Linux. La build macOS supporta solo X-Plane: vedi X-Plane 11 / 12.

Quale installazione di MSFS si possiede?

La posizione predefinita di SimConnect dipende da come è stato installato MSFS. I percorsi seguenti si riferiscono a MSFS 2024, che FFB-Bridge rileva automaticamente in tutte e tre le origini di installazione. Aiuta a sapere su quale ti trovi se qualcosa va storto.

MSFS 2020

MSFS 2020 si connette allo stesso modo tramite SimConnect TCP. Il rilevamento automatico del bridge e le correzioni del controllo dello stato con un clic prendono di mira il file di configurazione del 2024, quindi su 2020 potrebbe essere necessario confermare la porta utilizzata dal bridge (l'impostazione predefinita è 500 su Windows). Se 2020 è in ascolto su una porta non standard, impostala da Configurazione SimConnect Riga di controllo dello stato o punta il ponte direttamente verso il file FFB_BRIDGE_MSFS_CONFIG=<path-to-SimConnect.xml>.

InstallaSimConnect.xml posizione
Win Steam / standalone %APPDATA%\Microsoft Flight Simulator 2024\SimConnect.xml
Win Microsoft Store/Xbox Game Pass %LOCALAPPDATA%\Packages\Microsoft.Limitless_8wekyb3d8bbwe\LocalCache\SimConnect.xml
Linux Steam + Proton ~/.steam/steam/steamapps/compatdata/2537590/pfx/drive_c/users/steamuser/AppData/Roaming/Microsoft Flight Simulator 2024/SimConnect.xml

Windows – fuori dagli schemi

Ogni installazione standard di MSFS 2024 viene fornita con SimConnect TCP abilitato sulla porta 500, associato a tutte le interfacce IPv4. Per impostazione predefinita il bridge è 127.0.0.1:500 su Windows. Avvia MSFS, quindi avvia FFB-Bridge: il file Sim Il chip sulla dashboard dovrebbe diventare verde entro un secondo o due dal momento in cui la sim raggiunge il menu principale.

In caso contrario, apri il file Pagina di supporto ed esegui i controlli di integrità. Il Configurazione SimConnect row ti dice cosa ha trovato nell'XML e se la porta che sta utilizzando corrisponde alla porta con cui sta comunicando il bridge.

Porte diverse da 500

Alcuni strumenti – FSUIPC, SPAD.neXt – aggiungono le proprie voci TCP nello stesso SimConnect.xml. Se MSFS è in ascolto su una porta diversa da quella prevista dal bridge, il file Configurazione SimConnect riga nella scheda Controlli di integrità della pagina Supporto offre un servizio in linea Usa la porta:X pulsante. Fare clic e le preferenze del bridge verranno aggiornate su quella porta; non è necessario il riavvio di MSFS.

Linux - correzione con un clic tramite la pagina di supporto

MSFS sotto Proton spedisce lo stesso stock SimConnect.xml come la build di Windows, con TCP in ascolto sulla porta 500. Ma Linux tratta le porte inferiori a 1024 come privilegiate e il processo dello spazio dei nomi utente di Proton non può vincolarle. L'ascolto fallisce silenziosamente e nessun socket si apre mai.

La soluzione è aggiungere un parallelo <SimConnect.Comm> voce su una porta non privilegiata (il bridge utilizza 5111 per impostazione predefinita). Apri il Pagina di supporto → Controlli di integrità; il Configurazione SimConnect la riga mostrerà la porta privilegiata e offrirà a Correggi… pulsante.

Finestra di dialogo Correzione della pagina di supporto FFB-Bridge su Linux che mostra un prefisso Proton rilevato e la porta TCP SimConnect che verrà installata Finestra di dialogo Correzione della pagina di supporto FFB-Bridge su Linux che mostra un prefisso Proton rilevato e la porta TCP SimConnect che verrà installata
Figure 1. Finestra di dialogo di correzione su Linux (Supporto → Controlli di integrità → riga di configurazione SimConnect). Mostra il percorso del prefisso Proton trovato e la porta che sta per aggiungere. Facendo clic su Installa si unisce una nuova voce: le voci esistenti vengono lasciate intatte.

Correggi… unisce una nuova voce nell'XML esistente (non lo riscrive mai). Se il file esistente non è analizzabile, il programma di installazione ne esegue prima il backup come SimConnect.xml.bak-YYYY-MM-DD-HHMMSS e scrive una nuova configurazione generata. In ogni caso, riavvia MSFS dopo l'installazione in modo che rilegga SimConnect.xml.

Quale prefisso Proton?

FFB-Bridge analizza i noti prefissi di Steam, Steam-Flatpak, Heroic e Lutris. Se esegui MSFS da una posizione non standard, imposta FFB_BRIDGE_MSFS_PREFIX=/path/to/prefix nel tuo ambiente prima di lanciare il bridge. Per una sostituzione bare metal del solo file XML, FFB_BRIDGE_MSFS_CONFIG=/path/to/SimConnect.xml ha la precedenza.

Configurazione manuale

Se preferisci modificare manualmente, l'XML si presenta così:

<?xml version="1.0" encoding="Windows-1252"?>
<SimBase.Document Type="SimConnect" version="1,0">
  <Descr>SimConnect Client Configurations</Descr>
  <Filename>SimConnect.xml</Filename>
  <!-- FFB-Bridge: unprivileged TCP for Proton-on-Linux -->
  <SimConnect.Comm>
    <Descr>FFB-Bridge TCP</Descr>
    <Protocol>IPv4</Protocol>
    <Scope>local</Scope>
    <Port>5111</Port>
    <MaxClients>64</MaxClients>
    <MaxRecvSize>41088</MaxRecvSize>
    <DisableNagle>False</DisableNagle>
  </SimConnect.Comm>
  <!-- Keep any existing entries below this line. -->
</SimBase.Document>

Dopo aver salvato, apri FFB-Bridge Mock Sim pagina, ripristinare la sorgente di ingresso In tempo realee il bridge prenderà la nuova configurazione. Puoi anche andare al Pagina di supporto → Diagnostica e controlla il registro SimConnect connesso dopo aver riavviato MSFS.

SimVars letti dal bridge

Per riferimento, non è necessario configurare nulla di tutto ciò, ecco il set di MSFS SimVar a cui si iscrive il bridge:

  • AIRSPEED INDICATED
  • AIRSPEED MACH
  • G FORCE
  • ELEVATOR POSITION
  • AILERON POSITION
  • ELEVATOR TRIM PCT
  • AILERON TRIM PCT
  • STALL WARNING
  • OVERSPEED WARNING
  • SIM ON GROUND
  • GROUND VELOCITY
  • VERTICAL SPEED
  • BRAKE LEFT POSITION
  • BRAKE RIGHT POSITION
  • GEAR HANDLE POSITION
  • FLAPS HANDLE INDEX
  • TRAILING EDGE FLAPS LEFT PERCENT
  • TRAILING EDGE FLAPS RIGHT PERCENT
  • AUTOPILOT MASTER
  • SPOILERS HANDLE POSITION
  • ROTATION VELOCITY BODY X
  • ROTATION VELOCITY BODY Z
  • GENERAL ENG REVERSE THRUST ENGAGED:1
  • SURFACE TYPE
  • GENERAL ENG PCT MAX RPM:1
  • GENERAL ENG COMBUSTION:1
  • TITLE
  • ATC MODEL
  • CATEGORY
  • CAMERA STATE
  • ACCELERATION BODY X
  • ROTATION ACCELERATION BODY X
  • ROTATION ACCELERATION BODY Z
  • ROTATION ACCELERATION BODY Y
  • CRASH FLAG
  • ELEVATOR DEFLECTION
  • AILERON LEFT DEFLECTION
  • INCIDENCE BETA
  • ENG VIBRATION:1
  • CONTACT POINT COMPRESSION:0
  • CONTACT POINT COMPRESSION:1
  • CONTACT POINT COMPRESSION:2
  • AUTOPILOT FLIGHT DIRECTOR BANK
  • AUTOPILOT FLIGHT DIRECTOR PITCH
  • ACCELERATION BODY Z
  • ROTOR RPM PCT:1
  • ROTOR GOV ACTIVE:1
  • COLLECTIVE POSITION

Se MSFS non riconosce un nome di variabile, il bridge lo registra come avviso sul file Diagnostica pagina ma continua: le variabili mancanti vengono impostate automaticamente su zeri ragionevoli. Questo è il modo in cui il bridge tollera gli aerei di terze parti che non implementano ogni SimVar.

Risoluzione dei problemi

Vedi Risoluzione dei problemi per:

  • MSFS si connette ma nessuna forza: il più delle volte l'indicatore ARM nella striscia superiore è ancora DISARMATO; trattato lì.
  • La pausa MSFS / Active Pause silenzia immediatamente gli effetti dinamici e mantiene una molla neutra durante la pausa.
  • Se un lungo balbettio o una pausa riducono la forza di rollio dopo la ripresa, esporta un pacchetto di supporto e invia il feedback dalla stessa sessione.