summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--dpd/README.md22
-rwxr-xr-xdpd/apply_adapt_dumps.py2
-rwxr-xr-xdpd/main.py2
-rw-r--r--dpd/src/Adapt.py2
-rw-r--r--dpd/src/Const.py2
-rw-r--r--dpd/src/Dab_Util.py2
-rw-r--r--dpd/src/ExtractStatistic.py2
-rw-r--r--dpd/src/Heuristics.py2
-rw-r--r--dpd/src/MER.py2
-rw-r--r--dpd/src/Measure.py2
-rw-r--r--dpd/src/Measure_Shoulders.py2
-rw-r--r--dpd/src/Model_AM.py2
-rw-r--r--dpd/src/Model_Lut.py2
-rw-r--r--dpd/src/Model_PM.py2
-rw-r--r--dpd/src/Model_Poly.py2
-rw-r--r--dpd/src/Symbol_align.py2
-rw-r--r--dpd/src/TX_Agc.py2
-rw-r--r--dpd/src/phase_align.py2
-rwxr-xr-xdpd/src/subsample_align.py2
19 files changed, 32 insertions, 26 deletions
diff --git a/dpd/README.md b/dpd/README.md
index bf86b3b..3ef1566 100644
--- a/dpd/README.md
+++ b/dpd/README.md
@@ -1,20 +1,26 @@
-Digital Predistortion Calculation Engine for ODR-DabMod
+Digital Predistortion Computation Engine for ODR-DabMod
=======================================================
-This folder contains a prototype to do digital predistortion. It was tested on
-the development system only.
+This folder contains a digital predistortion prototype.
+It was only tested in a laboratory system, and is not ready
+for production usage.
Concept
-------
-ODR-DabMod makes outgoing TX samples and feedback RX samples available for an external tool. This
-external tool can request a buffer of samples for analysis, can calculate coefficients for the
-predistorter in ODR-DabMod and load the new coefficients using the remote control.
+ODR-DabMod makes outgoing TX samples and feedback RX samples available to an
+external tool. This external tool can request a buffer of samples for analysis,
+can calculate coefficients for the predistorter in ODR-DabMod and load the new
+coefficients using the remote control.
+
+The external tool is called the Digital Predistortion Computation Engine (DPDCE).
+The DPDCE is written in python, and makes use of the numpy library for
+efficient computation. Its sources reside in the *dpd* folder.
The predistorter in ODR-DabMod supports two modes: polynomial and lookup table.
-But at the moment only the polynomial model is implemented.
+In the DPDCE, only the polynomial model is implemented at the moment.
-The *dpd/main.py* script is the entry point for the *DPD Calculation Engine* into which these
+The *dpd/main.py* script is the entry point for the *DPD Computation Engine* into which these
features will be implemented. The tool uses modules from the *dpd/src/* folder:
- Sample transfer and time alignment with subsample accuracy is done by *Measure.py*
diff --git a/dpd/apply_adapt_dumps.py b/dpd/apply_adapt_dumps.py
index ee75e25..6b15aff 100755
--- a/dpd/apply_adapt_dumps.py
+++ b/dpd/apply_adapt_dumps.py
@@ -1,7 +1,7 @@
#!/usr/bin/env python
# -*- coding: utf-8 -*-
#
-# DPD Calculation Engine, apply stored configuration.
+# DPD Computation Engine, apply stored configuration.
#
# http://www.opendigitalradio.org
# Licence: The MIT License, see notice at the end of this file
diff --git a/dpd/main.py b/dpd/main.py
index d2ed453..ac710d0 100755
--- a/dpd/main.py
+++ b/dpd/main.py
@@ -1,7 +1,7 @@
#!/usr/bin/env python
# -*- coding: utf-8 -*-
#
-# DPD Calculation Engine main file.
+# DPD Computation Engine main file.
#
# http://www.opendigitalradio.org
# Licence: The MIT License, see notice at the end of this file
diff --git a/dpd/src/Adapt.py b/dpd/src/Adapt.py
index 1ab7710..f7b4eb4 100644
--- a/dpd/src/Adapt.py
+++ b/dpd/src/Adapt.py
@@ -1,6 +1,6 @@
# -*- coding: utf-8 -*-
#
-# DPD Calculation Engine: updates ODR-DabMod's settings
+# DPD Computation Engine: updates ODR-DabMod's settings
#
# http://www.opendigitalradio.org
# Licence: The MIT License, see notice at the end of this file
diff --git a/dpd/src/Const.py b/dpd/src/Const.py
index 701ef8a..6c9bafa 100644
--- a/dpd/src/Const.py
+++ b/dpd/src/Const.py
@@ -1,6 +1,6 @@
# -*- coding: utf-8 -*-
#
-# DPD Calculation Engine, constants.
+# DPD Computation Engine, constants.
#
# Source for DAB standard: etsi_EN_300_401_v010401p p145
#
diff --git a/dpd/src/Dab_Util.py b/dpd/src/Dab_Util.py
index 27a31ef..2021f38 100644
--- a/dpd/src/Dab_Util.py
+++ b/dpd/src/Dab_Util.py
@@ -1,6 +1,6 @@
# -*- coding: utf-8 -*-
#
-# DPD Calculation Engine, utilities for working with DAB signals.
+# DPD Computation Engine, utilities for working with DAB signals.
#
# http://www.opendigitalradio.org
# Licence: The MIT License, see notice at the end of this file
diff --git a/dpd/src/ExtractStatistic.py b/dpd/src/ExtractStatistic.py
index 8ea849b..d27cd77 100644
--- a/dpd/src/ExtractStatistic.py
+++ b/dpd/src/ExtractStatistic.py
@@ -1,6 +1,6 @@
# -*- coding: utf-8 -*-
#
-# DPD Calculation Engine,
+# DPD Computation Engine,
# Extract statistic from received TX and RX data to use in Model
#
# http://www.opendigitalradio.org
diff --git a/dpd/src/Heuristics.py b/dpd/src/Heuristics.py
index 51e221f..21d400b 100644
--- a/dpd/src/Heuristics.py
+++ b/dpd/src/Heuristics.py
@@ -1,6 +1,6 @@
# -*- coding: utf-8 -*-
#
-# DPD Calculation Engine, heuristics we use to tune the parameters.
+# DPD Computation Engine, heuristics we use to tune the parameters.
#
# http://www.opendigitalradio.org
# Licence: The MIT License, see notice at the end of this file
diff --git a/dpd/src/MER.py b/dpd/src/MER.py
index 0f169a7..f186261 100644
--- a/dpd/src/MER.py
+++ b/dpd/src/MER.py
@@ -1,6 +1,6 @@
# -*- coding: utf-8 -*-
#
-# DPD Calculation Engine, Modulation Error Rate.
+# DPD Computation Engine, Modulation Error Rate.
#
# http://www.opendigitalradio.org
# Licence: The MIT License, see notice at the end of this file
diff --git a/dpd/src/Measure.py b/dpd/src/Measure.py
index d485a86..5d0da65 100644
--- a/dpd/src/Measure.py
+++ b/dpd/src/Measure.py
@@ -1,6 +1,6 @@
# -*- coding: utf-8 -*-
#
-# DPD Calculation Engine, Measure signal using ODR-DabMod's
+# DPD Computation Engine, Measure signal using ODR-DabMod's
# DPD Server.
#
# http://www.opendigitalradio.org
diff --git a/dpd/src/Measure_Shoulders.py b/dpd/src/Measure_Shoulders.py
index fec39be..c733dfd 100644
--- a/dpd/src/Measure_Shoulders.py
+++ b/dpd/src/Measure_Shoulders.py
@@ -1,6 +1,6 @@
# -*- coding: utf-8 -*-
#
-# DPD Calculation Engine, calculate peak to shoulder difference.
+# DPD Computation Engine, calculate peak to shoulder difference.
#
# http://www.opendigitalradio.org
# Licence: The MIT License, see notice at the end of this file
diff --git a/dpd/src/Model_AM.py b/dpd/src/Model_AM.py
index a40f421..d7e880c 100644
--- a/dpd/src/Model_AM.py
+++ b/dpd/src/Model_AM.py
@@ -1,6 +1,6 @@
# -*- coding: utf-8 -*-
#
-# DPD Calculation Engine, model implementation for Amplitude and not Phase
+# DPD Computation Engine, model implementation for Amplitude and not Phase
#
# http://www.opendigitalradio.org
# Licence: The MIT License, see notice at the end of this file
diff --git a/dpd/src/Model_Lut.py b/dpd/src/Model_Lut.py
index d0f15df..6d4db52 100644
--- a/dpd/src/Model_Lut.py
+++ b/dpd/src/Model_Lut.py
@@ -1,6 +1,6 @@
# -*- coding: utf-8 -*-
#
-# DPD Calculation Engine, model implementation using polynomial
+# DPD Computation Engine, model implementation using polynomial
#
# http://www.opendigitalradio.org
# Licence: The MIT License, see notice at the end of this file
diff --git a/dpd/src/Model_PM.py b/dpd/src/Model_PM.py
index b0c7ae2..d4f8c00 100644
--- a/dpd/src/Model_PM.py
+++ b/dpd/src/Model_PM.py
@@ -1,6 +1,6 @@
# -*- coding: utf-8 -*-
#
-# DPD Calculation Engine, model implementation for Amplitude and not Phase
+# DPD Computation Engine, model implementation for Amplitude and not Phase
#
# http://www.opendigitalradio.org
# Licence: The MIT License, see notice at the end of this file
diff --git a/dpd/src/Model_Poly.py b/dpd/src/Model_Poly.py
index 16881ad..ff15941 100644
--- a/dpd/src/Model_Poly.py
+++ b/dpd/src/Model_Poly.py
@@ -1,6 +1,6 @@
# -*- coding: utf-8 -*-
#
-# DPD Calculation Engine, model implementation using polynomial
+# DPD Computation Engine, model implementation using polynomial
#
# http://www.opendigitalradio.org
# Licence: The MIT License, see notice at the end of this file
diff --git a/dpd/src/Symbol_align.py b/dpd/src/Symbol_align.py
index 4ea79c5..d921f25 100644
--- a/dpd/src/Symbol_align.py
+++ b/dpd/src/Symbol_align.py
@@ -1,6 +1,6 @@
# -*- coding: utf-8 -*-
#
-# DPD Calculation Engine, Modulation Error Rate.
+# DPD Computation Engine, Modulation Error Rate.
#
# http://www.opendigitalradio.org
# Licence: The MIT License, see notice at the end of this file
diff --git a/dpd/src/TX_Agc.py b/dpd/src/TX_Agc.py
index 857ae06..3c804fa 100644
--- a/dpd/src/TX_Agc.py
+++ b/dpd/src/TX_Agc.py
@@ -1,6 +1,6 @@
# -*- coding: utf-8 -*-
#
-# DPD Calculation Engine, Automatic Gain Control.
+# DPD Computation Engine, Automatic Gain Control.
#
# http://www.opendigitalradio.org
# Licence: The MIT License, see notice at the end of this file
diff --git a/dpd/src/phase_align.py b/dpd/src/phase_align.py
index 0d662ec..68c216d 100644
--- a/dpd/src/phase_align.py
+++ b/dpd/src/phase_align.py
@@ -1,6 +1,6 @@
# -*- coding: utf-8 -*-
#
-# DPD Calculation Engine, phase-align a signal against a reference.
+# DPD Computation Engine, phase-align a signal against a reference.
#
# http://www.opendigitalradio.org
# Licence: The MIT License, see notice at the end of this file
diff --git a/dpd/src/subsample_align.py b/dpd/src/subsample_align.py
index 0c98e50..68f3591 100755
--- a/dpd/src/subsample_align.py
+++ b/dpd/src/subsample_align.py
@@ -1,6 +1,6 @@
# -*- coding: utf-8 -*-
#
-# DPD Calculation Engine, utility to do subsample alignment.
+# DPD Computation Engine, utility to do subsample alignment.
#
# http://www.opendigitalradio.org
# Licence: The MIT License, see notice at the end of this file