--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/General-flow	Mon Jul 17 18:26:30 2017 +0000
@@ -0,0 +1,54 @@
+The general flow of using fc-rfcal-tools to calibrate Calypso GSM devices is as
+follows:
+
+* At the beginning of your calibration work session, you need to power on your
+  CMU200, wait for it to finish booting, and then run fc-cmu200d; the fc-cmu200d
+  command line takes the following form:
+
+  fc-cmu200d -c cable_name /dev/ttyXXX 19200
+
+  Change /dev/ttyXXX to the serial port that is connected to the CMU200, give
+  fc-cmu200d the same baud rate that is configured on the CMU (19200 is the
+  default), and select the appropriate cable configuration with the -c option:
+  see the Cable-config-howto article.
+
+  By default the RF2 port on the CMU200 will be used; you can give a -1 option
+  to use the RF1 port instead, or you can include an 'rf-port 1' or 'rf-port 2'
+  line in your cable config files to have the port selection go with the -c
+  selection.
+
+* In typical usage the fc-cmu200d process you started in the previous step can
+  persist through any number of individual device calibrations, as on a factory
+  production line.  However, if you need to switch to a different cable setup
+  with different loss numbers, you will need to kill the fc-cmu200d process and
+  restart it with the appropriate new -c option.
+
+* To calibrate an individual Calypso GSM device, you will need to have an
+  rvinterf process running, talking to the RVTMUX UART channel on that device.
+  Booting your Calypso GSM device in the correct manner and running rvinterf
+  with the right arguments is your responsibility: fc-rfcal-* tools will expect
+  rvinterf to be running already, and will not launch it themselves.
+
+* With both fc-cmu200d and rvinterf running, talking to your CMU200 and your
+  DUT, respectively, and with the correct RF coax (matching your fc-cmu200d -c
+  selection) connected between the two, you can now run the actual calibration
+  automation programs.  For a 900/1800/1900 MHz triband Calypso GSM device, the
+  standard sequence is as follows:
+
+fc-rfcal-vcxo
+fc-rfcal-rxband 900
+fc-rfcal-rxband 1800
+fc-rfcal-rxband 1900
+fc-rfcal-txband 900 <profile>
+fc-rfcal-txband 1800 <profile>
+fc-rfcal-txband 1900 <profile>
+
+The <profile> argument to fc-rfcal-txband commands needs to be changed to the
+name of the appropriate Tx levels calibration profile; see the Tx-cal-theory
+article for more information.
+
+Each of the fc-rfcal-* steps finishes by writing the values it has calibrated
+into the Calypso device's non-volatile flash file system (FFS); once all of the
+steps have been completed, the Calypso device is fully calibrated.  After the
+calibration procedure the Calypso device should be rebooted before normal AT
+command operation is attempted.