annotate 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
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
95
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
1 The general flow of using fc-rfcal-tools to calibrate Calypso GSM devices is as
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
2 follows:
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
3
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
4 * At the beginning of your calibration work session, you need to power on your
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
5 CMU200, wait for it to finish booting, and then run fc-cmu200d; the fc-cmu200d
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
6 command line takes the following form:
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
7
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
8 fc-cmu200d -c cable_name /dev/ttyXXX 19200
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
9
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10 Change /dev/ttyXXX to the serial port that is connected to the CMU200, give
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
11 fc-cmu200d the same baud rate that is configured on the CMU (19200 is the
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
12 default), and select the appropriate cable configuration with the -c option:
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
13 see the Cable-config-howto article.
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
14
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
15 By default the RF2 port on the CMU200 will be used; you can give a -1 option
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
16 to use the RF1 port instead, or you can include an 'rf-port 1' or 'rf-port 2'
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
17 line in your cable config files to have the port selection go with the -c
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
18 selection.
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
19
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
20 * In typical usage the fc-cmu200d process you started in the previous step can
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
21 persist through any number of individual device calibrations, as on a factory
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
22 production line. However, if you need to switch to a different cable setup
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
23 with different loss numbers, you will need to kill the fc-cmu200d process and
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
24 restart it with the appropriate new -c option.
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
25
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
26 * To calibrate an individual Calypso GSM device, you will need to have an
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
27 rvinterf process running, talking to the RVTMUX UART channel on that device.
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
28 Booting your Calypso GSM device in the correct manner and running rvinterf
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
29 with the right arguments is your responsibility: fc-rfcal-* tools will expect
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
30 rvinterf to be running already, and will not launch it themselves.
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
31
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
32 * With both fc-cmu200d and rvinterf running, talking to your CMU200 and your
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
33 DUT, respectively, and with the correct RF coax (matching your fc-cmu200d -c
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
34 selection) connected between the two, you can now run the actual calibration
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
35 automation programs. For a 900/1800/1900 MHz triband Calypso GSM device, the
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
36 standard sequence is as follows:
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
37
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
38 fc-rfcal-vcxo
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
39 fc-rfcal-rxband 900
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
40 fc-rfcal-rxband 1800
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
41 fc-rfcal-rxband 1900
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
42 fc-rfcal-txband 900 <profile>
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
43 fc-rfcal-txband 1800 <profile>
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
44 fc-rfcal-txband 1900 <profile>
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
45
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
46 The <profile> argument to fc-rfcal-txband commands needs to be changed to the
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
47 name of the appropriate Tx levels calibration profile; see the Tx-cal-theory
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
48 article for more information.
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
49
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
50 Each of the fc-rfcal-* steps finishes by writing the values it has calibrated
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
51 into the Calypso device's non-volatile flash file system (FFS); once all of the
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
52 steps have been completed, the Calypso device is fully calibrated. After the
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
53 calibration procedure the Calypso device should be rebooted before normal AT
b68301b38ff2 doc: Cable-config-howto and General-flow written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
54 command operation is attempted.