annotate INSTALL @ 94:b443d0665c1f

top README and INSTALL files added
author Mychaela Falconia <falcon@freecalypso.org>
date Mon, 17 Jul 2017 08:28:57 +0000
parents
children 037d9200aae4
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
94
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
1 The calibration software needs to be installed on a Unix/Linux machine that is
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
2 able to communicate serially with both your CMU200 instrument and your Calypso
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
3 devices to be calibrated. Because we use serial communication with the CMU200
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
4 instead of GPIB, no exotic drivers or libraries are needed. However, you do
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
5 need to have FreeCalypso host tools (release fc-host-tools-r5 or later)
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
6 installed on your system under /opt/freecalypso before you can compile and
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
7 install the present calibration software, as we use the rvinterf program from
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
8 FC host tools to communicate with Calypso DUTs (or more precisely, with the
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
9 L1TM component in their firmware), and we need some rvinterf definitions in
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10 order to compile.
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
11
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
12 Once you have fc-host-tools-r5 or later compiled and installed under
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
13 /opt/freecalypso, run 'make' to compile the calibration sw. Then run
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
14 'make install' to add the calibration programs to your FC software installation
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
15 under /opt/freecalypso.
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
16
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
17 You will also need to create one or more cable config files corresponding to
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
18 your cabling setup(s); see doc/cableconf-example. These cable config files
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
19 need to be placed in the /opt/freecalypso/rfcal/cableconf directory, and they
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
20 should be given some appropriately descriptive names:
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
21
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
22 * If you have a cable setup that terminates in an SMA connector for calibrating
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
23 Calypso GSM devices with SMA antenna interfaces, the corresponding cable
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
24 config file should be named "sma".
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
25
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
26 * If you have a cable setup that terminates in an MS-147 probe connector for
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
27 recalibrating Mot C1xx phones or similar, the corresponding cable config file
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
28 should be named "ms147".
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
29
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
30 * If you have a cable setup that terminates in a Murata SWD/SWF probe for
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
31 working with devices like Openmoko GTA0x, the corresponding cable config file
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
32 should be named "murata".
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
33
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
34 You will then select the cable configuration to be used in a given calibration
b443d0665c1f top README and INSTALL files added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
35 session with the -c option to fc-cmu200d.