view doc/Test-system-interface @ 131:8e26cb57c7f8

doc/Test-system-interface: additions for Tx ramp testing
author Mychaela Falconia <falcon@freecalypso.org>
date Mon, 20 Dec 2021 03:29:23 +0000
parents 01bae2629ffd
children
line wrap: on
line source

The Test System Interface Daemon (TSID) will provide a connection-oriented
(SOCK_STREAM) UNIX domain local socket at /tmp/fc_rftest_socket, and will speak
an ASCII line-based command-response protocol on this socket.  All command and
response lines will end with \n only (no \r), and each TSID response including
the initial greeting on connection establishment will begin with a '+' or '-'
character to indicate OK or error, respectively, like in POP3.

The following commands are currently defined:

vcxo-cal-setup band arfcn

This command is sent to the TSID to prepare the RF test system for the VCXO
calibration procedure.  The first argument after the command keyword is the
band to be used (850, 900, 1800 or 1900) and the second argument is the ARFCN
in that band on which the DUT will be transmitting.

freq-meas hint

This command directs the RF test system to take a frequency offset measurement
(vcxo-cal-setup must have been performed previously) and report it back to the
client in the response line.  The hint argument after the freq-meas keyword will
be sent by the VCXO calibration program (fc-rfcal-vcxo) to tell the RF test
system what kind of frequency offset measurement is being made, i.e., which step
in the VCXO calibration sequence is being performed; see the fc-rfcal-vcxo
source for the hint keywords.

txpwr-cal-setup band arfcn

This command is sent to the TSID to prepare the RF test system for the Tx power
level calibration procedure.  The first argument after the command keyword is
the band to be used (850, 900, 1800 or 1900) and the second argument is the
ARFCN in that band on which the DUT will be transmitting.

txpwr-cal-channel arfcn

This command is used during Tx power level calibration procedures to tell the
RF test system to switch to a different channel.

txpwr-cal-pcl pcl

This command is used during Tx power level calibration procedures to tell the
RF test system which PCL is being tested - it allows the RF test system to
prepare for the expected power level and select the right template for ramp
tolerance checking.

power-meas

This command directs the RF test system to take a power level measurement
(txpwr-cal-setup must have been performed previously) and report it back to the
client in the response line.

power-meas ramp

This command is the same as more basic power-meas, but it tells the TSID that
the client is interested not only in the power level measurement, but also needs
the RF test system to evaluate the ramp put out by the DUT, according to the PCL
template selected earlier with txpwr-cal-pcl.  The response consists of the dBm
power measurement and a ramp status keyword, separated by white space.

A given TSID implementation may ignore the ramp keyword after power-meas and
always return both values, if the actual RF test instrument always returns both
on the same query.

signal-gen-setup band

This command is sent to the TSID to prepare the RF test system for tests in
which the latter acts as a signal generator.  The argument after the command
keyword is the band number (850, 900, 1800 or 1900), and it selects the
downlink frequency band in which the signal generator will need to operate.

signal-gen-sine arfcn offset level

This command directs the RF test system to turn on its signal generator and put
out a pure sine wave at the frequency corresponding to the specified ARFCN (in
the downlink band previously selected with signal-gen-setup) plus the specified
offset in kHz (-67 or +67 with TI's Rx path calibration procedures), and at the
specified Tx power level in dBm.

signal-gen-off

Turn off the signal generator.