ReadMe117.txt  11-1-2013
  This ReadMe file is updated for the latest MSA Software, version 117.

Main Changes for MSA_Software version 117
* change one code line to prevent incorrect band start-up with fresh software download
* add code line to fix "Fresh Run" crash that pertained to colors error.
* changed code that compensated for phase data taken at frequencies other than 10.7 MHz
* change notice "The USB interface is either not plugged in or is too old a version for me" so as not to confuse operator
* add code to prevent software from crashing when loading a Test File that has no calibration data.

Depending on how you will use the MSA Software, go to the appropriate section:
 If you are installing MSA Software for the first time, and will use it with Liberty Basic, perform the prodedures in Section I only.
 If you are installing MSA Software for the first time, and will use it as an Executable (no Liberty Basic), perform the prodedures in Section II only.
 If you are upgrading MSA Software from Version 116 to Version 117, and will use it with Liberty Basic, perform the prodedures in Section III only.
 If you are upgrading MSA Software from Version 116 to Version 117, and will use it as an Executable (no Liberty Basic), perform the prodedures in Section IV only.

I. Initial installation of MSA Software for Liberty Basic

 A. Changes to your Computer folders.
   1. If not already installed, install Liberty Basic 4.03 with its location at: C:\Program Files\Liberty BASIC v4.03
   2. Perform a "search" of your computer and locate copies of "ntport.dll" and "zntport.sys". It is possible that they exist in System folders of your computer. They are not compatable for the MSA Software.  They will be replaced with new versions.
    a. Either delete "ntport.dll" and "zntport.sys" or change their names so as not to confuse the MSA Software. Example "ntportold.dll" and "zntportold.sys".
    b. If you have someone else's program that uses "ntport.dll" and "zntport.sys", you should rename, rather than delete the ntport and zntport in your system folders, just in case you need to revert to the prior one to use with your other program. Example "ntportold.dll" and "zntportold.sys".
    c. As a certainty, there will be a folder within Liberty Basic containing them:  C:\Program Files\Liberty BASIC v4.03/ntport. You may delete the entire folder, "ntport".
   3. From the Web Page, download the zipped folder, "Redist.zip" and place on your desktop
    a. Unzip the folder, "Redist.zip". It will create a folder, "Redist"
    b. Open the folder, "Redist", and run "NTPortDrvSetup.exe". This will install a folder, "NTPort Library Driver" in your Program Files Directory. It will install Ntport.dll into the proper directory for your computer. It will also install Zntport.sys into the proper directory for your computer. These new files are "backward" compatable for other programs.
    c. You may now delete the folders and their contents, "Redist" and "Redist.zip" from your desktop.  They are no longer needed.

 B. Installing the MSA Software
  1. Use your Windows Explorer and open the folder C:\Program Files\Liberty BASIC v4.03
   a. Create a new folder and name it "MSA_Software". This is where the new software will be installed. i.e.,  C:\Program Files\Liberty BASIC v4.03\MSA_Software
   b. Download "spectrumanalyzer.bas" and install into the folder, "MSA_Software".

 C. Running the MSA Software
  1. You can run the MSA Software by opening and running Liberty Basic, and choosing "spectrumanalyzer.bas" from the "MSA_Software" folder.
  2. Or, You may create a shortcut for spectrumanalyzer.bas and place it on your desktop. The first time you open spectrumanalyzer.bas from the desktop Icon,
   a. Right click the short cut icon
   b. Open With/Choose Program
   c. Check the "Always use this program to open these files"
   d. Click the "Other" button
   e. Go through the search to find "liberty.exe". It should be at
    C:\Program Files\Liberty BASIC v4.03\liberty.exe
   f. Thereafter, a double click on the icon will automatically open it
    in Liberty Basic


II. Initial installation of MSA Software as an Executable.

 A. Changes to your Computer folders.
  1. Perform a "search" of your computer and locate copies of "ntport.dll" and "zntport.sys". It is possible that they exist in System folders of your computer. They are not compatable for the MSA Software.  They will be replaced with new versions.
   a. Either delete "ntport.dll" and "zntport.sys" or change their names so as not to confuse the MSA Software. Example "ntportold.dll" and "zntportold.sys".
   b. If you have someone else's program that uses "ntport.dll" and "zntport.sys", you should rename, rather than delete the ntport and zntport in your system folders, just in case you need to revert to the prior one to use with your other program. Example "ntportold.dll" and "zntportold.sys".
  2. From the Web Page, download the zipped folder, "Redist.zip" and place on your desktop
   a. Unzip the folder, "Redist.zip". It will create a folder, "Redist"
   b. Open the folder, "Redist", and run "NTPortDrvSetup.exe". This will install a folder, "NTPort Library Driver" in your Program Files Directory. It will install Ntport.dll into the proper directory for your computer. It will also install Zntport.sys into the proper directory for your computer. These new files are "backward" compatable for other programs.
   c. You may now delete the folders and their contents, "Redist" and "Redist.zip" from your desktop.  They are no longer needed.

 B. Installing the MSA Software
  1. Use your Windows Explorer and open the folder C:\Program Files
   a. Create a new folder within Program Files, name it, "MSA_Software"
   b. Download the following MSA software files from the MSA web site
   and install them in the folder, C:\Program Files\MSA_Software
      ReadMe117.txt
      spectrumanalyzer.exe
      spectrumanalyzer.tkn
      vbas31w.sll
      vgui31w.sll
      voflr31w.sll
      vthk31w.dll
      vtk1631w.dll
      vtk3231w.dll
      vvm31w.dll
      vvmt31w.dll

 C. Running the MSA Software
  Create a short cut icon for quick access to run the MSA. Perform
   either step 1 or step 2.
  1. You may create a shortcut for spectrumanalyzer.tkn and place it
   on your desktop. You can run the MSA Program by clicking this icon.
   The first time you try to run from this icon,
    a. Right click the icon
    b. Open With/Choose Program
    c. Check the "Always use this program to open these files"
    d. Click the "Other" button
    e. Go through the search to find "spectrumanalyzer.exe". It should
    be at C:\Program Files\MSA_Software\spectrumanalyzer.exe
    f. Thereafter, a double click on the icon will automatically run the MSA Program
  2. You may create a shortcut for spectrumanalyzer.exe and place it
   on your desktop. A double click on the icon will automatically
   run the MSA Program.

III. MSA Software upgrade from Version 116 to 117, for Liberty Basic.
 A. Changes to your Computer folders.
  1. Open your Liberty Basic folder: C:\Program Files\Liberty BASIC v4.03\MSA_Software
   a. Delete "spectrumanalyzer.bas", or if you want to keep it as an archive, change its name to, "116spectrumanalyzer.bas"

 B. Installing the MSA Software
  1. Download "spectrumanalyzer.bas" and install in in the location folder, C:\Program Files\Liberty BASIC v4.03\MSA_Software

 C. Run the MSA Software the same way as your previous method.

IV. MSA Software upgrade from Version 116 to 117, as an Executable.
 A. Changes to your Computer folders.
  1. Open the folder: C:\Program Files\MSA_Software
   a. Delete "spectrumanalyzer.tkn", or if you want to keep it as an archive, change its name to, "116spectrumanalyzer.tkn"

 B. Installing the MSA Software
  1. Download "spectrumanalyzer.tkn" and install in in the location folder, C:\Program Files\MSA_Software

 C. Run the MSA Software the same way as your previous method.