Versione attuale. FFB-Bridge v1.2.1 è disponibile. Questa documentazione segue l'app attuale descritta dal manifesto di rilascio. Se una sezione sembra superata, segnalala tramite il 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
Figura 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:

  • Velocità (indicata, vera), altitudine, velocità verticale, beccheggio, inclinazione, rotta
  • Forza G, angolo di attacco, avviso di stallo, avviso di velocità eccessiva
  • Deviazione di elevatore, alettone e timone (trimmati e grezzi)
  • Posizioni del trim (elevatore, alettone, timone)
  • Stato della leva del carrello, indice della leva dei flap, posizione della leva dello spoiler
  • Percentuale di giri al minuto per motore e stato di combustione, inversione di spinta inserita
  • Enumerazione del tipo di superficie (pista vs erba vs ghiaccio), deflessione del pedale del freno
  • Stato principale dell'autopilota, beccheggio/inclinazione comandati dall'autopilota

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.