Plugin installation instructions

Please check the following installation instructions

If you don't feel safe to follow these guidelines, you may want to consider purchasing our Installation support. We will then install the plugin (either demo or purchased version) on your computer, using remote control software like TeamViewer and/or Skype, Should we not succeed, we will fully refund the value of the installation support, as well as the cost for our CPFlight plugin you may already have purchased

When and how to run the installer

The plugin is installed and updated with a dedicated and specialized installer software. You can download the installer at https://www.midwest737simulations.com/downloads/installer

The installer supports several use cases and should be (re-)run in any of the following situations:

  • Installation of the free demo version
  • License installation or upgrade after purchasing a full version. See procedure below
  • Plugin update to a more recent version
  • License recovery
  • License update to support additional computers or after computer reinstallation

Please uninstall any existing CPFlight plugin and terminate any CPFlight test software before running the installer, as it would interfere with the installation process. As long as another software occupies the COM port, the Installer is unable to identify the MCP.

The installer must run on your X-Plane computer and has the following prerequisites

  • Java 8 (>= 1.8.0_101), 9 or 10 must be installed on your X-Plane computer. If you don't have it, download it here
  • A working internet connection
  • Your MCP must be connected

The installer comes as an executable JAR file. There's no need to unpack the downloaded .jar file. If you have Java installed, it should run by clicking on it. On OSX, Java requires programs to be signed, but it tells you what to do to run an unsigned JAR file.

We've had a single bug report that the installer only briefly shows the startup screen and then closes down automatically. Until now, we weren't able to fully trace down the problem, but the customer reported that the problem went when he started the installer with administrative privileges from the command line. Please mail us at support@midwest737simulations.com if you encounter this problem.

Upon start, the installer automatically verifies its version and asks you to download a new version if yours is outdated. It then guides you through the sequence of screens that install the plugin and the associated license.

How do I get and install my purchased license?

The first step is to purchase a version on the web store. If you are a first time customer, you will have to create a user name and password. Remember these well, because you will use them later in the installer to retrieve you license.

After completing the payment, rerun the installer.

The remaining procedure depends on whether the installer finds a valid or invalid demo license on your computer.

  • If you do not have any license installed - neither demo nor purchased:
    1. The installer will offer you to install a demo license. Click on "Retrieve purchased license".
    2. You'll see a screen asking for your web store credentials: user name and password. Please type them exactly as you did on your purchase on the web store. If you don't remember, click on "Open Web Store" and reset your password.
    3. The installer will now do another scan for valid licenses and show them in a list. Select the one you purchased and continue
  • If you have a valid demo license:
    1. The installer will state the fact that you have a valid license. Click the option "Request a new or existing license".
    2. The installer will show a list of options which contains the demo license. Make sure to choose "Retrieve purchased license".
    3. You'll see a screen asking for your web store credentials: user name and password. Please type them exactly as you did on your purchase on the web store. If you don't remember, click on "Open Web Store" and reset your password.
    4. The installer will now do another scan for valid licenses and show them in a list. Select the one you purchased and continue
    5. The installer asks you if you want to overwrite your current valid license. Confirm.
  • If your demo license has expired already, the process is straightforward:
    1. You'll see a screen asking for your web store credentials: user name and password. Please type them exactly as you did on your purchase on the web store. If you don't remember, click on "Open Web Store" and reset your password.
    2. The installer will scan for valid licenses on the server and show them in a list. Select the one you purchased and continue.

What can I do if my MCP is not found?

The installer queries all found USB COM ports and, optionally, a manually entered IP address for CPFlight MCPs. There are some reasons why this process can fail, but fortunately, all of them can be solved easily:

  • Problem: The MCP is not connected to your computer or your network.
    • Solution: Connect the MCP and make sure it's turned on.
  • Problem: You're trying to connect a CPFlight USB MCP on Windows and you don't have the standard serial driver installed. This is a Windows installation problem that should not happen, but we have received reports that it sometimes does occur.
    • Solution: Open the Windows device manager and check if there's an unrecognized USB device (yellow exclamation mark icon) in the "Ports (COM & LPT)" or "Other devices" section:
      If so, right-click on it, and then select "Properties...".

      Click on the "Driver" tab and then on "Update driver".

      On the next screen, select "Search automatically for updated driver software"

      This should automatically install the standard Windows USB COM port driver.

      You should now see the USB Serial port in the list of Ports (COM & LPT):
      If this doesn't work, please report the problem to support@midwest737simulations.com
  • Problem: You're using an Ethernet MCP and its IP address is not correctly configured
    • Solution: In contrast to the USB models, Ethernet MCPs can not be identified automatically. You need to manually configure an IP address on the MCP. This IP address must be reachable from your computer and no other device in your network may use the same address. Then you must set the same address in the installer software. There's a button called "I have an Ethernet MCP" on the "Check hardware" screen that guides you through the process.
  • Problem: Another software blocks access to the serial port
    • Solution: Make sure to terminate any other software that could try to gain access to the serial port the MCP is connected to. This mainly includes the original CPFlight software, which is the reason why we recommend to uninstall it. But we've also received reports that with an outdated Java version, another instance of our installer software was still running in background and had to be shut down through the Task manager. This very specific problem was resolved by updating to a current version of Java
  • Problem: You're using an RS232 version of the MCP without a supported USB-to-serial converter
    • Solution: At this point, the formerly sold RS-232 versions are supported only through an FTDI or Prolific USB-to-serial converter. Make sure to install a supported driver for these converters as well
