short instructions - xmapsyv3
TRANSCRIPT
Rev 3.2.1 24.10.2021
XMapsyV3 – Short Instructions
1. Description This helpful tool sends data of the own simulator aircraft and AI traffic information over your local network to various EFB solutions. In addition to the XPlane message format (now including the native RPOS-format), the version V3 now also includes an ADS-B simulation using the GDL90 format. Thus, traffic data can finally be transferred to popular programs such as SykDemon, Airmate, Aerovie, Air Navigation Pro or AVPlan EFB. Once launched, it will only be visible as an icon in the tray and automatically connect to the FSX, P3D MSFS2020 or X-Plane (10 or 11). The following table provides an overview of the apps tested till now with XMapsy V3 on IOS and Android (if available there) and their usable features with the XPlane /Simulator interface and the new ADS-B / GDL90 interface:
Rev 3.2.1 24.10.2021
All trademarks referenced herein are the property of their respective owners You can test the tool in a fully functional version with no time restrictions. Only the flight areas are limited to a wide area around EDDC (Dresden-Germany), NZAA (Aukland - New Zealand) , KLAS (Las Vegas - United States) and YPAD (Adelaide – Australia).
Rev 3.2.1 24.10.2021
2. Installation and Start: - Make sure that .Net Framework 3.5 or above is installed
- Make sure that the appropriate version of FSUIPC for your simulator is installed if you want to use FSUIPC technology. (You can get it from http://www.schiratti.com/dowson.html)
- Alternatively, you can use the Simconnect client - no additional installation is necessary for this.
- X-Plane users must install XUIPC (download from http://www.schiratti.com/xpuipc.html) and set the connection via FSUIPC in the XMapsy settings.
- Execute Setup.exe on the same computer where the FSX/P3D/MSFS 2020/X-Plane is running and follow the Instructions.
- After installation you will find this icon on the desktop:
- Start the tool by double-clicking on the icon. A notification-icon will appear in the tray:
Right Click the tray-icon for Settings, Documentation, Check for updates, About, GPX-File Management and Exit:
- The color of the icon indicates the connection status to the simulator, XMapsy V3 connects automatically to the FSX, P3D, MSFS2020 or X-Plane – no user-action is necessary!
o Red: no connection to the simulator
o Yellow: trying to connect
o Green: connected to simulator with FSUIPC, transmitting data to your EFB-Device
o Blue: connected to simulator with SIMCONNECT, transmitting data to Your EFB Device
o Red: and yellow: you are outside of the demo area
Rev 3.2.1 24.10.2021
Important - before using XMapsy, note the following:
• XMapsy must be installed on the same computer where the FSX, P3D, XPlane or MSFS 2020 is running.
• Check if the correct version of FSUIPC is installed if you want to use FSUIPC, X-Plane users must install XUIPC.
• Check your firewall, UDP-ports 49002 and 4000 must be open in your local network ( additionally ports 49000 and 49707 if you use AVPlan EFB or Air Navigation Pro).
• Check the settings in your EFB software. The Input must be set to simulation at Port 49002/ ADS_B/GDL90 at port 4000.
• Never launch different EFB apps on your tablet at the same time, which can cause problems in communication with the flight simulator.
• If you have problems, read the notes in Chapter 4. "In case of trouble"
Rev 3.2.1 24.10.2021
3. Automatic recording of your flights as GPX and KML files:
An additional feature is the automatic recording as GPX-Files of all your flights.
In order to use this feature, the option "GPX / KML recording" must be activated in the XMapsy-
settings.
You must also specify a directory in which the files to be saved.
If you are using MSFS2020, your flights will now be recorded automatically.
XMapsy tries to recognize the departure and destination airports and to name the files accordingly.
This works very well in most cases, but if 2 airports are very close to each other problems can arise.
For example if you do not start your flight at the gate / on a parking position but directly on a runway
and this point is perhaps is located closer to the center of the 2. airport, wrong decisions can be
made here come.
When the flight has ended (i.e. you are back in the main menu of the Simulator), the recording is
ended and the recorded GPX file additionally was converted into a KML file. You can open this KML
file directly in Google Earth.
The recording is currently every 2 seconds; the temperature, wind direction and wind strength
currently measured on the aircraft are also recorded for each recording.
This data can then be displayed in Google Maps or other suitable software.
KML files generated by XMapsy can also be imported into FlightControlReplay (needs the autumn
update of fcr) and Sky-Dolly (the flight must last at least 12 minutes) and this tools can be used to
generate a replay in MSFS 2020 (to look at the flight route again later in the simulator and maybe
also to take some nice screenshots).
Rev 3.2.1 24.10.2021
You can end the current GPX recording at any time via the context menu of the XMapsy tray icon,
after which a new recording is automatically started again.
The temporarily switch off the recording via the menu item
"Disable GPS-Recording" (applies up to a restart of XMapsy) is also possible.
This may be helpful in some situations, for example when you are watching a replay.
The automatic detection of the beginning and end of a flight works without restrictions
with MSFS2020 and X-Plane.
If you use FSX or P3D, you need to use fsuipc for the automatic detection of the flights (the
unregistered version is sufficient). With a connection via simconnect you have to stop recording the
flight manually (if you fly with FSX or P3D) via the context menu of the XMapsy-tray icon.
Rev 3.2.1 24.10.2021
4. Settings: With the various settings you can customize and optimize XMapsy:
Select message format: Use XPlane/simulator format or use ADS-B/GDL90 format
XMapsyV3 can transmit the data in XPlane format or it can simulate an ADS-B device and send the data in GDL90 format. For one of the two variants you have to decide, the simultaneous use of both methods has not proven in practice. The advantage of the GDL-90 format is that many EFB solutions can display the AI traffic of the flight simulator (such as SkyDemon, AirMate, AvPlan EFB, OzRunways, FlyQ, Aerovie or ForeFlight.) If you select the XPlane format, the traffic is only recognized by Foreflight, Garmin Pilot and FlyQEFB so far.
Select preferred technology: Use FSUIPC, SIMCONNECT or automatic mode
XMapsy can connect to the flight simulator using various technologies. Here you determine which technology XMapsy should use to establish a connection. For FSX and P3D - users FSUIPC or SIMCONNECT are a suitable option. For Microsoft Flight Simulator 2020 users, SIMCONNECT is the recommended option. X-Plane users must install XUIPC (download from http://www.schiratti.com/xpuipc.html) and set the preferred technology to FSUIPC. If you choose the automatic mode, XMapsy will automatically try to find a suitable technology. First an attempt is made to establish a connection via FSIUPC, if this is not possible, an attempt is made to establish a connection via SIMCONNECT.
Rev 3.2.1 24.10.2021
Position / AHRS-data
Send AHRS-data (pitch, roll..): If the checkbox is checked, information about pitch and roll will
be transmitted in addition to the normal position messages. Use calculated heading:
When checked, the heading will be calculated based on the change in
position just as in the real GPS device.
If it is not checked, the heading provided by the simulator will be used.
GDL90 ownship geometric altitude based on MSL:
Normally the own altitude in ADS-B / GDL90 mode is transmitted as geometric altitude
(height above WGS-84 ellipsoid).
However, some EFBs do not work correctly according to the GDL90 specification
and expect the MSL height here.
If you check the box, the altitude will be sent via MSL.
Try it if the height is not displayed correctly. For some programs
(for example, SkyDemon) this chekbox must not be activated.
Use SkyDemon Mode:
If you are using SkyDemon in GDL90 mode, activate this checkbox.
A special logic then helps to avoid disconnections and gaps in your tracklog.
Send alternate data-format (AVPlan EFB): If you use AvPlan EFB or Air Navigation Pro with the XPLANE / simulator mode this field must be
activated.
Activate this option also if you use an APP that only supports the native XPlane protocol (RPOS).
Own aircraft HEX-code:
You can deposit the HEX code of your own aircraft here. Some EFB apps
evaluate this to avoid false alarms in the traffic detection.
Send AHRS-data every xxx milliseconds:
AHRS messages are transmitted at this frequency. Recommended: 200 ms = 5 Hz
Multiplier for defining the transmission rate of the position data:
Multiplier for defining the transmission rate of the position data based
on the transmission rate of the AHRS messages.
Example: AHRS messages are sent every 200ms, the multiplier is 5.
So the position messages (5x200ms = 1) are sent every 1 second.
Traffic Data
Send traffic data (via XPlane/simulator- or ADS-B/GDL90- Interface):
If this checkbox is activated, the data of all simulated AI aircraft
within the designated radius will be transferred to your EFB App.
If you are working in XPLANE / Simulator mode, this feature is only supported by ForeFlight.
Therefore, it is better to run Xmapsy in ADS-B / GDL-90 mode, as a large
amount of EFB Apps support the display of traffic.
Rev 3.2.1 24.10.2021
Consider traffic within xxx nautical miles around you:
Consider traffic within xxx nautical miles around you.
→If the range is set too large, there can be a lot of
traffic and the performance of XMapsy may get worse.
Adjust the value to your needs.
Send traffic data every xxx seconds:
The traffic data will be transferred every xxx seconds:
Test a little bit of what is best for your EFB program.
Four to five seconds have proven to be practicable.
Ignore planes on the ground:
Activate this option only when you want to
transfer data from AI-planes that are in the air.
Network
Broadcast to all devices in current subnet:
Define whether the data should be sent to all
devices in the current subnet or just a single IP address.
Send data to this broadcast address
The broadcast address suitable for your system of the subnet in which your tablets with the EFB apps are
running is suggested by XMapsy and should work in most cases.
Only change the suggested value if you have problems receiving the flight simulator coordinates with
your EFB app or if you only want to send the data to the IP address of an EFB device.
You can restart the automatic determination of the broadcast address using the button next to the
input field.
Send data to specific IP address
The IP address of your tablet with the EFB app.
Send GDL90 Messages to port:
The default port is 4000, which should not be
changed without a reason.
Expert-Mode:
Normally, the data is sent over the network either in X-Plane/Simulator-format or in GDL90-format.
When Expert-Mode is activated, both formats are transmitted at the same time.
However, this can cause problems due the increased network traffic or malfunctions
in some EFB apps. So be careful when you activate Expert Mode and check
whether you really need both formats at the same time.
GPX/KML
Record gpx/kml files:
If this checkbox is activated, XMapsy saves all your flights
as a GPX and KML file. XMapsy tries to name the files automatically
according to the departure and destination airports.
Logging
Generate log file:
If there are problems, it may be useful to create a log file and send it
to the developer. But beware, the log file can get very large and slow
down the system.
Do not activate this checkbox during normal operation but only
for troubleshooting.
Rev 3.2.1 24.10.2021
5. In case of trouble:
• XMapsy must be installed on the same computer where the simulator is running.
• Check if the correct version of FSUIPC is installed if you want to use FSUIPC.
• Check your firewall, UDP-ports 49002 and 4000 must be open in your local network ( additionally
ports 49001 and 49707 if you use AVPlan EFB or Air Navigation Pro).
• Check the settings in your EFB software. The Input must be set to simulation at Port 49002/
ADS_B/GDL90 at port 4000.
• Disable the internal GPS of your mobile device.
• Uncheck „use calculated heading“.
• Try to use a different connection technology (you can select FSUIP or SimConnect in the XMapsy
settings)
• Change the frequency with which the data is sent in the settings [send AHRS Data every xxx
milliseconds] . When you are using Synthetic Vision, 200 milliseconds is a good value, but for some
apps this data rate is too fast. In this case, choose a higher value or increase the multiplier.
• Never launch different EFB apps on your tablet at the same time, which can cause problems in
communication with the flight simulator.
• Sometimes there are problems (special behavior of WIN 10) if you have multiple network Adapters
(including virtual ones) on your simulator PC. Then the broadcast data will not sent to all network
adapters. In this case please change the default broadcast address in XMapsy-settings to the
Broadcast address of your prefered subnet. For example, if your tablet with the EFB software has the
IP address 192.168.1.30, the correct subnet mask is 192.168.1.255.
• If you use SkyDemon in GDL90 mode, remember to activate the option „use SkyDemon mode“ in the
XMapsy settings..
• Garmin Pilot users with IOS-Devices: It is no longer possible to send the data via the
broadcast address. So you have to enter the IP address of the iPad in the XMapsy settings
(as it is displayed in the Garmin Pilot settings).
• In the case of problems, always check whether your EFB app has been updated.
• X-Plane users must install XUIPC (download from
http://www.schiratti.com/xpuipc.html) and set the connection via FSUIPC in the
XMapsy settings.
If there are still problems, you will receive support quickly at [email protected].
For news and additional infos, check the XMapsy website https://xmapsy.com.
Rev 3.2.1 24.10.2021
6. some hints for different EFB-apps All trademarks referenced herein are the property of their respective owners . The listing makes no claim to completeness. XMapsy can also work with EFB-Apps that I have not tested yet.
6.1 AirMate Settings for ADS-B/GDL90 Mode Settings for XPlane/Simulator Mode
Rev 3.2.1 24.10.2021
6.2 SkyDemon Allow both devices in the settings and choose one of the two to fly.
Rev 3.2.1 24.10.2021
6.3 ForeFlight Foreflight automatically detects the correct mode Calibrate pitch and Roll !!
Rev 3.2.1 24.10.2021
6.4 Garmin Pilot GarminPilot only supports XPlane/Simulator mode. It is no longer possible to send the data via the broadcast address. So you have to enter the IP address of the iPad in the XMapsy settings (as it is displayed in the Garmin Pilot settings).
Rev 3.2.1 24.10.2021
6.5 Aerovie Settings for XPlane/Simulator Mode (The ADS-B/GDL90 mode is detected automatically).
Rev 3.2.1 24.10.2021
6.7 AvPlan EFB Settings for XPlane/Simulator Mode (The ADS-B/GDL90 mode is detected automatically).
Do not forget to activate the "Send alternate data-format" checkbox in the XMapsy settings.
Rev 3.2.1 24.10.2021
6.11 FltPlan Go Settings for ADS-B/GDL90 Mode
Settings for XPlane/Simulator Mode
Rev 3.2.1 24.10.2021
6.12 Stratus Insight Settings for XPlane/Simulator Mode (The ADS-B/GDL90 mode is detected automatically).
Rev 3.2.1 24.10.2021
6.13. Air Navigation Pro Settings for XPlane/Simulator Mode
Do not forget to activate the "Send alternate data-format" checkbox in the XMapsy settings.
Rev 3.2.1 24.10.2021
6.14 WingX Pro Settings for XPlane/Simulator Mode (The ADS-B/GDL90 mode is detected automatically).
Rev 3.2.1 24.10.2021
6.15 iFly GPS GDL90 mode or simulator mode are recognized automatically. However, you must be in an area
with map coverage.
If we are using the simulator mode, activate the option "send alternate data-format" in the
XMapsy settings.