annotate doc/RF-cal/Architecture @ 231:a58a7bbc0618

CHANGES: first changes since fc-host-tools-r5
author Mychaela Falconia <falcon@freecalypso.org>
date Thu, 03 Aug 2017 03:21:39 +0000
parents bab88077deba
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
191
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
1 The RF calibration process fundamentally consists of 3 parts:
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
2
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
3 1: The FreeCalypso GSM MS device under test (DUT) to be calibrated;
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
4
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
5 2: An RF test station to which the DUT is connected via an RF coax cable,
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
6 performing the RF signal analyzer and signal generator functions required
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
7 for the calibration procedures;
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
8
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
9 3: A program that communicates with both the DUT and the RF test station and
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10 orchestrates all of the signal generation, measurement and computation steps
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
11 to arrive at the final calibration results to be stored in the flash file
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
12 system of the DUT. The steps are too numerous, tedious and repetitive to be
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
13 performed manually, hence automation is required in order to make the process
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
14 practical.
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
15
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
16 The goal of the FreeCalypso RF calibration subproject is to produce a set of
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
17 tools for performing part 3 of the above breakdown. The current vision is that
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
18 our automated calibration software will be broken down into two interfacing
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
19 components:
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
20
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
21 1: There will be a Test System Interface Daemon (TSID) that encapsulates the
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
22 magic specific to a particular brand of RF test station, e.g., R&S CMU200.
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
23 The TSID will only talk to the CMU200 or other RF test station, but not to
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
24 the Calypso DUT, and the intent is that the TSID only needs to be started
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
25 once at the beginning of a calibration work shift and then stay running as a
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
26 hundred or more FreeCalypso GSM devices may be calibrated on the production
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
27 line. The TSID will present a local socket interface (can be changed to
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
28 TCP/IP if operation over a network is required) to which the other component
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
29 below will connect as a client.
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
30
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
31 2: There will be a set of 3 programs (fc-rfcal-vcxo, fc-rfcal-rxband and
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
32 fc-rfcal-txband) that perform the 3 required calibration groups for each
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
33 individual FreeCalypso device unit on the production line. The production
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
34 automation script will need to run fc-rfcal-vcxo first, then fc-rfcal-rxband
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
35 for each of the hardware-supported bands (e.g., 900, 1800 and 1900 on
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
36 FCDEV3B-900), then fc-rfcal-txband for each of the same bands. Each of these
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
37 programs will talk both to the DUT (via rvinterf) and to the RF test system
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
38 (via the TSID), i.e., will need to connect to an already-running rvinterf
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
39 process and to an already-running TSID via local sockets.
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
40
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
41 The programs in the second group above will contain no knowledge specific to
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
42 R&S CMU200 or any other particular brand of RF test station, instead this
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
43 knowledge is to be encapsulated in the TSID. The interface between the TSID
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
44 and its clients will be of a command-response nature, and will be defined from
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
45 the perspective of the needs of the FreeCalypso calibration process, rather than
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
46 from the perspective of the capabilities of the CMU200 - in other words, the
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
47 calibration automation program will command the TSID to the effect of "I need
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
48 this", and it will be the responsibility of the TSID to figure out how to
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
49 perform the required measurement or signal generation on the given type of test
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
50 equipment.
80bd2c652c46 doc/RF-cal/Architecture document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
51
192
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents: 191
diff changeset
52 See the Test-system-interface document for the details of the TSID socket
bab88077deba doc/RF-cal/Test-system-interface written
Mychaela Falconia <falcon@freecalypso.org>
parents: 191
diff changeset
53 interface.