FreeCalypso > hg > freecalypso-tools

annotate doc/RF-cal/Test-system-interface @ 210:071544322478

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
CHANGES: documented newly added utilities
author Mychaela Falconia <falcon@freecalypso.org>
date Thu, 18 May 2017 23:32:31 +0000
parents bab88077deba
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
192
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
1 The Test System Interface Daemon (TSID) will provide a connection-oriented
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
2 (SOCK_STREAM) UNIX domain local socket at /tmp/fc_rftest_socket, and will speak
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
3 an ASCII line-based command-response protocol on this socket. All command and
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
4 response lines will end with \n only (no \r), and each TSID response including
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
5 the initial greeting on connection establishment will begin with a '+' or '-'
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
6 character to indicate OK or error, respectively, like in POP3.
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
7
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
8 The following commands are currently defined:
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
9
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10 vcxo-cal-setup band arfcn
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
11
bab88077deba doc/RF-cal/Test-system-interface written
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
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
13 calibration procedure. The first argument after the command keyword is the
bab88077deba doc/RF-cal/Test-system-interface written
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
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
15 in that band on which the DUT will be transmitting.
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
16
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
17 freq-meas hint
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
18
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
19 This command directs the RF test system to take a frequency offset measurement
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
20 (vcxo-cal-setup must have been performed previously) and report it back to the
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
21 client in the response line. The hint argument after the freq-meas keyword will
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
22 be sent by the VCXO calibration program (fc-rfcal-vcxo) to tell the RF test
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
23 system what kind of frequency offset measurement is being made, i.e., which step
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
24 in the VCXO calibration sequence is being performed; the hint keywords remain
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
25 to be defined.
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
26
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
27 signal-gen-setup band
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
28
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
29 This command is sent to the TSID to prepare the RF test system for tests in
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
30 which the latter acts as a signal generator. The argument after the command
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
31 keyword is the band number (850, 900, 1800 or 1900), and it selects the
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
32 downlink frequency band in which the signal generator will need to operate.
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
33
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
34 signal-gen-sine arfcn offset level
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
35
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
36 This command directs the RF test system to turn on its signal generator and put
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
37 out a pure sine wave at the frequency corresponding to the specified ARFCN (in
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
38 the downlink band previously selected with signal-get-setup) plus the specified
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
39 offset in kHz (-67 or +67 with TI's Rx path calibration procedures), and at the
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
40 specified Tx power level in dBm.
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
41
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
42 signal-gen-off
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
43
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
44 Turn off the signal generator.
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
45
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
46 The commands for Tx power level calibration remain to be defined.