Documentazione in versione beta. Alcuni testi e immagini verranno rielaborati man mano che l'app si installa nella versione 1.0. Se una sezione risulta obsoleta, segnalala tramite il file modulo di feedback.

Simulatore di volo Microsoft 2024

FFB-Bridge comunica con MSFS 2024 tramite il trasporto TCP di SimConnect. In una nuova installazione di MSFS 2024 funziona immediatamente su Windows e richiede una singola modifica della configurazione in Linux/Proton. Quella del ponte Dottore page può fare la modifica per te: questa guida copre sia il percorso con un clic che quello manuale.

Che installazione MSFS hai?

La posizione predefinita di SimConnect dipende da come è stato installato MSFS. FFB-Bridge rileva automaticamente tutti e tre i casi, ma è utile sapere su quale ti trovi se qualcosa va storto.

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

Finestre – 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 Dottore. The 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 fila su Doctor offre un file 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 Doctor

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). Aperto Dottore; il Configurazione SimConnect la riga mostrerà la porta privilegiata e offrirà a Correggi… pulsante.

Finestra di dialogo Fix di FFB-Bridge Doctor su Linux che mostra un prefisso Proton rilevato e la porta TCP SimConnect che verrà installata
Figure 1. Finestra di dialogo Fix del medico su Linux. 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 takes precedence.

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 Simulazione simulata di SimConnect pagina, ripristinare la sorgente di ingresso Vivie il bridge rileverà la nuova configurazione. Su Linux puoi anche andare su Diagnostica e guarda 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, virata, 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 maniglia del cambio, indice della maniglia dei flap, posizione della maniglia dello spoiler
  • Percentuale di giri al minuto per motore e stato di combustione, spinta inversa inserita
  • Enumerazione del tipo di superficie (pista vs erba vs ghiaccio), deflessione del pedale del freno
  • Stato principale dell'autopilota, inclinazione/inclinazione comandate 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 non forza: molto spesso l'indicatore ARM nella striscia superiore è ancora DISINSERITO; coperto lì.
  • La pausa MSFS/Pausa attiva dovrebbe silenziare immediatamente gli effetti dinamici nella beta.11 e mantenere 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.