summaryrefslogtreecommitdiffstats
path: root/host/docs/calibration.rst
blob: 0aaace8f4c6da3f2ed75991a1fe0b8aa85b09cb2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
========================================================================
UHD - Calibration Application Notes
========================================================================

.. contents:: Table of Contents

------------------------------------------------------------------------
Self-calibration
------------------------------------------------------------------------
The UHD comes with several self-calibration utilities for minimizing IQ imbalance and DC offset.
These utilities perform calibration sweeps using transmit leakage into the receive path
(special equipment is not required).
The results from a calibration are written to a csv file in the user's home directory.
UHD will automatically apply corrections at runtime when the user changes settings.
Calibration results are specific to an individual RF board.

UHD comes with the following calibration utilities:

 * **uhd_cal_rx_iq_balance:** - mimimizes RX IQ imbalance vs LO frequency
 * **uhd_cal_tx_dc_offset:** - mimimizes TX DC offset vs LO frequency
 * **uhd_cal_tx_iq_balance:** - mimimizes TX IQ imbalance vs LO frequency


The following RF frontends are supported by the self-calibration utilities:

 * WBX transceiver board
 * SBX transceiver board
 * more to come...

********************************************
Calibration utilities
********************************************
UHD installs the calibration utilities into <install-path>/bin.
**Disconnect** any extrernal hardware from the RF antenna ports,
and run the following from the command line.
Each utility will take several minutes to complete.
::

    uhd_cal_rx_iq_balance --verbose --args=<optional device args>
    uhd_cal_tx_iq_balance --verbose --args=<optional device args>
    uhd_cal_tx_dc_offset --verbose --args=<optional device args>

See the output given by --help for more advanced options, such as:
manually choosing the frequency range and step size for the sweeps.

********************************************
Calibration data
********************************************
Calibration files are stored in the user's home/application directory.
They can easily be moved from machine to another by copying the "cal" directory.
Re-running a calibration utility will replace the existing calibration file.
The old calibration file will be renamed so it may be recovered by the user.

 * **Unix:** ${HOME}/.uhd/cal/
 * **Windows:** %APPDATA%\\.uhd\\cal\\