view doc/General-flow @ 122:aa2533be2ec1

doc/Tx-cal-theory: channel calibration documented
author Mychaela Falconia <falcon@freecalypso.org>
date Wed, 14 Feb 2018 04:54:58 +0000
parents b68301b38ff2
children
line wrap: on
line source

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.