Skip to content

Commit

Permalink
v1.5 readme update
Browse files Browse the repository at this point in the history
  • Loading branch information
mracko authored Feb 5, 2021
1 parent f5a4dee commit 9899510
Showing 1 changed file with 24 additions and 20 deletions.
44 changes: 24 additions & 20 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,11 +2,12 @@
MSFS Mobile Companion App is a tool that allows you to control essential aircraft instruments such as NAV/COM frequencies, autopilot or lights using almost any mobile device. The MSFS Mobile Companion App is free to use.

Screenshot of MSFS Mobile Companion App in action:
![](images/MSFS_MCA_Screenshot_v1_4.png)
![](images/MSFS_MCA_Screenshot_v1_5.png)

### MSFS Mobile Companion App features:

- Moving Map (Open Street Maps).
- Moving map (Open Street Maps).
- Load flight plan into the map.
- NAV 1/2 frequency and OBS 1/2 selection.
- ADF frequency and ADF card selection.
- COM 1/2 and transponder selection.
Expand All @@ -17,35 +18,38 @@ Screenshot of MSFS Mobile Companion App in action:
- Landing ratings (vertical speed at touchdown).
- Simulation rate controls.

## Update Feb/05/2021 Version 1.5 Changelog:

## Update Jan/06/2021 Version 1.4 Changelog:

- Dedicated A320 autopilot controls (tested with default A320 and FBW A32NX v0.5.1).
- Various UI fixes, especially for iOS devices.
- UI improvements for color-blind users.

- Added landscape mode (split-screen for map and controls).
- Added option to load your current flight plan.
- Switched active and stand-by NAV/COM displays.

## How do I install MSFS Mobile Companion App?
1. Download the latest build [here](https://github.com/mracko/MSFS-Mobile-Companion-App/releases/).
2. That's it.

## How do I run MSFS Mobile Companion App?
1. Make sure your PC and your mobile device are connected to the same local network and that your home network is set to *Private* in your Network Profile settings.
2. Start a flight in Microsoft Flight Simulator.
3. Run MSFS_MCA_v1-4.exe that you've unzipped previously.
4. A Microsoft Defender security window may open when launching MSFS_MCA_v1-4.exe for the first time. Allow the "unrecognized app" to run. Additionally, a Windows Security Alert Window may open when you launch MSFS_MCA_v1-4.exe for the first time. Allow private network access for MSFS_MCA_v1-4.exe in the Windows Security Alert Window.
5. A command line window will open that will give you instructions on the IP-address where you can access the MSFS Mobile Companion App. Don't close the command line window.
6. Open the IP-address in your mobile device's web browser. The IP address will most likely be something like *192.168.0.XXX:4000*.
**Don't install the app on your mobile device. Download and run it on your PC. This creates a local web server to which you connect from your mobile device via an IP address.**
1. Open the settings.txt file, that you’ve unzipped together with the MSFS_MCA_v1-5.exe and this guide, and change the last line to reflect your Microsoft Flight Simulator installation folder. This step is only necessary if you wish to use the Load Flight Plan functionality. Hint:
- MS Store users: C:\Users\YOURUSERNAME\AppData\Local\Packages\Microsoft.FlightSimulator_8wekyb3d8bbwe\
- Steam users: C:\Users\YOURUSERNAME\AppData\Roaming\Microsoft Flight Simulator\
2. Make sure your PC and your mobile device are connected to the same local network and that your home network is set to *Private* in your Network Profile settings.
3. Start a flight in Microsoft Flight Simulator.
4. Run MSFS_MCA_v1-5.exe that you've unzipped previously.
5. A Microsoft Defender security window may open when launching MSFS_MCA_v1-5.exe for the first time. Allow the "unrecognized app" to run. Additionally, a Windows Security Alert Window may open when you launch MSFS_MCA_v1-5.exe for the first time. Allow private network access for MSFS_MCA_v1-5.exe in the Windows Security Alert Window.
6. A command line window will open that will give you instructions on the IP-address where you can access the MSFS Mobile Companion App. Don't close the command line window.
7. Open the IP-address in your mobile device's web browser. The IP address will most likely be something like *192.168.0.XXX:4000*.

*Notice: You can launch MSFS Mobile Companion App directly from your PC's browser. In that case, just type in localhost:4000 in your browser's url bar.*

## Known issues:
- Changes to COM frequencies in the A320 will not be shown in the cockpit but will work nevertheless. To force an update of the frequency in the cockpit switch from VHF1 to VHF2 and then back to VHF1 (this is for COM1 frequencies).
- NAV/COM frequencies can get out of sync, especially when rapidly pressing frequency adjustment buttons. Use the "Force Sync Frequencies" button to synchronize frequencies with the sim.
- NAV/COM frequencies are not automatically synchronized when starting a second flight. Use the "Force Sync Frequencies" button to synchronize frequencies with the sim.
- You may see landings with a vertical speed between 0 and 5 fpm in the app. This is caused by the sim recording the plane loading on ground at the start of a flight as a landing.
- Not all deicing and light controls (eg TBM-930) will work with every aircraft. Windshield deicing is currently not supported. This is currently caused by the limitations of SimConnect.
- The app may not work on a fresh Windows 10 installation. You may see a "Could not find MSFS running. Please launch MSFS first and then restart the MSFS 2020 Mobile Companion App." message even if MSFS is running. To fix this, please download and install the Microsoft Visual C++ 2015 Redistributable.
- Changes to COM frequencies in the A320 will not be shown in the cockpit but will work nevertheless. To force an update of the frequency in the cockpit switch from VHF1 to VHF2 and then back to VHF1 (this is for COM1 frequencies).
- When using the Load Flight Plan button without having a waypoint programmed in your plane’s GPS, you might see a dashed violet line pointing towards 0,0 GPS coordinates or to your last GPS waypoint from your previous flight.
- NAV frequencies can get out of sync, especially when rapidly pressing frequency adjustment buttons. Use the "Force Sync Frequencies" button to synchronize frequencies with the sim.
- NAV frequencies may not automatically synchronize when starting a second flight. Use the "Force Sync Frequencies" button to synchronize frequencies with the sim.
- You may see landings with a vertical speed between 0 and 5 fpm in the app. This is caused by the sim recording the plane loading on the ground at the start of a flight as a landing.
- Not all deicing and light controls will work with every aircraft (eg TBM-930). Windshield deicing is currently not supported. This is caused by the current limitations of SimConnect.
- The app may not work on a fresh Windows 10 installation. You may see a "Could not find MSFS running. Please launch MSFS first and then restart the MSFS 2020 Mobile Companion App." message even if MSFS is running. To fix this, please download and install the Microsoft Visual C++ 2015 Redistributable.

## Credits
MSFS Mobile Companion App is based on the Python [SimConnect](https://pypi.org/project/SimConnect/) project.
Expand Down

0 comments on commit 9899510

Please sign in to comment.