If none of these suggestions resolve your problem, please write us at support@midwest737simulations.com and we'll do our best to find out what's going on. For example, we've had a single case where the MCP lost its serial number and therefore was not recognized by the installer. This wasn't easy to find and certainly is a very uncommon case, where the MCP actually worked with a different software that didn't query the serial number. 

License policy

Every MCP is entitled for a free 14 day demo license. After that period, running the plugin requires a valid purchased license. The license is tied to the MCP and can be transferred to another user without cost. In order for the new user to be able to request copies of the license, he or she should get in touch with us and require a license transfer in the web store.

Furthermore, a license for the same MCP can be used on up to five computers. If you reinstalled you computer from scratch, please rerun the installer and it will be included in the list of authorized computers. If you require a license to work on more than five different computer ids, please get in touch with us.

Captured data

During installation, the installer program captures some technical information about your computer and MCP and transmits it to our server:

  • Computer identification as defined by operating system:
    • Windows: registry entry Software\Microsoft\Cryptography\MachineGuid
    • Linux: result of function call dbus_get_local_machine_id()
    • OSX: IORegistry kIOPlatformUUIDKey value
  • Enumeration of devices connected to USB ports and information if they are identified as serial ports
  • Initial communication of devices identified as MCP candidates

From this information, only the CPFlight MCP serial number and the computer ID are effectively used for the issued license. The remaining items are debug data used exclusively to identify possible problems during the installation process.

A typical set of (anonymized) installation data looks like this:

 
VERSION=1 
MACHINE_ID=pppppppp-qqqq-rrrr-ssss-tttttttttttt 
MCP_ID=XXXXXXX 
; 
; Additional information: ; ADD EVENT: usb-1-2@0 xxxx:xxxz (hid) \\.\HID#VID_xxxx&PID_xxxz#6&aaaaaaaa&0&0000#{xxxxxxxx-yyyy-hhhh-vvvv-wwwwwwwwwwww} 
; ADD EVENT: usb-1-3-3@0 0403:6001 (serial) COM2 ; Possible CPFlight panel detected, will be tested 
; ADD EVENT: usb-1-12@1 bbbb:cccc (hid) \\.\HID#VID_bbbb&PID_cccc&MI_01&COL01#7&3FF52B&0&0000#{xxxxxxxx-yyyy-hhhh-vvvv-wwwwwwwwwwww} 
; ADD EVENT: usb-1-3-2@0 dddd:eeee (hid) \\.\HID#VID_dddd&PID_eeee#7&jjjjjjj&0&0000#{xxxxxxxx-yyyy-hhhh-vvvv-wwwwwwwwwwww} 
; ADD EVENT: usb-1-1@0 xxxx:ffff (hid) \\.\HID#VID_xxxx&PID_ffff#6&kkkkkkkk&0&0000#{xxxxxxxx-yyyy-hhhh-vvvv-wwwwwwwwwwww} 
; ADD EVENT: usb-1-13@0 xxxy:gggg (hid) \\.\HID#VID_xxxy&PID_gggg#6&lllllll&0&0000#{xxxxxxxx-yyyy-hhhh-vvvv-wwwwwwwwwwww} 
; ADD EVENT: usb-2-4@0 xxxy:hhhh (hid) \\.\HID#VID_xxxy&PID_hhhh#7&mmmmmmmm&0&0000#{xxxxxxxx-yyyy-hhhh-vvvv-wwwwwwwwwwww} 
; ADD EVENT: usb-1-4@3 xxxz:iiii (hid) \\.\HID#VID_xxxz&PID_iiii&MI_03#7&nnnnnnnn&0&0000#{xxxxxxxx-yyyy-hhhh-vvvv-wwwwwwwwwwww} 
; Port COM2 found, no more data expected 
; Panel found on port: COM2, serial number: XXXXXXX 
; CPFlight panel recognized on COM2 
; COM2: MOD485EFI1COM2 
; COM2: CHIAVEXXXXXXX 
; COM2: V01 000 
; COM2: KCPF 
; COM2: K020 
; COM2: K038 
; COM2: K041 
; COM2: K018 
; COM2: V02 100 
Copyright © 2013-2017 Jorg Neves Bliesener. All rights reserved.