Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

[media] doc-rst: improve DTV_BANDWIDTH_HZ notes

There are several notes for this DTV property. Some are
outdated, so take some care of it, making it updated.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>

+17 -11
+17 -11
Documentation/media/uapi/dvb/fe_property_parameters.rst
··· 219 219 Possible values: ``1712000``, ``5000000``, ``6000000``, ``7000000``, 220 220 ``8000000``, ``10000000``. 221 221 222 - Notes: 222 + .. note:: 223 223 224 - 1) For ISDB-T it should be always 6000000Hz (6MHz) 224 + #. DVB-T supports 6, 7 and 8MHz. 225 225 226 - 2) For ISDB-Tsb it can vary depending on the number of connected 227 - segments 226 + #. DVB-T2 supports 1.172, 5, 6, 7, 8 and 10MHz. 228 227 229 - 3) Bandwidth doesn't apply for DVB-C transmissions, as the bandwidth for 230 - DVB-C depends on the symbol rate 228 + #. ISDB-T supports 5MHz, 6MHz, 7MHz and 8MHz, although most 229 + places use 6MHz. 231 230 232 - 4) Bandwidth in ISDB-T is fixed (6MHz) or can be easily derived from 233 - other parameters (DTV_ISDBT_SB_SEGMENT_IDX, 234 - DTV_ISDBT_SB_SEGMENT_COUNT). 231 + #. On DVB-C and DVB-S/S2, the bandwidth depends on the symbol rate. 232 + So, the Kernel will silently ignore setting :ref:`DTV-BANDWIDTH-HZ`. 235 233 236 - 5) DVB-T supports 6, 7 and 8MHz. 234 + #. For DVB-C and DVB-S/S2, the Kernel will return an estimation of the 235 + bandwidth, calculated from :ref:`DTV-SYMBOL-RATE` and from 236 + the rolloff, with is fixed for DVB-C and DVB-S. 237 237 238 - 6) In addition, DVB-T2 supports 1.172, 5 and 10MHz. 238 + #. For DVB-S2, the bandwidth estimation will use :ref:`DTV-ROLLOFF`. 239 + 240 + #. For ISDB-Tsb, it can vary depending on the number of connected 241 + segments. 242 + 243 + #. Bandwidth in ISDB-Tsb can be easily derived from other parameters 244 + (DTV_ISDBT_SB_SEGMENT_IDX, DTV_ISDBT_SB_SEGMENT_COUNT). 239 245 240 246 241 247 .. _DTV-INVERSION: