ISDB-T: added bandwidth as an optional parameter

From: Patrick Boettcher <pboettcher@dibcom.fr>

- added bandwidth as an optional parameter
- added changelog
- added version

Priority: normal

Signed-off-by: Patrick Boettcher <pboettcher@dibcom.fr>

1 files changed, 31 insertions, 7 deletions

diff --git a/dvb-spec/ISDB-T_and_ISDB-Tsb_with_S2API b/dvb-spec/ISDB-T_and_ISDB-Tsb_with_S2API
index e2df2b4d9..747183225 100644
--- a/dvb-spec/ISDB-T_and_ISDB-Tsb_with_S2API
+++ b/dvb-spec/ISDB-T_and_ISDB-Tsb_with_S2API
@@ -1,5 +1,23 @@
-This document describes shortly what are the possible parameters in
-the Linux DVB-API called "S2API" in order to tune an ISDB-T/ISDB-Tsb
+Version 1.2 - 2009-08-04
+========================
+
+Changelog
+=========
+
+v1.2 - 2009-08-04
+- removed DTV_BANDWIDTH from being a necessary parameter - now optional
+
+v1.1 - 2009-08-04
+- added DTV_FREQUENCY as a necessary parameter
+
+v1.0 - 2009-08-03
+- initial draft
+
+Proposal
+========
+
+This document describes shortly what are the possible parameters in the Linux
+DVB-API called "S2API" and now DVB API 5 in order to tune an ISDB-T/ISDB-Tsb
 demodulator:
 
 This ISDB-T/ISDB-Tsb API extension should reflect all information
@@ -35,18 +53,24 @@ valid frequncy could be 474143 kHz. The stepping is bound to the bandwidth of
 the channel which is 6MHz.
 
 As in ISDB-Tsb the channel consists of only one or three segments the
-frequency step is 428kHz, 3*428 respectively. As for ISDB-T the
+frequency step is 429kHz, 3*429 respectively. As for ISDB-T the
 central frequency of the channel is expected.
 
-b) DTV_BANDWIDTH_HZ
-
-Help the front-end, for example, to set up base-band-filters correctly.
+b) DTV_BANDWIDTH_HZ (optional)
 
 Possible values:
 
 For ISDB-T it should be always 6000000Hz (6MHz)
 For ISDB-Tsb it can vary depending on the number of connected segments
 
+Note: Hardware specific values might be given here, but standard
+applications should not bother to set a value to this field as
+standard demods are ignoring it anyway.
+
+Bandwidth in ISDB-T is fixed (6MHz) or can be easily derived from
+other parameters (DTV_ISDBT_SB_SEGMENT_IDX,
+DTV_ISDBT_SB_SEGMENT_COUNT).
+
 c) DTV_DELIVERY_SYSTEM
 
 Possible values: SYS_ISDBT
@@ -192,7 +216,7 @@ Possible values: FEC_AUTO, FEC_1_2, FEC_2_3, FEC_3_4, FEC_5_6, FEC_7_8,
 
 6.3 DTV_ISDBT_LAYER*_MODULATION
 
-Possible values: QAM_AUTO, DQPSK, QAM_16, QAM_64, DQPSK
+Possible values: QAM_AUTO, QPSK, QAM_16, QAM_64, DQPSK
 
 Note: If layer C is DQPSK layer B has to be DQPSK. If layer B is DQPSK
 and DTV_ISDBT_PARTIAL_RECEPTION=0 layer has to be DQPSK.