--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/INSTALL	Mon Jul 17 08:28:57 2017 +0000
@@ -0,0 +1,35 @@
+The calibration software needs to be installed on a Unix/Linux machine that is
+able to communicate serially with both your CMU200 instrument and your Calypso
+devices to be calibrated.  Because we use serial communication with the CMU200
+instead of GPIB, no exotic drivers or libraries are needed.  However, you do
+need to have FreeCalypso host tools (release fc-host-tools-r5 or later)
+installed on your system under /opt/freecalypso before you can compile and
+install the present calibration software, as we use the rvinterf program from
+FC host tools to communicate with Calypso DUTs (or more precisely, with the
+L1TM component in their firmware), and we need some rvinterf definitions in
+order to compile.
+
+Once you have fc-host-tools-r5 or later compiled and installed under
+/opt/freecalypso, run 'make' to compile the calibration sw.  Then run
+'make install' to add the calibration programs to your FC software installation
+under /opt/freecalypso.
+
+You will also need to create one or more cable config files corresponding to
+your cabling setup(s); see doc/cableconf-example.  These cable config files
+need to be placed in the /opt/freecalypso/rfcal/cableconf directory, and they
+should be given some appropriately descriptive names:
+
+* If you have a cable setup that terminates in an SMA connector for calibrating
+  Calypso GSM devices with SMA antenna interfaces, the corresponding cable
+  config file should be named "sma".
+
+* If you have a cable setup that terminates in an MS-147 probe connector for
+  recalibrating Mot C1xx phones or similar, the corresponding cable config file
+  should be named "ms147".
+
+* If you have a cable setup that terminates in a Murata SWD/SWF probe for
+  working with devices like Openmoko GTA0x, the corresponding cable config file
+  should be named "murata".
+
+You will then select the cable configuration to be used in a given calibration
+session with the -c option to fc-cmu200d.