aboutsummaryrefslogtreecommitdiffstats
path: root/host/docs/calibration.rst
diff options
context:
space:
mode:
Diffstat (limited to 'host/docs/calibration.rst')
-rw-r--r--host/docs/calibration.rst29
1 files changed, 18 insertions, 11 deletions
diff --git a/host/docs/calibration.rst b/host/docs/calibration.rst
index 14e66a312..1945c4dd5 100644
--- a/host/docs/calibration.rst
+++ b/host/docs/calibration.rst
@@ -7,10 +7,10 @@ UHD - Calibration Application Notes
------------------------------------------------------------------------
Self-calibration
------------------------------------------------------------------------
-The UHD comes with several self-calibration utilities for minimizing IQ imbalance and DC offset.
+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.
+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 re-tunes the daughterboard LO.
Calibration results are specific to an individual RF board.
@@ -21,21 +21,20 @@ the user should re-apply the desired setting every time the LO is re-tuned.
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
-
+ * **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...
+ * RFX transceiver board
********************************************
-Calibration utilities
+Calibration Utilities
********************************************
-UHD installs the calibration utilities into <install-path>/bin.
+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.
@@ -48,14 +47,22 @@ Each utility will take several minutes to complete.
See the output given by --help for more advanced options, such as:
manually choosing the frequency range and step size for the sweeps.
+**Note:**
+Your daughterboard needs a serial number to run a calibration utility. Some older daughterboards
+may not have a serial number. If this is the case, run the following command to burn a serial number
+into the daughterboard's EEPROM:
+::
+
+ <install dir>/share/uhd/utils/usrp_burn_db_eeprom --ser=<desired serial> --args=<optional device args>
+
********************************************
-Calibration data
+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/
+ * **Linux:** ${HOME}/.uhd/cal/
* **Windows:** %APPDATA%\\.uhd\\cal\\