annotate doc/Test-system-interface @ 133:c99b1dce04ec default tip

fc-rfcal-txcheck: check and report ramp tolerance
author Mychaela Falconia <falcon@freecalypso.org>
date Mon, 20 Dec 2021 04:22:19 +0000
parents 8e26cb57c7f8
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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
113
01bae2629ffd doc/Test-system-interface: txpwr-cal-channel addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 93
diff changeset
34 txpwr-cal-channel arfcn
01bae2629ffd doc/Test-system-interface: txpwr-cal-channel addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 93
diff changeset
35
01bae2629ffd doc/Test-system-interface: txpwr-cal-channel addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 93
diff changeset
36 This command is used during Tx power level calibration procedures to tell the
01bae2629ffd doc/Test-system-interface: txpwr-cal-channel addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 93
diff changeset
37 RF test system to switch to a different channel.
01bae2629ffd doc/Test-system-interface: txpwr-cal-channel addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 93
diff changeset
38
131
8e26cb57c7f8 doc/Test-system-interface: additions for Tx ramp testing
Mychaela Falconia <falcon@freecalypso.org>
parents: 113
diff changeset
39 txpwr-cal-pcl pcl
8e26cb57c7f8 doc/Test-system-interface: additions for Tx ramp testing
Mychaela Falconia <falcon@freecalypso.org>
parents: 113
diff changeset
40
8e26cb57c7f8 doc/Test-system-interface: additions for Tx ramp testing
Mychaela Falconia <falcon@freecalypso.org>
parents: 113
diff changeset
41 This command is used during Tx power level calibration procedures to tell the
8e26cb57c7f8 doc/Test-system-interface: additions for Tx ramp testing
Mychaela Falconia <falcon@freecalypso.org>
parents: 113
diff changeset
42 RF test system which PCL is being tested - it allows the RF test system to
8e26cb57c7f8 doc/Test-system-interface: additions for Tx ramp testing
Mychaela Falconia <falcon@freecalypso.org>
parents: 113
diff changeset
43 prepare for the expected power level and select the right template for ramp
8e26cb57c7f8 doc/Test-system-interface: additions for Tx ramp testing
Mychaela Falconia <falcon@freecalypso.org>
parents: 113
diff changeset
44 tolerance checking.
8e26cb57c7f8 doc/Test-system-interface: additions for Tx ramp testing
Mychaela Falconia <falcon@freecalypso.org>
parents: 113
diff changeset
45
36
d348d47f8a04 doc/Test-system-interface: added commands for Tx power level calibration
Mychaela Falconia <falcon@freecalypso.org>
parents: 0
diff changeset
46 power-meas
d348d47f8a04 doc/Test-system-interface: added commands for Tx power level calibration
Mychaela Falconia <falcon@freecalypso.org>
parents: 0
diff changeset
47
d348d47f8a04 doc/Test-system-interface: added commands for Tx power level calibration
Mychaela Falconia <falcon@freecalypso.org>
parents: 0
diff changeset
48 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
49 (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
50 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
51
131
8e26cb57c7f8 doc/Test-system-interface: additions for Tx ramp testing
Mychaela Falconia <falcon@freecalypso.org>
parents: 113
diff changeset
52 power-meas ramp
8e26cb57c7f8 doc/Test-system-interface: additions for Tx ramp testing
Mychaela Falconia <falcon@freecalypso.org>
parents: 113
diff changeset
53
8e26cb57c7f8 doc/Test-system-interface: additions for Tx ramp testing
Mychaela Falconia <falcon@freecalypso.org>
parents: 113
diff changeset
54 This command is the same as more basic power-meas, but it tells the TSID that
8e26cb57c7f8 doc/Test-system-interface: additions for Tx ramp testing
Mychaela Falconia <falcon@freecalypso.org>
parents: 113
diff changeset
55 the client is interested not only in the power level measurement, but also needs
8e26cb57c7f8 doc/Test-system-interface: additions for Tx ramp testing
Mychaela Falconia <falcon@freecalypso.org>
parents: 113
diff changeset
56 the RF test system to evaluate the ramp put out by the DUT, according to the PCL
8e26cb57c7f8 doc/Test-system-interface: additions for Tx ramp testing
Mychaela Falconia <falcon@freecalypso.org>
parents: 113
diff changeset
57 template selected earlier with txpwr-cal-pcl. The response consists of the dBm
8e26cb57c7f8 doc/Test-system-interface: additions for Tx ramp testing
Mychaela Falconia <falcon@freecalypso.org>
parents: 113
diff changeset
58 power measurement and a ramp status keyword, separated by white space.
8e26cb57c7f8 doc/Test-system-interface: additions for Tx ramp testing
Mychaela Falconia <falcon@freecalypso.org>
parents: 113
diff changeset
59
8e26cb57c7f8 doc/Test-system-interface: additions for Tx ramp testing
Mychaela Falconia <falcon@freecalypso.org>
parents: 113
diff changeset
60 A given TSID implementation may ignore the ramp keyword after power-meas and
8e26cb57c7f8 doc/Test-system-interface: additions for Tx ramp testing
Mychaela Falconia <falcon@freecalypso.org>
parents: 113
diff changeset
61 always return both values, if the actual RF test instrument always returns both
8e26cb57c7f8 doc/Test-system-interface: additions for Tx ramp testing
Mychaela Falconia <falcon@freecalypso.org>
parents: 113
diff changeset
62 on the same query.
8e26cb57c7f8 doc/Test-system-interface: additions for Tx ramp testing
Mychaela Falconia <falcon@freecalypso.org>
parents: 113
diff changeset
63
0
bd62be88259d initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
64 signal-gen-setup band
bd62be88259d initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
65
bd62be88259d initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
66 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
67 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
68 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
69 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
70
bd62be88259d initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
71 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
72
bd62be88259d initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
73 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
74 out a pure sine wave at the frequency corresponding to the specified ARFCN (in
93
20e2b4571cd6 doc/Test-system-interface: typo fix
Mychaela Falconia <falcon@freecalypso.org>
parents: 36
diff changeset
75 the downlink band previously selected with signal-gen-setup) plus the specified
0
bd62be88259d initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
76 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
77 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
78
bd62be88259d initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
79 signal-gen-off
bd62be88259d initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
80
bd62be88259d initial import of rfcal code and docs from freecalypso-tools repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
81 Turn off the signal generator.