FreeCalypso > hg > fc-rfcal-tools
annotate doc/Test-system-interface @ 42:dcf7cd305e2b
fc-rfcal-gmagic started
author | Mychaela Falconia <falcon@freecalypso.org> |
---|---|
date | Sat, 27 May 2017 05:04:14 +0000 |
parents | d348d47f8a04 |
children | 20e2b4571cd6 |
rev | line source |
---|---|
0
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
1 The Test System Interface Daemon (TSID) will provide a connection-oriented |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
2 (SOCK_STREAM) UNIX domain local socket at /tmp/fc_rftest_socket, and will speak |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
3 an ASCII line-based command-response protocol on this socket. All command and |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
4 response lines will end with \n only (no \r), and each TSID response including |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
5 the initial greeting on connection establishment will begin with a '+' or '-' |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
6 character to indicate OK or error, respectively, like in POP3. |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
7 |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
8 The following commands are currently defined: |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
9 |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
10 vcxo-cal-setup band arfcn |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
11 |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
12 This command is sent to the TSID to prepare the RF test system for the VCXO |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
13 calibration procedure. The first argument after the command keyword is the |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
14 band to be used (850, 900, 1800 or 1900) and the second argument is the ARFCN |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
15 in that band on which the DUT will be transmitting. |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
16 |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
17 freq-meas hint |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
18 |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
19 This command directs the RF test system to take a frequency offset measurement |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
20 (vcxo-cal-setup must have been performed previously) and report it back to the |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
21 client in the response line. The hint argument after the freq-meas keyword will |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
22 be sent by the VCXO calibration program (fc-rfcal-vcxo) to tell the RF test |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
23 system what kind of frequency offset measurement is being made, i.e., which step |
36
d348d47f8a04
doc/Test-system-interface: added commands for Tx power level calibration
Mychaela Falconia <falcon@freecalypso.org>
parents:
0
diff
changeset
|
24 in the VCXO calibration sequence is being performed; see the fc-rfcal-vcxo |
d348d47f8a04
doc/Test-system-interface: added commands for Tx power level calibration
Mychaela Falconia <falcon@freecalypso.org>
parents:
0
diff
changeset
|
25 source for the hint keywords. |
d348d47f8a04
doc/Test-system-interface: added commands for Tx power level calibration
Mychaela Falconia <falcon@freecalypso.org>
parents:
0
diff
changeset
|
26 |
d348d47f8a04
doc/Test-system-interface: added commands for Tx power level calibration
Mychaela Falconia <falcon@freecalypso.org>
parents:
0
diff
changeset
|
27 txpwr-cal-setup band arfcn |
d348d47f8a04
doc/Test-system-interface: added commands for Tx power level calibration
Mychaela Falconia <falcon@freecalypso.org>
parents:
0
diff
changeset
|
28 |
d348d47f8a04
doc/Test-system-interface: added commands for Tx power level calibration
Mychaela Falconia <falcon@freecalypso.org>
parents:
0
diff
changeset
|
29 This command is sent to the TSID to prepare the RF test system for the Tx power |
d348d47f8a04
doc/Test-system-interface: added commands for Tx power level calibration
Mychaela Falconia <falcon@freecalypso.org>
parents:
0
diff
changeset
|
30 level calibration procedure. The first argument after the command keyword is |
d348d47f8a04
doc/Test-system-interface: added commands for Tx power level calibration
Mychaela Falconia <falcon@freecalypso.org>
parents:
0
diff
changeset
|
31 the band to be used (850, 900, 1800 or 1900) and the second argument is the |
d348d47f8a04
doc/Test-system-interface: added commands for Tx power level calibration
Mychaela Falconia <falcon@freecalypso.org>
parents:
0
diff
changeset
|
32 ARFCN in that band on which the DUT will be transmitting. |
d348d47f8a04
doc/Test-system-interface: added commands for Tx power level calibration
Mychaela Falconia <falcon@freecalypso.org>
parents:
0
diff
changeset
|
33 |
d348d47f8a04
doc/Test-system-interface: added commands for Tx power level calibration
Mychaela Falconia <falcon@freecalypso.org>
parents:
0
diff
changeset
|
34 power-meas |
d348d47f8a04
doc/Test-system-interface: added commands for Tx power level calibration
Mychaela Falconia <falcon@freecalypso.org>
parents:
0
diff
changeset
|
35 |
d348d47f8a04
doc/Test-system-interface: added commands for Tx power level calibration
Mychaela Falconia <falcon@freecalypso.org>
parents:
0
diff
changeset
|
36 This command directs the RF test system to take a power level measurement |
d348d47f8a04
doc/Test-system-interface: added commands for Tx power level calibration
Mychaela Falconia <falcon@freecalypso.org>
parents:
0
diff
changeset
|
37 (txpwr-cal-setup must have been performed previously) and report it back to the |
d348d47f8a04
doc/Test-system-interface: added commands for Tx power level calibration
Mychaela Falconia <falcon@freecalypso.org>
parents:
0
diff
changeset
|
38 client in the response line. |
0
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
39 |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
40 signal-gen-setup band |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
41 |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
42 This command is sent to the TSID to prepare the RF test system for tests in |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
43 which the latter acts as a signal generator. The argument after the command |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
44 keyword is the band number (850, 900, 1800 or 1900), and it selects the |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
45 downlink frequency band in which the signal generator will need to operate. |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
46 |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
47 signal-gen-sine arfcn offset level |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
48 |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
49 This command directs the RF test system to turn on its signal generator and put |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
50 out a pure sine wave at the frequency corresponding to the specified ARFCN (in |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
51 the downlink band previously selected with signal-get-setup) plus the specified |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
52 offset in kHz (-67 or +67 with TI's Rx path calibration procedures), and at the |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
53 specified Tx power level in dBm. |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
54 |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
55 signal-gen-off |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
56 |
bd62be88259d
initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
57 Turn off the signal generator. |