added inversion field

1 files changed, 21 insertions, 2 deletions

diff --git a/dvb-spec/dvbapi/frontend.tex b/dvb-spec/dvbapi/frontend.tex
index 5b496c688..23b9d3e22 100644
--- a/dvb-spec/dvbapi/frontend.tex
+++ b/dvb-spec/dvbapi/frontend.tex
@@ -26,8 +26,11 @@ It can take on the values
 \begin{verbatim}
 #define FE_HAS_POWER         1
 #define FE_HAS_SIGNAL        2
-#define FE_SPECTRUM_INV    4
+#define FE_SPECTRUM_INV      4
 #define FE_HAS_LOCK          8
+#define FE_HAS_CARRIER      16
+#define FE_HAS_VITERBI      32
+#define FE_HAS_SYNC         64
 #define TUNER_HAS_LOCK     128
 \end{verbatim}
 which can be ORed together and have the following meaning:
@@ -39,6 +42,9 @@ FE\_HAS\_POWER & the frontend is powered up and is ready to be used\\
 FE\_HAS\_SIGNAL & the frontend detects a signal above the normal noise level\\
 FE\_SPECTRUM\_INV & spectrum inversion is enabled/was necessary for lock\\
 FE\_HAS\_LOCK & frontend successfully locked to a DVB signal \\
+FE\_HAS\_CARRIER & carrier detected in signal\\
+FE\_HAS\_VITERBI & lock at viterbi decoder stage\\
+FE\_HAS\_SYNC    & TS sync bytes detected \\
 TUNER\_HAS\_LOCK & the tuner has a frequency lock
 \end{tabular}
 
@@ -54,6 +60,7 @@ FrontendParameters structure:
 typedef struct {
         __u32 Frequency;        /* (absolute) frequency in Hz for QAM/OFDM */
                                 /* intermediate frequency in kHz for QPSK */
+        SpectralInversion Inversion;    /* spectral inversion */
         union {
                 QPSKParameters qpsk;
                 QAMParameters  qam;
@@ -73,8 +80,8 @@ for cable QAM frontend you use the QAMParameters structure
 \begin{verbatim}
 typedef struct {
         __u32      SymbolRate; /* symbol rate in Symbols per second */
-        CodeRate   FEC_inner;  /* forward error correction (see above) */
         CodeRate   FEC_outer;  /* forward error correction (see above) */
+        CodeRate   FEC_inner;  /* forward error correction (see above) */
         Modulation QAM;        /* modulation type (see above) */
 } QAMParameters;
 \end{verbatim}
@@ -98,6 +105,18 @@ The intermediate frequency has to be specified in units of kHz.
 For QAM and OFDM frontends the Frequency specifies the absolute frequency
 and is given in Hz.
 
+The Inversion field can take one of these values:
+\begin{verbatim}
+typedef enum {
+        INVERSION_OFF,
+        INVERSION_ON,
+        INVERSION_AUTO
+} SpectralInversion;
+\end{verbatim}
+It indicates if spectral inversion should be presumed or not. 
+In the automatic setting (INVERSION_AUTO) the hardware will
+try to figure out the correct setting by itself.
+
 \noindent
 The possible values for the FEC\_inner field are
 \begin{verbatim}