Index

Home
Introduction
Configuring XPax
Using XPax
Main Screen
Manifest Screen
Diagram Screen
Aircraft Screen
Report Screen
Options Screen
Networked Configuration
Credits

Appendix
SimConnect Troubleshooting

Networked Configuration

XPax can be used in a networked configuration where FSX or FS9 runs on a different computer.  FSX must be the "Deluxe" version which includes the SimConnect interface installation.  For FS9, FSUIPC 3.75 (or later) must be installed which is available from http://www.schiratti.com/dowson.html.

Configuring SimConnect (For use with FSX)

Important requirements for networked configuration:
  • FSX Deluxe version ONLY (standard does not include the SDK or required simconnect client installation files)
  • FSX Service Pack 1 update applied (http://www.fsinsider.com)
  • FSX SDK installed from FSX Deluxe Disk 1 (\SDK folder setup.exe)
  • FSX SDK SP1A update applied (http://www.fsinsider.com)
  • The computer to run FSX (hereby named SERVER) and the computer(s) to run SimConnect add-ons (hereby named CLIENT(s)) must be appropriately configured for normal IP networking
  • Firewall software must be configured to allow SimConnect communications on the port you set (we suggest port 500) – This includes windows firewall – and applies to all computers, both SERVER and CLIENT(s)
  • FSX SP2/Acceleration may also be installed but is not required.  In either case, SP1 and SP1A SDK is REQUIRED for XPax to properly connect.

Step 1: Verify requirements

Look through the above requirements and ensure everything is setup properly and all FSX SDK & update installations have been run.

Step 2: SimConnect.xml

In order for local as well as remote add-ons to operate correctly within FSX, care must be taken to have a proper SimConnect.xml configuration file setup.

You will need two Comm sections, one global (for network connections) and one local (for local connections).

A sample recommended SimConnect.xml file is located in your XPax installation folder (Program Files\HiFi\XPax).

Copy this file to your [ApplicationDataFolder]\Microsoft\FSX folder then edit it to adjust the values shown (ApplicationDataFolder is:
For Windows XP: C:\Documents and Settings\[USERNAME]\Application Data\
For Vista: C:\Users\[USERNAME]\AppData\Roaming\):

First <Simconnect.Comm> Section (global)

For Protocol,
IPv4 should be used.
Example: <Protocol>IPv4</Protocol>

For Address,
use either the computer name or the physical IP address of this SERVER.  This MUST be correct and the same address specified in the client's simconnect.cfg file.
Example: <Address>192.168.1.102</Address>

For Port,
use any port you wish to enable for SimConnect communications.  We suggest port 500.  This port will need to be enabled in any software firewall programs you are running (including windows firewall).
Example: <Port>500</Port>

Here is an example:

<SimConnect.Comm>
  <Disabled>False</Disabled>
  <Protocol>IPv4</Protocol>
  <Scope>global</Scope>
  <Address>192.168.1.102</Address>
  <MaxClients>64</MaxClients>
  <Port>500</Port>
  <MaxRecvSize>4096</MaxRecvSize>
  <DisableNagle>False</DisableNagle>
</SimConnect.Comm>

Second <Simconnect.Comm> Section (local)

It is important that the local section be exactly as specified otherwise local connections may not work correctly:

<SimConnect.Comm>
  <Disabled>False</Disabled>
  <Protocol>Auto</Protocol>
  <Scope>local</Scope>
</SimConnect.Comm>

Step 2: SimConnect.ini

The configuration values here are less important, however it is helpful to have the debug console activated (console=1) to be able to see when SimConnect is appropriately making a connection and talking to the client applications.

We suggest the default values throughout:
Change console to 0 (console=0) to disable to debug console.

Step 3: Installing SimConnect client on CLIENT(s)

There is a simconnect.msi installation file located in the SDK installation folder\SDK\Core Utilities Kit\SimConnect SDK\lib.  This file should be copied to each CLIENT machine and run in order to install the appropriate SimConnect client files.  Remember to update your SDK to SP1A (or latest) before doing this.

Step 4: Configure CLIENT(s)

There is a single configuration file needed on all clients:
[MyDocumentsFolder]\SimConnect.cfg

MyDocumentsFolder is:
For Windows XP: C:\Documents and Settings\[USERNAME]\My Documents\.
For Vista: C:\Users\[USERNAME]\Documents\.

There is an example file located in your FSX SDK installation folder (normally C:\Program Files\Microsoft\Games\Flight Simulator X SDK\SDK\Core Utilities\SimConnect SDK\config).  We also have included a sample file in your XPaxinstallation folder.  We suggest copying this file to the appropriate location and then modifying as follows:

The values for Protocol, Address and Port must be configured exactly the same as you have configured for the server’s SimConnect.xml file global section.  We recommend the other values be left default.

Here is an example SimConnect.cfg file:
[SimConnect]
Protocol=IPv4
Address=192.168.1.102
Port=500
MaxReceiveSize=4096
DisableNagle=0

The SimConnect.cfg file needs to be set for all client computers that will be running addons that need to connect to FSX on the server.

Step 5: Test the configuration

Using the samples provided in the SDK, you can easily test for proper networked simconnect configuration.  The AI Traffic.exe example program (located in the SDK Installation folder\SDK\Core Utilities Kit\SimConnect SDK\Samples\AI Traffic) should be run after the SERVER’s FSX has been started.  If successful, the AI Traffic program will bring up a console window indicating “Connected to Flight Simulator!”.  If unsuccessful, the program will run and end immediately without any “Connected” message shown.  If you have the debug console enabled on server (console=1 in the SimConnect.ini file) then you’ll see some messages indicating connection and communication with the client.

Troubleshooting SimConnect:

If you are unable to get things working properly, please check for the following common issues:

  • Standard networking not properly configured between computers
  • SimConnect.xml, SimConnect.ini and/or SimConnect.cfg not properly existing or configured properly and in the proper locations
  • Port not enabled via software firewalls
  • Improper computer name or ip address set in the Address fields of the .xml and .cfg files
  • Protocol not set for IPv4 in .xml and/or .cfg files
  • SimConnect.msi installer not run on client machine
If you have continued problems, contact Microsoft support for assistance.