From 5377d91f3e88d5c8da46b1feba78b00d379fb7b6 Mon Sep 17 00:00:00 2001
From: Markus Heiser <markus.heiser@darmarIT.de>
Date: Thu, 30 Jun 2016 15:18:56 +0200
Subject: [PATCH] doc-rst: linux_tv DocBook to reST migration (docs-next)

This is the restructuredText (reST) migration of the ``media``
DocBook-XML set from the linux_tv project.

Signed-off-by: Markus Heiser <markus.heiser@darmarIT.de>
Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
---
 Documentation/index.rst                       |     1 +
 Documentation/linux_tv/audio.h.rst            |   153 +
 Documentation/linux_tv/ca.h.rst               |   108 +
 Documentation/linux_tv/conf.py                |   221 +
 Documentation/linux_tv/dmx.h.rst              |   173 +
 Documentation/linux_tv/frontend.h.rst         |   620 +
 Documentation/linux_tv/index.rst              |   100 +
 .../dvb/FE_DISHNETWORK_SEND_LEGACY_CMD.rst    |    55 +
 .../linux_tv/media/dvb/FE_GET_EVENT.rst       |    89 +
 .../linux_tv/media/dvb/FE_GET_FRONTEND.rst    |    77 +
 .../linux_tv/media/dvb/FE_READ_BER.rst        |    61 +
 .../media/dvb/FE_READ_SIGNAL_STRENGTH.rst     |    64 +
 .../linux_tv/media/dvb/FE_READ_SNR.rst        |    61 +
 .../media/dvb/FE_READ_UNCORRECTED_BLOCKS.rst  |    66 +
 .../linux_tv/media/dvb/FE_SET_FRONTEND.rst    |    84 +
 Documentation/linux_tv/media/dvb/audio.rst    |    37 +
 .../linux_tv/media/dvb/audio_data_types.rst   |   187 +
 .../media/dvb/audio_function_calls.rst        |  1308 ++
 Documentation/linux_tv/media/dvb/audio_h.rst  |    24 +
 Documentation/linux_tv/media/dvb/ca.rst       |    29 +
 .../linux_tv/media/dvb/ca_data_types.rst      |   121 +
 .../linux_tv/media/dvb/ca_function_calls.rst  |   541 +
 Documentation/linux_tv/media/dvb/ca_h.rst     |    24 +
 Documentation/linux_tv/media/dvb/demux.rst    |    29 +
 .../linux_tv/media/dvb/dmx_fcalls.rst         |  1013 ++
 Documentation/linux_tv/media/dvb/dmx_h.rst    |    24 +
 .../linux_tv/media/dvb/dmx_types.rst          |   253 +
 .../linux_tv/media/dvb/dtv-fe-stats.rst       |    28 +
 .../linux_tv/media/dvb/dtv-properties.rst     |    26 +
 .../linux_tv/media/dvb/dtv-property.rst       |    42 +
 .../linux_tv/media/dvb/dtv-stats.rst          |    29 +
 .../linux_tv/media/dvb/dvb-fe-read-status.rst |    31 +
 .../linux_tv/media/dvb/dvb-frontend-event.rst |    26 +
 .../media/dvb/dvb-frontend-parameters.rst     |   130 +
 Documentation/linux_tv/media/dvb/dvbapi.rst   |    95 +
 .../linux_tv/media/dvb/dvbproperty-006.rst    |    21 +
 .../linux_tv/media/dvb/dvbproperty.rst        |   122 +
 Documentation/linux_tv/media/dvb/examples.rst |   391 +
 .../linux_tv/media/dvb/fe-bandwidth-t.rst     |    88 +
 .../media/dvb/fe-diseqc-recv-slave-reply.rst  |    88 +
 .../media/dvb/fe-diseqc-reset-overload.rst    |    51 +
 .../media/dvb/fe-diseqc-send-burst.rst        |    93 +
 .../media/dvb/fe-diseqc-send-master-cmd.rst   |    78 +
 .../media/dvb/fe-enable-high-lnb-voltage.rst  |    58 +
 .../linux_tv/media/dvb/fe-get-info.rst        |   434 +
 .../linux_tv/media/dvb/fe-get-property.rst    |    75 +
 .../linux_tv/media/dvb/fe-read-status.rst     |   143 +
 .../media/dvb/fe-set-frontend-tune-mode.rst   |    60 +
 .../linux_tv/media/dvb/fe-set-tone.rst        |   100 +
 .../linux_tv/media/dvb/fe-set-voltage.rst     |    68 +
 .../linux_tv/media/dvb/fe-type-t.rst          |   100 +
 .../media/dvb/fe_property_parameters.rst      |  1976 +++
 .../dvb/frontend-property-cable-systems.rst   |    84 +
 .../frontend-property-satellite-systems.rst   |   112 +
 .../frontend-property-terrestrial-systems.rst |   303 +
 .../media/dvb/frontend-stat-properties.rst    |   254 +
 Documentation/linux_tv/media/dvb/frontend.rst |    62 +
 .../linux_tv/media/dvb/frontend_f_close.rst   |    55 +
 .../linux_tv/media/dvb/frontend_f_open.rst    |   108 +
 .../linux_tv/media/dvb/frontend_fcalls.rst    |    35 +
 .../linux_tv/media/dvb/frontend_h.rst         |    24 +
 .../media/dvb/frontend_legacy_api.rst         |    49 +
 .../media/dvb/frontend_legacy_dvbv3_api.rst   |    29 +
 Documentation/linux_tv/media/dvb/intro.rst    |   204 +
 .../linux_tv/media/dvb/intro_files/dvbstb.pdf |   Bin 0 -> 1881 bytes
 .../linux_tv/media/dvb/intro_files/dvbstb.png |   Bin 0 -> 22655 bytes
 .../linux_tv/media/dvb/legacy_dvb_apis.rst    |    31 +
 Documentation/linux_tv/media/dvb/net.rst      |   219 +
 Documentation/linux_tv/media/dvb/net_h.rst    |    24 +
 .../media/dvb/query-dvb-frontend-info.rst     |    22 +
 Documentation/linux_tv/media/dvb/video.rst    |    46 +
 .../media/dvb/video_function_calls.rst        |  1880 +++
 Documentation/linux_tv/media/dvb/video_h.rst  |    24 +
 .../linux_tv/media/dvb/video_types.rst        |   390 +
 .../media/v4l/Remote_controllers_Intro.rst    |    33 +
 .../v4l/Remote_controllers_table_change.rst   |    29 +
 .../media/v4l/Remote_controllers_tables.rst   |   768 +
 Documentation/linux_tv/media/v4l/app-pri.rst  |    39 +
 Documentation/linux_tv/media/v4l/async.rst    |    18 +
 Documentation/linux_tv/media/v4l/audio.rst    |    97 +
 Documentation/linux_tv/media/v4l/biblio.rst   |   390 +
 Documentation/linux_tv/media/v4l/buffer.rst   |   966 ++
 .../linux_tv/media/v4l/capture-example.rst    |    24 +
 .../linux_tv/media/v4l/capture.c.rst          |   675 +
 .../linux_tv/media/v4l/colorspaces.rst        |   172 +
 .../linux_tv/media/v4l/common-defs.rst        |    24 +
 Documentation/linux_tv/media/v4l/common.rst   |    56 +
 Documentation/linux_tv/media/v4l/compat.rst   |    29 +
 Documentation/linux_tv/media/v4l/control.rst  |   536 +
 Documentation/linux_tv/media/v4l/controls.rst |    18 +
 Documentation/linux_tv/media/v4l/crop.rst     |   300 +
 .../linux_tv/media/v4l/crop_files/crop.gif    |   Bin 0 -> 5967 bytes
 .../linux_tv/media/v4l/crop_files/crop.pdf    |   Bin 0 -> 5846 bytes
 .../linux_tv/media/v4l/depth-formats.rst      |    26 +
 .../linux_tv/media/v4l/dev-capture.rst        |   111 +
 .../linux_tv/media/v4l/dev-codec.rst          |    41 +
 .../linux_tv/media/v4l/dev-effect.rst         |    31 +
 .../linux_tv/media/v4l/dev-event.rst          |    56 +
 Documentation/linux_tv/media/v4l/dev-osd.rst  |   154 +
 .../linux_tv/media/v4l/dev-output.rst         |   108 +
 .../linux_tv/media/v4l/dev-overlay.rst        |   328 +
 .../linux_tv/media/v4l/dev-radio.rst          |    61 +
 .../linux_tv/media/v4l/dev-raw-vbi.rst        |   368 +
 .../media/v4l/dev-raw-vbi_files/vbi_525.gif   |   Bin 0 -> 4741 bytes
 .../media/v4l/dev-raw-vbi_files/vbi_525.pdf   |   Bin 0 -> 3395 bytes
 .../media/v4l/dev-raw-vbi_files/vbi_625.gif   |   Bin 0 -> 5095 bytes
 .../media/v4l/dev-raw-vbi_files/vbi_625.pdf   |   Bin 0 -> 3683 bytes
 .../media/v4l/dev-raw-vbi_files/vbi_hsync.gif |   Bin 0 -> 2400 bytes
 .../media/v4l/dev-raw-vbi_files/vbi_hsync.pdf |   Bin 0 -> 7405 bytes
 Documentation/linux_tv/media/v4l/dev-rds.rst  |   266 +
 Documentation/linux_tv/media/v4l/dev-sdr.rst  |   129 +
 .../linux_tv/media/v4l/dev-sliced-vbi.rst     |   804 ++
 .../linux_tv/media/v4l/dev-subdev.rst         |   502 +
 .../media/v4l/dev-subdev_files/pipeline.pdf   |   Bin 0 -> 20276 bytes
 .../media/v4l/dev-subdev_files/pipeline.png   |   Bin 0 -> 12130 bytes
 .../subdev-image-processing-crop.pdf          |   Bin 0 -> 20729 bytes
 .../subdev-image-processing-crop.svg          |    63 +
 .../subdev-image-processing-full.pdf          |   Bin 0 -> 46311 bytes
 .../subdev-image-processing-full.svg          |   163 +
 ...-image-processing-scaling-multi-source.pdf |   Bin 0 -> 36714 bytes
 ...-image-processing-scaling-multi-source.svg |   116 +
 .../linux_tv/media/v4l/dev-teletext.rst       |    43 +
 Documentation/linux_tv/media/v4l/devices.rst  |    37 +
 Documentation/linux_tv/media/v4l/diff-v4l.rst |   963 ++
 Documentation/linux_tv/media/v4l/dmabuf.rst   |   158 +
 Documentation/linux_tv/media/v4l/driver.rst   |    18 +
 .../linux_tv/media/v4l/dv-timings.rst         |    47 +
 .../linux_tv/media/v4l/extended-controls.rst  |  4533 ++++++
 .../linux_tv/media/v4l/fdl-appendix.rst       |   487 +
 .../linux_tv/media/v4l/field-order.rst        |   210 +
 .../v4l/field-order_files/fieldseq_bt.gif     |   Bin 0 -> 25430 bytes
 .../v4l/field-order_files/fieldseq_bt.pdf     |   Bin 0 -> 9185 bytes
 .../v4l/field-order_files/fieldseq_tb.gif     |   Bin 0 -> 25323 bytes
 .../v4l/field-order_files/fieldseq_tb.pdf     |   Bin 0 -> 9173 bytes
 Documentation/linux_tv/media/v4l/format.rst   |   101 +
 .../linux_tv/media/v4l/func-close.rst         |    56 +
 .../linux_tv/media/v4l/func-ioctl.rst         |    69 +
 .../linux_tv/media/v4l/func-mmap.rst          |   141 +
 .../linux_tv/media/v4l/func-munmap.rst        |    65 +
 .../linux_tv/media/v4l/func-open.rst          |    90 +
 .../linux_tv/media/v4l/func-poll.rst          |   118 +
 .../linux_tv/media/v4l/func-read.rst          |   138 +
 .../linux_tv/media/v4l/func-select.rst        |   108 +
 .../linux_tv/media/v4l/func-write.rst         |    89 +
 .../linux_tv/media/v4l/gen-errors.rst         |   109 +
 .../linux_tv/media/v4l/hist-v4l2.rst          |  1490 ++
 Documentation/linux_tv/media/v4l/io.rst       |    62 +
 .../linux_tv/media/v4l/keytable.c.rst         |   187 +
 .../media/v4l/libv4l-introduction.rst         |   178 +
 Documentation/linux_tv/media/v4l/libv4l.rst   |    24 +
 .../linux_tv/media/v4l/lirc_dev_intro.rst     |    37 +
 .../media/v4l/lirc_device_interface.rst       |    26 +
 .../linux_tv/media/v4l/lirc_ioctl.rst         |   165 +
 .../linux_tv/media/v4l/lirc_read.rst          |    28 +
 .../linux_tv/media/v4l/lirc_write.rst         |    23 +
 .../media/v4l/media-controller-intro.rst      |    42 +
 .../media/v4l/media-controller-model.rst      |    44 +
 .../linux_tv/media/v4l/media-controller.rst   |    66 +
 .../linux_tv/media/v4l/media-func-close.rst   |    54 +
 .../linux_tv/media/v4l/media-func-ioctl.rst   |    74 +
 .../linux_tv/media/v4l/media-func-open.rst    |    76 +
 .../media/v4l/media-ioc-device-info.rst       |   149 +
 .../media/v4l/media-ioc-enum-entities.rst     |   204 +
 .../media/v4l/media-ioc-enum-links.rst        |   180 +
 .../media/v4l/media-ioc-g-topology.rst        |   436 +
 .../media/v4l/media-ioc-setup-link.rst        |    75 +
 .../linux_tv/media/v4l/media-types.rst        |   433 +
 Documentation/linux_tv/media/v4l/mmap.rst     |   286 +
 Documentation/linux_tv/media/v4l/open.rst     |   168 +
 .../linux_tv/media/v4l/pixfmt-002.rst         |   207 +
 .../linux_tv/media/v4l/pixfmt-003.rst         |   177 +
 .../linux_tv/media/v4l/pixfmt-004.rst         |    60 +
 .../linux_tv/media/v4l/pixfmt-006.rst         |   291 +
 .../linux_tv/media/v4l/pixfmt-007.rst         |   870 ++
 .../linux_tv/media/v4l/pixfmt-008.rst         |    41 +
 .../linux_tv/media/v4l/pixfmt-013.rst         |   140 +
 .../linux_tv/media/v4l/pixfmt-grey.rst        |    89 +
 .../linux_tv/media/v4l/pixfmt-indexed.rst     |    84 +
 .../linux_tv/media/v4l/pixfmt-m420.rst        |   238 +
 .../linux_tv/media/v4l/pixfmt-nv12.rst        |   241 +
 .../linux_tv/media/v4l/pixfmt-nv12m.rst       |   256 +
 .../linux_tv/media/v4l/pixfmt-nv12mt.rst      |    71 +
 .../media/v4l/pixfmt-nv12mt_files/nv12mt.gif  |   Bin 0 -> 2108 bytes
 .../pixfmt-nv12mt_files/nv12mt_example.gif    |   Bin 0 -> 6858 bytes
 .../linux_tv/media/v4l/pixfmt-nv16.rst        |   290 +
 .../linux_tv/media/v4l/pixfmt-nv16m.rst       |   297 +
 .../linux_tv/media/v4l/pixfmt-nv24.rst        |   182 +
 .../linux_tv/media/v4l/pixfmt-packed-rgb.rst  |  1479 ++
 .../linux_tv/media/v4l/pixfmt-packed-yuv.rst  |   325 +
 .../linux_tv/media/v4l/pixfmt-reserved.rst    |   371 +
 .../linux_tv/media/v4l/pixfmt-rgb.rst         |    34 +
 .../linux_tv/media/v4l/pixfmt-sbggr16.rst     |   125 +
 .../linux_tv/media/v4l/pixfmt-sbggr8.rst      |    93 +
 .../linux_tv/media/v4l/pixfmt-sdr-cs08.rst    |    55 +
 .../linux_tv/media/v4l/pixfmt-sdr-cs14le.rst  |    60 +
 .../linux_tv/media/v4l/pixfmt-sdr-cu08.rst    |    55 +
 .../linux_tv/media/v4l/pixfmt-sdr-cu16le.rst  |    59 +
 .../linux_tv/media/v4l/pixfmt-sdr-ru12le.rst  |    50 +
 .../linux_tv/media/v4l/pixfmt-sgbrg8.rst      |    93 +
 .../linux_tv/media/v4l/pixfmt-sgrbg8.rst      |    93 +
 .../linux_tv/media/v4l/pixfmt-srggb10.rst     |   129 +
 .../media/v4l/pixfmt-srggb10alaw8.rst         |    32 +
 .../media/v4l/pixfmt-srggb10dpcm8.rst         |    33 +
 .../linux_tv/media/v4l/pixfmt-srggb10p.rst    |   112 +
 .../linux_tv/media/v4l/pixfmt-srggb12.rst     |   129 +
 .../linux_tv/media/v4l/pixfmt-srggb8.rst      |    93 +
 .../linux_tv/media/v4l/pixfmt-uv8.rst         |    88 +
 .../linux_tv/media/v4l/pixfmt-uyvy.rst        |   216 +
 .../linux_tv/media/v4l/pixfmt-vyuy.rst        |   216 +
 .../linux_tv/media/v4l/pixfmt-y10.rst         |   122 +
 .../linux_tv/media/v4l/pixfmt-y10b.rst        |    56 +
 .../linux_tv/media/v4l/pixfmt-y12.rst         |   122 +
 .../linux_tv/media/v4l/pixfmt-y12i.rst        |    59 +
 .../linux_tv/media/v4l/pixfmt-y16-be.rst      |   123 +
 .../linux_tv/media/v4l/pixfmt-y16.rst         |   123 +
 .../linux_tv/media/v4l/pixfmt-y41p.rst        |   313 +
 .../linux_tv/media/v4l/pixfmt-y8i.rst         |   123 +
 .../linux_tv/media/v4l/pixfmt-yuv410.rst      |   219 +
 .../linux_tv/media/v4l/pixfmt-yuv411p.rst     |   237 +
 .../linux_tv/media/v4l/pixfmt-yuv420.rst      |   250 +
 .../linux_tv/media/v4l/pixfmt-yuv420m.rst     |   265 +
 .../linux_tv/media/v4l/pixfmt-yuv422m.rst     |   274 +
 .../linux_tv/media/v4l/pixfmt-yuv422p.rst     |   257 +
 .../linux_tv/media/v4l/pixfmt-yuv444m.rst     |   294 +
 .../linux_tv/media/v4l/pixfmt-yuyv.rst        |   217 +
 .../linux_tv/media/v4l/pixfmt-yvyu.rst        |   216 +
 .../linux_tv/media/v4l/pixfmt-z16.rst         |   123 +
 Documentation/linux_tv/media/v4l/pixfmt.rst   |    46 +
 .../linux_tv/media/v4l/planar-apis.rst        |    74 +
 Documentation/linux_tv/media/v4l/querycap.rst |    43 +
 .../linux_tv/media/v4l/remote_controllers.rst |    53 +
 .../v4l/remote_controllers_sysfs_nodes.rst    |   152 +
 Documentation/linux_tv/media/v4l/rw.rst       |    56 +
 .../linux_tv/media/v4l/sdr-formats.rst        |    30 +
 .../linux_tv/media/v4l/selection-api-002.rst  |    37 +
 .../linux_tv/media/v4l/selection-api-003.rst  |    29 +
 .../v4l/selection-api-003_files/selection.png |   Bin 0 -> 11716 bytes
 .../linux_tv/media/v4l/selection-api-004.rst  |   146 +
 .../linux_tv/media/v4l/selection-api-005.rst  |    42 +
 .../linux_tv/media/v4l/selection-api-006.rst  |    89 +
 .../linux_tv/media/v4l/selection-api.rst      |    27 +
 .../linux_tv/media/v4l/selections-common.rst  |    34 +
 Documentation/linux_tv/media/v4l/standard.rst |   185 +
 .../linux_tv/media/v4l/streaming-par.rst      |    42 +
 .../linux_tv/media/v4l/subdev-formats.rst     | 11701 ++++++++++++++++
 .../media/v4l/subdev-formats_files/bayer.png  |   Bin 0 -> 9725 bytes
 Documentation/linux_tv/media/v4l/tuner.rst    |    91 +
 .../linux_tv/media/v4l/user-func.rst          |    92 +
 Documentation/linux_tv/media/v4l/userp.rst    |   123 +
 .../media/v4l/v4l2-selection-flags.rst        |    82 +
 .../media/v4l/v4l2-selection-targets.rst      |   146 +
 Documentation/linux_tv/media/v4l/v4l2.rst     |   392 +
 .../linux_tv/media/v4l/v4l2grab-example.rst   |    28 +
 .../linux_tv/media/v4l/v4l2grab.c.rst         |   180 +
 Documentation/linux_tv/media/v4l/video.rst    |    73 +
 Documentation/linux_tv/media/v4l/videodev.rst |    24 +
 .../linux_tv/media/v4l/vidioc-create-bufs.rst |   154 +
 .../linux_tv/media/v4l/vidioc-cropcap.rst     |   175 +
 .../media/v4l/vidioc-dbg-g-chip-info.rst      |   212 +
 .../media/v4l/vidioc-dbg-g-register.rst       |   218 +
 .../linux_tv/media/v4l/vidioc-decoder-cmd.rst |   280 +
 .../linux_tv/media/v4l/vidioc-dqevent.rst     |   581 +
 .../media/v4l/vidioc-dv-timings-cap.rst       |   259 +
 .../linux_tv/media/v4l/vidioc-encoder-cmd.rst |   204 +
 .../media/v4l/vidioc-enum-dv-timings.rst      |   128 +
 .../linux_tv/media/v4l/vidioc-enum-fmt.rst    |   172 +
 .../media/v4l/vidioc-enum-frameintervals.rst  |   282 +
 .../media/v4l/vidioc-enum-framesizes.rst      |   299 +
 .../media/v4l/vidioc-enum-freq-bands.rst      |   198 +
 .../linux_tv/media/v4l/vidioc-enumaudio.rst   |    63 +
 .../media/v4l/vidioc-enumaudioout.rst         |    66 +
 .../linux_tv/media/v4l/vidioc-enuminput.rst   |   375 +
 .../linux_tv/media/v4l/vidioc-enumoutput.rst  |   230 +
 .../linux_tv/media/v4l/vidioc-enumstd.rst     |   450 +
 .../linux_tv/media/v4l/vidioc-expbuf.rst      |   205 +
 .../linux_tv/media/v4l/vidioc-g-audio.rst     |   171 +
 .../linux_tv/media/v4l/vidioc-g-audioout.rst  |   131 +
 .../linux_tv/media/v4l/vidioc-g-crop.rst      |   122 +
 .../linux_tv/media/v4l/vidioc-g-ctrl.rst      |   114 +
 .../media/v4l/vidioc-g-dv-timings.rst         |   429 +
 .../linux_tv/media/v4l/vidioc-g-edid.rst      |   171 +
 .../linux_tv/media/v4l/vidioc-g-enc-index.rst |   218 +
 .../linux_tv/media/v4l/vidioc-g-ext-ctrls.rst |   498 +
 .../linux_tv/media/v4l/vidioc-g-fbuf.rst      |   509 +
 .../linux_tv/media/v4l/vidioc-g-fmt.rst       |   198 +
 .../linux_tv/media/v4l/vidioc-g-frequency.rst |   132 +
 .../linux_tv/media/v4l/vidioc-g-input.rst     |    70 +
 .../linux_tv/media/v4l/vidioc-g-jpegcomp.rst  |   191 +
 .../linux_tv/media/v4l/vidioc-g-modulator.rst |   264 +
 .../linux_tv/media/v4l/vidioc-g-output.rst    |    72 +
 .../linux_tv/media/v4l/vidioc-g-parm.rst      |   358 +
 .../linux_tv/media/v4l/vidioc-g-priority.rst  |   126 +
 .../linux_tv/media/v4l/vidioc-g-selection.rst |   218 +
 .../vidioc-g-selection_files/constraints.png  |   Bin 0 -> 3313 bytes
 .../media/v4l/vidioc-g-sliced-vbi-cap.rst     |   284 +
 .../linux_tv/media/v4l/vidioc-g-std.rst       |    76 +
 .../linux_tv/media/v4l/vidioc-g-tuner.rst     |   724 +
 .../linux_tv/media/v4l/vidioc-log-status.rst  |    48 +
 .../linux_tv/media/v4l/vidioc-overlay.rst     |    62 +
 .../linux_tv/media/v4l/vidioc-prepare-buf.rst |    69 +
 .../linux_tv/media/v4l/vidioc-qbuf.rst        |   158 +
 .../media/v4l/vidioc-query-dv-timings.rst     |    91 +
 .../linux_tv/media/v4l/vidioc-querybuf.rst    |    88 +
 .../linux_tv/media/v4l/vidioc-querycap.rst    |   442 +
 .../linux_tv/media/v4l/vidioc-queryctrl.rst   |   790 ++
 .../linux_tv/media/v4l/vidioc-querystd.rst    |    73 +
 .../linux_tv/media/v4l/vidioc-reqbufs.rst     |   133 +
 .../media/v4l/vidioc-s-hw-freq-seek.rst       |   187 +
 .../linux_tv/media/v4l/vidioc-streamon.rst    |   111 +
 .../v4l/vidioc-subdev-enum-frame-interval.rst |   161 +
 .../v4l/vidioc-subdev-enum-frame-size.rst     |   170 +
 .../v4l/vidioc-subdev-enum-mbus-code.rst      |   123 +
 .../media/v4l/vidioc-subdev-g-crop.rst        |   145 +
 .../media/v4l/vidioc-subdev-g-fmt.rst         |   181 +
 .../v4l/vidioc-subdev-g-frame-interval.rst    |   131 +
 .../media/v4l/vidioc-subdev-g-selection.rst   |   153 +
 .../media/v4l/vidioc-subscribe-event.rst      |   144 +
 .../linux_tv/media/v4l/yuv-formats.rst        |    66 +
 .../media_api_files/typical_media_device.pdf  |   Bin 0 -> 134268 bytes
 .../media_api_files/typical_media_device.svg  |    28 +
 Documentation/linux_tv/net.h.rst              |    70 +
 Documentation/linux_tv/video.h.rst            |   291 +
 Documentation/linux_tv/videodev2.h.rst        |  2311 +++
 323 files changed, 74156 insertions(+)
 create mode 100644 Documentation/linux_tv/audio.h.rst
 create mode 100644 Documentation/linux_tv/ca.h.rst
 create mode 100644 Documentation/linux_tv/conf.py
 create mode 100644 Documentation/linux_tv/dmx.h.rst
 create mode 100644 Documentation/linux_tv/frontend.h.rst
 create mode 100644 Documentation/linux_tv/index.rst
 create mode 100644 Documentation/linux_tv/media/dvb/FE_DISHNETWORK_SEND_LEGACY_CMD.rst
 create mode 100644 Documentation/linux_tv/media/dvb/FE_GET_EVENT.rst
 create mode 100644 Documentation/linux_tv/media/dvb/FE_GET_FRONTEND.rst
 create mode 100644 Documentation/linux_tv/media/dvb/FE_READ_BER.rst
 create mode 100644 Documentation/linux_tv/media/dvb/FE_READ_SIGNAL_STRENGTH.rst
 create mode 100644 Documentation/linux_tv/media/dvb/FE_READ_SNR.rst
 create mode 100644 Documentation/linux_tv/media/dvb/FE_READ_UNCORRECTED_BLOCKS.rst
 create mode 100644 Documentation/linux_tv/media/dvb/FE_SET_FRONTEND.rst
 create mode 100644 Documentation/linux_tv/media/dvb/audio.rst
 create mode 100644 Documentation/linux_tv/media/dvb/audio_data_types.rst
 create mode 100644 Documentation/linux_tv/media/dvb/audio_function_calls.rst
 create mode 100644 Documentation/linux_tv/media/dvb/audio_h.rst
 create mode 100644 Documentation/linux_tv/media/dvb/ca.rst
 create mode 100644 Documentation/linux_tv/media/dvb/ca_data_types.rst
 create mode 100644 Documentation/linux_tv/media/dvb/ca_function_calls.rst
 create mode 100644 Documentation/linux_tv/media/dvb/ca_h.rst
 create mode 100644 Documentation/linux_tv/media/dvb/demux.rst
 create mode 100644 Documentation/linux_tv/media/dvb/dmx_fcalls.rst
 create mode 100644 Documentation/linux_tv/media/dvb/dmx_h.rst
 create mode 100644 Documentation/linux_tv/media/dvb/dmx_types.rst
 create mode 100644 Documentation/linux_tv/media/dvb/dtv-fe-stats.rst
 create mode 100644 Documentation/linux_tv/media/dvb/dtv-properties.rst
 create mode 100644 Documentation/linux_tv/media/dvb/dtv-property.rst
 create mode 100644 Documentation/linux_tv/media/dvb/dtv-stats.rst
 create mode 100644 Documentation/linux_tv/media/dvb/dvb-fe-read-status.rst
 create mode 100644 Documentation/linux_tv/media/dvb/dvb-frontend-event.rst
 create mode 100644 Documentation/linux_tv/media/dvb/dvb-frontend-parameters.rst
 create mode 100644 Documentation/linux_tv/media/dvb/dvbapi.rst
 create mode 100644 Documentation/linux_tv/media/dvb/dvbproperty-006.rst
 create mode 100644 Documentation/linux_tv/media/dvb/dvbproperty.rst
 create mode 100644 Documentation/linux_tv/media/dvb/examples.rst
 create mode 100644 Documentation/linux_tv/media/dvb/fe-bandwidth-t.rst
 create mode 100644 Documentation/linux_tv/media/dvb/fe-diseqc-recv-slave-reply.rst
 create mode 100644 Documentation/linux_tv/media/dvb/fe-diseqc-reset-overload.rst
 create mode 100644 Documentation/linux_tv/media/dvb/fe-diseqc-send-burst.rst
 create mode 100644 Documentation/linux_tv/media/dvb/fe-diseqc-send-master-cmd.rst
 create mode 100644 Documentation/linux_tv/media/dvb/fe-enable-high-lnb-voltage.rst
 create mode 100644 Documentation/linux_tv/media/dvb/fe-get-info.rst
 create mode 100644 Documentation/linux_tv/media/dvb/fe-get-property.rst
 create mode 100644 Documentation/linux_tv/media/dvb/fe-read-status.rst
 create mode 100644 Documentation/linux_tv/media/dvb/fe-set-frontend-tune-mode.rst
 create mode 100644 Documentation/linux_tv/media/dvb/fe-set-tone.rst
 create mode 100644 Documentation/linux_tv/media/dvb/fe-set-voltage.rst
 create mode 100644 Documentation/linux_tv/media/dvb/fe-type-t.rst
 create mode 100644 Documentation/linux_tv/media/dvb/fe_property_parameters.rst
 create mode 100644 Documentation/linux_tv/media/dvb/frontend-property-cable-systems.rst
 create mode 100644 Documentation/linux_tv/media/dvb/frontend-property-satellite-systems.rst
 create mode 100644 Documentation/linux_tv/media/dvb/frontend-property-terrestrial-systems.rst
 create mode 100644 Documentation/linux_tv/media/dvb/frontend-stat-properties.rst
 create mode 100644 Documentation/linux_tv/media/dvb/frontend.rst
 create mode 100644 Documentation/linux_tv/media/dvb/frontend_f_close.rst
 create mode 100644 Documentation/linux_tv/media/dvb/frontend_f_open.rst
 create mode 100644 Documentation/linux_tv/media/dvb/frontend_fcalls.rst
 create mode 100644 Documentation/linux_tv/media/dvb/frontend_h.rst
 create mode 100644 Documentation/linux_tv/media/dvb/frontend_legacy_api.rst
 create mode 100644 Documentation/linux_tv/media/dvb/frontend_legacy_dvbv3_api.rst
 create mode 100644 Documentation/linux_tv/media/dvb/intro.rst
 create mode 100644 Documentation/linux_tv/media/dvb/intro_files/dvbstb.pdf
 create mode 100644 Documentation/linux_tv/media/dvb/intro_files/dvbstb.png
 create mode 100644 Documentation/linux_tv/media/dvb/legacy_dvb_apis.rst
 create mode 100644 Documentation/linux_tv/media/dvb/net.rst
 create mode 100644 Documentation/linux_tv/media/dvb/net_h.rst
 create mode 100644 Documentation/linux_tv/media/dvb/query-dvb-frontend-info.rst
 create mode 100644 Documentation/linux_tv/media/dvb/video.rst
 create mode 100644 Documentation/linux_tv/media/dvb/video_function_calls.rst
 create mode 100644 Documentation/linux_tv/media/dvb/video_h.rst
 create mode 100644 Documentation/linux_tv/media/dvb/video_types.rst
 create mode 100644 Documentation/linux_tv/media/v4l/Remote_controllers_Intro.rst
 create mode 100644 Documentation/linux_tv/media/v4l/Remote_controllers_table_change.rst
 create mode 100644 Documentation/linux_tv/media/v4l/Remote_controllers_tables.rst
 create mode 100644 Documentation/linux_tv/media/v4l/app-pri.rst
 create mode 100644 Documentation/linux_tv/media/v4l/async.rst
 create mode 100644 Documentation/linux_tv/media/v4l/audio.rst
 create mode 100644 Documentation/linux_tv/media/v4l/biblio.rst
 create mode 100644 Documentation/linux_tv/media/v4l/buffer.rst
 create mode 100644 Documentation/linux_tv/media/v4l/capture-example.rst
 create mode 100644 Documentation/linux_tv/media/v4l/capture.c.rst
 create mode 100644 Documentation/linux_tv/media/v4l/colorspaces.rst
 create mode 100644 Documentation/linux_tv/media/v4l/common-defs.rst
 create mode 100644 Documentation/linux_tv/media/v4l/common.rst
 create mode 100644 Documentation/linux_tv/media/v4l/compat.rst
 create mode 100644 Documentation/linux_tv/media/v4l/control.rst
 create mode 100644 Documentation/linux_tv/media/v4l/controls.rst
 create mode 100644 Documentation/linux_tv/media/v4l/crop.rst
 create mode 100644 Documentation/linux_tv/media/v4l/crop_files/crop.gif
 create mode 100644 Documentation/linux_tv/media/v4l/crop_files/crop.pdf
 create mode 100644 Documentation/linux_tv/media/v4l/depth-formats.rst
 create mode 100644 Documentation/linux_tv/media/v4l/dev-capture.rst
 create mode 100644 Documentation/linux_tv/media/v4l/dev-codec.rst
 create mode 100644 Documentation/linux_tv/media/v4l/dev-effect.rst
 create mode 100644 Documentation/linux_tv/media/v4l/dev-event.rst
 create mode 100644 Documentation/linux_tv/media/v4l/dev-osd.rst
 create mode 100644 Documentation/linux_tv/media/v4l/dev-output.rst
 create mode 100644 Documentation/linux_tv/media/v4l/dev-overlay.rst
 create mode 100644 Documentation/linux_tv/media/v4l/dev-radio.rst
 create mode 100644 Documentation/linux_tv/media/v4l/dev-raw-vbi.rst
 create mode 100644 Documentation/linux_tv/media/v4l/dev-raw-vbi_files/vbi_525.gif
 create mode 100644 Documentation/linux_tv/media/v4l/dev-raw-vbi_files/vbi_525.pdf
 create mode 100644 Documentation/linux_tv/media/v4l/dev-raw-vbi_files/vbi_625.gif
 create mode 100644 Documentation/linux_tv/media/v4l/dev-raw-vbi_files/vbi_625.pdf
 create mode 100644 Documentation/linux_tv/media/v4l/dev-raw-vbi_files/vbi_hsync.gif
 create mode 100644 Documentation/linux_tv/media/v4l/dev-raw-vbi_files/vbi_hsync.pdf
 create mode 100644 Documentation/linux_tv/media/v4l/dev-rds.rst
 create mode 100644 Documentation/linux_tv/media/v4l/dev-sdr.rst
 create mode 100644 Documentation/linux_tv/media/v4l/dev-sliced-vbi.rst
 create mode 100644 Documentation/linux_tv/media/v4l/dev-subdev.rst
 create mode 100644 Documentation/linux_tv/media/v4l/dev-subdev_files/pipeline.pdf
 create mode 100644 Documentation/linux_tv/media/v4l/dev-subdev_files/pipeline.png
 create mode 100644 Documentation/linux_tv/media/v4l/dev-subdev_files/subdev-image-processing-crop.pdf
 create mode 100644 Documentation/linux_tv/media/v4l/dev-subdev_files/subdev-image-processing-crop.svg
 create mode 100644 Documentation/linux_tv/media/v4l/dev-subdev_files/subdev-image-processing-full.pdf
 create mode 100644 Documentation/linux_tv/media/v4l/dev-subdev_files/subdev-image-processing-full.svg
 create mode 100644 Documentation/linux_tv/media/v4l/dev-subdev_files/subdev-image-processing-scaling-multi-source.pdf
 create mode 100644 Documentation/linux_tv/media/v4l/dev-subdev_files/subdev-image-processing-scaling-multi-source.svg
 create mode 100644 Documentation/linux_tv/media/v4l/dev-teletext.rst
 create mode 100644 Documentation/linux_tv/media/v4l/devices.rst
 create mode 100644 Documentation/linux_tv/media/v4l/diff-v4l.rst
 create mode 100644 Documentation/linux_tv/media/v4l/dmabuf.rst
 create mode 100644 Documentation/linux_tv/media/v4l/driver.rst
 create mode 100644 Documentation/linux_tv/media/v4l/dv-timings.rst
 create mode 100644 Documentation/linux_tv/media/v4l/extended-controls.rst
 create mode 100644 Documentation/linux_tv/media/v4l/fdl-appendix.rst
 create mode 100644 Documentation/linux_tv/media/v4l/field-order.rst
 create mode 100644 Documentation/linux_tv/media/v4l/field-order_files/fieldseq_bt.gif
 create mode 100644 Documentation/linux_tv/media/v4l/field-order_files/fieldseq_bt.pdf
 create mode 100644 Documentation/linux_tv/media/v4l/field-order_files/fieldseq_tb.gif
 create mode 100644 Documentation/linux_tv/media/v4l/field-order_files/fieldseq_tb.pdf
 create mode 100644 Documentation/linux_tv/media/v4l/format.rst
 create mode 100644 Documentation/linux_tv/media/v4l/func-close.rst
 create mode 100644 Documentation/linux_tv/media/v4l/func-ioctl.rst
 create mode 100644 Documentation/linux_tv/media/v4l/func-mmap.rst
 create mode 100644 Documentation/linux_tv/media/v4l/func-munmap.rst
 create mode 100644 Documentation/linux_tv/media/v4l/func-open.rst
 create mode 100644 Documentation/linux_tv/media/v4l/func-poll.rst
 create mode 100644 Documentation/linux_tv/media/v4l/func-read.rst
 create mode 100644 Documentation/linux_tv/media/v4l/func-select.rst
 create mode 100644 Documentation/linux_tv/media/v4l/func-write.rst
 create mode 100644 Documentation/linux_tv/media/v4l/gen-errors.rst
 create mode 100644 Documentation/linux_tv/media/v4l/hist-v4l2.rst
 create mode 100644 Documentation/linux_tv/media/v4l/io.rst
 create mode 100644 Documentation/linux_tv/media/v4l/keytable.c.rst
 create mode 100644 Documentation/linux_tv/media/v4l/libv4l-introduction.rst
 create mode 100644 Documentation/linux_tv/media/v4l/libv4l.rst
 create mode 100644 Documentation/linux_tv/media/v4l/lirc_dev_intro.rst
 create mode 100644 Documentation/linux_tv/media/v4l/lirc_device_interface.rst
 create mode 100644 Documentation/linux_tv/media/v4l/lirc_ioctl.rst
 create mode 100644 Documentation/linux_tv/media/v4l/lirc_read.rst
 create mode 100644 Documentation/linux_tv/media/v4l/lirc_write.rst
 create mode 100644 Documentation/linux_tv/media/v4l/media-controller-intro.rst
 create mode 100644 Documentation/linux_tv/media/v4l/media-controller-model.rst
 create mode 100644 Documentation/linux_tv/media/v4l/media-controller.rst
 create mode 100644 Documentation/linux_tv/media/v4l/media-func-close.rst
 create mode 100644 Documentation/linux_tv/media/v4l/media-func-ioctl.rst
 create mode 100644 Documentation/linux_tv/media/v4l/media-func-open.rst
 create mode 100644 Documentation/linux_tv/media/v4l/media-ioc-device-info.rst
 create mode 100644 Documentation/linux_tv/media/v4l/media-ioc-enum-entities.rst
 create mode 100644 Documentation/linux_tv/media/v4l/media-ioc-enum-links.rst
 create mode 100644 Documentation/linux_tv/media/v4l/media-ioc-g-topology.rst
 create mode 100644 Documentation/linux_tv/media/v4l/media-ioc-setup-link.rst
 create mode 100644 Documentation/linux_tv/media/v4l/media-types.rst
 create mode 100644 Documentation/linux_tv/media/v4l/mmap.rst
 create mode 100644 Documentation/linux_tv/media/v4l/open.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-002.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-003.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-004.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-006.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-007.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-008.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-013.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-grey.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-indexed.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-m420.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-nv12.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-nv12m.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-nv12mt.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-nv12mt_files/nv12mt.gif
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-nv12mt_files/nv12mt_example.gif
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-nv16.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-nv16m.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-nv24.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-packed-rgb.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-packed-yuv.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-reserved.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-rgb.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-sbggr16.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-sbggr8.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-sdr-cs08.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-sdr-cs14le.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-sdr-cu08.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-sdr-cu16le.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-sdr-ru12le.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-sgbrg8.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-sgrbg8.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-srggb10.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-srggb10alaw8.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-srggb10dpcm8.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-srggb10p.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-srggb12.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-srggb8.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-uv8.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-uyvy.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-vyuy.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-y10.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-y10b.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-y12.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-y12i.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-y16-be.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-y16.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-y41p.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-y8i.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-yuv410.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-yuv411p.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-yuv420.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-yuv420m.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-yuv422m.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-yuv422p.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-yuv444m.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-yuyv.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-yvyu.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt-z16.rst
 create mode 100644 Documentation/linux_tv/media/v4l/pixfmt.rst
 create mode 100644 Documentation/linux_tv/media/v4l/planar-apis.rst
 create mode 100644 Documentation/linux_tv/media/v4l/querycap.rst
 create mode 100644 Documentation/linux_tv/media/v4l/remote_controllers.rst
 create mode 100644 Documentation/linux_tv/media/v4l/remote_controllers_sysfs_nodes.rst
 create mode 100644 Documentation/linux_tv/media/v4l/rw.rst
 create mode 100644 Documentation/linux_tv/media/v4l/sdr-formats.rst
 create mode 100644 Documentation/linux_tv/media/v4l/selection-api-002.rst
 create mode 100644 Documentation/linux_tv/media/v4l/selection-api-003.rst
 create mode 100644 Documentation/linux_tv/media/v4l/selection-api-003_files/selection.png
 create mode 100644 Documentation/linux_tv/media/v4l/selection-api-004.rst
 create mode 100644 Documentation/linux_tv/media/v4l/selection-api-005.rst
 create mode 100644 Documentation/linux_tv/media/v4l/selection-api-006.rst
 create mode 100644 Documentation/linux_tv/media/v4l/selection-api.rst
 create mode 100644 Documentation/linux_tv/media/v4l/selections-common.rst
 create mode 100644 Documentation/linux_tv/media/v4l/standard.rst
 create mode 100644 Documentation/linux_tv/media/v4l/streaming-par.rst
 create mode 100644 Documentation/linux_tv/media/v4l/subdev-formats.rst
 create mode 100644 Documentation/linux_tv/media/v4l/subdev-formats_files/bayer.png
 create mode 100644 Documentation/linux_tv/media/v4l/tuner.rst
 create mode 100644 Documentation/linux_tv/media/v4l/user-func.rst
 create mode 100644 Documentation/linux_tv/media/v4l/userp.rst
 create mode 100644 Documentation/linux_tv/media/v4l/v4l2-selection-flags.rst
 create mode 100644 Documentation/linux_tv/media/v4l/v4l2-selection-targets.rst
 create mode 100644 Documentation/linux_tv/media/v4l/v4l2.rst
 create mode 100644 Documentation/linux_tv/media/v4l/v4l2grab-example.rst
 create mode 100644 Documentation/linux_tv/media/v4l/v4l2grab.c.rst
 create mode 100644 Documentation/linux_tv/media/v4l/video.rst
 create mode 100644 Documentation/linux_tv/media/v4l/videodev.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-create-bufs.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-cropcap.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-dbg-g-chip-info.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-dbg-g-register.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-decoder-cmd.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-dqevent.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-dv-timings-cap.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-encoder-cmd.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-enum-dv-timings.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-enum-fmt.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-enum-frameintervals.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-enum-framesizes.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-enum-freq-bands.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-enumaudio.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-enumaudioout.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-enuminput.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-enumoutput.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-enumstd.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-expbuf.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-g-audio.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-g-audioout.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-g-crop.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-g-ctrl.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-g-dv-timings.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-g-edid.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-g-enc-index.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-g-ext-ctrls.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-g-fbuf.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-g-fmt.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-g-frequency.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-g-input.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-g-jpegcomp.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-g-modulator.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-g-output.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-g-parm.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-g-priority.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-g-selection.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-g-selection_files/constraints.png
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-g-sliced-vbi-cap.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-g-std.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-g-tuner.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-log-status.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-overlay.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-prepare-buf.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-qbuf.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-query-dv-timings.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-querybuf.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-querycap.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-queryctrl.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-querystd.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-reqbufs.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-s-hw-freq-seek.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-streamon.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-subdev-enum-frame-interval.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-subdev-enum-frame-size.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-subdev-enum-mbus-code.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-subdev-g-crop.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-subdev-g-fmt.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-subdev-g-frame-interval.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-subdev-g-selection.rst
 create mode 100644 Documentation/linux_tv/media/v4l/vidioc-subscribe-event.rst
 create mode 100644 Documentation/linux_tv/media/v4l/yuv-formats.rst
 create mode 100644 Documentation/linux_tv/media_api_files/typical_media_device.pdf
 create mode 100644 Documentation/linux_tv/media_api_files/typical_media_device.svg
 create mode 100644 Documentation/linux_tv/net.h.rst
 create mode 100644 Documentation/linux_tv/video.h.rst
 create mode 100644 Documentation/linux_tv/videodev2.h.rst

diff --git a/Documentation/index.rst b/Documentation/index.rst
index f92854f01773..8bc7bf4e6041 100644
--- a/Documentation/index.rst
+++ b/Documentation/index.rst
@@ -14,6 +14,7 @@ Contents:
    :maxdepth: 2
 
    kernel-documentation
+   linux_tv/index
 
 Indices and tables
 ==================
diff --git a/Documentation/linux_tv/audio.h.rst b/Documentation/linux_tv/audio.h.rst
new file mode 100644
index 000000000000..abf29027f8ea
--- /dev/null
+++ b/Documentation/linux_tv/audio.h.rst
@@ -0,0 +1,153 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+file: audio.h
+=============
+
+.. code-block:: c
+
+    /*
+     * audio.h
+     *
+     * Copyright (C) 2000 Ralph  Metzler <ralph@convergence.de>
+     *                  & Marcus Metzler <marcus@convergence.de>
+     *                    for convergence integrated media GmbH
+     *
+     * This program is free software; you can redistribute it and/or
+     * modify it under the terms of the GNU General Lesser Public License
+     * as published by the Free Software Foundation; either version 2.1
+     * of the License, or (at your option) any later version.
+     *
+     * This program is distributed in the hope that it will be useful,
+     * but WITHOUT ANY WARRANTY; without even the implied warranty of
+     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+     * GNU General Public License for more details.
+     *
+     * You should have received a copy of the GNU Lesser General Public License
+     * along with this program; if not, write to the Free Software
+     * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+     *
+     */
+
+    #ifndef _DVBAUDIO_H_
+    #define _DVBAUDIO_H_
+
+    #include <linux/types.h>
+
+    typedef enum {
+            AUDIO_SOURCE_DEMUX, /* Select the demux as the main source */
+            AUDIO_SOURCE_MEMORY /* Select internal memory as the main source */
+    } audio_stream_source_t;
+
+
+    typedef enum {
+            AUDIO_STOPPED,      /* Device is stopped */
+            AUDIO_PLAYING,      /* Device is currently playing */
+            AUDIO_PAUSED        /* Device is paused */
+    } audio_play_state_t;
+
+
+    typedef enum {
+            AUDIO_STEREO,
+            AUDIO_MONO_LEFT,
+            AUDIO_MONO_RIGHT,
+            AUDIO_MONO,
+            AUDIO_STEREO_SWAPPED
+    } audio_channel_select_t;
+
+
+    typedef struct audio_mixer {
+            unsigned int volume_left;
+            unsigned int volume_right;
+      // what else do we need? bass, pass-through, ...
+    } audio_mixer_t;
+
+
+    typedef struct audio_status {
+            int                    AV_sync_state;  /* sync audio and video? */
+            int                    mute_state;     /* audio is muted */
+            audio_play_state_t     play_state;     /* current playback state */
+            audio_stream_source_t  stream_source;  /* current stream source */
+            audio_channel_select_t channel_select; /* currently selected channel */
+            int                    bypass_mode;    /* pass on audio data to */
+            audio_mixer_t          mixer_state;    /* current mixer state */
+    } audio_status_t;                              /* separate decoder hardware */
+
+
+    typedef
+    struct audio_karaoke {  /* if Vocal1 or Vocal2 are non-zero, they get mixed  */
+            int vocal1;    /* into left and right t at 70% each */
+            int vocal2;    /* if both, Vocal1 and Vocal2 are non-zero, Vocal1 gets*/
+            int melody;    /* mixed into the left channel and */
+                           /* Vocal2 into the right channel at 100% each. */
+                           /* if Melody is non-zero, the melody channel gets mixed*/
+    } audio_karaoke_t;     /* into left and right  */
+
+
+    typedef __u16 audio_attributes_t;
+    /*   bits: descr. */
+    /*   15-13 audio coding mode (0=ac3, 2=mpeg1, 3=mpeg2ext, 4=LPCM, 6=DTS, */
+    /*   12    multichannel extension */
+    /*   11-10 audio type (0=not spec, 1=language included) */
+    /*    9- 8 audio application mode (0=not spec, 1=karaoke, 2=surround) */
+    /*    7- 6 Quantization / DRC (mpeg audio: 1=DRC exists)(lpcm: 0=16bit,  */
+    /*    5- 4 Sample frequency fs (0=48kHz, 1=96kHz) */
+    /*    2- 0 number of audio channels (n+1 channels) */
+
+
+    /* for GET_CAPABILITIES and SET_FORMAT, the latter should only set one bit */
+    #define AUDIO_CAP_DTS    1
+    #define AUDIO_CAP_LPCM   2
+    #define AUDIO_CAP_MP1    4
+    #define AUDIO_CAP_MP2    8
+    #define AUDIO_CAP_MP3   16
+    #define AUDIO_CAP_AAC   32
+    #define AUDIO_CAP_OGG   64
+    #define AUDIO_CAP_SDDS 128
+    #define AUDIO_CAP_AC3  256
+
+    #define AUDIO_STOP                 _IO('o', 1)
+    #define AUDIO_PLAY                 _IO('o', 2)
+    #define AUDIO_PAUSE                _IO('o', 3)
+    #define AUDIO_CONTINUE             _IO('o', 4)
+    #define AUDIO_SELECT_SOURCE        _IO('o', 5)
+    #define AUDIO_SET_MUTE             _IO('o', 6)
+    #define AUDIO_SET_AV_SYNC          _IO('o', 7)
+    #define AUDIO_SET_BYPASS_MODE      _IO('o', 8)
+    #define AUDIO_CHANNEL_SELECT       _IO('o', 9)
+    #define AUDIO_GET_STATUS           _IOR('o', 10, audio_status_t)
+
+    #define AUDIO_GET_CAPABILITIES     _IOR('o', 11, unsigned int)
+    #define AUDIO_CLEAR_BUFFER         _IO('o',  12)
+    #define AUDIO_SET_ID               _IO('o', 13)
+    #define AUDIO_SET_MIXER            _IOW('o', 14, audio_mixer_t)
+    #define AUDIO_SET_STREAMTYPE       _IO('o', 15)
+    #define AUDIO_SET_EXT_ID           _IO('o', 16)
+    #define AUDIO_SET_ATTRIBUTES       _IOW('o', 17, audio_attributes_t)
+    #define AUDIO_SET_KARAOKE          _IOW('o', 18, audio_karaoke_t)
+
+    /**
+     * AUDIO_GET_PTS
+     *
+     * Read the 33 bit presentation time stamp as defined
+     * in ITU T-REC-H.222.0 / ISO/IEC 13818-1.
+     *
+     * The PTS should belong to the currently played
+     * frame if possible, but may also be a value close to it
+     * like the PTS of the last decoded frame or the last PTS
+     * extracted by the PES parser.
+     */
+    #define AUDIO_GET_PTS              _IOR('o', 19, __u64)
+    #define AUDIO_BILINGUAL_CHANNEL_SELECT _IO('o', 20)
+
+    #endif /* _DVBAUDIO_H_ */
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/ca.h.rst b/Documentation/linux_tv/ca.h.rst
new file mode 100644
index 000000000000..b69ce287aa8c
--- /dev/null
+++ b/Documentation/linux_tv/ca.h.rst
@@ -0,0 +1,108 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+file: ca.h
+==========
+
+.. code-block:: c
+
+    /*
+     * ca.h
+     *
+     * Copyright (C) 2000 Ralph  Metzler <ralph@convergence.de>
+     *                  & Marcus Metzler <marcus@convergence.de>
+     *                    for convergence integrated media GmbH
+     *
+     * This program is free software; you can redistribute it and/or
+     * modify it under the terms of the GNU General Lesser Public License
+     * as published by the Free Software Foundation; either version 2.1
+     * of the License, or (at your option) any later version.
+     *
+     * This program is distributed in the hope that it will be useful,
+     * but WITHOUT ANY WARRANTY; without even the implied warranty of
+     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+     * GNU General Public License for more details.
+     *
+     * You should have received a copy of the GNU Lesser General Public License
+     * along with this program; if not, write to the Free Software
+     * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+     *
+     */
+
+    #ifndef _DVBCA_H_
+    #define _DVBCA_H_
+
+    /* slot interface types and info */
+
+    typedef struct ca_slot_info {
+            int num;               /* slot number */
+
+            int type;              /* CA interface this slot supports */
+    #define CA_CI            1     /* CI high level interface */
+    #define CA_CI_LINK       2     /* CI link layer level interface */
+    #define CA_CI_PHYS       4     /* CI physical layer level interface */
+    #define CA_DESCR         8     /* built-in descrambler */
+    #define CA_SC          128     /* simple smart card interface */
+
+            unsigned int flags;
+    #define CA_CI_MODULE_PRESENT 1 /* module (or card) inserted */
+    #define CA_CI_MODULE_READY   2
+    } ca_slot_info_t;
+
+
+    /* descrambler types and info */
+
+    typedef struct ca_descr_info {
+            unsigned int num;          /* number of available descramblers (keys) */
+            unsigned int type;         /* type of supported scrambling system */
+    #define CA_ECD           1
+    #define CA_NDS           2
+    #define CA_DSS           4
+    } ca_descr_info_t;
+
+    typedef struct ca_caps {
+            unsigned int slot_num;     /* total number of CA card and module slots */
+            unsigned int slot_type;    /* OR of all supported types */
+            unsigned int descr_num;    /* total number of descrambler slots (keys) */
+            unsigned int descr_type;   /* OR of all supported types */
+    } ca_caps_t;
+
+    /* a message to/from a CI-CAM */
+    typedef struct ca_msg {
+            unsigned int index;
+            unsigned int type;
+            unsigned int length;
+            unsigned char msg[256];
+    } ca_msg_t;
+
+    typedef struct ca_descr {
+            unsigned int index;
+            unsigned int parity;    /* 0 == even, 1 == odd */
+            unsigned char cw[8];
+    } ca_descr_t;
+
+    typedef struct ca_pid {
+            unsigned int pid;
+            int index;              /* -1 == disable*/
+    } ca_pid_t;
+
+    #define CA_RESET          _IO('o', 128)
+    #define CA_GET_CAP        _IOR('o', 129, ca_caps_t)
+    #define CA_GET_SLOT_INFO  _IOR('o', 130, ca_slot_info_t)
+    #define CA_GET_DESCR_INFO _IOR('o', 131, ca_descr_info_t)
+    #define CA_GET_MSG        _IOR('o', 132, ca_msg_t)
+    #define CA_SEND_MSG       _IOW('o', 133, ca_msg_t)
+    #define CA_SET_DESCR      _IOW('o', 134, ca_descr_t)
+    #define CA_SET_PID        _IOW('o', 135, ca_pid_t)
+
+    #endif
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/conf.py b/Documentation/linux_tv/conf.py
new file mode 100644
index 000000000000..8013c921256b
--- /dev/null
+++ b/Documentation/linux_tv/conf.py
@@ -0,0 +1,221 @@
+# -*- coding: utf-8; mode: python -*-
+#
+# This is the project specific sphinx-build configuration, which is loaded from
+# the base configuration file (``../conf.py``). About config values consult:
+#
+# * http://www.sphinx-doc.org/en/stable/config.html
+#
+# While setting values here, please take care to not overwrite common needed
+# configurations. This means, do not *overwrite* composite values (e.g. the
+# list- or dictionary-value of "latex_elements" resp. "extensions") by
+# thoughtless assignments. Manipulate composite values always by *update*
+# (dict-values) or extend (list-values). Nevertheless, if you know what you are
+# doing, you are free to *overwrite* values to your needs.
+#
+# useful preset names:
+#
+# * BASE_FOLDER: the folder where the top conf.py is located
+# * main_name:   the basename of this project-folder
+
+# Set parser's default kernel-doc mode ``reST|kernel-doc``.
+kernel_doc_mode = "kernel-doc"
+
+# ------------------------------------------------------------------------------
+# General configuration
+# ------------------------------------------------------------------------------
+
+project   = u'LINUX MEDIA INFRASTRUCTURE API'
+copyright = u'2009-2015 : LinuxTV Developers'
+author    = u'The LinuxTV Developers'
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The short X.Y version.
+#version   = 'v4.7'
+# The full version, including alpha/beta/rc tags.
+#release   = 'v4.7-rc2'
+
+# extlinks["man"] = ('http://manpages.ubuntu.com/cgi-bin/search.py?q=%s', ' ')
+
+# intersphinx_mapping['kernel-doc'] = ('http://return42.github.io/sphkerneldoc/books/kernel-doc-HOWTO/', None)
+
+extensions.extend([
+    # 'sphinx.ext.pngmath'
+    #, 'sphinx.ext.mathjax'
+])
+
+# ------------------------------------------------------------------------------
+# Options for HTML output
+# ------------------------------------------------------------------------------
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+#html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+#html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+#html_logo = pathjoin(BASE_FOLDER, "_tex", "logo.png")
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+#html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path.extend([])
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = main_name
+
+# ------------------------------------------------------------------------------
+# Options for rst2pdf output
+# ------------------------------------------------------------------------------
+
+# Grouping the document tree into PDF files. List of tuples
+# (source start file, target name, title, author, options).
+#
+# The options element is a dictionary that lets you override
+# this config per-document.
+# For example,
+# ('index', u'MyProject', u'My Project', u'Author Name',
+#  dict(pdf_compressed = True))
+# would mean that specific document would be compressed
+# regardless of the global pdf_compressed setting.
+#
+# further:  http://rst2pdf.ralsina.me/handbook.html#sphinx
+
+# FIXME: at this time, the rst2pdf fails with a bug
+#pdf_documents = [
+#    (master_doc, main_name, project, author)
+#    , ]
+
+# If false, no index is generated.
+pdf_use_index = False
+
+# How many levels deep should the table of contents be?
+pdf_toc_depth = 3
+
+# Add section number to section references
+pdf_use_numbered_links = False
+
+# Background images fitting mode
+pdf_fit_background_mode = 'scale'
+
+
+# ------------------------------------------------------------------------------
+# Options for manual page output
+# ------------------------------------------------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+# man_pages = [
+#     (master_doc, 'kernel-doc', u'Kernel-Doc',
+#      [author], 1)
+# ]
+
+# If true, show URL addresses after external links.
+#man_show_urls = False
+
+# ------------------------------------------------------------------------------
+# Options for Texinfo output
+# ------------------------------------------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+# texinfo_documents = [
+#     (master_doc, 'Kernel-Doc', u'Kernel-Doc Documentation',
+#      author, 'Kernel-Doc', 'One line description of project.',
+#      'Miscellaneous'),
+# ]
+
+# Documents to append as an appendix to all manuals.
+#texinfo_appendices = []
+
+# If false, no module index is generated.
+#texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+#texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+#texinfo_no_detailmenu = False
+
+# ------------------------------------------------------------------------------
+# Options for Epub output
+# ------------------------------------------------------------------------------
+
+# Bibliographic Dublin Core info.
+# epub_title = project
+# epub_author = author
+# epub_publisher = author
+# epub_copyright = copyright
+
+# The basename for the epub file. It defaults to the project name.
+#epub_basename = project
+
+# The HTML theme for the epub output. Since the default themes are not
+# optimized for small screen space, using the same theme for HTML and epub
+# output is usually not wise. This defaults to 'epub', a theme designed to save
+# visual space.
+#epub_theme = 'epub'
+
+# The language of the text. It defaults to the language option
+# or 'en' if the language is not set.
+#epub_language = ''
+
+# The scheme of the identifier. Typical schemes are ISBN or URL.
+#epub_scheme = ''
+
+# The unique identifier of the text. This can be a ISBN number
+# or the project homepage.
+#epub_identifier = ''
+
+# A unique identification for the text.
+#epub_uid = ''
+
+# A tuple containing the cover image and cover page html template filenames.
+#epub_cover = ()
+
+# A sequence of (type, uri, title) tuples for the guide element of content.opf.
+#epub_guide = ()
+
+# HTML files that should be inserted before the pages created by sphinx.
+# The format is a list of tuples containing the path and title.
+#epub_pre_files.extend([])
+
+# HTML files that should be inserted after the pages created by sphinx.
+# The format is a list of tuples containing the path and title.
+#epub_post_files.extend([])
+
+# A list of files that should not be packed into the epub file.
+epub_exclude_files.extend([])
+
+# The depth of the table of contents in toc.ncx.
+#epub_tocdepth = 3
+
+# Allow duplicate toc entries.
+#epub_tocdup = True
+
+# Choose between 'default' and 'includehidden'.
+#epub_tocscope = 'default'
+
+# Fix unsupported image types using the Pillow.
+#epub_fix_images = False
+
+# Scale large images.
+#epub_max_image_width = 0
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+#epub_show_urls = 'inline'
+
+# If false, no index is generated.
+#epub_use_index = True
+
diff --git a/Documentation/linux_tv/dmx.h.rst b/Documentation/linux_tv/dmx.h.rst
new file mode 100644
index 000000000000..9ced07899e57
--- /dev/null
+++ b/Documentation/linux_tv/dmx.h.rst
@@ -0,0 +1,173 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+file: dmx.h
+===========
+
+.. code-block:: c
+
+    /*
+     * dmx.h
+     *
+     * Copyright (C) 2000 Marcus Metzler <marcus@convergence.de>
+     *                  & Ralph  Metzler <ralph@convergence.de>
+     *                    for convergence integrated media GmbH
+     *
+     * This program is free software; you can redistribute it and/or
+     * modify it under the terms of the GNU Lesser General Public License
+     * as published by the Free Software Foundation; either version 2.1
+     * of the License, or (at your option) any later version.
+     *
+     * This program is distributed in the hope that it will be useful,
+     * but WITHOUT ANY WARRANTY; without even the implied warranty of
+     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+     * GNU General Public License for more details.
+     *
+     * You should have received a copy of the GNU Lesser General Public License
+     * along with this program; if not, write to the Free Software
+     * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+     *
+     */
+
+    #ifndef _UAPI_DVBDMX_H_
+    #define _UAPI_DVBDMX_H_
+
+    #include <linux/types.h>
+    #ifndef __KERNEL__
+    #include <time.h>
+    #endif
+
+
+    #define DMX_FILTER_SIZE 16
+
+    enum dmx_output
+    {
+            DMX_OUT_DECODER, /* Streaming directly to decoder. */
+            DMX_OUT_TAP,     /* Output going to a memory buffer */
+                             /* (to be retrieved via the read command).*/
+            DMX_OUT_TS_TAP,  /* Output multiplexed into a new TS  */
+                             /* (to be retrieved by reading from the */
+                             /* logical DVR device).                 */
+            DMX_OUT_TSDEMUX_TAP /* Like TS_TAP but retrieved from the DMX device */
+    };
+
+    typedef enum dmx_output dmx_output_t;
+
+    typedef enum dmx_input
+    {
+            DMX_IN_FRONTEND, /* Input from a front-end device.  */
+            DMX_IN_DVR       /* Input from the logical DVR device.  */
+    } dmx_input_t;
+
+
+    typedef enum dmx_ts_pes
+    {
+            DMX_PES_AUDIO0,
+            DMX_PES_VIDEO0,
+            DMX_PES_TELETEXT0,
+            DMX_PES_SUBTITLE0,
+            DMX_PES_PCR0,
+
+            DMX_PES_AUDIO1,
+            DMX_PES_VIDEO1,
+            DMX_PES_TELETEXT1,
+            DMX_PES_SUBTITLE1,
+            DMX_PES_PCR1,
+
+            DMX_PES_AUDIO2,
+            DMX_PES_VIDEO2,
+            DMX_PES_TELETEXT2,
+            DMX_PES_SUBTITLE2,
+            DMX_PES_PCR2,
+
+            DMX_PES_AUDIO3,
+            DMX_PES_VIDEO3,
+            DMX_PES_TELETEXT3,
+            DMX_PES_SUBTITLE3,
+            DMX_PES_PCR3,
+
+            DMX_PES_OTHER
+    } dmx_pes_type_t;
+
+    #define DMX_PES_AUDIO    DMX_PES_AUDIO0
+    #define DMX_PES_VIDEO    DMX_PES_VIDEO0
+    #define DMX_PES_TELETEXT DMX_PES_TELETEXT0
+    #define DMX_PES_SUBTITLE DMX_PES_SUBTITLE0
+    #define DMX_PES_PCR      DMX_PES_PCR0
+
+
+    typedef struct dmx_filter
+    {
+            __u8  filter[DMX_FILTER_SIZE];
+            __u8  mask[DMX_FILTER_SIZE];
+            __u8  mode[DMX_FILTER_SIZE];
+    } dmx_filter_t;
+
+
+    struct dmx_sct_filter_params
+    {
+            __u16          pid;
+            dmx_filter_t   filter;
+            __u32          timeout;
+            __u32          flags;
+    #define DMX_CHECK_CRC       1
+    #define DMX_ONESHOT         2
+    #define DMX_IMMEDIATE_START 4
+    #define DMX_KERNEL_CLIENT   0x8000
+    };
+
+
+    struct dmx_pes_filter_params
+    {
+            __u16          pid;
+            dmx_input_t    input;
+            dmx_output_t   output;
+            dmx_pes_type_t pes_type;
+            __u32          flags;
+    };
+
+    typedef struct dmx_caps {
+            __u32 caps;
+            int num_decoders;
+    } dmx_caps_t;
+
+    typedef enum dmx_source {
+            DMX_SOURCE_FRONT0 = 0,
+            DMX_SOURCE_FRONT1,
+            DMX_SOURCE_FRONT2,
+            DMX_SOURCE_FRONT3,
+            DMX_SOURCE_DVR0   = 16,
+            DMX_SOURCE_DVR1,
+            DMX_SOURCE_DVR2,
+            DMX_SOURCE_DVR3
+    } dmx_source_t;
+
+    struct dmx_stc {
+            unsigned int num;       /* input : which STC? 0..N */
+            unsigned int base;      /* output: divisor for stc to get 90 kHz clock */
+            __u64 stc;              /* output: stc in 'base'*90 kHz units */
+    };
+
+    #define DMX_START                _IO('o', 41)
+    #define DMX_STOP                 _IO('o', 42)
+    #define DMX_SET_FILTER           _IOW('o', 43, struct dmx_sct_filter_params)
+    #define DMX_SET_PES_FILTER       _IOW('o', 44, struct dmx_pes_filter_params)
+    #define DMX_SET_BUFFER_SIZE      _IO('o', 45)
+    #define DMX_GET_PES_PIDS         _IOR('o', 47, __u16[5])
+    #define DMX_GET_CAPS             _IOR('o', 48, dmx_caps_t)
+    #define DMX_SET_SOURCE           _IOW('o', 49, dmx_source_t)
+    #define DMX_GET_STC              _IOWR('o', 50, struct dmx_stc)
+    #define DMX_ADD_PID              _IOW('o', 51, __u16)
+    #define DMX_REMOVE_PID           _IOW('o', 52, __u16)
+
+    #endif /* _UAPI_DVBDMX_H_ */
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/frontend.h.rst b/Documentation/linux_tv/frontend.h.rst
new file mode 100644
index 000000000000..1b65b2037778
--- /dev/null
+++ b/Documentation/linux_tv/frontend.h.rst
@@ -0,0 +1,620 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+file: frontend.h
+================
+
+.. code-block:: c
+
+    /*
+     * frontend.h
+     *
+     * Copyright (C) 2000 Marcus Metzler <marcus@convergence.de>
+     *                  Ralph  Metzler <ralph@convergence.de>
+     *                  Holger Waechtler <holger@convergence.de>
+     *                  Andre Draszik <ad@convergence.de>
+     *                  for convergence integrated media GmbH
+     *
+     * This program is free software; you can redistribute it and/or
+     * modify it under the terms of the GNU Lesser General Public License
+     * as published by the Free Software Foundation; either version 2.1
+     * of the License, or (at your option) any later version.
+     *
+     * This program is distributed in the hope that it will be useful,
+     * but WITHOUT ANY WARRANTY; without even the implied warranty of
+     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+     * GNU General Public License for more details.
+     *
+     * You should have received a copy of the GNU Lesser General Public License
+     * along with this program; if not, write to the Free Software
+     * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+     *
+     */
+
+    #ifndef _DVBFRONTEND_H_
+    #define _DVBFRONTEND_H_
+
+    #include <linux/types.h>
+
+    enum fe_type {
+            FE_QPSK,
+            FE_QAM,
+            FE_OFDM,
+            FE_ATSC
+    };
+
+    enum fe_caps {
+            FE_IS_STUPID                    = 0,
+            FE_CAN_INVERSION_AUTO           = 0x1,
+            FE_CAN_FEC_1_2                  = 0x2,
+            FE_CAN_FEC_2_3                  = 0x4,
+            FE_CAN_FEC_3_4                  = 0x8,
+            FE_CAN_FEC_4_5                  = 0x10,
+            FE_CAN_FEC_5_6                  = 0x20,
+            FE_CAN_FEC_6_7                  = 0x40,
+            FE_CAN_FEC_7_8                  = 0x80,
+            FE_CAN_FEC_8_9                  = 0x100,
+            FE_CAN_FEC_AUTO                 = 0x200,
+            FE_CAN_QPSK                     = 0x400,
+            FE_CAN_QAM_16                   = 0x800,
+            FE_CAN_QAM_32                   = 0x1000,
+            FE_CAN_QAM_64                   = 0x2000,
+            FE_CAN_QAM_128                  = 0x4000,
+            FE_CAN_QAM_256                  = 0x8000,
+            FE_CAN_QAM_AUTO                 = 0x10000,
+            FE_CAN_TRANSMISSION_MODE_AUTO   = 0x20000,
+            FE_CAN_BANDWIDTH_AUTO           = 0x40000,
+            FE_CAN_GUARD_INTERVAL_AUTO      = 0x80000,
+            FE_CAN_HIERARCHY_AUTO           = 0x100000,
+            FE_CAN_8VSB                     = 0x200000,
+            FE_CAN_16VSB                    = 0x400000,
+            FE_HAS_EXTENDED_CAPS            = 0x800000,   /* We need more bitspace for newer APIs, indicate this. */
+            FE_CAN_MULTISTREAM              = 0x4000000,  /* frontend supports multistream filtering */
+            FE_CAN_TURBO_FEC                = 0x8000000,  /* frontend supports "turbo fec modulation" */
+            FE_CAN_2G_MODULATION            = 0x10000000, /* frontend supports "2nd generation modulation" (DVB-S2) */
+            FE_NEEDS_BENDING                = 0x20000000, /* not supported anymore, don't use (frontend requires frequency bending) */
+            FE_CAN_RECOVER                  = 0x40000000, /* frontend can recover from a cable unplug automatically */
+            FE_CAN_MUTE_TS                  = 0x80000000  /* frontend can stop spurious TS data output */
+    };
+
+    struct dvb_frontend_info {
+            char       name[128];
+            enum fe_type type;      /* DEPRECATED. Use DTV_ENUM_DELSYS instead */
+            __u32      frequency_min;
+            __u32      frequency_max;
+            __u32      frequency_stepsize;
+            __u32      frequency_tolerance;
+            __u32      symbol_rate_min;
+            __u32      symbol_rate_max;
+            __u32      symbol_rate_tolerance;       /* ppm */
+            __u32      notifier_delay;              /* DEPRECATED */
+            enum fe_caps caps;
+    };
+
+
+    /**
+     *  Check out the DiSEqC bus spec available on http://www.eutelsat.org/ for
+     *  the meaning of this struct...
+     */
+    struct dvb_diseqc_master_cmd {
+            __u8 msg [6];   /*  { framing, address, command, data [3] } */
+            __u8 msg_len;   /*  valid values are 3...6  */
+    };
+
+    struct dvb_diseqc_slave_reply {
+            __u8 msg [4];   /*  { framing, data [3] } */
+            __u8 msg_len;   /*  valid values are 0...4, 0 means no msg  */
+            int  timeout;   /*  return from ioctl after timeout ms with */
+    };                      /*  errorcode when no message was received  */
+
+    enum fe_sec_voltage {
+            SEC_VOLTAGE_13,
+            SEC_VOLTAGE_18,
+            SEC_VOLTAGE_OFF
+    };
+
+    enum fe_sec_tone_mode {
+            SEC_TONE_ON,
+            SEC_TONE_OFF
+    };
+
+    enum fe_sec_mini_cmd {
+            SEC_MINI_A,
+            SEC_MINI_B
+    };
+
+    /**
+     * enum fe_status - enumerates the possible frontend status
+     * @FE_HAS_SIGNAL:      found something above the noise level
+     * @FE_HAS_CARRIER:     found a DVB signal
+     * @FE_HAS_VITERBI:     FEC is stable
+     * @FE_HAS_SYNC:        found sync bytes
+     * @FE_HAS_LOCK:        everything's working
+     * @FE_TIMEDOUT:        no lock within the last ~2 seconds
+     * @FE_REINIT:          frontend was reinitialized, application is recommended
+     *                      to reset DiSEqC, tone and parameters
+     */
+    enum fe_status {
+            FE_HAS_SIGNAL           = 0x01,
+            FE_HAS_CARRIER          = 0x02,
+            FE_HAS_VITERBI          = 0x04,
+            FE_HAS_SYNC             = 0x08,
+            FE_HAS_LOCK             = 0x10,
+            FE_TIMEDOUT             = 0x20,
+            FE_REINIT               = 0x40,
+    };
+
+    enum fe_spectral_inversion {
+            INVERSION_OFF,
+            INVERSION_ON,
+            INVERSION_AUTO
+    };
+
+    enum fe_code_rate {
+            FEC_NONE = 0,
+            FEC_1_2,
+            FEC_2_3,
+            FEC_3_4,
+            FEC_4_5,
+            FEC_5_6,
+            FEC_6_7,
+            FEC_7_8,
+            FEC_8_9,
+            FEC_AUTO,
+            FEC_3_5,
+            FEC_9_10,
+            FEC_2_5,
+    };
+
+    enum fe_modulation {
+            QPSK,
+            QAM_16,
+            QAM_32,
+            QAM_64,
+            QAM_128,
+            QAM_256,
+            QAM_AUTO,
+            VSB_8,
+            VSB_16,
+            PSK_8,
+            APSK_16,
+            APSK_32,
+            DQPSK,
+            QAM_4_NR,
+    };
+
+    enum fe_transmit_mode {
+            TRANSMISSION_MODE_2K,
+            TRANSMISSION_MODE_8K,
+            TRANSMISSION_MODE_AUTO,
+            TRANSMISSION_MODE_4K,
+            TRANSMISSION_MODE_1K,
+            TRANSMISSION_MODE_16K,
+            TRANSMISSION_MODE_32K,
+            TRANSMISSION_MODE_C1,
+            TRANSMISSION_MODE_C3780,
+    };
+
+    enum fe_guard_interval {
+            GUARD_INTERVAL_1_32,
+            GUARD_INTERVAL_1_16,
+            GUARD_INTERVAL_1_8,
+            GUARD_INTERVAL_1_4,
+            GUARD_INTERVAL_AUTO,
+            GUARD_INTERVAL_1_128,
+            GUARD_INTERVAL_19_128,
+            GUARD_INTERVAL_19_256,
+            GUARD_INTERVAL_PN420,
+            GUARD_INTERVAL_PN595,
+            GUARD_INTERVAL_PN945,
+    };
+
+    enum fe_hierarchy {
+            HIERARCHY_NONE,
+            HIERARCHY_1,
+            HIERARCHY_2,
+            HIERARCHY_4,
+            HIERARCHY_AUTO
+    };
+
+    enum fe_interleaving {
+            INTERLEAVING_NONE,
+            INTERLEAVING_AUTO,
+            INTERLEAVING_240,
+            INTERLEAVING_720,
+    };
+
+    /* S2API Commands */
+    #define DTV_UNDEFINED           0
+    #define DTV_TUNE                1
+    #define DTV_CLEAR               2
+    #define DTV_FREQUENCY           3
+    #define DTV_MODULATION          4
+    #define DTV_BANDWIDTH_HZ        5
+    #define DTV_INVERSION           6
+    #define DTV_DISEQC_MASTER       7
+    #define DTV_SYMBOL_RATE         8
+    #define DTV_INNER_FEC           9
+    #define DTV_VOLTAGE             10
+    #define DTV_TONE                11
+    #define DTV_PILOT               12
+    #define DTV_ROLLOFF             13
+    #define DTV_DISEQC_SLAVE_REPLY  14
+
+    /* Basic enumeration set for querying unlimited capabilities */
+    #define DTV_FE_CAPABILITY_COUNT 15
+    #define DTV_FE_CAPABILITY       16
+    #define DTV_DELIVERY_SYSTEM     17
+
+    /* ISDB-T and ISDB-Tsb */
+    #define DTV_ISDBT_PARTIAL_RECEPTION     18
+    #define DTV_ISDBT_SOUND_BROADCASTING    19
+
+    #define DTV_ISDBT_SB_SUBCHANNEL_ID      20
+    #define DTV_ISDBT_SB_SEGMENT_IDX        21
+    #define DTV_ISDBT_SB_SEGMENT_COUNT      22
+
+    #define DTV_ISDBT_LAYERA_FEC                    23
+    #define DTV_ISDBT_LAYERA_MODULATION             24
+    #define DTV_ISDBT_LAYERA_SEGMENT_COUNT          25
+    #define DTV_ISDBT_LAYERA_TIME_INTERLEAVING      26
+
+    #define DTV_ISDBT_LAYERB_FEC                    27
+    #define DTV_ISDBT_LAYERB_MODULATION             28
+    #define DTV_ISDBT_LAYERB_SEGMENT_COUNT          29
+    #define DTV_ISDBT_LAYERB_TIME_INTERLEAVING      30
+
+    #define DTV_ISDBT_LAYERC_FEC                    31
+    #define DTV_ISDBT_LAYERC_MODULATION             32
+    #define DTV_ISDBT_LAYERC_SEGMENT_COUNT          33
+    #define DTV_ISDBT_LAYERC_TIME_INTERLEAVING      34
+
+    #define DTV_API_VERSION         35
+
+    #define DTV_CODE_RATE_HP        36
+    #define DTV_CODE_RATE_LP        37
+    #define DTV_GUARD_INTERVAL      38
+    #define DTV_TRANSMISSION_MODE   39
+    #define DTV_HIERARCHY           40
+
+    #define DTV_ISDBT_LAYER_ENABLED 41
+
+    #define DTV_STREAM_ID           42
+    #define DTV_ISDBS_TS_ID_LEGACY  DTV_STREAM_ID
+    #define DTV_DVBT2_PLP_ID_LEGACY 43
+
+    #define DTV_ENUM_DELSYS         44
+
+    /* ATSC-MH */
+    #define DTV_ATSCMH_FIC_VER              45
+    #define DTV_ATSCMH_PARADE_ID            46
+    #define DTV_ATSCMH_NOG                  47
+    #define DTV_ATSCMH_TNOG                 48
+    #define DTV_ATSCMH_SGN                  49
+    #define DTV_ATSCMH_PRC                  50
+    #define DTV_ATSCMH_RS_FRAME_MODE        51
+    #define DTV_ATSCMH_RS_FRAME_ENSEMBLE    52
+    #define DTV_ATSCMH_RS_CODE_MODE_PRI     53
+    #define DTV_ATSCMH_RS_CODE_MODE_SEC     54
+    #define DTV_ATSCMH_SCCC_BLOCK_MODE      55
+    #define DTV_ATSCMH_SCCC_CODE_MODE_A     56
+    #define DTV_ATSCMH_SCCC_CODE_MODE_B     57
+    #define DTV_ATSCMH_SCCC_CODE_MODE_C     58
+    #define DTV_ATSCMH_SCCC_CODE_MODE_D     59
+
+    #define DTV_INTERLEAVING                        60
+    #define DTV_LNA                                 61
+
+    /* Quality parameters */
+    #define DTV_STAT_SIGNAL_STRENGTH        62
+    #define DTV_STAT_CNR                    63
+    #define DTV_STAT_PRE_ERROR_BIT_COUNT    64
+    #define DTV_STAT_PRE_TOTAL_BIT_COUNT    65
+    #define DTV_STAT_POST_ERROR_BIT_COUNT   66
+    #define DTV_STAT_POST_TOTAL_BIT_COUNT   67
+    #define DTV_STAT_ERROR_BLOCK_COUNT      68
+    #define DTV_STAT_TOTAL_BLOCK_COUNT      69
+
+    #define DTV_MAX_COMMAND         DTV_STAT_TOTAL_BLOCK_COUNT
+
+    enum fe_pilot {
+            PILOT_ON,
+            PILOT_OFF,
+            PILOT_AUTO,
+    };
+
+    enum fe_rolloff {
+            ROLLOFF_35, /* Implied value in DVB-S, default for DVB-S2 */
+            ROLLOFF_20,
+            ROLLOFF_25,
+            ROLLOFF_AUTO,
+    };
+
+    enum fe_delivery_system {
+            SYS_UNDEFINED,
+            SYS_DVBC_ANNEX_A,
+            SYS_DVBC_ANNEX_B,
+            SYS_DVBT,
+            SYS_DSS,
+            SYS_DVBS,
+            SYS_DVBS2,
+            SYS_DVBH,
+            SYS_ISDBT,
+            SYS_ISDBS,
+            SYS_ISDBC,
+            SYS_ATSC,
+            SYS_ATSCMH,
+            SYS_DTMB,
+            SYS_CMMB,
+            SYS_DAB,
+            SYS_DVBT2,
+            SYS_TURBO,
+            SYS_DVBC_ANNEX_C,
+    };
+
+    /* backward compatibility */
+    #define SYS_DVBC_ANNEX_AC       SYS_DVBC_ANNEX_A
+    #define SYS_DMBTH SYS_DTMB /* DMB-TH is legacy name, use DTMB instead */
+
+    /* ATSC-MH */
+
+    enum atscmh_sccc_block_mode {
+            ATSCMH_SCCC_BLK_SEP      = 0,
+            ATSCMH_SCCC_BLK_COMB     = 1,
+            ATSCMH_SCCC_BLK_RES      = 2,
+    };
+
+    enum atscmh_sccc_code_mode {
+            ATSCMH_SCCC_CODE_HLF     = 0,
+            ATSCMH_SCCC_CODE_QTR     = 1,
+            ATSCMH_SCCC_CODE_RES     = 2,
+    };
+
+    enum atscmh_rs_frame_ensemble {
+            ATSCMH_RSFRAME_ENS_PRI   = 0,
+            ATSCMH_RSFRAME_ENS_SEC   = 1,
+    };
+
+    enum atscmh_rs_frame_mode {
+            ATSCMH_RSFRAME_PRI_ONLY  = 0,
+            ATSCMH_RSFRAME_PRI_SEC   = 1,
+            ATSCMH_RSFRAME_RES       = 2,
+    };
+
+    enum atscmh_rs_code_mode {
+            ATSCMH_RSCODE_211_187    = 0,
+            ATSCMH_RSCODE_223_187    = 1,
+            ATSCMH_RSCODE_235_187    = 2,
+            ATSCMH_RSCODE_RES        = 3,
+    };
+
+    #define NO_STREAM_ID_FILTER     (~0U)
+    #define LNA_AUTO                (~0U)
+
+    struct dtv_cmds_h {
+            char    *name;          /* A display name for debugging purposes */
+
+            __u32   cmd;            /* A unique ID */
+
+            /* Flags */
+            __u32   set:1;          /* Either a set or get property */
+            __u32   buffer:1;       /* Does this property use the buffer? */
+            __u32   reserved:30;    /* Align */
+    };
+
+    /**
+     * Scale types for the quality parameters.
+     * @FE_SCALE_NOT_AVAILABLE: That QoS measure is not available. That
+     *                          could indicate a temporary or a permanent
+     *                          condition.
+     * @FE_SCALE_DECIBEL: The scale is measured in 0.001 dB steps, typically
+     *                used on signal measures.
+     * @FE_SCALE_RELATIVE: The scale is a relative percentual measure,
+     *                      ranging from 0 (0%) to 0xffff (100%).
+     * @FE_SCALE_COUNTER: The scale counts the occurrence of an event, like
+     *                      bit error, block error, lapsed time.
+     */
+    enum fecap_scale_params {
+            FE_SCALE_NOT_AVAILABLE = 0,
+            FE_SCALE_DECIBEL,
+            FE_SCALE_RELATIVE,
+            FE_SCALE_COUNTER
+    };
+
+    /**
+     * struct dtv_stats - Used for reading a DTV status property
+     *
+     * @value:      value of the measure. Should range from 0 to 0xffff;
+     * @scale:      Filled with enum fecap_scale_params - the scale
+     *              in usage for that parameter
+     *
+     * For most delivery systems, this will return a single value for each
+     * parameter.
+     * It should be noticed, however, that new OFDM delivery systems like
+     * ISDB can use different modulation types for each group of carriers.
+     * On such standards, up to 8 groups of statistics can be provided, one
+     * for each carrier group (called "layer" on ISDB).
+     * In order to be consistent with other delivery systems, the first
+     * value refers to the entire set of carriers ("global").
+     * dtv_status:scale should use the value FE_SCALE_NOT_AVAILABLE when
+     * the value for the entire group of carriers or from one specific layer
+     * is not provided by the hardware.
+     * st.len should be filled with the latest filled status + 1.
+     *
+     * In other words, for ISDB, those values should be filled like:
+     *      u.st.stat.svalue[0] = global statistics;
+     *      u.st.stat.scale[0] = FE_SCALE_DECIBEL;
+     *      u.st.stat.value[1] = layer A statistics;
+     *      u.st.stat.scale[1] = FE_SCALE_NOT_AVAILABLE (if not available);
+     *      u.st.stat.svalue[2] = layer B statistics;
+     *      u.st.stat.scale[2] = FE_SCALE_DECIBEL;
+     *      u.st.stat.svalue[3] = layer C statistics;
+     *      u.st.stat.scale[3] = FE_SCALE_DECIBEL;
+     *      u.st.len = 4;
+     */
+    struct dtv_stats {
+            __u8 scale;     /* enum fecap_scale_params type */
+            union {
+                    __u64 uvalue;   /* for counters and relative scales */
+                    __s64 svalue;   /* for 0.001 dB measures */
+            };
+    } __attribute__ ((packed));
+
+
+    #define MAX_DTV_STATS   4
+
+    struct dtv_fe_stats {
+            __u8 len;
+            struct dtv_stats stat[MAX_DTV_STATS];
+    } __attribute__ ((packed));
+
+    struct dtv_property {
+            __u32 cmd;
+            __u32 reserved[3];
+            union {
+                    __u32 data;
+                    struct dtv_fe_stats st;
+                    struct {
+                            __u8 data[32];
+                            __u32 len;
+                            __u32 reserved1[3];
+                            void *reserved2;
+                    } buffer;
+            } u;
+            int result;
+    } __attribute__ ((packed));
+
+    /* num of properties cannot exceed DTV_IOCTL_MAX_MSGS per ioctl */
+    #define DTV_IOCTL_MAX_MSGS 64
+
+    struct dtv_properties {
+            __u32 num;
+            struct dtv_property *props;
+    };
+
+    #if defined(__DVB_CORE__) || !defined (__KERNEL__)
+
+    /*
+     * DEPRECATED: The DVBv3 ioctls, structs and enums should not be used on
+     * newer programs, as it doesn't support the second generation of digital
+     * TV standards, nor supports newer delivery systems.
+     */
+
+    enum fe_bandwidth {
+            BANDWIDTH_8_MHZ,
+            BANDWIDTH_7_MHZ,
+            BANDWIDTH_6_MHZ,
+            BANDWIDTH_AUTO,
+            BANDWIDTH_5_MHZ,
+            BANDWIDTH_10_MHZ,
+            BANDWIDTH_1_712_MHZ,
+    };
+
+    /* This is needed for legacy userspace support */
+    typedef enum fe_sec_voltage fe_sec_voltage_t;
+    typedef enum fe_caps fe_caps_t;
+    typedef enum fe_type fe_type_t;
+    typedef enum fe_sec_tone_mode fe_sec_tone_mode_t;
+    typedef enum fe_sec_mini_cmd fe_sec_mini_cmd_t;
+    typedef enum fe_status fe_status_t;
+    typedef enum fe_spectral_inversion fe_spectral_inversion_t;
+    typedef enum fe_code_rate fe_code_rate_t;
+    typedef enum fe_modulation fe_modulation_t;
+    typedef enum fe_transmit_mode fe_transmit_mode_t;
+    typedef enum fe_bandwidth fe_bandwidth_t;
+    typedef enum fe_guard_interval fe_guard_interval_t;
+    typedef enum fe_hierarchy fe_hierarchy_t;
+    typedef enum fe_pilot fe_pilot_t;
+    typedef enum fe_rolloff fe_rolloff_t;
+    typedef enum fe_delivery_system fe_delivery_system_t;
+
+    struct dvb_qpsk_parameters {
+            __u32           symbol_rate;  /* symbol rate in Symbols per second */
+            fe_code_rate_t  fec_inner;    /* forward error correction (see above) */
+    };
+
+    struct dvb_qam_parameters {
+            __u32           symbol_rate; /* symbol rate in Symbols per second */
+            fe_code_rate_t  fec_inner;   /* forward error correction (see above) */
+            fe_modulation_t modulation;  /* modulation type (see above) */
+    };
+
+    struct dvb_vsb_parameters {
+            fe_modulation_t modulation;  /* modulation type (see above) */
+    };
+
+    struct dvb_ofdm_parameters {
+            fe_bandwidth_t      bandwidth;
+            fe_code_rate_t      code_rate_HP;  /* high priority stream code rate */
+            fe_code_rate_t      code_rate_LP;  /* low priority stream code rate */
+            fe_modulation_t     constellation; /* modulation type (see above) */
+            fe_transmit_mode_t  transmission_mode;
+            fe_guard_interval_t guard_interval;
+            fe_hierarchy_t      hierarchy_information;
+    };
+
+    struct dvb_frontend_parameters {
+            __u32 frequency;     /* (absolute) frequency in Hz for DVB-C/DVB-T/ATSC */
+                                 /* intermediate frequency in kHz for DVB-S */
+            fe_spectral_inversion_t inversion;
+            union {
+                    struct dvb_qpsk_parameters qpsk;        /* DVB-S */
+                    struct dvb_qam_parameters  qam;         /* DVB-C */
+                    struct dvb_ofdm_parameters ofdm;        /* DVB-T */
+                    struct dvb_vsb_parameters vsb;          /* ATSC */
+            } u;
+    };
+
+    struct dvb_frontend_event {
+            fe_status_t status;
+            struct dvb_frontend_parameters parameters;
+    };
+    #endif
+
+    #define FE_SET_PROPERTY            _IOW('o', 82, struct dtv_properties)
+    #define FE_GET_PROPERTY            _IOR('o', 83, struct dtv_properties)
+
+    /**
+     * When set, this flag will disable any zigzagging or other "normal" tuning
+     * behaviour. Additionally, there will be no automatic monitoring of the lock
+     * status, and hence no frontend events will be generated. If a frontend device
+     * is closed, this flag will be automatically turned off when the device is
+     * reopened read-write.
+     */
+    #define FE_TUNE_MODE_ONESHOT 0x01
+
+    #define FE_GET_INFO                _IOR('o', 61, struct dvb_frontend_info)
+
+    #define FE_DISEQC_RESET_OVERLOAD   _IO('o', 62)
+    #define FE_DISEQC_SEND_MASTER_CMD  _IOW('o', 63, struct dvb_diseqc_master_cmd)
+    #define FE_DISEQC_RECV_SLAVE_REPLY _IOR('o', 64, struct dvb_diseqc_slave_reply)
+    #define FE_DISEQC_SEND_BURST       _IO('o', 65)  /* fe_sec_mini_cmd_t */
+
+    #define FE_SET_TONE                _IO('o', 66)  /* fe_sec_tone_mode_t */
+    #define FE_SET_VOLTAGE             _IO('o', 67)  /* fe_sec_voltage_t */
+    #define FE_ENABLE_HIGH_LNB_VOLTAGE _IO('o', 68)  /* int */
+
+    #define FE_READ_STATUS             _IOR('o', 69, fe_status_t)
+    #define FE_READ_BER                _IOR('o', 70, __u32)
+    #define FE_READ_SIGNAL_STRENGTH    _IOR('o', 71, __u16)
+    #define FE_READ_SNR                _IOR('o', 72, __u16)
+    #define FE_READ_UNCORRECTED_BLOCKS _IOR('o', 73, __u32)
+
+    #define FE_SET_FRONTEND            _IOW('o', 76, struct dvb_frontend_parameters)
+    #define FE_GET_FRONTEND            _IOR('o', 77, struct dvb_frontend_parameters)
+    #define FE_SET_FRONTEND_TUNE_MODE  _IO('o', 81) /* unsigned int */
+    #define FE_GET_EVENT               _IOR('o', 78, struct dvb_frontend_event)
+
+    #define FE_DISHNETWORK_SEND_LEGACY_CMD _IO('o', 80) /* unsigned int */
+
+    #endif /*_DVBFRONTEND_H_*/
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/index.rst b/Documentation/linux_tv/index.rst
new file mode 100644
index 000000000000..42b3d4520942
--- /dev/null
+++ b/Documentation/linux_tv/index.rst
@@ -0,0 +1,100 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+##############################
+LINUX MEDIA INFRASTRUCTURE API
+##############################
+
+**Copyright** 2009-2015 : LinuxTV Developers
+
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.1 or
+any later version published by the Free Software Foundation. A copy of
+the license is included in the chapter entitled "GNU Free Documentation
+License"
+
+
+============
+Introduction
+============
+
+This document covers the Linux Kernel to Userspace API's used by video
+and radio streaming devices, including video cameras, analog and digital
+TV receiver cards, AM/FM receiver cards, streaming capture and output
+devices, codec devices and remote controllers.
+
+A typical media device hardware is shown at
+:ref:`typical_media_device`.
+
+
+.. _typical_media_device:
+
+.. figure::  media_api_files/typical_media_device.*
+    :alt:    typical_media_device.svg
+    :align:  center
+
+    Typical Media Device
+
+    Typical Media Device Block Diagram
+
+
+
+The media infrastructure API was designed to control such devices. It is
+divided into four parts.
+
+The first part covers radio, video capture and output, cameras, analog
+TV devices and codecs.
+
+The second part covers the API used for digital TV and Internet
+reception via one of the several digital tv standards. While it is
+called as DVB API, in fact it covers several different video standards
+including DVB-T/T2, DVB-S/S2, DVB-C, ATSC, ISDB-T, ISDB-S,etc. The
+complete list of supported standards can be found at
+:ref:`fe-delivery-system-t`.
+
+The third part covers the Remote Controller API.
+
+The fourth part covers the Media Controller API.
+
+It should also be noted that a media device may also have audio
+components, like mixers, PCM capture, PCM playback, etc, which are
+controlled via ALSA API.
+
+For additional information and for the latest development code, see:
+`https://linuxtv.org <https://linuxtv.org>`__.
+
+For discussing improvements, reporting troubles, sending new drivers,
+etc, please mail to:
+`Linux Media Mailing List (LMML). <http://vger.kernel.org/vger-lists.html#linux-media>`__.
+
+
+.. toctree::
+    :maxdepth: 1
+
+    media/v4l/v4l2
+    media/dvb/dvbapi
+    media/v4l/remote_controllers
+    media/v4l/media-controller
+    media/v4l/gen-errors
+    media/v4l/fdl-appendix
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
+
+
+.. only:: html
+
+  Retrieval
+  =========
+
+  * :ref:`genindex`
+
+.. todolist::
+
diff --git a/Documentation/linux_tv/media/dvb/FE_DISHNETWORK_SEND_LEGACY_CMD.rst b/Documentation/linux_tv/media/dvb/FE_DISHNETWORK_SEND_LEGACY_CMD.rst
new file mode 100644
index 000000000000..f4effaab9a1a
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/FE_DISHNETWORK_SEND_LEGACY_CMD.rst
@@ -0,0 +1,55 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _FE_DISHNETWORK_SEND_LEGACY_CMD:
+
+******************************
+FE_DISHNETWORK_SEND_LEGACY_CMD
+******************************
+
+DESCRIPTION
+
+WARNING: This is a very obscure legacy command, used only at stv0299
+driver. Should not be used on newer drivers.
+
+It provides a non-standard method for selecting Diseqc voltage on the
+frontend, for Dish Network legacy switches.
+
+As support for this ioctl were added in 2004, this means that such
+dishes were already legacy in 2004.
+
+SYNOPSIS
+
+int ioctl(int fd, int request =
+:ref:`FE_DISHNETWORK_SEND_LEGACY_CMD <FE_DISHNETWORK_SEND_LEGACY_CMD>`,
+unsigned long cmd);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  unsigned long cmd
+
+       -  sends the specified raw cmd to the dish via DISEqC.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/FE_GET_EVENT.rst b/Documentation/linux_tv/media/dvb/FE_GET_EVENT.rst
new file mode 100644
index 000000000000..75eab893c184
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/FE_GET_EVENT.rst
@@ -0,0 +1,89 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _FE_GET_EVENT:
+
+************
+FE_GET_EVENT
+************
+
+DESCRIPTION
+
+This ioctl call returns a frontend event if available. If an event is
+not available, the behavior depends on whether the device is in blocking
+or non-blocking mode. In the latter case, the call fails immediately
+with errno set to EWOULDBLOCK. In the former case, the call blocks until
+an event becomes available.
+
+SYNOPSIS
+
+int ioctl(int fd, int request = QPSK_GET_EVENT, struct
+dvb_frontend_event *ev);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals :ref:`FE_GET_EVENT <FE_GET_EVENT>` for this command.
+
+    -  .. row 3
+
+       -  struct dvb_frontend_event *ev
+
+       -  Points to the location where the event,
+
+    -  .. row 4
+
+       -  
+       -  if any, is to be stored.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  EWOULDBLOCK
+
+       -  There is no event pending, and the device is in non-blocking mode.
+
+    -  .. row 2
+
+       -  EOVERFLOW
+
+       -  Overflow in event queue - one or more events were lost.
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/FE_GET_FRONTEND.rst b/Documentation/linux_tv/media/dvb/FE_GET_FRONTEND.rst
new file mode 100644
index 000000000000..30c85cf0423c
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/FE_GET_FRONTEND.rst
@@ -0,0 +1,77 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _FE_GET_FRONTEND:
+
+***************
+FE_GET_FRONTEND
+***************
+
+DESCRIPTION
+
+This ioctl call queries the currently effective frontend parameters. For
+this command, read-only access to the device is sufficient.
+
+SYNOPSIS
+
+int ioctl(int fd, int request =
+:ref:`FE_GET_FRONTEND <FE_GET_FRONTEND>`, struct
+dvb_frontend_parameters *p);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals :ref:`FE_SET_FRONTEND <FE_SET_FRONTEND>` for this
+          command.
+
+    -  .. row 3
+
+       -  struct dvb_frontend_parameters *p
+
+       -  Points to parameters for tuning operation.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  EINVAL
+
+       -  Maximum supported symbol rate reached.
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/FE_READ_BER.rst b/Documentation/linux_tv/media/dvb/FE_READ_BER.rst
new file mode 100644
index 000000000000..e21451886dc2
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/FE_READ_BER.rst
@@ -0,0 +1,61 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _FE_READ_BER:
+
+***********
+FE_READ_BER
+***********
+
+DESCRIPTION
+
+This ioctl call returns the bit error rate for the signal currently
+received/demodulated by the front-end. For this command, read-only
+access to the device is sufficient.
+
+SYNOPSIS
+
+int ioctl(int fd, int request = :ref:`FE_READ_BER <FE_READ_BER>`,
+uint32_t *ber);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals :ref:`FE_READ_BER <FE_READ_BER>` for this command.
+
+    -  .. row 3
+
+       -  uint32_t *ber
+
+       -  The bit error rate is stored into *ber.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/FE_READ_SIGNAL_STRENGTH.rst b/Documentation/linux_tv/media/dvb/FE_READ_SIGNAL_STRENGTH.rst
new file mode 100644
index 000000000000..3e34bea21b6c
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/FE_READ_SIGNAL_STRENGTH.rst
@@ -0,0 +1,64 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _FE_READ_SIGNAL_STRENGTH:
+
+***********************
+FE_READ_SIGNAL_STRENGTH
+***********************
+
+DESCRIPTION
+
+This ioctl call returns the signal strength value for the signal
+currently received by the front-end. For this command, read-only access
+to the device is sufficient.
+
+SYNOPSIS
+
+int ioctl( int fd, int request =
+:ref:`FE_READ_SIGNAL_STRENGTH <FE_READ_SIGNAL_STRENGTH>`,
+uint16_t *strength);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals
+          :ref:`FE_READ_SIGNAL_STRENGTH <FE_READ_SIGNAL_STRENGTH>`
+          for this command.
+
+    -  .. row 3
+
+       -  uint16_t *strength
+
+       -  The signal strength value is stored into *strength.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/FE_READ_SNR.rst b/Documentation/linux_tv/media/dvb/FE_READ_SNR.rst
new file mode 100644
index 000000000000..b8a639706e9e
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/FE_READ_SNR.rst
@@ -0,0 +1,61 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _FE_READ_SNR:
+
+***********
+FE_READ_SNR
+***********
+
+DESCRIPTION
+
+This ioctl call returns the signal-to-noise ratio for the signal
+currently received by the front-end. For this command, read-only access
+to the device is sufficient.
+
+SYNOPSIS
+
+int ioctl(int fd, int request = :ref:`FE_READ_SNR <FE_READ_SNR>`,
+uint16_t *snr);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals :ref:`FE_READ_SNR <FE_READ_SNR>` for this command.
+
+    -  .. row 3
+
+       -  uint16_t *snr
+
+       -  The signal-to-noise ratio is stored into *snr.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/FE_READ_UNCORRECTED_BLOCKS.rst b/Documentation/linux_tv/media/dvb/FE_READ_UNCORRECTED_BLOCKS.rst
new file mode 100644
index 000000000000..261eb20ddadf
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/FE_READ_UNCORRECTED_BLOCKS.rst
@@ -0,0 +1,66 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _FE_READ_UNCORRECTED_BLOCKS:
+
+**************************
+FE_READ_UNCORRECTED_BLOCKS
+**************************
+
+DESCRIPTION
+
+This ioctl call returns the number of uncorrected blocks detected by the
+device driver during its lifetime. For meaningful measurements, the
+increment in block count during a specific time interval should be
+calculated. For this command, read-only access to the device is
+sufficient.
+
+SYNOPSIS
+
+int ioctl( int fd, int request =
+:ref:`FE_READ_UNCORRECTED_BLOCKS <FE_READ_UNCORRECTED_BLOCKS>`,
+uint32_t *ublocks);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals
+          :ref:`FE_READ_UNCORRECTED_BLOCKS <FE_READ_UNCORRECTED_BLOCKS>`
+          for this command.
+
+    -  .. row 3
+
+       -  uint32_t *ublocks
+
+       -  The total number of uncorrected blocks seen by the driver so far.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/FE_SET_FRONTEND.rst b/Documentation/linux_tv/media/dvb/FE_SET_FRONTEND.rst
new file mode 100644
index 000000000000..885f9e3ceb59
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/FE_SET_FRONTEND.rst
@@ -0,0 +1,84 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _FE_SET_FRONTEND:
+
+***************
+FE_SET_FRONTEND
+***************
+
+DESCRIPTION
+
+This ioctl call starts a tuning operation using specified parameters.
+The result of this call will be successful if the parameters were valid
+and the tuning could be initiated. The result of the tuning operation in
+itself, however, will arrive asynchronously as an event (see
+documentation for :ref:`FE_GET_EVENT <FE_GET_EVENT>` and
+FrontendEvent.) If a new :ref:`FE_SET_FRONTEND <FE_SET_FRONTEND>`
+operation is initiated before the previous one was completed, the
+previous operation will be aborted in favor of the new one. This command
+requires read/write access to the device.
+
+SYNOPSIS
+
+int ioctl(int fd, int request =
+:ref:`FE_SET_FRONTEND <FE_SET_FRONTEND>`, struct
+dvb_frontend_parameters *p);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals :ref:`FE_SET_FRONTEND <FE_SET_FRONTEND>` for this
+          command.
+
+    -  .. row 3
+
+       -  struct dvb_frontend_parameters *p
+
+       -  Points to parameters for tuning operation.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  EINVAL
+
+       -  Maximum supported symbol rate reached.
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/audio.rst b/Documentation/linux_tv/media/dvb/audio.rst
new file mode 100644
index 000000000000..d6b6f9edf3b3
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/audio.rst
@@ -0,0 +1,37 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _dvb_audio:
+
+################
+DVB Audio Device
+################
+The DVB audio device controls the MPEG2 audio decoder of the DVB
+hardware. It can be accessed through ``/dev/dvb/adapter?/audio?``. Data
+types and and ioctl definitions can be accessed by including
+``linux/dvb/audio.h`` in your application.
+
+Please note that some DVB cards don’t have their own MPEG decoder, which
+results in the omission of the audio and video device.
+
+These ioctls were also used by V4L2 to control MPEG decoders implemented
+in V4L2. The use of these ioctls for that purpose has been made obsolete
+and proper V4L2 ioctls or controls have been created to replace that
+functionality.
+
+
+.. toctree::
+    :maxdepth: 1
+
+    audio_data_types
+    audio_function_calls
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/audio_data_types.rst b/Documentation/linux_tv/media/dvb/audio_data_types.rst
new file mode 100644
index 000000000000..b3f5aa0ac6e4
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/audio_data_types.rst
@@ -0,0 +1,187 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _audio_data_types:
+
+****************
+Audio Data Types
+****************
+
+This section describes the structures, data types and defines used when
+talking to the audio device.
+
+
+.. _audio-stream-source-t:
+
+audio_stream_source_t
+=====================
+
+The audio stream source is set through the AUDIO_SELECT_SOURCE call
+and can take the following values, depending on whether we are replaying
+from an internal (demux) or external (user write) source.
+
+
+.. code-block:: c
+
+    typedef enum {
+        AUDIO_SOURCE_DEMUX,
+        AUDIO_SOURCE_MEMORY
+    } audio_stream_source_t;
+
+AUDIO_SOURCE_DEMUX selects the demultiplexer (fed either by the
+frontend or the DVR device) as the source of the video stream. If
+AUDIO_SOURCE_MEMORY is selected the stream comes from the application
+through the ``write()`` system call.
+
+
+.. _audio-play-state-t:
+
+audio_play_state_t
+==================
+
+The following values can be returned by the AUDIO_GET_STATUS call
+representing the state of audio playback.
+
+
+.. code-block:: c
+
+    typedef enum {
+        AUDIO_STOPPED,
+        AUDIO_PLAYING,
+        AUDIO_PAUSED
+    } audio_play_state_t;
+
+
+.. _audio-channel-select-t:
+
+audio_channel_select_t
+======================
+
+The audio channel selected via AUDIO_CHANNEL_SELECT is determined by
+the following values.
+
+
+.. code-block:: c
+
+    typedef enum {
+        AUDIO_STEREO,
+        AUDIO_MONO_LEFT,
+        AUDIO_MONO_RIGHT,
+        AUDIO_MONO,
+        AUDIO_STEREO_SWAPPED
+    } audio_channel_select_t;
+
+
+.. _audio-status:
+
+struct audio_status
+===================
+
+The AUDIO_GET_STATUS call returns the following structure informing
+about various states of the playback operation.
+
+
+.. code-block:: c
+
+    typedef struct audio_status {
+        boolean AV_sync_state;
+        boolean mute_state;
+        audio_play_state_t play_state;
+        audio_stream_source_t stream_source;
+        audio_channel_select_t channel_select;
+        boolean bypass_mode;
+        audio_mixer_t mixer_state;
+    } audio_status_t;
+
+
+.. _audio-mixer:
+
+struct audio_mixer
+==================
+
+The following structure is used by the AUDIO_SET_MIXER call to set the
+audio volume.
+
+
+.. code-block:: c
+
+    typedef struct audio_mixer {
+        unsigned int volume_left;
+        unsigned int volume_right;
+    } audio_mixer_t;
+
+
+.. _audio_encodings:
+
+audio encodings
+===============
+
+A call to AUDIO_GET_CAPABILITIES returns an unsigned integer with the
+following bits set according to the hardwares capabilities.
+
+
+.. code-block:: c
+
+     #define AUDIO_CAP_DTS    1
+     #define AUDIO_CAP_LPCM   2
+     #define AUDIO_CAP_MP1    4
+     #define AUDIO_CAP_MP2    8
+     #define AUDIO_CAP_MP3   16
+     #define AUDIO_CAP_AAC   32
+     #define AUDIO_CAP_OGG   64
+     #define AUDIO_CAP_SDDS 128
+     #define AUDIO_CAP_AC3  256
+
+
+.. _audio-karaoke:
+
+struct audio_karaoke
+====================
+
+The ioctl AUDIO_SET_KARAOKE uses the following format:
+
+
+.. code-block:: c
+
+    typedef
+    struct audio_karaoke {
+        int vocal1;
+        int vocal2;
+        int melody;
+    } audio_karaoke_t;
+
+If Vocal1 or Vocal2 are non-zero, they get mixed into left and right t
+at 70% each. If both, Vocal1 and Vocal2 are non-zero, Vocal1 gets mixed
+into the left channel and Vocal2 into the right channel at 100% each. Ff
+Melody is non-zero, the melody channel gets mixed into left and right.
+
+
+.. _audio-attributes-t:
+
+audio attributes
+================
+
+The following attributes can be set by a call to AUDIO_SET_ATTRIBUTES:
+
+
+.. code-block:: c
+
+     typedef uint16_t audio_attributes_t;
+     /*   bits: descr. */
+     /*   15-13 audio coding mode (0=ac3, 2=mpeg1, 3=mpeg2ext, 4=LPCM, 6=DTS, */
+     /*   12    multichannel extension */
+     /*   11-10 audio type (0=not spec, 1=language included) */
+     /*    9- 8 audio application mode (0=not spec, 1=karaoke, 2=surround) */
+     /*    7- 6 Quantization / DRC (mpeg audio: 1=DRC exists)(lpcm: 0=16bit,  */
+     /*    5- 4 Sample frequency fs (0=48kHz, 1=96kHz) */
+     /*    2- 0 number of audio channels (n+1 channels) */
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/audio_function_calls.rst b/Documentation/linux_tv/media/dvb/audio_function_calls.rst
new file mode 100644
index 000000000000..41a5757ffd72
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/audio_function_calls.rst
@@ -0,0 +1,1308 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _audio_function_calls:
+
+********************
+Audio Function Calls
+********************
+
+
+.. _audio_fopen:
+
+open()
+======
+
+DESCRIPTION
+
+This system call opens a named audio device (e.g.
+/dev/dvb/adapter0/audio0) for subsequent use. When an open() call has
+succeeded, the device will be ready for use. The significance of
+blocking or non-blocking mode is described in the documentation for
+functions where there is a difference. It does not affect the semantics
+of the open() call itself. A device opened in blocking mode can later be
+put into non-blocking mode (and vice versa) using the F_SETFL command
+of the fcntl system call. This is a standard system call, documented in
+the Linux manual page for fcntl. Only one user can open the Audio Device
+in O_RDWR mode. All other attempts to open the device in this mode will
+fail, and an error code will be returned. If the Audio Device is opened
+in O_RDONLY mode, the only ioctl call that can be used is
+AUDIO_GET_STATUS. All other call will return with an error code.
+
+SYNOPSIS
+
+int open(const char *deviceName, int flags);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  const char *deviceName
+
+       -  Name of specific audio device.
+
+    -  .. row 2
+
+       -  int flags
+
+       -  A bit-wise OR of the following flags:
+
+    -  .. row 3
+
+       -  
+       -  O_RDONLY read-only access
+
+    -  .. row 4
+
+       -  
+       -  O_RDWR read/write access
+
+    -  .. row 5
+
+       -  
+       -  O_NONBLOCK open in non-blocking mode
+
+    -  .. row 6
+
+       -  
+       -  (blocking mode is the default)
+
+
+RETURN VALUE
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ENODEV
+
+       -  Device driver not loaded/available.
+
+    -  .. row 2
+
+       -  EBUSY
+
+       -  Device or resource busy.
+
+    -  .. row 3
+
+       -  EINVAL
+
+       -  Invalid argument.
+
+
+
+.. _audio_fclose:
+
+close()
+=======
+
+DESCRIPTION
+
+This system call closes a previously opened audio device.
+
+SYNOPSIS
+
+int close(int fd);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+
+RETURN VALUE
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  EBADF
+
+       -  fd is not a valid open file descriptor.
+
+
+
+.. _audio_fwrite:
+
+write()
+=======
+
+DESCRIPTION
+
+This system call can only be used if AUDIO_SOURCE_MEMORY is selected
+in the ioctl call AUDIO_SELECT_SOURCE. The data provided shall be in
+PES format. If O_NONBLOCK is not specified the function will block
+until buffer space is available. The amount of data to be transferred is
+implied by count.
+
+SYNOPSIS
+
+size_t write(int fd, const void *buf, size_t count);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  void *buf
+
+       -  Pointer to the buffer containing the PES data.
+
+    -  .. row 3
+
+       -  size_t count
+
+       -  Size of buf.
+
+
+RETURN VALUE
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  EPERM
+
+       -  Mode AUDIO_SOURCE_MEMORY not selected.
+
+    -  .. row 2
+
+       -  ENOMEM
+
+       -  Attempted to write more data than the internal buffer can hold.
+
+    -  .. row 3
+
+       -  EBADF
+
+       -  fd is not a valid open file descriptor.
+
+
+
+.. _AUDIO_STOP:
+
+AUDIO_STOP
+==========
+
+DESCRIPTION
+
+This ioctl call asks the Audio Device to stop playing the current
+stream.
+
+SYNOPSIS
+
+int ioctl(int fd, int request = AUDIO_STOP);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals AUDIO_STOP for this command.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _AUDIO_PLAY:
+
+AUDIO_PLAY
+==========
+
+DESCRIPTION
+
+This ioctl call asks the Audio Device to start playing an audio stream
+from the selected source.
+
+SYNOPSIS
+
+int ioctl(int fd, int request = AUDIO_PLAY);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals AUDIO_PLAY for this command.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _AUDIO_PAUSE:
+
+AUDIO_PAUSE
+===========
+
+DESCRIPTION
+
+This ioctl call suspends the audio stream being played. Decoding and
+playing are paused. It is then possible to restart again decoding and
+playing process of the audio stream using AUDIO_CONTINUE command.
+
+SYNOPSIS
+
+int ioctl(int fd, int request = AUDIO_PAUSE);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals AUDIO_PAUSE for this command.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _AUDIO_CONTINUE:
+
+AUDIO_CONTINUE
+==============
+
+DESCRIPTION
+
+This ioctl restarts the decoding and playing process previously paused
+with AUDIO_PAUSE command.
+
+SYNOPSIS
+
+int ioctl(int fd, int request = AUDIO_CONTINUE);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals AUDIO_CONTINUE for this command.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _AUDIO_SELECT_SOURCE:
+
+AUDIO_SELECT_SOURCE
+===================
+
+DESCRIPTION
+
+This ioctl call informs the audio device which source shall be used for
+the input data. The possible sources are demux or memory. If
+AUDIO_SOURCE_MEMORY is selected, the data is fed to the Audio Device
+through the write command.
+
+SYNOPSIS
+
+int ioctl(int fd, int request = AUDIO_SELECT_SOURCE,
+audio_stream_source_t source);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals AUDIO_SELECT_SOURCE for this command.
+
+    -  .. row 3
+
+       -  audio_stream_source_t source
+
+       -  Indicates the source that shall be used for the Audio stream.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _AUDIO_SET_MUTE:
+
+AUDIO_SET_MUTE
+==============
+
+DESCRIPTION
+
+This ioctl is for DVB devices only. To control a V4L2 decoder use the
+V4L2 :ref:`VIDIOC_DECODER_CMD <vidioc-decoder-cmd>` with the
+``V4L2_DEC_CMD_START_MUTE_AUDIO`` flag instead.
+
+This ioctl call asks the audio device to mute the stream that is
+currently being played.
+
+SYNOPSIS
+
+int ioctl(int fd, int request = AUDIO_SET_MUTE, boolean state);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals AUDIO_SET_MUTE for this command.
+
+    -  .. row 3
+
+       -  boolean state
+
+       -  Indicates if audio device shall mute or not.
+
+    -  .. row 4
+
+       -  
+       -  TRUE Audio Mute
+
+    -  .. row 5
+
+       -  
+       -  FALSE Audio Un-mute
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _AUDIO_SET_AV_SYNC:
+
+AUDIO_SET_AV_SYNC
+=================
+
+DESCRIPTION
+
+This ioctl call asks the Audio Device to turn ON or OFF A/V
+synchronization.
+
+SYNOPSIS
+
+int ioctl(int fd, int request = AUDIO_SET_AV_SYNC, boolean state);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals AUDIO_AV_SYNC for this command.
+
+    -  .. row 3
+
+       -  boolean state
+
+       -  Tells the DVB subsystem if A/V synchronization shall be ON or OFF.
+
+    -  .. row 4
+
+       -  
+       -  TRUE AV-sync ON
+
+    -  .. row 5
+
+       -  
+       -  FALSE AV-sync OFF
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _AUDIO_SET_BYPASS_MODE:
+
+AUDIO_SET_BYPASS_MODE
+=====================
+
+DESCRIPTION
+
+This ioctl call asks the Audio Device to bypass the Audio decoder and
+forward the stream without decoding. This mode shall be used if streams
+that can’t be handled by the DVB system shall be decoded. Dolby
+DigitalTM streams are automatically forwarded by the DVB subsystem if
+the hardware can handle it.
+
+SYNOPSIS
+
+int ioctl(int fd, int request = AUDIO_SET_BYPASS_MODE, boolean mode);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals AUDIO_SET_BYPASS_MODE for this command.
+
+    -  .. row 3
+
+       -  boolean mode
+
+       -  Enables or disables the decoding of the current Audio stream in
+          the DVB subsystem.
+
+    -  .. row 4
+
+       -  
+       -  TRUE Bypass is disabled
+
+    -  .. row 5
+
+       -  
+       -  FALSE Bypass is enabled
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _AUDIO_CHANNEL_SELECT:
+
+AUDIO_CHANNEL_SELECT
+====================
+
+DESCRIPTION
+
+This ioctl is for DVB devices only. To control a V4L2 decoder use the
+V4L2 ``V4L2_CID_MPEG_AUDIO_DEC_PLAYBACK`` control instead.
+
+This ioctl call asks the Audio Device to select the requested channel if
+possible.
+
+SYNOPSIS
+
+int ioctl(int fd, int request = AUDIO_CHANNEL_SELECT,
+audio_channel_select_t);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals AUDIO_CHANNEL_SELECT for this command.
+
+    -  .. row 3
+
+       -  audio_channel_select_t ch
+
+       -  Select the output format of the audio (mono left/right, stereo).
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _AUDIO_BILINGUAL_CHANNEL_SELECT:
+
+AUDIO_BILINGUAL_CHANNEL_SELECT
+==============================
+
+DESCRIPTION
+
+This ioctl is obsolete. Do not use in new drivers. It has been replaced
+by the V4L2 ``V4L2_CID_MPEG_AUDIO_DEC_MULTILINGUAL_PLAYBACK`` control
+for MPEG decoders controlled through V4L2.
+
+This ioctl call asks the Audio Device to select the requested channel
+for bilingual streams if possible.
+
+SYNOPSIS
+
+int ioctl(int fd, int request = AUDIO_BILINGUAL_CHANNEL_SELECT,
+audio_channel_select_t);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals AUDIO_BILINGUAL_CHANNEL_SELECT for this command.
+
+    -  .. row 3
+
+       -  audio_channel_select_t ch
+
+       -  Select the output format of the audio (mono left/right, stereo).
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _AUDIO_GET_PTS:
+
+AUDIO_GET_PTS
+=============
+
+DESCRIPTION
+
+This ioctl is obsolete. Do not use in new drivers. If you need this
+functionality, then please contact the linux-media mailing list
+(`https://linuxtv.org/lists.php <https://linuxtv.org/lists.php>`__).
+
+This ioctl call asks the Audio Device to return the current PTS
+timestamp.
+
+SYNOPSIS
+
+int ioctl(int fd, int request = AUDIO_GET_PTS, __u64 *pts);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals AUDIO_GET_PTS for this command.
+
+    -  .. row 3
+
+       -  __u64 *pts
+
+       -  Returns the 33-bit timestamp as defined in ITU T-REC-H.222.0 /
+          ISO/IEC 13818-1.
+
+          The PTS should belong to the currently played frame if possible,
+          but may also be a value close to it like the PTS of the last
+          decoded frame or the last PTS extracted by the PES parser.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _AUDIO_GET_STATUS:
+
+AUDIO_GET_STATUS
+================
+
+DESCRIPTION
+
+This ioctl call asks the Audio Device to return the current state of the
+Audio Device.
+
+SYNOPSIS
+
+int ioctl(int fd, int request = AUDIO_GET_STATUS, struct audio_status
+*status);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals AUDIO_GET_STATUS for this command.
+
+    -  .. row 3
+
+       -  struct audio_status *status
+
+       -  Returns the current state of Audio Device.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _AUDIO_GET_CAPABILITIES:
+
+AUDIO_GET_CAPABILITIES
+======================
+
+DESCRIPTION
+
+This ioctl call asks the Audio Device to tell us about the decoding
+capabilities of the audio hardware.
+
+SYNOPSIS
+
+int ioctl(int fd, int request = AUDIO_GET_CAPABILITIES, unsigned int
+*cap);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals AUDIO_GET_CAPABILITIES for this command.
+
+    -  .. row 3
+
+       -  unsigned int *cap
+
+       -  Returns a bit array of supported sound formats.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _AUDIO_CLEAR_BUFFER:
+
+AUDIO_CLEAR_BUFFER
+==================
+
+DESCRIPTION
+
+This ioctl call asks the Audio Device to clear all software and hardware
+buffers of the audio decoder device.
+
+SYNOPSIS
+
+int ioctl(int fd, int request = AUDIO_CLEAR_BUFFER);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals AUDIO_CLEAR_BUFFER for this command.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _AUDIO_SET_ID:
+
+AUDIO_SET_ID
+============
+
+DESCRIPTION
+
+This ioctl selects which sub-stream is to be decoded if a program or
+system stream is sent to the video device. If no audio stream type is
+set the id has to be in [0xC0,0xDF] for MPEG sound, in [0x80,0x87] for
+AC3 and in [0xA0,0xA7] for LPCM. More specifications may follow for
+other stream types. If the stream type is set the id just specifies the
+substream id of the audio stream and only the first 5 bits are
+recognized.
+
+SYNOPSIS
+
+int ioctl(int fd, int request = AUDIO_SET_ID, int id);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals AUDIO_SET_ID for this command.
+
+    -  .. row 3
+
+       -  int id
+
+       -  audio sub-stream id
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _AUDIO_SET_MIXER:
+
+AUDIO_SET_MIXER
+===============
+
+DESCRIPTION
+
+This ioctl lets you adjust the mixer settings of the audio decoder.
+
+SYNOPSIS
+
+int ioctl(int fd, int request = AUDIO_SET_MIXER, audio_mixer_t
+*mix);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals AUDIO_SET_ID for this command.
+
+    -  .. row 3
+
+       -  audio_mixer_t *mix
+
+       -  mixer settings.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _AUDIO_SET_STREAMTYPE:
+
+AUDIO_SET_STREAMTYPE
+====================
+
+DESCRIPTION
+
+This ioctl tells the driver which kind of audio stream to expect. This
+is useful if the stream offers several audio sub-streams like LPCM and
+AC3.
+
+SYNOPSIS
+
+int ioctl(fd, int request = AUDIO_SET_STREAMTYPE, int type);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals AUDIO_SET_STREAMTYPE for this command.
+
+    -  .. row 3
+
+       -  int type
+
+       -  stream type
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  EINVAL
+
+       -  type is not a valid or supported stream type.
+
+
+
+.. _AUDIO_SET_EXT_ID:
+
+AUDIO_SET_EXT_ID
+================
+
+DESCRIPTION
+
+This ioctl can be used to set the extension id for MPEG streams in DVD
+playback. Only the first 3 bits are recognized.
+
+SYNOPSIS
+
+int ioctl(fd, int request = AUDIO_SET_EXT_ID, int id);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals AUDIO_SET_EXT_ID for this command.
+
+    -  .. row 3
+
+       -  int id
+
+       -  audio sub_stream_id
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  EINVAL
+
+       -  id is not a valid id.
+
+
+
+.. _AUDIO_SET_ATTRIBUTES:
+
+AUDIO_SET_ATTRIBUTES
+====================
+
+DESCRIPTION
+
+This ioctl is intended for DVD playback and allows you to set certain
+information about the audio stream.
+
+SYNOPSIS
+
+int ioctl(fd, int request = AUDIO_SET_ATTRIBUTES, audio_attributes_t
+attr );
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals AUDIO_SET_ATTRIBUTES for this command.
+
+    -  .. row 3
+
+       -  audio_attributes_t attr
+
+       -  audio attributes according to section ??
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  EINVAL
+
+       -  attr is not a valid or supported attribute setting.
+
+
+
+.. _AUDIO_SET_KARAOKE:
+
+AUDIO_SET_KARAOKE
+=================
+
+DESCRIPTION
+
+This ioctl allows one to set the mixer settings for a karaoke DVD.
+
+SYNOPSIS
+
+int ioctl(fd, int request = AUDIO_SET_KARAOKE, audio_karaoke_t
+*karaoke);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals AUDIO_SET_KARAOKE for this command.
+
+    -  .. row 3
+
+       -  audio_karaoke_t *karaoke
+
+       -  karaoke settings according to section ??.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  EINVAL
+
+       -  karaoke is not a valid or supported karaoke setting.
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/audio_h.rst b/Documentation/linux_tv/media/dvb/audio_h.rst
new file mode 100644
index 000000000000..09a73a54ab00
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/audio_h.rst
@@ -0,0 +1,24 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _audio_h:
+
+*********************
+DVB Audio Header File
+*********************
+
+
+.. toctree::
+    :maxdepth: 1
+
+    ../../audio.h
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/ca.rst b/Documentation/linux_tv/media/dvb/ca.rst
new file mode 100644
index 000000000000..bb01d93f0256
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/ca.rst
@@ -0,0 +1,29 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _dvb_ca:
+
+#############
+DVB CA Device
+#############
+The DVB CA device controls the conditional access hardware. It can be
+accessed through ``/dev/dvb/adapter?/ca?``. Data types and and ioctl
+definitions can be accessed by including ``linux/dvb/ca.h`` in your
+application.
+
+
+.. toctree::
+    :maxdepth: 1
+
+    ca_data_types
+    ca_function_calls
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/ca_data_types.rst b/Documentation/linux_tv/media/dvb/ca_data_types.rst
new file mode 100644
index 000000000000..bb0cdfa7c9a6
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/ca_data_types.rst
@@ -0,0 +1,121 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _ca_data_types:
+
+*************
+CA Data Types
+*************
+
+
+.. _ca-slot-info:
+
+ca_slot_info_t
+==============
+
+
+.. code-block:: c
+
+    typedef struct ca_slot_info {
+        int num;               /* slot number */
+
+        int type;              /* CA interface this slot supports */
+    #define CA_CI            1     /* CI high level interface */
+    #define CA_CI_LINK       2     /* CI link layer level interface */
+    #define CA_CI_PHYS       4     /* CI physical layer level interface */
+    #define CA_DESCR         8     /* built-in descrambler */
+    #define CA_SC          128     /* simple smart card interface */
+
+        unsigned int flags;
+    #define CA_CI_MODULE_PRESENT 1 /* module (or card) inserted */
+    #define CA_CI_MODULE_READY   2
+    } ca_slot_info_t;
+
+
+.. _ca-descr-info:
+
+ca_descr_info_t
+===============
+
+
+.. code-block:: c
+
+    typedef struct ca_descr_info {
+        unsigned int num;  /* number of available descramblers (keys) */
+        unsigned int type; /* type of supported scrambling system */
+    #define CA_ECD           1
+    #define CA_NDS           2
+    #define CA_DSS           4
+    } ca_descr_info_t;
+
+
+.. _ca-caps:
+
+ca_caps_t
+=========
+
+
+.. code-block:: c
+
+    typedef struct ca_caps {
+        unsigned int slot_num;  /* total number of CA card and module slots */
+        unsigned int slot_type; /* OR of all supported types */
+        unsigned int descr_num; /* total number of descrambler slots (keys) */
+        unsigned int descr_type;/* OR of all supported types */
+     } ca_cap_t;
+
+
+.. _ca-msg:
+
+ca_msg_t
+========
+
+
+.. code-block:: c
+
+    /* a message to/from a CI-CAM */
+    typedef struct ca_msg {
+        unsigned int index;
+        unsigned int type;
+        unsigned int length;
+        unsigned char msg[256];
+    } ca_msg_t;
+
+
+.. _ca-descr:
+
+ca_descr_t
+==========
+
+
+.. code-block:: c
+
+    typedef struct ca_descr {
+        unsigned int index;
+        unsigned int parity;
+        unsigned char cw[8];
+    } ca_descr_t;
+
+
+.. _ca-pid:
+
+ca-pid
+======
+
+
+.. code-block:: c
+
+    typedef struct ca_pid {
+        unsigned int pid;
+        int index;      /* -1 == disable*/
+    } ca_pid_t;
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/ca_function_calls.rst b/Documentation/linux_tv/media/dvb/ca_function_calls.rst
new file mode 100644
index 000000000000..9984b355f48f
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/ca_function_calls.rst
@@ -0,0 +1,541 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _ca_function_calls:
+
+*****************
+CA Function Calls
+*****************
+
+
+.. _ca_fopen:
+
+open()
+======
+
+DESCRIPTION
+
+This system call opens a named ca device (e.g. /dev/ost/ca) for
+subsequent use.
+
+When an open() call has succeeded, the device will be ready for use. The
+significance of blocking or non-blocking mode is described in the
+documentation for functions where there is a difference. It does not
+affect the semantics of the open() call itself. A device opened in
+blocking mode can later be put into non-blocking mode (and vice versa)
+using the F_SETFL command of the fcntl system call. This is a standard
+system call, documented in the Linux manual page for fcntl. Only one
+user can open the CA Device in O_RDWR mode. All other attempts to open
+the device in this mode will fail, and an error code will be returned.
+
+SYNOPSIS
+
+int open(const char *deviceName, int flags);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  const char *deviceName
+
+       -  Name of specific video device.
+
+    -  .. row 2
+
+       -  int flags
+
+       -  A bit-wise OR of the following flags:
+
+    -  .. row 3
+
+       -  
+       -  O_RDONLY read-only access
+
+    -  .. row 4
+
+       -  
+       -  O_RDWR read/write access
+
+    -  .. row 5
+
+       -  
+       -  O_NONBLOCK open in non-blocking mode
+
+    -  .. row 6
+
+       -  
+       -  (blocking mode is the default)
+
+
+RETURN VALUE
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ENODEV
+
+       -  Device driver not loaded/available.
+
+    -  .. row 2
+
+       -  EINTERNAL
+
+       -  Internal error.
+
+    -  .. row 3
+
+       -  EBUSY
+
+       -  Device or resource busy.
+
+    -  .. row 4
+
+       -  EINVAL
+
+       -  Invalid argument.
+
+
+
+.. _ca_fclose:
+
+close()
+=======
+
+DESCRIPTION
+
+This system call closes a previously opened audio device.
+
+SYNOPSIS
+
+int close(int fd);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+
+RETURN VALUE
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  EBADF
+
+       -  fd is not a valid open file descriptor.
+
+
+
+.. _CA_RESET:
+
+CA_RESET
+========
+
+DESCRIPTION
+
+This ioctl is undocumented. Documentation is welcome.
+
+SYNOPSIS
+
+int ioctl(fd, int request = CA_RESET);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals CA_RESET for this command.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _CA_GET_CAP:
+
+CA_GET_CAP
+==========
+
+DESCRIPTION
+
+This ioctl is undocumented. Documentation is welcome.
+
+SYNOPSIS
+
+int ioctl(fd, int request = CA_GET_CAP, ca_caps_t *);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals CA_GET_CAP for this command.
+
+    -  .. row 3
+
+       -  ca_caps_t *
+
+       -  Undocumented.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _CA_GET_SLOT_INFO:
+
+CA_GET_SLOT_INFO
+================
+
+DESCRIPTION
+
+This ioctl is undocumented. Documentation is welcome.
+
+SYNOPSIS
+
+int ioctl(fd, int request = CA_GET_SLOT_INFO, ca_slot_info_t *);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals CA_GET_SLOT_INFO for this command.
+
+    -  .. row 3
+
+       -  ca_slot_info_t *
+
+       -  Undocumented.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _CA_GET_DESCR_INFO:
+
+CA_GET_DESCR_INFO
+=================
+
+DESCRIPTION
+
+This ioctl is undocumented. Documentation is welcome.
+
+SYNOPSIS
+
+int ioctl(fd, int request = CA_GET_DESCR_INFO, ca_descr_info_t *);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals CA_GET_DESCR_INFO for this command.
+
+    -  .. row 3
+
+       -  ca_descr_info_t *
+
+       -  Undocumented.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _CA_GET_MSG:
+
+CA_GET_MSG
+==========
+
+DESCRIPTION
+
+This ioctl is undocumented. Documentation is welcome.
+
+SYNOPSIS
+
+int ioctl(fd, int request = CA_GET_MSG, ca_msg_t *);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals CA_GET_MSG for this command.
+
+    -  .. row 3
+
+       -  ca_msg_t *
+
+       -  Undocumented.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _CA_SEND_MSG:
+
+CA_SEND_MSG
+===========
+
+DESCRIPTION
+
+This ioctl is undocumented. Documentation is welcome.
+
+SYNOPSIS
+
+int ioctl(fd, int request = CA_SEND_MSG, ca_msg_t *);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals CA_SEND_MSG for this command.
+
+    -  .. row 3
+
+       -  ca_msg_t *
+
+       -  Undocumented.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _CA_SET_DESCR:
+
+CA_SET_DESCR
+============
+
+DESCRIPTION
+
+This ioctl is undocumented. Documentation is welcome.
+
+SYNOPSIS
+
+int ioctl(fd, int request = CA_SET_DESCR, ca_descr_t *);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals CA_SET_DESCR for this command.
+
+    -  .. row 3
+
+       -  ca_descr_t *
+
+       -  Undocumented.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _CA_SET_PID:
+
+CA_SET_PID
+==========
+
+DESCRIPTION
+
+This ioctl is undocumented. Documentation is welcome.
+
+SYNOPSIS
+
+int ioctl(fd, int request = CA_SET_PID, ca_pid_t *);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals CA_SET_PID for this command.
+
+    -  .. row 3
+
+       -  ca_pid_t *
+
+       -  Undocumented.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/ca_h.rst b/Documentation/linux_tv/media/dvb/ca_h.rst
new file mode 100644
index 000000000000..229bfbca045b
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/ca_h.rst
@@ -0,0 +1,24 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _ca_h:
+
+**********************************
+DVB Conditional Access Header File
+**********************************
+
+
+.. toctree::
+    :maxdepth: 1
+
+    ../../ca.h
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/demux.rst b/Documentation/linux_tv/media/dvb/demux.rst
new file mode 100644
index 000000000000..3bcee72c68fb
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/demux.rst
@@ -0,0 +1,29 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _dvb_demux:
+
+################
+DVB Demux Device
+################
+The DVB demux device controls the filters of the DVB hardware/software.
+It can be accessed through ``/dev/adapter?/demux?``. Data types and and
+ioctl definitions can be accessed by including ``linux/dvb/dmx.h`` in
+your application.
+
+
+.. toctree::
+    :maxdepth: 1
+
+    dmx_types
+    dmx_fcalls
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/dmx_fcalls.rst b/Documentation/linux_tv/media/dvb/dmx_fcalls.rst
new file mode 100644
index 000000000000..5982b57f0a3b
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/dmx_fcalls.rst
@@ -0,0 +1,1013 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _dmx_fcalls:
+
+********************
+Demux Function Calls
+********************
+
+
+.. _dmx_fopen:
+
+open()
+======
+
+DESCRIPTION
+
+This system call, used with a device name of /dev/dvb/adapter0/demux0,
+allocates a new filter and returns a handle which can be used for
+subsequent control of that filter. This call has to be made for each
+filter to be used, i.e. every returned file descriptor is a reference to
+a single filter. /dev/dvb/adapter0/dvr0 is a logical device to be used
+for retrieving Transport Streams for digital video recording. When
+reading from this device a transport stream containing the packets from
+all PES filters set in the corresponding demux device
+(/dev/dvb/adapter0/demux0) having the output set to DMX_OUT_TS_TAP. A
+recorded Transport Stream is replayed by writing to this device.
+
+The significance of blocking or non-blocking mode is described in the
+documentation for functions where there is a difference. It does not
+affect the semantics of the open() call itself. A device opened in
+blocking mode can later be put into non-blocking mode (and vice versa)
+using the F_SETFL command of the fcntl system call.
+
+SYNOPSIS
+
+int open(const char *deviceName, int flags);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  const char *deviceName
+
+       -  Name of demux device.
+
+    -  .. row 2
+
+       -  int flags
+
+       -  A bit-wise OR of the following flags:
+
+    -  .. row 3
+
+       -  
+       -  O_RDWR read/write access
+
+    -  .. row 4
+
+       -  
+       -  O_NONBLOCK open in non-blocking mode
+
+    -  .. row 5
+
+       -  
+       -  (blocking mode is the default)
+
+
+RETURN VALUE
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ENODEV
+
+       -  Device driver not loaded/available.
+
+    -  .. row 2
+
+       -  EINVAL
+
+       -  Invalid argument.
+
+    -  .. row 3
+
+       -  EMFILE
+
+       -  “Too many open files”, i.e. no more filters available.
+
+    -  .. row 4
+
+       -  ENOMEM
+
+       -  The driver failed to allocate enough memory.
+
+
+
+.. _dmx_fclose:
+
+close()
+=======
+
+DESCRIPTION
+
+This system call deactivates and deallocates a filter that was
+previously allocated via the open() call.
+
+SYNOPSIS
+
+int close(int fd);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+
+RETURN VALUE
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  EBADF
+
+       -  fd is not a valid open file descriptor.
+
+
+
+.. _dmx_fread:
+
+read()
+======
+
+DESCRIPTION
+
+This system call returns filtered data, which might be section or PES
+data. The filtered data is transferred from the driver’s internal
+circular buffer to buf. The maximum amount of data to be transferred is
+implied by count.
+
+SYNOPSIS
+
+size_t read(int fd, void *buf, size_t count);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  void *buf
+
+       -  Pointer to the buffer to be used for returned filtered data.
+
+    -  .. row 3
+
+       -  size_t count
+
+       -  Size of buf.
+
+
+RETURN VALUE
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  EWOULDBLOCK
+
+       -  No data to return and O_NONBLOCK was specified.
+
+    -  .. row 2
+
+       -  EBADF
+
+       -  fd is not a valid open file descriptor.
+
+    -  .. row 3
+
+       -  ECRC
+
+       -  Last section had a CRC error - no data returned. The buffer is
+          flushed.
+
+    -  .. row 4
+
+       -  EOVERFLOW
+
+       -  
+
+    -  .. row 5
+
+       -  
+       -  The filtered data was not read from the buffer in due time,
+          resulting in non-read data being lost. The buffer is flushed.
+
+    -  .. row 6
+
+       -  ETIMEDOUT
+
+       -  The section was not loaded within the stated timeout period. See
+          ioctl DMX_SET_FILTER for how to set a timeout.
+
+    -  .. row 7
+
+       -  EFAULT
+
+       -  The driver failed to write to the callers buffer due to an invalid
+          *buf pointer.
+
+
+
+.. _dmx_fwrite:
+
+write()
+=======
+
+DESCRIPTION
+
+This system call is only provided by the logical device
+/dev/dvb/adapter0/dvr0, associated with the physical demux device that
+provides the actual DVR functionality. It is used for replay of a
+digitally recorded Transport Stream. Matching filters have to be defined
+in the corresponding physical demux device, /dev/dvb/adapter0/demux0.
+The amount of data to be transferred is implied by count.
+
+SYNOPSIS
+
+ssize_t write(int fd, const void *buf, size_t count);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  void *buf
+
+       -  Pointer to the buffer containing the Transport Stream.
+
+    -  .. row 3
+
+       -  size_t count
+
+       -  Size of buf.
+
+
+RETURN VALUE
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  EWOULDBLOCK
+
+       -  No data was written. This might happen if O_NONBLOCK was
+          specified and there is no more buffer space available (if
+          O_NONBLOCK is not specified the function will block until buffer
+          space is available).
+
+    -  .. row 2
+
+       -  EBUSY
+
+       -  This error code indicates that there are conflicting requests. The
+          corresponding demux device is setup to receive data from the
+          front- end. Make sure that these filters are stopped and that the
+          filters with input set to DMX_IN_DVR are started.
+
+    -  .. row 3
+
+       -  EBADF
+
+       -  fd is not a valid open file descriptor.
+
+
+
+.. _DMX_START:
+
+DMX_START
+=========
+
+DESCRIPTION
+
+This ioctl call is used to start the actual filtering operation defined
+via the ioctl calls DMX_SET_FILTER or DMX_SET_PES_FILTER.
+
+SYNOPSIS
+
+int ioctl( int fd, int request = DMX_START);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals DMX_START for this command.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  EINVAL
+
+       -  Invalid argument, i.e. no filtering parameters provided via the
+          DMX_SET_FILTER or DMX_SET_PES_FILTER functions.
+
+    -  .. row 2
+
+       -  EBUSY
+
+       -  This error code indicates that there are conflicting requests.
+          There are active filters filtering data from another input source.
+          Make sure that these filters are stopped before starting this
+          filter.
+
+
+
+.. _DMX_STOP:
+
+DMX_STOP
+========
+
+DESCRIPTION
+
+This ioctl call is used to stop the actual filtering operation defined
+via the ioctl calls DMX_SET_FILTER or DMX_SET_PES_FILTER and
+started via the DMX_START command.
+
+SYNOPSIS
+
+int ioctl( int fd, int request = DMX_STOP);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals DMX_STOP for this command.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _DMX_SET_FILTER:
+
+DMX_SET_FILTER
+==============
+
+DESCRIPTION
+
+This ioctl call sets up a filter according to the filter and mask
+parameters provided. A timeout may be defined stating number of seconds
+to wait for a section to be loaded. A value of 0 means that no timeout
+should be applied. Finally there is a flag field where it is possible to
+state whether a section should be CRC-checked, whether the filter should
+be a ”one-shot” filter, i.e. if the filtering operation should be
+stopped after the first section is received, and whether the filtering
+operation should be started immediately (without waiting for a
+DMX_START ioctl call). If a filter was previously set-up, this filter
+will be canceled, and the receive buffer will be flushed.
+
+SYNOPSIS
+
+int ioctl( int fd, int request = DMX_SET_FILTER, struct
+dmx_sct_filter_params *params);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals DMX_SET_FILTER for this command.
+
+    -  .. row 3
+
+       -  struct dmx_sct_filter_params *params
+
+       -  Pointer to structure containing filter parameters.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _DMX_SET_PES_FILTER:
+
+DMX_SET_PES_FILTER
+==================
+
+DESCRIPTION
+
+This ioctl call sets up a PES filter according to the parameters
+provided. By a PES filter is meant a filter that is based just on the
+packet identifier (PID), i.e. no PES header or payload filtering
+capability is supported.
+
+SYNOPSIS
+
+int ioctl( int fd, int request = DMX_SET_PES_FILTER, struct
+dmx_pes_filter_params *params);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals DMX_SET_PES_FILTER for this command.
+
+    -  .. row 3
+
+       -  struct dmx_pes_filter_params *params
+
+       -  Pointer to structure containing filter parameters.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  EBUSY
+
+       -  This error code indicates that there are conflicting requests.
+          There are active filters filtering data from another input source.
+          Make sure that these filters are stopped before starting this
+          filter.
+
+
+
+.. _DMX_SET_BUFFER_SIZE:
+
+DMX_SET_BUFFER_SIZE
+===================
+
+DESCRIPTION
+
+This ioctl call is used to set the size of the circular buffer used for
+filtered data. The default size is two maximum sized sections, i.e. if
+this function is not called a buffer size of 2 * 4096 bytes will be
+used.
+
+SYNOPSIS
+
+int ioctl( int fd, int request = DMX_SET_BUFFER_SIZE, unsigned long
+size);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals DMX_SET_BUFFER_SIZE for this command.
+
+    -  .. row 3
+
+       -  unsigned long size
+
+       -  Size of circular buffer.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _DMX_GET_EVENT:
+
+DMX_GET_EVENT
+=============
+
+DESCRIPTION
+
+This ioctl call returns an event if available. If an event is not
+available, the behavior depends on whether the device is in blocking or
+non-blocking mode. In the latter case, the call fails immediately with
+errno set to EWOULDBLOCK. In the former case, the call blocks until an
+event becomes available.
+
+SYNOPSIS
+
+int ioctl( int fd, int request = DMX_GET_EVENT, struct dmx_event
+*ev);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals DMX_GET_EVENT for this command.
+
+    -  .. row 3
+
+       -  struct dmx_event *ev
+
+       -  Pointer to the location where the event is to be stored.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  EWOULDBLOCK
+
+       -  There is no event pending, and the device is in non-blocking mode.
+
+
+
+.. _DMX_GET_STC:
+
+DMX_GET_STC
+===========
+
+DESCRIPTION
+
+This ioctl call returns the current value of the system time counter
+(which is driven by a PES filter of type DMX_PES_PCR). Some hardware
+supports more than one STC, so you must specify which one by setting the
+num field of stc before the ioctl (range 0...n). The result is returned
+in form of a ratio with a 64 bit numerator and a 32 bit denominator, so
+the real 90kHz STC value is stc->stc / stc->base .
+
+SYNOPSIS
+
+int ioctl( int fd, int request = DMX_GET_STC, struct dmx_stc *stc);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals DMX_GET_STC for this command.
+
+    -  .. row 3
+
+       -  struct dmx_stc *stc
+
+       -  Pointer to the location where the stc is to be stored.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  EINVAL
+
+       -  Invalid stc number.
+
+
+
+.. _DMX_GET_PES_PIDS:
+
+DMX_GET_PES_PIDS
+================
+
+DESCRIPTION
+
+This ioctl is undocumented. Documentation is welcome.
+
+SYNOPSIS
+
+int ioctl(fd, int request = DMX_GET_PES_PIDS, __u16[5]);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals DMX_GET_PES_PIDS for this command.
+
+    -  .. row 3
+
+       -  __u16[5]
+
+       -  Undocumented.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _DMX_GET_CAPS:
+
+DMX_GET_CAPS
+============
+
+DESCRIPTION
+
+This ioctl is undocumented. Documentation is welcome.
+
+SYNOPSIS
+
+int ioctl(fd, int request = DMX_GET_CAPS, dmx_caps_t *);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals DMX_GET_CAPS for this command.
+
+    -  .. row 3
+
+       -  dmx_caps_t *
+
+       -  Undocumented.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _DMX_SET_SOURCE:
+
+DMX_SET_SOURCE
+==============
+
+DESCRIPTION
+
+This ioctl is undocumented. Documentation is welcome.
+
+SYNOPSIS
+
+int ioctl(fd, int request = DMX_SET_SOURCE, dmx_source_t *);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals DMX_SET_SOURCE for this command.
+
+    -  .. row 3
+
+       -  dmx_source_t *
+
+       -  Undocumented.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _DMX_ADD_PID:
+
+DMX_ADD_PID
+===========
+
+DESCRIPTION
+
+This ioctl call allows to add multiple PIDs to a transport stream filter
+previously set up with DMX_SET_PES_FILTER and output equal to
+DMX_OUT_TSDEMUX_TAP.
+
+SYNOPSIS
+
+int ioctl(fd, int request = DMX_ADD_PID, __u16 *);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals DMX_ADD_PID for this command.
+
+    -  .. row 3
+
+       -  __u16 *
+
+       -  PID number to be filtered.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _DMX_REMOVE_PID:
+
+DMX_REMOVE_PID
+==============
+
+DESCRIPTION
+
+This ioctl call allows to remove a PID when multiple PIDs are set on a
+transport stream filter, e. g. a filter previously set up with output
+equal to DMX_OUT_TSDEMUX_TAP, created via either
+DMX_SET_PES_FILTER or DMX_ADD_PID.
+
+SYNOPSIS
+
+int ioctl(fd, int request = DMX_REMOVE_PID, __u16 *);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals DMX_REMOVE_PID for this command.
+
+    -  .. row 3
+
+       -  __u16 *
+
+       -  PID of the PES filter to be removed.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/dmx_h.rst b/Documentation/linux_tv/media/dvb/dmx_h.rst
new file mode 100644
index 000000000000..19e2691b7eab
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/dmx_h.rst
@@ -0,0 +1,24 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _dmx_h:
+
+*********************
+DVB Demux Header File
+*********************
+
+
+.. toctree::
+    :maxdepth: 1
+
+    ../../dmx.h
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/dmx_types.rst b/Documentation/linux_tv/media/dvb/dmx_types.rst
new file mode 100644
index 000000000000..83859366b73e
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/dmx_types.rst
@@ -0,0 +1,253 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _dmx_types:
+
+****************
+Demux Data Types
+****************
+
+
+.. _dmx-output-t:
+
+Output for the demux
+====================
+
+
+.. _dmx-output:
+
+.. flat-table:: enum dmx_output
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ID
+
+       -  Description
+
+    -  .. row 2
+
+       -  .. _`DMX-OUT-DECODER`:
+
+          DMX_OUT_DECODER
+
+       -  Streaming directly to decoder.
+
+    -  .. row 3
+
+       -  .. _`DMX-OUT-TAP`:
+
+          DMX_OUT_TAP
+
+       -  Output going to a memory buffer (to be retrieved via the read
+          command). Delivers the stream output to the demux device on which
+          the ioctl is called.
+
+    -  .. row 4
+
+       -  .. _`DMX-OUT-TS-TAP`:
+
+          DMX_OUT_TS_TAP
+
+       -  Output multiplexed into a new TS (to be retrieved by reading from
+          the logical DVR device). Routes output to the logical DVR device
+          ``/dev/dvb/adapter?/dvr?``, which delivers a TS multiplexed from
+          all filters for which ``DMX_OUT_TS_TAP`` was specified.
+
+    -  .. row 5
+
+       -  .. _`DMX-OUT-TSDEMUX-TAP`:
+
+          DMX_OUT_TSDEMUX_TAP
+
+       -  Like :ref:`DMX_OUT_TS_TAP <DMX-OUT-TS-TAP>` but retrieved
+          from the DMX device.
+
+
+
+.. _dmx-input-t:
+
+dmx_input_t
+===========
+
+
+.. code-block:: c
+
+    typedef enum
+    {
+        DMX_IN_FRONTEND, /* Input from a front-end device.  */
+        DMX_IN_DVR       /* Input from the logical DVR device.  */
+    } dmx_input_t;
+
+
+.. _dmx-pes-type-t:
+
+dmx_pes_type_t
+==============
+
+
+.. code-block:: c
+
+    typedef enum
+    {
+        DMX_PES_AUDIO0,
+        DMX_PES_VIDEO0,
+        DMX_PES_TELETEXT0,
+        DMX_PES_SUBTITLE0,
+        DMX_PES_PCR0,
+
+        DMX_PES_AUDIO1,
+        DMX_PES_VIDEO1,
+        DMX_PES_TELETEXT1,
+        DMX_PES_SUBTITLE1,
+        DMX_PES_PCR1,
+
+        DMX_PES_AUDIO2,
+        DMX_PES_VIDEO2,
+        DMX_PES_TELETEXT2,
+        DMX_PES_SUBTITLE2,
+        DMX_PES_PCR2,
+
+        DMX_PES_AUDIO3,
+        DMX_PES_VIDEO3,
+        DMX_PES_TELETEXT3,
+        DMX_PES_SUBTITLE3,
+        DMX_PES_PCR3,
+
+        DMX_PES_OTHER
+    } dmx_pes_type_t;
+
+
+.. _dmx-filter:
+
+struct dmx_filter
+=================
+
+
+.. code-block:: c
+
+     typedef struct dmx_filter
+    {
+        __u8  filter[DMX_FILTER_SIZE];
+        __u8  mask[DMX_FILTER_SIZE];
+        __u8  mode[DMX_FILTER_SIZE];
+    } dmx_filter_t;
+
+
+.. _dmx-sct-filter-params:
+
+struct dmx_sct_filter_params
+============================
+
+
+.. code-block:: c
+
+    struct dmx_sct_filter_params
+    {
+        __u16          pid;
+        dmx_filter_t   filter;
+        __u32          timeout;
+        __u32          flags;
+    #define DMX_CHECK_CRC       1
+    #define DMX_ONESHOT         2
+    #define DMX_IMMEDIATE_START 4
+    #define DMX_KERNEL_CLIENT   0x8000
+    };
+
+
+.. _dmx-pes-filter-params:
+
+struct dmx_pes_filter_params
+============================
+
+
+.. code-block:: c
+
+    struct dmx_pes_filter_params
+    {
+        __u16          pid;
+        dmx_input_t    input;
+        dmx_output_t   output;
+        dmx_pes_type_t pes_type;
+        __u32          flags;
+    };
+
+
+.. _dmx-event:
+
+struct dmx_event
+================
+
+
+.. code-block:: c
+
+     struct dmx_event
+     {
+         dmx_event_t          event;
+         time_t               timeStamp;
+         union
+         {
+             dmx_scrambling_status_t scrambling;
+         } u;
+     };
+
+
+.. _dmx-stc:
+
+struct dmx_stc
+==============
+
+
+.. code-block:: c
+
+    struct dmx_stc {
+        unsigned int num;   /* input : which STC? 0..N */
+        unsigned int base;  /* output: divisor for stc to get 90 kHz clock */
+        __u64 stc;      /* output: stc in 'base'*90 kHz units */
+    };
+
+
+.. _dmx-caps:
+
+struct dmx_caps
+===============
+
+
+.. code-block:: c
+
+     typedef struct dmx_caps {
+        __u32 caps;
+        int num_decoders;
+    } dmx_caps_t;
+
+
+.. _dmx-source-t:
+
+enum dmx_source_t
+=================
+
+
+.. code-block:: c
+
+    typedef enum {
+        DMX_SOURCE_FRONT0 = 0,
+        DMX_SOURCE_FRONT1,
+        DMX_SOURCE_FRONT2,
+        DMX_SOURCE_FRONT3,
+        DMX_SOURCE_DVR0   = 16,
+        DMX_SOURCE_DVR1,
+        DMX_SOURCE_DVR2,
+        DMX_SOURCE_DVR3
+    } dmx_source_t;
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/dtv-fe-stats.rst b/Documentation/linux_tv/media/dvb/dtv-fe-stats.rst
new file mode 100644
index 000000000000..17b26fa050f5
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/dtv-fe-stats.rst
@@ -0,0 +1,28 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _dtv-fe-stats:
+
+*******************
+struct dtv_fe_stats
+*******************
+
+
+.. code-block:: c
+
+    #define MAX_DTV_STATS   4
+
+    struct dtv_fe_stats {
+        __u8 len;
+        struct dtv_stats stat[MAX_DTV_STATS];
+    } __packed;
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/dtv-properties.rst b/Documentation/linux_tv/media/dvb/dtv-properties.rst
new file mode 100644
index 000000000000..b1b28342d09d
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/dtv-properties.rst
@@ -0,0 +1,26 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _dtv-properties:
+
+*********************
+struct dtv_properties
+*********************
+
+
+.. code-block:: c
+
+    struct dtv_properties {
+        __u32 num;
+        struct dtv_property *props;
+    };
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/dtv-property.rst b/Documentation/linux_tv/media/dvb/dtv-property.rst
new file mode 100644
index 000000000000..4dff00eb610c
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/dtv-property.rst
@@ -0,0 +1,42 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _dtv-property:
+
+*******************
+struct dtv_property
+*******************
+
+
+.. code-block:: c
+
+    /* Reserved fields should be set to 0 */
+
+    struct dtv_property {
+        __u32 cmd;
+        __u32 reserved[3];
+        union {
+            __u32 data;
+            struct dtv_fe_stats st;
+            struct {
+                __u8 data[32];
+                __u32 len;
+                __u32 reserved1[3];
+                void *reserved2;
+            } buffer;
+        } u;
+        int result;
+    } __attribute__ ((packed));
+
+    /* num of properties cannot exceed DTV_IOCTL_MAX_MSGS per ioctl */
+    #define DTV_IOCTL_MAX_MSGS 64
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/dtv-stats.rst b/Documentation/linux_tv/media/dvb/dtv-stats.rst
new file mode 100644
index 000000000000..e70e5a5283ff
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/dtv-stats.rst
@@ -0,0 +1,29 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _dtv-stats:
+
+****************
+struct dtv_stats
+****************
+
+
+.. code-block:: c
+
+    struct dtv_stats {
+        __u8 scale; /* enum fecap_scale_params type */
+        union {
+            __u64 uvalue;   /* for counters and relative scales */
+            __s64 svalue;   /* for 1/1000 dB measures */
+        };
+    } __packed;
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/dvb-fe-read-status.rst b/Documentation/linux_tv/media/dvb/dvb-fe-read-status.rst
new file mode 100644
index 000000000000..12d8749e9e05
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/dvb-fe-read-status.rst
@@ -0,0 +1,31 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _dvb-fe-read-status:
+
+***************************************
+Querying frontend status and statistics
+***************************************
+
+Once :ref:`FE_SET_PROPERTY <FE_GET_PROPERTY>` is called, the
+frontend will run a kernel thread that will periodically check for the
+tuner lock status and provide statistics about the quality of the
+signal.
+
+The information about the frontend tuner locking status can be queried
+using :ref:`FE_READ_STATUS <FE_READ_STATUS>`.
+
+Signal statistics are provided via
+:ref:`FE_GET_PROPERTY <FE_GET_PROPERTY>`. Please note that several
+statistics require the demodulator to be fully locked (e. g. with
+FE_HAS_LOCK bit set). See
+:ref:`Frontend statistics indicators <frontend-stat-properties>` for
+more details.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/dvb-frontend-event.rst b/Documentation/linux_tv/media/dvb/dvb-frontend-event.rst
new file mode 100644
index 000000000000..82965e4d7450
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/dvb-frontend-event.rst
@@ -0,0 +1,26 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _dvb-frontend-event:
+
+***************
+frontend events
+***************
+
+
+.. code-block:: c
+
+     struct dvb_frontend_event {
+         fe_status_t status;
+         struct dvb_frontend_parameters parameters;
+     };
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/dvb-frontend-parameters.rst b/Documentation/linux_tv/media/dvb/dvb-frontend-parameters.rst
new file mode 100644
index 000000000000..0a1766f68917
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/dvb-frontend-parameters.rst
@@ -0,0 +1,130 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _dvb-frontend-parameters:
+
+*******************
+frontend parameters
+*******************
+
+The kind of parameters passed to the frontend device for tuning depend
+on the kind of hardware you are using.
+
+The struct ``dvb_frontend_parameters`` uses an union with specific
+per-system parameters. However, as newer delivery systems required more
+data, the structure size weren't enough to fit, and just extending its
+size would break the existing applications. So, those parameters were
+replaced by the usage of
+:ref:`FE_GET_PROPERTY/FE_SET_PROPERTY <FE_GET_PROPERTY>`
+ioctl's. The new API is flexible enough to add new parameters to
+existing delivery systems, and to add newer delivery systems.
+
+So, newer applications should use
+:ref:`FE_GET_PROPERTY/FE_SET_PROPERTY <FE_GET_PROPERTY>`
+instead, in order to be able to support the newer System Delivery like
+DVB-S2, DVB-T2, DVB-C2, ISDB, etc.
+
+All kinds of parameters are combined as an union in the
+FrontendParameters structure:
+
+
+.. code-block:: c
+
+    struct dvb_frontend_parameters {
+        uint32_t frequency;     /* (absolute) frequency in Hz for QAM/OFDM */
+                    /* intermediate frequency in kHz for QPSK */
+        fe_spectral_inversion_t inversion;
+        union {
+            struct dvb_qpsk_parameters qpsk;
+            struct dvb_qam_parameters  qam;
+            struct dvb_ofdm_parameters ofdm;
+            struct dvb_vsb_parameters  vsb;
+        } u;
+    };
+
+In the case of QPSK frontends the ``frequency`` field specifies the
+intermediate frequency, i.e. the offset which is effectively added to
+the local oscillator frequency (LOF) of the LNB. 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.
+
+
+.. _dvb-qpsk-parameters:
+
+QPSK parameters
+===============
+
+For satellite QPSK frontends you have to use the ``dvb_qpsk_parameters``
+structure:
+
+
+.. code-block:: c
+
+     struct dvb_qpsk_parameters {
+         uint32_t        symbol_rate;  /* symbol rate in Symbols per second */
+         fe_code_rate_t  fec_inner;    /* forward error correction (see above) */
+     };
+
+
+.. _dvb-qam-parameters:
+
+QAM parameters
+==============
+
+for cable QAM frontend you use the ``dvb_qam_parameters`` structure:
+
+
+.. code-block:: c
+
+     struct dvb_qam_parameters {
+         uint32_t         symbol_rate; /* symbol rate in Symbols per second */
+         fe_code_rate_t   fec_inner;   /* forward error correction (see above) */
+         fe_modulation_t  modulation;  /* modulation type (see above) */
+     };
+
+
+.. _dvb-vsb-parameters:
+
+VSB parameters
+==============
+
+ATSC frontends are supported by the ``dvb_vsb_parameters`` structure:
+
+
+.. code-block:: c
+
+    struct dvb_vsb_parameters {
+        fe_modulation_t modulation; /* modulation type (see above) */
+    };
+
+
+.. _dvb-ofdm-parameters:
+
+OFDM parameters
+===============
+
+DVB-T frontends are supported by the ``dvb_ofdm_parameters`` structure:
+
+
+.. code-block:: c
+
+     struct dvb_ofdm_parameters {
+         fe_bandwidth_t      bandwidth;
+         fe_code_rate_t      code_rate_HP;  /* high priority stream code rate */
+         fe_code_rate_t      code_rate_LP;  /* low priority stream code rate */
+         fe_modulation_t     constellation; /* modulation type (see above) */
+         fe_transmit_mode_t  transmission_mode;
+         fe_guard_interval_t guard_interval;
+         fe_hierarchy_t      hierarchy_information;
+     };
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/dvbapi.rst b/Documentation/linux_tv/media/dvb/dvbapi.rst
new file mode 100644
index 000000000000..5e513ac86052
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/dvbapi.rst
@@ -0,0 +1,95 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _dvbapi:
+
+#############
+LINUX DVB API
+#############
+
+**Version 5.10**
+
+.. toctree::
+    :maxdepth: 1
+
+    intro
+    frontend
+    demux
+    ca
+    net
+    legacy_dvb_apis
+    examples
+    audio_h
+    ca_h
+    dmx_h
+    frontend_h
+    net_h
+    video_h
+
+
+**********************
+Revision and Copyright
+**********************
+
+
+:author:    Metzler Ralph (*J. K.*)
+:address:   rjkm@metzlerbros.de
+
+:author:    Metzler Marcus (*O. C.*)
+:address:   rjkm@metzlerbros.de
+
+:author:    Chehab Mauro (*Carvalho*)
+:address:   m.chehab@samsung.com
+:contrib:   Ported document to Docbook XML.
+
+**Copyright** 2002, 2003 : Convergence GmbH
+
+**Copyright** 2009-2015 : Mauro Carvalho Chehab
+
+:revision: 2.1.0 / 2015-05-29 (*mcc*)
+
+DocBook improvements and cleanups, in order to document the system calls
+on a more standard way and provide more description about the current
+DVB API.
+
+
+:revision: 2.0.4 / 2011-05-06 (*mcc*)
+
+Add more information about DVB APIv5, better describing the frontend
+GET/SET props ioctl's.
+
+
+:revision: 2.0.3 / 2010-07-03 (*mcc*)
+
+Add some frontend capabilities flags, present on kernel, but missing at
+the specs.
+
+
+:revision: 2.0.2 / 2009-10-25 (*mcc*)
+
+documents FE_SET_FRONTEND_TUNE_MODE and
+FE_DISHETWORK_SEND_LEGACY_CMD ioctls.
+
+
+:revision: 2.0.1 / 2009-09-16 (*mcc*)
+
+Added ISDB-T test originally written by Patrick Boettcher
+
+
+:revision: 2.0.0 / 2009-09-06 (*mcc*)
+
+Conversion from LaTex to DocBook XML. The contents is the same as the
+original LaTex version.
+
+
+:revision: 1.0.0 / 2003-07-24 (*rjkm*)
+
+Initial revision on LaTEX.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/dvbproperty-006.rst b/Documentation/linux_tv/media/dvb/dvbproperty-006.rst
new file mode 100644
index 000000000000..4b89d607358c
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/dvbproperty-006.rst
@@ -0,0 +1,21 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+**************
+Property types
+**************
+
+On :ref:`FE_GET_PROPERTY and FE_SET_PROPERTY <FE_GET_PROPERTY>`,
+the actual action is determined by the dtv_property cmd/data pairs.
+With one single ioctl, is possible to get/set up to 64 properties. The
+actual meaning of each property is described on the next sections.
+
+The available frontend property types are shown on the next section.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/dvbproperty.rst b/Documentation/linux_tv/media/dvb/dvbproperty.rst
new file mode 100644
index 000000000000..a68b17808bc2
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/dvbproperty.rst
@@ -0,0 +1,122 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _frontend-properties:
+
+DVB Frontend properties
+=======================
+
+Tuning into a Digital TV physical channel and starting decoding it
+requires changing a set of parameters, in order to control the tuner,
+the demodulator, the Linear Low-noise Amplifier (LNA) and to set the
+antenna subsystem via Satellite Equipment Control (SEC), on satellite
+systems. The actual parameters are specific to each particular digital
+TV standards, and may change as the digital TV specs evolves.
+
+In the past, the strategy used was to have a union with the parameters
+needed to tune for DVB-S, DVB-C, DVB-T and ATSC delivery systems grouped
+there. The problem is that, as the second generation standards appeared,
+those structs were not big enough to contain the additional parameters.
+Also, the union didn't have any space left to be expanded without
+breaking userspace. So, the decision was to deprecate the legacy
+union/struct based approach, in favor of a properties set approach.
+
+NOTE: on Linux DVB API version 3, setting a frontend were done via
+:ref:`struct dvb_frontend_parameters <dvb-frontend-parameters>`.
+This got replaced on version 5 (also called "S2API", as this API were
+added originally_enabled to provide support for DVB-S2), because the
+old API has a very limited support to new standards and new hardware.
+This section describes the new and recommended way to set the frontend,
+with suppports all digital TV delivery systems.
+
+Example: with the properties based approach, in order to set the tuner
+to a DVB-C channel at 651 kHz, modulated with 256-QAM, FEC 3/4 and
+symbol rate of 5.217 Mbauds, those properties should be sent to
+:ref:`FE_SET_PROPERTY <FE_GET_PROPERTY>` ioctl:
+
+-  :ref:`DTV_DELIVERY_SYSTEM <DTV-DELIVERY-SYSTEM>` =
+   SYS_DVBC_ANNEX_A
+
+-  :ref:`DTV_FREQUENCY <DTV-FREQUENCY>` = 651000000
+
+-  :ref:`DTV_MODULATION <DTV-MODULATION>` = QAM_256
+
+-  :ref:`DTV_INVERSION <DTV-INVERSION>` = INVERSION_AUTO
+
+-  :ref:`DTV_SYMBOL_RATE <DTV-SYMBOL-RATE>` = 5217000
+
+-  :ref:`DTV_INNER_FEC <DTV-INNER-FEC>` = FEC_3_4
+
+-  :ref:`DTV_TUNE <DTV-TUNE>`
+
+The code that would do the above is:
+
+
+.. code-block:: c
+
+    #include <stdio.h>
+    #include <fcntl.h>
+    #include <sys/ioctl.h>
+    #include <linux/dvb/frontend.h>
+
+    static struct dtv_property props[] = {
+        { .cmd = DTV_DELIVERY_SYSTEM, .u.data = SYS_DVBC_ANNEX_A },
+        { .cmd = DTV_FREQUENCY,       .u.data = 651000000 },
+        { .cmd = DTV_MODULATION,      .u.data = QAM_256 },
+        { .cmd = DTV_INVERSION,       .u.data = INVERSION_AUTO },
+        { .cmd = DTV_SYMBOL_RATE,     .u.data = 5217000 },
+        { .cmd = DTV_INNER_FEC,       .u.data = FEC_3_4 },
+        { .cmd = DTV_TUNE }
+    };
+
+    static struct dtv_properties dtv_prop = {
+        .num = 6, .props = props
+    };
+
+    int main(void)
+    {
+        int fd = open("/dev/dvb/adapter0/frontend0", O_RDWR);
+
+        if (!fd) {
+            perror ("open");
+            return -1;
+        }
+        if (ioctl(fd, FE_SET_PROPERTY, &dtv_prop) == -1) {
+            perror("ioctl");
+            return -1;
+        }
+        printf("Frontend set\\n");
+        return 0;
+    }
+
+NOTE: While it is possible to directly call the Kernel code like the
+above example, it is strongly recommended to use
+`libdvbv5 <https://linuxtv.org/docs/libdvbv5/index.html>`__, as it
+provides abstraction to work with the supported digital TV standards and
+provides methods for usual operations like program scanning and to
+read/write channel descriptor files.
+
+
+.. toctree::
+    :maxdepth: 1
+
+    dtv-stats
+    dtv-fe-stats
+    dtv-property
+    dtv-properties
+    dvbproperty-006
+    fe_property_parameters
+    frontend-stat-properties
+    frontend-property-terrestrial-systems
+    frontend-property-cable-systems
+    frontend-property-satellite-systems
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/examples.rst b/Documentation/linux_tv/media/dvb/examples.rst
new file mode 100644
index 000000000000..b3a94dedcd39
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/examples.rst
@@ -0,0 +1,391 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _dvb_examples:
+
+********
+Examples
+********
+
+In this section we would like to present some examples for using the DVB
+API.
+
+NOTE: This section is out of date, and the code below won't even
+compile. Please refer to the
+`libdvbv5 <https://linuxtv.org/docs/libdvbv5/index.html>`__ for
+updated/recommended examples.
+
+
+.. _tuning:
+
+Tuning
+======
+
+We will start with a generic tuning subroutine that uses the frontend
+and SEC, as well as the demux devices. The example is given for QPSK
+tuners, but can easily be adjusted for QAM.
+
+
+.. code-block:: c
+
+     #include <sys/ioctl.h>
+     #include <stdio.h>
+     #include <stdint.h>
+     #include <sys/types.h>
+     #include <sys/stat.h>
+     #include <fcntl.h>
+     #include <time.h>
+     #include <unistd.h>
+
+     #include <linux/dvb/dmx.h>
+     #include <linux/dvb/frontend.h>
+     #include <linux/dvb/sec.h>
+     #include <sys/poll.h>
+
+     #define DMX "/dev/dvb/adapter0/demux1"
+     #define FRONT "/dev/dvb/adapter0/frontend1"
+     #define SEC "/dev/dvb/adapter0/sec1"
+
+     /* routine for checking if we have a signal and other status information*/
+     int FEReadStatus(int fd, fe_status_t *stat)
+     {
+         int ans;
+
+         if ( (ans = ioctl(fd,FE_READ_STATUS,stat) < 0)){
+             perror("FE READ STATUS: ");
+             return -1;
+         }
+
+         if (*stat & FE_HAS_POWER)
+             printf("FE HAS POWER\\n");
+
+         if (*stat & FE_HAS_SIGNAL)
+             printf("FE HAS SIGNAL\\n");
+
+         if (*stat & FE_SPECTRUM_INV)
+             printf("SPEKTRUM INV\\n");
+
+         return 0;
+     }
+
+
+     /* tune qpsk */
+     /* freq:             frequency of transponder                      */
+     /* vpid, apid, tpid: PIDs of video, audio and teletext TS packets  */
+     /* diseqc:           DiSEqC address of the used LNB                */
+     /* pol:              Polarisation                                  */
+     /* srate:            Symbol Rate                                   */
+     /* fec.              FEC                                           */
+     /* lnb_lof1:         local frequency of lower LNB band             */
+     /* lnb_lof2:         local frequency of upper LNB band             */
+     /* lnb_slof:         switch frequency of LNB                       */
+
+     int set_qpsk_channel(int freq, int vpid, int apid, int tpid,
+             int diseqc, int pol, int srate, int fec, int lnb_lof1,
+             int lnb_lof2, int lnb_slof)
+     {
+         struct secCommand scmd;
+         struct secCmdSequence scmds;
+         struct dmx_pes_filter_params pesFilterParams;
+         FrontendParameters frp;
+         struct pollfd pfd[1];
+         FrontendEvent event;
+         int demux1, demux2, demux3, front;
+
+         frequency = (uint32_t) freq;
+         symbolrate = (uint32_t) srate;
+
+         if((front = open(FRONT,O_RDWR)) < 0){
+             perror("FRONTEND DEVICE: ");
+             return -1;
+         }
+
+         if((sec = open(SEC,O_RDWR)) < 0){
+             perror("SEC DEVICE: ");
+             return -1;
+         }
+
+         if (demux1 < 0){
+             if ((demux1=open(DMX, O_RDWR|O_NONBLOCK))
+                 < 0){
+                 perror("DEMUX DEVICE: ");
+                 return -1;
+             }
+         }
+
+         if (demux2 < 0){
+             if ((demux2=open(DMX, O_RDWR|O_NONBLOCK))
+                 < 0){
+                 perror("DEMUX DEVICE: ");
+                 return -1;
+             }
+         }
+
+         if (demux3 < 0){
+             if ((demux3=open(DMX, O_RDWR|O_NONBLOCK))
+                 < 0){
+                 perror("DEMUX DEVICE: ");
+                 return -1;
+             }
+         }
+
+         if (freq < lnb_slof) {
+             frp.Frequency = (freq - lnb_lof1);
+             scmds.continuousTone = SEC_TONE_OFF;
+         } else {
+             frp.Frequency = (freq - lnb_lof2);
+             scmds.continuousTone = SEC_TONE_ON;
+         }
+         frp.Inversion = INVERSION_AUTO;
+         if (pol) scmds.voltage = SEC_VOLTAGE_18;
+         else scmds.voltage = SEC_VOLTAGE_13;
+
+         scmd.type=0;
+         scmd.u.diseqc.addr=0x10;
+         scmd.u.diseqc.cmd=0x38;
+         scmd.u.diseqc.numParams=1;
+         scmd.u.diseqc.params[0] = 0xF0 | ((diseqc * 4) & 0x0F) |
+             (scmds.continuousTone == SEC_TONE_ON ? 1 : 0) |
+             (scmds.voltage==SEC_VOLTAGE_18 ? 2 : 0);
+
+         scmds.miniCommand=SEC_MINI_NONE;
+         scmds.numCommands=1;
+         scmds.commands=&scmd;
+         if (ioctl(sec, SEC_SEND_SEQUENCE, &scmds) < 0){
+             perror("SEC SEND: ");
+             return -1;
+         }
+
+         if (ioctl(sec, SEC_SEND_SEQUENCE, &scmds) < 0){
+             perror("SEC SEND: ");
+             return -1;
+         }
+
+         frp.u.qpsk.SymbolRate = srate;
+         frp.u.qpsk.FEC_inner = fec;
+
+         if (ioctl(front, FE_SET_FRONTEND, &frp) < 0){
+             perror("QPSK TUNE: ");
+             return -1;
+         }
+
+         pfd[0].fd = front;
+         pfd[0].events = POLLIN;
+
+         if (poll(pfd,1,3000)){
+             if (pfd[0].revents & POLLIN){
+                 printf("Getting QPSK event\\n");
+                 if ( ioctl(front, FE_GET_EVENT, &event)
+
+                      == -EOVERFLOW){
+                     perror("qpsk get event");
+                     return -1;
+                 }
+                 printf("Received ");
+                 switch(event.type){
+                 case FE_UNEXPECTED_EV:
+                     printf("unexpected event\\n");
+                     return -1;
+                 case FE_FAILURE_EV:
+                     printf("failure event\\n");
+                     return -1;
+
+                 case FE_COMPLETION_EV:
+                     printf("completion event\\n");
+                 }
+             }
+         }
+
+
+         pesFilterParams.pid     = vpid;
+         pesFilterParams.input   = DMX_IN_FRONTEND;
+         pesFilterParams.output  = DMX_OUT_DECODER;
+         pesFilterParams.pes_type = DMX_PES_VIDEO;
+         pesFilterParams.flags   = DMX_IMMEDIATE_START;
+         if (ioctl(demux1, DMX_SET_PES_FILTER, &pesFilterParams) < 0){
+             perror("set_vpid");
+             return -1;
+         }
+
+         pesFilterParams.pid     = apid;
+         pesFilterParams.input   = DMX_IN_FRONTEND;
+         pesFilterParams.output  = DMX_OUT_DECODER;
+         pesFilterParams.pes_type = DMX_PES_AUDIO;
+         pesFilterParams.flags   = DMX_IMMEDIATE_START;
+         if (ioctl(demux2, DMX_SET_PES_FILTER, &pesFilterParams) < 0){
+             perror("set_apid");
+             return -1;
+         }
+
+         pesFilterParams.pid     = tpid;
+         pesFilterParams.input   = DMX_IN_FRONTEND;
+         pesFilterParams.output  = DMX_OUT_DECODER;
+         pesFilterParams.pes_type = DMX_PES_TELETEXT;
+         pesFilterParams.flags   = DMX_IMMEDIATE_START;
+         if (ioctl(demux3, DMX_SET_PES_FILTER, &pesFilterParams) < 0){
+             perror("set_tpid");
+             return -1;
+         }
+
+         return has_signal(fds);
+     }
+
+The program assumes that you are using a universal LNB and a standard
+DiSEqC switch with up to 4 addresses. Of course, you could build in some
+more checking if tuning was successful and maybe try to repeat the
+tuning process. Depending on the external hardware, i.e. LNB and DiSEqC
+switch, and weather conditions this may be necessary.
+
+
+.. _the_dvr_device:
+
+The DVR device
+==============
+
+The following program code shows how to use the DVR device for
+recording.
+
+
+.. code-block:: c
+
+     #include <sys/ioctl.h>
+     #include <stdio.h>
+     #include <stdint.h>
+     #include <sys/types.h>
+     #include <sys/stat.h>
+     #include <fcntl.h>
+     #include <time.h>
+     #include <unistd.h>
+
+     #include <linux/dvb/dmx.h>
+     #include <linux/dvb/video.h>
+     #include <sys/poll.h>
+     #define DVR "/dev/dvb/adapter0/dvr1"
+     #define AUDIO "/dev/dvb/adapter0/audio1"
+     #define VIDEO "/dev/dvb/adapter0/video1"
+
+     #define BUFFY (188*20)
+     #define MAX_LENGTH (1024*1024*5) /* record 5MB */
+
+
+     /* switch the demuxes to recording, assuming the transponder is tuned */
+
+     /* demux1, demux2: file descriptor of video and audio filters */
+     /* vpid, apid:     PIDs of video and audio channels           */
+
+     int switch_to_record(int demux1, int demux2, uint16_t vpid, uint16_t apid)
+     {
+         struct dmx_pes_filter_params pesFilterParams;
+
+         if (demux1 < 0){
+             if ((demux1=open(DMX, O_RDWR|O_NONBLOCK))
+                 < 0){
+                 perror("DEMUX DEVICE: ");
+                 return -1;
+             }
+         }
+
+         if (demux2 < 0){
+             if ((demux2=open(DMX, O_RDWR|O_NONBLOCK))
+                 < 0){
+                 perror("DEMUX DEVICE: ");
+                 return -1;
+             }
+         }
+
+         pesFilterParams.pid = vpid;
+         pesFilterParams.input = DMX_IN_FRONTEND;
+         pesFilterParams.output = DMX_OUT_TS_TAP;
+         pesFilterParams.pes_type = DMX_PES_VIDEO;
+         pesFilterParams.flags = DMX_IMMEDIATE_START;
+         if (ioctl(demux1, DMX_SET_PES_FILTER, &pesFilterParams) < 0){
+             perror("DEMUX DEVICE");
+             return -1;
+         }
+         pesFilterParams.pid = apid;
+         pesFilterParams.input = DMX_IN_FRONTEND;
+         pesFilterParams.output = DMX_OUT_TS_TAP;
+         pesFilterParams.pes_type = DMX_PES_AUDIO;
+         pesFilterParams.flags = DMX_IMMEDIATE_START;
+         if (ioctl(demux2, DMX_SET_PES_FILTER, &pesFilterParams) < 0){
+             perror("DEMUX DEVICE");
+             return -1;
+         }
+         return 0;
+     }
+
+     /* start recording MAX_LENGTH , assuming the transponder is tuned */
+
+     /* demux1, demux2: file descriptor of video and audio filters */
+     /* vpid, apid:     PIDs of video and audio channels           */
+     int record_dvr(int demux1, int demux2, uint16_t vpid, uint16_t apid)
+     {
+         int i;
+         int len;
+         int written;
+         uint8_t buf[BUFFY];
+         uint64_t length;
+         struct pollfd pfd[1];
+         int dvr, dvr_out;
+
+         /* open dvr device */
+         if ((dvr = open(DVR, O_RDONLY|O_NONBLOCK)) < 0){
+                 perror("DVR DEVICE");
+                 return -1;
+         }
+
+         /* switch video and audio demuxes to dvr */
+         printf ("Switching dvr on\\n");
+         i = switch_to_record(demux1, demux2, vpid, apid);
+         printf("finished: ");
+
+         printf("Recording %2.0f MB of test file in TS format\\n",
+            MAX_LENGTH/(1024.0*1024.0));
+         length = 0;
+
+         /* open output file */
+         if ((dvr_out = open(DVR_FILE,O_WRONLY|O_CREAT
+                      |O_TRUNC, S_IRUSR|S_IWUSR
+                      |S_IRGRP|S_IWGRP|S_IROTH|
+                      S_IWOTH)) < 0){
+             perror("Can't open file for dvr test");
+             return -1;
+         }
+
+         pfd[0].fd = dvr;
+         pfd[0].events = POLLIN;
+
+         /* poll for dvr data and write to file */
+         while (length < MAX_LENGTH ) {
+             if (poll(pfd,1,1)){
+                 if (pfd[0].revents & POLLIN){
+                     len = read(dvr, buf, BUFFY);
+                     if (len < 0){
+                         perror("recording");
+                         return -1;
+                     }
+                     if (len > 0){
+                         written = 0;
+                         while (written < len)
+                             written +=
+                                 write (dvr_out,
+                                    buf, len);
+                         length += len;
+                         printf("written %2.0f MB\\r",
+                            length/1024./1024.);
+                     }
+                 }
+             }
+         }
+         return 0;
+     }
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/fe-bandwidth-t.rst b/Documentation/linux_tv/media/dvb/fe-bandwidth-t.rst
new file mode 100644
index 000000000000..c6e56aba012a
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/fe-bandwidth-t.rst
@@ -0,0 +1,88 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _fe-bandwidth-t:
+
+******************
+Frontend bandwidth
+******************
+
+
+.. _fe-bandwidth:
+
+.. flat-table:: enum fe_bandwidth
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ID
+
+       -  Description
+
+    -  .. row 2
+
+       -  .. _`BANDWIDTH-AUTO`:
+
+          ``BANDWIDTH_AUTO``
+
+       -  Autodetect bandwidth (if supported)
+
+    -  .. row 3
+
+       -  .. _`BANDWIDTH-1-712-MHZ`:
+
+          ``BANDWIDTH_1_712_MHZ``
+
+       -  1.712 MHz
+
+    -  .. row 4
+
+       -  .. _`BANDWIDTH-5-MHZ`:
+
+          ``BANDWIDTH_5_MHZ``
+
+       -  5 MHz
+
+    -  .. row 5
+
+       -  .. _`BANDWIDTH-6-MHZ`:
+
+          ``BANDWIDTH_6_MHZ``
+
+       -  6 MHz
+
+    -  .. row 6
+
+       -  .. _`BANDWIDTH-7-MHZ`:
+
+          ``BANDWIDTH_7_MHZ``
+
+       -  7 MHz
+
+    -  .. row 7
+
+       -  .. _`BANDWIDTH-8-MHZ`:
+
+          ``BANDWIDTH_8_MHZ``
+
+       -  8 MHz
+
+    -  .. row 8
+
+       -  .. _`BANDWIDTH-10-MHZ`:
+
+          ``BANDWIDTH_10_MHZ``
+
+       -  10 MHz
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/fe-diseqc-recv-slave-reply.rst b/Documentation/linux_tv/media/dvb/fe-diseqc-recv-slave-reply.rst
new file mode 100644
index 000000000000..309930f9b3cd
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/fe-diseqc-recv-slave-reply.rst
@@ -0,0 +1,88 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _FE_DISEQC_RECV_SLAVE_REPLY:
+
+********************************
+ioctl FE_DISEQC_RECV_SLAVE_REPLY
+********************************
+
+*man FE_DISEQC_RECV_SLAVE_REPLY(2)*
+
+Receives reply from a DiSEqC 2.0 command
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct dvb_diseqc_slave_reply *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <frontend_f_open>`.
+
+``request``
+    FE_DISEQC_RECV_SLAVE_REPLY
+
+``argp``
+    pointer to struct
+    :ref:`dvb_diseqc_slave_reply <dvb-diseqc-slave-reply>`
+
+
+Description
+===========
+
+Receives reply from a DiSEqC 2.0 command.
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _dvb-diseqc-slave-reply:
+
+.. flat-table:: struct dvb_diseqc_slave_reply
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  uint8_t
+
+       -  msg[4]
+
+       -  DiSEqC message (framing, data[3])
+
+    -  .. row 2
+
+       -  uint8_t
+
+       -  msg_len
+
+       -  Length of the DiSEqC message. Valid values are 0 to 4, where 0
+          means no msg
+
+    -  .. row 3
+
+       -  int
+
+       -  timeout
+
+       -  Return from ioctl after timeout ms with errorcode when no message
+          was received
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/fe-diseqc-reset-overload.rst b/Documentation/linux_tv/media/dvb/fe-diseqc-reset-overload.rst
new file mode 100644
index 000000000000..dc7ae1a02725
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/fe-diseqc-reset-overload.rst
@@ -0,0 +1,51 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _FE_DISEQC_RESET_OVERLOAD:
+
+******************************
+ioctl FE_DISEQC_RESET_OVERLOAD
+******************************
+
+*man FE_DISEQC_RESET_OVERLOAD(2)*
+
+Restores the power to the antenna subsystem, if it was powered off due
+to power overload.
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, NULL )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <frontend_f_open>`.
+
+``request``
+    FE_DISEQC_RESET_OVERLOAD
+
+
+Description
+===========
+
+If the bus has been automatically powered off due to power overload,
+this ioctl call restores the power to the bus. The call requires
+read/write access to the device. This call has no effect if the device
+is manually powered off. Not all DVB adapters support this ioctl.
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/fe-diseqc-send-burst.rst b/Documentation/linux_tv/media/dvb/fe-diseqc-send-burst.rst
new file mode 100644
index 000000000000..34c787903eb1
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/fe-diseqc-send-burst.rst
@@ -0,0 +1,93 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _FE_DISEQC_SEND_BURST:
+
+**************************
+ioctl FE_DISEQC_SEND_BURST
+**************************
+
+*man FE_DISEQC_SEND_BURST(2)*
+
+Sends a 22KHz tone burst for 2x1 mini DiSEqC satellite selection.
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, enum fe_sec_mini_cmd *tone )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <frontend_f_open>`.
+
+``request``
+    FE_DISEQC_SEND_BURST
+
+``tone``
+    pointer to enum :ref:`fe_sec_mini_cmd <fe-sec-mini-cmd>`
+
+
+Description
+===========
+
+This ioctl is used to set the generation of a 22kHz tone burst for mini
+DiSEqC satellite selection for 2x1 switches. This call requires
+read/write permissions.
+
+It provides support for what's specified at
+`Digital Satellite Equipment Control (DiSEqC) - Simple "ToneBurst" Detection Circuit specification. <http://www.eutelsat.com/files/contributed/satellites/pdf/Diseqc/associated%20docs/simple_tone_burst_detec.pdf>`__
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _fe-sec-mini-cmd-t:
+
+enum fe_sec_mini_cmd
+====================
+
+
+.. _fe-sec-mini-cmd:
+
+.. flat-table:: enum fe_sec_mini_cmd
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ID
+
+       -  Description
+
+    -  .. row 2
+
+       -  .. _`SEC-MINI-A`:
+
+          ``SEC_MINI_A``
+
+       -  Sends a mini-DiSEqC 22kHz '0' Tone Burst to select satellite-A
+
+    -  .. row 3
+
+       -  .. _`SEC-MINI-B`:
+
+          ``SEC_MINI_B``
+
+       -  Sends a mini-DiSEqC 22kHz '1' Data Burst to select satellite-B
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/fe-diseqc-send-master-cmd.rst b/Documentation/linux_tv/media/dvb/fe-diseqc-send-master-cmd.rst
new file mode 100644
index 000000000000..974a45f632a6
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/fe-diseqc-send-master-cmd.rst
@@ -0,0 +1,78 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _FE_DISEQC_SEND_MASTER_CMD:
+
+*******************************
+ioctl FE_DISEQC_SEND_MASTER_CMD
+*******************************
+
+*man FE_DISEQC_SEND_MASTER_CMD(2)*
+
+Sends a DiSEqC command
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct dvb_diseqc_master_cmd *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <frontend_f_open>`.
+
+``request``
+    FE_DISEQC_SEND_MASTER_CMD
+
+``argp``
+    pointer to struct
+    :ref:`dvb_diseqc_master_cmd <dvb-diseqc-master-cmd>`
+
+
+Description
+===========
+
+Sends a DiSEqC command to the antenna subsystem.
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _dvb-diseqc-master-cmd:
+
+.. flat-table:: struct dvb_diseqc_master_cmd
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  uint8_t
+
+       -  msg[6]
+
+       -  DiSEqC message (framing, address, command, data[3])
+
+    -  .. row 2
+
+       -  uint8_t
+
+       -  msg_len
+
+       -  Length of the DiSEqC message. Valid values are 3 to 6
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/fe-enable-high-lnb-voltage.rst b/Documentation/linux_tv/media/dvb/fe-enable-high-lnb-voltage.rst
new file mode 100644
index 000000000000..207c65a44120
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/fe-enable-high-lnb-voltage.rst
@@ -0,0 +1,58 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _FE_ENABLE_HIGH_LNB_VOLTAGE:
+
+********************************
+ioctl FE_ENABLE_HIGH_LNB_VOLTAGE
+********************************
+
+*man FE_ENABLE_HIGH_LNB_VOLTAGE(2)*
+
+Select output DC level between normal LNBf voltages or higher LNBf
+voltages.
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, unsigned int high )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <frontend_f_open>`.
+
+``request``
+    FE_ENABLE_HIGH_LNB_VOLTAGE
+
+``high``
+    Valid flags:
+
+    -  0 - normal 13V and 18V.
+
+    -  >0 - enables slightly higher voltages instead of 13/18V, in order
+       to compensate for long antenna cables.
+
+
+Description
+===========
+
+Select output DC level between normal LNBf voltages or higher LNBf
+voltages between 0 (normal) or a value grater than 0 for higher
+voltages.
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/fe-get-info.rst b/Documentation/linux_tv/media/dvb/fe-get-info.rst
new file mode 100644
index 000000000000..5ac74c232b12
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/fe-get-info.rst
@@ -0,0 +1,434 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _FE_GET_INFO:
+
+*****************
+ioctl FE_GET_INFO
+*****************
+
+*man FE_GET_INFO(2)*
+
+Query DVB frontend capabilities and returns information about the
+front-end. This call only requires read-only access to the device
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct dvb_frontend_info *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <frontend_f_open>`.
+
+``request``
+    FE_GET_INFO
+
+``argp``
+    pointer to struct struct
+    :ref:`dvb_frontend_info <dvb-frontend-info>`
+
+
+Description
+===========
+
+All DVB frontend devices support the ``FE_GET_INFO`` ioctl. It is used
+to identify kernel devices compatible with this specification and to
+obtain information about driver and hardware capabilities. The ioctl
+takes a pointer to dvb_frontend_info which is filled by the driver.
+When the driver is not compatible with this specification the ioctl
+returns an error.
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _dvb-frontend-info:
+
+.. flat-table:: struct dvb_frontend_info
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  char
+
+       -  name[128]
+
+       -  Name of the frontend
+
+    -  .. row 2
+
+       -  fe_type_t
+
+       -  type
+
+       -  **DEPRECATED**. DVBv3 type. Should not be used on modern programs,
+          as a frontend may have more than one type. So, the DVBv5 API
+          should be used instead to enumerate and select the frontend type.
+
+    -  .. row 3
+
+       -  uint32_t
+
+       -  frequency_min
+
+       -  Minimal frequency supported by the frontend
+
+    -  .. row 4
+
+       -  uint32_t
+
+       -  frequency_max
+
+       -  Maximal frequency supported by the frontend
+
+    -  .. row 5
+
+       -  uint32_t
+
+       -  frequency_stepsize
+
+       -  Frequency step - all frequencies are multiple of this value
+
+    -  .. row 6
+
+       -  uint32_t
+
+       -  frequency_tolerance
+
+       -  Tolerance of the frequency
+
+    -  .. row 7
+
+       -  uint32_t
+
+       -  symbol_rate_min
+
+       -  Minimal symbol rate (for Cable/Satellite systems), in bauds
+
+    -  .. row 8
+
+       -  uint32_t
+
+       -  symbol_rate_max
+
+       -  Maximal symbol rate (for Cable/Satellite systems), in bauds
+
+    -  .. row 9
+
+       -  uint32_t
+
+       -  symbol_rate_tolerance
+
+       -  Maximal symbol rate tolerance, in ppm
+
+    -  .. row 10
+
+       -  uint32_t
+
+       -  notifier_delay
+
+       -  **DEPRECATED**. Not used by any driver.
+
+    -  .. row 11
+
+       -  enum :ref:`fe_caps <fe-caps>`
+
+       -  caps
+
+       -  Capabilities supported by the frontend
+
+
+NOTE: The frequencies are specified in Hz for Terrestrial and Cable
+systems. They're specified in kHz for Satellite systems
+
+
+.. _fe-caps-t:
+
+frontend capabilities
+=====================
+
+Capabilities describe what a frontend can do. Some capabilities are
+supported only on some specific frontend types.
+
+
+.. _fe-caps:
+
+.. flat-table:: enum fe_caps
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ID
+
+       -  Description
+
+    -  .. row 2
+
+       -  .. _`FE-IS-STUPID`:
+
+          ``FE_IS_STUPID``
+
+       -  There's something wrong at the frontend, and it can't report its
+          capabilities
+
+    -  .. row 3
+
+       -  .. _`FE-CAN-INVERSION-AUTO`:
+
+          ``FE_CAN_INVERSION_AUTO``
+
+       -  The frontend is capable of auto-detecting inversion
+
+    -  .. row 4
+
+       -  .. _`FE-CAN-FEC-1-2`:
+
+          ``FE_CAN_FEC_1_2``
+
+       -  The frontend supports FEC 1/2
+
+    -  .. row 5
+
+       -  .. _`FE-CAN-FEC-2-3`:
+
+          ``FE_CAN_FEC_2_3``
+
+       -  The frontend supports FEC 2/3
+
+    -  .. row 6
+
+       -  .. _`FE-CAN-FEC-3-4`:
+
+          ``FE_CAN_FEC_3_4``
+
+       -  The frontend supports FEC 3/4
+
+    -  .. row 7
+
+       -  .. _`FE-CAN-FEC-4-5`:
+
+          ``FE_CAN_FEC_4_5``
+
+       -  The frontend supports FEC 4/5
+
+    -  .. row 8
+
+       -  .. _`FE-CAN-FEC-5-6`:
+
+          ``FE_CAN_FEC_5_6``
+
+       -  The frontend supports FEC 5/6
+
+    -  .. row 9
+
+       -  .. _`FE-CAN-FEC-6-7`:
+
+          ``FE_CAN_FEC_6_7``
+
+       -  The frontend supports FEC 6/7
+
+    -  .. row 10
+
+       -  .. _`FE-CAN-FEC-7-8`:
+
+          ``FE_CAN_FEC_7_8``
+
+       -  The frontend supports FEC 7/8
+
+    -  .. row 11
+
+       -  .. _`FE-CAN-FEC-8-9`:
+
+          ``FE_CAN_FEC_8_9``
+
+       -  The frontend supports FEC 8/9
+
+    -  .. row 12
+
+       -  .. _`FE-CAN-FEC-AUTO`:
+
+          ``FE_CAN_FEC_AUTO``
+
+       -  The frontend can autodetect FEC.
+
+    -  .. row 13
+
+       -  .. _`FE-CAN-QPSK`:
+
+          ``FE_CAN_QPSK``
+
+       -  The frontend supports QPSK modulation
+
+    -  .. row 14
+
+       -  .. _`FE-CAN-QAM-16`:
+
+          ``FE_CAN_QAM_16``
+
+       -  The frontend supports 16-QAM modulation
+
+    -  .. row 15
+
+       -  .. _`FE-CAN-QAM-32`:
+
+          ``FE_CAN_QAM_32``
+
+       -  The frontend supports 32-QAM modulation
+
+    -  .. row 16
+
+       -  .. _`FE-CAN-QAM-64`:
+
+          ``FE_CAN_QAM_64``
+
+       -  The frontend supports 64-QAM modulation
+
+    -  .. row 17
+
+       -  .. _`FE-CAN-QAM-128`:
+
+          ``FE_CAN_QAM_128``
+
+       -  The frontend supports 128-QAM modulation
+
+    -  .. row 18
+
+       -  .. _`FE-CAN-QAM-256`:
+
+          ``FE_CAN_QAM_256``
+
+       -  The frontend supports 256-QAM modulation
+
+    -  .. row 19
+
+       -  .. _`FE-CAN-QAM-AUTO`:
+
+          ``FE_CAN_QAM_AUTO``
+
+       -  The frontend can autodetect modulation
+
+    -  .. row 20
+
+       -  .. _`FE-CAN-TRANSMISSION-MODE-AUTO`:
+
+          ``FE_CAN_TRANSMISSION_MODE_AUTO``
+
+       -  The frontend can autodetect the transmission mode
+
+    -  .. row 21
+
+       -  .. _`FE-CAN-BANDWIDTH-AUTO`:
+
+          ``FE_CAN_BANDWIDTH_AUTO``
+
+       -  The frontend can autodetect the bandwidth
+
+    -  .. row 22
+
+       -  .. _`FE-CAN-GUARD-INTERVAL-AUTO`:
+
+          ``FE_CAN_GUARD_INTERVAL_AUTO``
+
+       -  The frontend can autodetect the guard interval
+
+    -  .. row 23
+
+       -  .. _`FE-CAN-HIERARCHY-AUTO`:
+
+          ``FE_CAN_HIERARCHY_AUTO``
+
+       -  The frontend can autodetect hierarch
+
+    -  .. row 24
+
+       -  .. _`FE-CAN-8VSB`:
+
+          ``FE_CAN_8VSB``
+
+       -  The frontend supports 8-VSB modulation
+
+    -  .. row 25
+
+       -  .. _`FE-CAN-16VSB`:
+
+          ``FE_CAN_16VSB``
+
+       -  The frontend supports 16-VSB modulation
+
+    -  .. row 26
+
+       -  .. _`FE-HAS-EXTENDED-CAPS`:
+
+          ``FE_HAS_EXTENDED_CAPS``
+
+       -  Currently, unused
+
+    -  .. row 27
+
+       -  .. _`FE-CAN-MULTISTREAM`:
+
+          ``FE_CAN_MULTISTREAM``
+
+       -  The frontend supports multistream filtering
+
+    -  .. row 28
+
+       -  .. _`FE-CAN-TURBO-FEC`:
+
+          ``FE_CAN_TURBO_FEC``
+
+       -  The frontend supports turbo FEC modulation
+
+    -  .. row 29
+
+       -  .. _`FE-CAN-2G-MODULATION`:
+
+          ``FE_CAN_2G_MODULATION``
+
+       -  The frontend supports "2nd generation modulation" (DVB-S2/T2)>
+
+    -  .. row 30
+
+       -  .. _`FE-NEEDS-BENDING`:
+
+          ``FE_NEEDS_BENDING``
+
+       -  Not supported anymore, don't use it
+
+    -  .. row 31
+
+       -  .. _`FE-CAN-RECOVER`:
+
+          ``FE_CAN_RECOVER``
+
+       -  The frontend can recover from a cable unplug automatically
+
+    -  .. row 32
+
+       -  .. _`FE-CAN-MUTE-TS`:
+
+          ``FE_CAN_MUTE_TS``
+
+       -  The frontend can stop spurious TS data output
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/fe-get-property.rst b/Documentation/linux_tv/media/dvb/fe-get-property.rst
new file mode 100644
index 000000000000..8a6c5de041e8
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/fe-get-property.rst
@@ -0,0 +1,75 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _FE_GET_PROPERTY:
+
+**************************************
+ioctl FE_SET_PROPERTY, FE_GET_PROPERTY
+**************************************
+
+*man FE_SET_PROPERTY(2)*
+
+FE_GET_PROPERTY
+FE_SET_PROPERTY sets one or more frontend properties.
+FE_GET_PROPERTY returns one or more frontend properties.
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct dtv_properties *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <frontend_f_open>`.
+
+``request``
+    FE_SET_PROPERTY, FE_GET_PROPERTY
+
+``argp``
+    pointer to struct :ref:`dtv_properties <dtv-properties>`
+
+
+Description
+===========
+
+All DVB frontend devices support the ``FE_SET_PROPERTY`` and
+``FE_GET_PROPERTY`` ioctls. The supported properties and statistics
+depends on the delivery system and on the device:
+
+-  ``FE_SET_PROPERTY:``
+
+   -  This ioctl is used to set one or more frontend properties.
+
+   -  This is the basic command to request the frontend to tune into
+      some frequency and to start decoding the digital TV signal.
+
+   -  This call requires read/write access to the device.
+
+   -  At return, the values are updated to reflect the actual parameters
+      used.
+
+-  ``FE_GET_PROPERTY:``
+
+   -  This ioctl is used to get properties and statistics from the
+      frontend.
+
+   -  No properties are changed, and statistics aren't reset.
+
+   -  This call only requires read-only access to the device.
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/fe-read-status.rst b/Documentation/linux_tv/media/dvb/fe-read-status.rst
new file mode 100644
index 000000000000..41396a8f1c3d
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/fe-read-status.rst
@@ -0,0 +1,143 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _FE_READ_STATUS:
+
+********************
+ioctl FE_READ_STATUS
+********************
+
+*man FE_READ_STATUS(2)*
+
+Returns status information about the front-end. This call only requires
+read-only access to the device
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, unsigned int *status )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <frontend_f_open>`.
+
+``request``
+    FE_READ_STATUS
+
+``status``
+    pointer to a bitmask integer filled with the values defined by enum
+    :ref:`fe_status <fe-status>`.
+
+
+Description
+===========
+
+All DVB frontend devices support the ``FE_READ_STATUS`` ioctl. It is
+used to check about the locking status of the frontend after being
+tuned. The ioctl takes a pointer to an integer where the status will be
+written.
+
+NOTE: the size of status is actually sizeof(enum fe_status), with
+varies according with the architecture. This needs to be fixed in the
+future.
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _fe-status-t:
+
+int fe_status
+=============
+
+The fe_status parameter is used to indicate the current state and/or
+state changes of the frontend hardware. It is produced using the enum
+:ref:`fe_status <fe-status>` values on a bitmask
+
+
+.. _fe-status:
+
+.. flat-table:: enum fe_status
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ID
+
+       -  Description
+
+    -  .. row 2
+
+       -  .. _`FE-HAS-SIGNAL`:
+
+          ``FE_HAS_SIGNAL``
+
+       -  The frontend has found something above the noise level
+
+    -  .. row 3
+
+       -  .. _`FE-HAS-CARRIER`:
+
+          ``FE_HAS_CARRIER``
+
+       -  The frontend has found a DVB signal
+
+    -  .. row 4
+
+       -  .. _`FE-HAS-VITERBI`:
+
+          ``FE_HAS_VITERBI``
+
+       -  The frontend FEC inner coding (Viterbi, LDPC or other inner code)
+          is stable
+
+    -  .. row 5
+
+       -  .. _`FE-HAS-SYNC`:
+
+          ``FE_HAS_SYNC``
+
+       -  Synchronization bytes was found
+
+    -  .. row 6
+
+       -  .. _`FE-HAS-LOCK`:
+
+          ``FE_HAS_LOCK``
+
+       -  The DVB were locked and everything is working
+
+    -  .. row 7
+
+       -  .. _`FE-TIMEDOUT`:
+
+          ``FE_TIMEDOUT``
+
+       -  no lock within the last about 2 seconds
+
+    -  .. row 8
+
+       -  .. _`FE-REINIT`:
+
+          ``FE_REINIT``
+
+       -  The frontend was reinitialized, application is recommended to
+          reset DiSEqC, tone and parameters
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/fe-set-frontend-tune-mode.rst b/Documentation/linux_tv/media/dvb/fe-set-frontend-tune-mode.rst
new file mode 100644
index 000000000000..1167d22c2382
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/fe-set-frontend-tune-mode.rst
@@ -0,0 +1,60 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _FE_SET_FRONTEND_TUNE_MODE:
+
+*******************************
+ioctl FE_SET_FRONTEND_TUNE_MODE
+*******************************
+
+*man FE_SET_FRONTEND_TUNE_MODE(2)*
+
+Allow setting tuner mode flags to the frontend.
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, unsigned int flags )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <frontend_f_open>`.
+
+``request``
+    FE_SET_FRONTEND_TUNE_MODE
+
+``flags``
+    Valid flags:
+
+    -  0 - normal tune mode
+
+    -  FE_TUNE_MODE_ONESHOT - When set, this flag will disable any
+       zigzagging or other "normal" tuning behaviour. Additionally,
+       there will be no automatic monitoring of the lock status, and
+       hence no frontend events will be generated. If a frontend device
+       is closed, this flag will be automatically turned off when the
+       device is reopened read-write.
+
+
+Description
+===========
+
+Allow setting tuner mode flags to the frontend, between 0 (normal) or
+FE_TUNE_MODE_ONESHOT mode
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/fe-set-tone.rst b/Documentation/linux_tv/media/dvb/fe-set-tone.rst
new file mode 100644
index 000000000000..f98c4b3b8760
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/fe-set-tone.rst
@@ -0,0 +1,100 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _FE_SET_TONE:
+
+*****************
+ioctl FE_SET_TONE
+*****************
+
+*man FE_SET_TONE(2)*
+
+Sets/resets the generation of the continuous 22kHz tone.
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, enum fe_sec_tone_mode *tone )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <frontend_f_open>`.
+
+``request``
+    FE_SET_TONE
+
+``tone``
+    pointer to enum :ref:`fe_sec_tone_mode <fe-sec-tone-mode>`
+
+
+Description
+===========
+
+This ioctl is used to set the generation of the continuous 22kHz tone.
+This call requires read/write permissions.
+
+Usually, satellite antenna subsystems require that the digital TV device
+to send a 22kHz tone in order to select between high/low band on some
+dual-band LNBf. It is also used to send signals to DiSEqC equipment, but
+this is done using the DiSEqC ioctls.
+
+NOTE: if more than one device is connected to the same antenna, setting
+a tone may interfere on other devices, as they may lose the capability
+of selecting the band. So, it is recommended that applications would
+change to SEC_TONE_OFF when the device is not used.
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _fe-sec-tone-mode-t:
+
+enum fe_sec_tone_mode
+=====================
+
+
+.. _fe-sec-tone-mode:
+
+.. flat-table:: enum fe_sec_tone_mode
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ID
+
+       -  Description
+
+    -  .. row 2
+
+       -  .. _`SEC-TONE-ON`:
+
+          ``SEC_TONE_ON``
+
+       -  Sends a 22kHz tone burst to the antenna
+
+    -  .. row 3
+
+       -  .. _`SEC-TONE-OFF`:
+
+          ``SEC_TONE_OFF``
+
+       -  Don't send a 22kHz tone to the antenna (except if the
+          FE_DISEQC_* ioctls are called)
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/fe-set-voltage.rst b/Documentation/linux_tv/media/dvb/fe-set-voltage.rst
new file mode 100644
index 000000000000..eb4ab28b479a
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/fe-set-voltage.rst
@@ -0,0 +1,68 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _FE_SET_VOLTAGE:
+
+********************
+ioctl FE_SET_VOLTAGE
+********************
+
+*man FE_SET_VOLTAGE(2)*
+
+Allow setting the DC level sent to the antenna subsystem.
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, enum fe_sec_voltage *voltage )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <frontend_f_open>`.
+
+``request``
+    FE_SET_VOLTAGE
+
+``voltage``
+    pointer to enum :ref:`fe_sec_voltage <fe-sec-voltage>`
+
+    Valid values are described at enum
+    :ref:`fe_sec_voltage <fe-sec-voltage>`.
+
+
+Description
+===========
+
+This ioctl allows to set the DC voltage level sent through the antenna
+cable to 13V, 18V or off.
+
+Usually, a satellite antenna subsystems require that the digital TV
+device to send a DC voltage to feed power to the LNBf. Depending on the
+LNBf type, the polarization or the intermediate frequency (IF) of the
+LNBf can controlled by the voltage level. Other devices (for example,
+the ones that implement DISEqC and multipoint LNBf's don't need to
+control the voltage level, provided that either 13V or 18V is sent to
+power up the LNBf.
+
+NOTE: if more than one device is connected to the same antenna, setting
+a voltage level may interfere on other devices, as they may lose the
+capability of setting polarization or IF. So, on those cases, setting
+the voltage to SEC_VOLTAGE_OFF while the device is not is used is
+recommended.
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/fe-type-t.rst b/Documentation/linux_tv/media/dvb/fe-type-t.rst
new file mode 100644
index 000000000000..49fa8090010b
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/fe-type-t.rst
@@ -0,0 +1,100 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _fe-type-t:
+
+*************
+Frontend type
+*************
+
+For historical reasons, frontend types are named by the type of
+modulation used in transmission. The fontend types are given by
+fe_type_t type, defined as:
+
+
+.. _fe-type:
+
+.. flat-table:: Frontend types
+    :header-rows:  1
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  fe_type
+
+       -  Description
+
+       -  :ref:`DTV_DELIVERY_SYSTEM <DTV-DELIVERY-SYSTEM>` equivalent
+          type
+
+    -  .. row 2
+
+       -  .. _`FE-QPSK`:
+
+          ``FE_QPSK``
+
+       -  For DVB-S standard
+
+       -  ``SYS_DVBS``
+
+    -  .. row 3
+
+       -  .. _`FE-QAM`:
+
+          ``FE_QAM``
+
+       -  For DVB-C annex A standard
+
+       -  ``SYS_DVBC_ANNEX_A``
+
+    -  .. row 4
+
+       -  .. _`FE-OFDM`:
+
+          ``FE_OFDM``
+
+       -  For DVB-T standard
+
+       -  ``SYS_DVBT``
+
+    -  .. row 5
+
+       -  .. _`FE-ATSC`:
+
+          ``FE_ATSC``
+
+       -  For ATSC standard (terrestrial) or for DVB-C Annex B (cable) used
+          in US.
+
+       -  ``SYS_ATSC`` (terrestrial) or ``SYS_DVBC_ANNEX_B`` (cable)
+
+
+Newer formats like DVB-S2, ISDB-T, ISDB-S and DVB-T2 are not described
+at the above, as they're supported via the new
+:ref:`FE_GET_PROPERTY/FE_GET_SET_PROPERTY <FE_GET_PROPERTY>`
+ioctl's, using the :ref:`DTV_DELIVERY_SYSTEM <DTV-DELIVERY-SYSTEM>`
+parameter.
+
+In the old days, struct :ref:`dvb_frontend_info <dvb-frontend-info>`
+used to contain ``fe_type_t`` field to indicate the delivery systems,
+filled with either FE_QPSK, FE_QAM, FE_OFDM or FE_ATSC. While this
+is still filled to keep backward compatibility, the usage of this field
+is deprecated, as it can report just one delivery system, but some
+devices support multiple delivery systems. Please use
+:ref:`DTV_ENUM_DELSYS <DTV-ENUM-DELSYS>` instead.
+
+On devices that support multiple delivery systems, struct
+:ref:`dvb_frontend_info <dvb-frontend-info>`::``fe_type_t`` is
+filled with the currently standard, as selected by the last call to
+:ref:`FE_SET_PROPERTY <FE_GET_PROPERTY>` using the
+:ref:`DTV_DELIVERY_SYSTEM <DTV-DELIVERY-SYSTEM>` property.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/fe_property_parameters.rst b/Documentation/linux_tv/media/dvb/fe_property_parameters.rst
new file mode 100644
index 000000000000..cf8514d79a20
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/fe_property_parameters.rst
@@ -0,0 +1,1976 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _fe_property_parameters:
+
+******************************
+Digital TV property parameters
+******************************
+
+
+.. _DTV-UNDEFINED:
+
+DTV_UNDEFINED
+=============
+
+Used internally. A GET/SET operation for it won't change or return
+anything.
+
+
+.. _DTV-TUNE:
+
+DTV_TUNE
+========
+
+Interpret the cache of data, build either a traditional frontend
+tunerequest so we can pass validation in the ``FE_SET_FRONTEND`` ioctl.
+
+
+.. _DTV-CLEAR:
+
+DTV_CLEAR
+=========
+
+Reset a cache of data specific to the frontend here. This does not
+effect hardware.
+
+
+.. _DTV-FREQUENCY:
+
+DTV_FREQUENCY
+=============
+
+Central frequency of the channel.
+
+Notes:
+
+1)For satellite delivery systems, it is measured in kHz. For the other
+ones, it is measured in Hz.
+
+2)For ISDB-T, the channels are usually transmitted with an offset of
+143kHz. E.g. a valid frequency could be 474143 kHz. The stepping is
+bound to the bandwidth of the channel which is 6MHz.
+
+3)As in ISDB-Tsb the channel consists of only one or three segments the
+frequency step is 429kHz, 3*429 respectively. As for ISDB-T the central
+frequency of the channel is expected.
+
+
+.. _DTV-MODULATION:
+
+DTV_MODULATION
+==============
+
+Specifies the frontend modulation type for delivery systems that
+supports more than one modulation type. The modulation can be one of the
+types defined by enum :ref:`fe_modulation <fe-modulation>`.
+
+
+.. _fe-modulation-t:
+
+Modulation property
+-------------------
+
+Most of the digital TV standards currently offers more than one possible
+modulation (sometimes called as "constellation" on some standards). This
+enum contains the values used by the Kernel. Please note that not all
+modulations are supported by a given standard.
+
+
+.. _fe-modulation:
+
+.. flat-table:: enum fe_modulation
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ID
+
+       -  Description
+
+    -  .. row 2
+
+       -  .. _`QPSK`:
+
+          ``QPSK``
+
+       -  QPSK modulation
+
+    -  .. row 3
+
+       -  .. _`QAM-16`:
+
+          ``QAM_16``
+
+       -  16-QAM modulation
+
+    -  .. row 4
+
+       -  .. _`QAM-32`:
+
+          ``QAM_32``
+
+       -  32-QAM modulation
+
+    -  .. row 5
+
+       -  .. _`QAM-64`:
+
+          ``QAM_64``
+
+       -  64-QAM modulation
+
+    -  .. row 6
+
+       -  .. _`QAM-128`:
+
+          ``QAM_128``
+
+       -  128-QAM modulation
+
+    -  .. row 7
+
+       -  .. _`QAM-256`:
+
+          ``QAM_256``
+
+       -  256-QAM modulation
+
+    -  .. row 8
+
+       -  .. _`QAM-AUTO`:
+
+          ``QAM_AUTO``
+
+       -  Autodetect QAM modulation
+
+    -  .. row 9
+
+       -  .. _`VSB-8`:
+
+          ``VSB_8``
+
+       -  8-VSB modulation
+
+    -  .. row 10
+
+       -  .. _`VSB-16`:
+
+          ``VSB_16``
+
+       -  16-VSB modulation
+
+    -  .. row 11
+
+       -  .. _`PSK-8`:
+
+          ``PSK_8``
+
+       -  8-PSK modulation
+
+    -  .. row 12
+
+       -  .. _`APSK-16`:
+
+          ``APSK_16``
+
+       -  16-APSK modulation
+
+    -  .. row 13
+
+       -  .. _`APSK-32`:
+
+          ``APSK_32``
+
+       -  32-APSK modulation
+
+    -  .. row 14
+
+       -  .. _`DQPSK`:
+
+          ``DQPSK``
+
+       -  DQPSK modulation
+
+    -  .. row 15
+
+       -  .. _`QAM-4-NR`:
+
+          ``QAM_4_NR``
+
+       -  4-QAM-NR modulation
+
+
+
+.. _DTV-BANDWIDTH-HZ:
+
+DTV_BANDWIDTH_HZ
+================
+
+Bandwidth for the channel, in HZ.
+
+Possible values: ``1712000``, ``5000000``, ``6000000``, ``7000000``,
+``8000000``, ``10000000``.
+
+Notes:
+
+1) For ISDB-T it should be always 6000000Hz (6MHz)
+
+2) For ISDB-Tsb it can vary depending on the number of connected
+segments
+
+3) Bandwidth doesn't apply for DVB-C transmissions, as the bandwidth for
+DVB-C depends on the symbol rate
+
+4) 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).
+
+5) DVB-T supports 6, 7 and 8MHz.
+
+6) In addition, DVB-T2 supports 1.172, 5 and 10MHz.
+
+
+.. _DTV-INVERSION:
+
+DTV_INVERSION
+=============
+
+Specifies if the frontend should do spectral inversion or not.
+
+
+.. _fe-spectral-inversion-t:
+
+enum fe_modulation: Frontend spectral inversion
+-----------------------------------------------
+
+This parameter 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. If the hardware doesn't
+support, the DVB core will try to lock at the carrier first with
+inversion off. If it fails, it will try to enable inversion.
+
+
+.. _fe-spectral-inversion:
+
+.. flat-table:: enum fe_modulation
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ID
+
+       -  Description
+
+    -  .. row 2
+
+       -  .. _`INVERSION-OFF`:
+
+          ``INVERSION_OFF``
+
+       -  Don't do spectral band inversion.
+
+    -  .. row 3
+
+       -  .. _`INVERSION-ON`:
+
+          ``INVERSION_ON``
+
+       -  Do spectral band inversion.
+
+    -  .. row 4
+
+       -  .. _`INVERSION-AUTO`:
+
+          ``INVERSION_AUTO``
+
+       -  Autodetect spectral band inversion.
+
+
+
+.. _DTV-DISEQC-MASTER:
+
+DTV_DISEQC_MASTER
+=================
+
+Currently not implemented.
+
+
+.. _DTV-SYMBOL-RATE:
+
+DTV_SYMBOL_RATE
+===============
+
+Digital TV symbol rate, in bauds (symbols/second). Used on cable
+standards.
+
+
+.. _DTV-INNER-FEC:
+
+DTV_INNER_FEC
+=============
+
+Used cable/satellite transmissions. The acceptable values are:
+
+
+.. _fe-code-rate-t:
+
+enum fe_code_rate: type of the Forward Error Correction.
+--------------------------------------------------------
+
+
+.. _fe-code-rate:
+
+.. flat-table:: enum fe_code_rate
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ID
+
+       -  Description
+
+    -  .. row 2
+
+       -  .. _`FEC-NONE`:
+
+          ``FEC_NONE``
+
+       -  No Forward Error Correction Code
+
+    -  .. row 3
+
+       -  .. _`FEC-AUTO`:
+
+          ``FEC_AUTO``
+
+       -  Autodetect Error Correction Code
+
+    -  .. row 4
+
+       -  .. _`FEC-1-2`:
+
+          ``FEC_1_2``
+
+       -  Forward Error Correction Code 1/2
+
+    -  .. row 5
+
+       -  .. _`FEC-2-3`:
+
+          ``FEC_2_3``
+
+       -  Forward Error Correction Code 2/3
+
+    -  .. row 6
+
+       -  .. _`FEC-3-4`:
+
+          ``FEC_3_4``
+
+       -  Forward Error Correction Code 3/4
+
+    -  .. row 7
+
+       -  .. _`FEC-4-5`:
+
+          ``FEC_4_5``
+
+       -  Forward Error Correction Code 4/5
+
+    -  .. row 8
+
+       -  .. _`FEC-5-6`:
+
+          ``FEC_5_6``
+
+       -  Forward Error Correction Code 5/6
+
+    -  .. row 9
+
+       -  .. _`FEC-6-7`:
+
+          ``FEC_6_7``
+
+       -  Forward Error Correction Code 6/7
+
+    -  .. row 10
+
+       -  .. _`FEC-7-8`:
+
+          ``FEC_7_8``
+
+       -  Forward Error Correction Code 7/8
+
+    -  .. row 11
+
+       -  .. _`FEC-8-9`:
+
+          ``FEC_8_9``
+
+       -  Forward Error Correction Code 8/9
+
+    -  .. row 12
+
+       -  .. _`FEC-9-10`:
+
+          ``FEC_9_10``
+
+       -  Forward Error Correction Code 9/10
+
+    -  .. row 13
+
+       -  .. _`FEC-2-5`:
+
+          ``FEC_2_5``
+
+       -  Forward Error Correction Code 2/5
+
+    -  .. row 14
+
+       -  .. _`FEC-3-5`:
+
+          ``FEC_3_5``
+
+       -  Forward Error Correction Code 3/5
+
+
+
+.. _DTV-VOLTAGE:
+
+DTV_VOLTAGE
+===========
+
+The voltage is usually used with non-DiSEqC capable LNBs to switch the
+polarzation (horizontal/vertical). When using DiSEqC epuipment this
+voltage has to be switched consistently to the DiSEqC commands as
+described in the DiSEqC spec.
+
+
+.. _fe-sec-voltage:
+
+.. flat-table:: enum fe_sec_voltage
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ID
+
+       -  Description
+
+    -  .. row 2
+
+       -  .. _`SEC-VOLTAGE-13`:
+
+          ``SEC_VOLTAGE_13``
+
+       -  Set DC voltage level to 13V
+
+    -  .. row 3
+
+       -  .. _`SEC-VOLTAGE-18`:
+
+          ``SEC_VOLTAGE_18``
+
+       -  Set DC voltage level to 18V
+
+    -  .. row 4
+
+       -  .. _`SEC-VOLTAGE-OFF`:
+
+          ``SEC_VOLTAGE_OFF``
+
+       -  Don't send any voltage to the antenna
+
+
+
+.. _DTV-TONE:
+
+DTV_TONE
+========
+
+Currently not used.
+
+
+.. _DTV-PILOT:
+
+DTV_PILOT
+=========
+
+Sets DVB-S2 pilot
+
+
+.. _fe-pilot-t:
+
+fe_pilot type
+-------------
+
+
+.. _fe-pilot:
+
+.. flat-table:: enum fe_pilot
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ID
+
+       -  Description
+
+    -  .. row 2
+
+       -  .. _`PILOT-ON`:
+
+          ``PILOT_ON``
+
+       -  Pilot tones enabled
+
+    -  .. row 3
+
+       -  .. _`PILOT-OFF`:
+
+          ``PILOT_OFF``
+
+       -  Pilot tones disabled
+
+    -  .. row 4
+
+       -  .. _`PILOT-AUTO`:
+
+          ``PILOT_AUTO``
+
+       -  Autodetect pilot tones
+
+
+
+.. _DTV-ROLLOFF:
+
+DTV_ROLLOFF
+===========
+
+Sets DVB-S2 rolloff
+
+
+.. _fe-rolloff-t:
+
+fe_rolloff type
+---------------
+
+
+.. _fe-rolloff:
+
+.. flat-table:: enum fe_rolloff
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ID
+
+       -  Description
+
+    -  .. row 2
+
+       -  .. _`ROLLOFF-35`:
+
+          ``ROLLOFF_35``
+
+       -  Roloff factor: α=35%
+
+    -  .. row 3
+
+       -  .. _`ROLLOFF-20`:
+
+          ``ROLLOFF_20``
+
+       -  Roloff factor: α=20%
+
+    -  .. row 4
+
+       -  .. _`ROLLOFF-25`:
+
+          ``ROLLOFF_25``
+
+       -  Roloff factor: α=25%
+
+    -  .. row 5
+
+       -  .. _`ROLLOFF-AUTO`:
+
+          ``ROLLOFF_AUTO``
+
+       -  Auto-detect the roloff factor.
+
+
+
+.. _DTV-DISEQC-SLAVE-REPLY:
+
+DTV_DISEQC_SLAVE_REPLY
+======================
+
+Currently not implemented.
+
+
+.. _DTV-FE-CAPABILITY-COUNT:
+
+DTV_FE_CAPABILITY_COUNT
+=======================
+
+Currently not implemented.
+
+
+.. _DTV-FE-CAPABILITY:
+
+DTV_FE_CAPABILITY
+=================
+
+Currently not implemented.
+
+
+.. _DTV-DELIVERY-SYSTEM:
+
+DTV_DELIVERY_SYSTEM
+===================
+
+Specifies the type of Delivery system
+
+
+.. _fe-delivery-system-t:
+
+fe_delivery_system type
+-----------------------
+
+Possible values:
+
+
+.. _fe-delivery-system:
+
+.. flat-table:: enum fe_delivery_system
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ID
+
+       -  Description
+
+    -  .. row 2
+
+       -  .. _`SYS-UNDEFINED`:
+
+          ``SYS_UNDEFINED``
+
+       -  Undefined standard. Generally, indicates an error
+
+    -  .. row 3
+
+       -  .. _`SYS-DVBC-ANNEX-A`:
+
+          ``SYS_DVBC_ANNEX_A``
+
+       -  Cable TV: DVB-C following ITU-T J.83 Annex A spec
+
+    -  .. row 4
+
+       -  .. _`SYS-DVBC-ANNEX-B`:
+
+          ``SYS_DVBC_ANNEX_B``
+
+       -  Cable TV: DVB-C following ITU-T J.83 Annex B spec (ClearQAM)
+
+    -  .. row 5
+
+       -  .. _`SYS-DVBC-ANNEX-C`:
+
+          ``SYS_DVBC_ANNEX_C``
+
+       -  Cable TV: DVB-C following ITU-T J.83 Annex C spec
+
+    -  .. row 6
+
+       -  .. _`SYS-ISDBC`:
+
+          ``SYS_ISDBC``
+
+       -  Cable TV: ISDB-C (no drivers yet)
+
+    -  .. row 7
+
+       -  .. _`SYS-DVBT`:
+
+          ``SYS_DVBT``
+
+       -  Terrestral TV: DVB-T
+
+    -  .. row 8
+
+       -  .. _`SYS-DVBT2`:
+
+          ``SYS_DVBT2``
+
+       -  Terrestral TV: DVB-T2
+
+    -  .. row 9
+
+       -  .. _`SYS-ISDBT`:
+
+          ``SYS_ISDBT``
+
+       -  Terrestral TV: ISDB-T
+
+    -  .. row 10
+
+       -  .. _`SYS-ATSC`:
+
+          ``SYS_ATSC``
+
+       -  Terrestral TV: ATSC
+
+    -  .. row 11
+
+       -  .. _`SYS-ATSCMH`:
+
+          ``SYS_ATSCMH``
+
+       -  Terrestral TV (mobile): ATSC-M/H
+
+    -  .. row 12
+
+       -  .. _`SYS-DTMB`:
+
+          ``SYS_DTMB``
+
+       -  Terrestrial TV: DTMB
+
+    -  .. row 13
+
+       -  .. _`SYS-DVBS`:
+
+          ``SYS_DVBS``
+
+       -  Satellite TV: DVB-S
+
+    -  .. row 14
+
+       -  .. _`SYS-DVBS2`:
+
+          ``SYS_DVBS2``
+
+       -  Satellite TV: DVB-S2
+
+    -  .. row 15
+
+       -  .. _`SYS-TURBO`:
+
+          ``SYS_TURBO``
+
+       -  Satellite TV: DVB-S Turbo
+
+    -  .. row 16
+
+       -  .. _`SYS-ISDBS`:
+
+          ``SYS_ISDBS``
+
+       -  Satellite TV: ISDB-S
+
+    -  .. row 17
+
+       -  .. _`SYS-DAB`:
+
+          ``SYS_DAB``
+
+       -  Digital audio: DAB (not fully supported)
+
+    -  .. row 18
+
+       -  .. _`SYS-DSS`:
+
+          ``SYS_DSS``
+
+       -  Satellite TV:"DSS (not fully supported)
+
+    -  .. row 19
+
+       -  .. _`SYS-CMMB`:
+
+          ``SYS_CMMB``
+
+       -  Terrestral TV (mobile):CMMB (not fully supported)
+
+    -  .. row 20
+
+       -  .. _`SYS-DVBH`:
+
+          ``SYS_DVBH``
+
+       -  Terrestral TV (mobile): DVB-H (standard deprecated)
+
+
+
+.. _DTV-ISDBT-PARTIAL-RECEPTION:
+
+DTV_ISDBT_PARTIAL_RECEPTION
+===========================
+
+If ``DTV_ISDBT_SOUND_BROADCASTING`` is '0' this bit-field represents
+whether the channel is in partial reception mode or not.
+
+If '1' ``DTV_ISDBT_LAYERA_*`` values are assigned to the center segment
+and ``DTV_ISDBT_LAYERA_SEGMENT_COUNT`` has to be '1'.
+
+If in addition ``DTV_ISDBT_SOUND_BROADCASTING`` is '1'
+``DTV_ISDBT_PARTIAL_RECEPTION`` represents whether this ISDB-Tsb channel
+is consisting of one segment and layer or three segments and two layers.
+
+Possible values: 0, 1, -1 (AUTO)
+
+
+.. _DTV-ISDBT-SOUND-BROADCASTING:
+
+DTV_ISDBT_SOUND_BROADCASTING
+============================
+
+This field represents whether the other DTV_ISDBT_*-parameters are
+referring to an ISDB-T and an ISDB-Tsb channel. (See also
+``DTV_ISDBT_PARTIAL_RECEPTION``).
+
+Possible values: 0, 1, -1 (AUTO)
+
+
+.. _DTV-ISDBT-SB-SUBCHANNEL-ID:
+
+DTV_ISDBT_SB_SUBCHANNEL_ID
+==========================
+
+This field only applies if ``DTV_ISDBT_SOUND_BROADCASTING`` is '1'.
+
+(Note of the author: This might not be the correct description of the
+``SUBCHANNEL-ID`` in all details, but it is my understanding of the
+technical background needed to program a device)
+
+An ISDB-Tsb channel (1 or 3 segments) can be broadcasted alone or in a
+set of connected ISDB-Tsb channels. In this set of channels every
+channel can be received independently. The number of connected ISDB-Tsb
+segment can vary, e.g. depending on the frequency spectrum bandwidth
+available.
+
+Example: Assume 8 ISDB-Tsb connected segments are broadcasted. The
+broadcaster has several possibilities to put those channels in the air:
+Assuming a normal 13-segment ISDB-T spectrum he can align the 8 segments
+from position 1-8 to 5-13 or anything in between.
+
+The underlying layer of segments are subchannels: each segment is
+consisting of several subchannels with a predefined IDs. A sub-channel
+is used to help the demodulator to synchronize on the channel.
+
+An ISDB-T channel is always centered over all sub-channels. As for the
+example above, in ISDB-Tsb it is no longer as simple as that.
+
+``The DTV_ISDBT_SB_SUBCHANNEL_ID`` parameter is used to give the
+sub-channel ID of the segment to be demodulated.
+
+Possible values: 0 .. 41, -1 (AUTO)
+
+
+.. _DTV-ISDBT-SB-SEGMENT-IDX:
+
+DTV_ISDBT_SB_SEGMENT_IDX
+========================
+
+This field only applies if ``DTV_ISDBT_SOUND_BROADCASTING`` is '1'.
+
+``DTV_ISDBT_SB_SEGMENT_IDX`` gives the index of the segment to be
+demodulated for an ISDB-Tsb channel where several of them are
+transmitted in the connected manner.
+
+Possible values: 0 .. ``DTV_ISDBT_SB_SEGMENT_COUNT`` - 1
+
+Note: This value cannot be determined by an automatic channel search.
+
+
+.. _DTV-ISDBT-SB-SEGMENT-COUNT:
+
+DTV_ISDBT_SB_SEGMENT_COUNT
+==========================
+
+This field only applies if ``DTV_ISDBT_SOUND_BROADCASTING`` is '1'.
+
+``DTV_ISDBT_SB_SEGMENT_COUNT`` gives the total count of connected
+ISDB-Tsb channels.
+
+Possible values: 1 .. 13
+
+Note: This value cannot be determined by an automatic channel search.
+
+
+.. _isdb-hierq-layers:
+
+DTV-ISDBT-LAYER* parameters
+===========================
+
+ISDB-T channels can be coded hierarchically. As opposed to DVB-T in
+ISDB-T hierarchical layers can be decoded simultaneously. For that
+reason a ISDB-T demodulator has 3 Viterbi and 3 Reed-Solomon decoders.
+
+ISDB-T has 3 hierarchical layers which each can use a part of the
+available segments. The total number of segments over all layers has to
+13 in ISDB-T.
+
+There are 3 parameter sets, for Layers A, B and C.
+
+
+.. _DTV-ISDBT-LAYER-ENABLED:
+
+DTV_ISDBT_LAYER_ENABLED
+-----------------------
+
+Hierarchical reception in ISDB-T is achieved by enabling or disabling
+layers in the decoding process. Setting all bits of
+``DTV_ISDBT_LAYER_ENABLED`` to '1' forces all layers (if applicable) to
+be demodulated. This is the default.
+
+If the channel is in the partial reception mode
+(``DTV_ISDBT_PARTIAL_RECEPTION`` = 1) the central segment can be decoded
+independently of the other 12 segments. In that mode layer A has to have
+a ``SEGMENT_COUNT`` of 1.
+
+In ISDB-Tsb only layer A is used, it can be 1 or 3 in ISDB-Tsb according
+to ``DTV_ISDBT_PARTIAL_RECEPTION``. ``SEGMENT_COUNT`` must be filled
+accordingly.
+
+Possible values: 0x1, 0x2, 0x4 (|-able)
+
+``DTV_ISDBT_LAYER_ENABLED[0:0]`` - layer A
+
+``DTV_ISDBT_LAYER_ENABLED[1:1]`` - layer B
+
+``DTV_ISDBT_LAYER_ENABLED[2:2]`` - layer C
+
+``DTV_ISDBT_LAYER_ENABLED[31:3]`` unused
+
+
+.. _DTV-ISDBT-LAYER-FEC:
+
+DTV_ISDBT_LAYER*_FEC
+--------------------
+
+Possible values: ``FEC_AUTO``, ``FEC_1_2``, ``FEC_2_3``, ``FEC_3_4``,
+``FEC_5_6``, ``FEC_7_8``
+
+
+.. _DTV-ISDBT-LAYER-MODULATION:
+
+DTV_ISDBT_LAYER*_MODULATION
+---------------------------
+
+Possible values: ``QAM_AUTO``, QP\ ``SK, 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``.
+
+
+.. _DTV-ISDBT-LAYER-SEGMENT-COUNT:
+
+DTV_ISDBT_LAYER*_SEGMENT_COUNT
+------------------------------
+
+Possible values: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, -1 (AUTO)
+
+Note: Truth table for ``DTV_ISDBT_SOUND_BROADCASTING`` and
+``DTV_ISDBT_PARTIAL_RECEPTION`` and ``LAYER`` *_SEGMENT_COUNT
+
+
+.. _isdbt-layer_seg-cnt-table:
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  PR
+
+       -  SB
+
+       -  Layer A width
+
+       -  Layer B width
+
+       -  Layer C width
+
+       -  total width
+
+    -  .. row 2
+
+       -  0
+
+       -  0
+
+       -  1 .. 13
+
+       -  1 .. 13
+
+       -  1 .. 13
+
+       -  13
+
+    -  .. row 3
+
+       -  1
+
+       -  0
+
+       -  1
+
+       -  1 .. 13
+
+       -  1 .. 13
+
+       -  13
+
+    -  .. row 4
+
+       -  0
+
+       -  1
+
+       -  1
+
+       -  0
+
+       -  0
+
+       -  1
+
+    -  .. row 5
+
+       -  1
+
+       -  1
+
+       -  1
+
+       -  2
+
+       -  0
+
+       -  13
+
+
+
+.. _DTV-ISDBT-LAYER-TIME-INTERLEAVING:
+
+DTV_ISDBT_LAYER*_TIME_INTERLEAVING
+----------------------------------
+
+Valid values: 0, 1, 2, 4, -1 (AUTO)
+
+when DTV_ISDBT_SOUND_BROADCASTING is active, value 8 is also valid.
+
+Note: The real time interleaving length depends on the mode (fft-size).
+The values here are referring to what can be found in the
+TMCC-structure, as shown in the table below.
+
+
+.. _isdbt-layer-interleaving-table:
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  DTV_ISDBT_LAYER*_TIME_INTERLEAVING
+
+       -  Mode 1 (2K FFT)
+
+       -  Mode 2 (4K FFT)
+
+       -  Mode 3 (8K FFT)
+
+    -  .. row 2
+
+       -  0
+
+       -  0
+
+       -  0
+
+       -  0
+
+    -  .. row 3
+
+       -  1
+
+       -  4
+
+       -  2
+
+       -  1
+
+    -  .. row 4
+
+       -  2
+
+       -  8
+
+       -  4
+
+       -  2
+
+    -  .. row 5
+
+       -  4
+
+       -  16
+
+       -  8
+
+       -  4
+
+
+
+.. _DTV-ATSCMH-FIC-VER:
+
+DTV_ATSCMH_FIC_VER
+------------------
+
+Version number of the FIC (Fast Information Channel) signaling data.
+
+FIC is used for relaying information to allow rapid service acquisition
+by the receiver.
+
+Possible values: 0, 1, 2, 3, ..., 30, 31
+
+
+.. _DTV-ATSCMH-PARADE-ID:
+
+DTV_ATSCMH_PARADE_ID
+--------------------
+
+Parade identification number
+
+A parade is a collection of up to eight MH groups, conveying one or two
+ensembles.
+
+Possible values: 0, 1, 2, 3, ..., 126, 127
+
+
+.. _DTV-ATSCMH-NOG:
+
+DTV_ATSCMH_NOG
+--------------
+
+Number of MH groups per MH subframe for a designated parade.
+
+Possible values: 1, 2, 3, 4, 5, 6, 7, 8
+
+
+.. _DTV-ATSCMH-TNOG:
+
+DTV_ATSCMH_TNOG
+---------------
+
+Total number of MH groups including all MH groups belonging to all MH
+parades in one MH subframe.
+
+Possible values: 0, 1, 2, 3, ..., 30, 31
+
+
+.. _DTV-ATSCMH-SGN:
+
+DTV_ATSCMH_SGN
+--------------
+
+Start group number.
+
+Possible values: 0, 1, 2, 3, ..., 14, 15
+
+
+.. _DTV-ATSCMH-PRC:
+
+DTV_ATSCMH_PRC
+--------------
+
+Parade repetition cycle.
+
+Possible values: 1, 2, 3, 4, 5, 6, 7, 8
+
+
+.. _DTV-ATSCMH-RS-FRAME-MODE:
+
+DTV_ATSCMH_RS_FRAME_MODE
+------------------------
+
+Reed Solomon (RS) frame mode.
+
+Possible values are:
+
+
+.. _atscmh-rs-frame-mode:
+
+.. flat-table:: enum atscmh_rs_frame_mode
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ID
+
+       -  Description
+
+    -  .. row 2
+
+       -  .. _`ATSCMH-RSFRAME-PRI-ONLY`:
+
+          ``ATSCMH_RSFRAME_PRI_ONLY``
+
+       -  Single Frame: There is only a primary RS Frame for all Group
+          Regions.
+
+    -  .. row 3
+
+       -  .. _`ATSCMH-RSFRAME-PRI-SEC`:
+
+          ``ATSCMH_RSFRAME_PRI_SEC``
+
+       -  Dual Frame: There are two separate RS Frames: Primary RS Frame for
+          Group Region A and B and Secondary RS Frame for Group Region C and
+          D.
+
+
+
+.. _DTV-ATSCMH-RS-FRAME-ENSEMBLE:
+
+DTV_ATSCMH_RS_FRAME_ENSEMBLE
+----------------------------
+
+Reed Solomon(RS) frame ensemble.
+
+Possible values are:
+
+
+.. _atscmh-rs-frame-ensemble:
+
+.. flat-table:: enum atscmh_rs_frame_ensemble
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ID
+
+       -  Description
+
+    -  .. row 2
+
+       -  .. _`ATSCMH-RSFRAME-ENS-PRI`:
+
+          ``ATSCMH_RSFRAME_ENS_PRI``
+
+       -  Primary Ensemble.
+
+    -  .. row 3
+
+       -  .. _`ATSCMH-RSFRAME-ENS-SEC`:
+
+          ``AATSCMH_RSFRAME_PRI_SEC``
+
+       -  Secondary Ensemble.
+
+    -  .. row 4
+
+       -  .. _`ATSCMH-RSFRAME-RES`:
+
+          ``AATSCMH_RSFRAME_RES``
+
+       -  Reserved. Shouldn't be used.
+
+
+
+.. _DTV-ATSCMH-RS-CODE-MODE-PRI:
+
+DTV_ATSCMH_RS_CODE_MODE_PRI
+---------------------------
+
+Reed Solomon (RS) code mode (primary).
+
+Possible values are:
+
+
+.. _atscmh-rs-code-mode:
+
+.. flat-table:: enum atscmh_rs_code_mode
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ID
+
+       -  Description
+
+    -  .. row 2
+
+       -  .. _`ATSCMH-RSCODE-211-187`:
+
+          ``ATSCMH_RSCODE_211_187``
+
+       -  Reed Solomon code (211,187).
+
+    -  .. row 3
+
+       -  .. _`ATSCMH-RSCODE-223-187`:
+
+          ``ATSCMH_RSCODE_223_187``
+
+       -  Reed Solomon code (223,187).
+
+    -  .. row 4
+
+       -  .. _`ATSCMH-RSCODE-235-187`:
+
+          ``ATSCMH_RSCODE_235_187``
+
+       -  Reed Solomon code (235,187).
+
+    -  .. row 5
+
+       -  .. _`ATSCMH-RSCODE-RES`:
+
+          ``ATSCMH_RSCODE_RES``
+
+       -  Reserved. Shouldn't be used.
+
+
+
+.. _DTV-ATSCMH-RS-CODE-MODE-SEC:
+
+DTV_ATSCMH_RS_CODE_MODE_SEC
+---------------------------
+
+Reed Solomon (RS) code mode (secondary).
+
+Possible values are the same as documented on enum
+:ref:`atscmh_rs_code_mode <atscmh-rs-code-mode>`:
+
+
+.. _DTV-ATSCMH-SCCC-BLOCK-MODE:
+
+DTV_ATSCMH_SCCC_BLOCK_MODE
+--------------------------
+
+Series Concatenated Convolutional Code Block Mode.
+
+Possible values are:
+
+
+.. _atscmh-sccc-block-mode:
+
+.. flat-table:: enum atscmh_scc_block_mode
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ID
+
+       -  Description
+
+    -  .. row 2
+
+       -  .. _`ATSCMH-SCCC-BLK-SEP`:
+
+          ``ATSCMH_SCCC_BLK_SEP``
+
+       -  Separate SCCC: the SCCC outer code mode shall be set independently
+          for each Group Region (A, B, C, D)
+
+    -  .. row 3
+
+       -  .. _`ATSCMH-SCCC-BLK-COMB`:
+
+          ``ATSCMH_SCCC_BLK_COMB``
+
+       -  Combined SCCC: all four Regions shall have the same SCCC outer
+          code mode.
+
+    -  .. row 4
+
+       -  .. _`ATSCMH-SCCC-BLK-RES`:
+
+          ``ATSCMH_SCCC_BLK_RES``
+
+       -  Reserved. Shouldn't be used.
+
+
+
+.. _DTV-ATSCMH-SCCC-CODE-MODE-A:
+
+DTV_ATSCMH_SCCC_CODE_MODE_A
+---------------------------
+
+Series Concatenated Convolutional Code Rate.
+
+Possible values are:
+
+
+.. _atscmh-sccc-code-mode:
+
+.. flat-table:: enum atscmh_sccc_code_mode
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ID
+
+       -  Description
+
+    -  .. row 2
+
+       -  .. _`ATSCMH-SCCC-CODE-HLF`:
+
+          ``ATSCMH_SCCC_CODE_HLF``
+
+       -  The outer code rate of a SCCC Block is 1/2 rate.
+
+    -  .. row 3
+
+       -  .. _`ATSCMH-SCCC-CODE-QTR`:
+
+          ``ATSCMH_SCCC_CODE_QTR``
+
+       -  The outer code rate of a SCCC Block is 1/4 rate.
+
+    -  .. row 4
+
+       -  .. _`ATSCMH-SCCC-CODE-RES`:
+
+          ``ATSCMH_SCCC_CODE_RES``
+
+       -  to be documented.
+
+
+
+.. _DTV-ATSCMH-SCCC-CODE-MODE-B:
+
+DTV_ATSCMH_SCCC_CODE_MODE_B
+---------------------------
+
+Series Concatenated Convolutional Code Rate.
+
+Possible values are the same as documented on enum
+:ref:`atscmh_sccc_code_mode <atscmh-sccc-code-mode>`.
+
+
+.. _DTV-ATSCMH-SCCC-CODE-MODE-C:
+
+DTV_ATSCMH_SCCC_CODE_MODE_C
+---------------------------
+
+Series Concatenated Convolutional Code Rate.
+
+Possible values are the same as documented on enum
+:ref:`atscmh_sccc_code_mode <atscmh-sccc-code-mode>`.
+
+
+.. _DTV-ATSCMH-SCCC-CODE-MODE-D:
+
+DTV_ATSCMH_SCCC_CODE_MODE_D
+---------------------------
+
+Series Concatenated Convolutional Code Rate.
+
+Possible values are the same as documented on enum
+:ref:`atscmh_sccc_code_mode <atscmh-sccc-code-mode>`.
+
+
+.. _DTV-API-VERSION:
+
+DTV_API_VERSION
+===============
+
+Returns the major/minor version of the DVB API
+
+
+.. _DTV-CODE-RATE-HP:
+
+DTV_CODE_RATE_HP
+================
+
+Used on terrestrial transmissions. The acceptable values are the ones
+described at :ref:`fe_transmit_mode_t <fe-transmit-mode-t>`.
+
+
+.. _DTV-CODE-RATE-LP:
+
+DTV_CODE_RATE_LP
+================
+
+Used on terrestrial transmissions. The acceptable values are the ones
+described at :ref:`fe_transmit_mode_t <fe-transmit-mode-t>`.
+
+
+.. _DTV-GUARD-INTERVAL:
+
+DTV_GUARD_INTERVAL
+==================
+
+Possible values are:
+
+
+.. _fe-guard-interval-t:
+
+Modulation guard interval
+-------------------------
+
+
+.. _fe-guard-interval:
+
+.. flat-table:: enum fe_guard_interval
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ID
+
+       -  Description
+
+    -  .. row 2
+
+       -  .. _`GUARD-INTERVAL-AUTO`:
+
+          ``GUARD_INTERVAL_AUTO``
+
+       -  Autodetect the guard interval
+
+    -  .. row 3
+
+       -  .. _`GUARD-INTERVAL-1-128`:
+
+          ``GUARD_INTERVAL_1_128``
+
+       -  Guard interval 1/128
+
+    -  .. row 4
+
+       -  .. _`GUARD-INTERVAL-1-32`:
+
+          ``GUARD_INTERVAL_1_32``
+
+       -  Guard interval 1/32
+
+    -  .. row 5
+
+       -  .. _`GUARD-INTERVAL-1-16`:
+
+          ``GUARD_INTERVAL_1_16``
+
+       -  Guard interval 1/16
+
+    -  .. row 6
+
+       -  .. _`GUARD-INTERVAL-1-8`:
+
+          ``GUARD_INTERVAL_1_8``
+
+       -  Guard interval 1/8
+
+    -  .. row 7
+
+       -  .. _`GUARD-INTERVAL-1-4`:
+
+          ``GUARD_INTERVAL_1_4``
+
+       -  Guard interval 1/4
+
+    -  .. row 8
+
+       -  .. _`GUARD-INTERVAL-19-128`:
+
+          ``GUARD_INTERVAL_19_128``
+
+       -  Guard interval 19/128
+
+    -  .. row 9
+
+       -  .. _`GUARD-INTERVAL-19-256`:
+
+          ``GUARD_INTERVAL_19_256``
+
+       -  Guard interval 19/256
+
+    -  .. row 10
+
+       -  .. _`GUARD-INTERVAL-PN420`:
+
+          ``GUARD_INTERVAL_PN420``
+
+       -  PN length 420 (1/4)
+
+    -  .. row 11
+
+       -  .. _`GUARD-INTERVAL-PN595`:
+
+          ``GUARD_INTERVAL_PN595``
+
+       -  PN length 595 (1/6)
+
+    -  .. row 12
+
+       -  .. _`GUARD-INTERVAL-PN945`:
+
+          ``GUARD_INTERVAL_PN945``
+
+       -  PN length 945 (1/9)
+
+
+Notes:
+
+1) If ``DTV_GUARD_INTERVAL`` is set the ``GUARD_INTERVAL_AUTO`` the
+hardware will try to find the correct guard interval (if capable) and
+will use TMCC to fill in the missing parameters.
+
+2) Intervals 1/128, 19/128 and 19/256 are used only for DVB-T2 at
+present
+
+3) DTMB specifies PN420, PN595 and PN945.
+
+
+.. _DTV-TRANSMISSION-MODE:
+
+DTV_TRANSMISSION_MODE
+=====================
+
+Specifies the number of carriers used by the standard. This is used only
+on OFTM-based standards, e. g. DVB-T/T2, ISDB-T, DTMB
+
+
+.. _fe-transmit-mode-t:
+
+enum fe_transmit_mode: Number of carriers per channel
+-----------------------------------------------------
+
+
+.. _fe-transmit-mode:
+
+.. flat-table:: enum fe_transmit_mode
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ID
+
+       -  Description
+
+    -  .. row 2
+
+       -  .. _`TRANSMISSION-MODE-AUTO`:
+
+          ``TRANSMISSION_MODE_AUTO``
+
+       -  Autodetect transmission mode. The hardware will try to find the
+          correct FFT-size (if capable) to fill in the missing parameters.
+
+    -  .. row 3
+
+       -  .. _`TRANSMISSION-MODE-1K`:
+
+          ``TRANSMISSION_MODE_1K``
+
+       -  Transmission mode 1K
+
+    -  .. row 4
+
+       -  .. _`TRANSMISSION-MODE-2K`:
+
+          ``TRANSMISSION_MODE_2K``
+
+       -  Transmission mode 2K
+
+    -  .. row 5
+
+       -  .. _`TRANSMISSION-MODE-8K`:
+
+          ``TRANSMISSION_MODE_8K``
+
+       -  Transmission mode 8K
+
+    -  .. row 6
+
+       -  .. _`TRANSMISSION-MODE-4K`:
+
+          ``TRANSMISSION_MODE_4K``
+
+       -  Transmission mode 4K
+
+    -  .. row 7
+
+       -  .. _`TRANSMISSION-MODE-16K`:
+
+          ``TRANSMISSION_MODE_16K``
+
+       -  Transmission mode 16K
+
+    -  .. row 8
+
+       -  .. _`TRANSMISSION-MODE-32K`:
+
+          ``TRANSMISSION_MODE_32K``
+
+       -  Transmission mode 32K
+
+    -  .. row 9
+
+       -  .. _`TRANSMISSION-MODE-C1`:
+
+          ``TRANSMISSION_MODE_C1``
+
+       -  Single Carrier (C=1) transmission mode (DTMB)
+
+    -  .. row 10
+
+       -  .. _`TRANSMISSION-MODE-C3780`:
+
+          ``TRANSMISSION_MODE_C3780``
+
+       -  Multi Carrier (C=3780) transmission mode (DTMB)
+
+
+Notes:
+
+1) ISDB-T supports three carrier/symbol-size: 8K, 4K, 2K. It is called
+'mode' in the standard: Mode 1 is 2K, mode 2 is 4K, mode 3 is 8K
+
+2) If ``DTV_TRANSMISSION_MODE`` is set the ``TRANSMISSION_MODE_AUTO``
+the hardware will try to find the correct FFT-size (if capable) and will
+use TMCC to fill in the missing parameters.
+
+3) DVB-T specifies 2K and 8K as valid sizes.
+
+4) DVB-T2 specifies 1K, 2K, 4K, 8K, 16K and 32K.
+
+5) DTMB specifies C1 and C3780.
+
+
+.. _DTV-HIERARCHY:
+
+DTV_HIERARCHY
+=============
+
+Frontend hierarchy
+
+
+.. _fe-hierarchy-t:
+
+Frontend hierarchy
+------------------
+
+
+.. _fe-hierarchy:
+
+.. flat-table:: enum fe_hierarchy
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ID
+
+       -  Description
+
+    -  .. row 2
+
+       -  .. _`HIERARCHY-NONE`:
+
+          ``HIERARCHY_NONE``
+
+       -  No hierarchy
+
+    -  .. row 3
+
+       -  .. _`HIERARCHY-AUTO`:
+
+          ``HIERARCHY_AUTO``
+
+       -  Autodetect hierarchy (if supported)
+
+    -  .. row 4
+
+       -  .. _`HIERARCHY-1`:
+
+          ``HIERARCHY_1``
+
+       -  Hierarchy 1
+
+    -  .. row 5
+
+       -  .. _`HIERARCHY-2`:
+
+          ``HIERARCHY_2``
+
+       -  Hierarchy 2
+
+    -  .. row 6
+
+       -  .. _`HIERARCHY-4`:
+
+          ``HIERARCHY_4``
+
+       -  Hierarchy 4
+
+
+
+.. _DTV-STREAM-ID:
+
+DTV_STREAM_ID
+=============
+
+DVB-S2, DVB-T2 and ISDB-S support the transmission of several streams on
+a single transport stream. This property enables the DVB driver to
+handle substream filtering, when supported by the hardware. By default,
+substream filtering is disabled.
+
+For DVB-S2 and DVB-T2, the valid substream id range is from 0 to 255.
+
+For ISDB, the valid substream id range is from 1 to 65535.
+
+To disable it, you should use the special macro NO_STREAM_ID_FILTER.
+
+Note: any value outside the id range also disables filtering.
+
+
+.. _DTV-DVBT2-PLP-ID-LEGACY:
+
+DTV_DVBT2_PLP_ID_LEGACY
+=======================
+
+Obsolete, replaced with DTV_STREAM_ID.
+
+
+.. _DTV-ENUM-DELSYS:
+
+DTV_ENUM_DELSYS
+===============
+
+A Multi standard frontend needs to advertise the delivery systems
+provided. Applications need to enumerate the provided delivery systems,
+before using any other operation with the frontend. Prior to it's
+introduction, FE_GET_INFO was used to determine a frontend type. A
+frontend which provides more than a single delivery system,
+FE_GET_INFO doesn't help much. Applications which intends to use a
+multistandard frontend must enumerate the delivery systems associated
+with it, rather than trying to use FE_GET_INFO. In the case of a
+legacy frontend, the result is just the same as with FE_GET_INFO, but
+in a more structured format
+
+
+.. _DTV-INTERLEAVING:
+
+DTV_INTERLEAVING
+================
+
+Time interleaving to be used. Currently, used only on DTMB.
+
+
+.. _fe-interleaving:
+
+.. flat-table:: enum fe_interleaving
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ID
+
+       -  Description
+
+    -  .. row 2
+
+       -  .. _`INTERLEAVING-NONE`:
+
+          ``INTERLEAVING_NONE``
+
+       -  No interleaving.
+
+    -  .. row 3
+
+       -  .. _`INTERLEAVING-AUTO`:
+
+          ``INTERLEAVING_AUTO``
+
+       -  Auto-detect interleaving.
+
+    -  .. row 4
+
+       -  .. _`INTERLEAVING-240`:
+
+          ``INTERLEAVING_240``
+
+       -  Interleaving of 240 symbols.
+
+    -  .. row 5
+
+       -  .. _`INTERLEAVING-720`:
+
+          ``INTERLEAVING_720``
+
+       -  Interleaving of 720 symbols.
+
+
+
+.. _DTV-LNA:
+
+DTV_LNA
+=======
+
+Low-noise amplifier.
+
+Hardware might offer controllable LNA which can be set manually using
+that parameter. Usually LNA could be found only from terrestrial devices
+if at all.
+
+Possible values: 0, 1, LNA_AUTO
+
+0, LNA off
+
+1, LNA on
+
+use the special macro LNA_AUTO to set LNA auto
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/frontend-property-cable-systems.rst b/Documentation/linux_tv/media/dvb/frontend-property-cable-systems.rst
new file mode 100644
index 000000000000..360966ef50cf
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/frontend-property-cable-systems.rst
@@ -0,0 +1,84 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _frontend-property-cable-systems:
+
+*****************************************
+Properties used on cable delivery systems
+*****************************************
+
+
+.. _dvbc-params:
+
+DVB-C delivery system
+=====================
+
+The DVB-C Annex-A is the widely used cable standard. Transmission uses
+QAM modulation.
+
+The DVB-C Annex-C is optimized for 6MHz, and is used in Japan. It
+supports a subset of the Annex A modulation types, and a roll-off of
+0.13, instead of 0.15
+
+The following parameters are valid for DVB-C Annex A/C:
+
+-  :ref:`DTV_API_VERSION <DTV-API-VERSION>`
+
+-  :ref:`DTV_DELIVERY_SYSTEM <DTV-DELIVERY-SYSTEM>`
+
+-  :ref:`DTV_TUNE <DTV-TUNE>`
+
+-  :ref:`DTV_CLEAR <DTV-CLEAR>`
+
+-  :ref:`DTV_FREQUENCY <DTV-FREQUENCY>`
+
+-  :ref:`DTV_MODULATION <DTV-MODULATION>`
+
+-  :ref:`DTV_INVERSION <DTV-INVERSION>`
+
+-  :ref:`DTV_SYMBOL_RATE <DTV-SYMBOL-RATE>`
+
+-  :ref:`DTV_INNER_FEC <DTV-INNER-FEC>`
+
+-  :ref:`DTV_LNA <DTV-LNA>`
+
+In addition, the :ref:`DTV QoS statistics <frontend-stat-properties>`
+are also valid.
+
+
+.. _dvbc-annex-b-params:
+
+DVB-C Annex B delivery system
+=============================
+
+The DVB-C Annex-B is only used on a few Countries like the United
+States.
+
+The following parameters are valid for DVB-C Annex B:
+
+-  :ref:`DTV_API_VERSION <DTV-API-VERSION>`
+
+-  :ref:`DTV_DELIVERY_SYSTEM <DTV-DELIVERY-SYSTEM>`
+
+-  :ref:`DTV_TUNE <DTV-TUNE>`
+
+-  :ref:`DTV_CLEAR <DTV-CLEAR>`
+
+-  :ref:`DTV_FREQUENCY <DTV-FREQUENCY>`
+
+-  :ref:`DTV_MODULATION <DTV-MODULATION>`
+
+-  :ref:`DTV_INVERSION <DTV-INVERSION>`
+
+-  :ref:`DTV_LNA <DTV-LNA>`
+
+In addition, the :ref:`DTV QoS statistics <frontend-stat-properties>`
+are also valid.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/frontend-property-satellite-systems.rst b/Documentation/linux_tv/media/dvb/frontend-property-satellite-systems.rst
new file mode 100644
index 000000000000..1a204ac01afd
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/frontend-property-satellite-systems.rst
@@ -0,0 +1,112 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _frontend-property-satellite-systems:
+
+*********************************************
+Properties used on satellite delivery systems
+*********************************************
+
+
+.. _dvbs-params:
+
+DVB-S delivery system
+=====================
+
+The following parameters are valid for DVB-S:
+
+-  :ref:`DTV_API_VERSION <DTV-API-VERSION>`
+
+-  :ref:`DTV_DELIVERY_SYSTEM <DTV-DELIVERY-SYSTEM>`
+
+-  :ref:`DTV_TUNE <DTV-TUNE>`
+
+-  :ref:`DTV_CLEAR <DTV-CLEAR>`
+
+-  :ref:`DTV_FREQUENCY <DTV-FREQUENCY>`
+
+-  :ref:`DTV_INVERSION <DTV-INVERSION>`
+
+-  :ref:`DTV_SYMBOL_RATE <DTV-SYMBOL-RATE>`
+
+-  :ref:`DTV_INNER_FEC <DTV-INNER-FEC>`
+
+-  :ref:`DTV_VOLTAGE <DTV-VOLTAGE>`
+
+-  :ref:`DTV_TONE <DTV-TONE>`
+
+In addition, the :ref:`DTV QoS statistics <frontend-stat-properties>`
+are also valid.
+
+Future implementations might add those two missing parameters:
+
+-  :ref:`DTV_DISEQC_MASTER <DTV-DISEQC-MASTER>`
+
+-  :ref:`DTV_DISEQC_SLAVE_REPLY <DTV-DISEQC-SLAVE-REPLY>`
+
+
+.. _dvbs2-params:
+
+DVB-S2 delivery system
+======================
+
+In addition to all parameters valid for DVB-S, DVB-S2 supports the
+following parameters:
+
+-  :ref:`DTV_MODULATION <DTV-MODULATION>`
+
+-  :ref:`DTV_PILOT <DTV-PILOT>`
+
+-  :ref:`DTV_ROLLOFF <DTV-ROLLOFF>`
+
+-  :ref:`DTV_STREAM_ID <DTV-STREAM-ID>`
+
+In addition, the :ref:`DTV QoS statistics <frontend-stat-properties>`
+are also valid.
+
+
+.. _turbo-params:
+
+Turbo code delivery system
+==========================
+
+In addition to all parameters valid for DVB-S, turbo code supports the
+following parameters:
+
+-  :ref:`DTV_MODULATION <DTV-MODULATION>`
+
+
+.. _isdbs-params:
+
+ISDB-S delivery system
+======================
+
+The following parameters are valid for ISDB-S:
+
+-  :ref:`DTV_API_VERSION <DTV-API-VERSION>`
+
+-  :ref:`DTV_DELIVERY_SYSTEM <DTV-DELIVERY-SYSTEM>`
+
+-  :ref:`DTV_TUNE <DTV-TUNE>`
+
+-  :ref:`DTV_CLEAR <DTV-CLEAR>`
+
+-  :ref:`DTV_FREQUENCY <DTV-FREQUENCY>`
+
+-  :ref:`DTV_INVERSION <DTV-INVERSION>`
+
+-  :ref:`DTV_SYMBOL_RATE <DTV-SYMBOL-RATE>`
+
+-  :ref:`DTV_INNER_FEC <DTV-INNER-FEC>`
+
+-  :ref:`DTV_VOLTAGE <DTV-VOLTAGE>`
+
+-  :ref:`DTV_STREAM_ID <DTV-STREAM-ID>`
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/frontend-property-terrestrial-systems.rst b/Documentation/linux_tv/media/dvb/frontend-property-terrestrial-systems.rst
new file mode 100644
index 000000000000..78026596f46f
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/frontend-property-terrestrial-systems.rst
@@ -0,0 +1,303 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _frontend-property-terrestrial-systems:
+
+***********************************************
+Properties used on terrestrial delivery systems
+***********************************************
+
+
+.. _dvbt-params:
+
+DVB-T delivery system
+=====================
+
+The following parameters are valid for DVB-T:
+
+-  :ref:`DTV_API_VERSION <DTV-API-VERSION>`
+
+-  :ref:`DTV_DELIVERY_SYSTEM <DTV-DELIVERY-SYSTEM>`
+
+-  :ref:`DTV_TUNE <DTV-TUNE>`
+
+-  :ref:`DTV_CLEAR <DTV-CLEAR>`
+
+-  :ref:`DTV_FREQUENCY <DTV-FREQUENCY>`
+
+-  :ref:`DTV_MODULATION <DTV-MODULATION>`
+
+-  :ref:`DTV_BANDWIDTH_HZ <DTV-BANDWIDTH-HZ>`
+
+-  :ref:`DTV_INVERSION <DTV-INVERSION>`
+
+-  :ref:`DTV_CODE_RATE_HP <DTV-CODE-RATE-HP>`
+
+-  :ref:`DTV_CODE_RATE_LP <DTV-CODE-RATE-LP>`
+
+-  :ref:`DTV_GUARD_INTERVAL <DTV-GUARD-INTERVAL>`
+
+-  :ref:`DTV_TRANSMISSION_MODE <DTV-TRANSMISSION-MODE>`
+
+-  :ref:`DTV_HIERARCHY <DTV-HIERARCHY>`
+
+-  :ref:`DTV_LNA <DTV-LNA>`
+
+In addition, the :ref:`DTV QoS statistics <frontend-stat-properties>`
+are also valid.
+
+
+.. _dvbt2-params:
+
+DVB-T2 delivery system
+======================
+
+DVB-T2 support is currently in the early stages of development, so
+expect that this section maygrow and become more detailed with time.
+
+The following parameters are valid for DVB-T2:
+
+-  :ref:`DTV_API_VERSION <DTV-API-VERSION>`
+
+-  :ref:`DTV_DELIVERY_SYSTEM <DTV-DELIVERY-SYSTEM>`
+
+-  :ref:`DTV_TUNE <DTV-TUNE>`
+
+-  :ref:`DTV_CLEAR <DTV-CLEAR>`
+
+-  :ref:`DTV_FREQUENCY <DTV-FREQUENCY>`
+
+-  :ref:`DTV_MODULATION <DTV-MODULATION>`
+
+-  :ref:`DTV_BANDWIDTH_HZ <DTV-BANDWIDTH-HZ>`
+
+-  :ref:`DTV_INVERSION <DTV-INVERSION>`
+
+-  :ref:`DTV_CODE_RATE_HP <DTV-CODE-RATE-HP>`
+
+-  :ref:`DTV_CODE_RATE_LP <DTV-CODE-RATE-LP>`
+
+-  :ref:`DTV_GUARD_INTERVAL <DTV-GUARD-INTERVAL>`
+
+-  :ref:`DTV_TRANSMISSION_MODE <DTV-TRANSMISSION-MODE>`
+
+-  :ref:`DTV_HIERARCHY <DTV-HIERARCHY>`
+
+-  :ref:`DTV_STREAM_ID <DTV-STREAM-ID>`
+
+-  :ref:`DTV_LNA <DTV-LNA>`
+
+In addition, the :ref:`DTV QoS statistics <frontend-stat-properties>`
+are also valid.
+
+
+.. _isdbt:
+
+ISDB-T delivery system
+======================
+
+This ISDB-T/ISDB-Tsb API extension should reflect all information needed
+to tune any ISDB-T/ISDB-Tsb hardware. Of course it is possible that some
+very sophisticated devices won't need certain parameters to tune.
+
+The information given here should help application writers to know how
+to handle ISDB-T and ISDB-Tsb hardware using the Linux DVB-API.
+
+The details given here about ISDB-T and ISDB-Tsb are just enough to
+basically show the dependencies between the needed parameter values, but
+surely some information is left out. For more detailed information see
+the following documents:
+
+ARIB STD-B31 - "Transmission System for Digital Terrestrial Television
+Broadcasting" and
+
+ARIB TR-B14 - "Operational Guidelines for Digital Terrestrial Television
+Broadcasting".
+
+In order to understand the ISDB specific parameters, one has to have
+some knowledge the channel structure in ISDB-T and ISDB-Tsb. I.e. it has
+to be known to the reader that an ISDB-T channel consists of 13
+segments, that it can have up to 3 layer sharing those segments, and
+things like that.
+
+The following parameters are valid for ISDB-T:
+
+-  :ref:`DTV_API_VERSION <DTV-API-VERSION>`
+
+-  :ref:`DTV_DELIVERY_SYSTEM <DTV-DELIVERY-SYSTEM>`
+
+-  :ref:`DTV_TUNE <DTV-TUNE>`
+
+-  :ref:`DTV_CLEAR <DTV-CLEAR>`
+
+-  :ref:`DTV_FREQUENCY <DTV-FREQUENCY>`
+
+-  :ref:`DTV_BANDWIDTH_HZ <DTV-BANDWIDTH-HZ>`
+
+-  :ref:`DTV_INVERSION <DTV-INVERSION>`
+
+-  :ref:`DTV_GUARD_INTERVAL <DTV-GUARD-INTERVAL>`
+
+-  :ref:`DTV_TRANSMISSION_MODE <DTV-TRANSMISSION-MODE>`
+
+-  :ref:`DTV_ISDBT_LAYER_ENABLED <DTV-ISDBT-LAYER-ENABLED>`
+
+-  :ref:`DTV_ISDBT_PARTIAL_RECEPTION <DTV-ISDBT-PARTIAL-RECEPTION>`
+
+-  :ref:`DTV_ISDBT_SOUND_BROADCASTING <DTV-ISDBT-SOUND-BROADCASTING>`
+
+-  :ref:`DTV_ISDBT_SB_SUBCHANNEL_ID <DTV-ISDBT-SB-SUBCHANNEL-ID>`
+
+-  :ref:`DTV_ISDBT_SB_SEGMENT_IDX <DTV-ISDBT-SB-SEGMENT-IDX>`
+
+-  :ref:`DTV_ISDBT_SB_SEGMENT_COUNT <DTV-ISDBT-SB-SEGMENT-COUNT>`
+
+-  :ref:`DTV_ISDBT_LAYERA_FEC <DTV-ISDBT-LAYER-FEC>`
+
+-  :ref:`DTV_ISDBT_LAYERA_MODULATION <DTV-ISDBT-LAYER-MODULATION>`
+
+-  :ref:`DTV_ISDBT_LAYERA_SEGMENT_COUNT <DTV-ISDBT-LAYER-SEGMENT-COUNT>`
+
+-  :ref:`DTV_ISDBT_LAYERA_TIME_INTERLEAVING <DTV-ISDBT-LAYER-TIME-INTERLEAVING>`
+
+-  :ref:`DTV_ISDBT_LAYERB_FEC <DTV-ISDBT-LAYER-FEC>`
+
+-  :ref:`DTV_ISDBT_LAYERB_MODULATION <DTV-ISDBT-LAYER-MODULATION>`
+
+-  :ref:`DTV_ISDBT_LAYERB_SEGMENT_COUNT <DTV-ISDBT-LAYER-SEGMENT-COUNT>`
+
+-  :ref:`DTV_ISDBT_LAYERB_TIME_INTERLEAVING <DTV-ISDBT-LAYER-TIME-INTERLEAVING>`
+
+-  :ref:`DTV_ISDBT_LAYERC_FEC <DTV-ISDBT-LAYER-FEC>`
+
+-  :ref:`DTV_ISDBT_LAYERC_MODULATION <DTV-ISDBT-LAYER-MODULATION>`
+
+-  :ref:`DTV_ISDBT_LAYERC_SEGMENT_COUNT <DTV-ISDBT-LAYER-SEGMENT-COUNT>`
+
+-  :ref:`DTV_ISDBT_LAYERC_TIME_INTERLEAVING <DTV-ISDBT-LAYER-TIME-INTERLEAVING>`
+
+In addition, the :ref:`DTV QoS statistics <frontend-stat-properties>`
+are also valid.
+
+
+.. _atsc-params:
+
+ATSC delivery system
+====================
+
+The following parameters are valid for ATSC:
+
+-  :ref:`DTV_API_VERSION <DTV-API-VERSION>`
+
+-  :ref:`DTV_DELIVERY_SYSTEM <DTV-DELIVERY-SYSTEM>`
+
+-  :ref:`DTV_TUNE <DTV-TUNE>`
+
+-  :ref:`DTV_CLEAR <DTV-CLEAR>`
+
+-  :ref:`DTV_FREQUENCY <DTV-FREQUENCY>`
+
+-  :ref:`DTV_MODULATION <DTV-MODULATION>`
+
+-  :ref:`DTV_BANDWIDTH_HZ <DTV-BANDWIDTH-HZ>`
+
+In addition, the :ref:`DTV QoS statistics <frontend-stat-properties>`
+are also valid.
+
+
+.. _atscmh-params:
+
+ATSC-MH delivery system
+=======================
+
+The following parameters are valid for ATSC-MH:
+
+-  :ref:`DTV_API_VERSION <DTV-API-VERSION>`
+
+-  :ref:`DTV_DELIVERY_SYSTEM <DTV-DELIVERY-SYSTEM>`
+
+-  :ref:`DTV_TUNE <DTV-TUNE>`
+
+-  :ref:`DTV_CLEAR <DTV-CLEAR>`
+
+-  :ref:`DTV_FREQUENCY <DTV-FREQUENCY>`
+
+-  :ref:`DTV_BANDWIDTH_HZ <DTV-BANDWIDTH-HZ>`
+
+-  :ref:`DTV_ATSCMH_FIC_VER <DTV-ATSCMH-FIC-VER>`
+
+-  :ref:`DTV_ATSCMH_PARADE_ID <DTV-ATSCMH-PARADE-ID>`
+
+-  :ref:`DTV_ATSCMH_NOG <DTV-ATSCMH-NOG>`
+
+-  :ref:`DTV_ATSCMH_TNOG <DTV-ATSCMH-TNOG>`
+
+-  :ref:`DTV_ATSCMH_SGN <DTV-ATSCMH-SGN>`
+
+-  :ref:`DTV_ATSCMH_PRC <DTV-ATSCMH-PRC>`
+
+-  :ref:`DTV_ATSCMH_RS_FRAME_MODE <DTV-ATSCMH-RS-FRAME-MODE>`
+
+-  :ref:`DTV_ATSCMH_RS_FRAME_ENSEMBLE <DTV-ATSCMH-RS-FRAME-ENSEMBLE>`
+
+-  :ref:`DTV_ATSCMH_RS_CODE_MODE_PRI <DTV-ATSCMH-RS-CODE-MODE-PRI>`
+
+-  :ref:`DTV_ATSCMH_RS_CODE_MODE_SEC <DTV-ATSCMH-RS-CODE-MODE-SEC>`
+
+-  :ref:`DTV_ATSCMH_SCCC_BLOCK_MODE <DTV-ATSCMH-SCCC-BLOCK-MODE>`
+
+-  :ref:`DTV_ATSCMH_SCCC_CODE_MODE_A <DTV-ATSCMH-SCCC-CODE-MODE-A>`
+
+-  :ref:`DTV_ATSCMH_SCCC_CODE_MODE_B <DTV-ATSCMH-SCCC-CODE-MODE-B>`
+
+-  :ref:`DTV_ATSCMH_SCCC_CODE_MODE_C <DTV-ATSCMH-SCCC-CODE-MODE-C>`
+
+-  :ref:`DTV_ATSCMH_SCCC_CODE_MODE_D <DTV-ATSCMH-SCCC-CODE-MODE-D>`
+
+In addition, the :ref:`DTV QoS statistics <frontend-stat-properties>`
+are also valid.
+
+
+.. _dtmb-params:
+
+DTMB delivery system
+====================
+
+The following parameters are valid for DTMB:
+
+-  :ref:`DTV_API_VERSION <DTV-API-VERSION>`
+
+-  :ref:`DTV_DELIVERY_SYSTEM <DTV-DELIVERY-SYSTEM>`
+
+-  :ref:`DTV_TUNE <DTV-TUNE>`
+
+-  :ref:`DTV_CLEAR <DTV-CLEAR>`
+
+-  :ref:`DTV_FREQUENCY <DTV-FREQUENCY>`
+
+-  :ref:`DTV_MODULATION <DTV-MODULATION>`
+
+-  :ref:`DTV_BANDWIDTH_HZ <DTV-BANDWIDTH-HZ>`
+
+-  :ref:`DTV_INVERSION <DTV-INVERSION>`
+
+-  :ref:`DTV_INNER_FEC <DTV-INNER-FEC>`
+
+-  :ref:`DTV_GUARD_INTERVAL <DTV-GUARD-INTERVAL>`
+
+-  :ref:`DTV_TRANSMISSION_MODE <DTV-TRANSMISSION-MODE>`
+
+-  :ref:`DTV_INTERLEAVING <DTV-INTERLEAVING>`
+
+-  :ref:`DTV_LNA <DTV-LNA>`
+
+In addition, the :ref:`DTV QoS statistics <frontend-stat-properties>`
+are also valid.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/frontend-stat-properties.rst b/Documentation/linux_tv/media/dvb/frontend-stat-properties.rst
new file mode 100644
index 000000000000..36461d65a661
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/frontend-stat-properties.rst
@@ -0,0 +1,254 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _frontend-stat-properties:
+
+******************************
+Frontend statistics indicators
+******************************
+
+The values are returned via ``dtv_property.stat``. If the property is
+supported, ``dtv_property.stat.len`` is bigger than zero.
+
+For most delivery systems, ``dtv_property.stat.len`` will be 1 if the
+stats is supported, and the properties will return a single value for
+each parameter.
+
+It should be noted, however, that new OFDM delivery systems like ISDB
+can use different modulation types for each group of carriers. On such
+standards, up to 3 groups of statistics can be provided, and
+``dtv_property.stat.len`` is updated to reflect the "global" metrics,
+plus one metric per each carrier group (called "layer" on ISDB).
+
+So, in order to be consistent with other delivery systems, the first
+value at :ref:`dtv_property.stat.dtv_stats <dtv-stats>` array refers
+to the global metric. The other elements of the array represent each
+layer, starting from layer A(index 1), layer B (index 2) and so on.
+
+The number of filled elements are stored at ``dtv_property.stat.len``.
+
+Each element of the ``dtv_property.stat.dtv_stats`` array consists on
+two elements:
+
+-  ``svalue`` or ``uvalue``, where ``svalue`` is for signed values of
+   the measure (dB measures) and ``uvalue`` is for unsigned values
+   (counters, relative scale)
+
+-  ``scale`` - Scale for the value. It can be:
+
+   -  ``FE_SCALE_NOT_AVAILABLE`` - The parameter is supported by the
+      frontend, but it was not possible to collect it (could be a
+      transitory or permanent condition)
+
+   -  ``FE_SCALE_DECIBEL`` - parameter is a signed value, measured in
+      1/1000 dB
+
+   -  ``FE_SCALE_RELATIVE`` - parameter is a unsigned value, where 0
+      means 0% and 65535 means 100%.
+
+   -  ``FE_SCALE_COUNTER`` - parameter is a unsigned value that counts
+      the occurrence of an event, like bit error, block error, or lapsed
+      time.
+
+
+.. _DTV-STAT-SIGNAL-STRENGTH:
+
+DTV_STAT_SIGNAL_STRENGTH
+========================
+
+Indicates the signal strength level at the analog part of the tuner or
+of the demod.
+
+Possible scales for this metric are:
+
+-  ``FE_SCALE_NOT_AVAILABLE`` - it failed to measure it, or the
+   measurement was not complete yet.
+
+-  ``FE_SCALE_DECIBEL`` - signal strength is in 0.001 dBm units, power
+   measured in miliwatts. This value is generally negative.
+
+-  ``FE_SCALE_RELATIVE`` - The frontend provides a 0% to 100%
+   measurement for power (actually, 0 to 65535).
+
+
+.. _DTV-STAT-CNR:
+
+DTV_STAT_CNR
+============
+
+Indicates the Signal to Noise ratio for the main carrier.
+
+Possible scales for this metric are:
+
+-  ``FE_SCALE_NOT_AVAILABLE`` - it failed to measure it, or the
+   measurement was not complete yet.
+
+-  ``FE_SCALE_DECIBEL`` - Signal/Noise ratio is in 0.001 dB units.
+
+-  ``FE_SCALE_RELATIVE`` - The frontend provides a 0% to 100%
+   measurement for Signal/Noise (actually, 0 to 65535).
+
+
+.. _DTV-STAT-PRE-ERROR-BIT-COUNT:
+
+DTV_STAT_PRE_ERROR_BIT_COUNT
+============================
+
+Measures the number of bit errors before the forward error correction
+(FEC) on the inner coding block (before Viterbi, LDPC or other inner
+code).
+
+This measure is taken during the same interval as
+``DTV_STAT_PRE_TOTAL_BIT_COUNT``.
+
+In order to get the BER (Bit Error Rate) measurement, it should be
+divided by
+:ref:`DTV_STAT_PRE_TOTAL_BIT_COUNT <DTV-STAT-PRE-TOTAL-BIT-COUNT>`.
+
+This measurement is monotonically increased, as the frontend gets more
+bit count measurements. The frontend may reset it when a
+channel/transponder is tuned.
+
+Possible scales for this metric are:
+
+-  ``FE_SCALE_NOT_AVAILABLE`` - it failed to measure it, or the
+   measurement was not complete yet.
+
+-  ``FE_SCALE_COUNTER`` - Number of error bits counted before the inner
+   coding.
+
+
+.. _DTV-STAT-PRE-TOTAL-BIT-COUNT:
+
+DTV_STAT_PRE_TOTAL_BIT_COUNT
+============================
+
+Measures the amount of bits received before the inner code block, during
+the same period as
+:ref:`DTV_STAT_PRE_ERROR_BIT_COUNT <DTV-STAT-PRE-ERROR-BIT-COUNT>`
+measurement was taken.
+
+It should be noted that this measurement can be smaller than the total
+amount of bits on the transport stream, as the frontend may need to
+manually restart the measurement, losing some data between each
+measurement interval.
+
+This measurement is monotonically increased, as the frontend gets more
+bit count measurements. The frontend may reset it when a
+channel/transponder is tuned.
+
+Possible scales for this metric are:
+
+-  ``FE_SCALE_NOT_AVAILABLE`` - it failed to measure it, or the
+   measurement was not complete yet.
+
+-  ``FE_SCALE_COUNTER`` - Number of bits counted while measuring
+   :ref:`DTV_STAT_PRE_ERROR_BIT_COUNT <DTV-STAT-PRE-ERROR-BIT-COUNT>`.
+
+
+.. _DTV-STAT-POST-ERROR-BIT-COUNT:
+
+DTV_STAT_POST_ERROR_BIT_COUNT
+=============================
+
+Measures the number of bit errors after the forward error correction
+(FEC) done by inner code block (after Viterbi, LDPC or other inner
+code).
+
+This measure is taken during the same interval as
+``DTV_STAT_POST_TOTAL_BIT_COUNT``.
+
+In order to get the BER (Bit Error Rate) measurement, it should be
+divided by
+:ref:`DTV_STAT_POST_TOTAL_BIT_COUNT <DTV-STAT-POST-TOTAL-BIT-COUNT>`.
+
+This measurement is monotonically increased, as the frontend gets more
+bit count measurements. The frontend may reset it when a
+channel/transponder is tuned.
+
+Possible scales for this metric are:
+
+-  ``FE_SCALE_NOT_AVAILABLE`` - it failed to measure it, or the
+   measurement was not complete yet.
+
+-  ``FE_SCALE_COUNTER`` - Number of error bits counted after the inner
+   coding.
+
+
+.. _DTV-STAT-POST-TOTAL-BIT-COUNT:
+
+DTV_STAT_POST_TOTAL_BIT_COUNT
+=============================
+
+Measures the amount of bits received after the inner coding, during the
+same period as
+:ref:`DTV_STAT_POST_ERROR_BIT_COUNT <DTV-STAT-POST-ERROR-BIT-COUNT>`
+measurement was taken.
+
+It should be noted that this measurement can be smaller than the total
+amount of bits on the transport stream, as the frontend may need to
+manually restart the measurement, losing some data between each
+measurement interval.
+
+This measurement is monotonically increased, as the frontend gets more
+bit count measurements. The frontend may reset it when a
+channel/transponder is tuned.
+
+Possible scales for this metric are:
+
+-  ``FE_SCALE_NOT_AVAILABLE`` - it failed to measure it, or the
+   measurement was not complete yet.
+
+-  ``FE_SCALE_COUNTER`` - Number of bits counted while measuring
+   :ref:`DTV_STAT_POST_ERROR_BIT_COUNT <DTV-STAT-POST-ERROR-BIT-COUNT>`.
+
+
+.. _DTV-STAT-ERROR-BLOCK-COUNT:
+
+DTV_STAT_ERROR_BLOCK_COUNT
+==========================
+
+Measures the number of block errors after the outer forward error
+correction coding (after Reed-Solomon or other outer code).
+
+This measurement is monotonically increased, as the frontend gets more
+bit count measurements. The frontend may reset it when a
+channel/transponder is tuned.
+
+Possible scales for this metric are:
+
+-  ``FE_SCALE_NOT_AVAILABLE`` - it failed to measure it, or the
+   measurement was not complete yet.
+
+-  ``FE_SCALE_COUNTER`` - Number of error blocks counted after the outer
+   coding.
+
+
+.. _DTV-STAT-TOTAL-BLOCK-COUNT:
+
+DTV-STAT_TOTAL_BLOCK_COUNT
+==========================
+
+Measures the total number of blocks received during the same period as
+:ref:`DTV_STAT_ERROR_BLOCK_COUNT <DTV-STAT-ERROR-BLOCK-COUNT>`
+measurement was taken.
+
+It can be used to calculate the PER indicator, by dividing
+:ref:`DTV_STAT_ERROR_BLOCK_COUNT <DTV-STAT-ERROR-BLOCK-COUNT>` by
+:ref:`DTV-STAT-TOTAL-BLOCK-COUNT <DTV-STAT-TOTAL-BLOCK-COUNT>`.
+
+Possible scales for this metric are:
+
+-  ``FE_SCALE_NOT_AVAILABLE`` - it failed to measure it, or the
+   measurement was not complete yet.
+
+-  ``FE_SCALE_COUNTER`` - Number of blocks counted while measuring
+   :ref:`DTV_STAT_ERROR_BLOCK_COUNT <DTV-STAT-ERROR-BLOCK-COUNT>`.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/frontend.rst b/Documentation/linux_tv/media/dvb/frontend.rst
new file mode 100644
index 000000000000..46be409e76b6
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/frontend.rst
@@ -0,0 +1,62 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _dvb_frontend:
+
+################
+DVB Frontend API
+################
+The DVB frontend API was designed to support three types of delivery
+systems:
+
+-  Terrestrial systems: DVB-T, DVB-T2, ATSC, ATSC M/H, ISDB-T, DVB-H,
+   DTMB, CMMB
+
+-  Cable systems: DVB-C Annex A/C, ClearQAM (DVB-C Annex B), ISDB-C
+
+-  Satellite systems: DVB-S, DVB-S2, DVB Turbo, ISDB-S, DSS
+
+The DVB frontend controls several sub-devices including:
+
+-  Tuner
+
+-  Digital TV demodulator
+
+-  Low noise amplifier (LNA)
+
+-  Satellite Equipment Control (SEC) hardware (only for Satellite).
+
+The frontend can be accessed through ``/dev/dvb/adapter?/frontend?``.
+Data types and ioctl definitions can be accessed by including
+``linux/dvb/frontend.h`` in your application.
+
+NOTE: Transmission via the internet (DVB-IP) is not yet handled by this
+API but a future extension is possible.
+
+On Satellite systems, the API support for the Satellite Equipment
+Control (SEC) allows to power control and to send/receive signals to
+control the antenna subsystem, selecting the polarization and choosing
+the Intermediate Frequency IF) of the Low Noise Block Converter Feed
+Horn (LNBf). It supports the DiSEqC and V-SEC protocols. The DiSEqC
+(digital SEC) specification is available at
+`Eutelsat <http://www.eutelsat.com/satellites/4_5_5.html>`__.
+
+
+.. toctree::
+    :maxdepth: 1
+
+    query-dvb-frontend-info
+    dvb-fe-read-status
+    dvbproperty
+    frontend_fcalls
+    frontend_legacy_dvbv3_api
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/frontend_f_close.rst b/Documentation/linux_tv/media/dvb/frontend_f_close.rst
new file mode 100644
index 000000000000..cde87322859a
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/frontend_f_close.rst
@@ -0,0 +1,55 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _frontend_f_close:
+
+********************
+DVB frontend close()
+********************
+
+*man fe-close(2)*
+
+Close a frontend device
+
+
+Synopsis
+========
+
+.. code-block:: c
+
+    #include <unistd.h>
+
+
+.. c:function:: int close( int fd )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+
+Description
+===========
+
+This system call closes a previously opened front-end device. After
+closing a front-end device, its corresponding hardware might be powered
+down automatically.
+
+
+Return Value
+============
+
+The function returns 0 on success, -1 on failure and the ``errno`` is
+set appropriately. Possible error codes:
+
+EBADF
+    ``fd`` is not a valid open file descriptor.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/frontend_f_open.rst b/Documentation/linux_tv/media/dvb/frontend_f_open.rst
new file mode 100644
index 000000000000..676ae922338d
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/frontend_f_open.rst
@@ -0,0 +1,108 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _frontend_f_open:
+
+*******************
+DVB frontend open()
+*******************
+
+*man fe-open(2)*
+
+Open a frontend device
+
+
+Synopsis
+========
+
+.. code-block:: c
+
+    #include <fcntl.h>
+
+
+.. c:function:: int open( const char *device_name, int flags )
+
+Arguments
+=========
+
+``device_name``
+    Device to be opened.
+
+``flags``
+    Open flags. Access can either be ``O_RDWR`` or ``O_RDONLY``.
+
+    Multiple opens are allowed with ``O_RDONLY``. In this mode, only
+    query and read ioctls are allowed.
+
+    Only one open is allowed in ``O_RDWR``. In this mode, all ioctls are
+    allowed.
+
+    When the ``O_NONBLOCK`` flag is given, the system calls may return
+    EAGAIN error code when no data is available or when the device
+    driver is temporarily busy.
+
+    Other flags have no effect.
+
+
+Description
+===========
+
+This system call opens a named frontend device
+(``/dev/dvb/adapter?/frontend?``) for subsequent use. Usually the first
+thing to do after a successful open is to find out the frontend type
+with :ref:`FE_GET_INFO <FE_GET_INFO>`.
+
+The device can be opened in read-only mode, which only allows monitoring
+of device status and statistics, or read/write mode, which allows any
+kind of use (e.g. performing tuning operations.)
+
+In a system with multiple front-ends, it is usually the case that
+multiple devices cannot be open in read/write mode simultaneously. As
+long as a front-end device is opened in read/write mode, other open()
+calls in read/write mode will either fail or block, depending on whether
+non-blocking or blocking mode was specified. A front-end device opened
+in blocking mode can later be put into non-blocking mode (and vice
+versa) using the F_SETFL command of the fcntl system call. This is a
+standard system call, documented in the Linux manual page for fcntl.
+When an open() call has succeeded, the device will be ready for use in
+the specified mode. This implies that the corresponding hardware is
+powered up, and that other front-ends may have been powered down to make
+that possible.
+
+
+Return Value
+============
+
+On success :c:func:`open()` returns the new file descriptor. On error
+-1 is returned, and the ``errno`` variable is set appropriately.
+Possible error codes are:
+
+EACCES
+    The caller has no permission to access the device.
+
+EBUSY
+    The the device driver is already in use.
+
+ENXIO
+    No device corresponding to this device special file exists.
+
+ENOMEM
+    Not enough kernel memory was available to complete the request.
+
+EMFILE
+    The process already has the maximum number of files open.
+
+ENFILE
+    The limit on the total number of files open on the system has been
+    reached.
+
+ENODEV
+    The device got removed.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/frontend_fcalls.rst b/Documentation/linux_tv/media/dvb/frontend_fcalls.rst
new file mode 100644
index 000000000000..8eae0e9461ab
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/frontend_fcalls.rst
@@ -0,0 +1,35 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _frontend_fcalls:
+
+#######################
+Frontend Function Calls
+#######################
+
+.. toctree::
+    :maxdepth: 1
+
+    frontend_f_open
+    frontend_f_close
+    fe-get-info
+    fe-read-status
+    fe-get-property
+    fe-diseqc-reset-overload
+    fe-diseqc-send-master-cmd
+    fe-diseqc-recv-slave-reply
+    fe-diseqc-send-burst
+    fe-set-tone
+    fe-set-voltage
+    fe-enable-high-lnb-voltage
+    fe-set-frontend-tune-mode
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/frontend_h.rst b/Documentation/linux_tv/media/dvb/frontend_h.rst
new file mode 100644
index 000000000000..3f616c6bd01d
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/frontend_h.rst
@@ -0,0 +1,24 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _frontend_h:
+
+************************
+DVB Frontend Header File
+************************
+
+
+.. toctree::
+    :maxdepth: 1
+
+    ../../frontend.h
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/frontend_legacy_api.rst b/Documentation/linux_tv/media/dvb/frontend_legacy_api.rst
new file mode 100644
index 000000000000..dcc62d4a8516
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/frontend_legacy_api.rst
@@ -0,0 +1,49 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _frontend_legacy_types:
+
+Frontend Legacy Data Types
+==========================
+
+
+.. toctree::
+    :maxdepth: 1
+
+    fe-type-t
+    fe-bandwidth-t
+    dvb-frontend-parameters
+    dvb-frontend-event
+
+
+.. _frontend_legacy_fcalls:
+
+Frontend Legacy Function Calls
+==============================
+
+Those functions are defined at DVB version 3. The support is kept in the
+kernel due to compatibility issues only. Their usage is strongly not
+recommended
+
+
+.. toctree::
+    :maxdepth: 1
+
+    FE_READ_BER
+    FE_READ_SNR
+    FE_READ_SIGNAL_STRENGTH
+    FE_READ_UNCORRECTED_BLOCKS
+    FE_SET_FRONTEND
+    FE_GET_FRONTEND
+    FE_GET_EVENT
+    FE_DISHNETWORK_SEND_LEGACY_CMD
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/frontend_legacy_dvbv3_api.rst b/Documentation/linux_tv/media/dvb/frontend_legacy_dvbv3_api.rst
new file mode 100644
index 000000000000..1dbff41f6a34
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/frontend_legacy_dvbv3_api.rst
@@ -0,0 +1,29 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _frontend_legacy_dvbv3_api:
+
+****************************************
+DVB Frontend legacy API (a. k. a. DVBv3)
+****************************************
+
+The usage of this API is deprecated, as it doesn't support all digital
+TV standards, doesn't provide good statistics measurements and provides
+incomplete information. This is kept only to support legacy
+applications.
+
+
+.. toctree::
+    :maxdepth: 1
+
+    frontend_legacy_api
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/intro.rst b/Documentation/linux_tv/media/dvb/intro.rst
new file mode 100644
index 000000000000..0508f0d2c9db
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/intro.rst
@@ -0,0 +1,204 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _dvb_introdution:
+
+************
+Introduction
+************
+
+
+.. _requisites:
+
+What you need to know
+=====================
+
+The reader of this document is required to have some knowledge in the
+area of digital video broadcasting (DVB) and should be familiar with
+part I of the MPEG2 specification ISO/IEC 13818 (aka ITU-T H.222), i.e
+you should know what a program/transport stream (PS/TS) is and what is
+meant by a packetized elementary stream (PES) or an I-frame.
+
+Various DVB standards documents are available from http://www.dvb.org
+and/or http://www.etsi.org.
+
+It is also necessary to know how to access unix/linux devices and how to
+use ioctl calls. This also includes the knowledge of C or C++.
+
+
+.. _history:
+
+History
+=======
+
+The first API for DVB cards we used at Convergence in late 1999 was an
+extension of the Video4Linux API which was primarily developed for frame
+grabber cards. As such it was not really well suited to be used for DVB
+cards and their new features like recording MPEG streams and filtering
+several section and PES data streams at the same time.
+
+In early 2000, we were approached by Nokia with a proposal for a new
+standard Linux DVB API. As a commitment to the development of terminals
+based on open standards, Nokia and Convergence made it available to all
+Linux developers and published it on https://linuxtv.org in September
+2000. Convergence is the maintainer of the Linux DVB API. Together with
+the LinuxTV community (i.e. you, the reader of this document), the Linux
+DVB API will be constantly reviewed and improved. With the Linux driver
+for the Siemens/Hauppauge DVB PCI card Convergence provides a first
+implementation of the Linux DVB API.
+
+
+.. _overview:
+
+Overview
+========
+
+
+.. _stb_components:
+
+.. figure::  intro_files/dvbstb.*
+    :alt:    dvbstb.pdf / dvbstb.png
+    :align:  center
+
+    Components of a DVB card/STB
+
+A DVB PCI card or DVB set-top-box (STB) usually consists of the
+following main hardware components:
+
+-  Frontend consisting of tuner and DVB demodulator
+
+   Here the raw signal reaches the DVB hardware from a satellite dish or
+   antenna or directly from cable. The frontend down-converts and
+   demodulates this signal into an MPEG transport stream (TS). In case
+   of a satellite frontend, this includes a facility for satellite
+   equipment control (SEC), which allows control of LNB polarization,
+   multi feed switches or dish rotors.
+
+-  Conditional Access (CA) hardware like CI adapters and smartcard slots
+
+   The complete TS is passed through the CA hardware. Programs to which
+   the user has access (controlled by the smart card) are decoded in
+   real time and re-inserted into the TS.
+
+-  Demultiplexer which filters the incoming DVB stream
+
+   The demultiplexer splits the TS into its components like audio and
+   video streams. Besides usually several of such audio and video
+   streams it also contains data streams with information about the
+   programs offered in this or other streams of the same provider.
+
+-  MPEG2 audio and video decoder
+
+   The main targets of the demultiplexer are the MPEG2 audio and video
+   decoders. After decoding they pass on the uncompressed audio and
+   video to the computer screen or (through a PAL/NTSC encoder) to a TV
+   set.
+
+:ref:`stb_components` shows a crude schematic of the control and data
+flow between those components.
+
+On a DVB PCI card not all of these have to be present since some
+functionality can be provided by the main CPU of the PC (e.g. MPEG
+picture and sound decoding) or is not needed (e.g. for data-only uses
+like “internet over satellite”). Also not every card or STB provides
+conditional access hardware.
+
+
+.. _dvb_devices:
+
+Linux DVB Devices
+=================
+
+The Linux DVB API lets you control these hardware components through
+currently six Unix-style character devices for video, audio, frontend,
+demux, CA and IP-over-DVB networking. The video and audio devices
+control the MPEG2 decoder hardware, the frontend device the tuner and
+the DVB demodulator. The demux device gives you control over the PES and
+section filters of the hardware. If the hardware does not support
+filtering these filters can be implemented in software. Finally, the CA
+device controls all the conditional access capabilities of the hardware.
+It can depend on the individual security requirements of the platform,
+if and how many of the CA functions are made available to the
+application through this device.
+
+All devices can be found in the ``/dev`` tree under ``/dev/dvb``. The
+individual devices are called:
+
+-  ``/dev/dvb/adapterN/audioM``,
+
+-  ``/dev/dvb/adapterN/videoM``,
+
+-  ``/dev/dvb/adapterN/frontendM``,
+
+-  ``/dev/dvb/adapterN/netM``,
+
+-  ``/dev/dvb/adapterN/demuxM``,
+
+-  ``/dev/dvb/adapterN/dvrM``,
+
+-  ``/dev/dvb/adapterN/caM``,
+
+where N enumerates the DVB PCI cards in a system starting from 0, and M
+enumerates the devices of each type within each adapter, starting
+from 0, too. We will omit the “ ``/dev/dvb/adapterN/``\ ” in the further
+discussion of these devices.
+
+More details about the data structures and function calls of all the
+devices are described in the following chapters.
+
+
+.. _include_files:
+
+API include files
+=================
+
+For each of the DVB devices a corresponding include file exists. The DVB
+API include files should be included in application sources with a
+partial path like:
+
+
+.. code-block:: c
+
+        #include <linux/dvb/audio.h>
+
+
+.. code-block:: c
+
+        #include <linux/dvb/ca.h>
+
+
+.. code-block:: c
+
+        #include <linux/dvb/dmx.h>
+
+
+.. code-block:: c
+
+        #include <linux/dvb/frontend.h>
+
+
+.. code-block:: c
+
+        #include <linux/dvb/net.h>
+
+
+.. code-block:: c
+
+        #include <linux/dvb/osd.h>
+
+
+.. code-block:: c
+
+        #include <linux/dvb/video.h>
+
+To enable applications to support different API version, an additional
+include file ``linux/dvb/version.h`` exists, which defines the constant
+``DVB_API_VERSION``. This document describes ``DVB_API_VERSION 5.10``.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/intro_files/dvbstb.pdf b/Documentation/linux_tv/media/dvb/intro_files/dvbstb.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..0fa75d90c3eba1db9d07611ec6d86b4bc22d7a39
GIT binary patch
literal 1881
zcmZuydpJ~S7~f|KIaF3y&#K4C@?fQN&X~cZB}}7n$?S|Snrsbom~oj?bIug0wn8kc
zWK(H-+7OFXF1b{;wC<~xY|>U#(nW~WZi}e>jwUvB&L3ya@BMzi^S<x*e!sC0aCx@a
zVmrv9p?`lS#D-Cr2n>amE=9a?MF=H>?ExZ0c=B)xSHcJ{TteYoJcy9u&dv}?DRD^z
z6nX5_Y9GSHLGQwgHP2*P=;idTXWd6~<h$?aYd^{8$w)A~9e2aEL-T3Npvmddb%Xf|
z-B}EC$(ENFx_(4<4q++#U*3GPbAHFx!KA8@YuN(F;?b%FBThGVjJ^74eX@bj%(pl+
z;g7K9j01;f#-4n=`LX?gP6wYeno+fN(7d<b_giXE5r9Lt@-5qq6RR(<pi|f)i@1(^
zt76^r?sXf-NYAh|(){&vll+-ld3E#B=Id|m-|)?d*3Wx|B}AOtcN#NA!v)K*v&qr%
zR>W$!#yV4l+VuJsHfyS0F>I|H3|KRKl^dOUTN#F#SW3N7%E@zeB}aml^LOx$@x4;l
z$Miga7-b^cvh@tzmec}wr>kxaq-**<QBg>)INv|U{BBB3W8miN)fpqVgt?)(*X-fi
zi(mKh<Fea7FR5nS$FAnEWkWu#nw}ncoEgd248j^r1GM*Mwdw5YGXI^KLbzCl7<xq|
zCAyUyBzZByql^CiA<k@xSFX6e$Ha!0KwVBC{~l?HS&6uCdh|Cs@=J83-D_bFc?f@r
z*DqhS=Na!m<o=|XixodMGCzGK`a#bb8JZLRkQG*BJ!Uz(e5Ubn3;%fgup-j6v$?c9
zT}(#hs}__wv${y<c<u3HEftTv!)i;H$DCk=mh)ECd2=03>=wCr*Ut&{YdvqVqPYEf
zVpGXLbDmwbWtm=<p%~KcWM}v5h4HORrK)osjzLX_KB=)zT?LyQ*2vbKEsV&3qE{M6
z>@ob5vu8L?<BCT7-c;Q^#TSjw@A72IYVGHcwKcu-m<5@gjB)HwE~jU$UR$Qd!gH>k
z=@GMTKQ3FDZnE!So@U}Ut9u%kHYG|IG$yt~!`=eqX6co6Zp9Tr2^Pr>SIX1oG_6aL
z>8!{x5dW4{!d}>&;5FKhnI2?0)T$!GFvB-%8UQ_2YS@@qK6lTHW&ikub+)&Cwmr?t
z(!`h%TvMdkWM--LBJ$z(UtI%bV^wcP9ES%h&gR^|FH?zc5-#V4Mm_Jm+~Bq)fg_D(
zo!x-!+&(t;?8ZRX=<`G~&5pXcm0f)<l?|8gmb-KxjXlnNe!7VJ#g{ciVP{=@Wnbsx
z%TG-Q@>zYCbi>b7z23H?q9Us)w(rixs8{s`?QKWyktZDrE1e8&jE2^H@8wtBJRmb_
zs~LQBDOMTBh;|-msW9zty=|);ZywjNX%zg0E2Qf42!7FLm_E7mlY=rLHN=`a-hNS=
za6}*p!4V%^Dwntsk+2vAVLOx!V{B#s1cFLjLBV#k0YHclCkd4@2q%Fx2$V#S2&cpd
zFb^2<!y_rMe0e10A)<giz?`=X9s$@Gtto_nSs?D<9SD*zZ88&(IxG4MZ%qe?fwbU>
zyhs@Fl1oWg4AEH&p#T^tsAx%AO-;onscNRXgp!04A@3yKCO@^_;r;bfNkfRQzz4>h
zoz=p04QeA4IzTi{IHfXC)Vru7<oJG+epLtEBqUC^0r8VZ;H0gPh>$2I5=CefLPV-S
zirxphYVhrMRWYX&K&z#yAY5s+TqJ-!WCTf(K}z{13U<WUi&3UEXe;nwN=_)ap!HVV
zB}^3MfZLvlvK&wji2D%IkB25}ja1^n5DH@$gic<tJ)3REhJ#@>hA}a)ZS(~zCNUNh
zv}qcKvBBI;!%*}C3`IZGLphG1(bKq0d$5PoFuRXoC>WFJ>+Jr=rIZqRIIaYLZ7?E|
zZ^J>oFd`%fFi`aV!3bXwOu%&O!L;+au-Ix{N2b<Oe&N*vf|mSUTK%5ZA0h$tERvK&
SNli2nW3y1m!eY5E5Bd)oFwcSj

literal 0
HcmV?d00001

diff --git a/Documentation/linux_tv/media/dvb/intro_files/dvbstb.png b/Documentation/linux_tv/media/dvb/intro_files/dvbstb.png
new file mode 100644
index 0000000000000000000000000000000000000000..9b8f372e7afd9d016854973ba705dcdfbd1bbf13
GIT binary patch
literal 22655
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
I?##9S2OFAByZ`_I

literal 0
HcmV?d00001

diff --git a/Documentation/linux_tv/media/dvb/legacy_dvb_apis.rst b/Documentation/linux_tv/media/dvb/legacy_dvb_apis.rst
new file mode 100644
index 000000000000..15e0d88c2866
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/legacy_dvb_apis.rst
@@ -0,0 +1,31 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _legacy_dvb_apis:
+
+*******************
+DVB Deprecated APIs
+*******************
+
+The APIs described here are kept only for historical reasons. There's
+just one driver for a very legacy hardware that uses this API. No modern
+drivers should use it. Instead, audio and video should be using the V4L2
+and ALSA APIs, and the pipelines should be set using the Media
+Controller API
+
+
+.. toctree::
+    :maxdepth: 1
+
+    video
+    audio
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/net.rst b/Documentation/linux_tv/media/dvb/net.rst
new file mode 100644
index 000000000000..040ffc70601d
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/net.rst
@@ -0,0 +1,219 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _net:
+
+###############
+DVB Network API
+###############
+The DVB net device controls the mapping of data packages that are part
+of a transport stream to be mapped into a virtual network interface,
+visible through the standard Linux network protocol stack.
+
+Currently, two encapsulations are supported:
+
+-  `Multi Protocol Encapsulation (MPE) <http://en.wikipedia.org/wiki/Multiprotocol_Encapsulation>`__
+
+-  `Ultra Lightweight Encapsulation (ULE) <http://en.wikipedia.org/wiki/Unidirectional_Lightweight_Encapsulation>`__
+
+In order to create the Linux virtual network interfaces, an application
+needs to tell to the Kernel what are the PIDs and the encapsulation
+types that are present on the transport stream. This is done through
+``/dev/dvb/adapter?/net?`` device node. The data will be available via
+virtual ``dvb?_?`` network interfaces, and will be controlled/routed via
+the standard ip tools (like ip, route, netstat, ifconfig, etc).
+
+Data types and and ioctl definitions are defined via ``linux/dvb/net.h``
+header.
+
+
+.. _net_fcalls:
+
+######################
+DVB net Function Calls
+######################
+
+.. _NET_ADD_IF:
+
+****************
+ioctl NET_ADD_IF
+****************
+
+*man NET_ADD_IF(2)*
+
+Creates a new network interface for a given Packet ID.
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct dvb_net_if *net_if )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <frontend_f_open>`.
+
+``request``
+    FE_SET_TONE
+
+``net_if``
+    pointer to struct :ref:`dvb_net_if <dvb-net-if>`
+
+
+Description
+===========
+
+The NET_ADD_IF ioctl system call selects the Packet ID (PID) that
+contains a TCP/IP traffic, the type of encapsulation to be used (MPE or
+ULE) and the interface number for the new interface to be created. When
+the system call successfully returns, a new virtual network interface is
+created.
+
+The struct :ref:`dvb_net_if <dvb-net-if>`::ifnum field will be
+filled with the number of the created interface.
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _dvb-net-if-t:
+
+struct dvb_net_if description
+=============================
+
+
+.. _dvb-net-if:
+
+.. flat-table:: struct dvb_net_if
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ID
+
+       -  Description
+
+    -  .. row 2
+
+       -  pid
+
+       -  Packet ID (PID) of the MPEG-TS that contains data
+
+    -  .. row 3
+
+       -  ifnum
+
+       -  number of the DVB interface.
+
+    -  .. row 4
+
+       -  feedtype
+
+       -  Encapsulation type of the feed. It can be:
+          ``DVB_NET_FEEDTYPE_MPE`` for MPE encoding or
+          ``DVB_NET_FEEDTYPE_ULE`` for ULE encoding.
+
+
+
+.. _NET_REMOVE_IF:
+
+*******************
+ioctl NET_REMOVE_IF
+*******************
+
+*man NET_REMOVE_IF(2)*
+
+Removes a network interface.
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, int ifnum )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <frontend_f_open>`.
+
+``request``
+    FE_SET_TONE
+
+``net_if``
+    number of the interface to be removed
+
+
+Description
+===========
+
+The NET_REMOVE_IF ioctl deletes an interface previously created via
+:ref:`NET_ADD_IF <net>`.
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _NET_GET_IF:
+
+****************
+ioctl NET_GET_IF
+****************
+
+*man NET_GET_IF(2)*
+
+Read the configuration data of an interface created via
+:ref:`NET_ADD_IF <net>`.
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct dvb_net_if *net_if )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <frontend_f_open>`.
+
+``request``
+    FE_SET_TONE
+
+``net_if``
+    pointer to struct :ref:`dvb_net_if <dvb-net-if>`
+
+
+Description
+===========
+
+The NET_GET_IF ioctl uses the interface number given by the struct
+:ref:`dvb_net_if <dvb-net-if>`::ifnum field and fills the content of
+struct :ref:`dvb_net_if <dvb-net-if>` with the packet ID and
+encapsulation type used on such interface. If the interface was not
+created yet with :ref:`NET_ADD_IF <net>`, it will return -1 and fill
+the ``errno`` with ``EINVAL`` error code.
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/net_h.rst b/Documentation/linux_tv/media/dvb/net_h.rst
new file mode 100644
index 000000000000..357713b4a5ef
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/net_h.rst
@@ -0,0 +1,24 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _net_h:
+
+***********************
+DVB Network Header File
+***********************
+
+
+.. toctree::
+    :maxdepth: 1
+
+    ../../net.h
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/query-dvb-frontend-info.rst b/Documentation/linux_tv/media/dvb/query-dvb-frontend-info.rst
new file mode 100644
index 000000000000..4a4fd5af6e0f
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/query-dvb-frontend-info.rst
@@ -0,0 +1,22 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _query-dvb-frontend-info:
+
+*****************************
+Querying frontend information
+*****************************
+
+Usually, the first thing to do when the frontend is opened is to check
+the frontend capabilities. This is done using
+:ref:`FE_GET_INFO <FE_GET_INFO>`. This ioctl will enumerate the
+DVB API version and other characteristics about the frontend, and can be
+opened either in read only or read/write mode.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/video.rst b/Documentation/linux_tv/media/dvb/video.rst
new file mode 100644
index 000000000000..9783e9f344f6
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/video.rst
@@ -0,0 +1,46 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _dvb_video:
+
+################
+DVB Video Device
+################
+The DVB video device controls the MPEG2 video decoder of the DVB
+hardware. It can be accessed through **/dev/dvb/adapter0/video0**. Data
+types and and ioctl definitions can be accessed by including
+**linux/dvb/video.h** in your application.
+
+Note that the DVB video device only controls decoding of the MPEG video
+stream, not its presentation on the TV or computer screen. On PCs this
+is typically handled by an associated video4linux device, e.g.
+**/dev/video**, which allows scaling and defining output windows.
+
+Some DVB cards don’t have their own MPEG decoder, which results in the
+omission of the audio and video device as well as the video4linux
+device.
+
+The ioctls that deal with SPUs (sub picture units) and navigation
+packets are only supported on some MPEG decoders made for DVD playback.
+
+These ioctls were also used by V4L2 to control MPEG decoders implemented
+in V4L2. The use of these ioctls for that purpose has been made obsolete
+and proper V4L2 ioctls or controls have been created to replace that
+functionality.
+
+
+.. toctree::
+    :maxdepth: 1
+
+    video_types
+    video_function_calls
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/video_function_calls.rst b/Documentation/linux_tv/media/dvb/video_function_calls.rst
new file mode 100644
index 000000000000..3add2b85450d
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/video_function_calls.rst
@@ -0,0 +1,1880 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _video_function_calls:
+
+********************
+Video Function Calls
+********************
+
+
+.. _video_fopen:
+
+open()
+======
+
+DESCRIPTION
+
+This system call opens a named video device (e.g.
+/dev/dvb/adapter0/video0) for subsequent use.
+
+When an open() call has succeeded, the device will be ready for use. The
+significance of blocking or non-blocking mode is described in the
+documentation for functions where there is a difference. It does not
+affect the semantics of the open() call itself. A device opened in
+blocking mode can later be put into non-blocking mode (and vice versa)
+using the F_SETFL command of the fcntl system call. This is a standard
+system call, documented in the Linux manual page for fcntl. Only one
+user can open the Video Device in O_RDWR mode. All other attempts to
+open the device in this mode will fail, and an error-code will be
+returned. If the Video Device is opened in O_RDONLY mode, the only
+ioctl call that can be used is VIDEO_GET_STATUS. All other call will
+return an error code.
+
+SYNOPSIS
+
+int open(const char *deviceName, int flags);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  const char *deviceName
+
+       -  Name of specific video device.
+
+    -  .. row 2
+
+       -  int flags
+
+       -  A bit-wise OR of the following flags:
+
+    -  .. row 3
+
+       -  
+       -  O_RDONLY read-only access
+
+    -  .. row 4
+
+       -  
+       -  O_RDWR read/write access
+
+    -  .. row 5
+
+       -  
+       -  O_NONBLOCK open in non-blocking mode
+
+    -  .. row 6
+
+       -  
+       -  (blocking mode is the default)
+
+
+RETURN VALUE
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ENODEV
+
+       -  Device driver not loaded/available.
+
+    -  .. row 2
+
+       -  EINTERNAL
+
+       -  Internal error.
+
+    -  .. row 3
+
+       -  EBUSY
+
+       -  Device or resource busy.
+
+    -  .. row 4
+
+       -  EINVAL
+
+       -  Invalid argument.
+
+
+
+.. _video_fclose:
+
+close()
+=======
+
+DESCRIPTION
+
+This system call closes a previously opened video device.
+
+SYNOPSIS
+
+int close(int fd);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+
+RETURN VALUE
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  EBADF
+
+       -  fd is not a valid open file descriptor.
+
+
+
+.. _video_fwrite:
+
+write()
+=======
+
+DESCRIPTION
+
+This system call can only be used if VIDEO_SOURCE_MEMORY is selected
+in the ioctl call VIDEO_SELECT_SOURCE. The data provided shall be in
+PES format, unless the capability allows other formats. If O_NONBLOCK
+is not specified the function will block until buffer space is
+available. The amount of data to be transferred is implied by count.
+
+SYNOPSIS
+
+size_t write(int fd, const void *buf, size_t count);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  void *buf
+
+       -  Pointer to the buffer containing the PES data.
+
+    -  .. row 3
+
+       -  size_t count
+
+       -  Size of buf.
+
+
+RETURN VALUE
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  EPERM
+
+       -  Mode VIDEO_SOURCE_MEMORY not selected.
+
+    -  .. row 2
+
+       -  ENOMEM
+
+       -  Attempted to write more data than the internal buffer can hold.
+
+    -  .. row 3
+
+       -  EBADF
+
+       -  fd is not a valid open file descriptor.
+
+
+
+.. _VIDEO_STOP:
+
+VIDEO_STOP
+==========
+
+DESCRIPTION
+
+This ioctl is for DVB devices only. To control a V4L2 decoder use the
+V4L2 :ref:`VIDIOC_DECODER_CMD <vidioc-decoder-cmd>` instead.
+
+This ioctl call asks the Video Device to stop playing the current
+stream. Depending on the input parameter, the screen can be blanked out
+or displaying the last decoded frame.
+
+SYNOPSIS
+
+int ioctl(fd, int request = VIDEO_STOP, boolean mode);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals VIDEO_STOP for this command.
+
+    -  .. row 3
+
+       -  Boolean mode
+
+       -  Indicates how the screen shall be handled.
+
+    -  .. row 4
+
+       -  
+       -  TRUE: Blank screen when stop.
+
+    -  .. row 5
+
+       -  
+       -  FALSE: Show last decoded frame.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _VIDEO_PLAY:
+
+VIDEO_PLAY
+==========
+
+DESCRIPTION
+
+This ioctl is for DVB devices only. To control a V4L2 decoder use the
+V4L2 :ref:`VIDIOC_DECODER_CMD <vidioc-decoder-cmd>` instead.
+
+This ioctl call asks the Video Device to start playing a video stream
+from the selected source.
+
+SYNOPSIS
+
+int ioctl(fd, int request = VIDEO_PLAY);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals VIDEO_PLAY for this command.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _VIDEO_FREEZE:
+
+VIDEO_FREEZE
+============
+
+DESCRIPTION
+
+This ioctl is for DVB devices only. To control a V4L2 decoder use the
+V4L2 :ref:`VIDIOC_DECODER_CMD <vidioc-decoder-cmd>` instead.
+
+This ioctl call suspends the live video stream being played. Decoding
+and playing are frozen. It is then possible to restart the decoding and
+playing process of the video stream using the VIDEO_CONTINUE command.
+If VIDEO_SOURCE_MEMORY is selected in the ioctl call
+VIDEO_SELECT_SOURCE, the DVB subsystem will not decode any more data
+until the ioctl call VIDEO_CONTINUE or VIDEO_PLAY is performed.
+
+SYNOPSIS
+
+int ioctl(fd, int request = VIDEO_FREEZE);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals VIDEO_FREEZE for this command.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _VIDEO_CONTINUE:
+
+VIDEO_CONTINUE
+==============
+
+DESCRIPTION
+
+This ioctl is for DVB devices only. To control a V4L2 decoder use the
+V4L2 :ref:`VIDIOC_DECODER_CMD <vidioc-decoder-cmd>` instead.
+
+This ioctl call restarts decoding and playing processes of the video
+stream which was played before a call to VIDEO_FREEZE was made.
+
+SYNOPSIS
+
+int ioctl(fd, int request = VIDEO_CONTINUE);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals VIDEO_CONTINUE for this command.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _VIDEO_SELECT_SOURCE:
+
+VIDEO_SELECT_SOURCE
+===================
+
+DESCRIPTION
+
+This ioctl is for DVB devices only. This ioctl was also supported by the
+V4L2 ivtv driver, but that has been replaced by the ivtv-specific
+``IVTV_IOC_PASSTHROUGH_MODE`` ioctl.
+
+This ioctl call informs the video device which source shall be used for
+the input data. The possible sources are demux or memory. If memory is
+selected, the data is fed to the video device through the write command.
+
+SYNOPSIS
+
+int ioctl(fd, int request = VIDEO_SELECT_SOURCE,
+video_stream_source_t source);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals VIDEO_SELECT_SOURCE for this command.
+
+    -  .. row 3
+
+       -  video_stream_source_t source
+
+       -  Indicates which source shall be used for the Video stream.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _VIDEO_SET_BLANK:
+
+VIDEO_SET_BLANK
+===============
+
+DESCRIPTION
+
+This ioctl call asks the Video Device to blank out the picture.
+
+SYNOPSIS
+
+int ioctl(fd, int request = VIDEO_SET_BLANK, boolean mode);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals VIDEO_SET_BLANK for this command.
+
+    -  .. row 3
+
+       -  boolean mode
+
+       -  TRUE: Blank screen when stop.
+
+    -  .. row 4
+
+       -  
+       -  FALSE: Show last decoded frame.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _VIDEO_GET_STATUS:
+
+VIDEO_GET_STATUS
+================
+
+DESCRIPTION
+
+This ioctl call asks the Video Device to return the current status of
+the device.
+
+SYNOPSIS
+
+int ioctl(fd, int request = VIDEO_GET_STATUS, struct video_status
+*status);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals VIDEO_GET_STATUS for this command.
+
+    -  .. row 3
+
+       -  struct video_status *status
+
+       -  Returns the current status of the Video Device.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _VIDEO_GET_FRAME_COUNT:
+
+VIDEO_GET_FRAME_COUNT
+=====================
+
+DESCRIPTION
+
+This ioctl is obsolete. Do not use in new drivers. For V4L2 decoders
+this ioctl has been replaced by the ``V4L2_CID_MPEG_VIDEO_DEC_FRAME``
+control.
+
+This ioctl call asks the Video Device to return the number of displayed
+frames since the decoder was started.
+
+SYNOPSIS
+
+int ioctl(int fd, int request = VIDEO_GET_FRAME_COUNT, __u64 *pts);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals VIDEO_GET_FRAME_COUNT for this command.
+
+    -  .. row 3
+
+       -  __u64 *pts
+
+       -  Returns the number of frames displayed since the decoder was
+          started.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _VIDEO_GET_PTS:
+
+VIDEO_GET_PTS
+=============
+
+DESCRIPTION
+
+This ioctl is obsolete. Do not use in new drivers. For V4L2 decoders
+this ioctl has been replaced by the ``V4L2_CID_MPEG_VIDEO_DEC_PTS``
+control.
+
+This ioctl call asks the Video Device to return the current PTS
+timestamp.
+
+SYNOPSIS
+
+int ioctl(int fd, int request = VIDEO_GET_PTS, __u64 *pts);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals VIDEO_GET_PTS for this command.
+
+    -  .. row 3
+
+       -  __u64 *pts
+
+       -  Returns the 33-bit timestamp as defined in ITU T-REC-H.222.0 /
+          ISO/IEC 13818-1.
+
+          The PTS should belong to the currently played frame if possible,
+          but may also be a value close to it like the PTS of the last
+          decoded frame or the last PTS extracted by the PES parser.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _VIDEO_GET_FRAME_RATE:
+
+VIDEO_GET_FRAME_RATE
+====================
+
+DESCRIPTION
+
+This ioctl call asks the Video Device to return the current framerate.
+
+SYNOPSIS
+
+int ioctl(int fd, int request = VIDEO_GET_FRAME_RATE, unsigned int
+*rate);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals VIDEO_GET_FRAME_RATE for this command.
+
+    -  .. row 3
+
+       -  unsigned int *rate
+
+       -  Returns the framerate in number of frames per 1000 seconds.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _VIDEO_GET_EVENT:
+
+VIDEO_GET_EVENT
+===============
+
+DESCRIPTION
+
+This ioctl is for DVB devices only. To get events from a V4L2 decoder
+use the V4L2 :ref:`VIDIOC_DQEVENT <vidioc-dqevent>` ioctl instead.
+
+This ioctl call returns an event of type video_event if available. If
+an event is not available, the behavior depends on whether the device is
+in blocking or non-blocking mode. In the latter case, the call fails
+immediately with errno set to EWOULDBLOCK. In the former case, the call
+blocks until an event becomes available. The standard Linux poll()
+and/or select() system calls can be used with the device file descriptor
+to watch for new events. For select(), the file descriptor should be
+included in the exceptfds argument, and for poll(), POLLPRI should be
+specified as the wake-up condition. Read-only permissions are sufficient
+for this ioctl call.
+
+SYNOPSIS
+
+int ioctl(fd, int request = VIDEO_GET_EVENT, struct video_event *ev);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals VIDEO_GET_EVENT for this command.
+
+    -  .. row 3
+
+       -  struct video_event *ev
+
+       -  Points to the location where the event, if any, is to be stored.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  EWOULDBLOCK
+
+       -  There is no event pending, and the device is in non-blocking mode.
+
+    -  .. row 2
+
+       -  EOVERFLOW
+
+       -  Overflow in event queue - one or more events were lost.
+
+
+
+.. _VIDEO_COMMAND:
+
+VIDEO_COMMAND
+=============
+
+DESCRIPTION
+
+This ioctl is obsolete. Do not use in new drivers. For V4L2 decoders
+this ioctl has been replaced by the
+:ref:`VIDIOC_DECODER_CMD <vidioc-decoder-cmd>` ioctl.
+
+This ioctl commands the decoder. The ``video_command`` struct is a
+subset of the ``v4l2_decoder_cmd`` struct, so refer to the
+:ref:`VIDIOC_DECODER_CMD <vidioc-decoder-cmd>` documentation for
+more information.
+
+SYNOPSIS
+
+int ioctl(int fd, int request = VIDEO_COMMAND, struct video_command
+*cmd);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals VIDEO_COMMAND for this command.
+
+    -  .. row 3
+
+       -  struct video_command *cmd
+
+       -  Commands the decoder.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _VIDEO_TRY_COMMAND:
+
+VIDEO_TRY_COMMAND
+=================
+
+DESCRIPTION
+
+This ioctl is obsolete. Do not use in new drivers. For V4L2 decoders
+this ioctl has been replaced by the
+:ref:`VIDIOC_TRY_DECODER_CMD <vidioc-decoder-cmd>` ioctl.
+
+This ioctl tries a decoder command. The ``video_command`` struct is a
+subset of the ``v4l2_decoder_cmd`` struct, so refer to the
+:ref:`VIDIOC_TRY_DECODER_CMD <vidioc-decoder-cmd>` documentation
+for more information.
+
+SYNOPSIS
+
+int ioctl(int fd, int request = VIDEO_TRY_COMMAND, struct
+video_command *cmd);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals VIDEO_TRY_COMMAND for this command.
+
+    -  .. row 3
+
+       -  struct video_command *cmd
+
+       -  Try a decoder command.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _VIDEO_GET_SIZE:
+
+VIDEO_GET_SIZE
+==============
+
+DESCRIPTION
+
+This ioctl returns the size and aspect ratio.
+
+SYNOPSIS
+
+int ioctl(int fd, int request = VIDEO_GET_SIZE, video_size_t *size);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals VIDEO_GET_SIZE for this command.
+
+    -  .. row 3
+
+       -  video_size_t *size
+
+       -  Returns the size and aspect ratio.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _VIDEO_SET_DISPLAY_FORMAT:
+
+VIDEO_SET_DISPLAY_FORMAT
+========================
+
+DESCRIPTION
+
+This ioctl call asks the Video Device to select the video format to be
+applied by the MPEG chip on the video.
+
+SYNOPSIS
+
+int ioctl(fd, int request = VIDEO_SET_DISPLAY_FORMAT,
+video_display_format_t format);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals VIDEO_SET_DISPLAY_FORMAT for this command.
+
+    -  .. row 3
+
+       -  video_display_format_t format
+
+       -  Selects the video format to be used.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _VIDEO_STILLPICTURE:
+
+VIDEO_STILLPICTURE
+==================
+
+DESCRIPTION
+
+This ioctl call asks the Video Device to display a still picture
+(I-frame). The input data shall contain an I-frame. If the pointer is
+NULL, then the current displayed still picture is blanked.
+
+SYNOPSIS
+
+int ioctl(fd, int request = VIDEO_STILLPICTURE, struct
+video_still_picture *sp);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals VIDEO_STILLPICTURE for this command.
+
+    -  .. row 3
+
+       -  struct video_still_picture *sp
+
+       -  Pointer to a location where an I-frame and size is stored.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _VIDEO_FAST_FORWARD:
+
+VIDEO_FAST_FORWARD
+==================
+
+DESCRIPTION
+
+This ioctl call asks the Video Device to skip decoding of N number of
+I-frames. This call can only be used if VIDEO_SOURCE_MEMORY is
+selected.
+
+SYNOPSIS
+
+int ioctl(fd, int request = VIDEO_FAST_FORWARD, int nFrames);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals VIDEO_FAST_FORWARD for this command.
+
+    -  .. row 3
+
+       -  int nFrames
+
+       -  The number of frames to skip.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  EPERM
+
+       -  Mode VIDEO_SOURCE_MEMORY not selected.
+
+
+
+.. _VIDEO_SLOWMOTION:
+
+VIDEO_SLOWMOTION
+================
+
+DESCRIPTION
+
+This ioctl call asks the video device to repeat decoding frames N number
+of times. This call can only be used if VIDEO_SOURCE_MEMORY is
+selected.
+
+SYNOPSIS
+
+int ioctl(fd, int request = VIDEO_SLOWMOTION, int nFrames);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals VIDEO_SLOWMOTION for this command.
+
+    -  .. row 3
+
+       -  int nFrames
+
+       -  The number of times to repeat each frame.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  EPERM
+
+       -  Mode VIDEO_SOURCE_MEMORY not selected.
+
+
+
+.. _VIDEO_GET_CAPABILITIES:
+
+VIDEO_GET_CAPABILITIES
+======================
+
+DESCRIPTION
+
+This ioctl call asks the video device about its decoding capabilities.
+On success it returns and integer which has bits set according to the
+defines in section ??.
+
+SYNOPSIS
+
+int ioctl(fd, int request = VIDEO_GET_CAPABILITIES, unsigned int
+*cap);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals VIDEO_GET_CAPABILITIES for this command.
+
+    -  .. row 3
+
+       -  unsigned int *cap
+
+       -  Pointer to a location where to store the capability information.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _VIDEO_SET_ID:
+
+VIDEO_SET_ID
+============
+
+DESCRIPTION
+
+This ioctl selects which sub-stream is to be decoded if a program or
+system stream is sent to the video device.
+
+SYNOPSIS
+
+int ioctl(int fd, int request = VIDEO_SET_ID, int id);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals VIDEO_SET_ID for this command.
+
+    -  .. row 3
+
+       -  int id
+
+       -  video sub-stream id
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  EINVAL
+
+       -  Invalid sub-stream id.
+
+
+
+.. _VIDEO_CLEAR_BUFFER:
+
+VIDEO_CLEAR_BUFFER
+==================
+
+DESCRIPTION
+
+This ioctl call clears all video buffers in the driver and in the
+decoder hardware.
+
+SYNOPSIS
+
+int ioctl(fd, int request = VIDEO_CLEAR_BUFFER);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals VIDEO_CLEAR_BUFFER for this command.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _VIDEO_SET_STREAMTYPE:
+
+VIDEO_SET_STREAMTYPE
+====================
+
+DESCRIPTION
+
+This ioctl tells the driver which kind of stream to expect being written
+to it. If this call is not used the default of video PES is used. Some
+drivers might not support this call and always expect PES.
+
+SYNOPSIS
+
+int ioctl(fd, int request = VIDEO_SET_STREAMTYPE, int type);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals VIDEO_SET_STREAMTYPE for this command.
+
+    -  .. row 3
+
+       -  int type
+
+       -  stream type
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _VIDEO_SET_FORMAT:
+
+VIDEO_SET_FORMAT
+================
+
+DESCRIPTION
+
+This ioctl sets the screen format (aspect ratio) of the connected output
+device (TV) so that the output of the decoder can be adjusted
+accordingly.
+
+SYNOPSIS
+
+int ioctl(fd, int request = VIDEO_SET_FORMAT, video_format_t
+format);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals VIDEO_SET_FORMAT for this command.
+
+    -  .. row 3
+
+       -  video_format_t format
+
+       -  video format of TV as defined in section ??.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  EINVAL
+
+       -  format is not a valid video format.
+
+
+
+.. _VIDEO_SET_SYSTEM:
+
+VIDEO_SET_SYSTEM
+================
+
+DESCRIPTION
+
+This ioctl sets the television output format. The format (see section
+??) may vary from the color format of the displayed MPEG stream. If the
+hardware is not able to display the requested format the call will
+return an error.
+
+SYNOPSIS
+
+int ioctl(fd, int request = VIDEO_SET_SYSTEM , video_system_t
+system);
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals VIDEO_SET_FORMAT for this command.
+
+    -  .. row 3
+
+       -  video_system_t system
+
+       -  video system of TV output.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  EINVAL
+
+       -  system is not a valid or supported video system.
+
+
+
+.. _VIDEO_SET_HIGHLIGHT:
+
+VIDEO_SET_HIGHLIGHT
+===================
+
+DESCRIPTION
+
+This ioctl sets the SPU highlight information for the menu access of a
+DVD.
+
+SYNOPSIS
+
+int ioctl(fd, int request = VIDEO_SET_HIGHLIGHT ,video_highlight_t
+*vhilite)
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals VIDEO_SET_HIGHLIGHT for this command.
+
+    -  .. row 3
+
+       -  video_highlight_t *vhilite
+
+       -  SPU Highlight information according to section ??.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. _VIDEO_SET_SPU:
+
+VIDEO_SET_SPU
+=============
+
+DESCRIPTION
+
+This ioctl activates or deactivates SPU decoding in a DVD input stream.
+It can only be used, if the driver is able to handle a DVD stream.
+
+SYNOPSIS
+
+int ioctl(fd, int request = VIDEO_SET_SPU , video_spu_t *spu)
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals VIDEO_SET_SPU for this command.
+
+    -  .. row 3
+
+       -  video_spu_t *spu
+
+       -  SPU decoding (de)activation and subid setting according to section
+          ??.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  EINVAL
+
+       -  input is not a valid spu setting or driver cannot handle SPU.
+
+
+
+.. _VIDEO_SET_SPU_PALETTE:
+
+VIDEO_SET_SPU_PALETTE
+=====================
+
+DESCRIPTION
+
+This ioctl sets the SPU color palette.
+
+SYNOPSIS
+
+int ioctl(fd, int request = VIDEO_SET_SPU_PALETTE
+,video_spu_palette_t *palette )
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals VIDEO_SET_SPU_PALETTE for this command.
+
+    -  .. row 3
+
+       -  video_spu_palette_t *palette
+
+       -  SPU palette according to section ??.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  EINVAL
+
+       -  input is not a valid palette or driver doesn’t handle SPU.
+
+
+
+.. _VIDEO_GET_NAVI:
+
+VIDEO_GET_NAVI
+==============
+
+DESCRIPTION
+
+This ioctl returns navigational information from the DVD stream. This is
+especially needed if an encoded stream has to be decoded by the
+hardware.
+
+SYNOPSIS
+
+int ioctl(fd, int request = VIDEO_GET_NAVI , video_navi_pack_t
+*navipack)
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals VIDEO_GET_NAVI for this command.
+
+    -  .. row 3
+
+       -  video_navi_pack_t *navipack
+
+       -  PCI or DSI pack (private stream 2) according to section ??.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  EFAULT
+
+       -  driver is not able to return navigational information
+
+
+
+.. _VIDEO_SET_ATTRIBUTES:
+
+VIDEO_SET_ATTRIBUTES
+====================
+
+DESCRIPTION
+
+This ioctl is intended for DVD playback and allows you to set certain
+information about the stream. Some hardware may not need this
+information, but the call also tells the hardware to prepare for DVD
+playback.
+
+SYNOPSIS
+
+int ioctl(fd, int request = VIDEO_SET_ATTRIBUTE ,video_attributes_t
+vattr)
+
+PARAMETERS
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  int fd
+
+       -  File descriptor returned by a previous call to open().
+
+    -  .. row 2
+
+       -  int request
+
+       -  Equals VIDEO_SET_ATTRIBUTE for this command.
+
+    -  .. row 3
+
+       -  video_attributes_t vattr
+
+       -  video attributes according to section ??.
+
+
+RETURN VALUE
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  EINVAL
+
+       -  input is not a valid attribute setting.
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/video_h.rst b/Documentation/linux_tv/media/dvb/video_h.rst
new file mode 100644
index 000000000000..348d20c3cab7
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/video_h.rst
@@ -0,0 +1,24 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _video_h:
+
+*********************
+DVB Video Header File
+*********************
+
+
+.. toctree::
+    :maxdepth: 1
+
+    ../../video.h
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/dvb/video_types.rst b/Documentation/linux_tv/media/dvb/video_types.rst
new file mode 100644
index 000000000000..f57233825e42
--- /dev/null
+++ b/Documentation/linux_tv/media/dvb/video_types.rst
@@ -0,0 +1,390 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _video_types:
+
+****************
+Video Data Types
+****************
+
+
+.. _video-format-t:
+
+video_format_t
+==============
+
+The ``video_format_t`` data type defined by
+
+
+.. code-block:: c
+
+    typedef enum {
+        VIDEO_FORMAT_4_3,     /* Select 4:3 format */
+        VIDEO_FORMAT_16_9,    /* Select 16:9 format. */
+        VIDEO_FORMAT_221_1    /* 2.21:1 */
+    } video_format_t;
+
+is used in the VIDEO_SET_FORMAT function (??) to tell the driver which
+aspect ratio the output hardware (e.g. TV) has. It is also used in the
+data structures video_status (??) returned by VIDEO_GET_STATUS (??)
+and video_event (??) returned by VIDEO_GET_EVENT (??) which report
+about the display format of the current video stream.
+
+
+.. _video-displayformat-t:
+
+video_displayformat_t
+=====================
+
+In case the display format of the video stream and of the display
+hardware differ the application has to specify how to handle the
+cropping of the picture. This can be done using the
+VIDEO_SET_DISPLAY_FORMAT call (??) which accepts
+
+
+.. code-block:: c
+
+    typedef enum {
+        VIDEO_PAN_SCAN,       /* use pan and scan format */
+        VIDEO_LETTER_BOX,     /* use letterbox format */
+        VIDEO_CENTER_CUT_OUT  /* use center cut out format */
+    } video_displayformat_t;
+
+as argument.
+
+
+.. _video-stream-source-t:
+
+video_stream_source_t
+=====================
+
+The video stream source is set through the VIDEO_SELECT_SOURCE call
+and can take the following values, depending on whether we are replaying
+from an internal (demuxer) or external (user write) source.
+
+
+.. code-block:: c
+
+    typedef enum {
+        VIDEO_SOURCE_DEMUX, /* Select the demux as the main source */
+        VIDEO_SOURCE_MEMORY /* If this source is selected, the stream
+                       comes from the user through the write
+                       system call */
+    } video_stream_source_t;
+
+VIDEO_SOURCE_DEMUX selects the demultiplexer (fed either by the
+frontend or the DVR device) as the source of the video stream. If
+VIDEO_SOURCE_MEMORY is selected the stream comes from the application
+through the **write()** system call.
+
+
+.. _video-play-state-t:
+
+video_play_state_t
+==================
+
+The following values can be returned by the VIDEO_GET_STATUS call
+representing the state of video playback.
+
+
+.. code-block:: c
+
+    typedef enum {
+        VIDEO_STOPPED, /* Video is stopped */
+        VIDEO_PLAYING, /* Video is currently playing */
+        VIDEO_FREEZED  /* Video is freezed */
+    } video_play_state_t;
+
+
+.. _video-command:
+
+struct video_command
+====================
+
+The structure must be zeroed before use by the application This ensures
+it can be extended safely in the future.
+
+
+.. code-block:: c
+
+    struct video_command {
+        __u32 cmd;
+        __u32 flags;
+        union {
+            struct {
+                __u64 pts;
+            } stop;
+
+            struct {
+                /* 0 or 1000 specifies normal speed,
+                   1 specifies forward single stepping,
+                   -1 specifies backward single stepping,
+                   >>1: playback at speed/1000 of the normal speed,
+                   <-1: reverse playback at (-speed/1000) of the normal speed. */
+                __s32 speed;
+                __u32 format;
+            } play;
+
+            struct {
+                __u32 data[16];
+            } raw;
+        };
+    };
+
+
+.. _video-size-t:
+
+video_size_t
+============
+
+
+.. code-block:: c
+
+    typedef struct {
+        int w;
+        int h;
+        video_format_t aspect_ratio;
+    } video_size_t;
+
+
+.. _video-event:
+
+struct video_event
+==================
+
+The following is the structure of a video event as it is returned by the
+VIDEO_GET_EVENT call.
+
+
+.. code-block:: c
+
+    struct video_event {
+        __s32 type;
+    #define VIDEO_EVENT_SIZE_CHANGED    1
+    #define VIDEO_EVENT_FRAME_RATE_CHANGED  2
+    #define VIDEO_EVENT_DECODER_STOPPED     3
+    #define VIDEO_EVENT_VSYNC       4
+        __kernel_time_t timestamp;
+        union {
+            video_size_t size;
+            unsigned int frame_rate;    /* in frames per 1000sec */
+            unsigned char vsync_field;  /* unknown/odd/even/progressive */
+        } u;
+    };
+
+
+.. _video-status:
+
+struct video_status
+===================
+
+The VIDEO_GET_STATUS call returns the following structure informing
+about various states of the playback operation.
+
+
+.. code-block:: c
+
+    struct video_status {
+        int                   video_blank;   /* blank video on freeze? */
+        video_play_state_t    play_state;    /* current state of playback */
+        video_stream_source_t stream_source; /* current source (demux/memory) */
+        video_format_t        video_format;  /* current aspect ratio of stream */
+        video_displayformat_t display_format;/* selected cropping mode */
+    };
+
+If video_blank is set video will be blanked out if the channel is
+changed or if playback is stopped. Otherwise, the last picture will be
+displayed. play_state indicates if the video is currently frozen,
+stopped, or being played back. The stream_source corresponds to the
+seleted source for the video stream. It can come either from the
+demultiplexer or from memory. The video_format indicates the aspect
+ratio (one of 4:3 or 16:9) of the currently played video stream.
+Finally, display_format corresponds to the selected cropping mode in
+case the source video format is not the same as the format of the output
+device.
+
+
+.. _video-still-picture:
+
+struct video_still_picture
+==========================
+
+An I-frame displayed via the VIDEO_STILLPICTURE call is passed on
+within the following structure.
+
+
+.. code-block:: c
+
+    /* pointer to and size of a single iframe in memory */
+    struct video_still_picture {
+        char *iFrame;        /* pointer to a single iframe in memory */
+        int32_t size;
+    };
+
+
+.. _video_caps:
+
+video capabilities
+==================
+
+A call to VIDEO_GET_CAPABILITIES returns an unsigned integer with the
+following bits set according to the hardwares capabilities.
+
+
+.. code-block:: c
+
+     /* bit definitions for capabilities: */
+     /* can the hardware decode MPEG1 and/or MPEG2? */
+     #define VIDEO_CAP_MPEG1   1
+     #define VIDEO_CAP_MPEG2   2
+     /* can you send a system and/or program stream to video device?
+        (you still have to open the video and the audio device but only
+         send the stream to the video device) */
+     #define VIDEO_CAP_SYS     4
+     #define VIDEO_CAP_PROG    8
+     /* can the driver also handle SPU, NAVI and CSS encoded data?
+        (CSS API is not present yet) */
+     #define VIDEO_CAP_SPU    16
+     #define VIDEO_CAP_NAVI   32
+     #define VIDEO_CAP_CSS    64
+
+
+.. _video-system:
+
+video_system_t
+==============
+
+A call to VIDEO_SET_SYSTEM sets the desired video system for TV
+output. The following system types can be set:
+
+
+.. code-block:: c
+
+    typedef enum {
+         VIDEO_SYSTEM_PAL,
+         VIDEO_SYSTEM_NTSC,
+         VIDEO_SYSTEM_PALN,
+         VIDEO_SYSTEM_PALNc,
+         VIDEO_SYSTEM_PALM,
+         VIDEO_SYSTEM_NTSC60,
+         VIDEO_SYSTEM_PAL60,
+         VIDEO_SYSTEM_PALM60
+    } video_system_t;
+
+
+.. _video-highlight:
+
+struct video_highlight
+======================
+
+Calling the ioctl VIDEO_SET_HIGHLIGHTS posts the SPU highlight
+information. The call expects the following format for that information:
+
+
+.. code-block:: c
+
+     typedef
+     struct video_highlight {
+         boolean active;      /*    1=show highlight, 0=hide highlight */
+         uint8_t contrast1;   /*    7- 4  Pattern pixel contrast */
+                      /*    3- 0  Background pixel contrast */
+         uint8_t contrast2;   /*    7- 4  Emphasis pixel-2 contrast */
+                      /*    3- 0  Emphasis pixel-1 contrast */
+         uint8_t color1;      /*    7- 4  Pattern pixel color */
+                      /*    3- 0  Background pixel color */
+         uint8_t color2;      /*    7- 4  Emphasis pixel-2 color */
+                      /*    3- 0  Emphasis pixel-1 color */
+         uint32_t ypos;       /*   23-22  auto action mode */
+                      /*   21-12  start y */
+                      /*    9- 0  end y */
+         uint32_t xpos;       /*   23-22  button color number */
+                      /*   21-12  start x */
+                      /*    9- 0  end x */
+     } video_highlight_t;
+
+
+.. _video-spu:
+
+struct video_spu
+================
+
+Calling VIDEO_SET_SPU deactivates or activates SPU decoding, according
+to the following format:
+
+
+.. code-block:: c
+
+     typedef
+     struct video_spu {
+         boolean active;
+         int stream_id;
+     } video_spu_t;
+
+
+.. _video-spu-palette:
+
+struct video_spu_palette
+========================
+
+The following structure is used to set the SPU palette by calling
+VIDEO_SPU_PALETTE:
+
+
+.. code-block:: c
+
+     typedef
+     struct video_spu_palette {
+         int length;
+         uint8_t *palette;
+     } video_spu_palette_t;
+
+
+.. _video-navi-pack:
+
+struct video_navi_pack
+======================
+
+In order to get the navigational data the following structure has to be
+passed to the ioctl VIDEO_GET_NAVI:
+
+
+.. code-block:: c
+
+     typedef
+     struct video_navi_pack {
+         int length;         /* 0 ... 1024 */
+         uint8_t data[1024];
+     } video_navi_pack_t;
+
+
+.. _video-attributes-t:
+
+video_attributes_t
+==================
+
+The following attributes can be set by a call to VIDEO_SET_ATTRIBUTES:
+
+
+.. code-block:: c
+
+     typedef uint16_t video_attributes_t;
+     /*   bits: descr. */
+     /*   15-14 Video compression mode (0=MPEG-1, 1=MPEG-2) */
+     /*   13-12 TV system (0=525/60, 1=625/50) */
+     /*   11-10 Aspect ratio (0=4:3, 3=16:9) */
+     /*    9- 8 permitted display mode on 4:3 monitor (0=both, 1=only pan-sca */
+     /*    7    line 21-1 data present in GOP (1=yes, 0=no) */
+     /*    6    line 21-2 data present in GOP (1=yes, 0=no) */
+     /*    5- 3 source resolution (0=720x480/576, 1=704x480/576, 2=352x480/57 */
+     /*    2    source letterboxed (1=yes, 0=no) */
+     /*    0    film/camera mode (0=camera, 1=film (625/50 only)) */
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/Remote_controllers_Intro.rst b/Documentation/linux_tv/media/v4l/Remote_controllers_Intro.rst
new file mode 100644
index 000000000000..5e461ac39947
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/Remote_controllers_Intro.rst
@@ -0,0 +1,33 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _Remote_controllers_Intro:
+
+************
+Introduction
+************
+
+Currently, most analog and digital devices have a Infrared input for
+remote controllers. Each manufacturer has their own type of control. It
+is not rare for the same manufacturer to ship different types of
+controls, depending on the device.
+
+A Remote Controller interface is mapped as a normal evdev/input
+interface, just like a keyboard or a mouse. So, it uses all ioctls
+already defined for any other input devices.
+
+However, remove controllers are more flexible than a normal input
+device, as the IR receiver (and/or transmitter) can be used in
+conjunction with a wide variety of different IR remotes.
+
+In order to allow flexibility, the Remote Controller subsystem allows
+controlling the RC-specific attributes via
+:ref:`the sysfs class nodes <remote_controllers_sysfs_nodes>`.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/Remote_controllers_table_change.rst b/Documentation/linux_tv/media/v4l/Remote_controllers_table_change.rst
new file mode 100644
index 000000000000..a04cc2cbbbb3
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/Remote_controllers_table_change.rst
@@ -0,0 +1,29 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _Remote_controllers_table_change:
+
+*******************************************
+Changing default Remote Controller mappings
+*******************************************
+
+The event interface provides two ioctls to be used against the
+/dev/input/event device, to allow changing the default keymapping.
+
+This program demonstrates how to replace the keymap tables.
+
+
+.. toctree::
+    :maxdepth: 1
+
+    keytable.c
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/Remote_controllers_tables.rst b/Documentation/linux_tv/media/v4l/Remote_controllers_tables.rst
new file mode 100644
index 000000000000..2243d5b2dcd1
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/Remote_controllers_tables.rst
@@ -0,0 +1,768 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _Remote_controllers_tables:
+
+************************
+Remote controller tables
+************************
+
+Unfortunately, for several years, there was no effort to create uniform
+IR keycodes for different devices. This caused the same IR keyname to be
+mapped completely differently on different IR devices. This resulted
+that the same IR keyname to be mapped completely different on different
+IR's. Due to that, V4L2 API now specifies a standard for mapping Media
+keys on IR.
+
+This standard should be used by both V4L/DVB drivers and userspace
+applications
+
+The modules register the remote as keyboard within the linux input
+layer. This means that the IR key strokes will look like normal keyboard
+key strokes (if CONFIG_INPUT_KEYBOARD is enabled). Using the event
+devices (CONFIG_INPUT_EVDEV) it is possible for applications to access
+the remote via /dev/input/event devices.
+
+
+.. _rc_standard_keymap:
+
+.. flat-table:: IR default keymapping
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  Key code
+
+       -  Meaning
+
+       -  Key examples on IR
+
+    -  .. row 2
+
+       -  **Numeric keys**
+
+    -  .. row 3
+
+       -  ``KEY_0``
+
+       -  Keyboard digit 0
+
+       -  0
+
+    -  .. row 4
+
+       -  ``KEY_1``
+
+       -  Keyboard digit 1
+
+       -  1
+
+    -  .. row 5
+
+       -  ``KEY_2``
+
+       -  Keyboard digit 2
+
+       -  2
+
+    -  .. row 6
+
+       -  ``KEY_3``
+
+       -  Keyboard digit 3
+
+       -  3
+
+    -  .. row 7
+
+       -  ``KEY_4``
+
+       -  Keyboard digit 4
+
+       -  4
+
+    -  .. row 8
+
+       -  ``KEY_5``
+
+       -  Keyboard digit 5
+
+       -  5
+
+    -  .. row 9
+
+       -  ``KEY_6``
+
+       -  Keyboard digit 6
+
+       -  6
+
+    -  .. row 10
+
+       -  ``KEY_7``
+
+       -  Keyboard digit 7
+
+       -  7
+
+    -  .. row 11
+
+       -  ``KEY_8``
+
+       -  Keyboard digit 8
+
+       -  8
+
+    -  .. row 12
+
+       -  ``KEY_9``
+
+       -  Keyboard digit 9
+
+       -  9
+
+    -  .. row 13
+
+       -  **Movie play control**
+
+    -  .. row 14
+
+       -  ``KEY_FORWARD``
+
+       -  Instantly advance in time
+
+       -  >> / FORWARD
+
+    -  .. row 15
+
+       -  ``KEY_BACK``
+
+       -  Instantly go back in time
+
+       -  <<< / BACK
+
+    -  .. row 16
+
+       -  ``KEY_FASTFORWARD``
+
+       -  Play movie faster
+
+       -  >>> / FORWARD
+
+    -  .. row 17
+
+       -  ``KEY_REWIND``
+
+       -  Play movie back
+
+       -  REWIND / BACKWARD
+
+    -  .. row 18
+
+       -  ``KEY_NEXT``
+
+       -  Select next chapter / sub-chapter / interval
+
+       -  NEXT / SKIP
+
+    -  .. row 19
+
+       -  ``KEY_PREVIOUS``
+
+       -  Select previous chapter / sub-chapter / interval
+
+       -  << / PREV / PREVIOUS
+
+    -  .. row 20
+
+       -  ``KEY_AGAIN``
+
+       -  Repeat the video or a video interval
+
+       -  REPEAT / LOOP / RECALL
+
+    -  .. row 21
+
+       -  ``KEY_PAUSE``
+
+       -  Pause sroweam
+
+       -  PAUSE / FREEZE
+
+    -  .. row 22
+
+       -  ``KEY_PLAY``
+
+       -  Play movie at the normal timeshift
+
+       -  NORMAL TIMESHIFT / LIVE / >
+
+    -  .. row 23
+
+       -  ``KEY_PLAYPAUSE``
+
+       -  Alternate between play and pause
+
+       -  PLAY / PAUSE
+
+    -  .. row 24
+
+       -  ``KEY_STOP``
+
+       -  Stop sroweam
+
+       -  STOP
+
+    -  .. row 25
+
+       -  ``KEY_RECORD``
+
+       -  Start/stop recording sroweam
+
+       -  CAPTURE / REC / RECORD/PAUSE
+
+    -  .. row 26
+
+       -  ``KEY_CAMERA``
+
+       -  Take a picture of the image
+
+       -  CAMERA ICON / CAPTURE / SNAPSHOT
+
+    -  .. row 27
+
+       -  ``KEY_SHUFFLE``
+
+       -  Enable shuffle mode
+
+       -  SHUFFLE
+
+    -  .. row 28
+
+       -  ``KEY_TIME``
+
+       -  Activate time shift mode
+
+       -  TIME SHIFT
+
+    -  .. row 29
+
+       -  ``KEY_TITLE``
+
+       -  Allow changing the chapter
+
+       -  CHAPTER
+
+    -  .. row 30
+
+       -  ``KEY_SUBTITLE``
+
+       -  Allow changing the subtitle
+
+       -  SUBTITLE
+
+    -  .. row 31
+
+       -  **Image control**
+
+    -  .. row 32
+
+       -  ``KEY_BRIGHTNESSDOWN``
+
+       -  Decrease Brightness
+
+       -  BRIGHTNESS DECREASE
+
+    -  .. row 33
+
+       -  ``KEY_BRIGHTNESSUP``
+
+       -  Increase Brightness
+
+       -  BRIGHTNESS INCREASE
+
+    -  .. row 34
+
+       -  ``KEY_ANGLE``
+
+       -  Switch video camera angle (on videos with more than one angle
+          stored)
+
+       -  ANGLE / SWAP
+
+    -  .. row 35
+
+       -  ``KEY_EPG``
+
+       -  Open the Elecrowonic Play Guide (EPG)
+
+       -  EPG / GUIDE
+
+    -  .. row 36
+
+       -  ``KEY_TEXT``
+
+       -  Activate/change closed caption mode
+
+       -  CLOSED CAPTION/TELETEXT / DVD TEXT / TELETEXT / TTX
+
+    -  .. row 37
+
+       -  **Audio control**
+
+    -  .. row 38
+
+       -  ``KEY_AUDIO``
+
+       -  Change audio source
+
+       -  AUDIO SOURCE / AUDIO / MUSIC
+
+    -  .. row 39
+
+       -  ``KEY_MUTE``
+
+       -  Mute/unmute audio
+
+       -  MUTE / DEMUTE / UNMUTE
+
+    -  .. row 40
+
+       -  ``KEY_VOLUMEDOWN``
+
+       -  Decrease volume
+
+       -  VOLUME- / VOLUME DOWN
+
+    -  .. row 41
+
+       -  ``KEY_VOLUMEUP``
+
+       -  Increase volume
+
+       -  VOLUME+ / VOLUME UP
+
+    -  .. row 42
+
+       -  ``KEY_MODE``
+
+       -  Change sound mode
+
+       -  MONO/STEREO
+
+    -  .. row 43
+
+       -  ``KEY_LANGUAGE``
+
+       -  Select Language
+
+       -  1ST / 2ND LANGUAGE / DVD LANG / MTS/SAP / MTS SEL
+
+    -  .. row 44
+
+       -  **Channel control**
+
+    -  .. row 45
+
+       -  ``KEY_CHANNEL``
+
+       -  Go to the next favorite channel
+
+       -  ALT / CHANNEL / CH SURFING / SURF / FAV
+
+    -  .. row 46
+
+       -  ``KEY_CHANNELDOWN``
+
+       -  Decrease channel sequencially
+
+       -  CHANNEL - / CHANNEL DOWN / DOWN
+
+    -  .. row 47
+
+       -  ``KEY_CHANNELUP``
+
+       -  Increase channel sequencially
+
+       -  CHANNEL + / CHANNEL UP / UP
+
+    -  .. row 48
+
+       -  ``KEY_DIGITS``
+
+       -  Use more than one digit for channel
+
+       -  PLUS / 100/ 1xx / xxx / -/-- / Single Double Triple Digit
+
+    -  .. row 49
+
+       -  ``KEY_SEARCH``
+
+       -  Start channel autoscan
+
+       -  SCAN / AUTOSCAN
+
+    -  .. row 50
+
+       -  **Colored keys**
+
+    -  .. row 51
+
+       -  ``KEY_BLUE``
+
+       -  IR Blue key
+
+       -  BLUE
+
+    -  .. row 52
+
+       -  ``KEY_GREEN``
+
+       -  IR Green Key
+
+       -  GREEN
+
+    -  .. row 53
+
+       -  ``KEY_RED``
+
+       -  IR Red key
+
+       -  RED
+
+    -  .. row 54
+
+       -  ``KEY_YELLOW``
+
+       -  IR Yellow key
+
+       -  YELLOW
+
+    -  .. row 55
+
+       -  **Media selection**
+
+    -  .. row 56
+
+       -  ``KEY_CD``
+
+       -  Change input source to Compact Disc
+
+       -  CD
+
+    -  .. row 57
+
+       -  ``KEY_DVD``
+
+       -  Change input to DVD
+
+       -  DVD / DVD MENU
+
+    -  .. row 58
+
+       -  ``KEY_EJECTCLOSECD``
+
+       -  Open/close the CD/DVD player
+
+       -  -> ) / CLOSE / OPEN
+
+    -  .. row 59
+
+       -  ``KEY_MEDIA``
+
+       -  Turn on/off Media application
+
+       -  PC/TV / TURN ON/OFF APP
+
+    -  .. row 60
+
+       -  ``KEY_PC``
+
+       -  Selects from TV to PC
+
+       -  PC
+
+    -  .. row 61
+
+       -  ``KEY_RADIO``
+
+       -  Put into AM/FM radio mode
+
+       -  RADIO / TV/FM / TV/RADIO / FM / FM/RADIO
+
+    -  .. row 62
+
+       -  ``KEY_TV``
+
+       -  Select tv mode
+
+       -  TV / LIVE TV
+
+    -  .. row 63
+
+       -  ``KEY_TV2``
+
+       -  Select Cable mode
+
+       -  AIR/CBL
+
+    -  .. row 64
+
+       -  ``KEY_VCR``
+
+       -  Select VCR mode
+
+       -  VCR MODE / DTR
+
+    -  .. row 65
+
+       -  ``KEY_VIDEO``
+
+       -  Alternate between input modes
+
+       -  SOURCE / SELECT / DISPLAY / SWITCH INPUTS / VIDEO
+
+    -  .. row 66
+
+       -  **Power control**
+
+    -  .. row 67
+
+       -  ``KEY_POWER``
+
+       -  Turn on/off computer
+
+       -  SYSTEM POWER / COMPUTER POWER
+
+    -  .. row 68
+
+       -  ``KEY_POWER2``
+
+       -  Turn on/off application
+
+       -  TV ON/OFF / POWER
+
+    -  .. row 69
+
+       -  ``KEY_SLEEP``
+
+       -  Activate sleep timer
+
+       -  SLEEP / SLEEP TIMER
+
+    -  .. row 70
+
+       -  ``KEY_SUSPEND``
+
+       -  Put computer into suspend mode
+
+       -  STANDBY / SUSPEND
+
+    -  .. row 71
+
+       -  **Window control**
+
+    -  .. row 72
+
+       -  ``KEY_CLEAR``
+
+       -  Stop sroweam and return to default input video/audio
+
+       -  CLEAR / RESET / BOSS KEY
+
+    -  .. row 73
+
+       -  ``KEY_CYCLEWINDOWS``
+
+       -  Minimize windows and move to the next one
+
+       -  ALT-TAB / MINIMIZE / DESKTOP
+
+    -  .. row 74
+
+       -  ``KEY_FAVORITES``
+
+       -  Open the favorites sroweam window
+
+       -  TV WALL / Favorites
+
+    -  .. row 75
+
+       -  ``KEY_MENU``
+
+       -  Call application menu
+
+       -  2ND CONTROLS (USA: MENU) / DVD/MENU / SHOW/HIDE CTRL
+
+    -  .. row 76
+
+       -  ``KEY_NEW``
+
+       -  Open/Close Picture in Picture
+
+       -  PIP
+
+    -  .. row 77
+
+       -  ``KEY_OK``
+
+       -  Send a confirmation code to application
+
+       -  OK / ENTER / RETURN
+
+    -  .. row 78
+
+       -  ``KEY_SCREEN``
+
+       -  Select screen aspect ratio
+
+       -  4:3 16:9 SELECT
+
+    -  .. row 79
+
+       -  ``KEY_ZOOM``
+
+       -  Put device into zoom/full screen mode
+
+       -  ZOOM / FULL SCREEN / ZOOM+ / HIDE PANNEL / SWITCH
+
+    -  .. row 80
+
+       -  **Navigation keys**
+
+    -  .. row 81
+
+       -  ``KEY_ESC``
+
+       -  Cancel current operation
+
+       -  CANCEL / BACK
+
+    -  .. row 82
+
+       -  ``KEY_HELP``
+
+       -  Open a Help window
+
+       -  HELP
+
+    -  .. row 83
+
+       -  ``KEY_HOMEPAGE``
+
+       -  Navigate to Homepage
+
+       -  HOME
+
+    -  .. row 84
+
+       -  ``KEY_INFO``
+
+       -  Open On Screen Display
+
+       -  DISPLAY INFORMATION / OSD
+
+    -  .. row 85
+
+       -  ``KEY_WWW``
+
+       -  Open the default browser
+
+       -  WEB
+
+    -  .. row 86
+
+       -  ``KEY_UP``
+
+       -  Up key
+
+       -  UP
+
+    -  .. row 87
+
+       -  ``KEY_DOWN``
+
+       -  Down key
+
+       -  DOWN
+
+    -  .. row 88
+
+       -  ``KEY_LEFT``
+
+       -  Left key
+
+       -  LEFT
+
+    -  .. row 89
+
+       -  ``KEY_RIGHT``
+
+       -  Right key
+
+       -  RIGHT
+
+    -  .. row 90
+
+       -  **Miscellaneous keys**
+
+    -  .. row 91
+
+       -  ``KEY_DOT``
+
+       -  Return a dot
+
+       -  .
+
+    -  .. row 92
+
+       -  ``KEY_FN``
+
+       -  Select a function
+
+       -  FUNCTION
+
+
+It should be noted that, sometimes, there some fundamental missing keys
+at some cheaper IR's. Due to that, it is recommended to:
+
+
+.. _rc_keymap_notes:
+
+.. flat-table:: Notes
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  On simpler IR's, without separate channel keys, you need to map UP
+          as ``KEY_CHANNELUP``
+
+    -  .. row 2
+
+       -  On simpler IR's, without separate channel keys, you need to map
+          DOWN as ``KEY_CHANNELDOWN``
+
+    -  .. row 3
+
+       -  On simpler IR's, without separate volume keys, you need to map
+          LEFT as ``KEY_VOLUMEDOWN``
+
+    -  .. row 4
+
+       -  On simpler IR's, without separate volume keys, you need to map
+          RIGHT as ``KEY_VOLUMEUP``
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/app-pri.rst b/Documentation/linux_tv/media/v4l/app-pri.rst
new file mode 100644
index 000000000000..9716437ae14d
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/app-pri.rst
@@ -0,0 +1,39 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _app-pri:
+
+********************
+Application Priority
+********************
+
+When multiple applications share a device it may be desirable to assign
+them different priorities. Contrary to the traditional "rm -rf /" school
+of thought a video recording application could for example block other
+applications from changing video controls or switching the current TV
+channel. Another objective is to permit low priority applications
+working in background, which can be preempted by user controlled
+applications and automatically regain control of the device at a later
+time.
+
+Since these features cannot be implemented entirely in user space V4L2
+defines the :ref:`VIDIOC_G_PRIORITY <vidioc-g-priority>` and
+:ref:`VIDIOC_S_PRIORITY <vidioc-g-priority>` ioctls to request and
+query the access priority associate with a file descriptor. Opening a
+device assigns a medium priority, compatible with earlier versions of
+V4L2 and drivers not supporting these ioctls. Applications requiring a
+different priority will usually call ``VIDIOC_S_PRIORITY`` after
+verifying the device with the
+:ref:`VIDIOC_QUERYCAP <vidioc-querycap>` ioctl.
+
+Ioctls changing driver properties, such as
+:ref:`VIDIOC_S_INPUT <vidioc-g-input>`, return an EBUSY error code
+after another application obtained higher priority.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/async.rst b/Documentation/linux_tv/media/v4l/async.rst
new file mode 100644
index 000000000000..82a56e88a54d
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/async.rst
@@ -0,0 +1,18 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _async:
+
+****************
+Asynchronous I/O
+****************
+
+This method is not defined yet.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/audio.rst b/Documentation/linux_tv/media/v4l/audio.rst
new file mode 100644
index 000000000000..5e37adfbb49c
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/audio.rst
@@ -0,0 +1,97 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _audio:
+
+************************
+Audio Inputs and Outputs
+************************
+
+Audio inputs and outputs are physical connectors of a device. Video
+capture devices have inputs, output devices have outputs, zero or more
+each. Radio devices have no audio inputs or outputs. They have exactly
+one tuner which in fact *is* an audio source, but this API associates
+tuners with video inputs or outputs only, and radio devices have none of
+these. [1]_ A connector on a TV card to loop back the received audio
+signal to a sound card is not considered an audio output.
+
+Audio and video inputs and outputs are associated. Selecting a video
+source also selects an audio source. This is most evident when the video
+and audio source is a tuner. Further audio connectors can combine with
+more than one video input or output. Assumed two composite video inputs
+and two audio inputs exist, there may be up to four valid combinations.
+The relation of video and audio connectors is defined in the
+``audioset`` field of the respective struct
+:ref:`v4l2_input <v4l2-input>` or struct
+:ref:`v4l2_output <v4l2-output>`, where each bit represents the index
+number, starting at zero, of one audio input or output.
+
+To learn about the number and attributes of the available inputs and
+outputs applications can enumerate them with the
+:ref:`VIDIOC_ENUMAUDIO <vidioc-enumaudio>` and
+:ref:`VIDIOC_ENUMAUDOUT <vidioc-enumaudioout>` ioctl, respectively.
+The struct :ref:`v4l2_audio <v4l2-audio>` returned by the
+``VIDIOC_ENUMAUDIO`` ioctl also contains signal status information
+applicable when the current audio input is queried.
+
+The :ref:`VIDIOC_G_AUDIO <vidioc-g-audio>` and
+:ref:`VIDIOC_G_AUDOUT <vidioc-g-audioout>` ioctls report the current
+audio input and output, respectively. Note that, unlike
+:ref:`VIDIOC_G_INPUT <vidioc-g-input>` and
+:ref:`VIDIOC_G_OUTPUT <vidioc-g-output>` these ioctls return a
+structure as ``VIDIOC_ENUMAUDIO`` and ``VIDIOC_ENUMAUDOUT`` do, not just
+an index.
+
+To select an audio input and change its properties applications call the
+:ref:`VIDIOC_S_AUDIO <vidioc-g-audio>` ioctl. To select an audio
+output (which presently has no changeable properties) applications call
+the :ref:`VIDIOC_S_AUDOUT <vidioc-g-audioout>` ioctl.
+
+Drivers must implement all audio input ioctls when the device has
+multiple selectable audio inputs, all audio output ioctls when the
+device has multiple selectable audio outputs. When the device has any
+audio inputs or outputs the driver must set the ``V4L2_CAP_AUDIO`` flag
+in the struct :ref:`v4l2_capability <v4l2-capability>` returned by
+the :ref:`VIDIOC_QUERYCAP <vidioc-querycap>` ioctl.
+
+
+.. code-block:: c
+
+    struct v4l2_audio audio;
+
+    memset(&audio, 0, sizeof(audio));
+
+    if (-1 == ioctl(fd, VIDIOC_G_AUDIO, &audio)) {
+        perror("VIDIOC_G_AUDIO");
+        exit(EXIT_FAILURE);
+    }
+
+    printf("Current input: %s\\n", audio.name);
+
+
+.. code-block:: c
+
+    struct v4l2_audio audio;
+
+    memset(&audio, 0, sizeof(audio)); /* clear audio.mode, audio.reserved */
+
+    audio.index = 0;
+
+    if (-1 == ioctl(fd, VIDIOC_S_AUDIO, &audio)) {
+        perror("VIDIOC_S_AUDIO");
+        exit(EXIT_FAILURE);
+    }
+
+.. [1]
+   Actually struct :ref:`v4l2_audio <v4l2-audio>` ought to have a
+   ``tuner`` field like struct :ref:`v4l2_input <v4l2-input>`, not
+   only making the API more consistent but also permitting radio devices
+   with multiple tuners.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/biblio.rst b/Documentation/linux_tv/media/v4l/biblio.rst
new file mode 100644
index 000000000000..44dc7deb24b2
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/biblio.rst
@@ -0,0 +1,390 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+**********
+References
+**********
+
+
+.. _cea608:
+
+CEA 608-E
+=========
+
+
+:title:     CEA-608-E R-2014 "Line 21 Data Services"
+
+:author:    Consumer Electronics Association (http://www.ce.org)
+
+.. _en300294:
+
+EN 300 294
+==========
+
+
+:title:     EN 300 294 "625-line television Wide Screen Signalling (WSS)"
+
+:author:    European Telecommunication Standards Institute (http://www.etsi.org)
+
+.. _ets300231:
+
+ETS 300 231
+===========
+
+
+:title:     ETS 300 231 "Specification of the domestic video Programme Delivery Control system (PDC)"
+
+:author:    European Telecommunication Standards Institute (http://www.etsi.org)
+
+.. _ets300706:
+
+ETS 300 706
+===========
+
+
+:title:     ETS 300 706 "Enhanced Teletext specification"
+
+:author:    European Telecommunication Standards Institute (http://www.etsi.org)
+
+.. _mpeg2part1:
+
+ISO 13818-1
+===========
+
+
+:title:     ITU-T Rec. H.222.0 | ISO/IEC 13818-1 "Information technology — Generic coding of moving pictures and associated audio information: Systems"
+
+:author:    International Telecommunication Union (http://www.itu.ch), International Organisation for Standardisation (http://www.iso.ch)
+
+.. _mpeg2part2:
+
+ISO 13818-2
+===========
+
+
+:title:     ITU-T Rec. H.262 | ISO/IEC 13818-2 "Information technology — Generic coding of moving pictures and associated audio information: Video"
+
+:author:    International Telecommunication Union (http://www.itu.ch), International Organisation for Standardisation (http://www.iso.ch)
+
+.. _itu470:
+
+ITU BT.470
+==========
+
+
+:title:     ITU-R Recommendation BT.470-6 "Conventional Television Systems"
+
+:author:    International Telecommunication Union (http://www.itu.ch)
+
+.. _itu601:
+
+ITU BT.601
+==========
+
+
+:title:     ITU-R Recommendation BT.601-5 "Studio Encoding Parameters of Digital Television for Standard 4:3 and Wide-Screen 16:9 Aspect Ratios"
+
+:author:    International Telecommunication Union (http://www.itu.ch)
+
+.. _itu653:
+
+ITU BT.653
+==========
+
+
+:title:     ITU-R Recommendation BT.653-3 "Teletext systems"
+
+:author:    International Telecommunication Union (http://www.itu.ch)
+
+.. _itu709:
+
+ITU BT.709
+==========
+
+
+:title:     ITU-R Recommendation BT.709-5 "Parameter values for the HDTV standards for production and international programme exchange"
+
+:author:    International Telecommunication Union (http://www.itu.ch)
+
+.. _itu1119:
+
+ITU BT.1119
+===========
+
+
+:title:     ITU-R Recommendation BT.1119 "625-line television Wide Screen Signalling (WSS)"
+
+:author:    International Telecommunication Union (http://www.itu.ch)
+
+.. _jfif:
+
+JFIF
+====
+
+
+:title:     JPEG File Interchange Format
+:subtitle:  Version 1.02
+
+:author:    Independent JPEG Group (http://www.ijg.org)
+
+.. _itu-t81:
+
+ITU-T.81
+========
+
+
+:title:     ITU-T Recommendation T.81 "Information Technology — Digital Compression and Coding of Continous-Tone Still Images — Requirements and Guidelines"
+
+:author:    International Telecommunication Union (http://www.itu.int)
+
+.. _w3c-jpeg-jfif:
+
+W3C JPEG JFIF
+=============
+
+
+:title:     JPEG JFIF
+
+:author:    The World Wide Web Consortium (http://www.w3.org)
+
+.. _smpte12m:
+
+SMPTE 12M
+=========
+
+
+:title:     SMPTE 12M-1999 "Television, Audio and Film - Time and Control Code"
+
+:author:    Society of Motion Picture and Television Engineers (http://www.smpte.org)
+
+.. _smpte170m:
+
+SMPTE 170M
+==========
+
+
+:title:     SMPTE 170M-1999 "Television - Composite Analog Video Signal - NTSC for Studio Applications"
+
+:author:    Society of Motion Picture and Television Engineers (http://www.smpte.org)
+
+.. _smpte240m:
+
+SMPTE 240M
+==========
+
+
+:title:     SMPTE 240M-1999 "Television - Signal Parameters - 1125-Line High-Definition Production"
+
+:author:    Society of Motion Picture and Television Engineers (http://www.smpte.org)
+
+.. _smpte431:
+
+SMPTE RP 431-2
+==============
+
+
+:title:     SMPTE RP 431-2:2011 "D-Cinema Quality - Reference Projector and Environment"
+
+:author:    Society of Motion Picture and Television Engineers (http://www.smpte.org)
+
+.. _smpte2084:
+
+SMPTE ST 2084
+=============
+
+
+:title:     SMPTE ST 2084:2014 "High Dynamic Range Electro-Optical Transfer Function of Master Reference Displays"
+
+:author:    Society of Motion Picture and Television Engineers (http://www.smpte.org)
+
+.. _srgb:
+
+sRGB
+====
+
+
+:title:     IEC 61966-2-1 ed1.0 "Multimedia systems and equipment - Colour measurement and management - Part 2-1: Colour management - Default RGB colour space - sRGB"
+
+:author:    International Electrotechnical Commission (http://www.iec.ch)
+
+.. _sycc:
+
+sYCC
+====
+
+
+:title:     IEC 61966-2-1-am1 ed1.0 "Amendment 1 - Multimedia systems and equipment - Colour measurement and management - Part 2-1: Colour management - Default RGB colour space - sRGB"
+
+:author:    International Electrotechnical Commission (http://www.iec.ch)
+
+.. _xvycc:
+
+xvYCC
+=====
+
+
+:title:     IEC 61966-2-4 ed1.0 "Multimedia systems and equipment - Colour measurement and management - Part 2-4: Colour management - Extended-gamut YCC colour space for video applications - xvYCC"
+
+:author:    International Electrotechnical Commission (http://www.iec.ch)
+
+.. _adobergb:
+
+AdobeRGB
+========
+
+
+:title:     Adobe© RGB (1998) Color Image Encoding Version 2005-05
+
+:author:    Adobe Systems Incorporated (http://www.adobe.com)
+
+.. _oprgb:
+
+opRGB
+=====
+
+
+:title:     IEC 61966-2-5 "Multimedia systems and equipment - Colour measurement and management - Part 2-5: Colour management - Optional RGB colour space - opRGB"
+
+:author:    International Electrotechnical Commission (http://www.iec.ch)
+
+.. _itu2020:
+
+ITU BT.2020
+===========
+
+
+:title:     ITU-R Recommendation BT.2020 (08/2012) "Parameter values for ultra-high definition television systems for production and international programme exchange"
+
+:author:    International Telecommunication Union (http://www.itu.ch)
+
+.. _tech3213:
+
+EBU Tech 3213
+=============
+
+
+:title:     E.B.U. Standard for Chromaticity Tolerances for Studio Monitors"
+
+:author:    European Broadcast Union (http://www.ebu.ch)
+
+.. _iec62106:
+
+IEC 62106
+=========
+
+
+:title:     Specification of the radio data system (RDS) for VHF/FM sound broadcasting in the frequency range from 87,5 to 108,0 MHz
+
+:author:    International Electrotechnical Commission (http://www.iec.ch)
+
+.. _nrsc4:
+
+NRSC-4-B
+========
+
+
+:title:     NRSC-4-B: United States RBDS Standard
+
+:author:    National Radio Systems Committee (http://www.nrscstandards.org)
+
+.. _iso12232:
+
+ISO 12232:2006
+==============
+
+
+:title:     Photography — Digital still cameras — Determination of exposure index, ISO speed ratings, standard output sensitivity, and recommended exposure index
+
+:author:    International Organization for Standardization (http://www.iso.org)
+
+.. _cea861:
+
+CEA-861-E
+=========
+
+
+:title:     A DTV Profile for Uncompressed High Speed Digital Interfaces
+
+:author:    Consumer Electronics Association (http://www.ce.org)
+
+.. _vesadmt:
+
+VESA DMT
+========
+
+
+:title:     VESA and Industry Standards and Guidelines for Computer Display Monitor Timing (DMT)
+
+:author:    Video Electronics Standards Association (http://www.vesa.org)
+
+.. _vesaedid:
+
+EDID
+====
+
+
+:title:     VESA Enhanced Extended Display Identification Data Standard
+:subtitle:  Release A, Revision 2
+
+:author:    Video Electronics Standards Association (http://www.vesa.org)
+
+.. _hdcp:
+
+HDCP
+====
+
+
+:title:     High-bandwidth Digital Content Protection System
+:subtitle:  Revision 1.3
+
+:author:    Digital Content Protection LLC (http://www.digital-cp.com)
+
+.. _hdmi:
+
+HDMI
+====
+
+
+:title:     High-Definition Multimedia Interface
+:subtitle:  Specification Version 1.4a
+
+:author:    HDMI Licensing LLC (http://www.hdmi.org)
+
+.. _dp:
+
+DP
+==
+
+
+:title:     VESA DisplayPort Standard
+:subtitle:  Version 1, Revision 2
+
+:author:    Video Electronics Standards Association (http://www.vesa.org)
+
+.. _poynton:
+
+poynton
+=======
+
+
+:title:     Digital Video and HDTV, Algorithms and Interfaces
+
+:author:    Charles Poynton
+
+.. _colimg:
+
+colimg
+======
+
+
+:title:     Color Imaging: Fundamentals and Applications
+
+:author:    Erik Reinhard et al.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/buffer.rst b/Documentation/linux_tv/media/v4l/buffer.rst
new file mode 100644
index 000000000000..e4cec63979c2
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/buffer.rst
@@ -0,0 +1,966 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _buffer:
+
+*******
+Buffers
+*******
+
+A buffer contains data exchanged by application and driver using one of
+the Streaming I/O methods. In the multi-planar API, the data is held in
+planes, while the buffer structure acts as a container for the planes.
+Only pointers to buffers (planes) are exchanged, the data itself is not
+copied. These pointers, together with meta-information like timestamps
+or field parity, are stored in a struct :c:type:`struct v4l2_buffer`,
+argument to the :ref:`VIDIOC_QUERYBUF <vidioc-querybuf>`,
+:ref:`VIDIOC_QBUF <vidioc-qbuf>` and
+:ref:`VIDIOC_DQBUF <vidioc-qbuf>` ioctl. In the multi-planar API,
+some plane-specific members of struct :c:type:`struct v4l2_buffer`,
+such as pointers and sizes for each plane, are stored in struct
+:c:type:`struct v4l2_plane` instead. In that case, struct
+:c:type:`struct v4l2_buffer` contains an array of plane structures.
+
+Dequeued video buffers come with timestamps. The driver decides at which
+part of the frame and with which clock the timestamp is taken. Please
+see flags in the masks ``V4L2_BUF_FLAG_TIMESTAMP_MASK`` and
+``V4L2_BUF_FLAG_TSTAMP_SRC_MASK`` in :ref:`buffer-flags`. These flags
+are always valid and constant across all buffers during the whole video
+stream. Changes in these flags may take place as a side effect of
+:ref:`VIDIOC_S_INPUT <vidioc-g-input>` or
+:ref:`VIDIOC_S_OUTPUT <vidioc-g-output>` however. The
+``V4L2_BUF_FLAG_TIMESTAMP_COPY`` timestamp type which is used by e.g. on
+mem-to-mem devices is an exception to the rule: the timestamp source
+flags are copied from the OUTPUT video buffer to the CAPTURE video
+buffer.
+
+
+.. _v4l2-buffer:
+
+.. flat-table:: struct v4l2_buffer
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``index``
+
+       -  
+       -  Number of the buffer, set by the application except when calling
+          :ref:`VIDIOC_DQBUF <vidioc-qbuf>`, then it is set by the
+          driver. This field can range from zero to the number of buffers
+          allocated with the :ref:`VIDIOC_REQBUFS <vidioc-reqbufs>` ioctl
+          (struct :ref:`v4l2_requestbuffers <v4l2-requestbuffers>`
+          ``count``), plus any buffers allocated with
+          :ref:`VIDIOC_CREATE_BUFS <vidioc-create-bufs>` minus one.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``type``
+
+       -  
+       -  Type of the buffer, same as struct
+          :ref:`v4l2_format <v4l2-format>` ``type`` or struct
+          :ref:`v4l2_requestbuffers <v4l2-requestbuffers>` ``type``, set
+          by the application. See :ref:`v4l2-buf-type`
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``bytesused``
+
+       -  
+       -  The number of bytes occupied by the data in the buffer. It depends
+          on the negotiated data format and may change with each buffer for
+          compressed variable size data like JPEG images. Drivers must set
+          this field when ``type`` refers to a capture stream, applications
+          when it refers to an output stream. If the application sets this
+          to 0 for an output stream, then ``bytesused`` will be set to the
+          size of the buffer (see the ``length`` field of this struct) by
+          the driver. For multiplanar formats this field is ignored and the
+          ``planes`` pointer is used instead.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``flags``
+
+       -  
+       -  Flags set by the application or driver, see :ref:`buffer-flags`.
+
+    -  .. row 5
+
+       -  __u32
+
+       -  ``field``
+
+       -  
+       -  Indicates the field order of the image in the buffer, see
+          :ref:`v4l2-field`. This field is not used when the buffer
+          contains VBI data. Drivers must set it when ``type`` refers to a
+          capture stream, applications when it refers to an output stream.
+
+    -  .. row 6
+
+       -  struct timeval
+
+       -  ``timestamp``
+
+       -  
+       -  For capture streams this is time when the first data byte was
+          captured, as returned by the :c:func:`clock_gettime()` function
+          for the relevant clock id; see ``V4L2_BUF_FLAG_TIMESTAMP_*`` in
+          :ref:`buffer-flags`. For output streams the driver stores the
+          time at which the last data byte was actually sent out in the
+          ``timestamp`` field. This permits applications to monitor the
+          drift between the video and system clock. For output streams that
+          use ``V4L2_BUF_FLAG_TIMESTAMP_COPY`` the application has to fill
+          in the timestamp which will be copied by the driver to the capture
+          stream.
+
+    -  .. row 7
+
+       -  struct :ref:`v4l2_timecode <v4l2-timecode>`
+
+       -  ``timecode``
+
+       -  
+       -  When ``type`` is ``V4L2_BUF_TYPE_VIDEO_CAPTURE`` and the
+          ``V4L2_BUF_FLAG_TIMECODE`` flag is set in ``flags``, this
+          structure contains a frame timecode. In
+          :ref:`V4L2_FIELD_ALTERNATE <v4l2-field>` mode the top and
+          bottom field contain the same timecode. Timecodes are intended to
+          help video editing and are typically recorded on video tapes, but
+          also embedded in compressed formats like MPEG. This field is
+          independent of the ``timestamp`` and ``sequence`` fields.
+
+    -  .. row 8
+
+       -  __u32
+
+       -  ``sequence``
+
+       -  
+       -  Set by the driver, counting the frames (not fields!) in sequence.
+          This field is set for both input and output devices.
+
+    -  .. row 9
+
+       -  :cspan:`3`
+
+          In :ref:`V4L2_FIELD_ALTERNATE <v4l2-field>` mode the top and
+          bottom field have the same sequence number. The count starts at
+          zero and includes dropped or repeated frames. A dropped frame was
+          received by an input device but could not be stored due to lack of
+          free buffer space. A repeated frame was displayed again by an
+          output device because the application did not pass new data in
+          time.
+
+          Note this may count the frames received e.g. over USB, without
+          taking into account the frames dropped by the remote hardware due
+          to limited compression throughput or bus bandwidth. These devices
+          identify by not enumerating any video standards, see
+          :ref:`standard`.
+
+    -  .. row 10
+
+       -  __u32
+
+       -  ``memory``
+
+       -  
+       -  This field must be set by applications and/or drivers in
+          accordance with the selected I/O method. See :ref:`v4l2-memory`
+
+    -  .. row 11
+
+       -  union
+
+       -  ``m``
+
+    -  .. row 12
+
+       -  
+       -  __u32
+
+       -  ``offset``
+
+       -  For the single-planar API and when ``memory`` is
+          ``V4L2_MEMORY_MMAP`` this is the offset of the buffer from the
+          start of the device memory. The value is returned by the driver
+          and apart of serving as parameter to the
+          :ref:`mmap() <func-mmap>` function not useful for applications.
+          See :ref:`mmap` for details
+
+    -  .. row 13
+
+       -  
+       -  unsigned long
+
+       -  ``userptr``
+
+       -  For the single-planar API and when ``memory`` is
+          ``V4L2_MEMORY_USERPTR`` this is a pointer to the buffer (casted to
+          unsigned long type) in virtual memory, set by the application. See
+          :ref:`userp` for details.
+
+    -  .. row 14
+
+       -  
+       -  struct v4l2_plane
+
+       -  ``*planes``
+
+       -  When using the multi-planar API, contains a userspace pointer to
+          an array of struct :ref:`v4l2_plane <v4l2-plane>`. The size of
+          the array should be put in the ``length`` field of this
+          :c:type:`struct v4l2_buffer` structure.
+
+    -  .. row 15
+
+       -  
+       -  int
+
+       -  ``fd``
+
+       -  For the single-plane API and when ``memory`` is
+          ``V4L2_MEMORY_DMABUF`` this is the file descriptor associated with
+          a DMABUF buffer.
+
+    -  .. row 16
+
+       -  __u32
+
+       -  ``length``
+
+       -  
+       -  Size of the buffer (not the payload) in bytes for the
+          single-planar API. This is set by the driver based on the calls to
+          :ref:`VIDIOC_REQBUFS <vidioc-reqbufs>` and/or
+          :ref:`VIDIOC_CREATE_BUFS <vidioc-create-bufs>`. For the
+          multi-planar API the application sets this to the number of
+          elements in the ``planes`` array. The driver will fill in the
+          actual number of valid elements in that array.
+
+    -  .. row 17
+
+       -  __u32
+
+       -  ``reserved2``
+
+       -  
+       -  A place holder for future extensions. Drivers and applications
+          must set this to 0.
+
+    -  .. row 18
+
+       -  __u32
+
+       -  ``reserved``
+
+       -  
+       -  A place holder for future extensions. Drivers and applications
+          must set this to 0.
+
+
+
+.. _v4l2-plane:
+
+.. flat-table:: struct v4l2_plane
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``bytesused``
+
+       -  
+       -  The number of bytes occupied by data in the plane (its payload).
+          Drivers must set this field when ``type`` refers to a capture
+          stream, applications when it refers to an output stream. If the
+          application sets this to 0 for an output stream, then
+          ``bytesused`` will be set to the size of the plane (see the
+          ``length`` field of this struct) by the driver. Note that the
+          actual image data starts at ``data_offset`` which may not be 0.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``length``
+
+       -  
+       -  Size in bytes of the plane (not its payload). This is set by the
+          driver based on the calls to
+          :ref:`VIDIOC_REQBUFS <vidioc-reqbufs>` and/or
+          :ref:`VIDIOC_CREATE_BUFS <vidioc-create-bufs>`.
+
+    -  .. row 3
+
+       -  union
+
+       -  ``m``
+
+       -  
+       -  
+
+    -  .. row 4
+
+       -  
+       -  __u32
+
+       -  ``mem_offset``
+
+       -  When the memory type in the containing struct
+          :ref:`v4l2_buffer <v4l2-buffer>` is ``V4L2_MEMORY_MMAP``, this
+          is the value that should be passed to :ref:`mmap() <func-mmap>`,
+          similar to the ``offset`` field in struct
+          :ref:`v4l2_buffer <v4l2-buffer>`.
+
+    -  .. row 5
+
+       -  
+       -  unsigned long
+
+       -  ``userptr``
+
+       -  When the memory type in the containing struct
+          :ref:`v4l2_buffer <v4l2-buffer>` is ``V4L2_MEMORY_USERPTR``,
+          this is a userspace pointer to the memory allocated for this plane
+          by an application.
+
+    -  .. row 6
+
+       -  
+       -  int
+
+       -  ``fd``
+
+       -  When the memory type in the containing struct
+          :ref:`v4l2_buffer <v4l2-buffer>` is ``V4L2_MEMORY_DMABUF``,
+          this is a file descriptor associated with a DMABUF buffer, similar
+          to the ``fd`` field in struct :ref:`v4l2_buffer <v4l2-buffer>`.
+
+    -  .. row 7
+
+       -  __u32
+
+       -  ``data_offset``
+
+       -  
+       -  Offset in bytes to video data in the plane. Drivers must set this
+          field when ``type`` refers to a capture stream, applications when
+          it refers to an output stream. Note that data_offset is included
+          in ``bytesused``. So the size of the image in the plane is
+          ``bytesused``-``data_offset`` at offset ``data_offset`` from the
+          start of the plane.
+
+    -  .. row 8
+
+       -  __u32
+
+       -  ``reserved[11]``
+
+       -  
+       -  Reserved for future use. Should be zeroed by drivers and
+          applications.
+
+
+
+.. _v4l2-buf-type:
+
+.. flat-table:: enum v4l2_buf_type
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_BUF_TYPE_VIDEO_CAPTURE``
+
+       -  1
+
+       -  Buffer of a single-planar video capture stream, see
+          :ref:`capture`.
+
+    -  .. row 2
+
+       -  ``V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE``
+
+       -  9
+
+       -  Buffer of a multi-planar video capture stream, see
+          :ref:`capture`.
+
+    -  .. row 3
+
+       -  ``V4L2_BUF_TYPE_VIDEO_OUTPUT``
+
+       -  2
+
+       -  Buffer of a single-planar video output stream, see
+          :ref:`output`.
+
+    -  .. row 4
+
+       -  ``V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE``
+
+       -  10
+
+       -  Buffer of a multi-planar video output stream, see :ref:`output`.
+
+    -  .. row 5
+
+       -  ``V4L2_BUF_TYPE_VIDEO_OVERLAY``
+
+       -  3
+
+       -  Buffer for video overlay, see :ref:`overlay`.
+
+    -  .. row 6
+
+       -  ``V4L2_BUF_TYPE_VBI_CAPTURE``
+
+       -  4
+
+       -  Buffer of a raw VBI capture stream, see :ref:`raw-vbi`.
+
+    -  .. row 7
+
+       -  ``V4L2_BUF_TYPE_VBI_OUTPUT``
+
+       -  5
+
+       -  Buffer of a raw VBI output stream, see :ref:`raw-vbi`.
+
+    -  .. row 8
+
+       -  ``V4L2_BUF_TYPE_SLICED_VBI_CAPTURE``
+
+       -  6
+
+       -  Buffer of a sliced VBI capture stream, see :ref:`sliced`.
+
+    -  .. row 9
+
+       -  ``V4L2_BUF_TYPE_SLICED_VBI_OUTPUT``
+
+       -  7
+
+       -  Buffer of a sliced VBI output stream, see :ref:`sliced`.
+
+    -  .. row 10
+
+       -  ``V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY``
+
+       -  8
+
+       -  Buffer for video output overlay (OSD), see :ref:`osd`.
+
+    -  .. row 11
+
+       -  ``V4L2_BUF_TYPE_SDR_CAPTURE``
+
+       -  11
+
+       -  Buffer for Software Defined Radio (SDR) capture stream, see
+          :ref:`sdr`.
+
+    -  .. row 12
+
+       -  ``V4L2_BUF_TYPE_SDR_OUTPUT``
+
+       -  12
+
+       -  Buffer for Software Defined Radio (SDR) output stream, see
+          :ref:`sdr`.
+
+
+
+.. _buffer-flags:
+
+.. flat-table:: Buffer Flags
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_BUF_FLAG_MAPPED``
+
+       -  0x00000001
+
+       -  The buffer resides in device memory and has been mapped into the
+          application's address space, see :ref:`mmap` for details.
+          Drivers set or clear this flag when the
+          :ref:`VIDIOC_QUERYBUF <vidioc-querybuf>`,
+          :ref:`VIDIOC_QBUF <vidioc-qbuf>` or
+          :ref:`VIDIOC_DQBUF <vidioc-qbuf>` ioctl is called. Set by the
+          driver.
+
+    -  .. row 2
+
+       -  ``V4L2_BUF_FLAG_QUEUED``
+
+       -  0x00000002
+
+       -  Internally drivers maintain two buffer queues, an incoming and
+          outgoing queue. When this flag is set, the buffer is currently on
+          the incoming queue. It automatically moves to the outgoing queue
+          after the buffer has been filled (capture devices) or displayed
+          (output devices). Drivers set or clear this flag when the
+          ``VIDIOC_QUERYBUF`` ioctl is called. After (successful) calling
+          the ``VIDIOC_QBUF``\ ioctl it is always set and after
+          ``VIDIOC_DQBUF`` always cleared.
+
+    -  .. row 3
+
+       -  ``V4L2_BUF_FLAG_DONE``
+
+       -  0x00000004
+
+       -  When this flag is set, the buffer is currently on the outgoing
+          queue, ready to be dequeued from the driver. Drivers set or clear
+          this flag when the ``VIDIOC_QUERYBUF`` ioctl is called. After
+          calling the ``VIDIOC_QBUF`` or ``VIDIOC_DQBUF`` it is always
+          cleared. Of course a buffer cannot be on both queues at the same
+          time, the ``V4L2_BUF_FLAG_QUEUED`` and ``V4L2_BUF_FLAG_DONE`` flag
+          are mutually exclusive. They can be both cleared however, then the
+          buffer is in "dequeued" state, in the application domain so to
+          say.
+
+    -  .. row 4
+
+       -  ``V4L2_BUF_FLAG_ERROR``
+
+       -  0x00000040
+
+       -  When this flag is set, the buffer has been dequeued successfully,
+          although the data might have been corrupted. This is recoverable,
+          streaming may continue as normal and the buffer may be reused
+          normally. Drivers set this flag when the ``VIDIOC_DQBUF`` ioctl is
+          called.
+
+    -  .. row 5
+
+       -  ``V4L2_BUF_FLAG_KEYFRAME``
+
+       -  0x00000008
+
+       -  Drivers set or clear this flag when calling the ``VIDIOC_DQBUF``
+          ioctl. It may be set by video capture devices when the buffer
+          contains a compressed image which is a key frame (or field), i. e.
+          can be decompressed on its own. Also known as an I-frame.
+          Applications can set this bit when ``type`` refers to an output
+          stream.
+
+    -  .. row 6
+
+       -  ``V4L2_BUF_FLAG_PFRAME``
+
+       -  0x00000010
+
+       -  Similar to ``V4L2_BUF_FLAG_KEYFRAME`` this flags predicted frames
+          or fields which contain only differences to a previous key frame.
+          Applications can set this bit when ``type`` refers to an output
+          stream.
+
+    -  .. row 7
+
+       -  ``V4L2_BUF_FLAG_BFRAME``
+
+       -  0x00000020
+
+       -  Similar to ``V4L2_BUF_FLAG_KEYFRAME`` this flags a bi-directional
+          predicted frame or field which contains only the differences
+          between the current frame and both the preceding and following key
+          frames to specify its content. Applications can set this bit when
+          ``type`` refers to an output stream.
+
+    -  .. row 8
+
+       -  ``V4L2_BUF_FLAG_TIMECODE``
+
+       -  0x00000100
+
+       -  The ``timecode`` field is valid. Drivers set or clear this flag
+          when the ``VIDIOC_DQBUF`` ioctl is called. Applications can set
+          this bit and the corresponding ``timecode`` structure when
+          ``type`` refers to an output stream.
+
+    -  .. row 9
+
+       -  ``V4L2_BUF_FLAG_PREPARED``
+
+       -  0x00000400
+
+       -  The buffer has been prepared for I/O and can be queued by the
+          application. Drivers set or clear this flag when the
+          :ref:`VIDIOC_QUERYBUF <vidioc-querybuf>`,
+          :ref:`VIDIOC_PREPARE_BUF <vidioc-qbuf>`,
+          :ref:`VIDIOC_QBUF <vidioc-qbuf>` or
+          :ref:`VIDIOC_DQBUF <vidioc-qbuf>` ioctl is called.
+
+    -  .. row 10
+
+       -  ``V4L2_BUF_FLAG_NO_CACHE_INVALIDATE``
+
+       -  0x00000800
+
+       -  Caches do not have to be invalidated for this buffer. Typically
+          applications shall use this flag if the data captured in the
+          buffer is not going to be touched by the CPU, instead the buffer
+          will, probably, be passed on to a DMA-capable hardware unit for
+          further processing or output.
+
+    -  .. row 11
+
+       -  ``V4L2_BUF_FLAG_NO_CACHE_CLEAN``
+
+       -  0x00001000
+
+       -  Caches do not have to be cleaned for this buffer. Typically
+          applications shall use this flag for output buffers if the data in
+          this buffer has not been created by the CPU but by some
+          DMA-capable unit, in which case caches have not been used.
+
+    -  .. row 12
+
+       -  ``V4L2_BUF_FLAG_LAST``
+
+       -  0x00100000
+
+       -  Last buffer produced by the hardware. mem2mem codec drivers set
+          this flag on the capture queue for the last buffer when the
+          :ref:`VIDIOC_QUERYBUF <vidioc-querybuf>` or
+          :ref:`VIDIOC_DQBUF <vidioc-qbuf>` ioctl is called. Due to
+          hardware limitations, the last buffer may be empty. In this case
+          the driver will set the ``bytesused`` field to 0, regardless of
+          the format. Any Any subsequent call to the
+          :ref:`VIDIOC_DQBUF <vidioc-qbuf>` ioctl will not block anymore,
+          but return an EPIPE error code.
+
+    -  .. row 13
+
+       -  ``V4L2_BUF_FLAG_TIMESTAMP_MASK``
+
+       -  0x0000e000
+
+       -  Mask for timestamp types below. To test the timestamp type, mask
+          out bits not belonging to timestamp type by performing a logical
+          and operation with buffer flags and timestamp mask.
+
+    -  .. row 14
+
+       -  ``V4L2_BUF_FLAG_TIMESTAMP_UNKNOWN``
+
+       -  0x00000000
+
+       -  Unknown timestamp type. This type is used by drivers before Linux
+          3.9 and may be either monotonic (see below) or realtime (wall
+          clock). Monotonic clock has been favoured in embedded systems
+          whereas most of the drivers use the realtime clock. Either kinds
+          of timestamps are available in user space via
+          :c:func:`clock_gettime(2)` using clock IDs ``CLOCK_MONOTONIC``
+          and ``CLOCK_REALTIME``, respectively.
+
+    -  .. row 15
+
+       -  ``V4L2_BUF_FLAG_TIMESTAMP_MONOTONIC``
+
+       -  0x00002000
+
+       -  The buffer timestamp has been taken from the ``CLOCK_MONOTONIC``
+          clock. To access the same clock outside V4L2, use
+          :c:func:`clock_gettime(2)`.
+
+    -  .. row 16
+
+       -  ``V4L2_BUF_FLAG_TIMESTAMP_COPY``
+
+       -  0x00004000
+
+       -  The CAPTURE buffer timestamp has been taken from the corresponding
+          OUTPUT buffer. This flag applies only to mem2mem devices.
+
+    -  .. row 17
+
+       -  ``V4L2_BUF_FLAG_TSTAMP_SRC_MASK``
+
+       -  0x00070000
+
+       -  Mask for timestamp sources below. The timestamp source defines the
+          point of time the timestamp is taken in relation to the frame.
+          Logical 'and' operation between the ``flags`` field and
+          ``V4L2_BUF_FLAG_TSTAMP_SRC_MASK`` produces the value of the
+          timestamp source. Applications must set the timestamp source when
+          ``type`` refers to an output stream and
+          ``V4L2_BUF_FLAG_TIMESTAMP_COPY`` is set.
+
+    -  .. row 18
+
+       -  ``V4L2_BUF_FLAG_TSTAMP_SRC_EOF``
+
+       -  0x00000000
+
+       -  End Of Frame. The buffer timestamp has been taken when the last
+          pixel of the frame has been received or the last pixel of the
+          frame has been transmitted. In practice, software generated
+          timestamps will typically be read from the clock a small amount of
+          time after the last pixel has been received or transmitten,
+          depending on the system and other activity in it.
+
+    -  .. row 19
+
+       -  ``V4L2_BUF_FLAG_TSTAMP_SRC_SOE``
+
+       -  0x00010000
+
+       -  Start Of Exposure. The buffer timestamp has been taken when the
+          exposure of the frame has begun. This is only valid for the
+          ``V4L2_BUF_TYPE_VIDEO_CAPTURE`` buffer type.
+
+
+
+.. _v4l2-memory:
+
+.. flat-table:: enum v4l2_memory
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_MEMORY_MMAP``
+
+       -  1
+
+       -  The buffer is used for :ref:`memory mapping <mmap>` I/O.
+
+    -  .. row 2
+
+       -  ``V4L2_MEMORY_USERPTR``
+
+       -  2
+
+       -  The buffer is used for :ref:`user pointer <userp>` I/O.
+
+    -  .. row 3
+
+       -  ``V4L2_MEMORY_OVERLAY``
+
+       -  3
+
+       -  [to do]
+
+    -  .. row 4
+
+       -  ``V4L2_MEMORY_DMABUF``
+
+       -  4
+
+       -  The buffer is used for :ref:`DMA shared buffer <dmabuf>` I/O.
+
+
+
+Timecodes
+=========
+
+The :c:type:`struct v4l2_timecode` structure is designed to hold a
+:ref:`smpte12m` or similar timecode. (struct
+:c:type:`struct timeval` timestamps are stored in struct
+:ref:`v4l2_buffer <v4l2-buffer>` field ``timestamp``.)
+
+
+.. _v4l2-timecode:
+
+.. flat-table:: struct v4l2_timecode
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``type``
+
+       -  Frame rate the timecodes are based on, see :ref:`timecode-type`.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``flags``
+
+       -  Timecode flags, see :ref:`timecode-flags`.
+
+    -  .. row 3
+
+       -  __u8
+
+       -  ``frames``
+
+       -  Frame count, 0 ... 23/24/29/49/59, depending on the type of
+          timecode.
+
+    -  .. row 4
+
+       -  __u8
+
+       -  ``seconds``
+
+       -  Seconds count, 0 ... 59. This is a binary, not BCD number.
+
+    -  .. row 5
+
+       -  __u8
+
+       -  ``minutes``
+
+       -  Minutes count, 0 ... 59. This is a binary, not BCD number.
+
+    -  .. row 6
+
+       -  __u8
+
+       -  ``hours``
+
+       -  Hours count, 0 ... 29. This is a binary, not BCD number.
+
+    -  .. row 7
+
+       -  __u8
+
+       -  ``userbits``\ [4]
+
+       -  The "user group" bits from the timecode.
+
+
+
+.. _timecode-type:
+
+.. flat-table:: Timecode Types
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_TC_TYPE_24FPS``
+
+       -  1
+
+       -  24 frames per second, i. e. film.
+
+    -  .. row 2
+
+       -  ``V4L2_TC_TYPE_25FPS``
+
+       -  2
+
+       -  25 frames per second, i. e. PAL or SECAM video.
+
+    -  .. row 3
+
+       -  ``V4L2_TC_TYPE_30FPS``
+
+       -  3
+
+       -  30 frames per second, i. e. NTSC video.
+
+    -  .. row 4
+
+       -  ``V4L2_TC_TYPE_50FPS``
+
+       -  4
+
+       -  
+
+    -  .. row 5
+
+       -  ``V4L2_TC_TYPE_60FPS``
+
+       -  5
+
+       -  
+
+
+
+.. _timecode-flags:
+
+.. flat-table:: Timecode Flags
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_TC_FLAG_DROPFRAME``
+
+       -  0x0001
+
+       -  Indicates "drop frame" semantics for counting frames in 29.97 fps
+          material. When set, frame numbers 0 and 1 at the start of each
+          minute, except minutes 0, 10, 20, 30, 40, 50 are omitted from the
+          count.
+
+    -  .. row 2
+
+       -  ``V4L2_TC_FLAG_COLORFRAME``
+
+       -  0x0002
+
+       -  The "color frame" flag.
+
+    -  .. row 3
+
+       -  ``V4L2_TC_USERBITS_field``
+
+       -  0x000C
+
+       -  Field mask for the "binary group flags".
+
+    -  .. row 4
+
+       -  ``V4L2_TC_USERBITS_USERDEFINED``
+
+       -  0x0000
+
+       -  Unspecified format.
+
+    -  .. row 5
+
+       -  ``V4L2_TC_USERBITS_8BITCHARS``
+
+       -  0x0008
+
+       -  8-bit ISO characters.
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/capture-example.rst b/Documentation/linux_tv/media/v4l/capture-example.rst
new file mode 100644
index 000000000000..8d35e379cea7
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/capture-example.rst
@@ -0,0 +1,24 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _capture-example:
+
+*********************
+Video Capture Example
+*********************
+
+
+.. toctree::
+    :maxdepth: 1
+
+    capture.c
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/capture.c.rst b/Documentation/linux_tv/media/v4l/capture.c.rst
new file mode 100644
index 000000000000..41e96c78a6dd
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/capture.c.rst
@@ -0,0 +1,675 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+file: media/v4l/capture.c
+=========================
+
+.. code-block:: c
+
+    /*
+     *  V4L2 video capture example
+     *
+     *  This program can be used and distributed without restrictions.
+     *
+     *      This program is provided with the V4L2 API
+     * see https://linuxtv.org/docs.php for more information
+     */
+
+    #include <stdio.h>
+    #include <stdlib.h>
+    #include <string.h>
+    #include <assert.h>
+
+    #include <getopt.h>             /* getopt_long() */
+
+    #include <fcntl.h>              /* low-level i/o */
+    #include <unistd.h>
+    #include <errno.h>
+    #include <sys/stat.h>
+    #include <sys/types.h>
+    #include <sys/time.h>
+    #include <sys/mman.h>
+    #include <sys/ioctl.h>
+
+    #include <linux/videodev2.h>
+
+    #define CLEAR(x) memset(&(x), 0, sizeof(x))
+
+    enum io_method {
+            IO_METHOD_READ,
+            IO_METHOD_MMAP,
+            IO_METHOD_USERPTR,
+    };
+
+    struct buffer {
+            void   *start;
+            size_t  length;
+    };
+
+    static char            *dev_name;
+    static enum io_method   io = IO_METHOD_MMAP;
+    static int              fd = -1;
+    struct buffer          *buffers;
+    static unsigned int     n_buffers;
+    static int              out_buf;
+    static int              force_format;
+    static int              frame_count = 70;
+
+    static void errno_exit(const char *s)
+    {
+            fprintf(stderr, "%s error %d, %s\\n", s, errno, strerror(errno));
+            exit(EXIT_FAILURE);
+    }
+
+    static int xioctl(int fh, int request, void *arg)
+    {
+            int r;
+
+            do {
+                    r = ioctl(fh, request, arg);
+            } while (-1 == r && EINTR == errno);
+
+            return r;
+    }
+
+    static void process_image(const void *p, int size)
+    {
+            if (out_buf)
+                    fwrite(p, size, 1, stdout);
+
+            fflush(stderr);
+            fprintf(stderr, ".");
+            fflush(stdout);
+    }
+
+    static int read_frame(void)
+    {
+            struct v4l2_buffer buf;
+            unsigned int i;
+
+            switch (io) {
+            case IO_METHOD_READ:
+                    if (-1 == read(fd, buffers[0].start, buffers[0].length)) {
+                            switch (errno) {
+                            case EAGAIN:
+                                    return 0;
+
+                            case EIO:
+                                    /* Could ignore EIO, see spec. */
+
+                                    /* fall through */
+
+                            default:
+                                    errno_exit("read");
+                            }
+                    }
+
+                    process_image(buffers[0].start, buffers[0].length);
+                    break;
+
+            case IO_METHOD_MMAP:
+                    CLEAR(buf);
+
+                    buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
+                    buf.memory = V4L2_MEMORY_MMAP;
+
+                    if (-1 == xioctl(fd, VIDIOC_DQBUF, &buf)) {
+                            switch (errno) {
+                            case EAGAIN:
+                                    return 0;
+
+                            case EIO:
+                                    /* Could ignore EIO, see spec. */
+
+                                    /* fall through */
+
+                            default:
+                                    errno_exit("VIDIOC_DQBUF");
+                            }
+                    }
+
+                    assert(buf.index < n_buffers);
+
+                    process_image(buffers[buf.index].start, buf.bytesused);
+
+                    if (-1 == xioctl(fd, VIDIOC_QBUF, &buf))
+                            errno_exit("VIDIOC_QBUF");
+                    break;
+
+            case IO_METHOD_USERPTR:
+                    CLEAR(buf);
+
+                    buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
+                    buf.memory = V4L2_MEMORY_USERPTR;
+
+                    if (-1 == xioctl(fd, VIDIOC_DQBUF, &buf)) {
+                            switch (errno) {
+                            case EAGAIN:
+                                    return 0;
+
+                            case EIO:
+                                    /* Could ignore EIO, see spec. */
+
+                                    /* fall through */
+
+                            default:
+                                    errno_exit("VIDIOC_DQBUF");
+                            }
+                    }
+
+                    for (i = 0; i < n_buffers; ++i)
+                            if (buf.m.userptr == (unsigned long)buffers[i].start
+                                && buf.length == buffers[i].length)
+                                    break;
+
+                    assert(i < n_buffers);
+
+                    process_image((void *)buf.m.userptr, buf.bytesused);
+
+                    if (-1 == xioctl(fd, VIDIOC_QBUF, &buf))
+                            errno_exit("VIDIOC_QBUF");
+                    break;
+            }
+
+            return 1;
+    }
+
+    static void mainloop(void)
+    {
+            unsigned int count;
+
+            count = frame_count;
+
+            while (count-- > 0) {
+                    for (;;) {
+                            fd_set fds;
+                            struct timeval tv;
+                            int r;
+
+                            FD_ZERO(&fds);
+                            FD_SET(fd, &fds);
+
+                            /* Timeout. */
+                            tv.tv_sec = 2;
+                            tv.tv_usec = 0;
+
+                            r = select(fd + 1, &fds, NULL, NULL, &tv);
+
+                            if (-1 == r) {
+                                    if (EINTR == errno)
+                                            continue;
+                                    errno_exit("select");
+                            }
+
+                            if (0 == r) {
+                                    fprintf(stderr, "select timeout\\n");
+                                    exit(EXIT_FAILURE);
+                            }
+
+                            if (read_frame())
+                                    break;
+                            /* EAGAIN - continue select loop. */
+                    }
+            }
+    }
+
+    static void stop_capturing(void)
+    {
+            enum v4l2_buf_type type;
+
+            switch (io) {
+            case IO_METHOD_READ:
+                    /* Nothing to do. */
+                    break;
+
+            case IO_METHOD_MMAP:
+            case IO_METHOD_USERPTR:
+                    type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
+                    if (-1 == xioctl(fd, VIDIOC_STREAMOFF, &type))
+                            errno_exit("VIDIOC_STREAMOFF");
+                    break;
+            }
+    }
+
+    static void start_capturing(void)
+    {
+            unsigned int i;
+            enum v4l2_buf_type type;
+
+            switch (io) {
+            case IO_METHOD_READ:
+                    /* Nothing to do. */
+                    break;
+
+            case IO_METHOD_MMAP:
+                    for (i = 0; i < n_buffers; ++i) {
+                            struct v4l2_buffer buf;
+
+                            CLEAR(buf);
+                            buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
+                            buf.memory = V4L2_MEMORY_MMAP;
+                            buf.index = i;
+
+                            if (-1 == xioctl(fd, VIDIOC_QBUF, &buf))
+                                    errno_exit("VIDIOC_QBUF");
+                    }
+                    type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
+                    if (-1 == xioctl(fd, VIDIOC_STREAMON, &type))
+                            errno_exit("VIDIOC_STREAMON");
+                    break;
+
+            case IO_METHOD_USERPTR:
+                    for (i = 0; i < n_buffers; ++i) {
+                            struct v4l2_buffer buf;
+
+                            CLEAR(buf);
+                            buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
+                            buf.memory = V4L2_MEMORY_USERPTR;
+                            buf.index = i;
+                            buf.m.userptr = (unsigned long)buffers[i].start;
+                            buf.length = buffers[i].length;
+
+                            if (-1 == xioctl(fd, VIDIOC_QBUF, &buf))
+                                    errno_exit("VIDIOC_QBUF");
+                    }
+                    type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
+                    if (-1 == xioctl(fd, VIDIOC_STREAMON, &type))
+                            errno_exit("VIDIOC_STREAMON");
+                    break;
+            }
+    }
+
+    static void uninit_device(void)
+    {
+            unsigned int i;
+
+            switch (io) {
+            case IO_METHOD_READ:
+                    free(buffers[0].start);
+                    break;
+
+            case IO_METHOD_MMAP:
+                    for (i = 0; i < n_buffers; ++i)
+                            if (-1 == munmap(buffers[i].start, buffers[i].length))
+                                    errno_exit("munmap");
+                    break;
+
+            case IO_METHOD_USERPTR:
+                    for (i = 0; i < n_buffers; ++i)
+                            free(buffers[i].start);
+                    break;
+            }
+
+            free(buffers);
+    }
+
+    static void init_read(unsigned int buffer_size)
+    {
+            buffers = calloc(1, sizeof(*buffers));
+
+            if (!buffers) {
+                    fprintf(stderr, "Out of memory\\n");
+                    exit(EXIT_FAILURE);
+            }
+
+            buffers[0].length = buffer_size;
+            buffers[0].start = malloc(buffer_size);
+
+            if (!buffers[0].start) {
+                    fprintf(stderr, "Out of memory\\n");
+                    exit(EXIT_FAILURE);
+            }
+    }
+
+    static void init_mmap(void)
+    {
+            struct v4l2_requestbuffers req;
+
+            CLEAR(req);
+
+            req.count = 4;
+            req.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
+            req.memory = V4L2_MEMORY_MMAP;
+
+            if (-1 == xioctl(fd, VIDIOC_REQBUFS, &req)) {
+                    if (EINVAL == errno) {
+                            fprintf(stderr, "%s does not support "
+                                     "memory mappingn", dev_name);
+                            exit(EXIT_FAILURE);
+                    } else {
+                            errno_exit("VIDIOC_REQBUFS");
+                    }
+            }
+
+            if (req.count < 2) {
+                    fprintf(stderr, "Insufficient buffer memory on %s\\n",
+                             dev_name);
+                    exit(EXIT_FAILURE);
+            }
+
+            buffers = calloc(req.count, sizeof(*buffers));
+
+            if (!buffers) {
+                    fprintf(stderr, "Out of memory\\n");
+                    exit(EXIT_FAILURE);
+            }
+
+            for (n_buffers = 0; n_buffers < req.count; ++n_buffers) {
+                    struct v4l2_buffer buf;
+
+                    CLEAR(buf);
+
+                    buf.type        = V4L2_BUF_TYPE_VIDEO_CAPTURE;
+                    buf.memory      = V4L2_MEMORY_MMAP;
+                    buf.index       = n_buffers;
+
+                    if (-1 == xioctl(fd, VIDIOC_QUERYBUF, &buf))
+                            errno_exit("VIDIOC_QUERYBUF");
+
+                    buffers[n_buffers].length = buf.length;
+                    buffers[n_buffers].start =
+                            mmap(NULL /* start anywhere */,
+                                  buf.length,
+                                  PROT_READ | PROT_WRITE /* required */,
+                                  MAP_SHARED /* recommended */,
+                                  fd, buf.m.offset);
+
+                    if (MAP_FAILED == buffers[n_buffers].start)
+                            errno_exit("mmap");
+            }
+    }
+
+    static void init_userp(unsigned int buffer_size)
+    {
+            struct v4l2_requestbuffers req;
+
+            CLEAR(req);
+
+            req.count  = 4;
+            req.type   = V4L2_BUF_TYPE_VIDEO_CAPTURE;
+            req.memory = V4L2_MEMORY_USERPTR;
+
+            if (-1 == xioctl(fd, VIDIOC_REQBUFS, &req)) {
+                    if (EINVAL == errno) {
+                            fprintf(stderr, "%s does not support "
+                                     "user pointer i/on", dev_name);
+                            exit(EXIT_FAILURE);
+                    } else {
+                            errno_exit("VIDIOC_REQBUFS");
+                    }
+            }
+
+            buffers = calloc(4, sizeof(*buffers));
+
+            if (!buffers) {
+                    fprintf(stderr, "Out of memory\\n");
+                    exit(EXIT_FAILURE);
+            }
+
+            for (n_buffers = 0; n_buffers < 4; ++n_buffers) {
+                    buffers[n_buffers].length = buffer_size;
+                    buffers[n_buffers].start = malloc(buffer_size);
+
+                    if (!buffers[n_buffers].start) {
+                            fprintf(stderr, "Out of memory\\n");
+                            exit(EXIT_FAILURE);
+                    }
+            }
+    }
+
+    static void init_device(void)
+    {
+            struct v4l2_capability cap;
+            struct v4l2_cropcap cropcap;
+            struct v4l2_crop crop;
+            struct v4l2_format fmt;
+            unsigned int min;
+
+            if (-1 == xioctl(fd, VIDIOC_QUERYCAP, &cap)) {
+                    if (EINVAL == errno) {
+                            fprintf(stderr, "%s is no V4L2 device\\n",
+                                     dev_name);
+                            exit(EXIT_FAILURE);
+                    } else {
+                            errno_exit("VIDIOC_QUERYCAP");
+                    }
+            }
+
+            if (!(cap.capabilities & V4L2_CAP_VIDEO_CAPTURE)) {
+                    fprintf(stderr, "%s is no video capture device\\n",
+                             dev_name);
+                    exit(EXIT_FAILURE);
+            }
+
+            switch (io) {
+            case IO_METHOD_READ:
+                    if (!(cap.capabilities & V4L2_CAP_READWRITE)) {
+                            fprintf(stderr, "%s does not support read i/o\\n",
+                                     dev_name);
+                            exit(EXIT_FAILURE);
+                    }
+                    break;
+
+            case IO_METHOD_MMAP:
+            case IO_METHOD_USERPTR:
+                    if (!(cap.capabilities & V4L2_CAP_STREAMING)) {
+                            fprintf(stderr, "%s does not support streaming i/o\\n",
+                                     dev_name);
+                            exit(EXIT_FAILURE);
+                    }
+                    break;
+            }
+
+
+            /* Select video input, video standard and tune here. */
+
+
+            CLEAR(cropcap);
+
+            cropcap.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
+
+            if (0 == xioctl(fd, VIDIOC_CROPCAP, &cropcap)) {
+                    crop.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
+                    crop.c = cropcap.defrect; /* reset to default */
+
+                    if (-1 == xioctl(fd, VIDIOC_S_CROP, &crop)) {
+                            switch (errno) {
+                            case EINVAL:
+                                    /* Cropping not supported. */
+                                    break;
+                            default:
+                                    /* Errors ignored. */
+                                    break;
+                            }
+                    }
+            } else {
+                    /* Errors ignored. */
+            }
+
+
+            CLEAR(fmt);
+
+            fmt.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
+            if (force_format) {
+                    fmt.fmt.pix.width       = 640;
+                    fmt.fmt.pix.height      = 480;
+                    fmt.fmt.pix.pixelformat = V4L2_PIX_FMT_YUYV;
+                    fmt.fmt.pix.field       = V4L2_FIELD_INTERLACED;
+
+                    if (-1 == xioctl(fd, VIDIOC_S_FMT, &fmt))
+                            errno_exit("VIDIOC_S_FMT");
+
+                    /* Note VIDIOC_S_FMT may change width and height. */
+            } else {
+                    /* Preserve original settings as set by v4l2-ctl for example */
+                    if (-1 == xioctl(fd, VIDIOC_G_FMT, &fmt))
+                            errno_exit("VIDIOC_G_FMT");
+            }
+
+            /* Buggy driver paranoia. */
+            min = fmt.fmt.pix.width * 2;
+            if (fmt.fmt.pix.bytesperline < min)
+                    fmt.fmt.pix.bytesperline = min;
+            min = fmt.fmt.pix.bytesperline * fmt.fmt.pix.height;
+            if (fmt.fmt.pix.sizeimage < min)
+                    fmt.fmt.pix.sizeimage = min;
+
+            switch (io) {
+            case IO_METHOD_READ:
+                    init_read(fmt.fmt.pix.sizeimage);
+                    break;
+
+            case IO_METHOD_MMAP:
+                    init_mmap();
+                    break;
+
+            case IO_METHOD_USERPTR:
+                    init_userp(fmt.fmt.pix.sizeimage);
+                    break;
+            }
+    }
+
+    static void close_device(void)
+    {
+            if (-1 == close(fd))
+                    errno_exit("close");
+
+            fd = -1;
+    }
+
+    static void open_device(void)
+    {
+            struct stat st;
+
+            if (-1 == stat(dev_name, &st)) {
+                    fprintf(stderr, "Cannot identify '%s': %d, %s\\n",
+                             dev_name, errno, strerror(errno));
+                    exit(EXIT_FAILURE);
+            }
+
+            if (!S_ISCHR(st.st_mode)) {
+                    fprintf(stderr, "%s is no devicen", dev_name);
+                    exit(EXIT_FAILURE);
+            }
+
+            fd = open(dev_name, O_RDWR /* required */ | O_NONBLOCK, 0);
+
+            if (-1 == fd) {
+                    fprintf(stderr, "Cannot open '%s': %d, %s\\n",
+                             dev_name, errno, strerror(errno));
+                    exit(EXIT_FAILURE);
+            }
+    }
+
+    static void usage(FILE *fp, int argc, char **argv)
+    {
+            fprintf(fp,
+                     "Usage: %s [options]\\n\\n"
+                     "Version 1.3\\n"
+                     "Options:\\n"
+                     "-d | --device name   Video device name [%s]n"
+                     "-h | --help          Print this messagen"
+                     "-m | --mmap          Use memory mapped buffers [default]n"
+                     "-r | --read          Use read() callsn"
+                     "-u | --userp         Use application allocated buffersn"
+                     "-o | --output        Outputs stream to stdoutn"
+                     "-f | --format        Force format to 640x480 YUYVn"
+                     "-c | --count         Number of frames to grab [%i]n"
+                     "",
+                     argv[0], dev_name, frame_count);
+    }
+
+    static const char short_options[] = "d:hmruofc:";
+
+    static const struct option
+    long_options[] = {
+            { "device", required_argument, NULL, 'd' },
+            { "help",   no_argument,       NULL, 'h' },
+            { "mmap",   no_argument,       NULL, 'm' },
+            { "read",   no_argument,       NULL, 'r' },
+            { "userp",  no_argument,       NULL, 'u' },
+            { "output", no_argument,       NULL, 'o' },
+            { "format", no_argument,       NULL, 'f' },
+            { "count",  required_argument, NULL, 'c' },
+            { 0, 0, 0, 0 }
+    };
+
+    int main(int argc, char **argv)
+    {
+            dev_name = "/dev/video0";
+
+            for (;;) {
+                    int idx;
+                    int c;
+
+                    c = getopt_long(argc, argv,
+                                    short_options, long_options, &idx);
+
+                    if (-1 == c)
+                            break;
+
+                    switch (c) {
+                    case 0: /* getopt_long() flag */
+                            break;
+
+                    case 'd':
+                            dev_name = optarg;
+                            break;
+
+                    case 'h':
+                            usage(stdout, argc, argv);
+                            exit(EXIT_SUCCESS);
+
+                    case 'm':
+                            io = IO_METHOD_MMAP;
+                            break;
+
+                    case 'r':
+                            io = IO_METHOD_READ;
+                            break;
+
+                    case 'u':
+                            io = IO_METHOD_USERPTR;
+                            break;
+
+                    case 'o':
+                            out_buf++;
+                            break;
+
+                    case 'f':
+                            force_format++;
+                            break;
+
+                    case 'c':
+                            errno = 0;
+                            frame_count = strtol(optarg, NULL, 0);
+                            if (errno)
+                                    errno_exit(optarg);
+                            break;
+
+                    default:
+                            usage(stderr, argc, argv);
+                            exit(EXIT_FAILURE);
+                    }
+            }
+
+            open_device();
+            init_device();
+            start_capturing();
+            mainloop();
+            stop_capturing();
+            uninit_device();
+            close_device();
+            fprintf(stderr, "\\n");
+            return 0;
+    }
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/colorspaces.rst b/Documentation/linux_tv/media/v4l/colorspaces.rst
new file mode 100644
index 000000000000..85d0b33b60a3
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/colorspaces.rst
@@ -0,0 +1,172 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _colorspaces:
+
+***********
+Colorspaces
+***********
+
+'Color' is a very complex concept and depends on physics, chemistry and
+biology. Just because you have three numbers that describe the 'red',
+'green' and 'blue' components of the color of a pixel does not mean that
+you can accurately display that color. A colorspace defines what it
+actually *means* to have an RGB value of e.g. (255, 0, 0). That is,
+which color should be reproduced on the screen in a perfectly calibrated
+environment.
+
+In order to do that we first need to have a good definition of color,
+i.e. some way to uniquely and unambiguously define a color so that
+someone else can reproduce it. Human color vision is trichromatic since
+the human eye has color receptors that are sensitive to three different
+wavelengths of light. Hence the need to use three numbers to describe
+color. Be glad you are not a mantis shrimp as those are sensitive to 12
+different wavelengths, so instead of RGB we would be using the
+ABCDEFGHIJKL colorspace...
+
+Color exists only in the eye and brain and is the result of how strongly
+color receptors are stimulated. This is based on the Spectral Power
+Distribution (SPD) which is a graph showing the intensity (radiant
+power) of the light at wavelengths covering the visible spectrum as it
+enters the eye. The science of colorimetry is about the relationship
+between the SPD and color as perceived by the human brain.
+
+Since the human eye has only three color receptors it is perfectly
+possible that different SPDs will result in the same stimulation of
+those receptors and are perceived as the same color, even though the SPD
+of the light is different.
+
+In the 1920s experiments were devised to determine the relationship
+between SPDs and the perceived color and that resulted in the CIE 1931
+standard that defines spectral weighting functions that model the
+perception of color. Specifically that standard defines functions that
+can take an SPD and calculate the stimulus for each color receptor.
+After some further mathematical transforms these stimuli are known as
+the *CIE XYZ tristimulus* values and these X, Y and Z values describe a
+color as perceived by a human unambiguously. These X, Y and Z values are
+all in the range [0…1].
+
+The Y value in the CIE XYZ colorspace corresponds to luminance. Often
+the CIE XYZ colorspace is transformed to the normalized CIE xyY
+colorspace:
+
+x = X / (X + Y + Z)
+
+y = Y / (X + Y + Z)
+
+The x and y values are the chromaticity coordinates and can be used to
+define a color without the luminance component Y. It is very confusing
+to have such similar names for these colorspaces. Just be aware that if
+colors are specified with lower case 'x' and 'y', then the CIE xyY
+colorspace is used. Upper case 'X' and 'Y' refer to the CIE XYZ
+colorspace. Also, y has nothing to do with luminance. Together x and y
+specify a color, and Y the luminance. That is really all you need to
+remember from a practical point of view. At the end of this section you
+will find reading resources that go into much more detail if you are
+interested.
+
+A monitor or TV will reproduce colors by emitting light at three
+different wavelengths, the combination of which will stimulate the color
+receptors in the eye and thus cause the perception of color.
+Historically these wavelengths were defined by the red, green and blue
+phosphors used in the displays. These *color primaries* are part of what
+defines a colorspace.
+
+Different display devices will have different primaries and some
+primaries are more suitable for some display technologies than others.
+This has resulted in a variety of colorspaces that are used for
+different display technologies or uses. To define a colorspace you need
+to define the three color primaries (these are typically defined as x, y
+chromaticity coordinates from the CIE xyY colorspace) but also the white
+reference: that is the color obtained when all three primaries are at
+maximum power. This determines the relative power or energy of the
+primaries. This is usually chosen to be close to daylight which has been
+defined as the CIE D65 Illuminant.
+
+To recapitulate: the CIE XYZ colorspace uniquely identifies colors.
+Other colorspaces are defined by three chromaticity coordinates defined
+in the CIE xyY colorspace. Based on those a 3x3 matrix can be
+constructed that transforms CIE XYZ colors to colors in the new
+colorspace.
+
+Both the CIE XYZ and the RGB colorspace that are derived from the
+specific chromaticity primaries are linear colorspaces. But neither the
+eye, nor display technology is linear. Doubling the values of all
+components in the linear colorspace will not be perceived as twice the
+intensity of the color. So each colorspace also defines a transfer
+function that takes a linear color component value and transforms it to
+the non-linear component value, which is a closer match to the
+non-linear performance of both the eye and displays. Linear component
+values are denoted RGB, non-linear are denoted as R'G'B'. In general
+colors used in graphics are all R'G'B', except in openGL which uses
+linear RGB. Special care should be taken when dealing with openGL to
+provide linear RGB colors or to use the built-in openGL support to apply
+the inverse transfer function.
+
+The final piece that defines a colorspace is a function that transforms
+non-linear R'G'B' to non-linear Y'CbCr. This function is determined by
+the so-called luma coefficients. There may be multiple possible Y'CbCr
+encodings allowed for the same colorspace. Many encodings of color
+prefer to use luma (Y') and chroma (CbCr) instead of R'G'B'. Since the
+human eye is more sensitive to differences in luminance than in color
+this encoding allows one to reduce the amount of color information
+compared to the luma data. Note that the luma (Y') is unrelated to the Y
+in the CIE XYZ colorspace. Also note that Y'CbCr is often called YCbCr
+or YUV even though these are strictly speaking wrong.
+
+Sometimes people confuse Y'CbCr as being a colorspace. This is not
+correct, it is just an encoding of an R'G'B' color into luma and chroma
+values. The underlying colorspace that is associated with the R'G'B'
+color is also associated with the Y'CbCr color.
+
+The final step is how the RGB, R'G'B' or Y'CbCr values are quantized.
+The CIE XYZ colorspace where X, Y and Z are in the range [0…1] describes
+all colors that humans can perceive, but the transform to another
+colorspace will produce colors that are outside the [0…1] range. Once
+clamped to the [0…1] range those colors can no longer be reproduced in
+that colorspace. This clamping is what reduces the extent or gamut of
+the colorspace. How the range of [0…1] is translated to integer values
+in the range of [0…255] (or higher, depending on the color depth) is
+called the quantization. This is *not* part of the colorspace
+definition. In practice RGB or R'G'B' values are full range, i.e. they
+use the full [0…255] range. Y'CbCr values on the other hand are limited
+range with Y' using [16…235] and Cb and Cr using [16…240].
+
+Unfortunately, in some cases limited range RGB is also used where the
+components use the range [16…235]. And full range Y'CbCr also exists
+using the [0…255] range.
+
+In order to correctly interpret a color you need to know the
+quantization range, whether it is R'G'B' or Y'CbCr, the used Y'CbCr
+encoding and the colorspace. From that information you can calculate the
+corresponding CIE XYZ color and map that again to whatever colorspace
+your display device uses.
+
+The colorspace definition itself consists of the three chromaticity
+primaries, the white reference chromaticity, a transfer function and the
+luma coefficients needed to transform R'G'B' to Y'CbCr. While some
+colorspace standards correctly define all four, quite often the
+colorspace standard only defines some, and you have to rely on other
+standards for the missing pieces. The fact that colorspaces are often a
+mix of different standards also led to very confusing naming conventions
+where the name of a standard was used to name a colorspace when in fact
+that standard was part of various other colorspaces as well.
+
+If you want to read more about colors and colorspaces, then the
+following resources are useful: :ref:`poynton` is a good practical
+book for video engineers, :ref:`colimg` has a much broader scope and
+describes many more aspects of color (physics, chemistry, biology,
+etc.). The
+`http://www.brucelindbloom.com <http://www.brucelindbloom.com>`__
+website is an excellent resource, especially with respect to the
+mathematics behind colorspace conversions. The wikipedia
+`CIE 1931 colorspace <http://en.wikipedia.org/wiki/CIE_1931_color_space#CIE_xy_chromaticity_diagram_and_the_CIE_xyY_color_space>`__
+article is also very useful.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/common-defs.rst b/Documentation/linux_tv/media/v4l/common-defs.rst
new file mode 100644
index 000000000000..3f90a8c6e28c
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/common-defs.rst
@@ -0,0 +1,24 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _common-defs:
+
+******************************************************
+Common definitions for V4L2 and V4L2 subdev interfaces
+******************************************************
+
+
+.. toctree::
+    :maxdepth: 1
+
+    selections-common
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/common.rst b/Documentation/linux_tv/media/v4l/common.rst
new file mode 100644
index 000000000000..0e85b46b2efc
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/common.rst
@@ -0,0 +1,56 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _common:
+
+###################
+Common API Elements
+###################
+Programming a V4L2 device consists of these steps:
+
+-  Opening the device
+
+-  Changing device properties, selecting a video and audio input, video
+   standard, picture brightness a. o.
+
+-  Negotiating a data format
+
+-  Negotiating an input/output method
+
+-  The actual input/output loop
+
+-  Closing the device
+
+In practice most steps are optional and can be executed out of order. It
+depends on the V4L2 device type, you can read about the details in
+:ref:`devices`. In this chapter we will discuss the basic concepts
+applicable to all devices.
+
+
+.. toctree::
+    :maxdepth: 1
+
+    open
+    querycap
+    app-pri
+    video
+    audio
+    tuner
+    standard
+    dv-timings
+    controls
+    format
+    planar-apis
+    crop
+    selection-api
+    streaming-par
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/compat.rst b/Documentation/linux_tv/media/v4l/compat.rst
new file mode 100644
index 000000000000..8a6d883ae6af
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/compat.rst
@@ -0,0 +1,29 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _compat:
+
+*******
+Changes
+*******
+
+The following chapters document the evolution of the V4L2 API, errata or
+extensions. They are also intended to help application and driver
+writers to port or update their code.
+
+
+.. toctree::
+    :maxdepth: 1
+
+    diff-v4l
+    hist-v4l2
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/control.rst b/Documentation/linux_tv/media/v4l/control.rst
new file mode 100644
index 000000000000..16eb34472892
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/control.rst
@@ -0,0 +1,536 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _control:
+
+*************
+User Controls
+*************
+
+Devices typically have a number of user-settable controls such as
+brightness, saturation and so on, which would be presented to the user
+on a graphical user interface. But, different devices will have
+different controls available, and furthermore, the range of possible
+values, and the default value will vary from device to device. The
+control ioctls provide the information and a mechanism to create a nice
+user interface for these controls that will work correctly with any
+device.
+
+All controls are accessed using an ID value. V4L2 defines several IDs
+for specific purposes. Drivers can also implement their own custom
+controls using ``V4L2_CID_PRIVATE_BASE``  [1]_ and higher values. The
+pre-defined control IDs have the prefix ``V4L2_CID_``, and are listed in
+:ref:`control-id`. The ID is used when querying the attributes of a
+control, and when getting or setting the current value.
+
+Generally applications should present controls to the user without
+assumptions about their purpose. Each control comes with a name string
+the user is supposed to understand. When the purpose is non-intuitive
+the driver writer should provide a user manual, a user interface plug-in
+or a driver specific panel application. Predefined IDs were introduced
+to change a few controls programmatically, for example to mute a device
+during a channel switch.
+
+Drivers may enumerate different controls after switching the current
+video input or output, tuner or modulator, or audio input or output.
+Different in the sense of other bounds, another default and current
+value, step size or other menu items. A control with a certain *custom*
+ID can also change name and type.
+
+If a control is not applicable to the current configuration of the
+device (for example, it doesn't apply to the current video input)
+drivers set the ``V4L2_CTRL_FLAG_INACTIVE`` flag.
+
+Control values are stored globally, they do not change when switching
+except to stay within the reported bounds. They also do not change e. g.
+when the device is opened or closed, when the tuner radio frequency is
+changed or generally never without application request.
+
+V4L2 specifies an event mechanism to notify applications when controls
+change value (see
+:ref:`VIDIOC_SUBSCRIBE_EVENT <vidioc-subscribe-event>`, event
+``V4L2_EVENT_CTRL``), panel applications might want to make use of that
+in order to always reflect the correct control value.
+
+All controls use machine endianness.
+
+
+.. _control-id:
+
+Control IDs
+===========
+
+``V4L2_CID_BASE``
+    First predefined ID, equal to ``V4L2_CID_BRIGHTNESS``.
+
+``V4L2_CID_USER_BASE``
+    Synonym of ``V4L2_CID_BASE``.
+
+``V4L2_CID_BRIGHTNESS`` ``(integer)``
+    Picture brightness, or more precisely, the black level.
+
+``V4L2_CID_CONTRAST`` ``(integer)``
+    Picture contrast or luma gain.
+
+``V4L2_CID_SATURATION`` ``(integer)``
+    Picture color saturation or chroma gain.
+
+``V4L2_CID_HUE`` ``(integer)``
+    Hue or color balance.
+
+``V4L2_CID_AUDIO_VOLUME`` ``(integer)``
+    Overall audio volume. Note some drivers also provide an OSS or ALSA
+    mixer interface.
+
+``V4L2_CID_AUDIO_BALANCE`` ``(integer)``
+    Audio stereo balance. Minimum corresponds to all the way left,
+    maximum to right.
+
+``V4L2_CID_AUDIO_BASS`` ``(integer)``
+    Audio bass adjustment.
+
+``V4L2_CID_AUDIO_TREBLE`` ``(integer)``
+    Audio treble adjustment.
+
+``V4L2_CID_AUDIO_MUTE`` ``(boolean)``
+    Mute audio, i. e. set the volume to zero, however without affecting
+    ``V4L2_CID_AUDIO_VOLUME``. Like ALSA drivers, V4L2 drivers must mute
+    at load time to avoid excessive noise. Actually the entire device
+    should be reset to a low power consumption state.
+
+``V4L2_CID_AUDIO_LOUDNESS`` ``(boolean)``
+    Loudness mode (bass boost).
+
+``V4L2_CID_BLACK_LEVEL`` ``(integer)``
+    Another name for brightness (not a synonym of
+    ``V4L2_CID_BRIGHTNESS``). This control is deprecated and should not
+    be used in new drivers and applications.
+
+``V4L2_CID_AUTO_WHITE_BALANCE`` ``(boolean)``
+    Automatic white balance (cameras).
+
+``V4L2_CID_DO_WHITE_BALANCE`` ``(button)``
+    This is an action control. When set (the value is ignored), the
+    device will do a white balance and then hold the current setting.
+    Contrast this with the boolean ``V4L2_CID_AUTO_WHITE_BALANCE``,
+    which, when activated, keeps adjusting the white balance.
+
+``V4L2_CID_RED_BALANCE`` ``(integer)``
+    Red chroma balance.
+
+``V4L2_CID_BLUE_BALANCE`` ``(integer)``
+    Blue chroma balance.
+
+``V4L2_CID_GAMMA`` ``(integer)``
+    Gamma adjust.
+
+``V4L2_CID_WHITENESS`` ``(integer)``
+    Whiteness for grey-scale devices. This is a synonym for
+    ``V4L2_CID_GAMMA``. This control is deprecated and should not be
+    used in new drivers and applications.
+
+``V4L2_CID_EXPOSURE`` ``(integer)``
+    Exposure (cameras). [Unit?]
+
+``V4L2_CID_AUTOGAIN`` ``(boolean)``
+    Automatic gain/exposure control.
+
+``V4L2_CID_GAIN`` ``(integer)``
+    Gain control.
+
+``V4L2_CID_HFLIP`` ``(boolean)``
+    Mirror the picture horizontally.
+
+``V4L2_CID_VFLIP`` ``(boolean)``
+    Mirror the picture vertically.
+
+.. _`v4l2-power-line-frequency`:
+
+``V4L2_CID_POWER_LINE_FREQUENCY`` ``(enum)``
+    Enables a power line frequency filter to avoid flicker. Possible
+    values for ``enum v4l2_power_line_frequency`` are:
+    ``V4L2_CID_POWER_LINE_FREQUENCY_DISABLED`` (0),
+    ``V4L2_CID_POWER_LINE_FREQUENCY_50HZ`` (1),
+    ``V4L2_CID_POWER_LINE_FREQUENCY_60HZ`` (2) and
+    ``V4L2_CID_POWER_LINE_FREQUENCY_AUTO`` (3).
+
+``V4L2_CID_HUE_AUTO`` ``(boolean)``
+    Enables automatic hue control by the device. The effect of setting
+    ``V4L2_CID_HUE`` while automatic hue control is enabled is
+    undefined, drivers should ignore such request.
+
+``V4L2_CID_WHITE_BALANCE_TEMPERATURE`` ``(integer)``
+    This control specifies the white balance settings as a color
+    temperature in Kelvin. A driver should have a minimum of 2800
+    (incandescent) to 6500 (daylight). For more information about color
+    temperature see
+    `Wikipedia <http://en.wikipedia.org/wiki/Color_temperature>`__.
+
+``V4L2_CID_SHARPNESS`` ``(integer)``
+    Adjusts the sharpness filters in a camera. The minimum value
+    disables the filters, higher values give a sharper picture.
+
+``V4L2_CID_BACKLIGHT_COMPENSATION`` ``(integer)``
+    Adjusts the backlight compensation in a camera. The minimum value
+    disables backlight compensation.
+
+``V4L2_CID_CHROMA_AGC`` ``(boolean)``
+    Chroma automatic gain control.
+
+``V4L2_CID_CHROMA_GAIN`` ``(integer)``
+    Adjusts the Chroma gain control (for use when chroma AGC is
+    disabled).
+
+``V4L2_CID_COLOR_KILLER`` ``(boolean)``
+    Enable the color killer (i. e. force a black & white image in case
+    of a weak video signal).
+
+.. _`v4l2-colorfx`:
+
+``V4L2_CID_COLORFX`` ``(enum)``
+    Selects a color effect. The following values are defined:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_COLORFX_NONE``
+
+       -  Color effect is disabled.
+
+    -  .. row 2
+
+       -  ``V4L2_COLORFX_ANTIQUE``
+
+       -  An aging (old photo) effect.
+
+    -  .. row 3
+
+       -  ``V4L2_COLORFX_ART_FREEZE``
+
+       -  Frost color effect.
+
+    -  .. row 4
+
+       -  ``V4L2_COLORFX_AQUA``
+
+       -  Water color, cool tone.
+
+    -  .. row 5
+
+       -  ``V4L2_COLORFX_BW``
+
+       -  Black and white.
+
+    -  .. row 6
+
+       -  ``V4L2_COLORFX_EMBOSS``
+
+       -  Emboss, the highlights and shadows replace light/dark boundaries
+          and low contrast areas are set to a gray background.
+
+    -  .. row 7
+
+       -  ``V4L2_COLORFX_GRASS_GREEN``
+
+       -  Grass green.
+
+    -  .. row 8
+
+       -  ``V4L2_COLORFX_NEGATIVE``
+
+       -  Negative.
+
+    -  .. row 9
+
+       -  ``V4L2_COLORFX_SEPIA``
+
+       -  Sepia tone.
+
+    -  .. row 10
+
+       -  ``V4L2_COLORFX_SKETCH``
+
+       -  Sketch.
+
+    -  .. row 11
+
+       -  ``V4L2_COLORFX_SKIN_WHITEN``
+
+       -  Skin whiten.
+
+    -  .. row 12
+
+       -  ``V4L2_COLORFX_SKY_BLUE``
+
+       -  Sky blue.
+
+    -  .. row 13
+
+       -  ``V4L2_COLORFX_SOLARIZATION``
+
+       -  Solarization, the image is partially reversed in tone, only color
+          values above or below a certain threshold are inverted.
+
+    -  .. row 14
+
+       -  ``V4L2_COLORFX_SILHOUETTE``
+
+       -  Silhouette (outline).
+
+    -  .. row 15
+
+       -  ``V4L2_COLORFX_VIVID``
+
+       -  Vivid colors.
+
+    -  .. row 16
+
+       -  ``V4L2_COLORFX_SET_CBCR``
+
+       -  The Cb and Cr chroma components are replaced by fixed coefficients
+          determined by ``V4L2_CID_COLORFX_CBCR`` control.
+
+
+
+``V4L2_CID_COLORFX_CBCR`` ``(integer)``
+    Determines the Cb and Cr coefficients for ``V4L2_COLORFX_SET_CBCR``
+    color effect. Bits [7:0] of the supplied 32 bit value are
+    interpreted as Cr component, bits [15:8] as Cb component and bits
+    [31:16] must be zero.
+
+``V4L2_CID_AUTOBRIGHTNESS`` ``(boolean)``
+    Enable Automatic Brightness.
+
+``V4L2_CID_ROTATE`` ``(integer)``
+    Rotates the image by specified angle. Common angles are 90, 270 and
+    180. Rotating the image to 90 and 270 will reverse the height and
+    width of the display window. It is necessary to set the new height
+    and width of the picture using the
+    :ref:`VIDIOC_S_FMT <vidioc-g-fmt>` ioctl according to the
+    rotation angle selected.
+
+``V4L2_CID_BG_COLOR`` ``(integer)``
+    Sets the background color on the current output device. Background
+    color needs to be specified in the RGB24 format. The supplied 32 bit
+    value is interpreted as bits 0-7 Red color information, bits 8-15
+    Green color information, bits 16-23 Blue color information and bits
+    24-31 must be zero.
+
+``V4L2_CID_ILLUMINATORS_1 V4L2_CID_ILLUMINATORS_2`` ``(boolean)``
+    Switch on or off the illuminator 1 or 2 of the device (usually a
+    microscope).
+
+``V4L2_CID_MIN_BUFFERS_FOR_CAPTURE`` ``(integer)``
+    This is a read-only control that can be read by the application and
+    used as a hint to determine the number of CAPTURE buffers to pass to
+    REQBUFS. The value is the minimum number of CAPTURE buffers that is
+    necessary for hardware to work.
+
+``V4L2_CID_MIN_BUFFERS_FOR_OUTPUT`` ``(integer)``
+    This is a read-only control that can be read by the application and
+    used as a hint to determine the number of OUTPUT buffers to pass to
+    REQBUFS. The value is the minimum number of OUTPUT buffers that is
+    necessary for hardware to work.
+
+.. _`v4l2-alpha-component`:
+
+``V4L2_CID_ALPHA_COMPONENT`` ``(integer)``
+    Sets the alpha color component. When a capture device (or capture
+    queue of a mem-to-mem device) produces a frame format that includes
+    an alpha component (e.g.
+    :ref:`packed RGB image formats <rgb-formats>`) and the alpha value
+    is not defined by the device or the mem-to-mem input data this
+    control lets you select the alpha component value of all pixels.
+    When an output device (or output queue of a mem-to-mem device)
+    consumes a frame format that doesn't include an alpha component and
+    the device supports alpha channel processing this control lets you
+    set the alpha component value of all pixels for further processing
+    in the device.
+
+``V4L2_CID_LASTP1``
+    End of the predefined control IDs (currently
+    ``V4L2_CID_ALPHA_COMPONENT`` + 1).
+
+``V4L2_CID_PRIVATE_BASE``
+    ID of the first custom (driver specific) control. Applications
+    depending on particular custom controls should check the driver name
+    and version, see :ref:`querycap`.
+
+Applications can enumerate the available controls with the
+:ref:`VIDIOC_QUERYCTRL <vidioc-queryctrl>` and
+:ref:`VIDIOC_QUERYMENU <vidioc-queryctrl>` ioctls, get and set a
+control value with the :ref:`VIDIOC_G_CTRL <vidioc-g-ctrl>` and
+:ref:`VIDIOC_S_CTRL <vidioc-g-ctrl>` ioctls. Drivers must implement
+``VIDIOC_QUERYCTRL``, ``VIDIOC_G_CTRL`` and ``VIDIOC_S_CTRL`` when the
+device has one or more controls, ``VIDIOC_QUERYMENU`` when it has one or
+more menu type controls.
+
+
+.. code-block:: c
+
+    struct v4l2_queryctrl queryctrl;
+    struct v4l2_querymenu querymenu;
+
+    static void enumerate_menu(void)
+    {
+        printf("  Menu items:\\n");
+
+        memset(&querymenu, 0, sizeof(querymenu));
+        querymenu.id = queryctrl.id;
+
+        for (querymenu.index = queryctrl.minimum;
+             querymenu.index <= queryctrl.maximum;
+             querymenu.index++) {
+            if (0 == ioctl(fd, VIDIOC_QUERYMENU, &querymenu)) {
+                printf("  %s\\n", querymenu.name);
+            }
+        }
+    }
+
+    memset(&queryctrl, 0, sizeof(queryctrl));
+
+    for (queryctrl.id = V4L2_CID_BASE;
+         queryctrl.id < V4L2_CID_LASTP1;
+         queryctrl.id++) {
+        if (0 == ioctl(fd, VIDIOC_QUERYCTRL, &queryctrl)) {
+            if (queryctrl.flags & V4L2_CTRL_FLAG_DISABLED)
+                continue;
+
+            printf("Control %s\\n", queryctrl.name);
+
+            if (queryctrl.type == V4L2_CTRL_TYPE_MENU)
+                enumerate_menu();
+        } else {
+            if (errno == EINVAL)
+                continue;
+
+            perror("VIDIOC_QUERYCTRL");
+            exit(EXIT_FAILURE);
+        }
+    }
+
+    for (queryctrl.id = V4L2_CID_PRIVATE_BASE;;
+         queryctrl.id++) {
+        if (0 == ioctl(fd, VIDIOC_QUERYCTRL, &queryctrl)) {
+            if (queryctrl.flags & V4L2_CTRL_FLAG_DISABLED)
+                continue;
+
+            printf("Control %s\\n", queryctrl.name);
+
+            if (queryctrl.type == V4L2_CTRL_TYPE_MENU)
+                enumerate_menu();
+        } else {
+            if (errno == EINVAL)
+                break;
+
+            perror("VIDIOC_QUERYCTRL");
+            exit(EXIT_FAILURE);
+        }
+    }
+
+
+.. code-block:: c
+
+    memset(&queryctrl, 0, sizeof(queryctrl));
+
+    queryctrl.id = V4L2_CTRL_CLASS_USER | V4L2_CTRL_FLAG_NEXT_CTRL;
+    while (0 == ioctl(fd, VIDIOC_QUERYCTRL, &queryctrl)) {
+        if (V4L2_CTRL_ID2CLASS(queryctrl.id) != V4L2_CTRL_CLASS_USER)
+            break;
+        if (queryctrl.flags & V4L2_CTRL_FLAG_DISABLED)
+            continue;
+
+        printf("Control %s\\n", queryctrl.name);
+
+        if (queryctrl.type == V4L2_CTRL_TYPE_MENU)
+            enumerate_menu();
+
+        queryctrl.id |= V4L2_CTRL_FLAG_NEXT_CTRL;
+    }
+    if (errno != EINVAL) {
+        perror("VIDIOC_QUERYCTRL");
+        exit(EXIT_FAILURE);
+    }
+
+
+.. code-block:: c
+
+    struct v4l2_queryctrl queryctrl;
+    struct v4l2_control control;
+
+    memset(&queryctrl, 0, sizeof(queryctrl));
+    queryctrl.id = V4L2_CID_BRIGHTNESS;
+
+    if (-1 == ioctl(fd, VIDIOC_QUERYCTRL, &queryctrl)) {
+        if (errno != EINVAL) {
+            perror("VIDIOC_QUERYCTRL");
+            exit(EXIT_FAILURE);
+        } else {
+            printf("V4L2_CID_BRIGHTNESS is not supportedn");
+        }
+    } else if (queryctrl.flags & V4L2_CTRL_FLAG_DISABLED) {
+        printf("V4L2_CID_BRIGHTNESS is not supportedn");
+    } else {
+        memset(&control, 0, sizeof (control));
+        control.id = V4L2_CID_BRIGHTNESS;
+        control.value = queryctrl.default_value;
+
+        if (-1 == ioctl(fd, VIDIOC_S_CTRL, &control)) {
+            perror("VIDIOC_S_CTRL");
+            exit(EXIT_FAILURE);
+        }
+    }
+
+    memset(&control, 0, sizeof(control));
+    control.id = V4L2_CID_CONTRAST;
+
+    if (0 == ioctl(fd, VIDIOC_G_CTRL, &control)) {
+        control.value += 1;
+
+        /* The driver may clamp the value or return ERANGE, ignored here */
+
+        if (-1 == ioctl(fd, VIDIOC_S_CTRL, &control)
+            && errno != ERANGE) {
+            perror("VIDIOC_S_CTRL");
+            exit(EXIT_FAILURE);
+        }
+    /* Ignore if V4L2_CID_CONTRAST is unsupported */
+    } else if (errno != EINVAL) {
+        perror("VIDIOC_G_CTRL");
+        exit(EXIT_FAILURE);
+    }
+
+    control.id = V4L2_CID_AUDIO_MUTE;
+    control.value = 1; /* silence */
+
+    /* Errors ignored */
+    ioctl(fd, VIDIOC_S_CTRL, &control);
+
+.. [1]
+   The use of ``V4L2_CID_PRIVATE_BASE`` is problematic because different
+   drivers may use the same ``V4L2_CID_PRIVATE_BASE`` ID for different
+   controls. This makes it hard to programatically set such controls
+   since the meaning of the control with that ID is driver dependent. In
+   order to resolve this drivers use unique IDs and the
+   ``V4L2_CID_PRIVATE_BASE`` IDs are mapped to those unique IDs by the
+   kernel. Consider these ``V4L2_CID_PRIVATE_BASE`` IDs as aliases to
+   the real IDs.
+
+   Many applications today still use the ``V4L2_CID_PRIVATE_BASE`` IDs
+   instead of using :ref:`VIDIOC_QUERYCTRL <vidioc-queryctrl>` with
+   the ``V4L2_CTRL_FLAG_NEXT_CTRL`` flag to enumerate all IDs, so
+   support for ``V4L2_CID_PRIVATE_BASE`` is still around.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/controls.rst b/Documentation/linux_tv/media/v4l/controls.rst
new file mode 100644
index 000000000000..fe5bca543699
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/controls.rst
@@ -0,0 +1,18 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. toctree::
+    :maxdepth: 1
+
+    control
+    extended-controls
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/crop.rst b/Documentation/linux_tv/media/v4l/crop.rst
new file mode 100644
index 000000000000..b9014d03865f
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/crop.rst
@@ -0,0 +1,300 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _crop:
+
+*************************************
+Image Cropping, Insertion and Scaling
+*************************************
+
+Some video capture devices can sample a subsection of the picture and
+shrink or enlarge it to an image of arbitrary size. We call these
+abilities cropping and scaling. Some video output devices can scale an
+image up or down and insert it at an arbitrary scan line and horizontal
+offset into a video signal.
+
+Applications can use the following API to select an area in the video
+signal, query the default area and the hardware limits. *Despite their
+name, the :ref:`VIDIOC_CROPCAP <vidioc-cropcap>`,
+:ref:`VIDIOC_G_CROP <vidioc-g-crop>` and
+:ref:`VIDIOC_S_CROP <vidioc-g-crop>` ioctls apply to input as well
+as output devices.*
+
+Scaling requires a source and a target. On a video capture or overlay
+device the source is the video signal, and the cropping ioctls determine
+the area actually sampled. The target are images read by the application
+or overlaid onto the graphics screen. Their size (and position for an
+overlay) is negotiated with the :ref:`VIDIOC_G_FMT <vidioc-g-fmt>`
+and :ref:`VIDIOC_S_FMT <vidioc-g-fmt>` ioctls.
+
+On a video output device the source are the images passed in by the
+application, and their size is again negotiated with the
+``VIDIOC_G/S_FMT`` ioctls, or may be encoded in a compressed video
+stream. The target is the video signal, and the cropping ioctls
+determine the area where the images are inserted.
+
+Source and target rectangles are defined even if the device does not
+support scaling or the ``VIDIOC_G/S_CROP`` ioctls. Their size (and
+position where applicable) will be fixed in this case. *All capture and
+output device must support the ``VIDIOC_CROPCAP`` ioctl such that
+applications can determine if scaling takes place.*
+
+
+Cropping Structures
+===================
+
+
+.. _crop-scale:
+
+.. figure::  crop_files/crop.*
+    :alt:    crop.pdf / crop.gif
+    :align:  center
+
+    Image Cropping, Insertion and Scaling
+
+    The cropping, insertion and scaling process
+
+
+
+For capture devices the coordinates of the top left corner, width and
+height of the area which can be sampled is given by the ``bounds``
+substructure of the struct :ref:`v4l2_cropcap <v4l2-cropcap>`
+returned by the ``VIDIOC_CROPCAP`` ioctl. To support a wide range of
+hardware this specification does not define an origin or units. However
+by convention drivers should horizontally count unscaled samples
+relative to 0H (the leading edge of the horizontal sync pulse, see
+:ref:`vbi-hsync`). Vertically ITU-R line numbers of the first field
+(:ref:`vbi-525`, :ref:`vbi-625`), multiplied by two if the driver
+can capture both fields.
+
+The top left corner, width and height of the source rectangle, that is
+the area actually sampled, is given by struct
+:ref:`v4l2_crop <v4l2-crop>` using the same coordinate system as
+struct :ref:`v4l2_cropcap <v4l2-cropcap>`. Applications can use the
+``VIDIOC_G_CROP`` and ``VIDIOC_S_CROP`` ioctls to get and set this
+rectangle. It must lie completely within the capture boundaries and the
+driver may further adjust the requested size and/or position according
+to hardware limitations.
+
+Each capture device has a default source rectangle, given by the
+``defrect`` substructure of struct
+:ref:`v4l2_cropcap <v4l2-cropcap>`. The center of this rectangle
+shall align with the center of the active picture area of the video
+signal, and cover what the driver writer considers the complete picture.
+Drivers shall reset the source rectangle to the default when the driver
+is first loaded, but not later.
+
+For output devices these structures and ioctls are used accordingly,
+defining the *target* rectangle where the images will be inserted into
+the video signal.
+
+
+Scaling Adjustments
+===================
+
+Video hardware can have various cropping, insertion and scaling
+limitations. It may only scale up or down, support only discrete scaling
+factors, or have different scaling abilities in horizontal and vertical
+direction. Also it may not support scaling at all. At the same time the
+struct :ref:`v4l2_crop <v4l2-crop>` rectangle may have to be aligned,
+and both the source and target rectangles may have arbitrary upper and
+lower size limits. In particular the maximum ``width`` and ``height`` in
+struct :ref:`v4l2_crop <v4l2-crop>` may be smaller than the struct
+:ref:`v4l2_cropcap <v4l2-cropcap>`. ``bounds`` area. Therefore, as
+usual, drivers are expected to adjust the requested parameters and
+return the actual values selected.
+
+Applications can change the source or the target rectangle first, as
+they may prefer a particular image size or a certain area in the video
+signal. If the driver has to adjust both to satisfy hardware
+limitations, the last requested rectangle shall take priority, and the
+driver should preferably adjust the opposite one. The
+:ref:`VIDIOC_TRY_FMT <vidioc-g-fmt>` ioctl however shall not change
+the driver state and therefore only adjust the requested rectangle.
+
+Suppose scaling on a video capture device is restricted to a factor 1:1
+or 2:1 in either direction and the target image size must be a multiple
+of 16 × 16 pixels. The source cropping rectangle is set to defaults,
+which are also the upper limit in this example, of 640 × 400 pixels at
+offset 0, 0. An application requests an image size of 300 × 225 pixels,
+assuming video will be scaled down from the "full picture" accordingly.
+The driver sets the image size to the closest possible values 304 × 224,
+then chooses the cropping rectangle closest to the requested size, that
+is 608 × 224 (224 × 2:1 would exceed the limit 400). The offset 0, 0 is
+still valid, thus unmodified. Given the default cropping rectangle
+reported by ``VIDIOC_CROPCAP`` the application can easily propose
+another offset to center the cropping rectangle.
+
+Now the application may insist on covering an area using a picture
+aspect ratio closer to the original request, so it asks for a cropping
+rectangle of 608 × 456 pixels. The present scaling factors limit
+cropping to 640 × 384, so the driver returns the cropping size 608 × 384
+and adjusts the image size to closest possible 304 × 192.
+
+
+Examples
+========
+
+Source and target rectangles shall remain unchanged across closing and
+reopening a device, such that piping data into or out of a device will
+work without special preparations. More advanced applications should
+ensure the parameters are suitable before starting I/O.
+
+(A video capture device is assumed; change
+``V4L2_BUF_TYPE_VIDEO_CAPTURE`` for other devices.)
+
+
+.. code-block:: c
+
+    struct v4l2_cropcap cropcap;
+    struct v4l2_crop crop;
+
+    memset (&cropcap, 0, sizeof (cropcap));
+    cropcap.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
+
+    if (-1 == ioctl (fd, VIDIOC_CROPCAP, &cropcap)) {
+        perror ("VIDIOC_CROPCAP");
+        exit (EXIT_FAILURE);
+    }
+
+    memset (&crop, 0, sizeof (crop));
+    crop.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
+    crop.c = cropcap.defrect;
+
+    /* Ignore if cropping is not supported (EINVAL). */
+
+    if (-1 == ioctl (fd, VIDIOC_S_CROP, &crop)
+        && errno != EINVAL) {
+        perror ("VIDIOC_S_CROP");
+        exit (EXIT_FAILURE);
+    }
+
+(A video capture device is assumed.)
+
+
+.. code-block:: c
+
+    struct v4l2_cropcap cropcap;
+    struct v4l2_format format;
+
+    reset_cropping_parameters ();
+
+    /* Scale down to 1/4 size of full picture. */
+
+    memset (&format, 0, sizeof (format)); /* defaults */
+
+    format.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
+
+    format.fmt.pix.width = cropcap.defrect.width >> 1;
+    format.fmt.pix.height = cropcap.defrect.height >> 1;
+    format.fmt.pix.pixelformat = V4L2_PIX_FMT_YUYV;
+
+    if (-1 == ioctl (fd, VIDIOC_S_FMT, &format)) {
+        perror ("VIDIOC_S_FORMAT");
+        exit (EXIT_FAILURE);
+    }
+
+    /* We could check the actual image size now, the actual scaling factor
+       or if the driver can scale at all. */
+
+
+.. code-block:: c
+
+    struct v4l2_cropcap cropcap;
+    struct v4l2_crop crop;
+
+    memset (&cropcap, 0, sizeof (cropcap));
+    cropcap.type = V4L2_BUF_TYPE_VIDEO_OUTPUT;
+
+    if (-1 == ioctl (fd, VIDIOC_CROPCAP;, &cropcap)) {
+        perror ("VIDIOC_CROPCAP");
+        exit (EXIT_FAILURE);
+    }
+
+    memset (&crop, 0, sizeof (crop));
+
+    crop.type = V4L2_BUF_TYPE_VIDEO_OUTPUT;
+    crop.c = cropcap.defrect;
+
+    /* Scale the width and height to 50 % of their original size
+       and center the output. */
+
+    crop.c.width /= 2;
+    crop.c.height /= 2;
+    crop.c.left += crop.c.width / 2;
+    crop.c.top += crop.c.height / 2;
+
+    /* Ignore if cropping is not supported (EINVAL). */
+
+    if (-1 == ioctl (fd, VIDIOC_S_CROP, &crop)
+        && errno != EINVAL) {
+        perror ("VIDIOC_S_CROP");
+        exit (EXIT_FAILURE);
+    }
+
+(A video capture device is assumed.)
+
+
+.. code-block:: c
+
+    struct v4l2_cropcap cropcap;
+    struct v4l2_crop crop;
+    struct v4l2_format format;
+    double hscale, vscale;
+    double aspect;
+    int dwidth, dheight;
+
+    memset (&cropcap, 0, sizeof (cropcap));
+    cropcap.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
+
+    if (-1 == ioctl (fd, VIDIOC_CROPCAP, &cropcap)) {
+        perror ("VIDIOC_CROPCAP");
+        exit (EXIT_FAILURE);
+    }
+
+    memset (&crop, 0, sizeof (crop));
+    crop.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
+
+    if (-1 == ioctl (fd, VIDIOC_G_CROP, &crop)) {
+        if (errno != EINVAL) {
+            perror ("VIDIOC_G_CROP");
+            exit (EXIT_FAILURE);
+        }
+
+        /* Cropping not supported. */
+        crop.c = cropcap.defrect;
+    }
+
+    memset (&format, 0, sizeof (format));
+    format.fmt.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
+
+    if (-1 == ioctl (fd, VIDIOC_G_FMT, &format)) {
+        perror ("VIDIOC_G_FMT");
+        exit (EXIT_FAILURE);
+    }
+
+    /* The scaling applied by the driver. */
+
+    hscale = format.fmt.pix.width / (double) crop.c.width;
+    vscale = format.fmt.pix.height / (double) crop.c.height;
+
+    aspect = cropcap.pixelaspect.numerator /
+         (double) cropcap.pixelaspect.denominator;
+    aspect = aspect * hscale / vscale;
+
+    /* Devices following ITU-R BT.601 do not capture
+       square pixels. For playback on a computer monitor
+       we should scale the images to this size. */
+
+    dwidth = format.fmt.pix.width / aspect;
+    dheight = format.fmt.pix.height;
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/crop_files/crop.gif b/Documentation/linux_tv/media/v4l/crop_files/crop.gif
new file mode 100644
index 0000000000000000000000000000000000000000..3b9e7d836d4b8a685e76ec6412fc28c9f5c16f27
GIT binary patch
literal 5967
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

literal 0
HcmV?d00001

diff --git a/Documentation/linux_tv/media/v4l/crop_files/crop.pdf b/Documentation/linux_tv/media/v4l/crop_files/crop.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..c9fb81cd32f34d2b08cb601f3a1575af77e14275
GIT binary patch
literal 5846
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

literal 0
HcmV?d00001

diff --git a/Documentation/linux_tv/media/v4l/depth-formats.rst b/Documentation/linux_tv/media/v4l/depth-formats.rst
new file mode 100644
index 000000000000..c363eaf741f5
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/depth-formats.rst
@@ -0,0 +1,26 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _depth-formats:
+
+*************
+Depth Formats
+*************
+
+Depth data provides distance to points, mapped onto the image plane
+
+
+.. toctree::
+    :maxdepth: 1
+
+    pixfmt-z16
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/dev-capture.rst b/Documentation/linux_tv/media/v4l/dev-capture.rst
new file mode 100644
index 000000000000..21207ab2e604
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/dev-capture.rst
@@ -0,0 +1,111 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _capture:
+
+***********************
+Video Capture Interface
+***********************
+
+Video capture devices sample an analog video signal and store the
+digitized images in memory. Today nearly all devices can capture at full
+25 or 30 frames/second. With this interface applications can control the
+capture process and move images from the driver into user space.
+
+Conventionally V4L2 video capture devices are accessed through character
+device special files named ``/dev/video`` and ``/dev/video0`` to
+``/dev/video63`` with major number 81 and minor numbers 0 to 63.
+``/dev/video`` is typically a symbolic link to the preferred video
+device. Note the same device files are used for video output devices.
+
+
+Querying Capabilities
+=====================
+
+Devices supporting the video capture interface set the
+``V4L2_CAP_VIDEO_CAPTURE`` or ``V4L2_CAP_VIDEO_CAPTURE_MPLANE`` flag in
+the ``capabilities`` field of struct
+:ref:`v4l2_capability <v4l2-capability>` returned by the
+:ref:`VIDIOC_QUERYCAP <vidioc-querycap>` ioctl. As secondary device
+functions they may also support the :ref:`video overlay <overlay>`
+(``V4L2_CAP_VIDEO_OVERLAY``) and the :ref:`raw VBI capture <raw-vbi>`
+(``V4L2_CAP_VBI_CAPTURE``) interface. At least one of the read/write or
+streaming I/O methods must be supported. Tuners and audio inputs are
+optional.
+
+
+Supplemental Functions
+======================
+
+Video capture devices shall support :ref:`audio input <audio>`,
+:ref:`tuner <tuner>`, :ref:`controls <control>`,
+:ref:`cropping and scaling <crop>` and
+:ref:`streaming parameter <streaming-par>` ioctls as needed. The
+:ref:`video input <video>` and :ref:`video standard <standard>`
+ioctls must be supported by all video capture devices.
+
+
+Image Format Negotiation
+========================
+
+The result of a capture operation is determined by cropping and image
+format parameters. The former select an area of the video picture to
+capture, the latter how images are stored in memory, i. e. in RGB or YUV
+format, the number of bits per pixel or width and height. Together they
+also define how images are scaled in the process.
+
+As usual these parameters are *not* reset at :ref:`open() <func-open>`
+time to permit Unix tool chains, programming a device and then reading
+from it as if it was a plain file. Well written V4L2 applications ensure
+they really get what they want, including cropping and scaling.
+
+Cropping initialization at minimum requires to reset the parameters to
+defaults. An example is given in :ref:`crop`.
+
+To query the current image format applications set the ``type`` field of
+a struct :ref:`v4l2_format <v4l2-format>` to
+``V4L2_BUF_TYPE_VIDEO_CAPTURE`` or
+``V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE`` and call the
+:ref:`VIDIOC_G_FMT <vidioc-g-fmt>` ioctl with a pointer to this
+structure. Drivers fill the struct
+:ref:`v4l2_pix_format <v4l2-pix-format>` ``pix`` or the struct
+:ref:`v4l2_pix_format_mplane <v4l2-pix-format-mplane>` ``pix_mp``
+member of the ``fmt`` union.
+
+To request different parameters applications set the ``type`` field of a
+struct :ref:`v4l2_format <v4l2-format>` as above and initialize all
+fields of the struct :ref:`v4l2_pix_format <v4l2-pix-format>`
+``vbi`` member of the ``fmt`` union, or better just modify the results
+of ``VIDIOC_G_FMT``, and call the :ref:`VIDIOC_S_FMT <vidioc-g-fmt>`
+ioctl with a pointer to this structure. Drivers may adjust the
+parameters and finally return the actual parameters as ``VIDIOC_G_FMT``
+does.
+
+Like ``VIDIOC_S_FMT`` the :ref:`VIDIOC_TRY_FMT <vidioc-g-fmt>` ioctl
+can be used to learn about hardware limitations without disabling I/O or
+possibly time consuming hardware preparations.
+
+The contents of struct :ref:`v4l2_pix_format <v4l2-pix-format>` and
+struct :ref:`v4l2_pix_format_mplane <v4l2-pix-format-mplane>` are
+discussed in :ref:`pixfmt`. See also the specification of the
+``VIDIOC_G_FMT``, ``VIDIOC_S_FMT`` and ``VIDIOC_TRY_FMT`` ioctls for
+details. Video capture devices must implement both the ``VIDIOC_G_FMT``
+and ``VIDIOC_S_FMT`` ioctl, even if ``VIDIOC_S_FMT`` ignores all
+requests and always returns default parameters as ``VIDIOC_G_FMT`` does.
+``VIDIOC_TRY_FMT`` is optional.
+
+
+Reading Images
+==============
+
+A video capture device may support the :ref:`read() function <rw>`
+and/or streaming (:ref:`memory mapping <mmap>` or
+:ref:`user pointer <userp>`) I/O. See :ref:`io` for details.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/dev-codec.rst b/Documentation/linux_tv/media/v4l/dev-codec.rst
new file mode 100644
index 000000000000..f0b54c2b95c3
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/dev-codec.rst
@@ -0,0 +1,41 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _codec:
+
+***************
+Codec Interface
+***************
+
+A V4L2 codec can compress, decompress, transform, or otherwise convert
+video data from one format into another format, in memory. Typically
+such devices are memory-to-memory devices (i.e. devices with the
+``V4L2_CAP_VIDEO_M2M`` or ``V4L2_CAP_VIDEO_M2M_MPLANE`` capability set).
+
+A memory-to-memory video node acts just like a normal video node, but it
+supports both output (sending frames from memory to the codec hardware)
+and capture (receiving the processed frames from the codec hardware into
+memory) stream I/O. An application will have to setup the stream I/O for
+both sides and finally call :ref:`VIDIOC_STREAMON <vidioc-streamon>`
+for both capture and output to start the codec.
+
+Video compression codecs use the MPEG controls to setup their codec
+parameters (note that the MPEG controls actually support many more
+codecs than just MPEG). See :ref:`mpeg-controls`.
+
+Memory-to-memory devices can often be used as a shared resource: you can
+open the video node multiple times, each application setting up their
+own codec properties that are local to the file handle, and each can use
+it independently from the others. The driver will arbitrate access to
+the codec and reprogram it whenever another file handler gets access.
+This is different from the usual video node behavior where the video
+properties are global to the device (i.e. changing something through one
+file handle is visible through another file handle).
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/dev-effect.rst b/Documentation/linux_tv/media/v4l/dev-effect.rst
new file mode 100644
index 000000000000..c0cdfe07ff4d
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/dev-effect.rst
@@ -0,0 +1,31 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _effect:
+
+************************
+Effect Devices Interface
+************************
+
+    **Note**
+
+    This interface has been be suspended from the V4L2 API implemented
+    in Linux 2.6 until we have more experience with effect device
+    interfaces.
+
+A V4L2 video effect device can do image effects, filtering, or combine
+two or more images or image streams. For example video transitions or
+wipes. Applications send data to be processed and receive the result
+data either with :ref:`read() <func-read>` and
+:ref:`write() <func-write>` functions, or through the streaming I/O
+mechanism.
+
+[to do]
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/dev-event.rst b/Documentation/linux_tv/media/v4l/dev-event.rst
new file mode 100644
index 000000000000..afe24a72d8ea
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/dev-event.rst
@@ -0,0 +1,56 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _event:
+
+***************
+Event Interface
+***************
+
+The V4L2 event interface provides a means for a user to get immediately
+notified on certain conditions taking place on a device. This might
+include start of frame or loss of signal events, for example. Changes in
+the value or state of a V4L2 control can also be reported through
+events.
+
+To receive events, the events the user is interested in first must be
+subscribed using the
+:ref:`VIDIOC_SUBSCRIBE_EVENT <vidioc-subscribe-event>` ioctl. Once
+an event is subscribed, the events of subscribed types are dequeueable
+using the :ref:`VIDIOC_DQEVENT <vidioc-dqevent>` ioctl. Events may be
+unsubscribed using VIDIOC_UNSUBSCRIBE_EVENT ioctl. The special event
+type V4L2_EVENT_ALL may be used to unsubscribe all the events the
+driver supports.
+
+The event subscriptions and event queues are specific to file handles.
+Subscribing an event on one file handle does not affect other file
+handles.
+
+The information on dequeueable events is obtained by using select or
+poll system calls on video devices. The V4L2 events use POLLPRI events
+on poll system call and exceptions on select system call.
+
+Starting with kernel 3.1 certain guarantees can be given with regards to
+events:
+
+1. Each subscribed event has its own internal dedicated event queue.
+   This means that flooding of one event type will not interfere with
+   other event types.
+
+2. If the internal event queue for a particular subscribed event becomes
+   full, then the oldest event in that queue will be dropped.
+
+3. Where applicable, certain event types can ensure that the payload of
+   the oldest event that is about to be dropped will be merged with the
+   payload of the next oldest event. Thus ensuring that no information
+   is lost, but only an intermediate step leading up to that
+   information. See the documentation for the event you want to
+   subscribe to whether this is applicable for that event or not.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/dev-osd.rst b/Documentation/linux_tv/media/v4l/dev-osd.rst
new file mode 100644
index 000000000000..077e2cdc598d
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/dev-osd.rst
@@ -0,0 +1,154 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _osd:
+
+******************************
+Video Output Overlay Interface
+******************************
+
+
+**Also known as On-Screen Display (OSD)**
+Some video output devices can overlay a framebuffer image onto the
+outgoing video signal. Applications can set up such an overlay using
+this interface, which borrows structures and ioctls of the
+:ref:`Video Overlay <overlay>` interface.
+
+The OSD function is accessible through the same character special file
+as the :ref:`Video Output <capture>` function. Note the default
+function of such a ``/dev/video`` device is video capturing or output.
+The OSD function is only available after calling the
+:ref:`VIDIOC_S_FMT <vidioc-g-fmt>` ioctl.
+
+
+Querying Capabilities
+=====================
+
+Devices supporting the *Video Output Overlay* interface set the
+``V4L2_CAP_VIDEO_OUTPUT_OVERLAY`` flag in the ``capabilities`` field of
+struct :ref:`v4l2_capability <v4l2-capability>` returned by the
+:ref:`VIDIOC_QUERYCAP <vidioc-querycap>` ioctl.
+
+
+Framebuffer
+===========
+
+Contrary to the *Video Overlay* interface the framebuffer is normally
+implemented on the TV card and not the graphics card. On Linux it is
+accessible as a framebuffer device (``/dev/fbN``). Given a V4L2 device,
+applications can find the corresponding framebuffer device by calling
+the :ref:`VIDIOC_G_FBUF <vidioc-g-fbuf>` ioctl. It returns, amongst
+other information, the physical address of the framebuffer in the
+``base`` field of struct :ref:`v4l2_framebuffer <v4l2-framebuffer>`.
+The framebuffer device ioctl ``FBIOGET_FSCREENINFO`` returns the same
+address in the ``smem_start`` field of struct
+:c:type:`struct fb_fix_screeninfo`. The ``FBIOGET_FSCREENINFO``
+ioctl and struct :c:type:`struct fb_fix_screeninfo` are defined in
+the ``linux/fb.h`` header file.
+
+The width and height of the framebuffer depends on the current video
+standard. A V4L2 driver may reject attempts to change the video standard
+(or any other ioctl which would imply a framebuffer size change) with an
+EBUSY error code until all applications closed the framebuffer device.
+
+
+.. code-block:: c
+
+    #include <linux/fb.h>
+
+    struct v4l2_framebuffer fbuf;
+    unsigned int i;
+    int fb_fd;
+
+    if (-1 == ioctl(fd, VIDIOC_G_FBUF, &fbuf)) {
+        perror("VIDIOC_G_FBUF");
+        exit(EXIT_FAILURE);
+    }
+
+    for (i = 0; i < 30; i++) {
+        char dev_name[16];
+        struct fb_fix_screeninfo si;
+
+        snprintf(dev_name, sizeof(dev_name), "/dev/fb%u", i);
+
+        fb_fd = open(dev_name, O_RDWR);
+        if (-1 == fb_fd) {
+            switch (errno) {
+            case ENOENT: /* no such file */
+            case ENXIO:  /* no driver */
+                continue;
+
+            default:
+                perror("open");
+                exit(EXIT_FAILURE);
+            }
+        }
+
+        if (0 == ioctl(fb_fd, FBIOGET_FSCREENINFO, &si)) {
+            if (si.smem_start == (unsigned long)fbuf.base)
+                break;
+        } else {
+            /* Apparently not a framebuffer device. */
+        }
+
+        close(fb_fd);
+        fb_fd = -1;
+    }
+
+    /* fb_fd is the file descriptor of the framebuffer device
+       for the video output overlay, or -1 if no device was found. */
+
+
+Overlay Window and Scaling
+==========================
+
+The overlay is controlled by source and target rectangles. The source
+rectangle selects a subsection of the framebuffer image to be overlaid,
+the target rectangle an area in the outgoing video signal where the
+image will appear. Drivers may or may not support scaling, and arbitrary
+sizes and positions of these rectangles. Further drivers may support any
+(or none) of the clipping/blending methods defined for the
+:ref:`Video Overlay <overlay>` interface.
+
+A struct :ref:`v4l2_window <v4l2-window>` defines the size of the
+source rectangle, its position in the framebuffer and the
+clipping/blending method to be used for the overlay. To get the current
+parameters applications set the ``type`` field of a struct
+:ref:`v4l2_format <v4l2-format>` to
+``V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY`` and call the
+:ref:`VIDIOC_G_FMT <vidioc-g-fmt>` ioctl. The driver fills the
+:c:type:`struct v4l2_window` substructure named ``win``. It is not
+possible to retrieve a previously programmed clipping list or bitmap.
+
+To program the source rectangle applications set the ``type`` field of a
+struct :ref:`v4l2_format <v4l2-format>` to
+``V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY``, initialize the ``win``
+substructure and call the :ref:`VIDIOC_S_FMT <vidioc-g-fmt>` ioctl.
+The driver adjusts the parameters against hardware limits and returns
+the actual parameters as ``VIDIOC_G_FMT`` does. Like ``VIDIOC_S_FMT``,
+the :ref:`VIDIOC_TRY_FMT <vidioc-g-fmt>` ioctl can be used to learn
+about driver capabilities without actually changing driver state. Unlike
+``VIDIOC_S_FMT`` this also works after the overlay has been enabled.
+
+A struct :ref:`v4l2_crop <v4l2-crop>` defines the size and position
+of the target rectangle. The scaling factor of the overlay is implied by
+the width and height given in struct :ref:`v4l2_window <v4l2-window>`
+and struct :ref:`v4l2_crop <v4l2-crop>`. The cropping API applies to
+*Video Output* and *Video Output Overlay* devices in the same way as to
+*Video Capture* and *Video Overlay* devices, merely reversing the
+direction of the data flow. For more information see :ref:`crop`.
+
+
+Enabling Overlay
+================
+
+There is no V4L2 ioctl to enable or disable the overlay, however the
+framebuffer interface of the driver may support the ``FBIOBLANK`` ioctl.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/dev-output.rst b/Documentation/linux_tv/media/v4l/dev-output.rst
new file mode 100644
index 000000000000..0d46d59304b9
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/dev-output.rst
@@ -0,0 +1,108 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _output:
+
+**********************
+Video Output Interface
+**********************
+
+Video output devices encode stills or image sequences as analog video
+signal. With this interface applications can control the encoding
+process and move images from user space to the driver.
+
+Conventionally V4L2 video output devices are accessed through character
+device special files named ``/dev/video`` and ``/dev/video0`` to
+``/dev/video63`` with major number 81 and minor numbers 0 to 63.
+``/dev/video`` is typically a symbolic link to the preferred video
+device. Note the same device files are used for video capture devices.
+
+
+Querying Capabilities
+=====================
+
+Devices supporting the video output interface set the
+``V4L2_CAP_VIDEO_OUTPUT`` or ``V4L2_CAP_VIDEO_OUTPUT_MPLANE`` flag in
+the ``capabilities`` field of struct
+:ref:`v4l2_capability <v4l2-capability>` returned by the
+:ref:`VIDIOC_QUERYCAP <vidioc-querycap>` ioctl. As secondary device
+functions they may also support the :ref:`raw VBI output <raw-vbi>`
+(``V4L2_CAP_VBI_OUTPUT``) interface. At least one of the read/write or
+streaming I/O methods must be supported. Modulators and audio outputs
+are optional.
+
+
+Supplemental Functions
+======================
+
+Video output devices shall support :ref:`audio output <audio>`,
+:ref:`modulator <tuner>`, :ref:`controls <control>`,
+:ref:`cropping and scaling <crop>` and
+:ref:`streaming parameter <streaming-par>` ioctls as needed. The
+:ref:`video output <video>` and :ref:`video standard <standard>`
+ioctls must be supported by all video output devices.
+
+
+Image Format Negotiation
+========================
+
+The output is determined by cropping and image format parameters. The
+former select an area of the video picture where the image will appear,
+the latter how images are stored in memory, i. e. in RGB or YUV format,
+the number of bits per pixel or width and height. Together they also
+define how images are scaled in the process.
+
+As usual these parameters are *not* reset at :ref:`open() <func-open>`
+time to permit Unix tool chains, programming a device and then writing
+to it as if it was a plain file. Well written V4L2 applications ensure
+they really get what they want, including cropping and scaling.
+
+Cropping initialization at minimum requires to reset the parameters to
+defaults. An example is given in :ref:`crop`.
+
+To query the current image format applications set the ``type`` field of
+a struct :ref:`v4l2_format <v4l2-format>` to
+``V4L2_BUF_TYPE_VIDEO_OUTPUT`` or ``V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE``
+and call the :ref:`VIDIOC_G_FMT <vidioc-g-fmt>` ioctl with a pointer
+to this structure. Drivers fill the struct
+:ref:`v4l2_pix_format <v4l2-pix-format>` ``pix`` or the struct
+:ref:`v4l2_pix_format_mplane <v4l2-pix-format-mplane>` ``pix_mp``
+member of the ``fmt`` union.
+
+To request different parameters applications set the ``type`` field of a
+struct :ref:`v4l2_format <v4l2-format>` as above and initialize all
+fields of the struct :ref:`v4l2_pix_format <v4l2-pix-format>`
+``vbi`` member of the ``fmt`` union, or better just modify the results
+of ``VIDIOC_G_FMT``, and call the :ref:`VIDIOC_S_FMT <vidioc-g-fmt>`
+ioctl with a pointer to this structure. Drivers may adjust the
+parameters and finally return the actual parameters as ``VIDIOC_G_FMT``
+does.
+
+Like ``VIDIOC_S_FMT`` the :ref:`VIDIOC_TRY_FMT <vidioc-g-fmt>` ioctl
+can be used to learn about hardware limitations without disabling I/O or
+possibly time consuming hardware preparations.
+
+The contents of struct :ref:`v4l2_pix_format <v4l2-pix-format>` and
+struct :ref:`v4l2_pix_format_mplane <v4l2-pix-format-mplane>` are
+discussed in :ref:`pixfmt`. See also the specification of the
+``VIDIOC_G_FMT``, ``VIDIOC_S_FMT`` and ``VIDIOC_TRY_FMT`` ioctls for
+details. Video output devices must implement both the ``VIDIOC_G_FMT``
+and ``VIDIOC_S_FMT`` ioctl, even if ``VIDIOC_S_FMT`` ignores all
+requests and always returns default parameters as ``VIDIOC_G_FMT`` does.
+``VIDIOC_TRY_FMT`` is optional.
+
+
+Writing Images
+==============
+
+A video output device may support the :ref:`write() function <rw>`
+and/or streaming (:ref:`memory mapping <mmap>` or
+:ref:`user pointer <userp>`) I/O. See :ref:`io` for details.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/dev-overlay.rst b/Documentation/linux_tv/media/v4l/dev-overlay.rst
new file mode 100644
index 000000000000..50aed591284b
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/dev-overlay.rst
@@ -0,0 +1,328 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _overlay:
+
+***********************
+Video Overlay Interface
+***********************
+
+
+**Also known as Framebuffer Overlay or Previewing**
+Video overlay devices have the ability to genlock (TV-)video into the
+(VGA-)video signal of a graphics card, or to store captured images
+directly in video memory of a graphics card, typically with clipping.
+This can be considerable more efficient than capturing images and
+displaying them by other means. In the old days when only nuclear power
+plants needed cooling towers this used to be the only way to put live
+video into a window.
+
+Video overlay devices are accessed through the same character special
+files as :ref:`video capture <capture>` devices. Note the default
+function of a ``/dev/video`` device is video capturing. The overlay
+function is only available after calling the
+:ref:`VIDIOC_S_FMT <vidioc-g-fmt>` ioctl.
+
+The driver may support simultaneous overlay and capturing using the
+read/write and streaming I/O methods. If so, operation at the nominal
+frame rate of the video standard is not guaranteed. Frames may be
+directed away from overlay to capture, or one field may be used for
+overlay and the other for capture if the capture parameters permit this.
+
+Applications should use different file descriptors for capturing and
+overlay. This must be supported by all drivers capable of simultaneous
+capturing and overlay. Optionally these drivers may also permit
+capturing and overlay with a single file descriptor for compatibility
+with V4L and earlier versions of V4L2. [1]_
+
+
+Querying Capabilities
+=====================
+
+Devices supporting the video overlay interface set the
+``V4L2_CAP_VIDEO_OVERLAY`` flag in the ``capabilities`` field of struct
+:ref:`v4l2_capability <v4l2-capability>` returned by the
+:ref:`VIDIOC_QUERYCAP <vidioc-querycap>` ioctl. The overlay I/O
+method specified below must be supported. Tuners and audio inputs are
+optional.
+
+
+Supplemental Functions
+======================
+
+Video overlay devices shall support :ref:`audio input <audio>`,
+:ref:`tuner <tuner>`, :ref:`controls <control>`,
+:ref:`cropping and scaling <crop>` and
+:ref:`streaming parameter <streaming-par>` ioctls as needed. The
+:ref:`video input <video>` and :ref:`video standard <standard>`
+ioctls must be supported by all video overlay devices.
+
+
+Setup
+=====
+
+Before overlay can commence applications must program the driver with
+frame buffer parameters, namely the address and size of the frame buffer
+and the image format, for example RGB 5:6:5. The
+:ref:`VIDIOC_G_FBUF <vidioc-g-fbuf>` and
+:ref:`VIDIOC_S_FBUF <vidioc-g-fbuf>` ioctls are available to get and
+set these parameters, respectively. The ``VIDIOC_S_FBUF`` ioctl is
+privileged because it allows to set up DMA into physical memory,
+bypassing the memory protection mechanisms of the kernel. Only the
+superuser can change the frame buffer address and size. Users are not
+supposed to run TV applications as root or with SUID bit set. A small
+helper application with suitable privileges should query the graphics
+system and program the V4L2 driver at the appropriate time.
+
+Some devices add the video overlay to the output signal of the graphics
+card. In this case the frame buffer is not modified by the video device,
+and the frame buffer address and pixel format are not needed by the
+driver. The ``VIDIOC_S_FBUF`` ioctl is not privileged. An application
+can check for this type of device by calling the ``VIDIOC_G_FBUF``
+ioctl.
+
+A driver may support any (or none) of five clipping/blending methods:
+
+1. Chroma-keying displays the overlaid image only where pixels in the
+   primary graphics surface assume a certain color.
+
+2. A bitmap can be specified where each bit corresponds to a pixel in
+   the overlaid image. When the bit is set, the corresponding video
+   pixel is displayed, otherwise a pixel of the graphics surface.
+
+3. A list of clipping rectangles can be specified. In these regions *no*
+   video is displayed, so the graphics surface can be seen here.
+
+4. The framebuffer has an alpha channel that can be used to clip or
+   blend the framebuffer with the video.
+
+5. A global alpha value can be specified to blend the framebuffer
+   contents with video images.
+
+When simultaneous capturing and overlay is supported and the hardware
+prohibits different image and frame buffer formats, the format requested
+first takes precedence. The attempt to capture
+(:ref:`VIDIOC_S_FMT <vidioc-g-fmt>`) or overlay
+(:ref:`VIDIOC_S_FBUF <vidioc-g-fbuf>`) may fail with an EBUSY error
+code or return accordingly modified parameters..
+
+
+Overlay Window
+==============
+
+The overlaid image is determined by cropping and overlay window
+parameters. The former select an area of the video picture to capture,
+the latter how images are overlaid and clipped. Cropping initialization
+at minimum requires to reset the parameters to defaults. An example is
+given in :ref:`crop`.
+
+The overlay window is described by a struct
+:ref:`v4l2_window <v4l2-window>`. It defines the size of the image,
+its position over the graphics surface and the clipping to be applied.
+To get the current parameters applications set the ``type`` field of a
+struct :ref:`v4l2_format <v4l2-format>` to
+``V4L2_BUF_TYPE_VIDEO_OVERLAY`` and call the
+:ref:`VIDIOC_G_FMT <vidioc-g-fmt>` ioctl. The driver fills the
+:c:type:`struct v4l2_window` substructure named ``win``. It is not
+possible to retrieve a previously programmed clipping list or bitmap.
+
+To program the overlay window applications set the ``type`` field of a
+struct :ref:`v4l2_format <v4l2-format>` to
+``V4L2_BUF_TYPE_VIDEO_OVERLAY``, initialize the ``win`` substructure and
+call the :ref:`VIDIOC_S_FMT <vidioc-g-fmt>` ioctl. The driver
+adjusts the parameters against hardware limits and returns the actual
+parameters as ``VIDIOC_G_FMT`` does. Like ``VIDIOC_S_FMT``, the
+:ref:`VIDIOC_TRY_FMT <vidioc-g-fmt>` ioctl can be used to learn
+about driver capabilities without actually changing driver state. Unlike
+``VIDIOC_S_FMT`` this also works after the overlay has been enabled.
+
+The scaling factor of the overlaid image is implied by the width and
+height given in struct :ref:`v4l2_window <v4l2-window>` and the size
+of the cropping rectangle. For more information see :ref:`crop`.
+
+When simultaneous capturing and overlay is supported and the hardware
+prohibits different image and window sizes, the size requested first
+takes precedence. The attempt to capture or overlay as well
+(:ref:`VIDIOC_S_FMT <vidioc-g-fmt>`) may fail with an EBUSY error
+code or return accordingly modified parameters.
+
+
+.. _v4l2-window:
+
+struct v4l2_window
+------------------
+
+``struct v4l2_rect w``
+    Size and position of the window relative to the top, left corner of
+    the frame buffer defined with
+    :ref:`VIDIOC_S_FBUF <vidioc-g-fbuf>`. The window can extend the
+    frame buffer width and height, the ``x`` and ``y`` coordinates can
+    be negative, and it can lie completely outside the frame buffer. The
+    driver clips the window accordingly, or if that is not possible,
+    modifies its size and/or position.
+
+``enum v4l2_field field``
+    Applications set this field to determine which video field shall be
+    overlaid, typically one of ``V4L2_FIELD_ANY`` (0),
+    ``V4L2_FIELD_TOP``, ``V4L2_FIELD_BOTTOM`` or
+    ``V4L2_FIELD_INTERLACED``. Drivers may have to choose a different
+    field order and return the actual setting here.
+
+``__u32 chromakey``
+    When chroma-keying has been negotiated with
+    :ref:`VIDIOC_S_FBUF <vidioc-g-fbuf>` applications set this field
+    to the desired pixel value for the chroma key. The format is the
+    same as the pixel format of the framebuffer (struct
+    :ref:`v4l2_framebuffer <v4l2-framebuffer>` ``fmt.pixelformat``
+    field), with bytes in host order. E. g. for
+    :ref:`V4L2_PIX_FMT_BGR24 <V4L2-PIX-FMT-BGR32>` the value should
+    be 0xRRGGBB on a little endian, 0xBBGGRR on a big endian host.
+
+``struct v4l2_clip * clips``
+    When chroma-keying has *not* been negotiated and
+    :ref:`VIDIOC_G_FBUF <vidioc-g-fbuf>` indicated this capability,
+    applications can set this field to point to an array of clipping
+    rectangles.
+
+Like the window coordinates
+w
+, clipping rectangles are defined relative to the top, left corner of
+the frame buffer. However clipping rectangles must not extend the frame
+buffer width and height, and they must not overlap. If possible
+applications should merge adjacent rectangles. Whether this must create
+x-y or y-x bands, or the order of rectangles, is not defined. When clip
+lists are not supported the driver ignores this field. Its contents
+after calling
+!ri!:ref:`VIDIOC_S_FMT <vidioc-g-fmt>`
+are undefined.
+
+``__u32 clipcount``
+    When the application set the ``clips`` field, this field must
+    contain the number of clipping rectangles in the list. When clip
+    lists are not supported the driver ignores this field, its contents
+    after calling ``VIDIOC_S_FMT`` are undefined. When clip lists are
+    supported but no clipping is desired this field must be set to zero.
+
+``void * bitmap``
+    When chroma-keying has *not* been negotiated and
+    :ref:`VIDIOC_G_FBUF <vidioc-g-fbuf>` indicated this capability,
+    applications can set this field to point to a clipping bit mask.
+
+It must be of the same size as the window, ``w.width`` and ``w.height``.
+Each bit corresponds to a pixel in the overlaid image, which is
+displayed only when the bit is *set*. Pixel coordinates translate to
+bits like:
+
+
+.. code-block:: c
+
+    ((__u8 *) bitmap)[w.width * y + x / 8] & (1 << (x & 7))
+
+where ``0`` ≤ x < ``w.width`` and ``0`` ≤ y <``w.height``. [2]_
+
+When a clipping bit mask is not supported the driver ignores this field,
+its contents after calling :ref:`VIDIOC_S_FMT <vidioc-g-fmt>` are
+undefined. When a bit mask is supported but no clipping is desired this
+field must be set to ``NULL``.
+
+Applications need not create a clip list or bit mask. When they pass
+both, or despite negotiating chroma-keying, the results are undefined.
+Regardless of the chosen method, the clipping abilities of the hardware
+may be limited in quantity or quality. The results when these limits are
+exceeded are undefined. [3]_
+
+``__u8 global_alpha``
+    The global alpha value used to blend the framebuffer with video
+    images, if global alpha blending has been negotiated
+    (``V4L2_FBUF_FLAG_GLOBAL_ALPHA``, see
+    :ref:`VIDIOC_S_FBUF <vidioc-g-fbuf>`,
+    :ref:`framebuffer-flags`).
+
+Note this field was added in Linux 2.6.23, extending the structure.
+However the
+!ri!:ref:`VIDIOC_G/S/TRY_FMT <vidioc-g-fmt>`
+ioctls, which take a pointer to a
+!ri!:ref:`v4l2_format <v4l2-format>`
+parent structure with padding bytes at the end, are not affected.
+
+
+.. _v4l2-clip:
+
+struct v4l2_clip
+----------------
+
+The X Window system defines "regions" which are vectors of struct BoxRec
+{ short x1, y1, x2, y2; } with width = x2 - x1 and height = y2 - y1, so
+one cannot pass X11 clip lists directly.
+
+``struct v4l2_rect c``
+    Coordinates of the clipping rectangle, relative to the top, left
+    corner of the frame buffer. Only window pixels *outside* all
+    clipping rectangles are displayed.
+
+``struct v4l2_clip * next``
+    Pointer to the next clipping rectangle, NULL when this is the last
+    rectangle. Drivers ignore this field, it cannot be used to pass a
+    linked list of clipping rectangles.
+
+
+.. _v4l2-rect:
+
+struct v4l2_rect
+----------------
+
+``__s32 left``
+    Horizontal offset of the top, left corner of the rectangle, in
+    pixels.
+
+``__s32 top``
+    Vertical offset of the top, left corner of the rectangle, in pixels.
+    Offsets increase to the right and down.
+
+``__u32 width``
+    Width of the rectangle, in pixels.
+
+``__u32 height``
+    Height of the rectangle, in pixels.
+
+
+Enabling Overlay
+================
+
+To start or stop the frame buffer overlay applications call the
+:ref:`VIDIOC_OVERLAY <vidioc-overlay>` ioctl.
+
+.. [1]
+   A common application of two file descriptors is the XFree86
+   :ref:`Xv/V4L <xvideo>` interface driver and a V4L2 application.
+   While the X server controls video overlay, the application can take
+   advantage of memory mapping and DMA.
+
+   In the opinion of the designers of this API, no driver writer taking
+   the efforts to support simultaneous capturing and overlay will
+   restrict this ability by requiring a single file descriptor, as in
+   V4L and earlier versions of V4L2. Making this optional means
+   applications depending on two file descriptors need backup routines
+   to be compatible with all drivers, which is considerable more work
+   than using two fds in applications which do not. Also two fd's fit
+   the general concept of one file descriptor for each logical stream.
+   Hence as a complexity trade-off drivers *must* support two file
+   descriptors and *may* support single fd operation.
+
+.. [2]
+   Should we require ``w.width`` to be a multiple of eight?
+
+.. [3]
+   When the image is written into frame buffer memory it will be
+   undesirable if the driver clips out less pixels than expected,
+   because the application and graphics system are not aware these
+   regions need to be refreshed. The driver should clip out more pixels
+   or not write the image at all.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/dev-radio.rst b/Documentation/linux_tv/media/v4l/dev-radio.rst
new file mode 100644
index 000000000000..672540105a66
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/dev-radio.rst
@@ -0,0 +1,61 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _radio:
+
+***************
+Radio Interface
+***************
+
+This interface is intended for AM and FM (analog) radio receivers and
+transmitters.
+
+Conventionally V4L2 radio devices are accessed through character device
+special files named ``/dev/radio`` and ``/dev/radio0`` to
+``/dev/radio63`` with major number 81 and minor numbers 64 to 127.
+
+
+Querying Capabilities
+=====================
+
+Devices supporting the radio interface set the ``V4L2_CAP_RADIO`` and
+``V4L2_CAP_TUNER`` or ``V4L2_CAP_MODULATOR`` flag in the
+``capabilities`` field of struct
+:ref:`v4l2_capability <v4l2-capability>` returned by the
+:ref:`VIDIOC_QUERYCAP <vidioc-querycap>` ioctl. Other combinations of
+capability flags are reserved for future extensions.
+
+
+Supplemental Functions
+======================
+
+Radio devices can support :ref:`controls <control>`, and must support
+the :ref:`tuner or modulator <tuner>` ioctls.
+
+They do not support the video input or output, audio input or output,
+video standard, cropping and scaling, compression and streaming
+parameter, or overlay ioctls. All other ioctls and I/O methods are
+reserved for future extensions.
+
+
+Programming
+===========
+
+Radio devices may have a couple audio controls (as discussed in
+:ref:`control`) such as a volume control, possibly custom controls.
+Further all radio devices have one tuner or modulator (these are
+discussed in :ref:`tuner`) with index number zero to select the radio
+frequency and to determine if a monaural or FM stereo program is
+received/emitted. Drivers switch automatically between AM and FM
+depending on the selected frequency. The
+:ref:`VIDIOC_G_TUNER <vidioc-g-tuner>` or
+:ref:`VIDIOC_G_MODULATOR <vidioc-g-modulator>` ioctl reports the
+supported frequency range.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/dev-raw-vbi.rst b/Documentation/linux_tv/media/v4l/dev-raw-vbi.rst
new file mode 100644
index 000000000000..9ab5c4a4cad7
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/dev-raw-vbi.rst
@@ -0,0 +1,368 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _raw-vbi:
+
+**********************
+Raw VBI Data Interface
+**********************
+
+VBI is an abbreviation of Vertical Blanking Interval, a gap in the
+sequence of lines of an analog video signal. During VBI no picture
+information is transmitted, allowing some time while the electron beam
+of a cathode ray tube TV returns to the top of the screen. Using an
+oscilloscope you will find here the vertical synchronization pulses and
+short data packages ASK modulated [1]_ onto the video signal. These are
+transmissions of services such as Teletext or Closed Caption.
+
+Subject of this interface type is raw VBI data, as sampled off a video
+signal, or to be added to a signal for output. The data format is
+similar to uncompressed video images, a number of lines times a number
+of samples per line, we call this a VBI image.
+
+Conventionally V4L2 VBI devices are accessed through character device
+special files named ``/dev/vbi`` and ``/dev/vbi0`` to ``/dev/vbi31``
+with major number 81 and minor numbers 224 to 255. ``/dev/vbi`` is
+typically a symbolic link to the preferred VBI device. This convention
+applies to both input and output devices.
+
+To address the problems of finding related video and VBI devices VBI
+capturing and output is also available as device function under
+``/dev/video``. To capture or output raw VBI data with these devices
+applications must call the :ref:`VIDIOC_S_FMT <vidioc-g-fmt>` ioctl.
+Accessed as ``/dev/vbi``, raw VBI capturing or output is the default
+device function.
+
+
+Querying Capabilities
+=====================
+
+Devices supporting the raw VBI capturing or output API set the
+``V4L2_CAP_VBI_CAPTURE`` or ``V4L2_CAP_VBI_OUTPUT`` flags, respectively,
+in the ``capabilities`` field of struct
+:ref:`v4l2_capability <v4l2-capability>` returned by the
+:ref:`VIDIOC_QUERYCAP <vidioc-querycap>` ioctl. At least one of the
+read/write, streaming or asynchronous I/O methods must be supported. VBI
+devices may or may not have a tuner or modulator.
+
+
+Supplemental Functions
+======================
+
+VBI devices shall support :ref:`video input or output <video>`,
+:ref:`tuner or modulator <tuner>`, and :ref:`controls <control>`
+ioctls as needed. The :ref:`video standard <standard>` ioctls provide
+information vital to program a VBI device, therefore must be supported.
+
+
+Raw VBI Format Negotiation
+==========================
+
+Raw VBI sampling abilities can vary, in particular the sampling
+frequency. To properly interpret the data V4L2 specifies an ioctl to
+query the sampling parameters. Moreover, to allow for some flexibility
+applications can also suggest different parameters.
+
+As usual these parameters are *not* reset at :ref:`open() <func-open>`
+time to permit Unix tool chains, programming a device and then reading
+from it as if it was a plain file. Well written V4L2 applications should
+always ensure they really get what they want, requesting reasonable
+parameters and then checking if the actual parameters are suitable.
+
+To query the current raw VBI capture parameters applications set the
+``type`` field of a struct :ref:`v4l2_format <v4l2-format>` to
+``V4L2_BUF_TYPE_VBI_CAPTURE`` or ``V4L2_BUF_TYPE_VBI_OUTPUT``, and call
+the :ref:`VIDIOC_G_FMT <vidioc-g-fmt>` ioctl with a pointer to this
+structure. Drivers fill the struct
+:ref:`v4l2_vbi_format <v4l2-vbi-format>` ``vbi`` member of the
+``fmt`` union.
+
+To request different parameters applications set the ``type`` field of a
+struct :ref:`v4l2_format <v4l2-format>` as above and initialize all
+fields of the struct :ref:`v4l2_vbi_format <v4l2-vbi-format>`
+``vbi`` member of the ``fmt`` union, or better just modify the results
+of ``VIDIOC_G_FMT``, and call the :ref:`VIDIOC_S_FMT <vidioc-g-fmt>`
+ioctl with a pointer to this structure. Drivers return an EINVAL error
+code only when the given parameters are ambiguous, otherwise they modify
+the parameters according to the hardware capabilities and return the
+actual parameters. When the driver allocates resources at this point, it
+may return an EBUSY error code to indicate the returned parameters are
+valid but the required resources are currently not available. That may
+happen for instance when the video and VBI areas to capture would
+overlap, or when the driver supports multiple opens and another process
+already requested VBI capturing or output. Anyway, applications must
+expect other resource allocation points which may return EBUSY, at the
+:ref:`VIDIOC_STREAMON <vidioc-streamon>` ioctl and the first read(),
+write() and select() call.
+
+VBI devices must implement both the ``VIDIOC_G_FMT`` and
+``VIDIOC_S_FMT`` ioctl, even if ``VIDIOC_S_FMT`` ignores all requests
+and always returns default parameters as ``VIDIOC_G_FMT`` does.
+``VIDIOC_TRY_FMT`` is optional.
+
+
+.. _v4l2-vbi-format:
+
+.. flat-table:: struct v4l2_vbi_format
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``sampling_rate``
+
+       -  Samples per second, i. e. unit 1 Hz.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``offset``
+
+       -  Horizontal offset of the VBI image, relative to the leading edge
+          of the line synchronization pulse and counted in samples: The
+          first sample in the VBI image will be located ``offset`` /
+          ``sampling_rate`` seconds following the leading edge. See also
+          :ref:`vbi-hsync`.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``samples_per_line``
+
+       -  
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``sample_format``
+
+       -  Defines the sample format as in :ref:`pixfmt`, a
+          four-character-code. [2]_ Usually this is ``V4L2_PIX_FMT_GREY``,
+          i. e. each sample consists of 8 bits with lower values oriented
+          towards the black level. Do not assume any other correlation of
+          values with the signal level. For example, the MSB does not
+          necessarily indicate if the signal is 'high' or 'low' because 128
+          may not be the mean value of the signal. Drivers shall not convert
+          the sample format by software.
+
+    -  .. row 5
+
+       -  __u32
+
+       -  ``start``\ [2]
+
+       -  This is the scanning system line number associated with the first
+          line of the VBI image, of the first and the second field
+          respectively. See :ref:`vbi-525` and :ref:`vbi-625` for valid
+          values. The ``V4L2_VBI_ITU_525_F1_START``,
+          ``V4L2_VBI_ITU_525_F2_START``, ``V4L2_VBI_ITU_625_F1_START`` and
+          ``V4L2_VBI_ITU_625_F2_START`` defines give the start line numbers
+          for each field for each 525 or 625 line format as a convenience.
+          Don't forget that ITU line numbering starts at 1, not 0. VBI input
+          drivers can return start values 0 if the hardware cannot reliable
+          identify scanning lines, VBI acquisition may not require this
+          information.
+
+    -  .. row 6
+
+       -  __u32
+
+       -  ``count``\ [2]
+
+       -  The number of lines in the first and second field image,
+          respectively.
+
+    -  .. row 7
+
+       -  :cspan:`2`
+
+          Drivers should be as flexibility as possible. For example, it may
+          be possible to extend or move the VBI capture window down to the
+          picture area, implementing a 'full field mode' to capture data
+          service transmissions embedded in the picture.
+
+          An application can set the first or second ``count`` value to zero
+          if no data is required from the respective field; ``count``\ [1]
+          if the scanning system is progressive, i. e. not interlaced. The
+          corresponding start value shall be ignored by the application and
+          driver. Anyway, drivers may not support single field capturing and
+          return both count values non-zero.
+
+          Both ``count`` values set to zero, or line numbers outside the
+          bounds depicted in :ref:`vbi-525` and :ref:`vbi-625`, or a
+          field image covering lines of two fields, are invalid and shall
+          not be returned by the driver.
+
+          To initialize the ``start`` and ``count`` fields, applications
+          must first determine the current video standard selection. The
+          :ref:`v4l2_std_id <v4l2-std-id>` or the ``framelines`` field
+          of struct :ref:`v4l2_standard <v4l2-standard>` can be evaluated
+          for this purpose.
+
+    -  .. row 8
+
+       -  __u32
+
+       -  ``flags``
+
+       -  See :ref:`vbifmt-flags` below. Currently only drivers set flags,
+          applications must set this field to zero.
+
+    -  .. row 9
+
+       -  __u32
+
+       -  ``reserved``\ [2]
+
+       -  This array is reserved for future extensions. Drivers and
+          applications must set it to zero.
+
+
+
+.. _vbifmt-flags:
+
+.. flat-table:: Raw VBI Format Flags
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_VBI_UNSYNC``
+
+       -  0x0001
+
+       -  This flag indicates hardware which does not properly distinguish
+          between fields. Normally the VBI image stores the first field
+          (lower scanning line numbers) first in memory. This may be a top
+          or bottom field depending on the video standard. When this flag is
+          set the first or second field may be stored first, however the
+          fields are still in correct temporal order with the older field
+          first in memory. [3]_
+
+    -  .. row 2
+
+       -  ``V4L2_VBI_INTERLACED``
+
+       -  0x0002
+
+       -  By default the two field images will be passed sequentially; all
+          lines of the first field followed by all lines of the second field
+          (compare :ref:`field-order` ``V4L2_FIELD_SEQ_TB`` and
+          ``V4L2_FIELD_SEQ_BT``, whether the top or bottom field is first in
+          memory depends on the video standard). When this flag is set, the
+          two fields are interlaced (cf. ``V4L2_FIELD_INTERLACED``). The
+          first line of the first field followed by the first line of the
+          second field, then the two second lines, and so on. Such a layout
+          may be necessary when the hardware has been programmed to capture
+          or output interlaced video images and is unable to separate the
+          fields for VBI capturing at the same time. For simplicity setting
+          this flag implies that both ``count`` values are equal and
+          non-zero.
+
+
+
+.. _vbi-hsync:
+
+.. figure::  dev-raw-vbi_files/vbi_hsync.*
+    :alt:    vbi_hsync.pdf / vbi_hsync.gif
+    :align:  center
+
+    Line synchronization
+
+    Line synchronization diagram
+
+
+
+
+.. _vbi-525:
+
+.. figure::  dev-raw-vbi_files/vbi_525.*
+    :alt:    vbi_525.pdf / vbi_525.gif
+    :align:  center
+
+    ITU-R 525 line numbering (M/NTSC and M/PAL)
+
+    NTSC field synchronization diagram
+
+
+
+
+.. _vbi-625:
+
+.. figure::  dev-raw-vbi_files/vbi_625.*
+    :alt:    vbi_625.pdf / vbi_625.gif
+    :align:  center
+
+    ITU-R 625 line numbering
+
+    PAL/SECAM field synchronization diagram
+
+
+
+Remember the VBI image format depends on the selected video standard,
+therefore the application must choose a new standard or query the
+current standard first. Attempts to read or write data ahead of format
+negotiation, or after switching the video standard which may invalidate
+the negotiated VBI parameters, should be refused by the driver. A format
+change during active I/O is not permitted.
+
+
+Reading and writing VBI images
+==============================
+
+To assure synchronization with the field number and easier
+implementation, the smallest unit of data passed at a time is one frame,
+consisting of two fields of VBI images immediately following in memory.
+
+The total size of a frame computes as follows:
+
+
+.. code-block:: c
+
+    (count[0] + count[1]) *
+    samples_per_line * sample size in bytes
+
+The sample size is most likely always one byte, applications must check
+the ``sample_format`` field though, to function properly with other
+drivers.
+
+A VBI device may support :ref:`read/write <rw>` and/or streaming
+(:ref:`memory mapping <mmap>` or :ref:`user pointer <userp>`) I/O.
+The latter bears the possibility of synchronizing video and VBI data by
+using buffer timestamps.
+
+Remember the :ref:`VIDIOC_STREAMON <vidioc-streamon>` ioctl and the
+first read(), write() and select() call can be resource allocation
+points returning an EBUSY error code if the required hardware resources
+are temporarily unavailable, for example the device is already in use by
+another process.
+
+.. [1]
+   ASK: Amplitude-Shift Keying. A high signal level represents a '1'
+   bit, a low level a '0' bit.
+
+.. [2]
+   A few devices may be unable to sample VBI data at all but can extend
+   the video capture window to the VBI region.
+
+.. [3]
+   Most VBI services transmit on both fields, but some have different
+   semantics depending on the field number. These cannot be reliable
+   decoded or encoded when ``V4L2_VBI_UNSYNC`` is set.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/dev-raw-vbi_files/vbi_525.gif b/Documentation/linux_tv/media/v4l/dev-raw-vbi_files/vbi_525.gif
new file mode 100644
index 0000000000000000000000000000000000000000..5580b690d504f388f5c62f730c45e09999da1341
GIT binary patch
literal 4741
zcmV;05_;`NNk%w1VJZX20Du4h00030|NkNR1OWg50RSuj0000g1IPdX0{)DTsmtvT
zqnxzbi?iOm`wxcVNS5Y_rs`S(Y~#L5EGu+<+_<6Ref<OO5J6dybzCKt!(7w(q%9MG
zYRpQsOo`Y)*ZYlZA7j`id@0YW95usDJ)<jdZau5D-tlR6XFsQ<A>}8Sp>qewQ)rk+
zn26C8C?Q41#k1H*dFh3z*|+Bzc{MmlS}J#@+O`_%`gbUbng$gMn#nj(_cbXt>f*QC
zhZ!6>40hUBre}lvNj3-E`v$wpYI}|SYYqB(IK8PoYZxkPY5q)+45!GKt{X=?-YKsw
zjP6hj1^oV&Os_8-H)Gidn(`J4;jwn3@Tr?8PF=2ux}*&}SE-*b{&(jL(yIsZqecji
z4BiXI?4i7gB1u+*NT*ymhw#3EBjbT#J%t?$s%+`e5l@V@euji(i)GC`oPt(two{^~
z9&VPMx)E^W#gQ(3#-u3_rctIq$9^qqcBxl^GZiUSOYR@so@lkM+-kRO*q>SX#=MeJ
zFExpPCA}StH*Lk6`Q*ra>GW@6N{9D8&1n;J=E+^1g`|trn4Wuo*^G`%k{M&fGuIk<
z0+tEv)|^$)uASnx*cZA{zm5W1u<fEddVlsYJGgPKxs@k>-efu5;?Sd44~{*%_U+ue
zd;bnTy!i3t%bP!sKE3+&?AyD44?n*A`Sk1CzmGq^{{8&^`}_Y7V1NP+NML~m9*AIq
z3NA>|Z`NIh9E3suC!vE6UO0qw(@jX>g=+A^NL7+8Qj%gDp12rp`BavdZ<dv|8)c6P
z)z)UN$#|nyt3ef1Xe+U3#w{c^m|9`jSTz+fK*mE^lAZL0(?L0=7F(1J31{UuDh9db
zU_+s3Vplbq)TJG`u(QpOF0N=1mNP5_MwN(3<r!(h1m-43@Zc#Yacj2tXJe2ZM_8Fu
z>^P@TQ)U@slw(HKsH1)Y3YU+ckk(_Mg7(QHnsI(4VqCI(I4GfDQd(%FIDL7UPGqtA
zqNzn{Hq4S--o>e&V_Di0ue%bdqpeJSm=UPVHI@F6u({r<DGW0%%4lh>0^1p+)NTsx
zo69B&qpCp`8)mh6^7x~-HefYvlT3C*Y7XlhTa-SY8cMFLbI}QFxZ<9bZmaZe%j{B*
z(xPm=7|9juUcT0pFSg@qs|><y5rz_0@FG(&iNX%t>>7v~JfgV{U+nR}?ml}~sVS<w
zvdEnl3@~vEZ*rQw{$Nov$r?)&nuhmUm|=xLM~Gq29TrWr(MMA!G!l~z%^}iJD@`@i
zODA15)>>~3_0&ZBoUqeP%XYQbW}nTQb7gnUw%BVk2zT6a&rNsTcHfP6-g@uNci(>h
z4S3*!4^DXDh98c2;)-)O5!fa#4teB~2mW4!#o6Tov)hwz&Uxp9D^*D5Bw+5i%buT(
zdg=nQ#Ltu1z58(5s?Sb)?E$v_DJfSGB73smm2P|R!VfQ7>!DX-eC)TP>twOO|4e-J
z(oe6Q?m7aL6YokkWo-3DK2Lr4;@b`wS;~u&yzep-Q~hY}zc2du^3N~)Kl7e1uj_g8
z1OC3}@=3n{3UGX;5doTx=Y%ov&wJ1qpaUOBz)yuBRAx{hxZVcA3~F$C8ls>-=ybl(
zZE%Dn<e&+rpc?-<%U#X_UjIr6!}fg4fbsjo3@2E_HsI`p8^N6jso}yH3ej#p6v7Mf
zfHG1YaUUT>6%w0>sv`1mh*XT5{uI-;L??+ui4VHs2T;hqDZVL)RV<@|yvT$sVs9KG
zQls@+&_gJyP=98u<L1yf95==+UV_jg9Y+AhKLWCXb}Xdi@Yozbx~h#`l;g;>g~%I4
z(vXz&+a!6YNH!9zksXYq&noB0N{aG~p-f04?XgLtUD6|AFw7@IgfsZba+b8LSS@9V
zv0J_`m%6N3FX6YdU)oZbH*{Y&U}j7j?ILFsGYv6)`Ak<vGnmBWWi_LTC)Hr{nRejW
zHic;>Yl8D+v+Slgze&q*-mqmNN#1anNJh7mq8&)7r|H@WlKbhCmHBL<#KK`uQwo%y
zf)pe6o@cRt+GPorTP0-v+$p;-k}*l~oTo*Tf>DC>D@*&-L`OZ^PkLq)SE9KnK^@AC
zH@;J%sN`rESE|1kCUlP=EhrrQiBpkkbfh+enDQ*wt9}YKs5&JnIZT?$la{htDs4^z
zV}=N(zSOBKwGc#6(9oqyYM@CqDp7WNEuVhWC}SmSNKp|`uUbN$Ek&s&ZF<wH*3_kN
z{h?enchwVQwW3_@BU*X-)sFFTu4W}{VTt-zu&VVTY*p$+4~o|{8g@=i#cCE5YS6r9
zcB*=%sar3b*u?_$o<KdUY1M+MeHQhoitVaj+p1M;RkpKF{pq@v$64Cmm26L1r%-*%
z+LHD)u)!^^&hY*@*@X@@s32V}ai6<Zq}CL;%%v_-i>WKIstKmvjM@=PE4IeE7P<@r
z?5QZbT-2slz0D1+aaAJT*AmpKR*P*|mIz+&ChfbP&8d6IJKC_4tE~53Z-Luu-tx9q
zzT-VDZ}FR5%RY^&_GK=8Cluf4COE*N4I6HgD^(DO7_l3U<AOCT-1$bd!pha}eviiA
z3DY*ijQuZsOYFoCTiC%Z7O`w`8bZu&HN_2P?}c4_<Rrfs$-R><iaRVO9MAE`KGrdh
zdu&$c-uT2d9`2PTOw*JunaN{bag1raCmSmm%2T$ok-tpkDx+7+YkqH+i7aQkvUtR1
zuCE%AtN!HTIr+|P7F1e$I$#6y`OR>~EuA@R=QMkn(GT`>nfn|aW+Fk;N&v2>;|IXS
zB;wQDB<DD(smpGj`kc2^^)JKui&2X%)a-P`L983=9NGle$HXtEM+xj;3wzkaF1E3c
zjqGGAd)drxwzHoN?PyDT+SIPLwXcosY-@Yl-0rrwzYXqii+kMUF1NYQjqY@-d)@4A
zx4YjB?|935-t?}wz3*-9AY?Vs`0lsA^$NNO1Nz?tFSurQnTg&OgVqLbxWmO%S|b7E
zf)B5_#b0K>U?zOe7w@>a-_=lgLCNDJH+W$(u5jJ)y5uZxxyxS;^O(zg<}|Ol&2NtL
z{+#Q4=REJZ&wmc|pbLHIL@&D0kB;=DD}CuqZ@SZ;4)v%@ed<)Ny4A0a^{i`s>s;@;
z*S`+-u#0`{WG}nf&yM!7!L+_vL)(hk&b7Ajw(W9XJKWu_Ikg|EL^C8-i97?n7H)T2
zem|MU&ilXZ_B~{={Ma%j4)`{g4DgFj)oCifGG=;E49;{V$)w3Moi#p0pC2a15D#k*
zDXZ|5FBrvF)Vz^Da)oPb(=zxaS=Zx>qJmv`^H87gs|ehu{t~{Mh{e*^&;Elgi6!uJ
z7Z1#HepJxc7bg%Q`+zkN(7N{*Xb~O!--93e#%~w?PCtB*`2v8q&$Z#7f7#LgA9rVm
zhkpWFIe$|#F~@8Qi1|tUFsXH0{Kp#Vr+ru!fJgFv)~8(zcYslra`TrynCB_}cU<KI
zDjOpj!nb(<C2{}9SSq(H6$m>F2t>Q1KpVI{t9KOL6L`!LRrWV<v2#Be2!clDRyAmQ
zGRSvAW`Kr<5+f*MYfuYq0)L^iJ}*dw#`0^+$9yiBfVlTkH@JP>Q-j_|M_W)8u;YNl
zM<q`rgdl_t9ax3!bcJOI6jWG-kHCUrn1)B_JOdal+lM?u*eSg-TOKxGA~-G-loezs
zTOVkD+OvZuI4Z^`gBdu5diXLFrG^26fse>7RPlN1f+;N$iGw(RfC&DH;b(~4SA9x2
zEcX|NeV7uXCyD=)F@r~dsup=P*i337eVo^L3n+^ES0`uqJ)y^nPUtb6XN!!8i^s!>
zzlee9_k*fvgiZK>#<+2_xQh~Ghsn5iLD-9u=ZdXYjLN8u%Aj{(CN*_ucX&6B<Vaz3
z_jYlYj^=odU-ON+6^`r3j_`PQ^Jq}$n0M-!kM?+v?ubEiSC8^2j^G%O0=bX;sAmOv
zkOsMs4ViWi36T*gkrPRg6={(^_h%d@j0CBV0Ev);^p5@5k?r`AAQ_JgIgs=?k|ddu
zDp`^fq&6q%kmZPyG&z$tNj9vPi`$rZir0pZ6K2%q3OU3v`Tl24<2QNtgo}dJlS+Aw
ziHJU#vq%EwC9{?$ulR}Y=Ud9hd?;9o(^q?;*ouPpIN3LrOV}`ANtM2cjfMu4)7XqA
zww9x)l!hUVx7d_hxeaE?mS`!KS(!V0$t8D!2B}y<(Eym#*p`dwg-j`jsWO+p7@0@u
zl*rhZZt0X<xsi|rmyfA1lbM7@*?f-a4t7#5P`H`<unroSEtffmi3w|@SzDlaeX{wN
zq8XHq(VFLSmquBFusNExnO}HGd@~a)rU^pGql>hMn(g<NL%Ex-$t|%+n~iyvcUYNW
z24qkK2tpZJ%b6F(32}AFJfPV)WI|SXc%9{0h^aZ9{!po%{^WzN37>K#nD41BX~~%Q
zc|DbBgu>~G@EL<h8GZjUprlEN=qV!^!;JjNjok>Gof((V;Ay(~mfUGW;yEioNt71q
zpB;K6QaKMA+87Ngo%&~@6Y7k58K2RakP3;D9@&y{C6h5~qa68?F!_%%8c`YPqcMq(
zH;JP&N~17(qb^CLFPftu@S`nyp)RVVNotZodZb8NlPr0qR+^<Exuh5ArC$oBVJfC$
zx^9R_re``JkAZ|}%BBE<5SrPhaXKGwDxq?!bQvi_)&Qq=`fs|XC3Ph?bn2vhnr@%<
zMYma<=D|>m;-`dKZu!%jDN`3xbd1N49}E@#Y6t45eJVi<WD2txf6ZX18|RtnflZrQ
za^SM3-!c`vfDiLYNVtQihf1L<hpO(jsFCWHl-MVbAae47skiEKTIf*a83!ro6#wZS
zvns5Q3NK)UtQ}ZD@xiRkI&M4(mm32lDI}@@_gL0?MvZ!vK47atLYx!Et@}Ai>dA4V
zikskCAMOeZnIvX}cAYfAt}IiapoB?03a@FZk*jh_EoHC!iLbfEq@JXrgBGR#3b1-a
zuLLV;=X$V!3N7sVNdfDya3im*5V0yoGd#$uofKvK3P;ttvHa1os_?OS)~$fauPdvf
z7~5GWo3i>Lvy&!h5<9W(IjIOstCId=vLa-&H;W%Ri)X)~69*)+Ub1KC0<}-cYNd8~
zuQs){gleybPFIVyTw6|Fi%Y#Gw#qcN((-ty$W2=dw!pNu2)DK91h?h{w^m!VbK6Vm
z^i8G~wspH|qK3B}M0&OLSosQug;t^r3uyp$uhi$VmZ)fSg<wg$WrpjtI?G)^JEerH
zqr25;$c4001*@AIQ<Y}1`$xGzgt&4UX^T692exCBhJfmYW{EqwtGj*}qPal}S(O&L
z{6=M;>r%a|yP8F#xhq+=>k_l8x{7PCjQhH-+qv3xR+bBarwbLzOJT<QP?(#!#~ZzS
z6<NYdE2De4rK?5AE3ni%Wd7*8u)Z6;?hCt%CcCLyz3f}Lk{em(JHFbxz2fV<zpJs-
z=f4F(yn1H51MIy|#$fi#nFwl`j@!7U`MAMLzw67q7OcP*2D~4(!Hx!1$Oyi?JE-#;
zz#&|}7o5KMOS^TJh{Gwru?xd5tX$ZO!7N<63#`E<{6q-#eFTPH`n$ggoW1Bb#8`R1
z3_L~^jG5M3s&V$d5d6F`47y6ps$90hJ?moS`n%!^y4aPiNW{g#tHn|bj}<6oDO_Y%
zyu69&!jSvK5*)!2Ov6iz#09FpWqfJ*8)&3UH8BP-2#ml$oWy5b#RU4l@$1Hj?8I3{
z#Yc?7g`CFayT_7@{%K@p$&_rvnT*95e8Zhgv4;%3itJ{gOu{O>#+rP}n_S7O%*uQ`
z$$H$%sVvL4d&iLc$PPNnWSq+~oXDjd$tUc|YD~+PcFCCR%CU^h;AqBH9J00S$id9I
zZM?{&tjj+fxxZY)!ko>`Ow6yW%z1pw#r(~6T)5bLxP<)7pWM3DEWJ_8%M|R)4a~&l
zjKj%{$KYJV;vCM#Jj>fW%;s#%(A>Q1{LZ`F%k12MjV#aPY`Oqly!f2Y_I%G7lA@zi
z(W<y>Qeq?BkkPreYNx8VcN@~FHqxzD(k3mnw0LVB&CweT1Q$(1U3fw;jYBfs0yJ&3
zIjz$>&C@+@?bAOE)IlxOLrv60ZPZ7N)Jd(>OU=|x?bJ^V)ln_gQ%%)XZPize)n8N@
zG57=0oYgsPmYNF1Up>?(N5teO31>~#K%FcXB#525)<GS(YpR;3xT<meuUy?1Z=Ke7
T-P69LB$yM}Di_AhS^xk$4hn6I

literal 0
HcmV?d00001

diff --git a/Documentation/linux_tv/media/v4l/dev-raw-vbi_files/vbi_525.pdf b/Documentation/linux_tv/media/v4l/dev-raw-vbi_files/vbi_525.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..9e72c25b208db6c7844ed85fe9742324602c0a5c
GIT binary patch
literal 3395
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

literal 0
HcmV?d00001

diff --git a/Documentation/linux_tv/media/v4l/dev-raw-vbi_files/vbi_625.gif b/Documentation/linux_tv/media/v4l/dev-raw-vbi_files/vbi_625.gif
new file mode 100644
index 0000000000000000000000000000000000000000..34e3251983c4918ac5457a27d524ab1eaa54626a
GIT binary patch
literal 5095
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
Jo|**!06Qe}G|~V7

literal 0
HcmV?d00001

diff --git a/Documentation/linux_tv/media/v4l/dev-raw-vbi_files/vbi_625.pdf b/Documentation/linux_tv/media/v4l/dev-raw-vbi_files/vbi_625.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..765235e33a4de256a0b3fbf64ffe52946190cac4
GIT binary patch
literal 3683
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
O%*+C6V6bby1N2|1C{8y3

literal 0
HcmV?d00001

diff --git a/Documentation/linux_tv/media/v4l/dev-raw-vbi_files/vbi_hsync.gif b/Documentation/linux_tv/media/v4l/dev-raw-vbi_files/vbi_hsync.gif
new file mode 100644
index 0000000000000000000000000000000000000000..b02434d3b356c4646c47dc85dd662daf54202cdf
GIT binary patch
literal 2400
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
S_q*T?uXx8x-ttl;AOJhB!Nzd_

literal 0
HcmV?d00001

diff --git a/Documentation/linux_tv/media/v4l/dev-raw-vbi_files/vbi_hsync.pdf b/Documentation/linux_tv/media/v4l/dev-raw-vbi_files/vbi_hsync.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..200b668189bf1d0761dbcd75f38e43cb4d703a33
GIT binary patch
literal 7405
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
Z)<*{hlj6^0trDJuCm<vxbxd^;{{w1gP%Que

literal 0
HcmV?d00001

diff --git a/Documentation/linux_tv/media/v4l/dev-rds.rst b/Documentation/linux_tv/media/v4l/dev-rds.rst
new file mode 100644
index 000000000000..498752aa5eaf
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/dev-rds.rst
@@ -0,0 +1,266 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _rds:
+
+*************
+RDS Interface
+*************
+
+The Radio Data System transmits supplementary information in binary
+format, for example the station name or travel information, on an
+inaudible audio subcarrier of a radio program. This interface is aimed
+at devices capable of receiving and/or transmitting RDS information.
+
+For more information see the core RDS standard :ref:`iec62106` and the
+RBDS standard :ref:`nrsc4`.
+
+Note that the RBDS standard as is used in the USA is almost identical to
+the RDS standard. Any RDS decoder/encoder can also handle RBDS. Only
+some of the fields have slightly different meanings. See the RBDS
+standard for more information.
+
+The RBDS standard also specifies support for MMBS (Modified Mobile
+Search). This is a proprietary format which seems to be discontinued.
+The RDS interface does not support this format. Should support for MMBS
+(or the so-called 'E blocks' in general) be needed, then please contact
+the linux-media mailing list:
+`https://linuxtv.org/lists.php <https://linuxtv.org/lists.php>`__.
+
+
+Querying Capabilities
+=====================
+
+Devices supporting the RDS capturing API set the
+``V4L2_CAP_RDS_CAPTURE`` flag in the ``capabilities`` field of struct
+:ref:`v4l2_capability <v4l2-capability>` returned by the
+:ref:`VIDIOC_QUERYCAP <vidioc-querycap>` ioctl. Any tuner that
+supports RDS will set the ``V4L2_TUNER_CAP_RDS`` flag in the
+``capability`` field of struct :ref:`v4l2_tuner <v4l2-tuner>`. If the
+driver only passes RDS blocks without interpreting the data the
+``V4L2_TUNER_CAP_RDS_BLOCK_IO`` flag has to be set, see
+:ref:`Reading RDS data <reading-rds-data>`. For future use the flag
+``V4L2_TUNER_CAP_RDS_CONTROLS`` has also been defined. However, a driver
+for a radio tuner with this capability does not yet exist, so if you are
+planning to write such a driver you should discuss this on the
+linux-media mailing list:
+`https://linuxtv.org/lists.php <https://linuxtv.org/lists.php>`__.
+
+Whether an RDS signal is present can be detected by looking at the
+``rxsubchans`` field of struct :ref:`v4l2_tuner <v4l2-tuner>`: the
+``V4L2_TUNER_SUB_RDS`` will be set if RDS data was detected.
+
+Devices supporting the RDS output API set the ``V4L2_CAP_RDS_OUTPUT``
+flag in the ``capabilities`` field of struct
+:ref:`v4l2_capability <v4l2-capability>` returned by the
+:ref:`VIDIOC_QUERYCAP <vidioc-querycap>` ioctl. Any modulator that
+supports RDS will set the ``V4L2_TUNER_CAP_RDS`` flag in the
+``capability`` field of struct
+:ref:`v4l2_modulator <v4l2-modulator>`. In order to enable the RDS
+transmission one must set the ``V4L2_TUNER_SUB_RDS`` bit in the
+``txsubchans`` field of struct
+:ref:`v4l2_modulator <v4l2-modulator>`. If the driver only passes RDS
+blocks without interpreting the data the ``V4L2_TUNER_CAP_RDS_BLOCK_IO``
+flag has to be set. If the tuner is capable of handling RDS entities
+like program identification codes and radio text, the flag
+``V4L2_TUNER_CAP_RDS_CONTROLS`` should be set, see
+:ref:`Writing RDS data <writing-rds-data>` and
+:ref:`FM Transmitter Control Reference <fm-tx-controls>`.
+
+
+.. _reading-rds-data:
+
+Reading RDS data
+================
+
+RDS data can be read from the radio device with the
+:ref:`read() <func-read>` function. The data is packed in groups of
+three bytes.
+
+
+.. _writing-rds-data:
+
+Writing RDS data
+================
+
+RDS data can be written to the radio device with the
+:ref:`write() <func-write>` function. The data is packed in groups of
+three bytes, as follows:
+
+
+RDS datastructures
+==================
+
+
+.. _v4l2-rds-data:
+
+.. flat-table:: struct v4l2_rds_data
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 5
+
+
+    -  .. row 1
+
+       -  __u8
+
+       -  ``lsb``
+
+       -  Least Significant Byte of RDS Block
+
+    -  .. row 2
+
+       -  __u8
+
+       -  ``msb``
+
+       -  Most Significant Byte of RDS Block
+
+    -  .. row 3
+
+       -  __u8
+
+       -  ``block``
+
+       -  Block description
+
+
+
+.. _v4l2-rds-block:
+
+.. flat-table:: Block description
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 5
+
+
+    -  .. row 1
+
+       -  Bits 0-2
+
+       -  Block (aka offset) of the received data.
+
+    -  .. row 2
+
+       -  Bits 3-5
+
+       -  Deprecated. Currently identical to bits 0-2. Do not use these
+          bits.
+
+    -  .. row 3
+
+       -  Bit 6
+
+       -  Corrected bit. Indicates that an error was corrected for this data
+          block.
+
+    -  .. row 4
+
+       -  Bit 7
+
+       -  Error bit. Indicates that an uncorrectable error occurred during
+          reception of this block.
+
+
+
+.. _v4l2-rds-block-codes:
+
+.. flat-table:: Block defines
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 1 5
+
+
+    -  .. row 1
+
+       -  V4L2_RDS_BLOCK_MSK
+
+       -  
+       -  7
+
+       -  Mask for bits 0-2 to get the block ID.
+
+    -  .. row 2
+
+       -  V4L2_RDS_BLOCK_A
+
+       -  
+       -  0
+
+       -  Block A.
+
+    -  .. row 3
+
+       -  V4L2_RDS_BLOCK_B
+
+       -  
+       -  1
+
+       -  Block B.
+
+    -  .. row 4
+
+       -  V4L2_RDS_BLOCK_C
+
+       -  
+       -  2
+
+       -  Block C.
+
+    -  .. row 5
+
+       -  V4L2_RDS_BLOCK_D
+
+       -  
+       -  3
+
+       -  Block D.
+
+    -  .. row 6
+
+       -  V4L2_RDS_BLOCK_C_ALT
+
+       -  
+       -  4
+
+       -  Block C'.
+
+    -  .. row 7
+
+       -  V4L2_RDS_BLOCK_INVALID
+
+       -  read-only
+
+       -  7
+
+       -  An invalid block.
+
+    -  .. row 8
+
+       -  V4L2_RDS_BLOCK_CORRECTED
+
+       -  read-only
+
+       -  0x40
+
+       -  A bit error was detected but corrected.
+
+    -  .. row 9
+
+       -  V4L2_RDS_BLOCK_ERROR
+
+       -  read-only
+
+       -  0x80
+
+       -  An uncorrectable error occurred.
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/dev-sdr.rst b/Documentation/linux_tv/media/v4l/dev-sdr.rst
new file mode 100644
index 000000000000..8e9e34b8d53a
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/dev-sdr.rst
@@ -0,0 +1,129 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _sdr:
+
+**************************************
+Software Defined Radio Interface (SDR)
+**************************************
+
+SDR is an abbreviation of Software Defined Radio, the radio device which
+uses application software for modulation or demodulation. This interface
+is intended for controlling and data streaming of such devices.
+
+SDR devices are accessed through character device special files named
+``/dev/swradio0`` to ``/dev/swradio255`` with major number 81 and
+dynamically allocated minor numbers 0 to 255.
+
+
+Querying Capabilities
+=====================
+
+Devices supporting the SDR receiver interface set the
+``V4L2_CAP_SDR_CAPTURE`` and ``V4L2_CAP_TUNER`` flag in the
+``capabilities`` field of struct
+:ref:`v4l2_capability <v4l2-capability>` returned by the
+:ref:`VIDIOC_QUERYCAP <vidioc-querycap>` ioctl. That flag means the
+device has an Analog to Digital Converter (ADC), which is a mandatory
+element for the SDR receiver.
+
+Devices supporting the SDR transmitter interface set the
+``V4L2_CAP_SDR_OUTPUT`` and ``V4L2_CAP_MODULATOR`` flag in the
+``capabilities`` field of struct
+:ref:`v4l2_capability <v4l2-capability>` returned by the
+:ref:`VIDIOC_QUERYCAP <vidioc-querycap>` ioctl. That flag means the
+device has an Digital to Analog Converter (DAC), which is a mandatory
+element for the SDR transmitter.
+
+At least one of the read/write, streaming or asynchronous I/O methods
+must be supported.
+
+
+Supplemental Functions
+======================
+
+SDR devices can support :ref:`controls <control>`, and must support
+the :ref:`tuner <tuner>` ioctls. Tuner ioctls are used for setting the
+ADC/DAC sampling rate (sampling frequency) and the possible radio
+frequency (RF).
+
+The ``V4L2_TUNER_SDR`` tuner type is used for setting SDR device ADC/DAC
+frequency, and the ``V4L2_TUNER_RF`` tuner type is used for setting
+radio frequency. The tuner index of the RF tuner (if any) must always
+follow the SDR tuner index. Normally the SDR tuner is #0 and the RF
+tuner is #1.
+
+The :ref:`VIDIOC_S_HW_FREQ_SEEK <vidioc-s-hw-freq-seek>` ioctl is
+not supported.
+
+
+Data Format Negotiation
+=======================
+
+The SDR device uses the :ref:`format <format>` ioctls to select the
+capture and output format. Both the sampling resolution and the data
+streaming format are bound to that selectable format. In addition to the
+basic :ref:`format <format>` ioctls, the
+:ref:`VIDIOC_ENUM_FMT <vidioc-enum-fmt>` ioctl must be supported as
+well.
+
+To use the :ref:`format <format>` ioctls applications set the ``type``
+field of a struct :ref:`v4l2_format <v4l2-format>` to
+``V4L2_BUF_TYPE_SDR_CAPTURE`` or ``V4L2_BUF_TYPE_SDR_OUTPUT`` and use
+the struct :ref:`v4l2_sdr_format <v4l2-sdr-format>` ``sdr`` member
+of the ``fmt`` union as needed per the desired operation. Currently
+there is two fields, ``pixelformat`` and ``buffersize``, of struct
+struct :ref:`v4l2_sdr_format <v4l2-sdr-format>` which are used.
+Content of the ``pixelformat`` is V4L2 FourCC code of the data format.
+The ``buffersize`` field is maximum buffer size in bytes required for
+data transfer, set by the driver in order to inform application.
+
+
+.. _v4l2-sdr-format:
+
+.. flat-table:: struct v4l2_sdr_format
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``pixelformat``
+
+       -  The data format or type of compression, set by the application.
+          This is a little endian
+          :ref:`four character code <v4l2-fourcc>`. V4L2 defines SDR
+          formats in :ref:`sdr-formats`.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``buffersize``
+
+       -  Maximum size in bytes required for data. Value is set by the
+          driver.
+
+    -  .. row 3
+
+       -  __u8
+
+       -  ``reserved[24]``
+
+       -  This array is reserved for future extensions. Drivers and
+          applications must set it to zero.
+
+
+An SDR device may support :ref:`read/write <rw>` and/or streaming
+(:ref:`memory mapping <mmap>` or :ref:`user pointer <userp>`) I/O.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/dev-sliced-vbi.rst b/Documentation/linux_tv/media/v4l/dev-sliced-vbi.rst
new file mode 100644
index 000000000000..90d879964f52
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/dev-sliced-vbi.rst
@@ -0,0 +1,804 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _sliced:
+
+*************************
+Sliced VBI Data Interface
+*************************
+
+VBI stands for Vertical Blanking Interval, a gap in the sequence of
+lines of an analog video signal. During VBI no picture information is
+transmitted, allowing some time while the electron beam of a cathode ray
+tube TV returns to the top of the screen.
+
+Sliced VBI devices use hardware to demodulate data transmitted in the
+VBI. V4L2 drivers shall *not* do this by software, see also the
+:ref:`raw VBI interface <raw-vbi>`. The data is passed as short
+packets of fixed size, covering one scan line each. The number of
+packets per video frame is variable.
+
+Sliced VBI capture and output devices are accessed through the same
+character special files as raw VBI devices. When a driver supports both
+interfaces, the default function of a ``/dev/vbi`` device is *raw* VBI
+capturing or output, and the sliced VBI function is only available after
+calling the :ref:`VIDIOC_S_FMT <vidioc-g-fmt>` ioctl as defined
+below. Likewise a ``/dev/video`` device may support the sliced VBI API,
+however the default function here is video capturing or output.
+Different file descriptors must be used to pass raw and sliced VBI data
+simultaneously, if this is supported by the driver.
+
+
+Querying Capabilities
+=====================
+
+Devices supporting the sliced VBI capturing or output API set the
+``V4L2_CAP_SLICED_VBI_CAPTURE`` or ``V4L2_CAP_SLICED_VBI_OUTPUT`` flag
+respectively, in the ``capabilities`` field of struct
+:ref:`v4l2_capability <v4l2-capability>` returned by the
+:ref:`VIDIOC_QUERYCAP <vidioc-querycap>` ioctl. At least one of the
+read/write, streaming or asynchronous :ref:`I/O methods <io>` must be
+supported. Sliced VBI devices may have a tuner or modulator.
+
+
+Supplemental Functions
+======================
+
+Sliced VBI devices shall support :ref:`video input or output <video>`
+and :ref:`tuner or modulator <tuner>` ioctls if they have these
+capabilities, and they may support :ref:`control <control>` ioctls.
+The :ref:`video standard <standard>` ioctls provide information vital
+to program a sliced VBI device, therefore must be supported.
+
+
+.. _sliced-vbi-format-negotitation:
+
+Sliced VBI Format Negotiation
+=============================
+
+To find out which data services are supported by the hardware
+applications can call the
+:ref:`VIDIOC_G_SLICED_VBI_CAP <vidioc-g-sliced-vbi-cap>` ioctl.
+All drivers implementing the sliced VBI interface must support this
+ioctl. The results may differ from those of the
+:ref:`VIDIOC_S_FMT <vidioc-g-fmt>` ioctl when the number of VBI
+lines the hardware can capture or output per frame, or the number of
+services it can identify on a given line are limited. For example on PAL
+line 16 the hardware may be able to look for a VPS or Teletext signal,
+but not both at the same time.
+
+To determine the currently selected services applications set the
+``type`` field of struct :ref:`v4l2_format <v4l2-format>` to
+``V4L2_BUF_TYPE_SLICED_VBI_CAPTURE`` or
+``V4L2_BUF_TYPE_SLICED_VBI_OUTPUT``, and the
+:ref:`VIDIOC_G_FMT <vidioc-g-fmt>` ioctl fills the ``fmt.sliced``
+member, a struct
+:ref:`v4l2_sliced_vbi_format <v4l2-sliced-vbi-format>`.
+
+Applications can request different parameters by initializing or
+modifying the ``fmt.sliced`` member and calling the
+:ref:`VIDIOC_S_FMT <vidioc-g-fmt>` ioctl with a pointer to the
+:c:type:`struct v4l2_format` structure.
+
+The sliced VBI API is more complicated than the raw VBI API because the
+hardware must be told which VBI service to expect on each scan line. Not
+all services may be supported by the hardware on all lines (this is
+especially true for VBI output where Teletext is often unsupported and
+other services can only be inserted in one specific line). In many
+cases, however, it is sufficient to just set the ``service_set`` field
+to the required services and let the driver fill the ``service_lines``
+array according to hardware capabilities. Only if more precise control
+is needed should the programmer set the ``service_lines`` array
+explicitly.
+
+The :ref:`VIDIOC_S_FMT <vidioc-g-fmt>` ioctl modifies the parameters
+according to hardware capabilities. When the driver allocates resources
+at this point, it may return an EBUSY error code if the required
+resources are temporarily unavailable. Other resource allocation points
+which may return EBUSY can be the
+:ref:`VIDIOC_STREAMON <vidioc-streamon>` ioctl and the first
+:ref:`read() <func-read>`, :ref:`write() <func-write>` and
+:ref:`select() <func-select>` call.
+
+
+.. _v4l2-sliced-vbi-format:
+
+.. flat-table:: struct v4l2_sliced_vbi_format
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 3 2 2 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``service_set``
+
+       -  :cspan:`2`
+
+          If ``service_set`` is non-zero when passed with
+          :ref:`VIDIOC_S_FMT <vidioc-g-fmt>` or
+          :ref:`VIDIOC_TRY_FMT <vidioc-g-fmt>`, the ``service_lines``
+          array will be filled by the driver according to the services
+          specified in this field. For example, if ``service_set`` is
+          initialized with ``V4L2_SLICED_TELETEXT_B | V4L2_SLICED_WSS_625``,
+          a driver for the cx25840 video decoder sets lines 7-22 of both
+          fields [1]_ to ``V4L2_SLICED_TELETEXT_B`` and line 23 of the first
+          field to ``V4L2_SLICED_WSS_625``. If ``service_set`` is set to
+          zero, then the values of ``service_lines`` will be used instead.
+
+          On return the driver sets this field to the union of all elements
+          of the returned ``service_lines`` array. It may contain less
+          services than requested, perhaps just one, if the hardware cannot
+          handle more services simultaneously. It may be empty (zero) if
+          none of the requested services are supported by the hardware.
+
+    -  .. row 2
+
+       -  __u16
+
+       -  ``service_lines``\ [2][24]
+
+       -  :cspan:`2`
+
+          Applications initialize this array with sets of data services the
+          driver shall look for or insert on the respective scan line.
+          Subject to hardware capabilities drivers return the requested set,
+          a subset, which may be just a single service, or an empty set.
+          When the hardware cannot handle multiple services on the same line
+          the driver shall choose one. No assumptions can be made on which
+          service the driver chooses.
+
+          Data services are defined in :ref:`vbi-services2`. Array indices
+          map to ITU-R line numbers (see also :ref:`vbi-525` and
+          :ref:`vbi-625`) as follows:
+
+    -  .. row 3
+
+       -  
+       -  
+       -  Element
+
+       -  525 line systems
+
+       -  625 line systems
+
+    -  .. row 4
+
+       -  
+       -  
+       -  ``service_lines``\ [0][1]
+
+       -  1
+
+       -  1
+
+    -  .. row 5
+
+       -  
+       -  
+       -  ``service_lines``\ [0][23]
+
+       -  23
+
+       -  23
+
+    -  .. row 6
+
+       -  
+       -  
+       -  ``service_lines``\ [1][1]
+
+       -  264
+
+       -  314
+
+    -  .. row 7
+
+       -  
+       -  
+       -  ``service_lines``\ [1][23]
+
+       -  286
+
+       -  336
+
+    -  .. row 8
+
+       -  
+       -  
+       -  :cspan:`2` Drivers must set ``service_lines`` [0][0] and
+          ``service_lines``\ [1][0] to zero. The
+          ``V4L2_VBI_ITU_525_F1_START``, ``V4L2_VBI_ITU_525_F2_START``,
+          ``V4L2_VBI_ITU_625_F1_START`` and ``V4L2_VBI_ITU_625_F2_START``
+          defines give the start line numbers for each field for each 525 or
+          625 line format as a convenience. Don't forget that ITU line
+          numbering starts at 1, not 0.
+
+    -  .. row 9
+
+       -  __u32
+
+       -  ``io_size``
+
+       -  :cspan:`2` Maximum number of bytes passed by one
+          :ref:`read() <func-read>` or :ref:`write() <func-write>` call,
+          and the buffer size in bytes for the
+          :ref:`VIDIOC_QBUF <vidioc-qbuf>` and
+          :ref:`VIDIOC_DQBUF <vidioc-qbuf>` ioctl. Drivers set this field
+          to the size of struct
+          :ref:`v4l2_sliced_vbi_data <v4l2-sliced-vbi-data>` times the
+          number of non-zero elements in the returned ``service_lines``
+          array (that is the number of lines potentially carrying data).
+
+    -  .. row 10
+
+       -  __u32
+
+       -  ``reserved``\ [2]
+
+       -  :cspan:`2` This array is reserved for future extensions.
+          Applications and drivers must set it to zero.
+
+
+
+.. _vbi-services2:
+
+.. flat-table:: Sliced VBI services
+    :header-rows:  1
+    :stub-columns: 0
+    :widths:       2 1 1 2 2
+
+
+    -  .. row 1
+
+       -  Symbol
+
+       -  Value
+
+       -  Reference
+
+       -  Lines, usually
+
+       -  Payload
+
+    -  .. row 2
+
+       -  ``V4L2_SLICED_TELETEXT_B`` (Teletext System B)
+
+       -  0x0001
+
+       -  :ref:`ets300706`, :ref:`itu653`
+
+       -  PAL/SECAM line 7-22, 320-335 (second field 7-22)
+
+       -  Last 42 of the 45 byte Teletext packet, that is without clock
+          run-in and framing code, lsb first transmitted.
+
+    -  .. row 3
+
+       -  ``V4L2_SLICED_VPS``
+
+       -  0x0400
+
+       -  :ref:`ets300231`
+
+       -  PAL line 16
+
+       -  Byte number 3 to 15 according to Figure 9 of ETS 300 231, lsb
+          first transmitted.
+
+    -  .. row 4
+
+       -  ``V4L2_SLICED_CAPTION_525``
+
+       -  0x1000
+
+       -  :ref:`cea608`
+
+       -  NTSC line 21, 284 (second field 21)
+
+       -  Two bytes in transmission order, including parity bit, lsb first
+          transmitted.
+
+    -  .. row 5
+
+       -  ``V4L2_SLICED_WSS_625``
+
+       -  0x4000
+
+       -  :ref:`itu1119`, :ref:`en300294`
+
+       -  PAL/SECAM line 23
+
+       -  
+
+          ::
+
+              Byte         0                 1
+                    msb         lsb  msb           lsb
+               Bit  7 6 5 4 3 2 1 0  x x 13 12 11 10 9
+
+    -  .. row 6
+
+       -  ``V4L2_SLICED_VBI_525``
+
+       -  0x1000
+
+       -  :cspan:`2` Set of services applicable to 525 line systems.
+
+    -  .. row 7
+
+       -  ``V4L2_SLICED_VBI_625``
+
+       -  0x4401
+
+       -  :cspan:`2` Set of services applicable to 625 line systems.
+
+
+Drivers may return an EINVAL error code when applications attempt to
+read or write data without prior format negotiation, after switching the
+video standard (which may invalidate the negotiated VBI parameters) and
+after switching the video input (which may change the video standard as
+a side effect). The :ref:`VIDIOC_S_FMT <vidioc-g-fmt>` ioctl may
+return an EBUSY error code when applications attempt to change the
+format while i/o is in progress (between a
+:ref:`VIDIOC_STREAMON <vidioc-streamon>` and
+:ref:`VIDIOC_STREAMOFF <vidioc-streamon>` call, and after the first
+:ref:`read() <func-read>` or :ref:`write() <func-write>` call).
+
+
+Reading and writing sliced VBI data
+===================================
+
+A single :ref:`read() <func-read>` or :ref:`write() <func-write>`
+call must pass all data belonging to one video frame. That is an array
+of :c:type:`struct v4l2_sliced_vbi_data` structures with one or
+more elements and a total size not exceeding ``io_size`` bytes. Likewise
+in streaming I/O mode one buffer of ``io_size`` bytes must contain data
+of one video frame. The ``id`` of unused
+:c:type:`struct v4l2_sliced_vbi_data` elements must be zero.
+
+
+.. _v4l2-sliced-vbi-data:
+
+.. flat-table:: struct v4l2_sliced_vbi_data
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``id``
+
+       -  A flag from :ref:`vbi-services` identifying the type of data in
+          this packet. Only a single bit must be set. When the ``id`` of a
+          captured packet is zero, the packet is empty and the contents of
+          other fields are undefined. Applications shall ignore empty
+          packets. When the ``id`` of a packet for output is zero the
+          contents of the ``data`` field are undefined and the driver must
+          no longer insert data on the requested ``field`` and ``line``.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``field``
+
+       -  The video field number this data has been captured from, or shall
+          be inserted at. ``0`` for the first field, ``1`` for the second
+          field.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``line``
+
+       -  The field (as opposed to frame) line number this data has been
+          captured from, or shall be inserted at. See :ref:`vbi-525` and
+          :ref:`vbi-625` for valid values. Sliced VBI capture devices can
+          set the line number of all packets to ``0`` if the hardware cannot
+          reliably identify scan lines. The field number must always be
+          valid.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``reserved``
+
+       -  This field is reserved for future extensions. Applications and
+          drivers must set it to zero.
+
+    -  .. row 5
+
+       -  __u8
+
+       -  ``data``\ [48]
+
+       -  The packet payload. See :ref:`vbi-services` for the contents and
+          number of bytes passed for each data type. The contents of padding
+          bytes at the end of this array are undefined, drivers and
+          applications shall ignore them.
+
+
+Packets are always passed in ascending line number order, without
+duplicate line numbers. The :ref:`write() <func-write>` function and
+the :ref:`VIDIOC_QBUF <vidioc-qbuf>` ioctl must return an EINVAL
+error code when applications violate this rule. They must also return an
+EINVAL error code when applications pass an incorrect field or line
+number, or a combination of ``field``, ``line`` and ``id`` which has not
+been negotiated with the :ref:`VIDIOC_G_FMT <vidioc-g-fmt>` or
+:ref:`VIDIOC_S_FMT <vidioc-g-fmt>` ioctl. When the line numbers are
+unknown the driver must pass the packets in transmitted order. The
+driver can insert empty packets with ``id`` set to zero anywhere in the
+packet array.
+
+To assure synchronization and to distinguish from frame dropping, when a
+captured frame does not carry any of the requested data services drivers
+must pass one or more empty packets. When an application fails to pass
+VBI data in time for output, the driver must output the last VPS and WSS
+packet again, and disable the output of Closed Caption and Teletext
+data, or output data which is ignored by Closed Caption and Teletext
+decoders.
+
+A sliced VBI device may support :ref:`read/write <rw>` and/or
+streaming (:ref:`memory mapping <mmap>` and/or
+:ref:`user pointer <userp>`) I/O. The latter bears the possibility of
+synchronizing video and VBI data by using buffer timestamps.
+
+
+Sliced VBI Data in MPEG Streams
+===============================
+
+If a device can produce an MPEG output stream, it may be capable of
+providing
+:ref:`negotiated sliced VBI services <sliced-vbi-format-negotitation>`
+as data embedded in the MPEG stream. Users or applications control this
+sliced VBI data insertion with the
+:ref:`V4L2_CID_MPEG_STREAM_VBI_FMT <v4l2-mpeg-stream-vbi-fmt>`
+control.
+
+If the driver does not provide the
+:ref:`V4L2_CID_MPEG_STREAM_VBI_FMT <v4l2-mpeg-stream-vbi-fmt>`
+control, or only allows that control to be set to
+:ref:`V4L2_MPEG_STREAM_VBI_FMT_NONE <v4l2-mpeg-stream-vbi-fmt>`,
+then the device cannot embed sliced VBI data in the MPEG stream.
+
+The
+:ref:`V4L2_CID_MPEG_STREAM_VBI_FMT <v4l2-mpeg-stream-vbi-fmt>`
+control does not implicitly set the device driver to capture nor cease
+capturing sliced VBI data. The control only indicates to embed sliced
+VBI data in the MPEG stream, if an application has negotiated sliced VBI
+service be captured.
+
+It may also be the case that a device can embed sliced VBI data in only
+certain types of MPEG streams: for example in an MPEG-2 PS but not an
+MPEG-2 TS. In this situation, if sliced VBI data insertion is requested,
+the sliced VBI data will be embedded in MPEG stream types when
+supported, and silently omitted from MPEG stream types where sliced VBI
+data insertion is not supported by the device.
+
+The following subsections specify the format of the embedded sliced VBI
+data.
+
+
+MPEG Stream Embedded, Sliced VBI Data Format: NONE
+--------------------------------------------------
+
+The
+:ref:`V4L2_MPEG_STREAM_VBI_FMT_NONE <v4l2-mpeg-stream-vbi-fmt>`
+embedded sliced VBI format shall be interpreted by drivers as a control
+to cease embedding sliced VBI data in MPEG streams. Neither the device
+nor driver shall insert "empty" embedded sliced VBI data packets in the
+MPEG stream when this format is set. No MPEG stream data structures are
+specified for this format.
+
+
+MPEG Stream Embedded, Sliced VBI Data Format: IVTV
+--------------------------------------------------
+
+The
+:ref:`V4L2_MPEG_STREAM_VBI_FMT_IVTV <v4l2-mpeg-stream-vbi-fmt>`
+embedded sliced VBI format, when supported, indicates to the driver to
+embed up to 36 lines of sliced VBI data per frame in an MPEG-2 *Private
+Stream 1 PES* packet encapsulated in an MPEG-2 *Program Pack* in the
+MPEG stream.
+
+*Historical context*: This format specification originates from a
+custom, embedded, sliced VBI data format used by the ``ivtv`` driver.
+This format has already been informally specified in the kernel sources
+in the file ``Documentation/video4linux/cx2341x/README.vbi`` . The
+maximum size of the payload and other aspects of this format are driven
+by the CX23415 MPEG decoder's capabilities and limitations with respect
+to extracting, decoding, and displaying sliced VBI data embedded within
+an MPEG stream.
+
+This format's use is *not* exclusive to the ``ivtv`` driver *nor*
+exclusive to CX2341x devices, as the sliced VBI data packet insertion
+into the MPEG stream is implemented in driver software. At least the
+``cx18`` driver provides sliced VBI data insertion into an MPEG-2 PS in
+this format as well.
+
+The following definitions specify the payload of the MPEG-2 *Private
+Stream 1 PES* packets that contain sliced VBI data when
+:ref:`V4L2_MPEG_STREAM_VBI_FMT_IVTV <v4l2-mpeg-stream-vbi-fmt>`
+is set. (The MPEG-2 *Private Stream 1 PES* packet header and
+encapsulating MPEG-2 *Program Pack* header are not detailed here. Please
+refer to the MPEG-2 specifications for details on those packet headers.)
+
+The payload of the MPEG-2 *Private Stream 1 PES* packets that contain
+sliced VBI data is specified by struct
+:ref:`v4l2_mpeg_vbi_fmt_ivtv <v4l2-mpeg-vbi-fmt-ivtv>`. The
+payload is variable length, depending on the actual number of lines of
+sliced VBI data present in a video frame. The payload may be padded at
+the end with unspecified fill bytes to align the end of the payload to a
+4-byte boundary. The payload shall never exceed 1552 bytes (2 fields
+with 18 lines/field with 43 bytes of data/line and a 4 byte magic
+number).
+
+
+.. _v4l2-mpeg-vbi-fmt-ivtv:
+
+.. flat-table:: struct v4l2_mpeg_vbi_fmt_ivtv
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 1 2
+
+
+    -  .. row 1
+
+       -  __u8
+
+       -  ``magic``\ [4]
+
+       -  
+       -  A "magic" constant from :ref:`v4l2-mpeg-vbi-fmt-ivtv-magic` that
+          indicates this is a valid sliced VBI data payload and also
+          indicates which member of the anonymous union, ``itv0`` or
+          ``ITV0``, to use for the payload data.
+
+    -  .. row 2
+
+       -  union
+
+       -  (anonymous)
+
+    -  .. row 3
+
+       -  
+       -  struct :ref:`v4l2_mpeg_vbi_itv0 <v4l2-mpeg-vbi-itv0>`
+
+       -  ``itv0``
+
+       -  The primary form of the sliced VBI data payload that contains
+          anywhere from 1 to 35 lines of sliced VBI data. Line masks are
+          provided in this form of the payload indicating which VBI lines
+          are provided.
+
+    -  .. row 4
+
+       -  
+       -  struct :ref:`v4l2_mpeg_vbi_ITV0 <v4l2-mpeg-vbi-itv0-1>`
+
+       -  ``ITV0``
+
+       -  An alternate form of the sliced VBI data payload used when 36
+          lines of sliced VBI data are present. No line masks are provided
+          in this form of the payload; all valid line mask bits are
+          implcitly set.
+
+
+
+.. _v4l2-mpeg-vbi-fmt-ivtv-magic:
+
+.. flat-table:: Magic Constants for struct v4l2_mpeg_vbi_fmt_ivtv magic field
+    :header-rows:  1
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  Defined Symbol
+
+       -  Value
+
+       -  Description
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_VBI_IVTV_MAGIC0``
+
+       -  "itv0"
+
+       -  Indicates the ``itv0`` member of the union in struct
+          :ref:`v4l2_mpeg_vbi_fmt_ivtv <v4l2-mpeg-vbi-fmt-ivtv>` is
+          valid.
+
+    -  .. row 3
+
+       -  ``V4L2_MPEG_VBI_IVTV_MAGIC1``
+
+       -  "ITV0"
+
+       -  Indicates the ``ITV0`` member of the union in struct
+          :ref:`v4l2_mpeg_vbi_fmt_ivtv <v4l2-mpeg-vbi-fmt-ivtv>` is
+          valid and that 36 lines of sliced VBI data are present.
+
+
+
+.. _v4l2-mpeg-vbi-itv0:
+
+.. flat-table:: struct v4l2_mpeg_vbi_itv0
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __le32
+
+       -  ``linemask``\ [2]
+
+       -  Bitmasks indicating the VBI service lines present. These
+          ``linemask`` values are stored in little endian byte order in the
+          MPEG stream. Some reference ``linemask`` bit positions with their
+          corresponding VBI line number and video field are given below.
+          b\ :sub:`0` indicates the least significant bit of a ``linemask``
+          value:
+
+
+
+          ::
+
+              linemask[0] b0:     line  6     first field
+              linemask[0] b17:        line 23     first field
+              linemask[0] b18:        line  6     second field
+              linemask[0] b31:        line 19     second field
+              linemask[1] b0:     line 20     second field
+              linemask[1] b3:     line 23     second field
+              linemask[1] b4-b31: unused and set to 0
+
+    -  .. row 2
+
+       -  struct
+          :ref:`v4l2_mpeg_vbi_itv0_line <v4l2-mpeg-vbi-itv0-line>`
+
+       -  ``line``\ [35]
+
+       -  This is a variable length array that holds from 1 to 35 lines of
+          sliced VBI data. The sliced VBI data lines present correspond to
+          the bits set in the ``linemask`` array, starting from b\ :sub:`0`
+          of ``linemask``\ [0] up through b\ :sub:`31` of ``linemask``\ [0],
+          and from b\ :sub:`0` of ``linemask``\ [1] up through b :sub:`3` of
+          ``linemask``\ [1]. ``line``\ [0] corresponds to the first bit
+          found set in the ``linemask`` array, ``line``\ [1] corresponds to
+          the second bit found set in the ``linemask`` array, etc. If no
+          ``linemask`` array bits are set, then ``line``\ [0] may contain
+          one line of unspecified data that should be ignored by
+          applications.
+
+
+
+.. _v4l2-mpeg-vbi-itv0-1:
+
+.. flat-table:: struct v4l2_mpeg_vbi_ITV0
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  struct
+          :ref:`v4l2_mpeg_vbi_itv0_line <v4l2-mpeg-vbi-itv0-line>`
+
+       -  ``line``\ [36]
+
+       -  A fixed length array of 36 lines of sliced VBI data. ``line``\ [0]
+          through ``line``\ [17] correspond to lines 6 through 23 of the
+          first field. ``line``\ [18] through ``line``\ [35] corresponds to
+          lines 6 through 23 of the second field.
+
+
+
+.. _v4l2-mpeg-vbi-itv0-line:
+
+.. flat-table:: struct v4l2_mpeg_vbi_itv0_line
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u8
+
+       -  ``id``
+
+       -  A line identifier value from
+          :ref:`ITV0-Line-Identifier-Constants` that indicates the type of
+          sliced VBI data stored on this line.
+
+    -  .. row 2
+
+       -  __u8
+
+       -  ``data``\ [42]
+
+       -  The sliced VBI data for the line.
+
+
+
+.. _ITV0-Line-Identifier-Constants:
+
+.. flat-table:: Line Identifiers for struct v4l2_mpeg_vbi_itv0_line id field
+    :header-rows:  1
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  Defined Symbol
+
+       -  Value
+
+       -  Description
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_VBI_IVTV_TELETEXT_B``
+
+       -  1
+
+       -  Refer to :ref:`Sliced VBI services <vbi-services2>` for a
+          description of the line payload.
+
+    -  .. row 3
+
+       -  ``V4L2_MPEG_VBI_IVTV_CAPTION_525``
+
+       -  4
+
+       -  Refer to :ref:`Sliced VBI services <vbi-services2>` for a
+          description of the line payload.
+
+    -  .. row 4
+
+       -  ``V4L2_MPEG_VBI_IVTV_WSS_625``
+
+       -  5
+
+       -  Refer to :ref:`Sliced VBI services <vbi-services2>` for a
+          description of the line payload.
+
+    -  .. row 5
+
+       -  ``V4L2_MPEG_VBI_IVTV_VPS``
+
+       -  7
+
+       -  Refer to :ref:`Sliced VBI services <vbi-services2>` for a
+          description of the line payload.
+
+
+
+.. [1]
+   According to :ref:`ETS 300 706 <ets300706>` lines 6-22 of the first
+   field and lines 5-22 of the second field may carry Teletext data.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/dev-subdev.rst b/Documentation/linux_tv/media/v4l/dev-subdev.rst
new file mode 100644
index 000000000000..66274eafd437
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/dev-subdev.rst
@@ -0,0 +1,502 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _subdev:
+
+********************
+Sub-device Interface
+********************
+
+The complex nature of V4L2 devices, where hardware is often made of
+several integrated circuits that need to interact with each other in a
+controlled way, leads to complex V4L2 drivers. The drivers usually
+reflect the hardware model in software, and model the different hardware
+components as software blocks called sub-devices.
+
+V4L2 sub-devices are usually kernel-only objects. If the V4L2 driver
+implements the media device API, they will automatically inherit from
+media entities. Applications will be able to enumerate the sub-devices
+and discover the hardware topology using the media entities, pads and
+links enumeration API.
+
+In addition to make sub-devices discoverable, drivers can also choose to
+make them directly configurable by applications. When both the
+sub-device driver and the V4L2 device driver support this, sub-devices
+will feature a character device node on which ioctls can be called to
+
+-  query, read and write sub-devices controls
+
+-  subscribe and unsubscribe to events and retrieve them
+
+-  negotiate image formats on individual pads
+
+Sub-device character device nodes, conventionally named
+``/dev/v4l-subdev*``, use major number 81.
+
+
+Controls
+========
+
+Most V4L2 controls are implemented by sub-device hardware. Drivers
+usually merge all controls and expose them through video device nodes.
+Applications can control all sub-devices through a single interface.
+
+Complex devices sometimes implement the same control in different pieces
+of hardware. This situation is common in embedded platforms, where both
+sensors and image processing hardware implement identical functions,
+such as contrast adjustment, white balance or faulty pixels correction.
+As the V4L2 controls API doesn't support several identical controls in a
+single device, all but one of the identical controls are hidden.
+
+Applications can access those hidden controls through the sub-device
+node with the V4L2 control API described in :ref:`control`. The ioctls
+behave identically as when issued on V4L2 device nodes, with the
+exception that they deal only with controls implemented in the
+sub-device.
+
+Depending on the driver, those controls might also be exposed through
+one (or several) V4L2 device nodes.
+
+
+Events
+======
+
+V4L2 sub-devices can notify applications of events as described in
+:ref:`event`. The API behaves identically as when used on V4L2 device
+nodes, with the exception that it only deals with events generated by
+the sub-device. Depending on the driver, those events might also be
+reported on one (or several) V4L2 device nodes.
+
+
+.. _pad-level-formats:
+
+Pad-level Formats
+=================
+
+    **Warning**
+
+    Pad-level formats are only applicable to very complex device that
+    need to expose low-level format configuration to user space. Generic
+    V4L2 applications do *not* need to use the API described in this
+    section.
+
+    **Note**
+
+    For the purpose of this section, the term *format* means the
+    combination of media bus data format, frame width and frame height.
+
+Image formats are typically negotiated on video capture and output
+devices using the format and
+:ref:`selection <vidioc-subdev-g-selection>` ioctls. The driver is
+responsible for configuring every block in the video pipeline according
+to the requested format at the pipeline input and/or output.
+
+For complex devices, such as often found in embedded systems, identical
+image sizes at the output of a pipeline can be achieved using different
+hardware configurations. One such example is shown on
+:ref:`pipeline-scaling`, where image scaling can be performed on both
+the video sensor and the host image processing hardware.
+
+
+.. _pipeline-scaling:
+
+.. figure::  dev-subdev_files/pipeline.*
+    :alt:    pipeline.pdf / pipeline.png
+    :align:  center
+
+    Image Format Negotiation on Pipelines
+
+    High quality and high speed pipeline configuration
+
+
+
+The sensor scaler is usually of less quality than the host scaler, but
+scaling on the sensor is required to achieve higher frame rates.
+Depending on the use case (quality vs. speed), the pipeline must be
+configured differently. Applications need to configure the formats at
+every point in the pipeline explicitly.
+
+Drivers that implement the :ref:`media API <media-controller-intro>`
+can expose pad-level image format configuration to applications. When
+they do, applications can use the
+:ref:`VIDIOC_SUBDEV_G_FMT <vidioc-subdev-g-fmt>` and
+:ref:`VIDIOC_SUBDEV_S_FMT <vidioc-subdev-g-fmt>` ioctls. to
+negotiate formats on a per-pad basis.
+
+Applications are responsible for configuring coherent parameters on the
+whole pipeline and making sure that connected pads have compatible
+formats. The pipeline is checked for formats mismatch at
+:ref:`VIDIOC_STREAMON <vidioc-streamon>` time, and an EPIPE error
+code is then returned if the configuration is invalid.
+
+Pad-level image format configuration support can be tested by calling
+the :ref:`VIDIOC_SUBDEV_G_FMT <vidioc-subdev-g-fmt>` ioctl on pad
+0. If the driver returns an EINVAL error code pad-level format
+configuration is not supported by the sub-device.
+
+
+Format Negotiation
+------------------
+
+Acceptable formats on pads can (and usually do) depend on a number of
+external parameters, such as formats on other pads, active links, or
+even controls. Finding a combination of formats on all pads in a video
+pipeline, acceptable to both application and driver, can't rely on
+formats enumeration only. A format negotiation mechanism is required.
+
+Central to the format negotiation mechanism are the get/set format
+operations. When called with the ``which`` argument set to
+``V4L2_SUBDEV_FORMAT_TRY``, the
+:ref:`VIDIOC_SUBDEV_G_FMT <vidioc-subdev-g-fmt>` and
+:ref:`VIDIOC_SUBDEV_S_FMT <vidioc-subdev-g-fmt>` ioctls operate on
+a set of formats parameters that are not connected to the hardware
+configuration. Modifying those 'try' formats leaves the device state
+untouched (this applies to both the software state stored in the driver
+and the hardware state stored in the device itself).
+
+While not kept as part of the device state, try formats are stored in
+the sub-device file handles. A
+:ref:`VIDIOC_SUBDEV_G_FMT <vidioc-subdev-g-fmt>` call will return
+the last try format set *on the same sub-device file handle*. Several
+applications querying the same sub-device at the same time will thus not
+interact with each other.
+
+To find out whether a particular format is supported by the device,
+applications use the
+:ref:`VIDIOC_SUBDEV_S_FMT <vidioc-subdev-g-fmt>` ioctl. Drivers
+verify and, if needed, change the requested ``format`` based on device
+requirements and return the possibly modified value. Applications can
+then choose to try a different format or accept the returned value and
+continue.
+
+Formats returned by the driver during a negotiation iteration are
+guaranteed to be supported by the device. In particular, drivers
+guarantee that a returned format will not be further changed if passed
+to an :ref:`VIDIOC_SUBDEV_S_FMT <vidioc-subdev-g-fmt>` call as-is
+(as long as external parameters, such as formats on other pads or links'
+configuration are not changed).
+
+Drivers automatically propagate formats inside sub-devices. When a try
+or active format is set on a pad, corresponding formats on other pads of
+the same sub-device can be modified by the driver. Drivers are free to
+modify formats as required by the device. However, they should comply
+with the following rules when possible:
+
+-  Formats should be propagated from sink pads to source pads. Modifying
+   a format on a source pad should not modify the format on any sink
+   pad.
+
+-  Sub-devices that scale frames using variable scaling factors should
+   reset the scale factors to default values when sink pads formats are
+   modified. If the 1:1 scaling ratio is supported, this means that
+   source pads formats should be reset to the sink pads formats.
+
+Formats are not propagated across links, as that would involve
+propagating them from one sub-device file handle to another.
+Applications must then take care to configure both ends of every link
+explicitly with compatible formats. Identical formats on the two ends of
+a link are guaranteed to be compatible. Drivers are free to accept
+different formats matching device requirements as being compatible.
+
+:ref:`sample-pipeline-config` shows a sample configuration sequence
+for the pipeline described in :ref:`pipeline-scaling` (table columns
+list entity names and pad numbers).
+
+
+.. _sample-pipeline-config:
+
+.. flat-table:: Sample Pipeline Configuration
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  
+       -  Sensor/0 format
+
+       -  Frontend/0 format
+
+       -  Frontend/1 format
+
+       -  Scaler/0 format
+
+       -  Scaler/0 compose selection rectangle
+
+       -  Scaler/1 format
+
+    -  .. row 2
+
+       -  Initial state
+
+       -  2048x1536/SGRBG8_1X8
+
+       -  (default)
+
+       -  (default)
+
+       -  (default)
+
+       -  (default)
+
+       -  (default)
+
+    -  .. row 3
+
+       -  Configure frontend sink format
+
+       -  2048x1536/SGRBG8_1X8
+
+       -  *2048x1536/SGRBG8_1X8*
+
+       -  *2046x1534/SGRBG8_1X8*
+
+       -  (default)
+
+       -  (default)
+
+       -  (default)
+
+    -  .. row 4
+
+       -  Configure scaler sink format
+
+       -  2048x1536/SGRBG8_1X8
+
+       -  2048x1536/SGRBG8_1X8
+
+       -  2046x1534/SGRBG8_1X8
+
+       -  *2046x1534/SGRBG8_1X8*
+
+       -  *0,0/2046x1534*
+
+       -  *2046x1534/SGRBG8_1X8*
+
+    -  .. row 5
+
+       -  Configure scaler sink compose selection
+
+       -  2048x1536/SGRBG8_1X8
+
+       -  2048x1536/SGRBG8_1X8
+
+       -  2046x1534/SGRBG8_1X8
+
+       -  2046x1534/SGRBG8_1X8
+
+       -  *0,0/1280x960*
+
+       -  *1280x960/SGRBG8_1X8*
+
+
+
+1. Initial state. The sensor source pad format is set to its native 3MP
+   size and V4L2_MBUS_FMT_SGRBG8_1X8 media bus code. Formats on the
+   host frontend and scaler sink and source pads have the default
+   values, as well as the compose rectangle on the scaler's sink pad.
+
+2. The application configures the frontend sink pad format's size to
+   2048x1536 and its media bus code to V4L2_MBUS_FMT_SGRBG_1X8. The
+   driver propagates the format to the frontend source pad.
+
+3. The application configures the scaler sink pad format's size to
+   2046x1534 and the media bus code to V4L2_MBUS_FMT_SGRBG_1X8 to
+   match the frontend source size and media bus code. The media bus code
+   on the sink pad is set to V4L2_MBUS_FMT_SGRBG_1X8. The driver
+   propagates the size to the compose selection rectangle on the
+   scaler's sink pad, and the format to the scaler source pad.
+
+4. The application configures the size of the compose selection
+   rectangle of the scaler's sink pad 1280x960. The driver propagates
+   the size to the scaler's source pad format.
+
+When satisfied with the try results, applications can set the active
+formats by setting the ``which`` argument to
+``V4L2_SUBDEV_FORMAT_ACTIVE``. Active formats are changed exactly as try
+formats by drivers. To avoid modifying the hardware state during format
+negotiation, applications should negotiate try formats first and then
+modify the active settings using the try formats returned during the
+last negotiation iteration. This guarantees that the active format will
+be applied as-is by the driver without being modified.
+
+
+.. _v4l2-subdev-selections:
+
+Selections: cropping, scaling and composition
+---------------------------------------------
+
+Many sub-devices support cropping frames on their input or output pads
+(or possible even on both). Cropping is used to select the area of
+interest in an image, typically on an image sensor or a video decoder.
+It can also be used as part of digital zoom implementations to select
+the area of the image that will be scaled up.
+
+Crop settings are defined by a crop rectangle and represented in a
+struct :ref:`v4l2_rect <v4l2-rect>` by the coordinates of the top
+left corner and the rectangle size. Both the coordinates and sizes are
+expressed in pixels.
+
+As for pad formats, drivers store try and active rectangles for the
+selection targets :ref:`v4l2-selections-common`.
+
+On sink pads, cropping is applied relative to the current pad format.
+The pad format represents the image size as received by the sub-device
+from the previous block in the pipeline, and the crop rectangle
+represents the sub-image that will be transmitted further inside the
+sub-device for processing.
+
+The scaling operation changes the size of the image by scaling it to new
+dimensions. The scaling ratio isn't specified explicitly, but is implied
+from the original and scaled image sizes. Both sizes are represented by
+struct :ref:`v4l2_rect <v4l2-rect>`.
+
+Scaling support is optional. When supported by a subdev, the crop
+rectangle on the subdev's sink pad is scaled to the size configured
+using the
+:ref:`VIDIOC_SUBDEV_S_SELECTION <vidioc-subdev-g-selection>` IOCTL
+using ``V4L2_SEL_TGT_COMPOSE`` selection target on the same pad. If the
+subdev supports scaling but not composing, the top and left values are
+not used and must always be set to zero.
+
+On source pads, cropping is similar to sink pads, with the exception
+that the source size from which the cropping is performed, is the
+COMPOSE rectangle on the sink pad. In both sink and source pads, the
+crop rectangle must be entirely contained inside the source image size
+for the crop operation.
+
+The drivers should always use the closest possible rectangle the user
+requests on all selection targets, unless specifically told otherwise.
+``V4L2_SEL_FLAG_GE`` and ``V4L2_SEL_FLAG_LE`` flags may be used to round
+the image size either up or down. :ref:`v4l2-selection-flags`
+
+
+Types of selection targets
+--------------------------
+
+
+Actual targets
+^^^^^^^^^^^^^^
+
+Actual targets (without a postfix) reflect the actual hardware
+configuration at any point of time. There is a BOUNDS target
+corresponding to every actual target.
+
+
+BOUNDS targets
+^^^^^^^^^^^^^^
+
+BOUNDS targets is the smallest rectangle that contains all valid actual
+rectangles. It may not be possible to set the actual rectangle as large
+as the BOUNDS rectangle, however. This may be because e.g. a sensor's
+pixel array is not rectangular but cross-shaped or round. The maximum
+size may also be smaller than the BOUNDS rectangle.
+
+
+Order of configuration and format propagation
+---------------------------------------------
+
+Inside subdevs, the order of image processing steps will always be from
+the sink pad towards the source pad. This is also reflected in the order
+in which the configuration must be performed by the user: the changes
+made will be propagated to any subsequent stages. If this behaviour is
+not desired, the user must set ``V4L2_SEL_FLAG_KEEP_CONFIG`` flag. This
+flag causes no propagation of the changes are allowed in any
+circumstances. This may also cause the accessed rectangle to be adjusted
+by the driver, depending on the properties of the underlying hardware.
+
+The coordinates to a step always refer to the actual size of the
+previous step. The exception to this rule is the source compose
+rectangle, which refers to the sink compose bounds rectangle --- if it
+is supported by the hardware.
+
+1. Sink pad format. The user configures the sink pad format. This format
+   defines the parameters of the image the entity receives through the
+   pad for further processing.
+
+2. Sink pad actual crop selection. The sink pad crop defines the crop
+   performed to the sink pad format.
+
+3. Sink pad actual compose selection. The size of the sink pad compose
+   rectangle defines the scaling ratio compared to the size of the sink
+   pad crop rectangle. The location of the compose rectangle specifies
+   the location of the actual sink compose rectangle in the sink compose
+   bounds rectangle.
+
+4. Source pad actual crop selection. Crop on the source pad defines crop
+   performed to the image in the sink compose bounds rectangle.
+
+5. Source pad format. The source pad format defines the output pixel
+   format of the subdev, as well as the other parameters with the
+   exception of the image width and height. Width and height are defined
+   by the size of the source pad actual crop selection.
+
+Accessing any of the above rectangles not supported by the subdev will
+return ``EINVAL``. Any rectangle referring to a previous unsupported
+rectangle coordinates will instead refer to the previous supported
+rectangle. For example, if sink crop is not supported, the compose
+selection will refer to the sink pad format dimensions instead.
+
+
+.. _subdev-image-processing-crop:
+
+.. figure::  dev-subdev_files/subdev-image-processing-crop.*
+    :alt:    subdev-image-processing-crop.svg
+    :align:  center
+
+    Image processing in subdevs: simple crop example
+
+In the above example, the subdev supports cropping on its sink pad. To
+configure it, the user sets the media bus format on the subdev's sink
+pad. Now the actual crop rectangle can be set on the sink pad --- the
+location and size of this rectangle reflect the location and size of a
+rectangle to be cropped from the sink format. The size of the sink crop
+rectangle will also be the size of the format of the subdev's source
+pad.
+
+
+.. _subdev-image-processing-scaling-multi-source:
+
+.. figure::  dev-subdev_files/subdev-image-processing-scaling-multi-source.*
+    :alt:    subdev-image-processing-scaling-multi-source.svg
+    :align:  center
+
+    Image processing in subdevs: scaling with multiple sources
+
+In this example, the subdev is capable of first cropping, then scaling
+and finally cropping for two source pads individually from the resulting
+scaled image. The location of the scaled image in the cropped image is
+ignored in sink compose target. Both of the locations of the source crop
+rectangles refer to the sink scaling rectangle, independently cropping
+an area at location specified by the source crop rectangle from it.
+
+
+.. _subdev-image-processing-full:
+
+.. figure::  dev-subdev_files/subdev-image-processing-full.*
+    :alt:    subdev-image-processing-full.svg
+    :align:  center
+
+    Image processing in subdevs: scaling and composition with multiple sinks and sources
+
+The subdev driver supports two sink pads and two source pads. The images
+from both of the sink pads are individually cropped, then scaled and
+further composed on the composition bounds rectangle. From that, two
+independent streams are cropped and sent out of the subdev from the
+source pads.
+
+
+.. toctree::
+    :maxdepth: 1
+
+    subdev-formats
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/dev-subdev_files/pipeline.pdf b/Documentation/linux_tv/media/v4l/dev-subdev_files/pipeline.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..ee3e37f04b6a788e255ce26d1607e77ba2c119a3
GIT binary patch
literal 20276
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
V%8y_8ZbSy1$UvHzIeI!F{{we5{PX|-

literal 0
HcmV?d00001

diff --git a/Documentation/linux_tv/media/v4l/dev-subdev_files/pipeline.png b/Documentation/linux_tv/media/v4l/dev-subdev_files/pipeline.png
new file mode 100644
index 0000000000000000000000000000000000000000..f19b86c2c24d07d5ae437820944d25489a447d7a
GIT binary patch
literal 12130
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
B;b8y(

literal 0
HcmV?d00001

diff --git a/Documentation/linux_tv/media/v4l/dev-subdev_files/subdev-image-processing-crop.pdf b/Documentation/linux_tv/media/v4l/dev-subdev_files/subdev-image-processing-crop.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..29a806f839b4a59511d25d48ff4619a0ed01d7ad
GIT binary patch
literal 20729
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

literal 0
HcmV?d00001

diff --git a/Documentation/linux_tv/media/v4l/dev-subdev_files/subdev-image-processing-crop.svg b/Documentation/linux_tv/media/v4l/dev-subdev_files/subdev-image-processing-crop.svg
new file mode 100644
index 000000000000..18b0f5de9ed2
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/dev-subdev_files/subdev-image-processing-crop.svg
@@ -0,0 +1,63 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.0//EN" "http://www.w3.org/TR/2001/PR-SVG-20010719/DTD/svg10.dtd">
+<svg width="43cm" height="10cm" viewBox="-194 128 844 196" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+  <rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" x="-8" y="130" width="469.774" height="193"/>
+  <g>
+    <rect style="fill: #ffffff" x="4.5" y="189" width="159" height="104"/>
+    <rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #a52a2a" x="4.5" y="189" width="159" height="104"/>
+  </g>
+  <g>
+    <rect style="fill: #ffffff" x="63.5" y="211" width="94" height="77"/>
+    <rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #0000ff" x="63.5" y="211" width="94" height="77"/>
+  </g>
+  <text style="fill: #0000ff;text-anchor:start;font-size:12.8;font-family:sanserif;font-style:normal;font-weight:normal" x="74.5" y="227.75">
+    <tspan x="74.5" y="227.75">sink</tspan>
+    <tspan x="74.5" y="243.75">crop</tspan>
+    <tspan x="74.5" y="259.75">selection</tspan>
+  </text>
+  <text style="fill: #000000;text-anchor:start;font-size:12.8;font-family:sanserif;font-style:normal;font-weight:normal" x="29.5" y="158">
+    <tspan x="29.5" y="158"></tspan>
+  </text>
+  <text style="fill: #a52a2a;text-anchor:start;font-size:12.8;font-family:sanserif;font-style:normal;font-weight:normal" x="8.53836" y="157.914">
+    <tspan x="8.53836" y="157.914">sink media</tspan>
+    <tspan x="8.53836" y="173.914">bus format</tspan>
+  </text>
+  <text style="fill: #8b6914;text-anchor:start;font-size:12.8;font-family:sanserif;font-style:normal;font-weight:normal" x="349.774" y="155">
+    <tspan x="349.774" y="155">source media</tspan>
+    <tspan x="349.774" y="171">bus format</tspan>
+  </text>
+  <g>
+    <rect style="fill: #ffffff" x="350.488" y="190.834" width="93.2863" height="75.166"/>
+    <rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #8b6914" x="350.488" y="190.834" width="93.2863" height="75.166"/>
+  </g>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="350.488" y1="266" x2="63.5" y2="288"/>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="350.488" y1="190.834" x2="63.5" y2="211"/>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="443.774" y1="266" x2="157.5" y2="288"/>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="443.774" y1="190.834" x2="157.5" y2="211"/>
+  <g>
+    <ellipse style="fill: #ffffff" cx="473.1" cy="219.984" rx="8.5" ry="8.5"/>
+    <ellipse style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" cx="473.1" cy="219.984" rx="8.5" ry="8.5"/>
+    <ellipse style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" cx="473.1" cy="219.984" rx="8.5" ry="8.5"/>
+  </g>
+  <g>
+    <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" x1="481.6" y1="219.984" x2="637.934" y2="220.012"/>
+    <polygon style="fill: #000000" points="645.434,220.014 635.433,225.012 637.934,220.012 635.435,215.012 "/>
+    <polygon style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="645.434,220.014 635.433,225.012 637.934,220.012 635.435,215.012 "/>
+  </g>
+  <text style="fill: #000000;text-anchor:start;font-size:12.8;font-family:sanserif;font-style:normal;font-weight:normal" x="506.908" y="209.8">
+    <tspan x="506.908" y="209.8">pad 1 (source)</tspan>
+  </text>
+  <g>
+    <ellipse style="fill: #ffffff" cx="-20.3982" cy="241.512" rx="8.5" ry="8.5"/>
+    <ellipse style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" cx="-20.3982" cy="241.512" rx="8.5" ry="8.5"/>
+    <ellipse style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" cx="-20.3982" cy="241.512" rx="8.5" ry="8.5"/>
+  </g>
+  <g>
+    <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" x1="-192.398" y1="241.8" x2="-38.6343" y2="241.529"/>
+    <polygon style="fill: #000000" points="-31.1343,241.516 -41.1254,246.534 -38.6343,241.529 -41.1431,236.534 "/>
+    <polygon style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="-31.1343,241.516 -41.1254,246.534 -38.6343,241.529 -41.1431,236.534 "/>
+  </g>
+  <text style="fill: #000000;text-anchor:start;font-size:12.8;font-family:sanserif;font-style:normal;font-weight:normal" x="-147.858" y="229.8">
+    <tspan x="-147.858" y="229.8">pad 0 (sink)</tspan>
+  </text>
+</svg>
diff --git a/Documentation/linux_tv/media/v4l/dev-subdev_files/subdev-image-processing-full.pdf b/Documentation/linux_tv/media/v4l/dev-subdev_files/subdev-image-processing-full.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..b78a8e8f6b35bbd5c0b5e018c28b27f157626f17
GIT binary patch
literal 46311
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

literal 0
HcmV?d00001

diff --git a/Documentation/linux_tv/media/v4l/dev-subdev_files/subdev-image-processing-full.svg b/Documentation/linux_tv/media/v4l/dev-subdev_files/subdev-image-processing-full.svg
new file mode 100644
index 000000000000..3322cf4c0093
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/dev-subdev_files/subdev-image-processing-full.svg
@@ -0,0 +1,163 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.0//EN" "http://www.w3.org/TR/2001/PR-SVG-20010719/DTD/svg10.dtd">
+<svg width="59cm" height="18cm" viewBox="-186 71 1178 346" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+  <g>
+    <rect style="fill: #ffffff" x="318.9" y="129" width="208.1" height="249"/>
+    <rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #ff765a" x="318.9" y="129" width="208.1" height="249"/>
+  </g>
+  <rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" x="-2" y="73" width="806" height="343"/>
+  <g>
+    <ellipse style="fill: #ffffff" cx="-12.5" cy="166.712" rx="8.5" ry="8.5"/>
+    <ellipse style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" cx="-12.5" cy="166.712" rx="8.5" ry="8.5"/>
+    <ellipse style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" cx="-12.5" cy="166.712" rx="8.5" ry="8.5"/>
+  </g>
+  <g>
+    <ellipse style="fill: #ffffff" cx="815.232" cy="205.184" rx="8.5" ry="8.5"/>
+    <ellipse style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" cx="815.232" cy="205.184" rx="8.5" ry="8.5"/>
+    <ellipse style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" cx="815.232" cy="205.184" rx="8.5" ry="8.5"/>
+  </g>
+  <g>
+    <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" x1="-184.5" y1="167" x2="-30.7361" y2="166.729"/>
+    <polygon style="fill: #000000" points="-23.2361,166.716 -33.2272,171.734 -30.7361,166.729 -33.2449,161.734 "/>
+    <polygon style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="-23.2361,166.716 -33.2272,171.734 -30.7361,166.729 -33.2449,161.734 "/>
+  </g>
+  <g>
+    <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" x1="823.732" y1="205.184" x2="980.066" y2="205.212"/>
+    <polygon style="fill: #000000" points="987.566,205.214 977.565,210.212 980.066,205.212 977.567,200.212 "/>
+    <polygon style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="987.566,205.214 977.565,210.212 980.066,205.212 977.567,200.212 "/>
+  </g>
+  <text style="fill: #000000;text-anchor:start;font-size:12.8;font-family:sanserif;font-style:normal;font-weight:normal" x="-139.96" y="155">
+    <tspan x="-139.96" y="155">pad 0 (sink)</tspan>
+  </text>
+  <text style="fill: #000000;text-anchor:start;font-size:12.8;font-family:sanserif;font-style:normal;font-weight:normal" x="849.04" y="195">
+    <tspan x="849.04" y="195">pad 2 (source)</tspan>
+  </text>
+  <g>
+    <rect style="fill: #ffffff" x="5.5" y="120" width="159" height="104"/>
+    <rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #a52a2a" x="5.5" y="120" width="159" height="104"/>
+  </g>
+  <g>
+    <rect style="fill: #ffffff" x="62.5" y="136" width="94" height="77"/>
+    <rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #0000ff" x="62.5" y="136" width="94" height="77"/>
+  </g>
+  <text style="fill: #000000;text-anchor:start;font-size:12.8;font-family:sanserif;font-style:normal;font-weight:normal" x="30.5" y="89">
+    <tspan x="30.5" y="89"></tspan>
+  </text>
+  <text style="fill: #a52a2a;text-anchor:start;font-size:12.8;font-family:sanserif;font-style:normal;font-weight:normal" x="9.53836" y="88.9138">
+    <tspan x="9.53836" y="88.9138">sink media</tspan>
+    <tspan x="9.53836" y="104.914">bus format</tspan>
+  </text>
+  <g>
+    <rect style="fill: #ffffff" x="333.644" y="185.65" width="165.2" height="172.478"/>
+    <rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #00ff00" x="333.644" y="185.65" width="165.2" height="172.478"/>
+  </g>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="333.644" y1="358.128" x2="62.5" y2="213"/>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="333.644" y1="185.65" x2="62.5" y2="136"/>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="498.844" y1="358.128" x2="156.5" y2="213"/>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="498.844" y1="185.65" x2="156.5" y2="136"/>
+  <text style="fill: #00ff00;text-anchor:start;font-size:12.8;font-family:sanserif;font-style:normal;font-weight:normal" x="334.704" y="149.442">
+    <tspan x="334.704" y="149.442">sink compose</tspan>
+    <tspan x="334.704" y="165.442">selection (scaling)</tspan>
+  </text>
+  <g>
+    <rect style="fill: #ffffff" x="409.322" y="194.565" width="100.186" height="71.4523"/>
+    <rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #a020f0" x="409.322" y="194.565" width="100.186" height="71.4523"/>
+  </g>
+  <text style="fill: #8b6914;text-anchor:start;font-size:12.8;font-family:sanserif;font-style:normal;font-weight:normal" x="689.5" y="105.128">
+    <tspan x="689.5" y="105.128">source media</tspan>
+    <tspan x="689.5" y="121.128">bus format</tspan>
+  </text>
+  <g>
+    <rect style="fill: #ffffff" x="688.488" y="173.834" width="100.186" height="71.4523"/>
+    <rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #8b6914" x="688.488" y="173.834" width="100.186" height="71.4523"/>
+  </g>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="688.488" y1="245.286" x2="409.322" y2="266.018"/>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="688.488" y1="173.834" x2="409.322" y2="194.565"/>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="788.674" y1="245.286" x2="509.508" y2="266.018"/>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="788.674" y1="173.834" x2="509.508" y2="194.565"/>
+  <text style="fill: #ff765a;text-anchor:start;font-size:12.8;font-family:sanserif;font-style:normal;font-weight:normal" x="325" y="103">
+    <tspan x="325" y="103">sink compose</tspan>
+    <tspan x="325" y="119">bounds selection</tspan>
+  </text>
+  <g>
+    <ellipse style="fill: #ffffff" cx="-12.0982" cy="341.512" rx="8.5" ry="8.5"/>
+    <ellipse style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" cx="-12.0982" cy="341.512" rx="8.5" ry="8.5"/>
+    <ellipse style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" cx="-12.0982" cy="341.512" rx="8.5" ry="8.5"/>
+  </g>
+  <g>
+    <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" x1="-184.098" y1="341.8" x2="-30.3343" y2="341.529"/>
+    <polygon style="fill: #000000" points="-22.8343,341.516 -32.8254,346.534 -30.3343,341.529 -32.8431,336.534 "/>
+    <polygon style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="-22.8343,341.516 -32.8254,346.534 -30.3343,341.529 -32.8431,336.534 "/>
+  </g>
+  <text style="fill: #000000;text-anchor:start;font-size:12.8;font-family:sanserif;font-style:normal;font-weight:normal" x="-139" y="329">
+    <tspan x="-139" y="329">pad 1 (sink)</tspan>
+  </text>
+  <g>
+    <rect style="fill: #ffffff" x="7.80824" y="292.8" width="112.092" height="82.2"/>
+    <rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #a52a2a" x="7.80824" y="292.8" width="112.092" height="82.2"/>
+  </g>
+  <g>
+    <rect style="fill: #ffffff" x="52.9" y="314.8" width="58.1" height="50.2"/>
+    <rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #0000ff" x="52.9" y="314.8" width="58.1" height="50.2"/>
+  </g>
+  <text style="fill: #000000;text-anchor:start;font-size:12.8;font-family:sanserif;font-style:normal;font-weight:normal" x="31.9" y="259.8">
+    <tspan x="31.9" y="259.8"></tspan>
+  </text>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="358.9" y1="251.9" x2="52.9" y2="314.8"/>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="358.9" y1="316" x2="52.9" y2="365"/>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="434" y1="316" x2="111" y2="365"/>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="434" y1="251.9" x2="111" y2="314.8"/>
+  <rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #00ff00" x="358.9" y="251.9" width="75.1" height="64.1"/>
+  <rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #a020f0" x="443.262" y="284.466" width="64.738" height="48.534"/>
+  <g>
+    <rect style="fill: #ffffff" x="693.428" y="324.734" width="63.572" height="49.266"/>
+    <rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #8b6914" x="693.428" y="324.734" width="63.572" height="49.266"/>
+  </g>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="693.428" y1="374" x2="443.262" y2="333"/>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="693.428" y1="324.734" x2="443.262" y2="284.466"/>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="757" y1="374" x2="508" y2="333"/>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="757" y1="324.734" x2="508" y2="284.466"/>
+  <g>
+    <ellipse style="fill: #ffffff" cx="815.44" cy="343.984" rx="8.5" ry="8.5"/>
+    <ellipse style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" cx="815.44" cy="343.984" rx="8.5" ry="8.5"/>
+    <ellipse style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" cx="815.44" cy="343.984" rx="8.5" ry="8.5"/>
+  </g>
+  <g>
+    <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" x1="823.94" y1="343.984" x2="980.274" y2="344.012"/>
+    <polygon style="fill: #000000" points="987.774,344.014 977.773,349.012 980.274,344.012 977.775,339.012 "/>
+    <polygon style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="987.774,344.014 977.773,349.012 980.274,344.012 977.775,339.012 "/>
+  </g>
+  <text style="fill: #000000;text-anchor:start;font-size:12.8;font-family:sanserif;font-style:normal;font-weight:normal" x="849.248" y="333.8">
+    <tspan x="849.248" y="333.8">pad 3 (source)</tspan>
+  </text>
+  <text style="fill: #0000ff;text-anchor:start;font-size:12.8;font-family:sanserif;font-style:normal;font-weight:normal" x="197" y="91">
+    <tspan x="197" y="91">sink</tspan>
+    <tspan x="197" y="107">crop</tspan>
+    <tspan x="197" y="123">selection</tspan>
+  </text>
+  <text style="fill: #a020f0;text-anchor:start;font-size:12.8;font-family:sanserif;font-style:normal;font-weight:normal" x="553" y="95">
+    <tspan x="553" y="95">source</tspan>
+    <tspan x="553" y="111">crop</tspan>
+    <tspan x="553" y="127">selection</tspan>
+  </text>
+  <g>
+    <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #0000ff" x1="211" y1="132" x2="166.21" y2="135.287"/>
+    <polygon style="fill: #0000ff" points="158.73,135.836 168.337,130.118 166.21,135.287 169.069,140.091 "/>
+    <polygon style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #0000ff" points="158.73,135.836 168.337,130.118 166.21,135.287 169.069,140.091 "/>
+  </g>
+  <g>
+    <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #0000ff" x1="209" y1="131" x2="115.581" y2="306.209"/>
+    <polygon style="fill: #0000ff" points="112.052,312.827 112.345,301.65 115.581,306.209 121.169,306.355 "/>
+    <polygon style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #0000ff" points="112.052,312.827 112.345,301.65 115.581,306.209 121.169,306.355 "/>
+  </g>
+  <g>
+    <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #a020f0" x1="550.492" y1="133.214" x2="514.916" y2="186.469"/>
+    <polygon style="fill: #a020f0" points="510.75,192.706 512.147,181.613 514.916,186.469 520.463,187.168 "/>
+    <polygon style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #a020f0" points="510.75,192.706 512.147,181.613 514.916,186.469 520.463,187.168 "/>
+  </g>
+  <g>
+    <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #a020f0" x1="550.072" y1="133.787" x2="510.618" y2="275.089"/>
+    <polygon style="fill: #a020f0" points="508.601,282.312 506.475,271.336 510.618,275.089 516.106,274.025 "/>
+    <polygon style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #a020f0" points="508.601,282.312 506.475,271.336 510.618,275.089 516.106,274.025 "/>
+  </g>
+</svg>
diff --git a/Documentation/linux_tv/media/v4l/dev-subdev_files/subdev-image-processing-scaling-multi-source.pdf b/Documentation/linux_tv/media/v4l/dev-subdev_files/subdev-image-processing-scaling-multi-source.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..8f7a95b6eb4d8d883ec293254be19f41edb6b746
GIT binary patch
literal 36714
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
AiU0rr

literal 0
HcmV?d00001

diff --git a/Documentation/linux_tv/media/v4l/dev-subdev_files/subdev-image-processing-scaling-multi-source.svg b/Documentation/linux_tv/media/v4l/dev-subdev_files/subdev-image-processing-scaling-multi-source.svg
new file mode 100644
index 000000000000..2340c0f8bc92
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/dev-subdev_files/subdev-image-processing-scaling-multi-source.svg
@@ -0,0 +1,116 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.0//EN" "http://www.w3.org/TR/2001/PR-SVG-20010719/DTD/svg10.dtd">
+<svg width="59cm" height="17cm" viewBox="-194 128 1179 330" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+  <rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" x="-8" y="130" width="806" height="327"/>
+  <g>
+    <rect style="fill: #ffffff" x="4.5" y="189" width="159" height="104"/>
+    <rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #a52a2a" x="4.5" y="189" width="159" height="104"/>
+  </g>
+  <g>
+    <rect style="fill: #ffffff" x="49.5" y="204" width="94" height="77"/>
+    <rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #0000ff" x="49.5" y="204" width="94" height="77"/>
+  </g>
+  <text style="fill: #0000ff;text-anchor:start;font-size:12.8;font-family:sanserif;font-style:normal;font-weight:normal" x="60" y="224">
+    <tspan x="60" y="224">sink</tspan>
+    <tspan x="60" y="240">crop</tspan>
+    <tspan x="60" y="256">selection</tspan>
+  </text>
+  <text style="fill: #000000;text-anchor:start;font-size:12.8;font-family:sanserif;font-style:normal;font-weight:normal" x="29.5" y="158">
+    <tspan x="29.5" y="158"></tspan>
+  </text>
+  <text style="fill: #a52a2a;text-anchor:start;font-size:12.8;font-family:sanserif;font-style:normal;font-weight:normal" x="8.53836" y="157.914">
+    <tspan x="8.53836" y="157.914">sink media</tspan>
+    <tspan x="8.53836" y="173.914">bus format</tspan>
+  </text>
+  <g>
+    <rect style="fill: #ffffff" x="333.644" y="185.65" width="165.2" height="172.478"/>
+    <rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #00ff00" x="333.644" y="185.65" width="165.2" height="172.478"/>
+  </g>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="333.644" y1="358.128" x2="49.5" y2="281"/>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="333.644" y1="185.65" x2="49.5" y2="204"/>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="498.844" y1="358.128" x2="143.5" y2="281"/>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="498.844" y1="185.65" x2="143.5" y2="204"/>
+  <text style="fill: #00ff00;text-anchor:start;font-size:12.8;font-family:sanserif;font-style:normal;font-weight:normal" x="334.704" y="149.442">
+    <tspan x="334.704" y="149.442">sink compose</tspan>
+    <tspan x="334.704" y="165.442">selection (scaling)</tspan>
+  </text>
+  <g>
+    <rect style="fill: #ffffff" x="382.322" y="199.565" width="100.186" height="71.4523"/>
+    <rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #a020f0" x="382.322" y="199.565" width="100.186" height="71.4523"/>
+  </g>
+  <text style="fill: #a020f0;text-anchor:start;font-size:12.8;font-family:sanserif;font-style:normal;font-weight:normal" x="543.322" y="149.442">
+    <tspan x="543.322" y="149.442">source</tspan>
+    <tspan x="543.322" y="165.442">crop</tspan>
+    <tspan x="543.322" y="181.442">selection</tspan>
+  </text>
+  <text style="fill: #8b6914;text-anchor:start;font-size:12.8;font-family:sanserif;font-style:normal;font-weight:normal" x="691.5" y="157.128">
+    <tspan x="691.5" y="157.128">source media</tspan>
+    <tspan x="691.5" y="173.128">bus format</tspan>
+  </text>
+  <g>
+    <rect style="fill: #ffffff" x="690.488" y="225.834" width="100.186" height="71.4523"/>
+    <rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #8b6914" x="690.488" y="225.834" width="100.186" height="71.4523"/>
+  </g>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="690.488" y1="297.286" x2="382.322" y2="271.018"/>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="690.488" y1="225.834" x2="382.322" y2="199.565"/>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="790.674" y1="297.286" x2="482.508" y2="271.018"/>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="790.674" y1="225.834" x2="482.508" y2="199.565"/>
+  <g>
+    <ellipse style="fill: #ffffff" cx="808.1" cy="249.984" rx="8.5" ry="8.5"/>
+    <ellipse style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" cx="808.1" cy="249.984" rx="8.5" ry="8.5"/>
+    <ellipse style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" cx="808.1" cy="249.984" rx="8.5" ry="8.5"/>
+  </g>
+  <g>
+    <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" x1="816.6" y1="249.984" x2="972.934" y2="250.012"/>
+    <polygon style="fill: #000000" points="980.434,250.014 970.433,255.012 972.934,250.012 970.435,245.012 "/>
+    <polygon style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="980.434,250.014 970.433,255.012 972.934,250.012 970.435,245.012 "/>
+  </g>
+  <text style="fill: #000000;text-anchor:start;font-size:12.8;font-family:sanserif;font-style:normal;font-weight:normal" x="841.908" y="239.8">
+    <tspan x="841.908" y="239.8">pad 1 (source)</tspan>
+  </text>
+  <g>
+    <ellipse style="fill: #ffffff" cx="-20.3982" cy="241.512" rx="8.5" ry="8.5"/>
+    <ellipse style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" cx="-20.3982" cy="241.512" rx="8.5" ry="8.5"/>
+    <ellipse style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" cx="-20.3982" cy="241.512" rx="8.5" ry="8.5"/>
+  </g>
+  <g>
+    <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" x1="-192.398" y1="241.8" x2="-38.6343" y2="241.529"/>
+    <polygon style="fill: #000000" points="-31.1343,241.516 -41.1254,246.534 -38.6343,241.529 -41.1431,236.534 "/>
+    <polygon style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="-31.1343,241.516 -41.1254,246.534 -38.6343,241.529 -41.1431,236.534 "/>
+  </g>
+  <text style="fill: #000000;text-anchor:start;font-size:12.8;font-family:sanserif;font-style:normal;font-weight:normal" x="-147.858" y="229.8">
+    <tspan x="-147.858" y="229.8">pad 0 (sink)</tspan>
+  </text>
+  <rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #a020f0" x="389.822" y="276.666" width="100.186" height="71.4523"/>
+  <g>
+    <rect style="fill: #ffffff" x="689.988" y="345.934" width="100.186" height="71.4523"/>
+    <rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #8b6914" x="689.988" y="345.934" width="100.186" height="71.4523"/>
+  </g>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="689.988" y1="417.386" x2="389.822" y2="348.118"/>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="689.988" y1="345.934" x2="389.822" y2="276.666"/>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="790.174" y1="417.386" x2="490.008" y2="348.118"/>
+  <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #e60505" x1="790.174" y1="345.934" x2="490.008" y2="276.666"/>
+  <g>
+    <ellipse style="fill: #ffffff" cx="805.6" cy="384.084" rx="8.5" ry="8.5"/>
+    <ellipse style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" cx="805.6" cy="384.084" rx="8.5" ry="8.5"/>
+    <ellipse style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" cx="805.6" cy="384.084" rx="8.5" ry="8.5"/>
+  </g>
+  <g>
+    <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" x1="814.1" y1="384.084" x2="970.434" y2="384.112"/>
+    <polygon style="fill: #000000" points="977.934,384.114 967.933,389.112 970.434,384.112 967.935,379.112 "/>
+    <polygon style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="977.934,384.114 967.933,389.112 970.434,384.112 967.935,379.112 "/>
+  </g>
+  <text style="fill: #000000;text-anchor:start;font-size:12.8;font-family:sanserif;font-style:normal;font-weight:normal" x="839.408" y="373.9">
+    <tspan x="839.408" y="373.9">pad 2 (source)</tspan>
+  </text>
+  <g>
+    <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #a020f0" x1="546" y1="191" x2="492.157" y2="198.263"/>
+    <polygon style="fill: #a020f0" points="484.724,199.266 493.966,192.974 492.157,198.263 495.303,202.884 "/>
+    <polygon style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #a020f0" points="484.724,199.266 493.966,192.974 492.157,198.263 495.303,202.884 "/>
+  </g>
+  <g>
+    <line style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #a020f0" x1="546.908" y1="190.725" x2="495.383" y2="268.548"/>
+    <polygon style="fill: #a020f0" points="491.242,274.802 492.594,263.703 495.383,268.548 500.932,269.224 "/>
+    <polygon style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #a020f0" points="491.242,274.802 492.594,263.703 495.383,268.548 500.932,269.224 "/>
+  </g>
+</svg>
diff --git a/Documentation/linux_tv/media/v4l/dev-teletext.rst b/Documentation/linux_tv/media/v4l/dev-teletext.rst
new file mode 100644
index 000000000000..ed69e0fb6371
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/dev-teletext.rst
@@ -0,0 +1,43 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _ttx:
+
+******************
+Teletext Interface
+******************
+
+This interface was aimed at devices receiving and demodulating Teletext
+data [:ref:`ets300706`, :ref:`itu653`], evaluating the Teletext
+packages and storing formatted pages in cache memory. Such devices are
+usually implemented as microcontrollers with serial interface
+(I:sup:`2`\ C) and could be found on old TV cards, dedicated Teletext
+decoding cards and home-brew devices connected to the PC parallel port.
+
+The Teletext API was designed by Martin Buck. It was defined in the
+kernel header file ``linux/videotext.h``, the specification is available
+from
+`ftp://ftp.gwdg.de/pub/linux/misc/videotext/ <ftp://ftp.gwdg.de/pub/linux/misc/videotext/>`__.
+(Videotext is the name of the German public television Teletext
+service.)
+
+Eventually the Teletext API was integrated into the V4L API with
+character device file names ``/dev/vtx0`` to ``/dev/vtx31``, device
+major number 81, minor numbers 192 to 223.
+
+However, teletext decoders were quickly replaced by more generic VBI
+demodulators and those dedicated teletext decoders no longer exist. For
+many years the vtx devices were still around, even though nobody used
+them. So the decision was made to finally remove support for the
+Teletext API in kernel 2.6.37.
+
+Modern devices all use the :ref:`raw <raw-vbi>` or
+:ref:`sliced <sliced>` VBI API.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/devices.rst b/Documentation/linux_tv/media/v4l/devices.rst
new file mode 100644
index 000000000000..dee6d10e2900
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/devices.rst
@@ -0,0 +1,37 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _devices:
+
+**********
+Interfaces
+**********
+
+
+.. toctree::
+    :maxdepth: 1
+
+    dev-capture
+    dev-overlay
+    dev-output
+    dev-osd
+    dev-codec
+    dev-effect
+    dev-raw-vbi
+    dev-sliced-vbi
+    dev-teletext
+    dev-radio
+    dev-rds
+    dev-sdr
+    dev-event
+    dev-subdev
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/diff-v4l.rst b/Documentation/linux_tv/media/v4l/diff-v4l.rst
new file mode 100644
index 000000000000..eef51e610c8b
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/diff-v4l.rst
@@ -0,0 +1,963 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _diff-v4l:
+
+********************************
+Differences between V4L and V4L2
+********************************
+
+The Video For Linux API was first introduced in Linux 2.1 to unify and
+replace various TV and radio device related interfaces, developed
+independently by driver writers in prior years. Starting with Linux 2.5
+the much improved V4L2 API replaces the V4L API. The support for the old
+V4L calls were removed from Kernel, but the library :ref:`libv4l`
+supports the conversion of a V4L API system call into a V4L2 one.
+
+
+Opening and Closing Devices
+===========================
+
+For compatibility reasons the character device file names recommended
+for V4L2 video capture, overlay, radio and raw vbi capture devices did
+not change from those used by V4L. They are listed in :ref:`devices`
+and below in :ref:`v4l-dev`.
+
+The teletext devices (minor range 192-223) have been removed in V4L2 and
+no longer exist. There is no hardware available anymore for handling
+pure teletext. Instead raw or sliced VBI is used.
+
+The V4L ``videodev`` module automatically assigns minor numbers to
+drivers in load order, depending on the registered device type. We
+recommend that V4L2 drivers by default register devices with the same
+numbers, but the system administrator can assign arbitrary minor numbers
+using driver module options. The major device number remains 81.
+
+
+.. _v4l-dev:
+
+.. flat-table:: V4L Device Types, Names and Numbers
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  Device Type
+
+       -  File Name
+
+       -  Minor Numbers
+
+    -  .. row 2
+
+       -  Video capture and overlay
+
+       -  ``/dev/video`` and ``/dev/bttv0``\  [1]_, ``/dev/video0`` to
+          ``/dev/video63``
+
+       -  0-63
+
+    -  .. row 3
+
+       -  Radio receiver
+
+       -  ``/dev/radio``\  [2]_, ``/dev/radio0`` to ``/dev/radio63``
+
+       -  64-127
+
+    -  .. row 4
+
+       -  Raw VBI capture
+
+       -  ``/dev/vbi``, ``/dev/vbi0`` to ``/dev/vbi31``
+
+       -  224-255
+
+
+V4L prohibits (or used to prohibit) multiple opens of a device file.
+V4L2 drivers *may* support multiple opens, see :ref:`open` for details
+and consequences.
+
+V4L drivers respond to V4L2 ioctls with an EINVAL error code.
+
+
+Querying Capabilities
+=====================
+
+The V4L ``VIDIOCGCAP`` ioctl is equivalent to V4L2's
+:ref:`VIDIOC_QUERYCAP <vidioc-querycap>`.
+
+The ``name`` field in struct :c:type:`struct video_capability` became
+``card`` in struct :ref:`v4l2_capability <v4l2-capability>`, ``type``
+was replaced by ``capabilities``. Note V4L2 does not distinguish between
+device types like this, better think of basic video input, video output
+and radio devices supporting a set of related functions like video
+capturing, video overlay and VBI capturing. See :ref:`open` for an
+introduction.
+
+
+
+.. flat-table::
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  struct :c:type:`struct video_capability` ``type``
+
+       -  struct :ref:`v4l2_capability <v4l2-capability>`
+          ``capabilities`` flags
+
+       -  Purpose
+
+    -  .. row 2
+
+       -  ``VID_TYPE_CAPTURE``
+
+       -  ``V4L2_CAP_VIDEO_CAPTURE``
+
+       -  The :ref:`video capture <capture>` interface is supported.
+
+    -  .. row 3
+
+       -  ``VID_TYPE_TUNER``
+
+       -  ``V4L2_CAP_TUNER``
+
+       -  The device has a :ref:`tuner or modulator <tuner>`.
+
+    -  .. row 4
+
+       -  ``VID_TYPE_TELETEXT``
+
+       -  ``V4L2_CAP_VBI_CAPTURE``
+
+       -  The :ref:`raw VBI capture <raw-vbi>` interface is supported.
+
+    -  .. row 5
+
+       -  ``VID_TYPE_OVERLAY``
+
+       -  ``V4L2_CAP_VIDEO_OVERLAY``
+
+       -  The :ref:`video overlay <overlay>` interface is supported.
+
+    -  .. row 6
+
+       -  ``VID_TYPE_CHROMAKEY``
+
+       -  ``V4L2_FBUF_CAP_CHROMAKEY`` in field ``capability`` of struct
+          :ref:`v4l2_framebuffer <v4l2-framebuffer>`
+
+       -  Whether chromakey overlay is supported. For more information on
+          overlay see :ref:`overlay`.
+
+    -  .. row 7
+
+       -  ``VID_TYPE_CLIPPING``
+
+       -  ``V4L2_FBUF_CAP_LIST_CLIPPING`` and
+          ``V4L2_FBUF_CAP_BITMAP_CLIPPING`` in field ``capability`` of
+          struct :ref:`v4l2_framebuffer <v4l2-framebuffer>`
+
+       -  Whether clipping the overlaid image is supported, see
+          :ref:`overlay`.
+
+    -  .. row 8
+
+       -  ``VID_TYPE_FRAMERAM``
+
+       -  ``V4L2_FBUF_CAP_EXTERNOVERLAY`` *not set* in field ``capability``
+          of struct :ref:`v4l2_framebuffer <v4l2-framebuffer>`
+
+       -  Whether overlay overwrites frame buffer memory, see
+          :ref:`overlay`.
+
+    -  .. row 9
+
+       -  ``VID_TYPE_SCALES``
+
+       -  ``-``
+
+       -  This flag indicates if the hardware can scale images. The V4L2 API
+          implies the scale factor by setting the cropping dimensions and
+          image size with the :ref:`VIDIOC_S_CROP <vidioc-g-crop>` and
+          :ref:`VIDIOC_S_FMT <vidioc-g-fmt>` ioctl, respectively. The
+          driver returns the closest sizes possible. For more information on
+          cropping and scaling see :ref:`crop`.
+
+    -  .. row 10
+
+       -  ``VID_TYPE_MONOCHROME``
+
+       -  ``-``
+
+       -  Applications can enumerate the supported image formats with the
+          :ref:`VIDIOC_ENUM_FMT <vidioc-enum-fmt>` ioctl to determine if
+          the device supports grey scale capturing only. For more
+          information on image formats see :ref:`pixfmt`.
+
+    -  .. row 11
+
+       -  ``VID_TYPE_SUBCAPTURE``
+
+       -  ``-``
+
+       -  Applications can call the :ref:`VIDIOC_G_CROP <vidioc-g-crop>`
+          ioctl to determine if the device supports capturing a subsection
+          of the full picture ("cropping" in V4L2). If not, the ioctl
+          returns the EINVAL error code. For more information on cropping
+          and scaling see :ref:`crop`.
+
+    -  .. row 12
+
+       -  ``VID_TYPE_MPEG_DECODER``
+
+       -  ``-``
+
+       -  Applications can enumerate the supported image formats with the
+          :ref:`VIDIOC_ENUM_FMT <vidioc-enum-fmt>` ioctl to determine if
+          the device supports MPEG streams.
+
+    -  .. row 13
+
+       -  ``VID_TYPE_MPEG_ENCODER``
+
+       -  ``-``
+
+       -  See above.
+
+    -  .. row 14
+
+       -  ``VID_TYPE_MJPEG_DECODER``
+
+       -  ``-``
+
+       -  See above.
+
+    -  .. row 15
+
+       -  ``VID_TYPE_MJPEG_ENCODER``
+
+       -  ``-``
+
+       -  See above.
+
+
+The ``audios`` field was replaced by ``capabilities`` flag
+``V4L2_CAP_AUDIO``, indicating *if* the device has any audio inputs or
+outputs. To determine their number applications can enumerate audio
+inputs with the :ref:`VIDIOC_G_AUDIO <vidioc-g-audio>` ioctl. The
+audio ioctls are described in :ref:`audio`.
+
+The ``maxwidth``, ``maxheight``, ``minwidth`` and ``minheight`` fields
+were removed. Calling the :ref:`VIDIOC_S_FMT <vidioc-g-fmt>` or
+:ref:`VIDIOC_TRY_FMT <vidioc-g-fmt>` ioctl with the desired
+dimensions returns the closest size possible, taking into account the
+current video standard, cropping and scaling limitations.
+
+
+Video Sources
+=============
+
+V4L provides the ``VIDIOCGCHAN`` and ``VIDIOCSCHAN`` ioctl using struct
+:c:type:`struct video_channel` to enumerate the video inputs of a V4L
+device. The equivalent V4L2 ioctls are
+:ref:`VIDIOC_ENUMINPUT <vidioc-enuminput>`,
+:ref:`VIDIOC_G_INPUT <vidioc-g-input>` and
+:ref:`VIDIOC_S_INPUT <vidioc-g-input>` using struct
+:ref:`v4l2_input <v4l2-input>` as discussed in :ref:`video`.
+
+The ``channel`` field counting inputs was renamed to ``index``, the
+video input types were renamed as follows:
+
+
+
+.. flat-table::
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  struct :c:type:`struct video_channel` ``type``
+
+       -  struct :ref:`v4l2_input <v4l2-input>` ``type``
+
+    -  .. row 2
+
+       -  ``VIDEO_TYPE_TV``
+
+       -  ``V4L2_INPUT_TYPE_TUNER``
+
+    -  .. row 3
+
+       -  ``VIDEO_TYPE_CAMERA``
+
+       -  ``V4L2_INPUT_TYPE_CAMERA``
+
+
+Unlike the ``tuners`` field expressing the number of tuners of this
+input, V4L2 assumes each video input is connected to at most one tuner.
+However a tuner can have more than one input, i. e. RF connectors, and a
+device can have multiple tuners. The index number of the tuner
+associated with the input, if any, is stored in field ``tuner`` of
+struct :ref:`v4l2_input <v4l2-input>`. Enumeration of tuners is
+discussed in :ref:`tuner`.
+
+The redundant ``VIDEO_VC_TUNER`` flag was dropped. Video inputs
+associated with a tuner are of type ``V4L2_INPUT_TYPE_TUNER``. The
+``VIDEO_VC_AUDIO`` flag was replaced by the ``audioset`` field. V4L2
+considers devices with up to 32 audio inputs. Each set bit in the
+``audioset`` field represents one audio input this video input combines
+with. For information about audio inputs and how to switch between them
+see :ref:`audio`.
+
+The ``norm`` field describing the supported video standards was replaced
+by ``std``. The V4L specification mentions a flag ``VIDEO_VC_NORM``
+indicating whether the standard can be changed. This flag was a later
+addition together with the ``norm`` field and has been removed in the
+meantime. V4L2 has a similar, albeit more comprehensive approach to
+video standards, see :ref:`standard` for more information.
+
+
+Tuning
+======
+
+The V4L ``VIDIOCGTUNER`` and ``VIDIOCSTUNER`` ioctl and struct
+:c:type:`struct video_tuner` can be used to enumerate the tuners of a
+V4L TV or radio device. The equivalent V4L2 ioctls are
+:ref:`VIDIOC_G_TUNER <vidioc-g-tuner>` and
+:ref:`VIDIOC_S_TUNER <vidioc-g-tuner>` using struct
+:ref:`v4l2_tuner <v4l2-tuner>`. Tuners are covered in :ref:`tuner`.
+
+The ``tuner`` field counting tuners was renamed to ``index``. The fields
+``name``, ``rangelow`` and ``rangehigh`` remained unchanged.
+
+The ``VIDEO_TUNER_PAL``, ``VIDEO_TUNER_NTSC`` and ``VIDEO_TUNER_SECAM``
+flags indicating the supported video standards were dropped. This
+information is now contained in the associated struct
+:ref:`v4l2_input <v4l2-input>`. No replacement exists for the
+``VIDEO_TUNER_NORM`` flag indicating whether the video standard can be
+switched. The ``mode`` field to select a different video standard was
+replaced by a whole new set of ioctls and structures described in
+:ref:`standard`. Due to its ubiquity it should be mentioned the BTTV
+driver supports several standards in addition to the regular
+``VIDEO_MODE_PAL`` (0), ``VIDEO_MODE_NTSC``, ``VIDEO_MODE_SECAM`` and
+``VIDEO_MODE_AUTO`` (3). Namely N/PAL Argentina, M/PAL, N/PAL, and NTSC
+Japan with numbers 3-6 (sic).
+
+The ``VIDEO_TUNER_STEREO_ON`` flag indicating stereo reception became
+``V4L2_TUNER_SUB_STEREO`` in field ``rxsubchans``. This field also
+permits the detection of monaural and bilingual audio, see the
+definition of struct :ref:`v4l2_tuner <v4l2-tuner>` for details.
+Presently no replacement exists for the ``VIDEO_TUNER_RDS_ON`` and
+``VIDEO_TUNER_MBS_ON`` flags.
+
+The ``VIDEO_TUNER_LOW`` flag was renamed to ``V4L2_TUNER_CAP_LOW`` in
+the struct :ref:`v4l2_tuner <v4l2-tuner>` ``capability`` field.
+
+The ``VIDIOCGFREQ`` and ``VIDIOCSFREQ`` ioctl to change the tuner
+frequency where renamed to
+:ref:`VIDIOC_G_FREQUENCY <vidioc-g-frequency>` and
+:ref:`VIDIOC_S_FREQUENCY <vidioc-g-frequency>`. They take a pointer
+to a struct :ref:`v4l2_frequency <v4l2-frequency>` instead of an
+unsigned long integer.
+
+
+.. _v4l-image-properties:
+
+Image Properties
+================
+
+V4L2 has no equivalent of the ``VIDIOCGPICT`` and ``VIDIOCSPICT`` ioctl
+and struct :c:type:`struct video_picture`. The following fields where
+replaced by V4L2 controls accessible with the
+:ref:`VIDIOC_QUERYCTRL <vidioc-queryctrl>`,
+:ref:`VIDIOC_G_CTRL <vidioc-g-ctrl>` and
+:ref:`VIDIOC_S_CTRL <vidioc-g-ctrl>` ioctls:
+
+
+
+.. flat-table::
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  struct :c:type:`struct video_picture`
+
+       -  V4L2 Control ID
+
+    -  .. row 2
+
+       -  ``brightness``
+
+       -  ``V4L2_CID_BRIGHTNESS``
+
+    -  .. row 3
+
+       -  ``hue``
+
+       -  ``V4L2_CID_HUE``
+
+    -  .. row 4
+
+       -  ``colour``
+
+       -  ``V4L2_CID_SATURATION``
+
+    -  .. row 5
+
+       -  ``contrast``
+
+       -  ``V4L2_CID_CONTRAST``
+
+    -  .. row 6
+
+       -  ``whiteness``
+
+       -  ``V4L2_CID_WHITENESS``
+
+
+The V4L picture controls are assumed to range from 0 to 65535 with no
+particular reset value. The V4L2 API permits arbitrary limits and
+defaults which can be queried with the
+:ref:`VIDIOC_QUERYCTRL <vidioc-queryctrl>` ioctl. For general
+information about controls see :ref:`control`.
+
+The ``depth`` (average number of bits per pixel) of a video image is
+implied by the selected image format. V4L2 does not explicitly provide
+such information assuming applications recognizing the format are aware
+of the image depth and others need not know. The ``palette`` field moved
+into the struct :ref:`v4l2_pix_format <v4l2-pix-format>`:
+
+
+
+.. flat-table::
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  struct :c:type:`struct video_picture` ``palette``
+
+       -  struct :ref:`v4l2_pix_format <v4l2-pix-format>` ``pixfmt``
+
+    -  .. row 2
+
+       -  ``VIDEO_PALETTE_GREY``
+
+       -  :ref:`V4L2_PIX_FMT_GREY <V4L2-PIX-FMT-GREY>`
+
+    -  .. row 3
+
+       -  ``VIDEO_PALETTE_HI240``
+
+       -  :ref:`V4L2_PIX_FMT_HI240 <pixfmt-reserved>` [3]_
+
+    -  .. row 4
+
+       -  ``VIDEO_PALETTE_RGB565``
+
+       -  :ref:`V4L2_PIX_FMT_RGB565 <pixfmt-rgb>`
+
+    -  .. row 5
+
+       -  ``VIDEO_PALETTE_RGB555``
+
+       -  :ref:`V4L2_PIX_FMT_RGB555 <pixfmt-rgb>`
+
+    -  .. row 6
+
+       -  ``VIDEO_PALETTE_RGB24``
+
+       -  :ref:`V4L2_PIX_FMT_BGR24 <pixfmt-rgb>`
+
+    -  .. row 7
+
+       -  ``VIDEO_PALETTE_RGB32``
+
+       -  :ref:`V4L2_PIX_FMT_BGR32 <pixfmt-rgb>` [4]_
+
+    -  .. row 8
+
+       -  ``VIDEO_PALETTE_YUV422``
+
+       -  :ref:`V4L2_PIX_FMT_YUYV <V4L2-PIX-FMT-YUYV>`
+
+    -  .. row 9
+
+       -  ``VIDEO_PALETTE_YUYV``\  [5]_
+
+       -  :ref:`V4L2_PIX_FMT_YUYV <V4L2-PIX-FMT-YUYV>`
+
+    -  .. row 10
+
+       -  ``VIDEO_PALETTE_UYVY``
+
+       -  :ref:`V4L2_PIX_FMT_UYVY <V4L2-PIX-FMT-UYVY>`
+
+    -  .. row 11
+
+       -  ``VIDEO_PALETTE_YUV420``
+
+       -  None
+
+    -  .. row 12
+
+       -  ``VIDEO_PALETTE_YUV411``
+
+       -  :ref:`V4L2_PIX_FMT_Y41P <V4L2-PIX-FMT-Y41P>` [6]_
+
+    -  .. row 13
+
+       -  ``VIDEO_PALETTE_RAW``
+
+       -  None [7]_
+
+    -  .. row 14
+
+       -  ``VIDEO_PALETTE_YUV422P``
+
+       -  :ref:`V4L2_PIX_FMT_YUV422P <V4L2-PIX-FMT-YUV422P>`
+
+    -  .. row 15
+
+       -  ``VIDEO_PALETTE_YUV411P``
+
+       -  :ref:`V4L2_PIX_FMT_YUV411P <V4L2-PIX-FMT-YUV411P>` [8]_
+
+    -  .. row 16
+
+       -  ``VIDEO_PALETTE_YUV420P``
+
+       -  :ref:`V4L2_PIX_FMT_YVU420 <V4L2-PIX-FMT-YVU420>`
+
+    -  .. row 17
+
+       -  ``VIDEO_PALETTE_YUV410P``
+
+       -  :ref:`V4L2_PIX_FMT_YVU410 <V4L2-PIX-FMT-YVU410>`
+
+
+V4L2 image formats are defined in :ref:`pixfmt`. The image format can
+be selected with the :ref:`VIDIOC_S_FMT <vidioc-g-fmt>` ioctl.
+
+
+Audio
+=====
+
+The ``VIDIOCGAUDIO`` and ``VIDIOCSAUDIO`` ioctl and struct
+:c:type:`struct video_audio` are used to enumerate the audio inputs
+of a V4L device. The equivalent V4L2 ioctls are
+:ref:`VIDIOC_G_AUDIO <vidioc-g-audio>` and
+:ref:`VIDIOC_S_AUDIO <vidioc-g-audio>` using struct
+:ref:`v4l2_audio <v4l2-audio>` as discussed in :ref:`audio`.
+
+The ``audio`` "channel number" field counting audio inputs was renamed
+to ``index``.
+
+On ``VIDIOCSAUDIO`` the ``mode`` field selects *one* of the
+``VIDEO_SOUND_MONO``, ``VIDEO_SOUND_STEREO``, ``VIDEO_SOUND_LANG1`` or
+``VIDEO_SOUND_LANG2`` audio demodulation modes. When the current audio
+standard is BTSC ``VIDEO_SOUND_LANG2`` refers to SAP and
+``VIDEO_SOUND_LANG1`` is meaningless. Also undocumented in the V4L
+specification, there is no way to query the selected mode. On
+``VIDIOCGAUDIO`` the driver returns the *actually received* audio
+programmes in this field. In the V4L2 API this information is stored in
+the struct :ref:`v4l2_tuner <v4l2-tuner>` ``rxsubchans`` and
+``audmode`` fields, respectively. See :ref:`tuner` for more
+information on tuners. Related to audio modes struct
+:ref:`v4l2_audio <v4l2-audio>` also reports if this is a mono or
+stereo input, regardless if the source is a tuner.
+
+The following fields where replaced by V4L2 controls accessible with the
+:ref:`VIDIOC_QUERYCTRL <vidioc-queryctrl>`,
+:ref:`VIDIOC_G_CTRL <vidioc-g-ctrl>` and
+:ref:`VIDIOC_S_CTRL <vidioc-g-ctrl>` ioctls:
+
+
+
+.. flat-table::
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  struct :c:type:`struct video_audio`
+
+       -  V4L2 Control ID
+
+    -  .. row 2
+
+       -  ``volume``
+
+       -  ``V4L2_CID_AUDIO_VOLUME``
+
+    -  .. row 3
+
+       -  ``bass``
+
+       -  ``V4L2_CID_AUDIO_BASS``
+
+    -  .. row 4
+
+       -  ``treble``
+
+       -  ``V4L2_CID_AUDIO_TREBLE``
+
+    -  .. row 5
+
+       -  ``balance``
+
+       -  ``V4L2_CID_AUDIO_BALANCE``
+
+
+To determine which of these controls are supported by a driver V4L
+provides the ``flags`` ``VIDEO_AUDIO_VOLUME``, ``VIDEO_AUDIO_BASS``,
+``VIDEO_AUDIO_TREBLE`` and ``VIDEO_AUDIO_BALANCE``. In the V4L2 API the
+:ref:`VIDIOC_QUERYCTRL <vidioc-queryctrl>` ioctl reports if the
+respective control is supported. Accordingly the ``VIDEO_AUDIO_MUTABLE``
+and ``VIDEO_AUDIO_MUTE`` flags where replaced by the boolean
+``V4L2_CID_AUDIO_MUTE`` control.
+
+All V4L2 controls have a ``step`` attribute replacing the struct
+:c:type:`struct video_audio` ``step`` field. The V4L audio controls
+are assumed to range from 0 to 65535 with no particular reset value. The
+V4L2 API permits arbitrary limits and defaults which can be queried with
+the :ref:`VIDIOC_QUERYCTRL <vidioc-queryctrl>` ioctl. For general
+information about controls see :ref:`control`.
+
+
+Frame Buffer Overlay
+====================
+
+The V4L2 ioctls equivalent to ``VIDIOCGFBUF`` and ``VIDIOCSFBUF`` are
+:ref:`VIDIOC_G_FBUF <vidioc-g-fbuf>` and
+:ref:`VIDIOC_S_FBUF <vidioc-g-fbuf>`. The ``base`` field of struct
+:c:type:`struct video_buffer` remained unchanged, except V4L2 defines
+a flag to indicate non-destructive overlays instead of a ``NULL``
+pointer. All other fields moved into the struct
+:ref:`v4l2_pix_format <v4l2-pix-format>` ``fmt`` substructure of
+struct :ref:`v4l2_framebuffer <v4l2-framebuffer>`. The ``depth``
+field was replaced by ``pixelformat``. See :ref:`pixfmt-rgb` for a
+list of RGB formats and their respective color depths.
+
+Instead of the special ioctls ``VIDIOCGWIN`` and ``VIDIOCSWIN`` V4L2
+uses the general-purpose data format negotiation ioctls
+:ref:`VIDIOC_G_FMT <vidioc-g-fmt>` and
+:ref:`VIDIOC_S_FMT <vidioc-g-fmt>`. They take a pointer to a struct
+:ref:`v4l2_format <v4l2-format>` as argument. Here the ``win`` member
+of the ``fmt`` union is used, a struct
+:ref:`v4l2_window <v4l2-window>`.
+
+The ``x``, ``y``, ``width`` and ``height`` fields of struct
+:c:type:`struct video_window` moved into struct
+:ref:`v4l2_rect <v4l2-rect>` substructure ``w`` of struct
+:c:type:`struct v4l2_window`. The ``chromakey``, ``clips``, and
+``clipcount`` fields remained unchanged. Struct
+:c:type:`struct video_clip` was renamed to struct
+:ref:`v4l2_clip <v4l2-clip>`, also containing a struct
+:c:type:`struct v4l2_rect`, but the semantics are still the same.
+
+The ``VIDEO_WINDOW_INTERLACE`` flag was dropped. Instead applications
+must set the ``field`` field to ``V4L2_FIELD_ANY`` or
+``V4L2_FIELD_INTERLACED``. The ``VIDEO_WINDOW_CHROMAKEY`` flag moved
+into struct :ref:`v4l2_framebuffer <v4l2-framebuffer>`, under the new
+name ``V4L2_FBUF_FLAG_CHROMAKEY``.
+
+In V4L, storing a bitmap pointer in ``clips`` and setting ``clipcount``
+to ``VIDEO_CLIP_BITMAP`` (-1) requests bitmap clipping, using a fixed
+size bitmap of 1024 × 625 bits. Struct :c:type:`struct v4l2_window`
+has a separate ``bitmap`` pointer field for this purpose and the bitmap
+size is determined by ``w.width`` and ``w.height``.
+
+The ``VIDIOCCAPTURE`` ioctl to enable or disable overlay was renamed to
+:ref:`VIDIOC_OVERLAY <vidioc-overlay>`.
+
+
+Cropping
+========
+
+To capture only a subsection of the full picture V4L defines the
+``VIDIOCGCAPTURE`` and ``VIDIOCSCAPTURE`` ioctls using struct
+:c:type:`struct video_capture`. The equivalent V4L2 ioctls are
+:ref:`VIDIOC_G_CROP <vidioc-g-crop>` and
+:ref:`VIDIOC_S_CROP <vidioc-g-crop>` using struct
+:ref:`v4l2_crop <v4l2-crop>`, and the related
+:ref:`VIDIOC_CROPCAP <vidioc-cropcap>` ioctl. This is a rather
+complex matter, see :ref:`crop` for details.
+
+The ``x``, ``y``, ``width`` and ``height`` fields moved into struct
+:ref:`v4l2_rect <v4l2-rect>` substructure ``c`` of struct
+:c:type:`struct v4l2_crop`. The ``decimation`` field was dropped. In
+the V4L2 API the scaling factor is implied by the size of the cropping
+rectangle and the size of the captured or overlaid image.
+
+The ``VIDEO_CAPTURE_ODD`` and ``VIDEO_CAPTURE_EVEN`` flags to capture
+only the odd or even field, respectively, were replaced by
+``V4L2_FIELD_TOP`` and ``V4L2_FIELD_BOTTOM`` in the field named
+``field`` of struct :ref:`v4l2_pix_format <v4l2-pix-format>` and
+struct :ref:`v4l2_window <v4l2-window>`. These structures are used to
+select a capture or overlay format with the
+:ref:`VIDIOC_S_FMT <vidioc-g-fmt>` ioctl.
+
+
+Reading Images, Memory Mapping
+==============================
+
+
+Capturing using the read method
+-------------------------------
+
+There is no essential difference between reading images from a V4L or
+V4L2 device using the :ref:`read() <func-read>` function, however V4L2
+drivers are not required to support this I/O method. Applications can
+determine if the function is available with the
+:ref:`VIDIOC_QUERYCAP <vidioc-querycap>` ioctl. All V4L2 devices
+exchanging data with applications must support the
+:ref:`select() <func-select>` and :ref:`poll() <func-poll>`
+functions.
+
+To select an image format and size, V4L provides the ``VIDIOCSPICT`` and
+``VIDIOCSWIN`` ioctls. V4L2 uses the general-purpose data format
+negotiation ioctls :ref:`VIDIOC_G_FMT <vidioc-g-fmt>` and
+:ref:`VIDIOC_S_FMT <vidioc-g-fmt>`. They take a pointer to a struct
+:ref:`v4l2_format <v4l2-format>` as argument, here the struct
+:ref:`v4l2_pix_format <v4l2-pix-format>` named ``pix`` of its
+``fmt`` union is used.
+
+For more information about the V4L2 read interface see :ref:`rw`.
+
+
+Capturing using memory mapping
+------------------------------
+
+Applications can read from V4L devices by mapping buffers in device
+memory, or more often just buffers allocated in DMA-able system memory,
+into their address space. This avoids the data copying overhead of the
+read method. V4L2 supports memory mapping as well, with a few
+differences.
+
+
+
+.. flat-table::
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  V4L
+
+       -  V4L2
+
+    -  .. row 2
+
+       -  
+       -  The image format must be selected before buffers are allocated,
+          with the :ref:`VIDIOC_S_FMT <vidioc-g-fmt>` ioctl. When no
+          format is selected the driver may use the last, possibly by
+          another application requested format.
+
+    -  .. row 3
+
+       -  Applications cannot change the number of buffers. The it is built
+          into the driver, unless it has a module option to change the
+          number when the driver module is loaded.
+
+       -  The :ref:`VIDIOC_REQBUFS <vidioc-reqbufs>` ioctl allocates the
+          desired number of buffers, this is a required step in the
+          initialization sequence.
+
+    -  .. row 4
+
+       -  Drivers map all buffers as one contiguous range of memory. The
+          ``VIDIOCGMBUF`` ioctl is available to query the number of buffers,
+          the offset of each buffer from the start of the virtual file, and
+          the overall amount of memory used, which can be used as arguments
+          for the :ref:`mmap() <func-mmap>` function.
+
+       -  Buffers are individually mapped. The offset and size of each
+          buffer can be determined with the
+          :ref:`VIDIOC_QUERYBUF <vidioc-querybuf>` ioctl.
+
+    -  .. row 5
+
+       -  The ``VIDIOCMCAPTURE`` ioctl prepares a buffer for capturing. It
+          also determines the image format for this buffer. The ioctl
+          returns immediately, eventually with an EAGAIN error code if no
+          video signal had been detected. When the driver supports more than
+          one buffer applications can call the ioctl multiple times and thus
+          have multiple outstanding capture requests.
+
+          The ``VIDIOCSYNC`` ioctl suspends execution until a particular
+          buffer has been filled.
+
+       -  Drivers maintain an incoming and outgoing queue.
+          :ref:`VIDIOC_QBUF <vidioc-qbuf>` enqueues any empty buffer into
+          the incoming queue. Filled buffers are dequeued from the outgoing
+          queue with the :ref:`VIDIOC_DQBUF <vidioc-qbuf>` ioctl. To wait
+          until filled buffers become available this function,
+          :ref:`select() <func-select>` or :ref:`poll() <func-poll>` can
+          be used. The :ref:`VIDIOC_STREAMON <vidioc-streamon>` ioctl
+          must be called once after enqueuing one or more buffers to start
+          capturing. Its counterpart
+          :ref:`VIDIOC_STREAMOFF <vidioc-streamon>` stops capturing and
+          dequeues all buffers from both queues. Applications can query the
+          signal status, if known, with the
+          :ref:`VIDIOC_ENUMINPUT <vidioc-enuminput>` ioctl.
+
+
+For a more in-depth discussion of memory mapping and examples, see
+:ref:`mmap`.
+
+
+Reading Raw VBI Data
+====================
+
+Originally the V4L API did not specify a raw VBI capture interface, only
+the device file ``/dev/vbi`` was reserved for this purpose. The only
+driver supporting this interface was the BTTV driver, de-facto defining
+the V4L VBI interface. Reading from the device yields a raw VBI image
+with the following parameters:
+
+
+
+.. flat-table::
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  struct :ref:`v4l2_vbi_format <v4l2-vbi-format>`
+
+       -  V4L, BTTV driver
+
+    -  .. row 2
+
+       -  sampling_rate
+
+       -  28636363 Hz NTSC (or any other 525-line standard); 35468950 Hz PAL
+          and SECAM (625-line standards)
+
+    -  .. row 3
+
+       -  offset
+
+       -  ?
+
+    -  .. row 4
+
+       -  samples_per_line
+
+       -  2048
+
+    -  .. row 5
+
+       -  sample_format
+
+       -  V4L2_PIX_FMT_GREY. The last four bytes (a machine endianness
+          integer) contain a frame counter.
+
+    -  .. row 6
+
+       -  start[]
+
+       -  10, 273 NTSC; 22, 335 PAL and SECAM
+
+    -  .. row 7
+
+       -  count[]
+
+       -  16, 16 [9]_
+
+    -  .. row 8
+
+       -  flags
+
+       -  0
+
+
+Undocumented in the V4L specification, in Linux 2.3 the
+``VIDIOCGVBIFMT`` and ``VIDIOCSVBIFMT`` ioctls using struct
+:c:type:`struct vbi_format` were added to determine the VBI image
+parameters. These ioctls are only partially compatible with the V4L2 VBI
+interface specified in :ref:`raw-vbi`.
+
+An ``offset`` field does not exist, ``sample_format`` is supposed to be
+``VIDEO_PALETTE_RAW``, equivalent to ``V4L2_PIX_FMT_GREY``. The
+remaining fields are probably equivalent to struct
+:ref:`v4l2_vbi_format <v4l2-vbi-format>`.
+
+Apparently only the Zoran (ZR 36120) driver implements these ioctls. The
+semantics differ from those specified for V4L2 in two ways. The
+parameters are reset on :ref:`open() <func-open>` and
+``VIDIOCSVBIFMT`` always returns an EINVAL error code if the parameters
+are invalid.
+
+
+Miscellaneous
+=============
+
+V4L2 has no equivalent of the ``VIDIOCGUNIT`` ioctl. Applications can
+find the VBI device associated with a video capture device (or vice
+versa) by reopening the device and requesting VBI data. For details see
+:ref:`open`.
+
+No replacement exists for ``VIDIOCKEY``, and the V4L functions for
+microcode programming. A new interface for MPEG compression and playback
+devices is documented in :ref:`extended-controls`.
+
+.. [1]
+   According to Documentation/devices.txt these should be symbolic links
+   to ``/dev/video0``. Note the original bttv interface is not
+   compatible with V4L or V4L2.
+
+.. [2]
+   According to ``Documentation/devices.txt`` a symbolic link to
+   ``/dev/radio0``.
+
+.. [3]
+   This is a custom format used by the BTTV driver, not one of the V4L2
+   standard formats.
+
+.. [4]
+   Presumably all V4L RGB formats are little-endian, although some
+   drivers might interpret them according to machine endianness. V4L2
+   defines little-endian, big-endian and red/blue swapped variants. For
+   details see :ref:`pixfmt-rgb`.
+
+.. [5]
+   ``VIDEO_PALETTE_YUV422`` and ``VIDEO_PALETTE_YUYV`` are the same
+   formats. Some V4L drivers respond to one, some to the other.
+
+.. [6]
+   Not to be confused with ``V4L2_PIX_FMT_YUV411P``, which is a planar
+   format.
+
+.. [7]
+   V4L explains this as: "RAW capture (BT848)"
+
+.. [8]
+   Not to be confused with ``V4L2_PIX_FMT_Y41P``, which is a packed
+   format.
+
+.. [9]
+   Old driver versions used different values, eventually the custom
+   ``BTTV_VBISIZE`` ioctl was added to query the correct values.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/dmabuf.rst b/Documentation/linux_tv/media/v4l/dmabuf.rst
new file mode 100644
index 000000000000..ac14cf89fa38
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/dmabuf.rst
@@ -0,0 +1,158 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _dmabuf:
+
+************************************
+Streaming I/O (DMA buffer importing)
+************************************
+
+The DMABUF framework provides a generic method for sharing buffers
+between multiple devices. Device drivers that support DMABUF can export
+a DMA buffer to userspace as a file descriptor (known as the exporter
+role), import a DMA buffer from userspace using a file descriptor
+previously exported for a different or the same device (known as the
+importer role), or both. This section describes the DMABUF importer role
+API in V4L2.
+
+Refer to :ref:`DMABUF exporting <vidioc-expbuf>` for details about
+exporting V4L2 buffers as DMABUF file descriptors.
+
+Input and output devices support the streaming I/O method when the
+``V4L2_CAP_STREAMING`` flag in the ``capabilities`` field of struct
+:ref:`v4l2_capability <v4l2-capability>` returned by the
+:ref:`VIDIOC_QUERYCAP <vidioc-querycap>` ioctl is set. Whether
+importing DMA buffers through DMABUF file descriptors is supported is
+determined by calling the :ref:`VIDIOC_REQBUFS <vidioc-reqbufs>`
+ioctl with the memory type set to ``V4L2_MEMORY_DMABUF``.
+
+This I/O method is dedicated to sharing DMA buffers between different
+devices, which may be V4L devices or other video-related devices (e.g.
+DRM). Buffers (planes) are allocated by a driver on behalf of an
+application. Next, these buffers are exported to the application as file
+descriptors using an API which is specific for an allocator driver. Only
+such file descriptor are exchanged. The descriptors and meta-information
+are passed in struct :ref:`v4l2_buffer <v4l2-buffer>` (or in struct
+:ref:`v4l2_plane <v4l2-plane>` in the multi-planar API case). The
+driver must be switched into DMABUF I/O mode by calling the
+:ref:`VIDIOC_REQBUFS <vidioc-reqbufs>` with the desired buffer type.
+
+
+.. code-block:: c
+
+    struct v4l2_requestbuffers reqbuf;
+
+    memset(&reqbuf, 0, sizeof (reqbuf));
+    reqbuf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
+    reqbuf.memory = V4L2_MEMORY_DMABUF;
+    reqbuf.count = 1;
+
+    if (ioctl(fd, VIDIOC_REQBUFS, &reqbuf) == -1) {
+        if (errno == EINVAL)
+            printf("Video capturing or DMABUF streaming is not supported\\n");
+        else
+            perror("VIDIOC_REQBUFS");
+
+        exit(EXIT_FAILURE);
+    }
+
+The buffer (plane) file descriptor is passed on the fly with the
+:ref:`VIDIOC_QBUF <vidioc-qbuf>` ioctl. In case of multiplanar
+buffers, every plane can be associated with a different DMABUF
+descriptor. Although buffers are commonly cycled, applications can pass
+a different DMABUF descriptor at each ``VIDIOC_QBUF`` call.
+
+
+.. code-block:: c
+
+    int buffer_queue(int v4lfd, int index, int dmafd)
+    {
+        struct v4l2_buffer buf;
+
+        memset(&buf, 0, sizeof buf);
+        buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
+        buf.memory = V4L2_MEMORY_DMABUF;
+        buf.index = index;
+        buf.m.fd = dmafd;
+
+        if (ioctl(v4lfd, VIDIOC_QBUF, &buf) == -1) {
+            perror("VIDIOC_QBUF");
+            return -1;
+        }
+
+        return 0;
+    }
+
+
+.. code-block:: c
+
+    int buffer_queue_mp(int v4lfd, int index, int dmafd[], int n_planes)
+    {
+        struct v4l2_buffer buf;
+        struct v4l2_plane planes[VIDEO_MAX_PLANES];
+        int i;
+
+        memset(&buf, 0, sizeof buf);
+        buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE;
+        buf.memory = V4L2_MEMORY_DMABUF;
+        buf.index = index;
+        buf.m.planes = planes;
+        buf.length = n_planes;
+
+        memset(&planes, 0, sizeof planes);
+
+        for (i = 0; i < n_planes; ++i)
+            buf.m.planes[i].m.fd = dmafd[i];
+
+        if (ioctl(v4lfd, VIDIOC_QBUF, &buf) == -1) {
+            perror("VIDIOC_QBUF");
+            return -1;
+        }
+
+        return 0;
+    }
+
+Captured or displayed buffers are dequeued with the
+:ref:`VIDIOC_DQBUF <vidioc-qbuf>` ioctl. The driver can unlock the
+buffer at any time between the completion of the DMA and this ioctl. The
+memory is also unlocked when
+:ref:`VIDIOC_STREAMOFF <vidioc-streamon>` is called,
+:ref:`VIDIOC_REQBUFS <vidioc-reqbufs>`, or when the device is closed.
+
+For capturing applications it is customary to enqueue a number of empty
+buffers, to start capturing and enter the read loop. Here the
+application waits until a filled buffer can be dequeued, and re-enqueues
+the buffer when the data is no longer needed. Output applications fill
+and enqueue buffers, when enough buffers are stacked up output is
+started. In the write loop, when the application runs out of free
+buffers it must wait until an empty buffer can be dequeued and reused.
+Two methods exist to suspend execution of the application until one or
+more buffers can be dequeued. By default ``VIDIOC_DQBUF`` blocks when no
+buffer is in the outgoing queue. When the ``O_NONBLOCK`` flag was given
+to the :ref:`open() <func-open>` function, ``VIDIOC_DQBUF`` returns
+immediately with an EAGAIN error code when no buffer is available. The
+:ref:`select() <func-select>` and :ref:`poll() <func-poll>`
+functions are always available.
+
+To start and stop capturing or displaying applications call the
+:ref:`VIDIOC_STREAMON <vidioc-streamon>` and
+:ref:`VIDIOC_STREAMOFF <vidioc-streamon>` ioctls. Note that
+``VIDIOC_STREAMOFF`` removes all buffers from both queues and unlocks
+all buffers as a side effect. Since there is no notion of doing anything
+"now" on a multitasking system, if an application needs to synchronize
+with another event it should examine the struct
+:ref:`v4l2_buffer <v4l2-buffer>` ``timestamp`` of captured or
+outputted buffers.
+
+Drivers implementing DMABUF importing I/O must support the
+``VIDIOC_REQBUFS``, ``VIDIOC_QBUF``, ``VIDIOC_DQBUF``,
+``VIDIOC_STREAMON`` and ``VIDIOC_STREAMOFF`` ioctls, and the
+:c:func:`select()` and :c:func:`poll()` functions.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/driver.rst b/Documentation/linux_tv/media/v4l/driver.rst
new file mode 100644
index 000000000000..7ed48861c6fe
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/driver.rst
@@ -0,0 +1,18 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _driver:
+
+***********************
+V4L2 Driver Programming
+***********************
+
+to do
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/dv-timings.rst b/Documentation/linux_tv/media/v4l/dv-timings.rst
new file mode 100644
index 000000000000..a347ce7cb504
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/dv-timings.rst
@@ -0,0 +1,47 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _dv-timings:
+
+**************************
+Digital Video (DV) Timings
+**************************
+
+The video standards discussed so far have been dealing with Analog TV
+and the corresponding video timings. Today there are many more different
+hardware interfaces such as High Definition TV interfaces (HDMI), VGA,
+DVI connectors etc., that carry video signals and there is a need to
+extend the API to select the video timings for these interfaces. Since
+it is not possible to extend the :ref:`v4l2_std_id <v4l2-std-id>`
+due to the limited bits available, a new set of ioctls was added to
+set/get video timings at the input and output.
+
+These ioctls deal with the detailed digital video timings that define
+each video format. This includes parameters such as the active video
+width and height, signal polarities, frontporches, backporches, sync
+widths etc. The ``linux/v4l2-dv-timings.h`` header can be used to get
+the timings of the formats in the :ref:`cea861` and :ref:`vesadmt`
+standards.
+
+To enumerate and query the attributes of the DV timings supported by a
+device applications use the
+:ref:`VIDIOC_ENUM_DV_TIMINGS <vidioc-enum-dv-timings>` and
+:ref:`VIDIOC_DV_TIMINGS_CAP <vidioc-dv-timings-cap>` ioctls. To set
+DV timings for the device applications use the
+:ref:`VIDIOC_S_DV_TIMINGS <vidioc-g-dv-timings>` ioctl and to get
+current DV timings they use the
+:ref:`VIDIOC_G_DV_TIMINGS <vidioc-g-dv-timings>` ioctl. To detect
+the DV timings as seen by the video receiver applications use the
+:ref:`VIDIOC_QUERY_DV_TIMINGS <vidioc-query-dv-timings>` ioctl.
+
+Applications can make use of the :ref:`input-capabilities` and
+:ref:`output-capabilities` flags to determine whether the digital
+video ioctls can be used with the given input or output.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/extended-controls.rst b/Documentation/linux_tv/media/v4l/extended-controls.rst
new file mode 100644
index 000000000000..5f9779e94cde
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/extended-controls.rst
@@ -0,0 +1,4533 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _extended-controls:
+
+*****************
+Extended Controls
+*****************
+
+
+Introduction
+============
+
+The control mechanism as originally designed was meant to be used for
+user settings (brightness, saturation, etc). However, it turned out to
+be a very useful model for implementing more complicated driver APIs
+where each driver implements only a subset of a larger API.
+
+The MPEG encoding API was the driving force behind designing and
+implementing this extended control mechanism: the MPEG standard is quite
+large and the currently supported hardware MPEG encoders each only
+implement a subset of this standard. Further more, many parameters
+relating to how the video is encoded into an MPEG stream are specific to
+the MPEG encoding chip since the MPEG standard only defines the format
+of the resulting MPEG stream, not how the video is actually encoded into
+that format.
+
+Unfortunately, the original control API lacked some features needed for
+these new uses and so it was extended into the (not terribly originally
+named) extended control API.
+
+Even though the MPEG encoding API was the first effort to use the
+Extended Control API, nowadays there are also other classes of Extended
+Controls, such as Camera Controls and FM Transmitter Controls. The
+Extended Controls API as well as all Extended Controls classes are
+described in the following text.
+
+
+The Extended Control API
+========================
+
+Three new ioctls are available:
+:ref:`VIDIOC_G_EXT_CTRLS <vidioc-g-ext-ctrls>`,
+:ref:`VIDIOC_S_EXT_CTRLS <vidioc-g-ext-ctrls>` and
+:ref:`VIDIOC_TRY_EXT_CTRLS <vidioc-g-ext-ctrls>`. These ioctls act
+on arrays of controls (as opposed to the
+:ref:`VIDIOC_G_CTRL <vidioc-g-ctrl>` and
+:ref:`VIDIOC_S_CTRL <vidioc-g-ctrl>` ioctls that act on a single
+control). This is needed since it is often required to atomically change
+several controls at once.
+
+Each of the new ioctls expects a pointer to a struct
+:ref:`v4l2_ext_controls <v4l2-ext-controls>`. This structure
+contains a pointer to the control array, a count of the number of
+controls in that array and a control class. Control classes are used to
+group similar controls into a single class. For example, control class
+``V4L2_CTRL_CLASS_USER`` contains all user controls (i. e. all controls
+that can also be set using the old ``VIDIOC_S_CTRL`` ioctl). Control
+class ``V4L2_CTRL_CLASS_MPEG`` contains all controls relating to MPEG
+encoding, etc.
+
+All controls in the control array must belong to the specified control
+class. An error is returned if this is not the case.
+
+It is also possible to use an empty control array (count == 0) to check
+whether the specified control class is supported.
+
+The control array is a struct
+:ref:`v4l2_ext_control <v4l2-ext-control>` array. The
+:c:type:`struct v4l2_ext_control` structure is very similar to
+struct :ref:`v4l2_control <v4l2-control>`, except for the fact that
+it also allows for 64-bit values and pointers to be passed.
+
+Since the struct :ref:`v4l2_ext_control <v4l2-ext-control>` supports
+pointers it is now also possible to have controls with compound types
+such as N-dimensional arrays and/or structures. You need to specify the
+``V4L2_CTRL_FLAG_NEXT_COMPOUND`` when enumerating controls to actually
+be able to see such compound controls. In other words, these controls
+with compound types should only be used programmatically.
+
+Since such compound controls need to expose more information about
+themselves than is possible with
+:ref:`VIDIOC_QUERYCTRL <vidioc-queryctrl>` the
+:ref:`VIDIOC_QUERY_EXT_CTRL <vidioc-queryctrl>` ioctl was added. In
+particular, this ioctl gives the dimensions of the N-dimensional array
+if this control consists of more than one element.
+
+It is important to realize that due to the flexibility of controls it is
+necessary to check whether the control you want to set actually is
+supported in the driver and what the valid range of values is. So use
+the :ref:`VIDIOC_QUERYCTRL <vidioc-queryctrl>` (or
+:ref:`VIDIOC_QUERY_EXT_CTRL <vidioc-queryctrl>`) and
+:ref:`VIDIOC_QUERYMENU <vidioc-queryctrl>` ioctls to check this. Also
+note that it is possible that some of the menu indices in a control of
+type ``V4L2_CTRL_TYPE_MENU`` may not be supported (``VIDIOC_QUERYMENU``
+will return an error). A good example is the list of supported MPEG
+audio bitrates. Some drivers only support one or two bitrates, others
+support a wider range.
+
+All controls use machine endianness.
+
+
+Enumerating Extended Controls
+=============================
+
+The recommended way to enumerate over the extended controls is by using
+:ref:`VIDIOC_QUERYCTRL <vidioc-queryctrl>` in combination with the
+``V4L2_CTRL_FLAG_NEXT_CTRL`` flag:
+
+
+.. code-block:: c
+
+    struct v4l2_queryctrl qctrl;
+
+    qctrl.id = V4L2_CTRL_FLAG_NEXT_CTRL;
+    while (0 == ioctl (fd, VIDIOC_QUERYCTRL, &qctrl)) {
+        /* ... */
+        qctrl.id |= V4L2_CTRL_FLAG_NEXT_CTRL;
+    }
+
+The initial control ID is set to 0 ORed with the
+``V4L2_CTRL_FLAG_NEXT_CTRL`` flag. The ``VIDIOC_QUERYCTRL`` ioctl will
+return the first control with a higher ID than the specified one. When
+no such controls are found an error is returned.
+
+If you want to get all controls within a specific control class, then
+you can set the initial ``qctrl.id`` value to the control class and add
+an extra check to break out of the loop when a control of another
+control class is found:
+
+
+.. code-block:: c
+
+    qctrl.id = V4L2_CTRL_CLASS_MPEG | V4L2_CTRL_FLAG_NEXT_CTRL;
+    while (0 == ioctl(fd, VIDIOC_QUERYCTRL, &qctrl)) {
+        if (V4L2_CTRL_ID2CLASS(qctrl.id) != V4L2_CTRL_CLASS_MPEG)
+            break;
+            /* ... */
+        qctrl.id |= V4L2_CTRL_FLAG_NEXT_CTRL;
+    }
+
+The 32-bit ``qctrl.id`` value is subdivided into three bit ranges: the
+top 4 bits are reserved for flags (e. g. ``V4L2_CTRL_FLAG_NEXT_CTRL``)
+and are not actually part of the ID. The remaining 28 bits form the
+control ID, of which the most significant 12 bits define the control
+class and the least significant 16 bits identify the control within the
+control class. It is guaranteed that these last 16 bits are always
+non-zero for controls. The range of 0x1000 and up are reserved for
+driver-specific controls. The macro ``V4L2_CTRL_ID2CLASS(id)`` returns
+the control class ID based on a control ID.
+
+If the driver does not support extended controls, then
+``VIDIOC_QUERYCTRL`` will fail when used in combination with
+``V4L2_CTRL_FLAG_NEXT_CTRL``. In that case the old method of enumerating
+control should be used (see :ref:`enum_all_controls`). But if it is
+supported, then it is guaranteed to enumerate over all controls,
+including driver-private controls.
+
+
+Creating Control Panels
+=======================
+
+It is possible to create control panels for a graphical user interface
+where the user can select the various controls. Basically you will have
+to iterate over all controls using the method described above. Each
+control class starts with a control of type
+``V4L2_CTRL_TYPE_CTRL_CLASS``. ``VIDIOC_QUERYCTRL`` will return the name
+of this control class which can be used as the title of a tab page
+within a control panel.
+
+The flags field of struct :ref:`v4l2_queryctrl <v4l2-queryctrl>` also
+contains hints on the behavior of the control. See the
+:ref:`VIDIOC_QUERYCTRL <vidioc-queryctrl>` documentation for more
+details.
+
+
+.. _mpeg-controls:
+
+Codec Control Reference
+=======================
+
+Below all controls within the Codec control class are described. First
+the generic controls, then controls specific for certain hardware.
+
+Note: These controls are applicable to all codecs and not just MPEG. The
+defines are prefixed with V4L2_CID_MPEG/V4L2_MPEG as the controls
+were originally made for MPEG codecs and later extended to cover all
+encoding formats.
+
+
+Generic Codec Controls
+----------------------
+
+
+.. _mpeg-control-id:
+
+Codec Control IDs
+^^^^^^^^^^^^^^^^^
+
+``V4L2_CID_MPEG_CLASS (class)``
+    The Codec class descriptor. Calling
+    :ref:`VIDIOC_QUERYCTRL <vidioc-queryctrl>` for this control will
+    return a description of this control class. This description can be
+    used as the caption of a Tab page in a GUI, for example.
+
+.. _`v4l2-mpeg-stream-type`:
+
+``V4L2_CID_MPEG_STREAM_TYPE (enum v4l2_mpeg_stream_type)``
+    The MPEG-1, -2 or -4 output stream type. One cannot assume anything
+    here. Each hardware MPEG encoder tends to support different subsets
+    of the available MPEG stream types. This control is specific to
+    multiplexed MPEG streams. The currently defined stream types are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_STREAM_TYPE_MPEG2_PS``
+
+       -  MPEG-2 program stream
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_STREAM_TYPE_MPEG2_TS``
+
+       -  MPEG-2 transport stream
+
+    -  .. row 3
+
+       -  ``V4L2_MPEG_STREAM_TYPE_MPEG1_SS``
+
+       -  MPEG-1 system stream
+
+    -  .. row 4
+
+       -  ``V4L2_MPEG_STREAM_TYPE_MPEG2_DVD``
+
+       -  MPEG-2 DVD-compatible stream
+
+    -  .. row 5
+
+       -  ``V4L2_MPEG_STREAM_TYPE_MPEG1_VCD``
+
+       -  MPEG-1 VCD-compatible stream
+
+    -  .. row 6
+
+       -  ``V4L2_MPEG_STREAM_TYPE_MPEG2_SVCD``
+
+       -  MPEG-2 SVCD-compatible stream
+
+
+
+``V4L2_CID_MPEG_STREAM_PID_PMT (integer)``
+    Program Map Table Packet ID for the MPEG transport stream (default
+    16)
+
+``V4L2_CID_MPEG_STREAM_PID_AUDIO (integer)``
+    Audio Packet ID for the MPEG transport stream (default 256)
+
+``V4L2_CID_MPEG_STREAM_PID_VIDEO (integer)``
+    Video Packet ID for the MPEG transport stream (default 260)
+
+``V4L2_CID_MPEG_STREAM_PID_PCR (integer)``
+    Packet ID for the MPEG transport stream carrying PCR fields (default
+    259)
+
+``V4L2_CID_MPEG_STREAM_PES_ID_AUDIO (integer)``
+    Audio ID for MPEG PES
+
+``V4L2_CID_MPEG_STREAM_PES_ID_VIDEO (integer)``
+    Video ID for MPEG PES
+
+.. _`v4l2-mpeg-stream-vbi-fmt`:
+
+``V4L2_CID_MPEG_STREAM_VBI_FMT (enum v4l2_mpeg_stream_vbi_fmt)``
+    Some cards can embed VBI data (e. g. Closed Caption, Teletext) into
+    the MPEG stream. This control selects whether VBI data should be
+    embedded, and if so, what embedding method should be used. The list
+    of possible VBI formats depends on the driver. The currently defined
+    VBI format types are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_STREAM_VBI_FMT_NONE``
+
+       -  No VBI in the MPEG stream
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_STREAM_VBI_FMT_IVTV``
+
+       -  VBI in private packets, IVTV format (documented in the kernel
+          sources in the file
+          ``Documentation/video4linux/cx2341x/README.vbi``)
+
+
+
+.. _`v4l2-mpeg-audio-sampling-freq`:
+
+``V4L2_CID_MPEG_AUDIO_SAMPLING_FREQ (enum v4l2_mpeg_audio_sampling_freq)``
+    MPEG Audio sampling frequency. Possible values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_AUDIO_SAMPLING_FREQ_44100``
+
+       -  44.1 kHz
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_AUDIO_SAMPLING_FREQ_48000``
+
+       -  48 kHz
+
+    -  .. row 3
+
+       -  ``V4L2_MPEG_AUDIO_SAMPLING_FREQ_32000``
+
+       -  32 kHz
+
+
+
+.. _`v4l2-mpeg-audio-encoding`:
+
+``V4L2_CID_MPEG_AUDIO_ENCODING (enum v4l2_mpeg_audio_encoding)``
+    MPEG Audio encoding. This control is specific to multiplexed MPEG
+    streams. Possible values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_AUDIO_ENCODING_LAYER_1``
+
+       -  MPEG-1/2 Layer I encoding
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_AUDIO_ENCODING_LAYER_2``
+
+       -  MPEG-1/2 Layer II encoding
+
+    -  .. row 3
+
+       -  ``V4L2_MPEG_AUDIO_ENCODING_LAYER_3``
+
+       -  MPEG-1/2 Layer III encoding
+
+    -  .. row 4
+
+       -  ``V4L2_MPEG_AUDIO_ENCODING_AAC``
+
+       -  MPEG-2/4 AAC (Advanced Audio Coding)
+
+    -  .. row 5
+
+       -  ``V4L2_MPEG_AUDIO_ENCODING_AC3``
+
+       -  AC-3 aka ATSC A/52 encoding
+
+
+
+.. _`v4l2-mpeg-audio-l1-bitrate`:
+
+``V4L2_CID_MPEG_AUDIO_L1_BITRATE (enum v4l2_mpeg_audio_l1_bitrate)``
+    MPEG-1/2 Layer I bitrate. Possible values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_AUDIO_L1_BITRATE_32K``
+
+       -  32 kbit/s
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_AUDIO_L1_BITRATE_64K``
+
+       -  64 kbit/s
+
+    -  .. row 3
+
+       -  ``V4L2_MPEG_AUDIO_L1_BITRATE_96K``
+
+       -  96 kbit/s
+
+    -  .. row 4
+
+       -  ``V4L2_MPEG_AUDIO_L1_BITRATE_128K``
+
+       -  128 kbit/s
+
+    -  .. row 5
+
+       -  ``V4L2_MPEG_AUDIO_L1_BITRATE_160K``
+
+       -  160 kbit/s
+
+    -  .. row 6
+
+       -  ``V4L2_MPEG_AUDIO_L1_BITRATE_192K``
+
+       -  192 kbit/s
+
+    -  .. row 7
+
+       -  ``V4L2_MPEG_AUDIO_L1_BITRATE_224K``
+
+       -  224 kbit/s
+
+    -  .. row 8
+
+       -  ``V4L2_MPEG_AUDIO_L1_BITRATE_256K``
+
+       -  256 kbit/s
+
+    -  .. row 9
+
+       -  ``V4L2_MPEG_AUDIO_L1_BITRATE_288K``
+
+       -  288 kbit/s
+
+    -  .. row 10
+
+       -  ``V4L2_MPEG_AUDIO_L1_BITRATE_320K``
+
+       -  320 kbit/s
+
+    -  .. row 11
+
+       -  ``V4L2_MPEG_AUDIO_L1_BITRATE_352K``
+
+       -  352 kbit/s
+
+    -  .. row 12
+
+       -  ``V4L2_MPEG_AUDIO_L1_BITRATE_384K``
+
+       -  384 kbit/s
+
+    -  .. row 13
+
+       -  ``V4L2_MPEG_AUDIO_L1_BITRATE_416K``
+
+       -  416 kbit/s
+
+    -  .. row 14
+
+       -  ``V4L2_MPEG_AUDIO_L1_BITRATE_448K``
+
+       -  448 kbit/s
+
+
+
+.. _`v4l2-mpeg-audio-l2-bitrate`:
+
+``V4L2_CID_MPEG_AUDIO_L2_BITRATE (enum v4l2_mpeg_audio_l2_bitrate)``
+    MPEG-1/2 Layer II bitrate. Possible values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_AUDIO_L2_BITRATE_32K``
+
+       -  32 kbit/s
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_AUDIO_L2_BITRATE_48K``
+
+       -  48 kbit/s
+
+    -  .. row 3
+
+       -  ``V4L2_MPEG_AUDIO_L2_BITRATE_56K``
+
+       -  56 kbit/s
+
+    -  .. row 4
+
+       -  ``V4L2_MPEG_AUDIO_L2_BITRATE_64K``
+
+       -  64 kbit/s
+
+    -  .. row 5
+
+       -  ``V4L2_MPEG_AUDIO_L2_BITRATE_80K``
+
+       -  80 kbit/s
+
+    -  .. row 6
+
+       -  ``V4L2_MPEG_AUDIO_L2_BITRATE_96K``
+
+       -  96 kbit/s
+
+    -  .. row 7
+
+       -  ``V4L2_MPEG_AUDIO_L2_BITRATE_112K``
+
+       -  112 kbit/s
+
+    -  .. row 8
+
+       -  ``V4L2_MPEG_AUDIO_L2_BITRATE_128K``
+
+       -  128 kbit/s
+
+    -  .. row 9
+
+       -  ``V4L2_MPEG_AUDIO_L2_BITRATE_160K``
+
+       -  160 kbit/s
+
+    -  .. row 10
+
+       -  ``V4L2_MPEG_AUDIO_L2_BITRATE_192K``
+
+       -  192 kbit/s
+
+    -  .. row 11
+
+       -  ``V4L2_MPEG_AUDIO_L2_BITRATE_224K``
+
+       -  224 kbit/s
+
+    -  .. row 12
+
+       -  ``V4L2_MPEG_AUDIO_L2_BITRATE_256K``
+
+       -  256 kbit/s
+
+    -  .. row 13
+
+       -  ``V4L2_MPEG_AUDIO_L2_BITRATE_320K``
+
+       -  320 kbit/s
+
+    -  .. row 14
+
+       -  ``V4L2_MPEG_AUDIO_L2_BITRATE_384K``
+
+       -  384 kbit/s
+
+
+
+.. _`v4l2-mpeg-audio-l3-bitrate`:
+
+``V4L2_CID_MPEG_AUDIO_L3_BITRATE (enum v4l2_mpeg_audio_l3_bitrate)``
+    MPEG-1/2 Layer III bitrate. Possible values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_AUDIO_L3_BITRATE_32K``
+
+       -  32 kbit/s
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_AUDIO_L3_BITRATE_40K``
+
+       -  40 kbit/s
+
+    -  .. row 3
+
+       -  ``V4L2_MPEG_AUDIO_L3_BITRATE_48K``
+
+       -  48 kbit/s
+
+    -  .. row 4
+
+       -  ``V4L2_MPEG_AUDIO_L3_BITRATE_56K``
+
+       -  56 kbit/s
+
+    -  .. row 5
+
+       -  ``V4L2_MPEG_AUDIO_L3_BITRATE_64K``
+
+       -  64 kbit/s
+
+    -  .. row 6
+
+       -  ``V4L2_MPEG_AUDIO_L3_BITRATE_80K``
+
+       -  80 kbit/s
+
+    -  .. row 7
+
+       -  ``V4L2_MPEG_AUDIO_L3_BITRATE_96K``
+
+       -  96 kbit/s
+
+    -  .. row 8
+
+       -  ``V4L2_MPEG_AUDIO_L3_BITRATE_112K``
+
+       -  112 kbit/s
+
+    -  .. row 9
+
+       -  ``V4L2_MPEG_AUDIO_L3_BITRATE_128K``
+
+       -  128 kbit/s
+
+    -  .. row 10
+
+       -  ``V4L2_MPEG_AUDIO_L3_BITRATE_160K``
+
+       -  160 kbit/s
+
+    -  .. row 11
+
+       -  ``V4L2_MPEG_AUDIO_L3_BITRATE_192K``
+
+       -  192 kbit/s
+
+    -  .. row 12
+
+       -  ``V4L2_MPEG_AUDIO_L3_BITRATE_224K``
+
+       -  224 kbit/s
+
+    -  .. row 13
+
+       -  ``V4L2_MPEG_AUDIO_L3_BITRATE_256K``
+
+       -  256 kbit/s
+
+    -  .. row 14
+
+       -  ``V4L2_MPEG_AUDIO_L3_BITRATE_320K``
+
+       -  320 kbit/s
+
+
+
+``V4L2_CID_MPEG_AUDIO_AAC_BITRATE (integer)``
+    AAC bitrate in bits per second.
+
+.. _`v4l2-mpeg-audio-ac3-bitrate`:
+
+``V4L2_CID_MPEG_AUDIO_AC3_BITRATE (enum v4l2_mpeg_audio_ac3_bitrate)``
+    AC-3 bitrate. Possible values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_AUDIO_AC3_BITRATE_32K``
+
+       -  32 kbit/s
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_AUDIO_AC3_BITRATE_40K``
+
+       -  40 kbit/s
+
+    -  .. row 3
+
+       -  ``V4L2_MPEG_AUDIO_AC3_BITRATE_48K``
+
+       -  48 kbit/s
+
+    -  .. row 4
+
+       -  ``V4L2_MPEG_AUDIO_AC3_BITRATE_56K``
+
+       -  56 kbit/s
+
+    -  .. row 5
+
+       -  ``V4L2_MPEG_AUDIO_AC3_BITRATE_64K``
+
+       -  64 kbit/s
+
+    -  .. row 6
+
+       -  ``V4L2_MPEG_AUDIO_AC3_BITRATE_80K``
+
+       -  80 kbit/s
+
+    -  .. row 7
+
+       -  ``V4L2_MPEG_AUDIO_AC3_BITRATE_96K``
+
+       -  96 kbit/s
+
+    -  .. row 8
+
+       -  ``V4L2_MPEG_AUDIO_AC3_BITRATE_112K``
+
+       -  112 kbit/s
+
+    -  .. row 9
+
+       -  ``V4L2_MPEG_AUDIO_AC3_BITRATE_128K``
+
+       -  128 kbit/s
+
+    -  .. row 10
+
+       -  ``V4L2_MPEG_AUDIO_AC3_BITRATE_160K``
+
+       -  160 kbit/s
+
+    -  .. row 11
+
+       -  ``V4L2_MPEG_AUDIO_AC3_BITRATE_192K``
+
+       -  192 kbit/s
+
+    -  .. row 12
+
+       -  ``V4L2_MPEG_AUDIO_AC3_BITRATE_224K``
+
+       -  224 kbit/s
+
+    -  .. row 13
+
+       -  ``V4L2_MPEG_AUDIO_AC3_BITRATE_256K``
+
+       -  256 kbit/s
+
+    -  .. row 14
+
+       -  ``V4L2_MPEG_AUDIO_AC3_BITRATE_320K``
+
+       -  320 kbit/s
+
+    -  .. row 15
+
+       -  ``V4L2_MPEG_AUDIO_AC3_BITRATE_384K``
+
+       -  384 kbit/s
+
+    -  .. row 16
+
+       -  ``V4L2_MPEG_AUDIO_AC3_BITRATE_448K``
+
+       -  448 kbit/s
+
+    -  .. row 17
+
+       -  ``V4L2_MPEG_AUDIO_AC3_BITRATE_512K``
+
+       -  512 kbit/s
+
+    -  .. row 18
+
+       -  ``V4L2_MPEG_AUDIO_AC3_BITRATE_576K``
+
+       -  576 kbit/s
+
+    -  .. row 19
+
+       -  ``V4L2_MPEG_AUDIO_AC3_BITRATE_640K``
+
+       -  640 kbit/s
+
+
+
+.. _`v4l2-mpeg-audio-mode`:
+
+``V4L2_CID_MPEG_AUDIO_MODE (enum v4l2_mpeg_audio_mode)``
+    MPEG Audio mode. Possible values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_AUDIO_MODE_STEREO``
+
+       -  Stereo
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_AUDIO_MODE_JOINT_STEREO``
+
+       -  Joint Stereo
+
+    -  .. row 3
+
+       -  ``V4L2_MPEG_AUDIO_MODE_DUAL``
+
+       -  Bilingual
+
+    -  .. row 4
+
+       -  ``V4L2_MPEG_AUDIO_MODE_MONO``
+
+       -  Mono
+
+
+
+.. _`v4l2-mpeg-audio-mode-extension`:
+
+``V4L2_CID_MPEG_AUDIO_MODE_EXTENSION (enum v4l2_mpeg_audio_mode_extension)``
+    Joint Stereo audio mode extension. In Layer I and II they indicate
+    which subbands are in intensity stereo. All other subbands are coded
+    in stereo. Layer III is not (yet) supported. Possible values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_4``
+
+       -  Subbands 4-31 in intensity stereo
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_8``
+
+       -  Subbands 8-31 in intensity stereo
+
+    -  .. row 3
+
+       -  ``V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_12``
+
+       -  Subbands 12-31 in intensity stereo
+
+    -  .. row 4
+
+       -  ``V4L2_MPEG_AUDIO_MODE_EXTENSION_BOUND_16``
+
+       -  Subbands 16-31 in intensity stereo
+
+
+
+.. _`v4l2-mpeg-audio-emphasis`:
+
+``V4L2_CID_MPEG_AUDIO_EMPHASIS (enum v4l2_mpeg_audio_emphasis)``
+    Audio Emphasis. Possible values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_AUDIO_EMPHASIS_NONE``
+
+       -  None
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_AUDIO_EMPHASIS_50_DIV_15_uS``
+
+       -  50/15 microsecond emphasis
+
+    -  .. row 3
+
+       -  ``V4L2_MPEG_AUDIO_EMPHASIS_CCITT_J17``
+
+       -  CCITT J.17
+
+
+
+.. _`v4l2-mpeg-audio-crc`:
+
+``V4L2_CID_MPEG_AUDIO_CRC (enum v4l2_mpeg_audio_crc)``
+    CRC method. Possible values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_AUDIO_CRC_NONE``
+
+       -  None
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_AUDIO_CRC_CRC16``
+
+       -  16 bit parity check
+
+
+
+``V4L2_CID_MPEG_AUDIO_MUTE (boolean)``
+    Mutes the audio when capturing. This is not done by muting audio
+    hardware, which can still produce a slight hiss, but in the encoder
+    itself, guaranteeing a fixed and reproducible audio bitstream. 0 =
+    unmuted, 1 = muted.
+
+.. _`v4l2-mpeg-audio-dec-playback`:
+
+``V4L2_CID_MPEG_AUDIO_DEC_PLAYBACK (enum v4l2_mpeg_audio_dec_playback)``
+    Determines how monolingual audio should be played back. Possible
+    values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_AUDIO_DEC_PLAYBACK_AUTO``
+
+       -  Automatically determines the best playback mode.
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_AUDIO_DEC_PLAYBACK_STEREO``
+
+       -  Stereo playback.
+
+    -  .. row 3
+
+       -  ``V4L2_MPEG_AUDIO_DEC_PLAYBACK_LEFT``
+
+       -  Left channel playback.
+
+    -  .. row 4
+
+       -  ``V4L2_MPEG_AUDIO_DEC_PLAYBACK_RIGHT``
+
+       -  Right channel playback.
+
+    -  .. row 5
+
+       -  ``V4L2_MPEG_AUDIO_DEC_PLAYBACK_MONO``
+
+       -  Mono playback.
+
+    -  .. row 6
+
+       -  ``V4L2_MPEG_AUDIO_DEC_PLAYBACK_SWAPPED_STEREO``
+
+       -  Stereo playback with swapped left and right channels.
+
+
+
+.. _`v4l2-mpeg-audio-dec-multilingual-playback`:
+
+``V4L2_CID_MPEG_AUDIO_DEC_MULTILINGUAL_PLAYBACK (enum v4l2_mpeg_audio_dec_playback)``
+    Determines how multilingual audio should be played back.
+
+.. _`v4l2-mpeg-video-encoding`:
+
+``V4L2_CID_MPEG_VIDEO_ENCODING (enum v4l2_mpeg_video_encoding)``
+    MPEG Video encoding method. This control is specific to multiplexed
+    MPEG streams. Possible values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_VIDEO_ENCODING_MPEG_1``
+
+       -  MPEG-1 Video encoding
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_VIDEO_ENCODING_MPEG_2``
+
+       -  MPEG-2 Video encoding
+
+    -  .. row 3
+
+       -  ``V4L2_MPEG_VIDEO_ENCODING_MPEG_4_AVC``
+
+       -  MPEG-4 AVC (H.264) Video encoding
+
+
+
+.. _`v4l2-mpeg-video-aspect`:
+
+``V4L2_CID_MPEG_VIDEO_ASPECT (enum v4l2_mpeg_video_aspect)``
+    Video aspect. Possible values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_VIDEO_ASPECT_1x1``
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_VIDEO_ASPECT_4x3``
+
+    -  .. row 3
+
+       -  ``V4L2_MPEG_VIDEO_ASPECT_16x9``
+
+    -  .. row 4
+
+       -  ``V4L2_MPEG_VIDEO_ASPECT_221x100``
+
+
+
+``V4L2_CID_MPEG_VIDEO_B_FRAMES (integer)``
+    Number of B-Frames (default 2)
+
+``V4L2_CID_MPEG_VIDEO_GOP_SIZE (integer)``
+    GOP size (default 12)
+
+``V4L2_CID_MPEG_VIDEO_GOP_CLOSURE (boolean)``
+    GOP closure (default 1)
+
+``V4L2_CID_MPEG_VIDEO_PULLDOWN (boolean)``
+    Enable 3:2 pulldown (default 0)
+
+.. _`v4l2-mpeg-video-bitrate-mode`:
+
+``V4L2_CID_MPEG_VIDEO_BITRATE_MODE (enum v4l2_mpeg_video_bitrate_mode)``
+    Video bitrate mode. Possible values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_VIDEO_BITRATE_MODE_VBR``
+
+       -  Variable bitrate
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_VIDEO_BITRATE_MODE_CBR``
+
+       -  Constant bitrate
+
+
+
+``V4L2_CID_MPEG_VIDEO_BITRATE (integer)``
+    Video bitrate in bits per second.
+
+``V4L2_CID_MPEG_VIDEO_BITRATE_PEAK (integer)``
+    Peak video bitrate in bits per second. Must be larger or equal to
+    the average video bitrate. It is ignored if the video bitrate mode
+    is set to constant bitrate.
+
+``V4L2_CID_MPEG_VIDEO_TEMPORAL_DECIMATION (integer)``
+    For every captured frame, skip this many subsequent frames (default
+    0).
+
+``V4L2_CID_MPEG_VIDEO_MUTE (boolean)``
+    "Mutes" the video to a fixed color when capturing. This is useful
+    for testing, to produce a fixed video bitstream. 0 = unmuted, 1 =
+    muted.
+
+``V4L2_CID_MPEG_VIDEO_MUTE_YUV (integer)``
+    Sets the "mute" color of the video. The supplied 32-bit integer is
+    interpreted as follows (bit 0 = least significant bit):
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  Bit 0:7
+
+       -  V chrominance information
+
+    -  .. row 2
+
+       -  Bit 8:15
+
+       -  U chrominance information
+
+    -  .. row 3
+
+       -  Bit 16:23
+
+       -  Y luminance information
+
+    -  .. row 4
+
+       -  Bit 24:31
+
+       -  Must be zero.
+
+
+
+.. _`v4l2-mpeg-video-dec-pts`:
+
+``V4L2_CID_MPEG_VIDEO_DEC_PTS (integer64)``
+    This read-only control returns the 33-bit video Presentation Time
+    Stamp as defined in ITU T-REC-H.222.0 and ISO/IEC 13818-1 of the
+    currently displayed frame. This is the same PTS as is used in
+    :ref:`VIDIOC_DECODER_CMD <vidioc-decoder-cmd>`.
+
+.. _`v4l2-mpeg-video-dec-frame`:
+
+``V4L2_CID_MPEG_VIDEO_DEC_FRAME (integer64)``
+    This read-only control returns the frame counter of the frame that
+    is currently displayed (decoded). This value is reset to 0 whenever
+    the decoder is started.
+
+``V4L2_CID_MPEG_VIDEO_DECODER_SLICE_INTERFACE (boolean)``
+    If enabled the decoder expects to receive a single slice per buffer,
+    otherwise the decoder expects a single frame in per buffer.
+    Applicable to the decoder, all codecs.
+
+``V4L2_CID_MPEG_VIDEO_H264_VUI_SAR_ENABLE (boolean)``
+    Enable writing sample aspect ratio in the Video Usability
+    Information. Applicable to the H264 encoder.
+
+.. _`v4l2-mpeg-video-h264-vui-sar-idc`:
+
+``V4L2_CID_MPEG_VIDEO_H264_VUI_SAR_IDC (enum v4l2_mpeg_video_h264_vui_sar_idc)``
+    VUI sample aspect ratio indicator for H.264 encoding. The value is
+    defined in the table E-1 in the standard. Applicable to the H264
+    encoder.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_UNSPECIFIED``
+
+       -  Unspecified
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_1x1``
+
+       -  1x1
+
+    -  .. row 3
+
+       -  ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_12x11``
+
+       -  12x11
+
+    -  .. row 4
+
+       -  ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_10x11``
+
+       -  10x11
+
+    -  .. row 5
+
+       -  ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_16x11``
+
+       -  16x11
+
+    -  .. row 6
+
+       -  ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_40x33``
+
+       -  40x33
+
+    -  .. row 7
+
+       -  ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_24x11``
+
+       -  24x11
+
+    -  .. row 8
+
+       -  ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_20x11``
+
+       -  20x11
+
+    -  .. row 9
+
+       -  ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_32x11``
+
+       -  32x11
+
+    -  .. row 10
+
+       -  ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_80x33``
+
+       -  80x33
+
+    -  .. row 11
+
+       -  ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_18x11``
+
+       -  18x11
+
+    -  .. row 12
+
+       -  ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_15x11``
+
+       -  15x11
+
+    -  .. row 13
+
+       -  ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_64x33``
+
+       -  64x33
+
+    -  .. row 14
+
+       -  ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_160x99``
+
+       -  160x99
+
+    -  .. row 15
+
+       -  ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_4x3``
+
+       -  4x3
+
+    -  .. row 16
+
+       -  ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_3x2``
+
+       -  3x2
+
+    -  .. row 17
+
+       -  ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_2x1``
+
+       -  2x1
+
+    -  .. row 18
+
+       -  ``V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_EXTENDED``
+
+       -  Extended SAR
+
+
+
+``V4L2_CID_MPEG_VIDEO_H264_VUI_EXT_SAR_WIDTH (integer)``
+    Extended sample aspect ratio width for H.264 VUI encoding.
+    Applicable to the H264 encoder.
+
+``V4L2_CID_MPEG_VIDEO_H264_VUI_EXT_SAR_HEIGHT (integer)``
+    Extended sample aspect ratio height for H.264 VUI encoding.
+    Applicable to the H264 encoder.
+
+.. _`v4l2-mpeg-video-h264-level`:
+
+``V4L2_CID_MPEG_VIDEO_H264_LEVEL (enum v4l2_mpeg_video_h264_level)``
+    The level information for the H264 video elementary stream.
+    Applicable to the H264 encoder. Possible values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_VIDEO_H264_LEVEL_1_0``
+
+       -  Level 1.0
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_VIDEO_H264_LEVEL_1B``
+
+       -  Level 1B
+
+    -  .. row 3
+
+       -  ``V4L2_MPEG_VIDEO_H264_LEVEL_1_1``
+
+       -  Level 1.1
+
+    -  .. row 4
+
+       -  ``V4L2_MPEG_VIDEO_H264_LEVEL_1_2``
+
+       -  Level 1.2
+
+    -  .. row 5
+
+       -  ``V4L2_MPEG_VIDEO_H264_LEVEL_1_3``
+
+       -  Level 1.3
+
+    -  .. row 6
+
+       -  ``V4L2_MPEG_VIDEO_H264_LEVEL_2_0``
+
+       -  Level 2.0
+
+    -  .. row 7
+
+       -  ``V4L2_MPEG_VIDEO_H264_LEVEL_2_1``
+
+       -  Level 2.1
+
+    -  .. row 8
+
+       -  ``V4L2_MPEG_VIDEO_H264_LEVEL_2_2``
+
+       -  Level 2.2
+
+    -  .. row 9
+
+       -  ``V4L2_MPEG_VIDEO_H264_LEVEL_3_0``
+
+       -  Level 3.0
+
+    -  .. row 10
+
+       -  ``V4L2_MPEG_VIDEO_H264_LEVEL_3_1``
+
+       -  Level 3.1
+
+    -  .. row 11
+
+       -  ``V4L2_MPEG_VIDEO_H264_LEVEL_3_2``
+
+       -  Level 3.2
+
+    -  .. row 12
+
+       -  ``V4L2_MPEG_VIDEO_H264_LEVEL_4_0``
+
+       -  Level 4.0
+
+    -  .. row 13
+
+       -  ``V4L2_MPEG_VIDEO_H264_LEVEL_4_1``
+
+       -  Level 4.1
+
+    -  .. row 14
+
+       -  ``V4L2_MPEG_VIDEO_H264_LEVEL_4_2``
+
+       -  Level 4.2
+
+    -  .. row 15
+
+       -  ``V4L2_MPEG_VIDEO_H264_LEVEL_5_0``
+
+       -  Level 5.0
+
+    -  .. row 16
+
+       -  ``V4L2_MPEG_VIDEO_H264_LEVEL_5_1``
+
+       -  Level 5.1
+
+
+
+.. _`v4l2-mpeg-video-mpeg4-level`:
+
+``V4L2_CID_MPEG_VIDEO_MPEG4_LEVEL (enum v4l2_mpeg_video_mpeg4_level)``
+    The level information for the MPEG4 elementary stream. Applicable to
+    the MPEG4 encoder. Possible values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_VIDEO_LEVEL_0``
+
+       -  Level 0
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_VIDEO_LEVEL_0B``
+
+       -  Level 0b
+
+    -  .. row 3
+
+       -  ``V4L2_MPEG_VIDEO_LEVEL_1``
+
+       -  Level 1
+
+    -  .. row 4
+
+       -  ``V4L2_MPEG_VIDEO_LEVEL_2``
+
+       -  Level 2
+
+    -  .. row 5
+
+       -  ``V4L2_MPEG_VIDEO_LEVEL_3``
+
+       -  Level 3
+
+    -  .. row 6
+
+       -  ``V4L2_MPEG_VIDEO_LEVEL_3B``
+
+       -  Level 3b
+
+    -  .. row 7
+
+       -  ``V4L2_MPEG_VIDEO_LEVEL_4``
+
+       -  Level 4
+
+    -  .. row 8
+
+       -  ``V4L2_MPEG_VIDEO_LEVEL_5``
+
+       -  Level 5
+
+
+
+.. _`v4l2-mpeg-video-h264-profile`:
+
+``V4L2_CID_MPEG_VIDEO_H264_PROFILE (enum v4l2_mpeg_video_h264_profile)``
+    The profile information for H264. Applicable to the H264 encoder.
+    Possible values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_VIDEO_H264_PROFILE_BASELINE``
+
+       -  Baseline profile
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_VIDEO_H264_PROFILE_CONSTRAINED_BASELINE``
+
+       -  Constrained Baseline profile
+
+    -  .. row 3
+
+       -  ``V4L2_MPEG_VIDEO_H264_PROFILE_MAIN``
+
+       -  Main profile
+
+    -  .. row 4
+
+       -  ``V4L2_MPEG_VIDEO_H264_PROFILE_EXTENDED``
+
+       -  Extended profile
+
+    -  .. row 5
+
+       -  ``V4L2_MPEG_VIDEO_H264_PROFILE_HIGH``
+
+       -  High profile
+
+    -  .. row 6
+
+       -  ``V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_10``
+
+       -  High 10 profile
+
+    -  .. row 7
+
+       -  ``V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_422``
+
+       -  High 422 profile
+
+    -  .. row 8
+
+       -  ``V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_444_PREDICTIVE``
+
+       -  High 444 Predictive profile
+
+    -  .. row 9
+
+       -  ``V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_10_INTRA``
+
+       -  High 10 Intra profile
+
+    -  .. row 10
+
+       -  ``V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_422_INTRA``
+
+       -  High 422 Intra profile
+
+    -  .. row 11
+
+       -  ``V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_444_INTRA``
+
+       -  High 444 Intra profile
+
+    -  .. row 12
+
+       -  ``V4L2_MPEG_VIDEO_H264_PROFILE_CAVLC_444_INTRA``
+
+       -  CAVLC 444 Intra profile
+
+    -  .. row 13
+
+       -  ``V4L2_MPEG_VIDEO_H264_PROFILE_SCALABLE_BASELINE``
+
+       -  Scalable Baseline profile
+
+    -  .. row 14
+
+       -  ``V4L2_MPEG_VIDEO_H264_PROFILE_SCALABLE_HIGH``
+
+       -  Scalable High profile
+
+    -  .. row 15
+
+       -  ``V4L2_MPEG_VIDEO_H264_PROFILE_SCALABLE_HIGH_INTRA``
+
+       -  Scalable High Intra profile
+
+    -  .. row 16
+
+       -  ``V4L2_MPEG_VIDEO_H264_PROFILE_STEREO_HIGH``
+
+       -  Stereo High profile
+
+    -  .. row 17
+
+       -  ``V4L2_MPEG_VIDEO_H264_PROFILE_MULTIVIEW_HIGH``
+
+       -  Multiview High profile
+
+
+
+.. _`v4l2-mpeg-video-mpeg4-profile`:
+
+``V4L2_CID_MPEG_VIDEO_MPEG4_PROFILE (enum v4l2_mpeg_video_mpeg4_profile)``
+    The profile information for MPEG4. Applicable to the MPEG4 encoder.
+    Possible values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_VIDEO_PROFILE_SIMPLE``
+
+       -  Simple profile
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_VIDEO_PROFILE_ADVANCED_SIMPLE``
+
+       -  Advanced Simple profile
+
+    -  .. row 3
+
+       -  ``V4L2_MPEG_VIDEO_PROFILE_CORE``
+
+       -  Core profile
+
+    -  .. row 4
+
+       -  ``V4L2_MPEG_VIDEO_PROFILE_SIMPLE_SCALABLE``
+
+       -  Simple Scalable profile
+
+    -  .. row 5
+
+       -  ``V4L2_MPEG_VIDEO_PROFILE_ADVANCED_CODING_EFFICIENCY``
+
+       -  
+
+
+
+``V4L2_CID_MPEG_VIDEO_MAX_REF_PIC (integer)``
+    The maximum number of reference pictures used for encoding.
+    Applicable to the encoder.
+
+.. _`v4l2-mpeg-video-multi-slice-mode`:
+
+``V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MODE (enum v4l2_mpeg_video_multi_slice_mode)``
+    Determines how the encoder should handle division of frame into
+    slices. Applicable to the encoder. Possible values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_VIDEO_MULTI_SLICE_MODE_SINGLE``
+
+       -  Single slice per frame.
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_VIDEO_MULTI_SLICE_MODE_MAX_MB``
+
+       -  Multiple slices with set maximum number of macroblocks per slice.
+
+    -  .. row 3
+
+       -  ``V4L2_MPEG_VIDEO_MULTI_SLICE_MODE_MAX_BYTES``
+
+       -  Multiple slice with set maximum size in bytes per slice.
+
+
+
+``V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MAX_MB (integer)``
+    The maximum number of macroblocks in a slice. Used when
+    ``V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MODE`` is set to
+    ``V4L2_MPEG_VIDEO_MULTI_SLICE_MODE_MAX_MB``. Applicable to the
+    encoder.
+
+``V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MAX_BYTES (integer)``
+    The maximum size of a slice in bytes. Used when
+    ``V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MODE`` is set to
+    ``V4L2_MPEG_VIDEO_MULTI_SLICE_MODE_MAX_BYTES``. Applicable to the
+    encoder.
+
+.. _`v4l2-mpeg-video-h264-loop-filter-mode`:
+
+``V4L2_CID_MPEG_VIDEO_H264_LOOP_FILTER_MODE (enum v4l2_mpeg_video_h264_loop_filter_mode)``
+    Loop filter mode for H264 encoder. Possible values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_VIDEO_H264_LOOP_FILTER_MODE_ENABLED``
+
+       -  Loop filter is enabled.
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_VIDEO_H264_LOOP_FILTER_MODE_DISABLED``
+
+       -  Loop filter is disabled.
+
+    -  .. row 3
+
+       -  ``V4L2_MPEG_VIDEO_H264_LOOP_FILTER_MODE_DISABLED_AT_SLICE_BOUNDARY``
+
+       -  Loop filter is disabled at the slice boundary.
+
+
+
+``V4L2_CID_MPEG_VIDEO_H264_LOOP_FILTER_ALPHA (integer)``
+    Loop filter alpha coefficient, defined in the H264 standard.
+    Applicable to the H264 encoder.
+
+``V4L2_CID_MPEG_VIDEO_H264_LOOP_FILTER_BETA (integer)``
+    Loop filter beta coefficient, defined in the H264 standard.
+    Applicable to the H264 encoder.
+
+.. _`v4l2-mpeg-video-h264-entropy-mode`:
+
+``V4L2_CID_MPEG_VIDEO_H264_ENTROPY_MODE (enum v4l2_mpeg_video_h264_entropy_mode)``
+    Entropy coding mode for H264 - CABAC/CAVALC. Applicable to the H264
+    encoder. Possible values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_VIDEO_H264_ENTROPY_MODE_CAVLC``
+
+       -  Use CAVLC entropy coding.
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_VIDEO_H264_ENTROPY_MODE_CABAC``
+
+       -  Use CABAC entropy coding.
+
+
+
+``V4L2_CID_MPEG_VIDEO_H264_8X8_TRANSFORM (boolean)``
+    Enable 8X8 transform for H264. Applicable to the H264 encoder.
+
+``V4L2_CID_MPEG_VIDEO_CYCLIC_INTRA_REFRESH_MB (integer)``
+    Cyclic intra macroblock refresh. This is the number of continuous
+    macroblocks refreshed every frame. Each frame a successive set of
+    macroblocks is refreshed until the cycle completes and starts from
+    the top of the frame. Applicable to H264, H263 and MPEG4 encoder.
+
+``V4L2_CID_MPEG_VIDEO_FRAME_RC_ENABLE (boolean)``
+    Frame level rate control enable. If this control is disabled then
+    the quantization parameter for each frame type is constant and set
+    with appropriate controls (e.g.
+    ``V4L2_CID_MPEG_VIDEO_H263_I_FRAME_QP``). If frame rate control is
+    enabled then quantization parameter is adjusted to meet the chosen
+    bitrate. Minimum and maximum value for the quantization parameter
+    can be set with appropriate controls (e.g.
+    ``V4L2_CID_MPEG_VIDEO_H263_MIN_QP``). Applicable to encoders.
+
+``V4L2_CID_MPEG_VIDEO_MB_RC_ENABLE (boolean)``
+    Macroblock level rate control enable. Applicable to the MPEG4 and
+    H264 encoders.
+
+``V4L2_CID_MPEG_VIDEO_MPEG4_QPEL (boolean)``
+    Quarter pixel motion estimation for MPEG4. Applicable to the MPEG4
+    encoder.
+
+``V4L2_CID_MPEG_VIDEO_H263_I_FRAME_QP (integer)``
+    Quantization parameter for an I frame for H263. Valid range: from 1
+    to 31.
+
+``V4L2_CID_MPEG_VIDEO_H263_MIN_QP (integer)``
+    Minimum quantization parameter for H263. Valid range: from 1 to 31.
+
+``V4L2_CID_MPEG_VIDEO_H263_MAX_QP (integer)``
+    Maximum quantization parameter for H263. Valid range: from 1 to 31.
+
+``V4L2_CID_MPEG_VIDEO_H263_P_FRAME_QP (integer)``
+    Quantization parameter for an P frame for H263. Valid range: from 1
+    to 31.
+
+``V4L2_CID_MPEG_VIDEO_H263_B_FRAME_QP (integer)``
+    Quantization parameter for an B frame for H263. Valid range: from 1
+    to 31.
+
+``V4L2_CID_MPEG_VIDEO_H264_I_FRAME_QP (integer)``
+    Quantization parameter for an I frame for H264. Valid range: from 0
+    to 51.
+
+``V4L2_CID_MPEG_VIDEO_H264_MIN_QP (integer)``
+    Minimum quantization parameter for H264. Valid range: from 0 to 51.
+
+``V4L2_CID_MPEG_VIDEO_H264_MAX_QP (integer)``
+    Maximum quantization parameter for H264. Valid range: from 0 to 51.
+
+``V4L2_CID_MPEG_VIDEO_H264_P_FRAME_QP (integer)``
+    Quantization parameter for an P frame for H264. Valid range: from 0
+    to 51.
+
+``V4L2_CID_MPEG_VIDEO_H264_B_FRAME_QP (integer)``
+    Quantization parameter for an B frame for H264. Valid range: from 0
+    to 51.
+
+``V4L2_CID_MPEG_VIDEO_MPEG4_I_FRAME_QP (integer)``
+    Quantization parameter for an I frame for MPEG4. Valid range: from 1
+    to 31.
+
+``V4L2_CID_MPEG_VIDEO_MPEG4_MIN_QP (integer)``
+    Minimum quantization parameter for MPEG4. Valid range: from 1 to 31.
+
+``V4L2_CID_MPEG_VIDEO_MPEG4_MAX_QP (integer)``
+    Maximum quantization parameter for MPEG4. Valid range: from 1 to 31.
+
+``V4L2_CID_MPEG_VIDEO_MPEG4_P_FRAME_QP (integer)``
+    Quantization parameter for an P frame for MPEG4. Valid range: from 1
+    to 31.
+
+``V4L2_CID_MPEG_VIDEO_MPEG4_B_FRAME_QP (integer)``
+    Quantization parameter for an B frame for MPEG4. Valid range: from 1
+    to 31.
+
+``V4L2_CID_MPEG_VIDEO_VBV_SIZE (integer)``
+    The Video Buffer Verifier size in kilobytes, it is used as a
+    limitation of frame skip. The VBV is defined in the standard as a
+    mean to verify that the produced stream will be successfully
+    decoded. The standard describes it as "Part of a hypothetical
+    decoder that is conceptually connected to the output of the encoder.
+    Its purpose is to provide a constraint on the variability of the
+    data rate that an encoder or editing process may produce.".
+    Applicable to the MPEG1, MPEG2, MPEG4 encoders.
+
+.. _`v4l2-mpeg-video-vbv-delay`:
+
+``V4L2_CID_MPEG_VIDEO_VBV_DELAY (integer)``
+    Sets the initial delay in milliseconds for VBV buffer control.
+
+.. _`v4l2-mpeg-video-hor-search-range`:
+
+``V4L2_CID_MPEG_VIDEO_MV_H_SEARCH_RANGE (integer)``
+    Horizontal search range defines maximum horizontal search area in
+    pixels to search and match for the present Macroblock (MB) in the
+    reference picture. This V4L2 control macro is used to set horizontal
+    search range for motion estimation module in video encoder.
+
+.. _`v4l2-mpeg-video-vert-search-range`:
+
+``V4L2_CID_MPEG_VIDEO_MV_V_SEARCH_RANGE (integer)``
+    Vertical search range defines maximum vertical search area in pixels
+    to search and match for the present Macroblock (MB) in the reference
+    picture. This V4L2 control macro is used to set vertical search
+    range for motion estimation module in video encoder.
+
+.. _`v4l2-mpeg-video-force-key-frame`:
+
+``V4L2_CID_MPEG_VIDEO_FORCE_KEY_FRAME (button)``
+    Force a key frame for the next queued buffer. Applicable to
+    encoders. This is a general, codec-agnostic keyframe control.
+
+``V4L2_CID_MPEG_VIDEO_H264_CPB_SIZE (integer)``
+    The Coded Picture Buffer size in kilobytes, it is used as a
+    limitation of frame skip. The CPB is defined in the H264 standard as
+    a mean to verify that the produced stream will be successfully
+    decoded. Applicable to the H264 encoder.
+
+``V4L2_CID_MPEG_VIDEO_H264_I_PERIOD (integer)``
+    Period between I-frames in the open GOP for H264. In case of an open
+    GOP this is the period between two I-frames. The period between IDR
+    (Instantaneous Decoding Refresh) frames is taken from the GOP_SIZE
+    control. An IDR frame, which stands for Instantaneous Decoding
+    Refresh is an I-frame after which no prior frames are referenced.
+    This means that a stream can be restarted from an IDR frame without
+    the need to store or decode any previous frames. Applicable to the
+    H264 encoder.
+
+.. _`v4l2-mpeg-video-header-mode`:
+
+``V4L2_CID_MPEG_VIDEO_HEADER_MODE (enum v4l2_mpeg_video_header_mode)``
+    Determines whether the header is returned as the first buffer or is
+    it returned together with the first frame. Applicable to encoders.
+    Possible values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_VIDEO_HEADER_MODE_SEPARATE``
+
+       -  The stream header is returned separately in the first buffer.
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_VIDEO_HEADER_MODE_JOINED_WITH_1ST_FRAME``
+
+       -  The stream header is returned together with the first encoded
+          frame.
+
+
+
+``V4L2_CID_MPEG_VIDEO_REPEAT_SEQ_HEADER (boolean)``
+    Repeat the video sequence headers. Repeating these headers makes
+    random access to the video stream easier. Applicable to the MPEG1, 2
+    and 4 encoder.
+
+``V4L2_CID_MPEG_VIDEO_DECODER_MPEG4_DEBLOCK_FILTER (boolean)``
+    Enabled the deblocking post processing filter for MPEG4 decoder.
+    Applicable to the MPEG4 decoder.
+
+``V4L2_CID_MPEG_VIDEO_MPEG4_VOP_TIME_RES (integer)``
+    vop_time_increment_resolution value for MPEG4. Applicable to the
+    MPEG4 encoder.
+
+``V4L2_CID_MPEG_VIDEO_MPEG4_VOP_TIME_INC (integer)``
+    vop_time_increment value for MPEG4. Applicable to the MPEG4
+    encoder.
+
+``V4L2_CID_MPEG_VIDEO_H264_SEI_FRAME_PACKING (boolean)``
+    Enable generation of frame packing supplemental enhancement
+    information in the encoded bitstream. The frame packing SEI message
+    contains the arrangement of L and R planes for 3D viewing.
+    Applicable to the H264 encoder.
+
+``V4L2_CID_MPEG_VIDEO_H264_SEI_FP_CURRENT_FRAME_0 (boolean)``
+    Sets current frame as frame0 in frame packing SEI. Applicable to the
+    H264 encoder.
+
+.. _`v4l2-mpeg-video-h264-sei-fp-arrangement-type`:
+
+``V4L2_CID_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE (enum v4l2_mpeg_video_h264_sei_fp_arrangement_type)``
+    Frame packing arrangement type for H264 SEI. Applicable to the H264
+    encoder. Possible values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_CHEKERBOARD``
+
+       -  Pixels are alternatively from L and R.
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_COLUMN``
+
+       -  L and R are interlaced by column.
+
+    -  .. row 3
+
+       -  ``V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_ROW``
+
+       -  L and R are interlaced by row.
+
+    -  .. row 4
+
+       -  ``V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_SIDE_BY_SIDE``
+
+       -  L is on the left, R on the right.
+
+    -  .. row 5
+
+       -  ``V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_TOP_BOTTOM``
+
+       -  L is on top, R on bottom.
+
+    -  .. row 6
+
+       -  ``V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_TEMPORAL``
+
+       -  One view per frame.
+
+
+
+``V4L2_CID_MPEG_VIDEO_H264_FMO (boolean)``
+    Enables flexible macroblock ordering in the encoded bitstream. It is
+    a technique used for restructuring the ordering of macroblocks in
+    pictures. Applicable to the H264 encoder.
+
+.. _`v4l2-mpeg-video-h264-fmo-map-type`:
+
+``V4L2_CID_MPEG_VIDEO_H264_FMO_MAP_TYPE (enum v4l2_mpeg_video_h264_fmo_map_type)``
+    When using FMO, the map type divides the image in different scan
+    patterns of macroblocks. Applicable to the H264 encoder. Possible
+    values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_INTERLEAVED_SLICES``
+
+       -  Slices are interleaved one after other with macroblocks in run
+          length order.
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_SCATTERED_SLICES``
+
+       -  Scatters the macroblocks based on a mathematical function known to
+          both encoder and decoder.
+
+    -  .. row 3
+
+       -  ``V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_FOREGROUND_WITH_LEFT_OVER``
+
+       -  Macroblocks arranged in rectangular areas or regions of interest.
+
+    -  .. row 4
+
+       -  ``V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_BOX_OUT``
+
+       -  Slice groups grow in a cyclic way from centre to outwards.
+
+    -  .. row 5
+
+       -  ``V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_RASTER_SCAN``
+
+       -  Slice groups grow in raster scan pattern from left to right.
+
+    -  .. row 6
+
+       -  ``V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_WIPE_SCAN``
+
+       -  Slice groups grow in wipe scan pattern from top to bottom.
+
+    -  .. row 7
+
+       -  ``V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_EXPLICIT``
+
+       -  User defined map type.
+
+
+
+``V4L2_CID_MPEG_VIDEO_H264_FMO_SLICE_GROUP (integer)``
+    Number of slice groups in FMO. Applicable to the H264 encoder.
+
+.. _`v4l2-mpeg-video-h264-fmo-change-direction`:
+
+``V4L2_CID_MPEG_VIDEO_H264_FMO_CHANGE_DIRECTION (enum v4l2_mpeg_video_h264_fmo_change_dir)``
+    Specifies a direction of the slice group change for raster and wipe
+    maps. Applicable to the H264 encoder. Possible values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_VIDEO_H264_FMO_CHANGE_DIR_RIGHT``
+
+       -  Raster scan or wipe right.
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_VIDEO_H264_FMO_CHANGE_DIR_LEFT``
+
+       -  Reverse raster scan or wipe left.
+
+
+
+``V4L2_CID_MPEG_VIDEO_H264_FMO_CHANGE_RATE (integer)``
+    Specifies the size of the first slice group for raster and wipe map.
+    Applicable to the H264 encoder.
+
+``V4L2_CID_MPEG_VIDEO_H264_FMO_RUN_LENGTH (integer)``
+    Specifies the number of consecutive macroblocks for the interleaved
+    map. Applicable to the H264 encoder.
+
+``V4L2_CID_MPEG_VIDEO_H264_ASO (boolean)``
+    Enables arbitrary slice ordering in encoded bitstream. Applicable to
+    the H264 encoder.
+
+``V4L2_CID_MPEG_VIDEO_H264_ASO_SLICE_ORDER (integer)``
+    Specifies the slice order in ASO. Applicable to the H264 encoder.
+    The supplied 32-bit integer is interpreted as follows (bit 0 = least
+    significant bit):
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  Bit 0:15
+
+       -  Slice ID
+
+    -  .. row 2
+
+       -  Bit 16:32
+
+       -  Slice position or order
+
+
+
+``V4L2_CID_MPEG_VIDEO_H264_HIERARCHICAL_CODING (boolean)``
+    Enables H264 hierarchical coding. Applicable to the H264 encoder.
+
+.. _`v4l2-mpeg-video-h264-hierarchical-coding-type`:
+
+``V4L2_CID_MPEG_VIDEO_H264_HIERARCHICAL_CODING_TYPE (enum v4l2_mpeg_video_h264_hierarchical_coding_type)``
+    Specifies the hierarchical coding type. Applicable to the H264
+    encoder. Possible values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_VIDEO_H264_HIERARCHICAL_CODING_B``
+
+       -  Hierarchical B coding.
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_VIDEO_H264_HIERARCHICAL_CODING_P``
+
+       -  Hierarchical P coding.
+
+
+
+``V4L2_CID_MPEG_VIDEO_H264_HIERARCHICAL_CODING_LAYER (integer)``
+    Specifies the number of hierarchical coding layers. Applicable to
+    the H264 encoder.
+
+``V4L2_CID_MPEG_VIDEO_H264_HIERARCHICAL_CODING_LAYER_QP (integer)``
+    Specifies a user defined QP for each layer. Applicable to the H264
+    encoder. The supplied 32-bit integer is interpreted as follows (bit
+    0 = least significant bit):
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  Bit 0:15
+
+       -  QP value
+
+    -  .. row 2
+
+       -  Bit 16:32
+
+       -  Layer number
+
+
+
+
+MFC 5.1 MPEG Controls
+---------------------
+
+The following MPEG class controls deal with MPEG decoding and encoding
+settings that are specific to the Multi Format Codec 5.1 device present
+in the S5P family of SoCs by Samsung.
+
+
+.. _mfc51-control-id:
+
+MFC 5.1 Control IDs
+^^^^^^^^^^^^^^^^^^^
+
+``V4L2_CID_MPEG_MFC51_VIDEO_DECODER_H264_DISPLAY_DELAY_ENABLE (boolean)``
+    If the display delay is enabled then the decoder is forced to return
+    a CAPTURE buffer (decoded frame) after processing a certain number
+    of OUTPUT buffers. The delay can be set through
+    ``V4L2_CID_MPEG_MFC51_VIDEO_DECODER_H264_DISPLAY_DELAY``. This
+    feature can be used for example for generating thumbnails of videos.
+    Applicable to the H264 decoder.
+
+``V4L2_CID_MPEG_MFC51_VIDEO_DECODER_H264_DISPLAY_DELAY (integer)``
+    Display delay value for H264 decoder. The decoder is forced to
+    return a decoded frame after the set 'display delay' number of
+    frames. If this number is low it may result in frames returned out
+    of dispaly order, in addition the hardware may still be using the
+    returned buffer as a reference picture for subsequent frames.
+
+``V4L2_CID_MPEG_MFC51_VIDEO_H264_NUM_REF_PIC_FOR_P (integer)``
+    The number of reference pictures used for encoding a P picture.
+    Applicable to the H264 encoder.
+
+``V4L2_CID_MPEG_MFC51_VIDEO_PADDING (boolean)``
+    Padding enable in the encoder - use a color instead of repeating
+    border pixels. Applicable to encoders.
+
+``V4L2_CID_MPEG_MFC51_VIDEO_PADDING_YUV (integer)``
+    Padding color in the encoder. Applicable to encoders. The supplied
+    32-bit integer is interpreted as follows (bit 0 = least significant
+    bit):
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  Bit 0:7
+
+       -  V chrominance information
+
+    -  .. row 2
+
+       -  Bit 8:15
+
+       -  U chrominance information
+
+    -  .. row 3
+
+       -  Bit 16:23
+
+       -  Y luminance information
+
+    -  .. row 4
+
+       -  Bit 24:31
+
+       -  Must be zero.
+
+
+
+``V4L2_CID_MPEG_MFC51_VIDEO_RC_REACTION_COEFF (integer)``
+    Reaction coefficient for MFC rate control. Applicable to encoders.
+
+    Note 1: Valid only when the frame level RC is enabled.
+
+    Note 2: For tight CBR, this field must be small (ex. 2 ~ 10). For
+    VBR, this field must be large (ex. 100 ~ 1000).
+
+    Note 3: It is not recommended to use the greater number than
+    FRAME_RATE * (10^9 / BIT_RATE).
+
+``V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_DARK (boolean)``
+    Adaptive rate control for dark region. Valid only when H.264 and
+    macroblock level RC is enabled
+    (``V4L2_CID_MPEG_VIDEO_MB_RC_ENABLE``). Applicable to the H264
+    encoder.
+
+``V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_SMOOTH (boolean)``
+    Adaptive rate control for smooth region. Valid only when H.264 and
+    macroblock level RC is enabled
+    (``V4L2_CID_MPEG_VIDEO_MB_RC_ENABLE``). Applicable to the H264
+    encoder.
+
+``V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_STATIC (boolean)``
+    Adaptive rate control for static region. Valid only when H.264 and
+    macroblock level RC is enabled
+    (``V4L2_CID_MPEG_VIDEO_MB_RC_ENABLE``). Applicable to the H264
+    encoder.
+
+``V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_ACTIVITY (boolean)``
+    Adaptive rate control for activity region. Valid only when H.264 and
+    macroblock level RC is enabled
+    (``V4L2_CID_MPEG_VIDEO_MB_RC_ENABLE``). Applicable to the H264
+    encoder.
+
+.. _`v4l2-mpeg-mfc51-video-frame-skip-mode`:
+
+``V4L2_CID_MPEG_MFC51_VIDEO_FRAME_SKIP_MODE (enum v4l2_mpeg_mfc51_video_frame_skip_mode)``
+    Indicates in what conditions the encoder should skip frames. If
+    encoding a frame would cause the encoded stream to be larger then a
+    chosen data limit then the frame will be skipped. Possible values
+    are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_MFC51_FRAME_SKIP_MODE_DISABLED``
+
+       -  Frame skip mode is disabled.
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_MFC51_FRAME_SKIP_MODE_LEVEL_LIMIT``
+
+       -  Frame skip mode enabled and buffer limit is set by the chosen
+          level and is defined by the standard.
+
+    -  .. row 3
+
+       -  ``V4L2_MPEG_MFC51_FRAME_SKIP_MODE_BUF_LIMIT``
+
+       -  Frame skip mode enabled and buffer limit is set by the VBV
+          (MPEG1/2/4) or CPB (H264) buffer size control.
+
+
+
+``V4L2_CID_MPEG_MFC51_VIDEO_RC_FIXED_TARGET_BIT (integer)``
+    Enable rate-control with fixed target bit. If this setting is
+    enabled, then the rate control logic of the encoder will calculate
+    the average bitrate for a GOP and keep it below or equal the set
+    bitrate target. Otherwise the rate control logic calculates the
+    overall average bitrate for the stream and keeps it below or equal
+    to the set bitrate. In the first case the average bitrate for the
+    whole stream will be smaller then the set bitrate. This is caused
+    because the average is calculated for smaller number of frames, on
+    the other hand enabling this setting will ensure that the stream
+    will meet tight bandwidth constraints. Applicable to encoders.
+
+.. _`v4l2-mpeg-mfc51-video-force-frame-type`:
+
+``V4L2_CID_MPEG_MFC51_VIDEO_FORCE_FRAME_TYPE (enum v4l2_mpeg_mfc51_video_force_frame_type)``
+    Force a frame type for the next queued buffer. Applicable to
+    encoders. Possible values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_MFC51_FORCE_FRAME_TYPE_DISABLED``
+
+       -  Forcing a specific frame type disabled.
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_MFC51_FORCE_FRAME_TYPE_I_FRAME``
+
+       -  Force an I-frame.
+
+    -  .. row 3
+
+       -  ``V4L2_MPEG_MFC51_FORCE_FRAME_TYPE_NOT_CODED``
+
+       -  Force a non-coded frame.
+
+
+
+
+CX2341x MPEG Controls
+---------------------
+
+The following MPEG class controls deal with MPEG encoding settings that
+are specific to the Conexant CX23415 and CX23416 MPEG encoding chips.
+
+
+.. _cx2341x-control-id:
+
+CX2341x Control IDs
+^^^^^^^^^^^^^^^^^^^
+
+.. _`v4l2-mpeg-cx2341x-video-spatial-filter-mode`:
+
+``V4L2_CID_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE (enum v4l2_mpeg_cx2341x_video_spatial_filter_mode)``
+    Sets the Spatial Filter mode (default ``MANUAL``). Possible values
+    are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE_MANUAL``
+
+       -  Choose the filter manually
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE_AUTO``
+
+       -  Choose the filter automatically
+
+
+
+``V4L2_CID_MPEG_CX2341X_VIDEO_SPATIAL_FILTER (integer (0-15))``
+    The setting for the Spatial Filter. 0 = off, 15 = maximum. (Default
+    is 0.)
+
+.. _`luma-spatial-filter-type`:
+
+``V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE (enum v4l2_mpeg_cx2341x_video_luma_spatial_filter_type)``
+    Select the algorithm to use for the Luma Spatial Filter (default
+    ``1D_HOR``). Possible values:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_OFF``
+
+       -  No filter
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_1D_HOR``
+
+       -  One-dimensional horizontal
+
+    -  .. row 3
+
+       -  ``V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_1D_VERT``
+
+       -  One-dimensional vertical
+
+    -  .. row 4
+
+       -  ``V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_2D_HV_SEPARABLE``
+
+       -  Two-dimensional separable
+
+    -  .. row 5
+
+       -  ``V4L2_MPEG_CX2341X_VIDEO_LUMA_SPATIAL_FILTER_TYPE_2D_SYM_NON_SEPARABLE``
+
+       -  Two-dimensional symmetrical non-separable
+
+
+
+.. _`chroma-spatial-filter-type`:
+
+``V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE (enum v4l2_mpeg_cx2341x_video_chroma_spatial_filter_type)``
+    Select the algorithm for the Chroma Spatial Filter (default
+    ``1D_HOR``). Possible values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE_OFF``
+
+       -  No filter
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_CX2341X_VIDEO_CHROMA_SPATIAL_FILTER_TYPE_1D_HOR``
+
+       -  One-dimensional horizontal
+
+
+
+.. _`v4l2-mpeg-cx2341x-video-temporal-filter-mode`:
+
+``V4L2_CID_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE (enum v4l2_mpeg_cx2341x_video_temporal_filter_mode)``
+    Sets the Temporal Filter mode (default ``MANUAL``). Possible values
+    are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE_MANUAL``
+
+       -  Choose the filter manually
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER_MODE_AUTO``
+
+       -  Choose the filter automatically
+
+
+
+``V4L2_CID_MPEG_CX2341X_VIDEO_TEMPORAL_FILTER (integer (0-31))``
+    The setting for the Temporal Filter. 0 = off, 31 = maximum. (Default
+    is 8 for full-scale capturing and 0 for scaled capturing.)
+
+.. _`v4l2-mpeg-cx2341x-video-median-filter-type`:
+
+``V4L2_CID_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE (enum v4l2_mpeg_cx2341x_video_median_filter_type)``
+    Median Filter Type (default ``OFF``). Possible values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_OFF``
+
+       -  No filter
+
+    -  .. row 2
+
+       -  ``V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_HOR``
+
+       -  Horizontal filter
+
+    -  .. row 3
+
+       -  ``V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_VERT``
+
+       -  Vertical filter
+
+    -  .. row 4
+
+       -  ``V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_HOR_VERT``
+
+       -  Horizontal and vertical filter
+
+    -  .. row 5
+
+       -  ``V4L2_MPEG_CX2341X_VIDEO_MEDIAN_FILTER_TYPE_DIAG``
+
+       -  Diagonal filter
+
+
+
+``V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_MEDIAN_FILTER_BOTTOM (integer (0-255))``
+    Threshold above which the luminance median filter is enabled
+    (default 0)
+
+``V4L2_CID_MPEG_CX2341X_VIDEO_LUMA_MEDIAN_FILTER_TOP (integer (0-255))``
+    Threshold below which the luminance median filter is enabled
+    (default 255)
+
+``V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_MEDIAN_FILTER_BOTTOM (integer (0-255))``
+    Threshold above which the chroma median filter is enabled (default
+    0)
+
+``V4L2_CID_MPEG_CX2341X_VIDEO_CHROMA_MEDIAN_FILTER_TOP (integer (0-255))``
+    Threshold below which the chroma median filter is enabled (default
+    255)
+
+``V4L2_CID_MPEG_CX2341X_STREAM_INSERT_NAV_PACKETS (boolean)``
+    The CX2341X MPEG encoder can insert one empty MPEG-2 PES packet into
+    the stream between every four video frames. The packet size is 2048
+    bytes, including the packet_start_code_prefix and stream_id
+    fields. The stream_id is 0xBF (private stream 2). The payload
+    consists of 0x00 bytes, to be filled in by the application. 0 = do
+    not insert, 1 = insert packets.
+
+
+VPX Control Reference
+---------------------
+
+The VPX controls include controls for encoding parameters of VPx video
+codec.
+
+
+.. _vpx-control-id:
+
+VPX Control IDs
+^^^^^^^^^^^^^^^
+
+.. _`v4l2-vpx-num-partitions`:
+
+``V4L2_CID_MPEG_VIDEO_VPX_NUM_PARTITIONS (enum v4l2_vp8_num_partitions)``
+    The number of token partitions to use in VP8 encoder. Possible
+    values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_CID_MPEG_VIDEO_VPX_1_PARTITION``
+
+       -  1 coefficient partition
+
+    -  .. row 2
+
+       -  ``V4L2_CID_MPEG_VIDEO_VPX_2_PARTITIONS``
+
+       -  2 coefficient partitions
+
+    -  .. row 3
+
+       -  ``V4L2_CID_MPEG_VIDEO_VPX_4_PARTITIONS``
+
+       -  4 coefficient partitions
+
+    -  .. row 4
+
+       -  ``V4L2_CID_MPEG_VIDEO_VPX_8_PARTITIONS``
+
+       -  8 coefficient partitions
+
+
+
+``V4L2_CID_MPEG_VIDEO_VPX_IMD_DISABLE_4X4 (boolean)``
+    Setting this prevents intra 4x4 mode in the intra mode decision.
+
+.. _`v4l2-vpx-num-ref-frames`:
+
+``V4L2_CID_MPEG_VIDEO_VPX_NUM_REF_FRAMES (enum v4l2_vp8_num_ref_frames)``
+    The number of reference pictures for encoding P frames. Possible
+    values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_CID_MPEG_VIDEO_VPX_1_REF_FRAME``
+
+       -  Last encoded frame will be searched
+
+    -  .. row 2
+
+       -  ``V4L2_CID_MPEG_VIDEO_VPX_2_REF_FRAME``
+
+       -  Two frames will be searched among the last encoded frame, the
+          golden frame and the alternate reference (altref) frame. The
+          encoder implementation will decide which two are chosen.
+
+    -  .. row 3
+
+       -  ``V4L2_CID_MPEG_VIDEO_VPX_3_REF_FRAME``
+
+       -  The last encoded frame, the golden frame and the altref frame will
+          be searched.
+
+
+
+``V4L2_CID_MPEG_VIDEO_VPX_FILTER_LEVEL (integer)``
+    Indicates the loop filter level. The adjustment of the loop filter
+    level is done via a delta value against a baseline loop filter
+    value.
+
+``V4L2_CID_MPEG_VIDEO_VPX_FILTER_SHARPNESS (integer)``
+    This parameter affects the loop filter. Anything above zero weakens
+    the deblocking effect on the loop filter.
+
+``V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_REF_PERIOD (integer)``
+    Sets the refresh period for the golden frame. The period is defined
+    in number of frames. For a value of 'n', every nth frame starting
+    from the first key frame will be taken as a golden frame. For eg.
+    for encoding sequence of 0, 1, 2, 3, 4, 5, 6, 7 where the golden
+    frame refresh period is set as 4, the frames 0, 4, 8 etc will be
+    taken as the golden frames as frame 0 is always a key frame.
+
+.. _`v4l2-vpx-golden-frame-sel`:
+
+``V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_SEL (enum v4l2_vp8_golden_frame_sel)``
+    Selects the golden frame for encoding. Possible values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_USE_PREV``
+
+       -  Use the (n-2)th frame as a golden frame, current frame index being
+          'n'.
+
+    -  .. row 2
+
+       -  ``V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_USE_REF_PERIOD``
+
+       -  Use the previous specific frame indicated by
+          V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_REF_PERIOD as a
+          golden frame.
+
+
+
+``V4L2_CID_MPEG_VIDEO_VPX_MIN_QP (integer)``
+    Minimum quantization parameter for VP8.
+
+``V4L2_CID_MPEG_VIDEO_VPX_MAX_QP (integer)``
+    Maximum quantization parameter for VP8.
+
+``V4L2_CID_MPEG_VIDEO_VPX_I_FRAME_QP (integer)``
+    Quantization parameter for an I frame for VP8.
+
+``V4L2_CID_MPEG_VIDEO_VPX_P_FRAME_QP (integer)``
+    Quantization parameter for a P frame for VP8.
+
+``V4L2_CID_MPEG_VIDEO_VPX_PROFILE (integer)``
+    Select the desired profile for VPx encoder. Acceptable values are 0,
+    1, 2 and 3 corresponding to encoder profiles 0, 1, 2 and 3.
+
+
+.. _camera-controls:
+
+Camera Control Reference
+========================
+
+The Camera class includes controls for mechanical (or equivalent
+digital) features of a device such as controllable lenses or sensors.
+
+
+.. _camera-control-id:
+
+Camera Control IDs
+------------------
+
+``V4L2_CID_CAMERA_CLASS (class)``
+    The Camera class descriptor. Calling
+    :ref:`VIDIOC_QUERYCTRL <vidioc-queryctrl>` for this control will
+    return a description of this control class.
+
+.. _`v4l2-exposure-auto-type`:
+
+``V4L2_CID_EXPOSURE_AUTO (enum v4l2_exposure_auto_type)``
+    Enables automatic adjustments of the exposure time and/or iris
+    aperture. The effect of manual changes of the exposure time or iris
+    aperture while these features are enabled is undefined, drivers
+    should ignore such requests. Possible values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_EXPOSURE_AUTO``
+
+       -  Automatic exposure time, automatic iris aperture.
+
+    -  .. row 2
+
+       -  ``V4L2_EXPOSURE_MANUAL``
+
+       -  Manual exposure time, manual iris.
+
+    -  .. row 3
+
+       -  ``V4L2_EXPOSURE_SHUTTER_PRIORITY``
+
+       -  Manual exposure time, auto iris.
+
+    -  .. row 4
+
+       -  ``V4L2_EXPOSURE_APERTURE_PRIORITY``
+
+       -  Auto exposure time, manual iris.
+
+
+
+``V4L2_CID_EXPOSURE_ABSOLUTE (integer)``
+    Determines the exposure time of the camera sensor. The exposure time
+    is limited by the frame interval. Drivers should interpret the
+    values as 100 µs units, where the value 1 stands for 1/10000th of a
+    second, 10000 for 1 second and 100000 for 10 seconds.
+
+``V4L2_CID_EXPOSURE_AUTO_PRIORITY (boolean)``
+    When ``V4L2_CID_EXPOSURE_AUTO`` is set to ``AUTO`` or
+    ``APERTURE_PRIORITY``, this control determines if the device may
+    dynamically vary the frame rate. By default this feature is disabled
+    (0) and the frame rate must remain constant.
+
+``V4L2_CID_EXPOSURE_BIAS (integer menu)``
+    Determines the automatic exposure compensation, it is effective only
+    when ``V4L2_CID_EXPOSURE_AUTO`` control is set to ``AUTO``,
+    ``SHUTTER_PRIORITY`` or ``APERTURE_PRIORITY``. It is expressed in
+    terms of EV, drivers should interpret the values as 0.001 EV units,
+    where the value 1000 stands for +1 EV.
+
+    Increasing the exposure compensation value is equivalent to
+    decreasing the exposure value (EV) and will increase the amount of
+    light at the image sensor. The camera performs the exposure
+    compensation by adjusting absolute exposure time and/or aperture.
+
+.. _`v4l2-exposure-metering`:
+
+``V4L2_CID_EXPOSURE_METERING (enum v4l2_exposure_metering)``
+    Determines how the camera measures the amount of light available for
+    the frame exposure. Possible values are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_EXPOSURE_METERING_AVERAGE``
+
+       -  Use the light information coming from the entire frame and average
+          giving no weighting to any particular portion of the metered area.
+
+    -  .. row 2
+
+       -  ``V4L2_EXPOSURE_METERING_CENTER_WEIGHTED``
+
+       -  Average the light information coming from the entire frame giving
+          priority to the center of the metered area.
+
+    -  .. row 3
+
+       -  ``V4L2_EXPOSURE_METERING_SPOT``
+
+       -  Measure only very small area at the center of the frame.
+
+    -  .. row 4
+
+       -  ``V4L2_EXPOSURE_METERING_MATRIX``
+
+       -  A multi-zone metering. The light intensity is measured in several
+          points of the frame and the results are combined. The algorithm of
+          the zones selection and their significance in calculating the
+          final value is device dependent.
+
+
+
+``V4L2_CID_PAN_RELATIVE (integer)``
+    This control turns the camera horizontally by the specified amount.
+    The unit is undefined. A positive value moves the camera to the
+    right (clockwise when viewed from above), a negative value to the
+    left. A value of zero does not cause motion. This is a write-only
+    control.
+
+``V4L2_CID_TILT_RELATIVE (integer)``
+    This control turns the camera vertically by the specified amount.
+    The unit is undefined. A positive value moves the camera up, a
+    negative value down. A value of zero does not cause motion. This is
+    a write-only control.
+
+``V4L2_CID_PAN_RESET (button)``
+    When this control is set, the camera moves horizontally to the
+    default position.
+
+``V4L2_CID_TILT_RESET (button)``
+    When this control is set, the camera moves vertically to the default
+    position.
+
+``V4L2_CID_PAN_ABSOLUTE (integer)``
+    This control turns the camera horizontally to the specified
+    position. Positive values move the camera to the right (clockwise
+    when viewed from above), negative values to the left. Drivers should
+    interpret the values as arc seconds, with valid values between -180
+    * 3600 and +180 * 3600 inclusive.
+
+``V4L2_CID_TILT_ABSOLUTE (integer)``
+    This control turns the camera vertically to the specified position.
+    Positive values move the camera up, negative values down. Drivers
+    should interpret the values as arc seconds, with valid values
+    between -180 * 3600 and +180 * 3600 inclusive.
+
+``V4L2_CID_FOCUS_ABSOLUTE (integer)``
+    This control sets the focal point of the camera to the specified
+    position. The unit is undefined. Positive values set the focus
+    closer to the camera, negative values towards infinity.
+
+``V4L2_CID_FOCUS_RELATIVE (integer)``
+    This control moves the focal point of the camera by the specified
+    amount. The unit is undefined. Positive values move the focus closer
+    to the camera, negative values towards infinity. This is a
+    write-only control.
+
+``V4L2_CID_FOCUS_AUTO (boolean)``
+    Enables continuous automatic focus adjustments. The effect of manual
+    focus adjustments while this feature is enabled is undefined,
+    drivers should ignore such requests.
+
+``V4L2_CID_AUTO_FOCUS_START (button)``
+    Starts single auto focus process. The effect of setting this control
+    when ``V4L2_CID_FOCUS_AUTO`` is set to ``TRUE`` (1) is undefined,
+    drivers should ignore such requests.
+
+``V4L2_CID_AUTO_FOCUS_STOP (button)``
+    Aborts automatic focusing started with ``V4L2_CID_AUTO_FOCUS_START``
+    control. It is effective only when the continuous autofocus is
+    disabled, that is when ``V4L2_CID_FOCUS_AUTO`` control is set to
+    ``FALSE`` (0).
+
+.. _`v4l2-auto-focus-status`:
+
+``V4L2_CID_AUTO_FOCUS_STATUS (bitmask)``
+    The automatic focus status. This is a read-only control.
+
+    Setting ``V4L2_LOCK_FOCUS`` lock bit of the ``V4L2_CID_3A_LOCK``
+    control may stop updates of the ``V4L2_CID_AUTO_FOCUS_STATUS``
+    control value.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_AUTO_FOCUS_STATUS_IDLE``
+
+       -  Automatic focus is not active.
+
+    -  .. row 2
+
+       -  ``V4L2_AUTO_FOCUS_STATUS_BUSY``
+
+       -  Automatic focusing is in progress.
+
+    -  .. row 3
+
+       -  ``V4L2_AUTO_FOCUS_STATUS_REACHED``
+
+       -  Focus has been reached.
+
+    -  .. row 4
+
+       -  ``V4L2_AUTO_FOCUS_STATUS_FAILED``
+
+       -  Automatic focus has failed, the driver will not transition from
+          this state until another action is performed by an application.
+
+
+
+.. _`v4l2-auto-focus-range`:
+
+``V4L2_CID_AUTO_FOCUS_RANGE (enum v4l2_auto_focus_range)``
+    Determines auto focus distance range for which lens may be adjusted.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_AUTO_FOCUS_RANGE_AUTO``
+
+       -  The camera automatically selects the focus range.
+
+    -  .. row 2
+
+       -  ``V4L2_AUTO_FOCUS_RANGE_NORMAL``
+
+       -  Normal distance range, limited for best automatic focus
+          performance.
+
+    -  .. row 3
+
+       -  ``V4L2_AUTO_FOCUS_RANGE_MACRO``
+
+       -  Macro (close-up) auto focus. The camera will use its minimum
+          possible distance for auto focus.
+
+    -  .. row 4
+
+       -  ``V4L2_AUTO_FOCUS_RANGE_INFINITY``
+
+       -  The lens is set to focus on an object at infinite distance.
+
+
+
+``V4L2_CID_ZOOM_ABSOLUTE (integer)``
+    Specify the objective lens focal length as an absolute value. The
+    zoom unit is driver-specific and its value should be a positive
+    integer.
+
+``V4L2_CID_ZOOM_RELATIVE (integer)``
+    Specify the objective lens focal length relatively to the current
+    value. Positive values move the zoom lens group towards the
+    telephoto direction, negative values towards the wide-angle
+    direction. The zoom unit is driver-specific. This is a write-only
+    control.
+
+``V4L2_CID_ZOOM_CONTINUOUS (integer)``
+    Move the objective lens group at the specified speed until it
+    reaches physical device limits or until an explicit request to stop
+    the movement. A positive value moves the zoom lens group towards the
+    telephoto direction. A value of zero stops the zoom lens group
+    movement. A negative value moves the zoom lens group towards the
+    wide-angle direction. The zoom speed unit is driver-specific.
+
+``V4L2_CID_IRIS_ABSOLUTE (integer)``
+    This control sets the camera's aperture to the specified value. The
+    unit is undefined. Larger values open the iris wider, smaller values
+    close it.
+
+``V4L2_CID_IRIS_RELATIVE (integer)``
+    This control modifies the camera's aperture by the specified amount.
+    The unit is undefined. Positive values open the iris one step
+    further, negative values close it one step further. This is a
+    write-only control.
+
+``V4L2_CID_PRIVACY (boolean)``
+    Prevent video from being acquired by the camera. When this control
+    is set to ``TRUE`` (1), no image can be captured by the camera.
+    Common means to enforce privacy are mechanical obturation of the
+    sensor and firmware image processing, but the device is not
+    restricted to these methods. Devices that implement the privacy
+    control must support read access and may support write access.
+
+``V4L2_CID_BAND_STOP_FILTER (integer)``
+    Switch the band-stop filter of a camera sensor on or off, or specify
+    its strength. Such band-stop filters can be used, for example, to
+    filter out the fluorescent light component.
+
+.. _`v4l2-auto-n-preset-white-balance`:
+
+``V4L2_CID_AUTO_N_PRESET_WHITE_BALANCE (enum v4l2_auto_n_preset_white_balance)``
+    Sets white balance to automatic, manual or a preset. The presets
+    determine color temperature of the light as a hint to the camera for
+    white balance adjustments resulting in most accurate color
+    representation. The following white balance presets are listed in
+    order of increasing color temperature.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_WHITE_BALANCE_MANUAL``
+
+       -  Manual white balance.
+
+    -  .. row 2
+
+       -  ``V4L2_WHITE_BALANCE_AUTO``
+
+       -  Automatic white balance adjustments.
+
+    -  .. row 3
+
+       -  ``V4L2_WHITE_BALANCE_INCANDESCENT``
+
+       -  White balance setting for incandescent (tungsten) lighting. It
+          generally cools down the colors and corresponds approximately to
+          2500...3500 K color temperature range.
+
+    -  .. row 4
+
+       -  ``V4L2_WHITE_BALANCE_FLUORESCENT``
+
+       -  White balance preset for fluorescent lighting. It corresponds
+          approximately to 4000...5000 K color temperature.
+
+    -  .. row 5
+
+       -  ``V4L2_WHITE_BALANCE_FLUORESCENT_H``
+
+       -  With this setting the camera will compensate for fluorescent H
+          lighting.
+
+    -  .. row 6
+
+       -  ``V4L2_WHITE_BALANCE_HORIZON``
+
+       -  White balance setting for horizon daylight. It corresponds
+          approximately to 5000 K color temperature.
+
+    -  .. row 7
+
+       -  ``V4L2_WHITE_BALANCE_DAYLIGHT``
+
+       -  White balance preset for daylight (with clear sky). It corresponds
+          approximately to 5000...6500 K color temperature.
+
+    -  .. row 8
+
+       -  ``V4L2_WHITE_BALANCE_FLASH``
+
+       -  With this setting the camera will compensate for the flash light.
+          It slightly warms up the colors and corresponds roughly to
+          5000...5500 K color temperature.
+
+    -  .. row 9
+
+       -  ``V4L2_WHITE_BALANCE_CLOUDY``
+
+       -  White balance preset for moderately overcast sky. This option
+          corresponds approximately to 6500...8000 K color temperature
+          range.
+
+    -  .. row 10
+
+       -  ``V4L2_WHITE_BALANCE_SHADE``
+
+       -  White balance preset for shade or heavily overcast sky. It
+          corresponds approximately to 9000...10000 K color temperature.
+
+
+
+.. _`v4l2-wide-dynamic-range`:
+
+``V4L2_CID_WIDE_DYNAMIC_RANGE (boolean)``
+    Enables or disables the camera's wide dynamic range feature. This
+    feature allows to obtain clear images in situations where intensity
+    of the illumination varies significantly throughout the scene, i.e.
+    there are simultaneously very dark and very bright areas. It is most
+    commonly realized in cameras by combining two subsequent frames with
+    different exposure times.  [1]_
+
+.. _`v4l2-image-stabilization`:
+
+``V4L2_CID_IMAGE_STABILIZATION (boolean)``
+    Enables or disables image stabilization.
+
+``V4L2_CID_ISO_SENSITIVITY (integer menu)``
+    Determines ISO equivalent of an image sensor indicating the sensor's
+    sensitivity to light. The numbers are expressed in arithmetic scale,
+    as per :ref:`iso12232` standard, where doubling the sensor
+    sensitivity is represented by doubling the numerical ISO value.
+    Applications should interpret the values as standard ISO values
+    multiplied by 1000, e.g. control value 800 stands for ISO 0.8.
+    Drivers will usually support only a subset of standard ISO values.
+    The effect of setting this control while the
+    ``V4L2_CID_ISO_SENSITIVITY_AUTO`` control is set to a value other
+    than ``V4L2_CID_ISO_SENSITIVITY_MANUAL`` is undefined, drivers
+    should ignore such requests.
+
+.. _`v4l2-iso-sensitivity-auto-type`:
+
+``V4L2_CID_ISO_SENSITIVITY_AUTO (enum v4l2_iso_sensitivity_type)``
+    Enables or disables automatic ISO sensitivity adjustments.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_CID_ISO_SENSITIVITY_MANUAL``
+
+       -  Manual ISO sensitivity.
+
+    -  .. row 2
+
+       -  ``V4L2_CID_ISO_SENSITIVITY_AUTO``
+
+       -  Automatic ISO sensitivity adjustments.
+
+
+
+.. _`v4l2-scene-mode`:
+
+``V4L2_CID_SCENE_MODE (enum v4l2_scene_mode)``
+    This control allows to select scene programs as the camera automatic
+    modes optimized for common shooting scenes. Within these modes the
+    camera determines best exposure, aperture, focusing, light metering,
+    white balance and equivalent sensitivity. The controls of those
+    parameters are influenced by the scene mode control. An exact
+    behavior in each mode is subject to the camera specification.
+
+    When the scene mode feature is not used, this control should be set
+    to ``V4L2_SCENE_MODE_NONE`` to make sure the other possibly related
+    controls are accessible. The following scene programs are defined:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_SCENE_MODE_NONE``
+
+       -  The scene mode feature is disabled.
+
+    -  .. row 2
+
+       -  ``V4L2_SCENE_MODE_BACKLIGHT``
+
+       -  Backlight. Compensates for dark shadows when light is coming from
+          behind a subject, also by automatically turning on the flash.
+
+    -  .. row 3
+
+       -  ``V4L2_SCENE_MODE_BEACH_SNOW``
+
+       -  Beach and snow. This mode compensates for all-white or bright
+          scenes, which tend to look gray and low contrast, when camera's
+          automatic exposure is based on an average scene brightness. To
+          compensate, this mode automatically slightly overexposes the
+          frames. The white balance may also be adjusted to compensate for
+          the fact that reflected snow looks bluish rather than white.
+
+    -  .. row 4
+
+       -  ``V4L2_SCENE_MODE_CANDLELIGHT``
+
+       -  Candle light. The camera generally raises the ISO sensitivity and
+          lowers the shutter speed. This mode compensates for relatively
+          close subject in the scene. The flash is disabled in order to
+          preserve the ambiance of the light.
+
+    -  .. row 5
+
+       -  ``V4L2_SCENE_MODE_DAWN_DUSK``
+
+       -  Dawn and dusk. Preserves the colors seen in low natural light
+          before dusk and after down. The camera may turn off the flash, and
+          automatically focus at infinity. It will usually boost saturation
+          and lower the shutter speed.
+
+    -  .. row 6
+
+       -  ``V4L2_SCENE_MODE_FALL_COLORS``
+
+       -  Fall colors. Increases saturation and adjusts white balance for
+          color enhancement. Pictures of autumn leaves get saturated reds
+          and yellows.
+
+    -  .. row 7
+
+       -  ``V4L2_SCENE_MODE_FIREWORKS``
+
+       -  Fireworks. Long exposure times are used to capture the expanding
+          burst of light from a firework. The camera may invoke image
+          stabilization.
+
+    -  .. row 8
+
+       -  ``V4L2_SCENE_MODE_LANDSCAPE``
+
+       -  Landscape. The camera may choose a small aperture to provide deep
+          depth of field and long exposure duration to help capture detail
+          in dim light conditions. The focus is fixed at infinity. Suitable
+          for distant and wide scenery.
+
+    -  .. row 9
+
+       -  ``V4L2_SCENE_MODE_NIGHT``
+
+       -  Night, also known as Night Landscape. Designed for low light
+          conditions, it preserves detail in the dark areas without blowing
+          out bright objects. The camera generally sets itself to a
+          medium-to-high ISO sensitivity, with a relatively long exposure
+          time, and turns flash off. As such, there will be increased image
+          noise and the possibility of blurred image.
+
+    -  .. row 10
+
+       -  ``V4L2_SCENE_MODE_PARTY_INDOOR``
+
+       -  Party and indoor. Designed to capture indoor scenes that are lit
+          by indoor background lighting as well as the flash. The camera
+          usually increases ISO sensitivity, and adjusts exposure for the
+          low light conditions.
+
+    -  .. row 11
+
+       -  ``V4L2_SCENE_MODE_PORTRAIT``
+
+       -  Portrait. The camera adjusts the aperture so that the depth of
+          field is reduced, which helps to isolate the subject against a
+          smooth background. Most cameras recognize the presence of faces in
+          the scene and focus on them. The color hue is adjusted to enhance
+          skin tones. The intensity of the flash is often reduced.
+
+    -  .. row 12
+
+       -  ``V4L2_SCENE_MODE_SPORTS``
+
+       -  Sports. Significantly increases ISO and uses a fast shutter speed
+          to freeze motion of rapidly-moving subjects. Increased image noise
+          may be seen in this mode.
+
+    -  .. row 13
+
+       -  ``V4L2_SCENE_MODE_SUNSET``
+
+       -  Sunset. Preserves deep hues seen in sunsets and sunrises. It bumps
+          up the saturation.
+
+    -  .. row 14
+
+       -  ``V4L2_SCENE_MODE_TEXT``
+
+       -  Text. It applies extra contrast and sharpness, it is typically a
+          black-and-white mode optimized for readability. Automatic focus
+          may be switched to close-up mode and this setting may also involve
+          some lens-distortion correction.
+
+
+
+``V4L2_CID_3A_LOCK (bitmask)``
+    This control locks or unlocks the automatic focus, exposure and
+    white balance. The automatic adjustments can be paused independently
+    by setting the corresponding lock bit to 1. The camera then retains
+    the settings until the lock bit is cleared. The following lock bits
+    are defined:
+
+    When a given algorithm is not enabled, drivers should ignore
+    requests to lock it and should return no error. An example might be
+    an application setting bit ``V4L2_LOCK_WHITE_BALANCE`` when the
+    ``V4L2_CID_AUTO_WHITE_BALANCE`` control is set to ``FALSE``. The
+    value of this control may be changed by exposure, white balance or
+    focus controls.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_LOCK_EXPOSURE``
+
+       -  Automatic exposure adjustments lock.
+
+    -  .. row 2
+
+       -  ``V4L2_LOCK_WHITE_BALANCE``
+
+       -  Automatic white balance adjustments lock.
+
+    -  .. row 3
+
+       -  ``V4L2_LOCK_FOCUS``
+
+       -  Automatic focus lock.
+
+
+
+``V4L2_CID_PAN_SPEED (integer)``
+    This control turns the camera horizontally at the specific speed.
+    The unit is undefined. A positive value moves the camera to the
+    right (clockwise when viewed from above), a negative value to the
+    left. A value of zero stops the motion if one is in progress and has
+    no effect otherwise.
+
+``V4L2_CID_TILT_SPEED (integer)``
+    This control turns the camera vertically at the specified speed. The
+    unit is undefined. A positive value moves the camera up, a negative
+    value down. A value of zero stops the motion if one is in progress
+    and has no effect otherwise.
+
+
+.. _fm-tx-controls:
+
+FM Transmitter Control Reference
+================================
+
+The FM Transmitter (FM_TX) class includes controls for common features
+of FM transmissions capable devices. Currently this class includes
+parameters for audio compression, pilot tone generation, audio deviation
+limiter, RDS transmission and tuning power features.
+
+
+.. _fm-tx-control-id:
+
+FM_TX Control IDs
+-----------------
+
+``V4L2_CID_FM_TX_CLASS (class)``
+    The FM_TX class descriptor. Calling
+    :ref:`VIDIOC_QUERYCTRL <vidioc-queryctrl>` for this control will
+    return a description of this control class.
+
+``V4L2_CID_RDS_TX_DEVIATION (integer)``
+    Configures RDS signal frequency deviation level in Hz. The range and
+    step are driver-specific.
+
+``V4L2_CID_RDS_TX_PI (integer)``
+    Sets the RDS Programme Identification field for transmission.
+
+``V4L2_CID_RDS_TX_PTY (integer)``
+    Sets the RDS Programme Type field for transmission. This encodes up
+    to 31 pre-defined programme types.
+
+``V4L2_CID_RDS_TX_PS_NAME (string)``
+    Sets the Programme Service name (PS_NAME) for transmission. It is
+    intended for static display on a receiver. It is the primary aid to
+    listeners in programme service identification and selection. In
+    Annex E of :ref:`iec62106`, the RDS specification, there is a full
+    description of the correct character encoding for Programme Service
+    name strings. Also from RDS specification, PS is usually a single
+    eight character text. However, it is also possible to find receivers
+    which can scroll strings sized as 8 x N characters. So, this control
+    must be configured with steps of 8 characters. The result is it must
+    always contain a string with size multiple of 8.
+
+``V4L2_CID_RDS_TX_RADIO_TEXT (string)``
+    Sets the Radio Text info for transmission. It is a textual
+    description of what is being broadcasted. RDS Radio Text can be
+    applied when broadcaster wishes to transmit longer PS names,
+    programme-related information or any other text. In these cases,
+    RadioText should be used in addition to ``V4L2_CID_RDS_TX_PS_NAME``.
+    The encoding for Radio Text strings is also fully described in Annex
+    E of :ref:`iec62106`. The length of Radio Text strings depends on
+    which RDS Block is being used to transmit it, either 32 (2A block)
+    or 64 (2B block). However, it is also possible to find receivers
+    which can scroll strings sized as 32 x N or 64 x N characters. So,
+    this control must be configured with steps of 32 or 64 characters.
+    The result is it must always contain a string with size multiple of
+    32 or 64.
+
+``V4L2_CID_RDS_TX_MONO_STEREO (boolean)``
+    Sets the Mono/Stereo bit of the Decoder Identification code. If set,
+    then the audio was recorded as stereo.
+
+``V4L2_CID_RDS_TX_ARTIFICIAL_HEAD (boolean)``
+    Sets the
+    `Artificial Head <http://en.wikipedia.org/wiki/Artificial_head>`__
+    bit of the Decoder Identification code. If set, then the audio was
+    recorded using an artificial head.
+
+``V4L2_CID_RDS_TX_COMPRESSED (boolean)``
+    Sets the Compressed bit of the Decoder Identification code. If set,
+    then the audio is compressed.
+
+``V4L2_CID_RDS_TX_DYNAMIC_PTY (boolean)``
+    Sets the Dynamic PTY bit of the Decoder Identification code. If set,
+    then the PTY code is dynamically switched.
+
+``V4L2_CID_RDS_TX_TRAFFIC_ANNOUNCEMENT (boolean)``
+    If set, then a traffic announcement is in progress.
+
+``V4L2_CID_RDS_TX_TRAFFIC_PROGRAM (boolean)``
+    If set, then the tuned programme carries traffic announcements.
+
+``V4L2_CID_RDS_TX_MUSIC_SPEECH (boolean)``
+    If set, then this channel broadcasts music. If cleared, then it
+    broadcasts speech. If the transmitter doesn't make this distinction,
+    then it should be set.
+
+``V4L2_CID_RDS_TX_ALT_FREQS_ENABLE (boolean)``
+    If set, then transmit alternate frequencies.
+
+``V4L2_CID_RDS_TX_ALT_FREQS (__u32 array)``
+    The alternate frequencies in kHz units. The RDS standard allows for
+    up to 25 frequencies to be defined. Drivers may support fewer
+    frequencies so check the array size.
+
+``V4L2_CID_AUDIO_LIMITER_ENABLED (boolean)``
+    Enables or disables the audio deviation limiter feature. The limiter
+    is useful when trying to maximize the audio volume, minimize
+    receiver-generated distortion and prevent overmodulation.
+
+``V4L2_CID_AUDIO_LIMITER_RELEASE_TIME (integer)``
+    Sets the audio deviation limiter feature release time. Unit is in
+    useconds. Step and range are driver-specific.
+
+``V4L2_CID_AUDIO_LIMITER_DEVIATION (integer)``
+    Configures audio frequency deviation level in Hz. The range and step
+    are driver-specific.
+
+``V4L2_CID_AUDIO_COMPRESSION_ENABLED (boolean)``
+    Enables or disables the audio compression feature. This feature
+    amplifies signals below the threshold by a fixed gain and compresses
+    audio signals above the threshold by the ratio of Threshold/(Gain +
+    Threshold).
+
+``V4L2_CID_AUDIO_COMPRESSION_GAIN (integer)``
+    Sets the gain for audio compression feature. It is a dB value. The
+    range and step are driver-specific.
+
+``V4L2_CID_AUDIO_COMPRESSION_THRESHOLD (integer)``
+    Sets the threshold level for audio compression freature. It is a dB
+    value. The range and step are driver-specific.
+
+``V4L2_CID_AUDIO_COMPRESSION_ATTACK_TIME (integer)``
+    Sets the attack time for audio compression feature. It is a useconds
+    value. The range and step are driver-specific.
+
+``V4L2_CID_AUDIO_COMPRESSION_RELEASE_TIME (integer)``
+    Sets the release time for audio compression feature. It is a
+    useconds value. The range and step are driver-specific.
+
+``V4L2_CID_PILOT_TONE_ENABLED (boolean)``
+    Enables or disables the pilot tone generation feature.
+
+``V4L2_CID_PILOT_TONE_DEVIATION (integer)``
+    Configures pilot tone frequency deviation level. Unit is in Hz. The
+    range and step are driver-specific.
+
+``V4L2_CID_PILOT_TONE_FREQUENCY (integer)``
+    Configures pilot tone frequency value. Unit is in Hz. The range and
+    step are driver-specific.
+
+``V4L2_CID_TUNE_PREEMPHASIS (enum v4l2_preemphasis)``
+    Configures the pre-emphasis value for broadcasting. A pre-emphasis
+    filter is applied to the broadcast to accentuate the high audio
+    frequencies. Depending on the region, a time constant of either 50
+    or 75 useconds is used. The enum v4l2_preemphasis defines possible
+    values for pre-emphasis. Here they are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_PREEMPHASIS_DISABLED``
+
+       -  No pre-emphasis is applied.
+
+    -  .. row 2
+
+       -  ``V4L2_PREEMPHASIS_50_uS``
+
+       -  A pre-emphasis of 50 uS is used.
+
+    -  .. row 3
+
+       -  ``V4L2_PREEMPHASIS_75_uS``
+
+       -  A pre-emphasis of 75 uS is used.
+
+
+
+``V4L2_CID_TUNE_POWER_LEVEL (integer)``
+    Sets the output power level for signal transmission. Unit is in
+    dBuV. Range and step are driver-specific.
+
+``V4L2_CID_TUNE_ANTENNA_CAPACITOR (integer)``
+    This selects the value of antenna tuning capacitor manually or
+    automatically if set to zero. Unit, range and step are
+    driver-specific.
+
+For more details about RDS specification, refer to :ref:`iec62106`
+document, from CENELEC.
+
+
+.. _flash-controls:
+
+Flash Control Reference
+=======================
+
+The V4L2 flash controls are intended to provide generic access to flash
+controller devices. Flash controller devices are typically used in
+digital cameras.
+
+The interface can support both LED and xenon flash devices. As of
+writing this, there is no xenon flash driver using this interface.
+
+
+.. _flash-controls-use-cases:
+
+Supported use cases
+-------------------
+
+
+Unsynchronised LED flash (software strobe)
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Unsynchronised LED flash is controlled directly by the host as the
+sensor. The flash must be enabled by the host before the exposure of the
+image starts and disabled once it ends. The host is fully responsible
+for the timing of the flash.
+
+Example of such device: Nokia N900.
+
+
+Synchronised LED flash (hardware strobe)
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The synchronised LED flash is pre-programmed by the host (power and
+timeout) but controlled by the sensor through a strobe signal from the
+sensor to the flash.
+
+The sensor controls the flash duration and timing. This information
+typically must be made available to the sensor.
+
+
+LED flash as torch
+^^^^^^^^^^^^^^^^^^
+
+LED flash may be used as torch in conjunction with another use case
+involving camera or individually.
+
+
+.. _flash-control-id:
+
+Flash Control IDs
+"""""""""""""""""
+
+``V4L2_CID_FLASH_CLASS (class)``
+    The FLASH class descriptor.
+
+``V4L2_CID_FLASH_LED_MODE (menu)``
+    Defines the mode of the flash LED, the high-power white LED attached
+    to the flash controller. Setting this control may not be possible in
+    presence of some faults. See V4L2_CID_FLASH_FAULT.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_FLASH_LED_MODE_NONE``
+
+       -  Off.
+
+    -  .. row 2
+
+       -  ``V4L2_FLASH_LED_MODE_FLASH``
+
+       -  Flash mode.
+
+    -  .. row 3
+
+       -  ``V4L2_FLASH_LED_MODE_TORCH``
+
+       -  Torch mode. See V4L2_CID_FLASH_TORCH_INTENSITY.
+
+
+
+``V4L2_CID_FLASH_STROBE_SOURCE (menu)``
+    Defines the source of the flash LED strobe.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_FLASH_STROBE_SOURCE_SOFTWARE``
+
+       -  The flash strobe is triggered by using the
+          V4L2_CID_FLASH_STROBE control.
+
+    -  .. row 2
+
+       -  ``V4L2_FLASH_STROBE_SOURCE_EXTERNAL``
+
+       -  The flash strobe is triggered by an external source. Typically
+          this is a sensor, which makes it possible to synchronises the
+          flash strobe start to exposure start.
+
+
+
+``V4L2_CID_FLASH_STROBE (button)``
+    Strobe flash. Valid when V4L2_CID_FLASH_LED_MODE is set to
+    V4L2_FLASH_LED_MODE_FLASH and V4L2_CID_FLASH_STROBE_SOURCE
+    is set to V4L2_FLASH_STROBE_SOURCE_SOFTWARE. Setting this
+    control may not be possible in presence of some faults. See
+    V4L2_CID_FLASH_FAULT.
+
+``V4L2_CID_FLASH_STROBE_STOP (button)``
+    Stop flash strobe immediately.
+
+``V4L2_CID_FLASH_STROBE_STATUS (boolean)``
+    Strobe status: whether the flash is strobing at the moment or not.
+    This is a read-only control.
+
+``V4L2_CID_FLASH_TIMEOUT (integer)``
+    Hardware timeout for flash. The flash strobe is stopped after this
+    period of time has passed from the start of the strobe.
+
+``V4L2_CID_FLASH_INTENSITY (integer)``
+    Intensity of the flash strobe when the flash LED is in flash mode
+    (V4L2_FLASH_LED_MODE_FLASH). The unit should be milliamps (mA)
+    if possible.
+
+``V4L2_CID_FLASH_TORCH_INTENSITY (integer)``
+    Intensity of the flash LED in torch mode
+    (V4L2_FLASH_LED_MODE_TORCH). The unit should be milliamps (mA)
+    if possible. Setting this control may not be possible in presence of
+    some faults. See V4L2_CID_FLASH_FAULT.
+
+``V4L2_CID_FLASH_INDICATOR_INTENSITY (integer)``
+    Intensity of the indicator LED. The indicator LED may be fully
+    independent of the flash LED. The unit should be microamps (uA) if
+    possible.
+
+``V4L2_CID_FLASH_FAULT (bitmask)``
+    Faults related to the flash. The faults tell about specific problems
+    in the flash chip itself or the LEDs attached to it. Faults may
+    prevent further use of some of the flash controls. In particular,
+    V4L2_CID_FLASH_LED_MODE is set to V4L2_FLASH_LED_MODE_NONE
+    if the fault affects the flash LED. Exactly which faults have such
+    an effect is chip dependent. Reading the faults resets the control
+    and returns the chip to a usable state if possible.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_FLASH_FAULT_OVER_VOLTAGE``
+
+       -  Flash controller voltage to the flash LED has exceeded the limit
+          specific to the flash controller.
+
+    -  .. row 2
+
+       -  ``V4L2_FLASH_FAULT_TIMEOUT``
+
+       -  The flash strobe was still on when the timeout set by the user ---
+          V4L2_CID_FLASH_TIMEOUT control --- has expired. Not all flash
+          controllers may set this in all such conditions.
+
+    -  .. row 3
+
+       -  ``V4L2_FLASH_FAULT_OVER_TEMPERATURE``
+
+       -  The flash controller has overheated.
+
+    -  .. row 4
+
+       -  ``V4L2_FLASH_FAULT_SHORT_CIRCUIT``
+
+       -  The short circuit protection of the flash controller has been
+          triggered.
+
+    -  .. row 5
+
+       -  ``V4L2_FLASH_FAULT_OVER_CURRENT``
+
+       -  Current in the LED power supply has exceeded the limit specific to
+          the flash controller.
+
+    -  .. row 6
+
+       -  ``V4L2_FLASH_FAULT_INDICATOR``
+
+       -  The flash controller has detected a short or open circuit
+          condition on the indicator LED.
+
+    -  .. row 7
+
+       -  ``V4L2_FLASH_FAULT_UNDER_VOLTAGE``
+
+       -  Flash controller voltage to the flash LED has been below the
+          minimum limit specific to the flash controller.
+
+    -  .. row 8
+
+       -  ``V4L2_FLASH_FAULT_INPUT_VOLTAGE``
+
+       -  The input voltage of the flash controller is below the limit under
+          which strobing the flash at full current will not be possible.The
+          condition persists until this flag is no longer set.
+
+    -  .. row 9
+
+       -  ``V4L2_FLASH_FAULT_LED_OVER_TEMPERATURE``
+
+       -  The temperature of the LED has exceeded its allowed upper limit.
+
+
+
+``V4L2_CID_FLASH_CHARGE (boolean)``
+    Enable or disable charging of the xenon flash capacitor.
+
+``V4L2_CID_FLASH_READY (boolean)``
+    Is the flash ready to strobe? Xenon flashes require their capacitors
+    charged before strobing. LED flashes often require a cooldown period
+    after strobe during which another strobe will not be possible. This
+    is a read-only control.
+
+
+.. _jpeg-controls:
+
+JPEG Control Reference
+======================
+
+The JPEG class includes controls for common features of JPEG encoders
+and decoders. Currently it includes features for codecs implementing
+progressive baseline DCT compression process with Huffman entrophy
+coding.
+
+
+.. _jpeg-control-id:
+
+JPEG Control IDs
+----------------
+
+``V4L2_CID_JPEG_CLASS (class)``
+    The JPEG class descriptor. Calling
+    :ref:`VIDIOC_QUERYCTRL <vidioc-queryctrl>` for this control will
+    return a description of this control class.
+
+``V4L2_CID_JPEG_CHROMA_SUBSAMPLING (menu)``
+    The chroma subsampling factors describe how each component of an
+    input image is sampled, in respect to maximum sample rate in each
+    spatial dimension. See :ref:`itu-t81`, clause A.1.1. for more
+    details. The ``V4L2_CID_JPEG_CHROMA_SUBSAMPLING`` control determines
+    how Cb and Cr components are downsampled after coverting an input
+    image from RGB to Y'CbCr color space.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_JPEG_CHROMA_SUBSAMPLING_444``
+
+       -  No chroma subsampling, each pixel has Y, Cr and Cb values.
+
+    -  .. row 2
+
+       -  ``V4L2_JPEG_CHROMA_SUBSAMPLING_422``
+
+       -  Horizontally subsample Cr, Cb components by a factor of 2.
+
+    -  .. row 3
+
+       -  ``V4L2_JPEG_CHROMA_SUBSAMPLING_420``
+
+       -  Subsample Cr, Cb components horizontally and vertically by 2.
+
+    -  .. row 4
+
+       -  ``V4L2_JPEG_CHROMA_SUBSAMPLING_411``
+
+       -  Horizontally subsample Cr, Cb components by a factor of 4.
+
+    -  .. row 5
+
+       -  ``V4L2_JPEG_CHROMA_SUBSAMPLING_410``
+
+       -  Subsample Cr, Cb components horizontally by 4 and vertically by 2.
+
+    -  .. row 6
+
+       -  ``V4L2_JPEG_CHROMA_SUBSAMPLING_GRAY``
+
+       -  Use only luminance component.
+
+
+
+``V4L2_CID_JPEG_RESTART_INTERVAL (integer)``
+    The restart interval determines an interval of inserting RSTm
+    markers (m = 0..7). The purpose of these markers is to additionally
+    reinitialize the encoder process, in order to process blocks of an
+    image independently. For the lossy compression processes the restart
+    interval unit is MCU (Minimum Coded Unit) and its value is contained
+    in DRI (Define Restart Interval) marker. If
+    ``V4L2_CID_JPEG_RESTART_INTERVAL`` control is set to 0, DRI and RSTm
+    markers will not be inserted.
+
+.. _`jpeg-quality-control`:
+
+``V4L2_CID_JPEG_COMPRESSION_QUALITY (integer)``
+    ``V4L2_CID_JPEG_COMPRESSION_QUALITY`` control determines trade-off
+    between image quality and size. It provides simpler method for
+    applications to control image quality, without a need for direct
+    reconfiguration of luminance and chrominance quantization tables. In
+    cases where a driver uses quantization tables configured directly by
+    an application, using interfaces defined elsewhere,
+    ``V4L2_CID_JPEG_COMPRESSION_QUALITY`` control should be set by
+    driver to 0.
+
+    The value range of this control is driver-specific. Only positive,
+    non-zero values are meaningful. The recommended range is 1 - 100,
+    where larger values correspond to better image quality.
+
+.. _`jpeg-active-marker-control`:
+
+``V4L2_CID_JPEG_ACTIVE_MARKER (bitmask)``
+    Specify which JPEG markers are included in compressed stream. This
+    control is valid only for encoders.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_JPEG_ACTIVE_MARKER_APP0``
+
+       -  Application data segment APP\ :sub:`0`.
+
+    -  .. row 2
+
+       -  ``V4L2_JPEG_ACTIVE_MARKER_APP1``
+
+       -  Application data segment APP\ :sub:`1`.
+
+    -  .. row 3
+
+       -  ``V4L2_JPEG_ACTIVE_MARKER_COM``
+
+       -  Comment segment.
+
+    -  .. row 4
+
+       -  ``V4L2_JPEG_ACTIVE_MARKER_DQT``
+
+       -  Quantization tables segment.
+
+    -  .. row 5
+
+       -  ``V4L2_JPEG_ACTIVE_MARKER_DHT``
+
+       -  Huffman tables segment.
+
+
+
+For more details about JPEG specification, refer to :ref:`itu-t81`,
+:ref:`jfif`, :ref:`w3c-jpeg-jfif`.
+
+
+.. _image-source-controls:
+
+Image Source Control Reference
+==============================
+
+The Image Source control class is intended for low-level control of
+image source devices such as image sensors. The devices feature an
+analogue to digital converter and a bus transmitter to transmit the
+image data out of the device.
+
+
+.. _image-source-control-id:
+
+Image Source Control IDs
+------------------------
+
+``V4L2_CID_IMAGE_SOURCE_CLASS (class)``
+    The IMAGE_SOURCE class descriptor.
+
+``V4L2_CID_VBLANK (integer)``
+    Vertical blanking. The idle period after every frame during which no
+    image data is produced. The unit of vertical blanking is a line.
+    Every line has length of the image width plus horizontal blanking at
+    the pixel rate defined by ``V4L2_CID_PIXEL_RATE`` control in the
+    same sub-device.
+
+``V4L2_CID_HBLANK (integer)``
+    Horizontal blanking. The idle period after every line of image data
+    during which no image data is produced. The unit of horizontal
+    blanking is pixels.
+
+``V4L2_CID_ANALOGUE_GAIN (integer)``
+    Analogue gain is gain affecting all colour components in the pixel
+    matrix. The gain operation is performed in the analogue domain
+    before A/D conversion.
+
+``V4L2_CID_TEST_PATTERN_RED (integer)``
+    Test pattern red colour component.
+
+``V4L2_CID_TEST_PATTERN_GREENR (integer)``
+    Test pattern green (next to red) colour component.
+
+``V4L2_CID_TEST_PATTERN_BLUE (integer)``
+    Test pattern blue colour component.
+
+``V4L2_CID_TEST_PATTERN_GREENB (integer)``
+    Test pattern green (next to blue) colour component.
+
+
+.. _image-process-controls:
+
+Image Process Control Reference
+===============================
+
+The Image Process control class is intended for low-level control of
+image processing functions. Unlike ``V4L2_CID_IMAGE_SOURCE_CLASS``, the
+controls in this class affect processing the image, and do not control
+capturing of it.
+
+
+.. _image-process-control-id:
+
+Image Process Control IDs
+-------------------------
+
+``V4L2_CID_IMAGE_PROC_CLASS (class)``
+    The IMAGE_PROC class descriptor.
+
+``V4L2_CID_LINK_FREQ (integer menu)``
+    Data bus frequency. Together with the media bus pixel code, bus type
+    (clock cycles per sample), the data bus frequency defines the pixel
+    rate (``V4L2_CID_PIXEL_RATE``) in the pixel array (or possibly
+    elsewhere, if the device is not an image sensor). The frame rate can
+    be calculated from the pixel clock, image width and height and
+    horizontal and vertical blanking. While the pixel rate control may
+    be defined elsewhere than in the subdev containing the pixel array,
+    the frame rate cannot be obtained from that information. This is
+    because only on the pixel array it can be assumed that the vertical
+    and horizontal blanking information is exact: no other blanking is
+    allowed in the pixel array. The selection of frame rate is performed
+    by selecting the desired horizontal and vertical blanking. The unit
+    of this control is Hz.
+
+``V4L2_CID_PIXEL_RATE (64-bit integer)``
+    Pixel rate in the source pads of the subdev. This control is
+    read-only and its unit is pixels / second.
+
+``V4L2_CID_TEST_PATTERN (menu)``
+    Some capture/display/sensor devices have the capability to generate
+    test pattern images. These hardware specific test patterns can be
+    used to test if a device is working properly.
+
+
+.. _dv-controls:
+
+Digital Video Control Reference
+===============================
+
+The Digital Video control class is intended to control receivers and
+transmitters for `VGA <http://en.wikipedia.org/wiki/Vga>`__,
+`DVI <http://en.wikipedia.org/wiki/Digital_Visual_Interface>`__
+(Digital Visual Interface), HDMI (:ref:`hdmi`) and DisplayPort
+(:ref:`dp`). These controls are generally expected to be private to
+the receiver or transmitter subdevice that implements them, so they are
+only exposed on the ``/dev/v4l-subdev*`` device node.
+
+Note that these devices can have multiple input or output pads which are
+hooked up to e.g. HDMI connectors. Even though the subdevice will
+receive or transmit video from/to only one of those pads, the other pads
+can still be active when it comes to EDID (Extended Display
+Identification Data, :ref:`vesaedid`) and HDCP (High-bandwidth Digital
+Content Protection System, :ref:`hdcp`) processing, allowing the
+device to do the fairly slow EDID/HDCP handling in advance. This allows
+for quick switching between connectors.
+
+These pads appear in several of the controls in this section as
+bitmasks, one bit for each pad. Bit 0 corresponds to pad 0, bit 1 to pad
+1, etc. The maximum value of the control is the set of valid pads.
+
+
+.. _dv-control-id:
+
+Digital Video Control IDs
+-------------------------
+
+``V4L2_CID_DV_CLASS (class)``
+    The Digital Video class descriptor.
+
+``V4L2_CID_DV_TX_HOTPLUG (bitmask)``
+    Many connectors have a hotplug pin which is high if EDID information
+    is available from the source. This control shows the state of the
+    hotplug pin as seen by the transmitter. Each bit corresponds to an
+    output pad on the transmitter. If an output pad does not have an
+    associated hotplug pin, then the bit for that pad will be 0. This
+    read-only control is applicable to DVI-D, HDMI and DisplayPort
+    connectors.
+
+``V4L2_CID_DV_TX_RXSENSE (bitmask)``
+    Rx Sense is the detection of pull-ups on the TMDS clock lines. This
+    normally means that the sink has left/entered standby (i.e. the
+    transmitter can sense that the receiver is ready to receive video).
+    Each bit corresponds to an output pad on the transmitter. If an
+    output pad does not have an associated Rx Sense, then the bit for
+    that pad will be 0. This read-only control is applicable to DVI-D
+    and HDMI devices.
+
+``V4L2_CID_DV_TX_EDID_PRESENT (bitmask)``
+    When the transmitter sees the hotplug signal from the receiver it
+    will attempt to read the EDID. If set, then the transmitter has read
+    at least the first block (= 128 bytes). Each bit corresponds to an
+    output pad on the transmitter. If an output pad does not support
+    EDIDs, then the bit for that pad will be 0. This read-only control
+    is applicable to VGA, DVI-A/D, HDMI and DisplayPort connectors.
+
+``V4L2_CID_DV_TX_MODE (enum v4l2_dv_tx_mode)``
+    HDMI transmitters can transmit in DVI-D mode (just video) or in HDMI
+    mode (video + audio + auxiliary data). This control selects which
+    mode to use: V4L2_DV_TX_MODE_DVI_D or V4L2_DV_TX_MODE_HDMI.
+    This control is applicable to HDMI connectors.
+
+``V4L2_CID_DV_TX_RGB_RANGE (enum v4l2_dv_rgb_range)``
+    Select the quantization range for RGB output. V4L2_DV_RANGE_AUTO
+    follows the RGB quantization range specified in the standard for the
+    video interface (ie. :ref:`cea861` for HDMI).
+    V4L2_DV_RANGE_LIMITED and V4L2_DV_RANGE_FULL override the
+    standard to be compatible with sinks that have not implemented the
+    standard correctly (unfortunately quite common for HDMI and DVI-D).
+    Full range allows all possible values to be used whereas limited
+    range sets the range to (16 << (N-8)) - (235 << (N-8)) where N is
+    the number of bits per component. This control is applicable to VGA,
+    DVI-A/D, HDMI and DisplayPort connectors.
+
+``V4L2_CID_DV_TX_IT_CONTENT_TYPE (enum v4l2_dv_it_content_type)``
+    Configures the IT Content Type of the transmitted video. This
+    information is sent over HDMI and DisplayPort connectors as part of
+    the AVI InfoFrame. The term 'IT Content' is used for content that
+    originates from a computer as opposed to content from a TV broadcast
+    or an analog source. The enum v4l2_dv_it_content_type defines
+    the possible content types:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_DV_IT_CONTENT_TYPE_GRAPHICS``
+
+       -  Graphics content. Pixel data should be passed unfiltered and
+          without analog reconstruction.
+
+    -  .. row 2
+
+       -  ``V4L2_DV_IT_CONTENT_TYPE_PHOTO``
+
+       -  Photo content. The content is derived from digital still pictures.
+          The content should be passed through with minimal scaling and
+          picture enhancements.
+
+    -  .. row 3
+
+       -  ``V4L2_DV_IT_CONTENT_TYPE_CINEMA``
+
+       -  Cinema content.
+
+    -  .. row 4
+
+       -  ``V4L2_DV_IT_CONTENT_TYPE_GAME``
+
+       -  Game content. Audio and video latency should be minimized.
+
+    -  .. row 5
+
+       -  ``V4L2_DV_IT_CONTENT_TYPE_NO_ITC``
+
+       -  No IT Content information is available and the ITC bit in the AVI
+          InfoFrame is set to 0.
+
+
+
+``V4L2_CID_DV_RX_POWER_PRESENT (bitmask)``
+    Detects whether the receiver receives power from the source (e.g.
+    HDMI carries 5V on one of the pins). This is often used to power an
+    eeprom which contains EDID information, such that the source can
+    read the EDID even if the sink is in standby/power off. Each bit
+    corresponds to an input pad on the transmitter. If an input pad
+    cannot detect whether power is present, then the bit for that pad
+    will be 0. This read-only control is applicable to DVI-D, HDMI and
+    DisplayPort connectors.
+
+``V4L2_CID_DV_RX_RGB_RANGE (enum v4l2_dv_rgb_range)``
+    Select the quantization range for RGB input. V4L2_DV_RANGE_AUTO
+    follows the RGB quantization range specified in the standard for the
+    video interface (ie. :ref:`cea861` for HDMI).
+    V4L2_DV_RANGE_LIMITED and V4L2_DV_RANGE_FULL override the
+    standard to be compatible with sources that have not implemented the
+    standard correctly (unfortunately quite common for HDMI and DVI-D).
+    Full range allows all possible values to be used whereas limited
+    range sets the range to (16 << (N-8)) - (235 << (N-8)) where N is
+    the number of bits per component. This control is applicable to VGA,
+    DVI-A/D, HDMI and DisplayPort connectors.
+
+``V4L2_CID_DV_RX_IT_CONTENT_TYPE (enum v4l2_dv_it_content_type)``
+    Reads the IT Content Type of the received video. This information is
+    sent over HDMI and DisplayPort connectors as part of the AVI
+    InfoFrame. The term 'IT Content' is used for content that originates
+    from a computer as opposed to content from a TV broadcast or an
+    analog source. See ``V4L2_CID_DV_TX_IT_CONTENT_TYPE`` for the
+    available content types.
+
+
+.. _fm-rx-controls:
+
+FM Receiver Control Reference
+=============================
+
+The FM Receiver (FM_RX) class includes controls for common features of
+FM Reception capable devices.
+
+
+.. _fm-rx-control-id:
+
+FM_RX Control IDs
+-----------------
+
+``V4L2_CID_FM_RX_CLASS (class)``
+    The FM_RX class descriptor. Calling
+    :ref:`VIDIOC_QUERYCTRL <vidioc-queryctrl>` for this control will
+    return a description of this control class.
+
+``V4L2_CID_RDS_RECEPTION (boolean)``
+    Enables/disables RDS reception by the radio tuner
+
+``V4L2_CID_RDS_RX_PTY (integer)``
+    Gets RDS Programme Type field. This encodes up to 31 pre-defined
+    programme types.
+
+``V4L2_CID_RDS_RX_PS_NAME (string)``
+    Gets the Programme Service name (PS_NAME). It is intended for
+    static display on a receiver. It is the primary aid to listeners in
+    programme service identification and selection. In Annex E of
+    :ref:`iec62106`, the RDS specification, there is a full
+    description of the correct character encoding for Programme Service
+    name strings. Also from RDS specification, PS is usually a single
+    eight character text. However, it is also possible to find receivers
+    which can scroll strings sized as 8 x N characters. So, this control
+    must be configured with steps of 8 characters. The result is it must
+    always contain a string with size multiple of 8.
+
+``V4L2_CID_RDS_RX_RADIO_TEXT (string)``
+    Gets the Radio Text info. It is a textual description of what is
+    being broadcasted. RDS Radio Text can be applied when broadcaster
+    wishes to transmit longer PS names, programme-related information or
+    any other text. In these cases, RadioText can be used in addition to
+    ``V4L2_CID_RDS_RX_PS_NAME``. The encoding for Radio Text strings is
+    also fully described in Annex E of :ref:`iec62106`. The length of
+    Radio Text strings depends on which RDS Block is being used to
+    transmit it, either 32 (2A block) or 64 (2B block). However, it is
+    also possible to find receivers which can scroll strings sized as 32
+    x N or 64 x N characters. So, this control must be configured with
+    steps of 32 or 64 characters. The result is it must always contain a
+    string with size multiple of 32 or 64.
+
+``V4L2_CID_RDS_RX_TRAFFIC_ANNOUNCEMENT (boolean)``
+    If set, then a traffic announcement is in progress.
+
+``V4L2_CID_RDS_RX_TRAFFIC_PROGRAM (boolean)``
+    If set, then the tuned programme carries traffic announcements.
+
+``V4L2_CID_RDS_RX_MUSIC_SPEECH (boolean)``
+    If set, then this channel broadcasts music. If cleared, then it
+    broadcasts speech. If the transmitter doesn't make this distinction,
+    then it will be set.
+
+``V4L2_CID_TUNE_DEEMPHASIS (enum v4l2_deemphasis)``
+    Configures the de-emphasis value for reception. A de-emphasis filter
+    is applied to the broadcast to accentuate the high audio
+    frequencies. Depending on the region, a time constant of either 50
+    or 75 useconds is used. The enum v4l2_deemphasis defines possible
+    values for de-emphasis. Here they are:
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_DEEMPHASIS_DISABLED``
+
+       -  No de-emphasis is applied.
+
+    -  .. row 2
+
+       -  ``V4L2_DEEMPHASIS_50_uS``
+
+       -  A de-emphasis of 50 uS is used.
+
+    -  .. row 3
+
+       -  ``V4L2_DEEMPHASIS_75_uS``
+
+       -  A de-emphasis of 75 uS is used.
+
+
+
+
+.. _detect-controls:
+
+Detect Control Reference
+========================
+
+The Detect class includes controls for common features of various motion
+or object detection capable devices.
+
+
+.. _detect-control-id:
+
+Detect Control IDs
+------------------
+
+``V4L2_CID_DETECT_CLASS (class)``
+    The Detect class descriptor. Calling
+    :ref:`VIDIOC_QUERYCTRL <vidioc-queryctrl>` for this control will
+    return a description of this control class.
+
+``V4L2_CID_DETECT_MD_MODE (menu)``
+    Sets the motion detection mode.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``V4L2_DETECT_MD_MODE_DISABLED``
+
+       -  Disable motion detection.
+
+    -  .. row 2
+
+       -  ``V4L2_DETECT_MD_MODE_GLOBAL``
+
+       -  Use a single motion detection threshold.
+
+    -  .. row 3
+
+       -  ``V4L2_DETECT_MD_MODE_THRESHOLD_GRID``
+
+       -  The image is divided into a grid, each cell with its own motion
+          detection threshold. These thresholds are set through the
+          ``V4L2_CID_DETECT_MD_THRESHOLD_GRID`` matrix control.
+
+    -  .. row 4
+
+       -  ``V4L2_DETECT_MD_MODE_REGION_GRID``
+
+       -  The image is divided into a grid, each cell with its own region
+          value that specifies which per-region motion detection thresholds
+          should be used. Each region has its own thresholds. How these
+          per-region thresholds are set up is driver-specific. The region
+          values for the grid are set through the
+          ``V4L2_CID_DETECT_MD_REGION_GRID`` matrix control.
+
+
+
+``V4L2_CID_DETECT_MD_GLOBAL_THRESHOLD (integer)``
+    Sets the global motion detection threshold to be used with the
+    ``V4L2_DETECT_MD_MODE_GLOBAL`` motion detection mode.
+
+``V4L2_CID_DETECT_MD_THRESHOLD_GRID (__u16 matrix)``
+    Sets the motion detection thresholds for each cell in the grid. To
+    be used with the ``V4L2_DETECT_MD_MODE_THRESHOLD_GRID`` motion
+    detection mode. Matrix element (0, 0) represents the cell at the
+    top-left of the grid.
+
+``V4L2_CID_DETECT_MD_REGION_GRID (__u8 matrix)``
+    Sets the motion detection region value for each cell in the grid. To
+    be used with the ``V4L2_DETECT_MD_MODE_REGION_GRID`` motion
+    detection mode. Matrix element (0, 0) represents the cell at the
+    top-left of the grid.
+
+
+.. _rf-tuner-controls:
+
+RF Tuner Control Reference
+==========================
+
+The RF Tuner (RF_TUNER) class includes controls for common features of
+devices having RF tuner.
+
+In this context, RF tuner is radio receiver circuit between antenna and
+demodulator. It receives radio frequency (RF) from the antenna and
+converts that received signal to lower intermediate frequency (IF) or
+baseband frequency (BB). Tuners that could do baseband output are often
+called Zero-IF tuners. Older tuners were typically simple PLL tuners
+inside a metal box, whilst newer ones are highly integrated chips
+without a metal box "silicon tuners". These controls are mostly
+applicable for new feature rich silicon tuners, just because older
+tuners does not have much adjustable features.
+
+For more information about RF tuners see
+`Tuner (radio) <http://en.wikipedia.org/wiki/Tuner_%28radio%29>`__
+and `RF front end <http://en.wikipedia.org/wiki/RF_front_end>`__
+from Wikipedia.
+
+
+.. _rf-tuner-control-id:
+
+RF_TUNER Control IDs
+--------------------
+
+``V4L2_CID_RF_TUNER_CLASS (class)``
+    The RF_TUNER class descriptor. Calling
+    :ref:`VIDIOC_QUERYCTRL <vidioc-queryctrl>` for this control will
+    return a description of this control class.
+
+``V4L2_CID_RF_TUNER_BANDWIDTH_AUTO (boolean)``
+    Enables/disables tuner radio channel bandwidth configuration. In
+    automatic mode bandwidth configuration is performed by the driver.
+
+``V4L2_CID_RF_TUNER_BANDWIDTH (integer)``
+    Filter(s) on tuner signal path are used to filter signal according
+    to receiving party needs. Driver configures filters to fulfill
+    desired bandwidth requirement. Used when
+    V4L2_CID_RF_TUNER_BANDWIDTH_AUTO is not set. Unit is in Hz. The
+    range and step are driver-specific.
+
+``V4L2_CID_RF_TUNER_LNA_GAIN_AUTO (boolean)``
+    Enables/disables LNA automatic gain control (AGC)
+
+``V4L2_CID_RF_TUNER_MIXER_GAIN_AUTO (boolean)``
+    Enables/disables mixer automatic gain control (AGC)
+
+``V4L2_CID_RF_TUNER_IF_GAIN_AUTO (boolean)``
+    Enables/disables IF automatic gain control (AGC)
+
+``V4L2_CID_RF_TUNER_RF_GAIN (integer)``
+    The RF amplifier is the very first amplifier on the receiver signal
+    path, just right after the antenna input. The difference between the
+    LNA gain and the RF gain in this document is that the LNA gain is
+    integrated in the tuner chip while the RF gain is a separate chip.
+    There may be both RF and LNA gain controls in the same device. The
+    range and step are driver-specific.
+
+``V4L2_CID_RF_TUNER_LNA_GAIN (integer)``
+    LNA (low noise amplifier) gain is first gain stage on the RF tuner
+    signal path. It is located very close to tuner antenna input. Used
+    when ``V4L2_CID_RF_TUNER_LNA_GAIN_AUTO`` is not set. See
+    ``V4L2_CID_RF_TUNER_RF_GAIN`` to understand how RF gain and LNA gain
+    differs from the each others. The range and step are
+    driver-specific.
+
+``V4L2_CID_RF_TUNER_MIXER_GAIN (integer)``
+    Mixer gain is second gain stage on the RF tuner signal path. It is
+    located inside mixer block, where RF signal is down-converted by the
+    mixer. Used when ``V4L2_CID_RF_TUNER_MIXER_GAIN_AUTO`` is not set.
+    The range and step are driver-specific.
+
+``V4L2_CID_RF_TUNER_IF_GAIN (integer)``
+    IF gain is last gain stage on the RF tuner signal path. It is
+    located on output of RF tuner. It controls signal level of
+    intermediate frequency output or baseband output. Used when
+    ``V4L2_CID_RF_TUNER_IF_GAIN_AUTO`` is not set. The range and step
+    are driver-specific.
+
+``V4L2_CID_RF_TUNER_PLL_LOCK (boolean)``
+    Is synthesizer PLL locked? RF tuner is receiving given frequency
+    when that control is set. This is a read-only control.
+
+.. [1]
+   This control may be changed to a menu control in the future, if more
+   options are required.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/fdl-appendix.rst b/Documentation/linux_tv/media/v4l/fdl-appendix.rst
new file mode 100644
index 000000000000..4a7be9b00670
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/fdl-appendix.rst
@@ -0,0 +1,487 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _fdl:
+
+******************************
+GNU Free Documentation License
+******************************
+
+
+.. _fdl-preamble:
+
+0. PREAMBLE
+===========
+
+The purpose of this License is to make a manual, textbook, or other
+written document “free” in the sense of freedom: to assure everyone the
+effective freedom to copy and redistribute it, with or without modifying
+it, either commercially or noncommercially. Secondarily, this License
+preserves for the author and publisher a way to get credit for their
+work, while not being considered responsible for modifications made by
+others.
+
+This License is a kind of “copyleft”, which means that derivative works
+of the document must themselves be free in the same sense. It
+complements the GNU General Public License, which is a copyleft license
+designed for free software.
+
+We have designed this License in order to use it for manuals for free
+software, because free software needs free documentation: a free program
+should come with manuals providing the same freedoms that the software
+does. But this License is not limited to software manuals; it can be
+used for any textual work, regardless of subject matter or whether it is
+published as a printed book. We recommend this License principally for
+works whose purpose is instruction or reference.
+
+
+.. _fdl-section1:
+
+1. APPLICABILITY AND DEFINITIONS
+================================
+
+
+.. _fdl-document:
+This License applies to any manual or other work that contains a notice
+placed by the copyright holder saying it can be distributed under the
+terms of this License. The “Document”, below, refers to any such manual
+or work. Any member of the public is a licensee, and is addressed as
+“you”.
+
+
+.. _fdl-modified:
+A “Modified Version” of the Document means any work containing the
+Document or a portion of it, either copied verbatim, or with
+modifications and/or translated into another language.
+
+
+.. _fdl-secondary:
+A “Secondary Section” is a named appendix or a front-matter section of
+the :ref:`Document <fdl-document>` that deals exclusively with the
+relationship of the publishers or authors of the Document to the
+Document's overall subject (or to related matters) and contains nothing
+that could fall directly within that overall subject. (For example, if
+the Document is in part a textbook of mathematics, a Secondary Section
+may not explain any mathematics.) The relationship could be a matter of
+historical connection with the subject or with related matters, or of
+legal, commercial, philosophical, ethical or political position
+regarding them.
+
+
+.. _fdl-invariant:
+The “Invariant Sections” are certain
+:ref:`Secondary Sections <fdl-secondary>` whose titles are designated,
+as being those of Invariant Sections, in the notice that says that the
+:ref:`Document <fdl-document>` is released under this License.
+
+
+.. _fdl-cover-texts:
+The “Cover Texts” are certain short passages of text that are listed, as
+Front-Cover Texts or Back-Cover Texts, in the notice that says that the
+:ref:`Document <fdl-document>` is released under this License.
+
+
+.. _fdl-transparent:
+A “Transparent” copy of the :ref:`Document <fdl-document>` means a
+machine-readable copy, represented in a format whose specification is
+available to the general public, whose contents can be viewed and edited
+directly and straightforwardly with generic text editors or (for images
+composed of pixels) generic paint programs or (for drawings) some widely
+available drawing editor, and that is suitable for input to text
+formatters or for automatic translation to a variety of formats suitable
+for input to text formatters. A copy made in an otherwise Transparent
+file format whose markup has been designed to thwart or discourage
+subsequent modification by readers is not Transparent. A copy that is
+not “Transparent” is called “Opaque”.
+
+Examples of suitable formats for Transparent copies include plain ASCII
+without markup, Texinfo input format, LaTeX input format, SGML or XML
+using a publicly available DTD, and standard-conforming simple HTML
+designed for human modification. Opaque formats include PostScript, PDF,
+proprietary formats that can be read and edited only by proprietary word
+processors, SGML or XML for which the DTD and/or processing tools are
+not generally available, and the machine-generated HTML produced by some
+word processors for output purposes only.
+
+
+.. _fdl-title-page:
+The “Title Page” means, for a printed book, the title page itself, plus
+such following pages as are needed to hold, legibly, the material this
+License requires to appear in the title page. For works in formats which
+do not have any title page as such, “Title Page” means the text near the
+most prominent appearance of the work's title, preceding the beginning
+of the body of the text.
+
+
+.. _fdl-section2:
+
+2. VERBATIM COPYING
+===================
+
+You may copy and distribute the :ref:`Document <fdl-document>` in any
+medium, either commercially or noncommercially, provided that this
+License, the copyright notices, and the license notice saying this
+License applies to the Document are reproduced in all copies, and that
+you add no other conditions whatsoever to those of this License. You may
+not use technical measures to obstruct or control the reading or further
+copying of the copies you make or distribute. However, you may accept
+compensation in exchange for copies. If you distribute a large enough
+number of copies you must also follow the conditions in
+:ref:`section 3 <fdl-section3>`.
+
+You may also lend copies, under the same conditions stated above, and
+you may publicly display copies.
+
+
+.. _fdl-section3:
+
+3. COPYING IN QUANTITY
+======================
+
+If you publish printed copies of the :ref:`Document <fdl-document>`
+numbering more than 100, and the Document's license notice requires
+:ref:`Cover Texts <fdl-cover-texts>`, you must enclose the copies in
+covers that carry, clearly and legibly, all these Cover Texts:
+Front-Cover Texts on the front cover, and Back-Cover Texts on the back
+cover. Both covers must also clearly and legibly identify you as the
+publisher of these copies. The front cover must present the full title
+with all words of the title equally prominent and visible. You may add
+other material on the covers in addition. Copying with changes limited
+to the covers, as long as they preserve the title of the
+:ref:`Document <fdl-document>` and satisfy these conditions, can be
+treated as verbatim copying in other respects.
+
+If the required texts for either cover are too voluminous to fit
+legibly, you should put the first ones listed (as many as fit
+reasonably) on the actual cover, and continue the rest onto adjacent
+pages.
+
+If you publish or distribute :ref:`Opaque <fdl-transparent>` copies of
+the :ref:`Document <fdl-document>` numbering more than 100, you must
+either include a machine-readable :ref:`Transparent <fdl-transparent>`
+copy along with each Opaque copy, or state in or with each Opaque copy a
+publicly-accessible computer-network location containing a complete
+Transparent copy of the Document, free of added material, which the
+general network-using public has access to download anonymously at no
+charge using public-standard network protocols. If you use the latter
+option, you must take reasonably prudent steps, when you begin
+distribution of Opaque copies in quantity, to ensure that this
+Transparent copy will remain thus accessible at the stated location
+until at least one year after the last time you distribute an Opaque
+copy (directly or through your agents or retailers) of that edition to
+the public.
+
+It is requested, but not required, that you contact the authors of the
+:ref:`Document <fdl-document>` well before redistributing any large
+number of copies, to give them a chance to provide you with an updated
+version of the Document.
+
+
+.. _fdl-section4:
+
+4. MODIFICATIONS
+================
+
+You may copy and distribute a :ref:`Modified Version <fdl-modified>`
+of the :ref:`Document <fdl-document>` under the conditions of sections
+:ref:`2 <fdl-section2>` and :ref:`3 <fdl-section3>` above, provided
+that you release the Modified Version under precisely this License, with
+the Modified Version filling the role of the Document, thus licensing
+distribution and modification of the Modified Version to whoever
+possesses a copy of it. In addition, you must do these things in the
+Modified Version:
+
+-  **A.**
+
+   Use in the :ref:`Title Page <fdl-title-page>` (and on the covers,
+   if any) a title distinct from that of the
+   :ref:`Document <fdl-document>`, and from those of previous versions
+   (which should, if there were any, be listed in the History section of
+   the Document). You may use the same title as a previous version if
+   the original publisher of that version gives permission.
+
+-  **B.**
+
+   List on the :ref:`Title Page <fdl-title-page>`, as authors, one or
+   more persons or entities responsible for authorship of the
+   modifications in the :ref:`Modified Version <fdl-modified>`,
+   together with at least five of the principal authors of the
+   :ref:`Document <fdl-document>` (all of its principal authors, if it
+   has less than five).
+
+-  **C.**
+
+   State on the :ref:`Title Page <fdl-title-page>` the name of the
+   publisher of the :ref:`Modified Version <fdl-modified>`, as the
+   publisher.
+
+-  **D.**
+
+   Preserve all the copyright notices of the
+   :ref:`Document <fdl-document>`.
+
+-  **E.**
+
+   Add an appropriate copyright notice for your modifications adjacent
+   to the other copyright notices.
+
+-  **F.**
+
+   Include, immediately after the copyright notices, a license notice
+   giving the public permission to use the
+   :ref:`Modified Version <fdl-modified>` under the terms of this
+   License, in the form shown in the Addendum below.
+
+-  **G.**
+
+   Preserve in that license notice the full lists of
+   :ref:`Invariant Sections <fdl-invariant>` and required
+   :ref:`Cover Texts <fdl-cover-texts>` given in the
+   :ref:`Document's <fdl-document>` license notice.
+
+-  **H.**
+
+   Include an unaltered copy of this License.
+
+-  **I.**
+
+   Preserve the section entitled “History”, and its title, and add to it
+   an item stating at least the title, year, new authors, and publisher
+   of the :ref:`Modified Version <fdl-modified>`as given on the
+   :ref:`Title Page <fdl-title-page>`. If there is no section entitled
+   “History” in the :ref:`Document <fdl-document>`, create one stating
+   the title, year, authors, and publisher of the Document as given on
+   its Title Page, then add an item describing the Modified Version as
+   stated in the previous sentence.
+
+-  **J.**
+
+   Preserve the network location, if any, given in the
+   :ref:`Document <fdl-document>` for public access to a
+   :ref:`Transparent <fdl-transparent>` copy of the Document, and
+   likewise the network locations given in the Document for previous
+   versions it was based on. These may be placed in the “History”
+   section. You may omit a network location for a work that was
+   published at least four years before the Document itself, or if the
+   original publisher of the version it refers to gives permission.
+
+-  **K.**
+
+   In any section entitled “Acknowledgements” or “Dedications”, preserve
+   the section's title, and preserve in the section all the substance
+   and tone of each of the contributor acknowledgements and/or
+   dedications given therein.
+
+-  **L.**
+
+   Preserve all the :ref:`Invariant Sections <fdl-invariant>` of the
+   :ref:`Document <fdl-document>`, unaltered in their text and in
+   their titles. Section numbers or the equivalent are not considered
+   part of the section titles.
+
+-  **M.**
+
+   Delete any section entitled “Endorsements”. Such a section may not be
+   included in the :ref:`Modified Version <fdl-modified>`.
+
+-  **N.**
+
+   Do not retitle any existing section as “Endorsements” or to conflict
+   in title with any :ref:`Invariant Section <fdl-invariant>`.
+
+If the :ref:`Modified Version <fdl-modified>` includes new
+front-matter sections or appendices that qualify as
+:ref:`Secondary Sections <fdl-secondary>` and contain no material
+copied from the Document, you may at your option designate some or all
+of these sections as invariant. To do this, add their titles to the list
+of :ref:`Invariant Sections <fdl-invariant>` in the Modified Version's
+license notice. These titles must be distinct from any other section
+titles.
+
+You may add a section entitled “Endorsements”, provided it contains
+nothing but endorsements of your
+:ref:`Modified Version <fdl-modified>` by various parties--for
+example, statements of peer review or that the text has been approved by
+an organization as the authoritative definition of a standard.
+
+You may add a passage of up to five words as a
+:ref:`Front-Cover Text <fdl-cover-texts>`, and a passage of up to 25
+words as a :ref:`Back-Cover Text <fdl-cover-texts>`, to the end of the
+list of :ref:`Cover Texts <fdl-cover-texts>` in the
+:ref:`Modified Version <fdl-modified>`. Only one passage of
+Front-Cover Text and one of Back-Cover Text may be added by (or through
+arrangements made by) any one entity. If the
+:ref:`Document <fdl-document>` already includes a cover text for the
+same cover, previously added by you or by arrangement made by the same
+entity you are acting on behalf of, you may not add another; but you may
+replace the old one, on explicit permission from the previous publisher
+that added the old one.
+
+The author(s) and publisher(s) of the :ref:`Document <fdl-document>`
+do not by this License give permission to use their names for publicity
+for or to assert or imply endorsement of any
+:ref:`Modified Version <fdl-modified>`.
+
+
+.. _fdl-section5:
+
+5. COMBINING DOCUMENTS
+======================
+
+You may combine the :ref:`Document <fdl-document>` with other
+documents released under this License, under the terms defined in
+:ref:`section 4 <fdl-section4>` above for modified versions, provided
+that you include in the combination all of the
+:ref:`Invariant Sections <fdl-invariant>` of all of the original
+documents, unmodified, and list them all as Invariant Sections of your
+combined work in its license notice.
+
+The combined work need only contain one copy of this License, and
+multiple identical :ref:`Invariant Sections <fdl-invariant>` may be
+replaced with a single copy. If there are multiple Invariant Sections
+with the same name but different contents, make the title of each such
+section unique by adding at the end of it, in parentheses, the name of
+the original author or publisher of that section if known, or else a
+unique number. Make the same adjustment to the section titles in the
+list of Invariant Sections in the license notice of the combined work.
+
+In the combination, you must combine any sections entitled “History” in
+the various original documents, forming one section entitled “History”;
+likewise combine any sections entitled “Acknowledgements”, and any
+sections entitled “Dedications”. You must delete all sections entitled
+“Endorsements.”
+
+
+.. _fdl-section6:
+
+6. COLLECTIONS OF DOCUMENTS
+===========================
+
+You may make a collection consisting of the
+:ref:`Document <fdl-document>` and other documents released under this
+License, and replace the individual copies of this License in the
+various documents with a single copy that is included in the collection,
+provided that you follow the rules of this License for verbatim copying
+of each of the documents in all other respects.
+
+You may extract a single document from such a collection, and dispbibute
+it individually under this License, provided you insert a copy of this
+License into the extracted document, and follow this License in all
+other respects regarding verbatim copying of that document.
+
+
+.. _fdl-section7:
+
+7. AGGREGATION WITH INDEPENDENT WORKS
+=====================================
+
+A compilation of the :ref:`Document <fdl-document>` or its derivatives
+with other separate and independent documents or works, in or on a
+volume of a storage or distribution medium, does not as a whole count as
+a :ref:`Modified Version <fdl-modified>` of the Document, provided no
+compilation copyright is claimed for the compilation. Such a compilation
+is called an “aggregate”, and this License does not apply to the other
+self-contained works thus compiled with the Document , on account of
+their being thus compiled, if they are not themselves derivative works
+of the Document. If the :ref:`Cover Text <fdl-cover-texts>`
+requirement of :ref:`section 3 <fdl-section3>` is applicable to these
+copies of the Document, then if the Document is less than one quarter of
+the entire aggregate, the Document's Cover Texts may be placed on covers
+that surround only the Document within the aggregate. Otherwise they
+must appear on covers around the whole aggregate.
+
+
+.. _fdl-section8:
+
+8. TRANSLATION
+==============
+
+Translation is considered a kind of modification, so you may distribute
+translations of the :ref:`Document <fdl-document>` under the terms of
+:ref:`section 4 <fdl-section4>`. Replacing
+:ref:`Invariant Sections <fdl-invariant>` with translations requires
+special permission from their copyright holders, but you may include
+translations of some or all Invariant Sections in addition to the
+original versions of these Invariant Sections. You may include a
+translation of this License provided that you also include the original
+English version of this License. In case of a disagreement between the
+translation and the original English version of this License, the
+original English version will prevail.
+
+
+.. _fdl-section9:
+
+9. TERMINATION
+==============
+
+You may not copy, modify, sublicense, or distribute the
+:ref:`Document <fdl-document>` except as expressly provided for under
+this License. Any other attempt to copy, modify, sublicense or
+distribute the Document is void, and will automatically terminate your
+rights under this License. However, parties who have received copies, or
+rights, from you under this License will not have their licenses
+terminated so long as such parties remain in full compliance.
+
+
+.. _fdl-section10:
+
+10. FUTURE REVISIONS OF THIS LICENSE
+====================================
+
+The `Free Software Foundation <http://www.gnu.org/fsf/fsf.html>`__
+may publish new, revised versions of the GNU Free Documentation License
+from time to time. Such new versions will be similar in spirit to the
+present version, but may differ in detail to address new problems or
+concerns. See
+`http://www.gnu.org/copyleft/ <http://www.gnu.org/copyleft>`__.
+
+Each version of the License is given a distinguishing version number. If
+the :ref:`Document <fdl-document>` specifies that a particular
+numbered version of this License “or any later version” applies to it,
+you have the option of following the terms and conditions either of that
+specified version or of any later version that has been published (not
+as a draft) by the Free Software Foundation. If the Document does not
+specify a version number of this License, you may choose any version
+ever published (not as a draft) by the Free Software Foundation.
+
+
+.. _fdl-using:
+
+Addendum
+========
+
+To use this License in a document you have written, include a copy of
+the License in the document and put the following copyright and license
+notices just after the title page:
+
+    Copyright © YEAR YOUR NAME.
+
+    Permission is granted to copy, distribute and/or modify this
+    document under the terms of the GNU Free Documentation License,
+    Version 1.1 or any later version published by the Free Software
+    Foundation; with the :ref:`Invariant Sections <fdl-invariant>`
+    being LIST THEIR TITLES, with the
+    :ref:`Front-Cover Texts <fdl-cover-texts>` being LIST, and with
+    the :ref:`Back-Cover Texts <fdl-cover-texts>` being LIST. A copy
+    of the license is included in the section entitled “GNU Free
+    Documentation License”.
+
+If you have no :ref:`Invariant Sections <fdl-invariant>`, write “with
+no Invariant Sections” instead of saying which ones are invariant. If
+you have no :ref:`Front-Cover Texts <fdl-cover-texts>`, write “no
+Front-Cover Texts” instead of “Front-Cover Texts being LIST”; likewise
+for :ref:`Back-Cover Texts <fdl-cover-texts>`.
+
+If your document contains nontrivial examples of program code, we
+recommend releasing these examples in parallel under your choice of free
+software license, such as the
+`GNU General Public License <http://www.gnu.org/copyleft/gpl.html>`__,
+to permit their use in free software.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/field-order.rst b/Documentation/linux_tv/media/v4l/field-order.rst
new file mode 100644
index 000000000000..295ec0430183
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/field-order.rst
@@ -0,0 +1,210 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _field-order:
+
+***********
+Field Order
+***********
+
+We have to distinguish between progressive and interlaced video.
+Progressive video transmits all lines of a video image sequentially.
+Interlaced video divides an image into two fields, containing only the
+odd and even lines of the image, respectively. Alternating the so called
+odd and even field are transmitted, and due to a small delay between
+fields a cathode ray TV displays the lines interleaved, yielding the
+original frame. This curious technique was invented because at refresh
+rates similar to film the image would fade out too quickly. Transmitting
+fields reduces the flicker without the necessity of doubling the frame
+rate and with it the bandwidth required for each channel.
+
+It is important to understand a video camera does not expose one frame
+at a time, merely transmitting the frames separated into fields. The
+fields are in fact captured at two different instances in time. An
+object on screen may well move between one field and the next. For
+applications analysing motion it is of paramount importance to recognize
+which field of a frame is older, the *temporal order*.
+
+When the driver provides or accepts images field by field rather than
+interleaved, it is also important applications understand how the fields
+combine to frames. We distinguish between top (aka odd) and bottom (aka
+even) fields, the *spatial order*: The first line of the top field is
+the first line of an interlaced frame, the first line of the bottom
+field is the second line of that frame.
+
+However because fields were captured one after the other, arguing
+whether a frame commences with the top or bottom field is pointless. Any
+two successive top and bottom, or bottom and top fields yield a valid
+frame. Only when the source was progressive to begin with, e. g. when
+transferring film to video, two fields may come from the same frame,
+creating a natural order.
+
+Counter to intuition the top field is not necessarily the older field.
+Whether the older field contains the top or bottom lines is a convention
+determined by the video standard. Hence the distinction between temporal
+and spatial order of fields. The diagrams below should make this
+clearer.
+
+All video capture and output devices must report the current field
+order. Some drivers may permit the selection of a different order, to
+this end applications initialize the ``field`` field of struct
+:ref:`v4l2_pix_format <v4l2-pix-format>` before calling the
+:ref:`VIDIOC_S_FMT <vidioc-g-fmt>` ioctl. If this is not desired it
+should have the value ``V4L2_FIELD_ANY`` (0).
+
+
+.. _v4l2-field:
+
+.. flat-table:: enum v4l2_field
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_FIELD_ANY``
+
+       -  0
+
+       -  Applications request this field order when any one of the
+          ``V4L2_FIELD_NONE``, ``V4L2_FIELD_TOP``, ``V4L2_FIELD_BOTTOM``, or
+          ``V4L2_FIELD_INTERLACED`` formats is acceptable. Drivers choose
+          depending on hardware capabilities or e. g. the requested image
+          size, and return the actual field order. Drivers must never return
+          ``V4L2_FIELD_ANY``. If multiple field orders are possible the
+          driver must choose one of the possible field orders during
+          :ref:`VIDIOC_S_FMT <vidioc-g-fmt>` or
+          :ref:`VIDIOC_TRY_FMT <vidioc-g-fmt>`. struct
+          :ref:`v4l2_buffer <v4l2-buffer>` ``field`` can never be
+          ``V4L2_FIELD_ANY``.
+
+    -  .. row 2
+
+       -  ``V4L2_FIELD_NONE``
+
+       -  1
+
+       -  Images are in progressive format, not interlaced. The driver may
+          also indicate this order when it cannot distinguish between
+          ``V4L2_FIELD_TOP`` and ``V4L2_FIELD_BOTTOM``.
+
+    -  .. row 3
+
+       -  ``V4L2_FIELD_TOP``
+
+       -  2
+
+       -  Images consist of the top (aka odd) field only.
+
+    -  .. row 4
+
+       -  ``V4L2_FIELD_BOTTOM``
+
+       -  3
+
+       -  Images consist of the bottom (aka even) field only. Applications
+          may wish to prevent a device from capturing interlaced images
+          because they will have "comb" or "feathering" artefacts around
+          moving objects.
+
+    -  .. row 5
+
+       -  ``V4L2_FIELD_INTERLACED``
+
+       -  4
+
+       -  Images contain both fields, interleaved line by line. The temporal
+          order of the fields (whether the top or bottom field is first
+          transmitted) depends on the current video standard. M/NTSC
+          transmits the bottom field first, all other standards the top
+          field first.
+
+    -  .. row 6
+
+       -  ``V4L2_FIELD_SEQ_TB``
+
+       -  5
+
+       -  Images contain both fields, the top field lines are stored first
+          in memory, immediately followed by the bottom field lines. Fields
+          are always stored in temporal order, the older one first in
+          memory. Image sizes refer to the frame, not fields.
+
+    -  .. row 7
+
+       -  ``V4L2_FIELD_SEQ_BT``
+
+       -  6
+
+       -  Images contain both fields, the bottom field lines are stored
+          first in memory, immediately followed by the top field lines.
+          Fields are always stored in temporal order, the older one first in
+          memory. Image sizes refer to the frame, not fields.
+
+    -  .. row 8
+
+       -  ``V4L2_FIELD_ALTERNATE``
+
+       -  7
+
+       -  The two fields of a frame are passed in separate buffers, in
+          temporal order, i. e. the older one first. To indicate the field
+          parity (whether the current field is a top or bottom field) the
+          driver or application, depending on data direction, must set
+          struct :ref:`v4l2_buffer <v4l2-buffer>` ``field`` to
+          ``V4L2_FIELD_TOP`` or ``V4L2_FIELD_BOTTOM``. Any two successive
+          fields pair to build a frame. If fields are successive, without
+          any dropped fields between them (fields can drop individually),
+          can be determined from the struct
+          :ref:`v4l2_buffer <v4l2-buffer>` ``sequence`` field. This
+          format cannot be selected when using the read/write I/O method
+          since there is no way to communicate if a field was a top or
+          bottom field.
+
+    -  .. row 9
+
+       -  ``V4L2_FIELD_INTERLACED_TB``
+
+       -  8
+
+       -  Images contain both fields, interleaved line by line, top field
+          first. The top field is transmitted first.
+
+    -  .. row 10
+
+       -  ``V4L2_FIELD_INTERLACED_BT``
+
+       -  9
+
+       -  Images contain both fields, interleaved line by line, top field
+          first. The bottom field is transmitted first.
+
+
+
+.. _fieldseq-tb:
+
+.. figure::  field-order_files/fieldseq_tb.*
+    :alt:    fieldseq_tb.pdf / fieldseq_tb.gif
+    :align:  center
+
+    Field Order, Top Field First Transmitted
+
+
+.. _fieldseq-bt:
+
+.. figure::  field-order_files/fieldseq_bt.*
+    :alt:    fieldseq_bt.pdf / fieldseq_bt.gif
+    :align:  center
+
+    Field Order, Bottom Field First Transmitted
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/field-order_files/fieldseq_bt.gif b/Documentation/linux_tv/media/v4l/field-order_files/fieldseq_bt.gif
new file mode 100644
index 0000000000000000000000000000000000000000..60e8569a76c92e7ab45068306dc736771fa3a61e
GIT binary patch
literal 25430
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
RmMaODaVeK`xi<j;06T_Ydy4=7

literal 0
HcmV?d00001

diff --git a/Documentation/linux_tv/media/v4l/field-order_files/fieldseq_bt.pdf b/Documentation/linux_tv/media/v4l/field-order_files/fieldseq_bt.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..26598b23f80daf8048fdaa9a83a39a0e8ba12f19
GIT binary patch
literal 9185
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
UbNNdS($XYgVM<D-c4n~u2a2_wzyJUM

literal 0
HcmV?d00001

diff --git a/Documentation/linux_tv/media/v4l/field-order_files/fieldseq_tb.gif b/Documentation/linux_tv/media/v4l/field-order_files/fieldseq_tb.gif
new file mode 100644
index 0000000000000000000000000000000000000000..718492f1cfc703e6553c3b0e2afc4b269258412b
GIT binary patch
literal 25323
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
ODXEex$&zjp5CA*JsW6`a

literal 0
HcmV?d00001

diff --git a/Documentation/linux_tv/media/v4l/field-order_files/fieldseq_tb.pdf b/Documentation/linux_tv/media/v4l/field-order_files/fieldseq_tb.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..4965b22ddb3a85aa27a4e6f98c931323605dd26e
GIT binary patch
literal 9173
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

literal 0
HcmV?d00001

diff --git a/Documentation/linux_tv/media/v4l/format.rst b/Documentation/linux_tv/media/v4l/format.rst
new file mode 100644
index 000000000000..c1e30a64c833
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/format.rst
@@ -0,0 +1,101 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _format:
+
+************
+Data Formats
+************
+
+
+Data Format Negotiation
+=======================
+
+Different devices exchange different kinds of data with applications,
+for example video images, raw or sliced VBI data, RDS datagrams. Even
+within one kind many different formats are possible, in particular an
+abundance of image formats. Although drivers must provide a default and
+the selection persists across closing and reopening a device,
+applications should always negotiate a data format before engaging in
+data exchange. Negotiation means the application asks for a particular
+format and the driver selects and reports the best the hardware can do
+to satisfy the request. Of course applications can also just query the
+current selection.
+
+A single mechanism exists to negotiate all data formats using the
+aggregate struct :ref:`v4l2_format <v4l2-format>` and the
+:ref:`VIDIOC_G_FMT <vidioc-g-fmt>` and
+:ref:`VIDIOC_S_FMT <vidioc-g-fmt>` ioctls. Additionally the
+:ref:`VIDIOC_TRY_FMT <vidioc-g-fmt>` ioctl can be used to examine
+what the hardware *could* do, without actually selecting a new data
+format. The data formats supported by the V4L2 API are covered in the
+respective device section in :ref:`devices`. For a closer look at
+image formats see :ref:`pixfmt`.
+
+The ``VIDIOC_S_FMT`` ioctl is a major turning-point in the
+initialization sequence. Prior to this point multiple panel applications
+can access the same device concurrently to select the current input,
+change controls or modify other properties. The first ``VIDIOC_S_FMT``
+assigns a logical stream (video data, VBI data etc.) exclusively to one
+file descriptor.
+
+Exclusive means no other application, more precisely no other file
+descriptor, can grab this stream or change device properties
+inconsistent with the negotiated parameters. A video standard change for
+example, when the new standard uses a different number of scan lines,
+can invalidate the selected image format. Therefore only the file
+descriptor owning the stream can make invalidating changes. Accordingly
+multiple file descriptors which grabbed different logical streams
+prevent each other from interfering with their settings. When for
+example video overlay is about to start or already in progress,
+simultaneous video capturing may be restricted to the same cropping and
+image size.
+
+When applications omit the ``VIDIOC_S_FMT`` ioctl its locking side
+effects are implied by the next step, the selection of an I/O method
+with the :ref:`VIDIOC_REQBUFS <vidioc-reqbufs>` ioctl or implicit
+with the first :ref:`read() <func-read>` or
+:ref:`write() <func-write>` call.
+
+Generally only one logical stream can be assigned to a file descriptor,
+the exception being drivers permitting simultaneous video capturing and
+overlay using the same file descriptor for compatibility with V4L and
+earlier versions of V4L2. Switching the logical stream or returning into
+"panel mode" is possible by closing and reopening the device. Drivers
+*may* support a switch using ``VIDIOC_S_FMT``.
+
+All drivers exchanging data with applications must support the
+``VIDIOC_G_FMT`` and ``VIDIOC_S_FMT`` ioctl. Implementation of the
+``VIDIOC_TRY_FMT`` is highly recommended but optional.
+
+
+Image Format Enumeration
+========================
+
+Apart of the generic format negotiation functions a special ioctl to
+enumerate all image formats supported by video capture, overlay or
+output devices is available. [1]_
+
+The :ref:`VIDIOC_ENUM_FMT <vidioc-enum-fmt>` ioctl must be supported
+by all drivers exchanging image data with applications.
+
+    **Important**
+
+    Drivers are not supposed to convert image formats in kernel space.
+    They must enumerate only formats directly supported by the hardware.
+    If necessary driver writers should publish an example conversion
+    routine or library for integration into applications.
+
+.. [1]
+   Enumerating formats an application has no a-priori knowledge of
+   (otherwise it could explicitly ask for them and need not enumerate)
+   seems useless, but there are applications serving as proxy between
+   drivers and the actual video applications for which this is useful.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/func-close.rst b/Documentation/linux_tv/media/v4l/func-close.rst
new file mode 100644
index 000000000000..28fd055bf71b
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/func-close.rst
@@ -0,0 +1,56 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _func-close:
+
+************
+V4L2 close()
+************
+
+*man v4l2-close(2)*
+
+Close a V4L2 device
+
+
+Synopsis
+========
+
+.. code-block:: c
+
+    #include <unistd.h>
+
+
+.. c:function:: int close( int fd )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+
+Description
+===========
+
+Closes the device. Any I/O in progress is terminated and resources
+associated with the file descriptor are freed. However data format
+parameters, current input or output, control values or other properties
+remain unchanged.
+
+
+Return Value
+============
+
+The function returns 0 on success, -1 on failure and the ``errno`` is
+set appropriately. Possible error codes:
+
+EBADF
+    ``fd`` is not a valid open file descriptor.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/func-ioctl.rst b/Documentation/linux_tv/media/v4l/func-ioctl.rst
new file mode 100644
index 000000000000..774ac4cbb6b8
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/func-ioctl.rst
@@ -0,0 +1,69 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _func-ioctl:
+
+************
+V4L2 ioctl()
+************
+
+*man v4l2-ioctl(2)*
+
+Program a V4L2 device
+
+
+Synopsis
+========
+
+.. code-block:: c
+
+    #include <sys/ioctl.h>
+
+
+.. c:function:: int ioctl( int fd, int request, void *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    V4L2 ioctl request code as defined in the ``videodev2.h`` header
+    file, for example VIDIOC_QUERYCAP.
+
+``argp``
+    Pointer to a function parameter, usually a structure.
+
+
+Description
+===========
+
+The :c:func:`ioctl()` function is used to program V4L2 devices. The
+argument ``fd`` must be an open file descriptor. An ioctl ``request``
+has encoded in it whether the argument is an input, output or read/write
+parameter, and the size of the argument ``argp`` in bytes. Macros and
+defines specifying V4L2 ioctl requests are located in the
+``videodev2.h`` header file. Applications should use their own copy, not
+include the version in the kernel sources on the system they compile on.
+All V4L2 ioctl requests, their respective function and parameters are
+specified in :ref:`user-func`.
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+When an ioctl that takes an output or read/write parameter fails, the
+parameter remains unmodified.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/func-mmap.rst b/Documentation/linux_tv/media/v4l/func-mmap.rst
new file mode 100644
index 000000000000..fb6e4cd52e24
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/func-mmap.rst
@@ -0,0 +1,141 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _func-mmap:
+
+***********
+V4L2 mmap()
+***********
+
+*man v4l2-mmap(2)*
+
+Map device memory into application address space
+
+
+Synopsis
+========
+
+.. code-block:: c
+
+    #include <unistd.h>
+    #include <sys/mman.h>
+
+
+.. c:function:: void *mmap( void *start, size_t length, int prot, int flags, int fd, off_t offset )
+
+Arguments
+=========
+
+``start``
+    Map the buffer to this address in the application's address space.
+    When the ``MAP_FIXED`` flag is specified, ``start`` must be a
+    multiple of the pagesize and mmap will fail when the specified
+    address cannot be used. Use of this option is discouraged;
+    applications should just specify a ``NULL`` pointer here.
+
+``length``
+    Length of the memory area to map. This must be the same value as
+    returned by the driver in the struct
+    :ref:`v4l2_buffer <v4l2-buffer>` ``length`` field for the
+    single-planar API, and the same value as returned by the driver in
+    the struct :ref:`v4l2_plane <v4l2-plane>` ``length`` field for
+    the multi-planar API.
+
+``prot``
+    The ``prot`` argument describes the desired memory protection.
+    Regardless of the device type and the direction of data exchange it
+    should be set to ``PROT_READ`` | ``PROT_WRITE``, permitting read
+    and write access to image buffers. Drivers should support at least
+    this combination of flags. Note the Linux ``video-buf`` kernel
+    module, which is used by the bttv, saa7134, saa7146, cx88 and vivi
+    driver supports only ``PROT_READ`` | ``PROT_WRITE``. When the
+    driver does not support the desired protection the
+    :c:func:`mmap()` function fails.
+
+    Note device memory accesses (e. g. the memory on a graphics card
+    with video capturing hardware) may incur a performance penalty
+    compared to main memory accesses, or reads may be significantly
+    slower than writes or vice versa. Other I/O methods may be more
+    efficient in this case.
+
+``flags``
+    The ``flags`` parameter specifies the type of the mapped object,
+    mapping options and whether modifications made to the mapped copy of
+    the page are private to the process or are to be shared with other
+    references.
+
+    ``MAP_FIXED`` requests that the driver selects no other address than
+    the one specified. If the specified address cannot be used,
+    :c:func:`mmap()` will fail. If ``MAP_FIXED`` is specified,
+    ``start`` must be a multiple of the pagesize. Use of this option is
+    discouraged.
+
+    One of the ``MAP_SHARED`` or ``MAP_PRIVATE`` flags must be set.
+    ``MAP_SHARED`` allows applications to share the mapped memory with
+    other (e. g. child-) processes. Note the Linux ``video-buf`` module
+    which is used by the bttv, saa7134, saa7146, cx88 and vivi driver
+    supports only ``MAP_SHARED``. ``MAP_PRIVATE`` requests copy-on-write
+    semantics. V4L2 applications should not set the ``MAP_PRIVATE``,
+    ``MAP_DENYWRITE``, ``MAP_EXECUTABLE`` or ``MAP_ANON`` flag.
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``offset``
+    Offset of the buffer in device memory. This must be the same value
+    as returned by the driver in the struct
+    :ref:`v4l2_buffer <v4l2-buffer>` ``m`` union ``offset`` field for
+    the single-planar API, and the same value as returned by the driver
+    in the struct :ref:`v4l2_plane <v4l2-plane>` ``m`` union
+    ``mem_offset`` field for the multi-planar API.
+
+
+Description
+===========
+
+The :c:func:`mmap()` function asks to map ``length`` bytes starting at
+``offset`` in the memory of the device specified by ``fd`` into the
+application address space, preferably at address ``start``. This latter
+address is a hint only, and is usually specified as 0.
+
+Suitable length and offset parameters are queried with the
+:ref:`VIDIOC_QUERYBUF <vidioc-querybuf>` ioctl. Buffers must be
+allocated with the :ref:`VIDIOC_REQBUFS <vidioc-reqbufs>` ioctl
+before they can be queried.
+
+To unmap buffers the :ref:`munmap() <func-munmap>` function is used.
+
+
+Return Value
+============
+
+On success :c:func:`mmap()` returns a pointer to the mapped buffer. On
+error ``MAP_FAILED`` (-1) is returned, and the ``errno`` variable is set
+appropriately. Possible error codes are:
+
+EBADF
+    ``fd`` is not a valid file descriptor.
+
+EACCES
+    ``fd`` is not open for reading and writing.
+
+EINVAL
+    The ``start`` or ``length`` or ``offset`` are not suitable. (E. g.
+    they are too large, or not aligned on a ``PAGESIZE`` boundary.)
+
+    The ``flags`` or ``prot`` value is not supported.
+
+    No buffers have been allocated with the
+    :ref:`VIDIOC_REQBUFS <vidioc-reqbufs>` ioctl.
+
+ENOMEM
+    Not enough physical or virtual memory was available to complete the
+    request.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/func-munmap.rst b/Documentation/linux_tv/media/v4l/func-munmap.rst
new file mode 100644
index 000000000000..46c837457cae
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/func-munmap.rst
@@ -0,0 +1,65 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _func-munmap:
+
+*************
+V4L2 munmap()
+*************
+
+*man v4l2-munmap(2)*
+
+Unmap device memory
+
+
+Synopsis
+========
+
+.. code-block:: c
+
+    #include <unistd.h>
+    #include <sys/mman.h>
+
+
+.. c:function:: int munmap( void *start, size_t length )
+
+Arguments
+=========
+
+``start``
+    Address of the mapped buffer as returned by the
+    :ref:`mmap() <func-mmap>` function.
+
+``length``
+    Length of the mapped buffer. This must be the same value as given to
+    :c:func:`mmap()` and returned by the driver in the struct
+    :ref:`v4l2_buffer <v4l2-buffer>` ``length`` field for the
+    single-planar API and in the struct
+    :ref:`v4l2_plane <v4l2-plane>` ``length`` field for the
+    multi-planar API.
+
+
+Description
+===========
+
+Unmaps a previously with the :ref:`mmap() <func-mmap>` function mapped
+buffer and frees it, if possible.
+
+
+Return Value
+============
+
+On success :c:func:`munmap()` returns 0, on failure -1 and the
+``errno`` variable is set appropriately:
+
+EINVAL
+    The ``start`` or ``length`` is incorrect, or no buffers have been
+    mapped yet.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/func-open.rst b/Documentation/linux_tv/media/v4l/func-open.rst
new file mode 100644
index 000000000000..21b1dfddc118
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/func-open.rst
@@ -0,0 +1,90 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _func-open:
+
+***********
+V4L2 open()
+***********
+
+*man v4l2-open(2)*
+
+Open a V4L2 device
+
+
+Synopsis
+========
+
+.. code-block:: c
+
+    #include <fcntl.h>
+
+
+.. c:function:: int open( const char *device_name, int flags )
+
+Arguments
+=========
+
+``device_name``
+    Device to be opened.
+
+``flags``
+    Open flags. Access mode must be ``O_RDWR``. This is just a
+    technicality, input devices still support only reading and output
+    devices only writing.
+
+    When the ``O_NONBLOCK`` flag is given, the read() function and the
+    :ref:`VIDIOC_DQBUF <vidioc-qbuf>` ioctl will return the EAGAIN
+    error code when no data is available or no buffer is in the driver
+    outgoing queue, otherwise these functions block until data becomes
+    available. All V4L2 drivers exchanging data with applications must
+    support the ``O_NONBLOCK`` flag.
+
+    Other flags have no effect.
+
+
+Description
+===========
+
+To open a V4L2 device applications call :c:func:`open()` with the
+desired device name. This function has no side effects; all data format
+parameters, current input or output, control values or other properties
+remain unchanged. At the first :c:func:`open()` call after loading the
+driver they will be reset to default values, drivers are never in an
+undefined state.
+
+
+Return Value
+============
+
+On success :c:func:`open()` returns the new file descriptor. On error
+-1 is returned, and the ``errno`` variable is set appropriately.
+Possible error codes are:
+
+EACCES
+    The caller has no permission to access the device.
+
+EBUSY
+    The driver does not support multiple opens and the device is already
+    in use.
+
+ENXIO
+    No device corresponding to this device special file exists.
+
+ENOMEM
+    Not enough kernel memory was available to complete the request.
+
+EMFILE
+    The process already has the maximum number of files open.
+
+ENFILE
+    The limit on the total number of files open on the system has been
+    reached.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/func-poll.rst b/Documentation/linux_tv/media/v4l/func-poll.rst
new file mode 100644
index 000000000000..d3ad7b8d1a90
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/func-poll.rst
@@ -0,0 +1,118 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _func-poll:
+
+***********
+V4L2 poll()
+***********
+
+*man v4l2-poll(2)*
+
+Wait for some event on a file descriptor
+
+
+Synopsis
+========
+
+.. code-block:: c
+
+    #include <sys/poll.h>
+
+
+.. c:function:: int poll( struct pollfd *ufds, unsigned int nfds, int timeout )
+
+Description
+===========
+
+With the :c:func:`poll()` function applications can suspend execution
+until the driver has captured data or is ready to accept data for
+output.
+
+When streaming I/O has been negotiated this function waits until a
+buffer has been filled by the capture device and can be dequeued with
+the :ref:`VIDIOC_DQBUF <vidioc-qbuf>` ioctl. For output devices this
+function waits until the device is ready to accept a new buffer to be
+queued up with the :ref:`VIDIOC_QBUF <vidioc-qbuf>` ioctl for
+display. When buffers are already in the outgoing queue of the driver
+(capture) or the incoming queue isn't full (display) the function
+returns immediately.
+
+On success :c:func:`poll()` returns the number of file descriptors
+that have been selected (that is, file descriptors for which the
+``revents`` field of the respective :c:type:`struct pollfd` structure
+is non-zero). Capture devices set the ``POLLIN`` and ``POLLRDNORM``
+flags in the ``revents`` field, output devices the ``POLLOUT`` and
+``POLLWRNORM`` flags. When the function timed out it returns a value of
+zero, on failure it returns -1 and the ``errno`` variable is set
+appropriately. When the application did not call
+:ref:`VIDIOC_STREAMON <vidioc-streamon>` the :c:func:`poll()`
+function succeeds, but sets the ``POLLERR`` flag in the ``revents``
+field. When the application has called
+:ref:`VIDIOC_STREAMON <vidioc-streamon>` for a capture device but
+hasn't yet called :ref:`VIDIOC_QBUF <vidioc-qbuf>`, the
+:c:func:`poll()` function succeeds and sets the ``POLLERR`` flag in
+the ``revents`` field. For output devices this same situation will cause
+:c:func:`poll()` to succeed as well, but it sets the ``POLLOUT`` and
+``POLLWRNORM`` flags in the ``revents`` field.
+
+If an event occurred (see :ref:`VIDIOC_DQEVENT <vidioc-dqevent>`)
+then ``POLLPRI`` will be set in the ``revents`` field and
+:c:func:`poll()` will return.
+
+When use of the :c:func:`read()` function has been negotiated and the
+driver does not capture yet, the :c:func:`poll()` function starts
+capturing. When that fails it returns a ``POLLERR`` as above. Otherwise
+it waits until data has been captured and can be read. When the driver
+captures continuously (as opposed to, for example, still images) the
+function may return immediately.
+
+When use of the :c:func:`write()` function has been negotiated and the
+driver does not stream yet, the :c:func:`poll()` function starts
+streaming. When that fails it returns a ``POLLERR`` as above. Otherwise
+it waits until the driver is ready for a non-blocking
+:c:func:`write()` call.
+
+If the caller is only interested in events (just ``POLLPRI`` is set in
+the ``events`` field), then :c:func:`poll()` will *not* start
+streaming if the driver does not stream yet. This makes it possible to
+just poll for events and not for buffers.
+
+All drivers implementing the :c:func:`read()` or :c:func:`write()`
+function or streaming I/O must also support the :c:func:`poll()`
+function.
+
+For more details see the :c:func:`poll()` manual page.
+
+
+Return Value
+============
+
+On success, :c:func:`poll()` returns the number structures which have
+non-zero ``revents`` fields, or zero if the call timed out. On error -1
+is returned, and the ``errno`` variable is set appropriately:
+
+EBADF
+    One or more of the ``ufds`` members specify an invalid file
+    descriptor.
+
+EBUSY
+    The driver does not support multiple read or write streams and the
+    device is already in use.
+
+EFAULT
+    ``ufds`` references an inaccessible memory area.
+
+EINTR
+    The call was interrupted by a signal.
+
+EINVAL
+    The ``nfds`` argument is greater than ``OPEN_MAX``.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/func-read.rst b/Documentation/linux_tv/media/v4l/func-read.rst
new file mode 100644
index 000000000000..b46cbbdeeab7
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/func-read.rst
@@ -0,0 +1,138 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _func-read:
+
+***********
+V4L2 read()
+***********
+
+*man v4l2-read(2)*
+
+Read from a V4L2 device
+
+
+Synopsis
+========
+
+.. code-block:: c
+
+    #include <unistd.h>
+
+
+.. c:function:: ssize_t read( int fd, void *buf, size_t count )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``buf``
+``count``
+
+
+Description
+===========
+
+:c:func:`read()` attempts to read up to ``count`` bytes from file
+descriptor ``fd`` into the buffer starting at ``buf``. The layout of the
+data in the buffer is discussed in the respective device interface
+section, see ##. If ``count`` is zero, :c:func:`read()` returns zero
+and has no other results. If ``count`` is greater than ``SSIZE_MAX``,
+the result is unspecified. Regardless of the ``count`` value each
+:c:func:`read()` call will provide at most one frame (two fields)
+worth of data.
+
+By default :c:func:`read()` blocks until data becomes available. When
+the ``O_NONBLOCK`` flag was given to the :ref:`open() <func-open>`
+function it returns immediately with an EAGAIN error code when no data
+is available. The :ref:`select() <func-select>` or
+:ref:`poll() <func-poll>` functions can always be used to suspend
+execution until data becomes available. All drivers supporting the
+:c:func:`read()` function must also support :c:func:`select()` and
+:c:func:`poll()`.
+
+Drivers can implement read functionality in different ways, using a
+single or multiple buffers and discarding the oldest or newest frames
+once the internal buffers are filled.
+
+:c:func:`read()` never returns a "snapshot" of a buffer being filled.
+Using a single buffer the driver will stop capturing when the
+application starts reading the buffer until the read is finished. Thus
+only the period of the vertical blanking interval is available for
+reading, or the capture rate must fall below the nominal frame rate of
+the video standard.
+
+The behavior of :c:func:`read()` when called during the active picture
+period or the vertical blanking separating the top and bottom field
+depends on the discarding policy. A driver discarding the oldest frames
+keeps capturing into an internal buffer, continuously overwriting the
+previously, not read frame, and returns the frame being received at the
+time of the :c:func:`read()` call as soon as it is complete.
+
+A driver discarding the newest frames stops capturing until the next
+:c:func:`read()` call. The frame being received at :c:func:`read()`
+time is discarded, returning the following frame instead. Again this
+implies a reduction of the capture rate to one half or less of the
+nominal frame rate. An example of this model is the video read mode of
+the bttv driver, initiating a DMA to user memory when :c:func:`read()`
+is called and returning when the DMA finished.
+
+In the multiple buffer model drivers maintain a ring of internal
+buffers, automatically advancing to the next free buffer. This allows
+continuous capturing when the application can empty the buffers fast
+enough. Again, the behavior when the driver runs out of free buffers
+depends on the discarding policy.
+
+Applications can get and set the number of buffers used internally by
+the driver with the :ref:`VIDIOC_G_PARM <vidioc-g-parm>` and
+:ref:`VIDIOC_S_PARM <vidioc-g-parm>` ioctls. They are optional,
+however. The discarding policy is not reported and cannot be changed.
+For minimum requirements see :ref:`devices`.
+
+
+Return Value
+============
+
+On success, the number of bytes read is returned. It is not an error if
+this number is smaller than the number of bytes requested, or the amount
+of data required for one frame. This may happen for example because
+:c:func:`read()` was interrupted by a signal. On error, -1 is
+returned, and the ``errno`` variable is set appropriately. In this case
+the next read will start at the beginning of a new frame. Possible error
+codes are:
+
+EAGAIN
+    Non-blocking I/O has been selected using O_NONBLOCK and no data was
+    immediately available for reading.
+
+EBADF
+    ``fd`` is not a valid file descriptor or is not open for reading, or
+    the process already has the maximum number of files open.
+
+EBUSY
+    The driver does not support multiple read streams and the device is
+    already in use.
+
+EFAULT
+    ``buf`` references an inaccessible memory area.
+
+EINTR
+    The call was interrupted by a signal before any data was read.
+
+EIO
+    I/O error. This indicates some hardware problem or a failure to
+    communicate with a remote device (USB camera etc.).
+
+EINVAL
+    The :c:func:`read()` function is not supported by this driver, not
+    on this device, or generally not on this type of device.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/func-select.rst b/Documentation/linux_tv/media/v4l/func-select.rst
new file mode 100644
index 000000000000..7c9706838cb3
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/func-select.rst
@@ -0,0 +1,108 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _func-select:
+
+*************
+V4L2 select()
+*************
+
+*man v4l2-select(2)*
+
+Synchronous I/O multiplexing
+
+
+Synopsis
+========
+
+.. code-block:: c
+
+    #include <sys/time.h>
+    #include <sys/types.h>
+    #include <unistd.h>
+
+
+.. c:function:: int select( int nfds, fd_set *readfds, fd_set *writefds, fd_set *exceptfds, struct timeval *timeout )
+
+Description
+===========
+
+With the :c:func:`select()` function applications can suspend
+execution until the driver has captured data or is ready to accept data
+for output.
+
+When streaming I/O has been negotiated this function waits until a
+buffer has been filled or displayed and can be dequeued with the
+:ref:`VIDIOC_DQBUF <vidioc-qbuf>` ioctl. When buffers are already in
+the outgoing queue of the driver the function returns immediately.
+
+On success :c:func:`select()` returns the total number of bits set in
+the :c:type:`struct fd_set`s. When the function timed out it returns
+a value of zero. On failure it returns -1 and the ``errno`` variable is
+set appropriately. When the application did not call
+:ref:`VIDIOC_QBUF <vidioc-qbuf>` or
+:ref:`VIDIOC_STREAMON <vidioc-streamon>` yet the :c:func:`select()`
+function succeeds, setting the bit of the file descriptor in ``readfds``
+or ``writefds``, but subsequent :ref:`VIDIOC_DQBUF <vidioc-qbuf>`
+calls will fail. [1]_
+
+When use of the :c:func:`read()` function has been negotiated and the
+driver does not capture yet, the :c:func:`select()` function starts
+capturing. When that fails, :c:func:`select()` returns successful and
+a subsequent :c:func:`read()` call, which also attempts to start
+capturing, will return an appropriate error code. When the driver
+captures continuously (as opposed to, for example, still images) and
+data is already available the :c:func:`select()` function returns
+immediately.
+
+When use of the :c:func:`write()` function has been negotiated the
+:c:func:`select()` function just waits until the driver is ready for a
+non-blocking :c:func:`write()` call.
+
+All drivers implementing the :c:func:`read()` or :c:func:`write()`
+function or streaming I/O must also support the :c:func:`select()`
+function.
+
+For more details see the :c:func:`select()` manual page.
+
+
+Return Value
+============
+
+On success, :c:func:`select()` returns the number of descriptors
+contained in the three returned descriptor sets, which will be zero if
+the timeout expired. On error -1 is returned, and the ``errno`` variable
+is set appropriately; the sets and ``timeout`` are undefined. Possible
+error codes are:
+
+EBADF
+    One or more of the file descriptor sets specified a file descriptor
+    that is not open.
+
+EBUSY
+    The driver does not support multiple read or write streams and the
+    device is already in use.
+
+EFAULT
+    The ``readfds``, ``writefds``, ``exceptfds`` or ``timeout`` pointer
+    references an inaccessible memory area.
+
+EINTR
+    The call was interrupted by a signal.
+
+EINVAL
+    The ``nfds`` argument is less than zero or greater than
+    ``FD_SETSIZE``.
+
+.. [1]
+   The Linux kernel implements :c:func:`select()` like the
+   :ref:`poll() <func-poll>` function, but :c:func:`select()` cannot
+   return a ``POLLERR``.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/func-write.rst b/Documentation/linux_tv/media/v4l/func-write.rst
new file mode 100644
index 000000000000..d2265ba0d92d
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/func-write.rst
@@ -0,0 +1,89 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _func-write:
+
+************
+V4L2 write()
+************
+
+*man v4l2-write(2)*
+
+Write to a V4L2 device
+
+
+Synopsis
+========
+
+.. code-block:: c
+
+    #include <unistd.h>
+
+
+.. c:function:: ssize_t write( int fd, void *buf, size_t count )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``buf``
+``count``
+
+
+Description
+===========
+
+:c:func:`write()` writes up to ``count`` bytes to the device
+referenced by the file descriptor ``fd`` from the buffer starting at
+``buf``. When the hardware outputs are not active yet, this function
+enables them. When ``count`` is zero, :c:func:`write()` returns 0
+without any other effect.
+
+When the application does not provide more data in time, the previous
+video frame, raw VBI image, sliced VPS or WSS data is displayed again.
+Sliced Teletext or Closed Caption data is not repeated, the driver
+inserts a blank line instead.
+
+
+Return Value
+============
+
+On success, the number of bytes written are returned. Zero indicates
+nothing was written. On error, -1 is returned, and the ``errno``
+variable is set appropriately. In this case the next write will start at
+the beginning of a new frame. Possible error codes are:
+
+EAGAIN
+    Non-blocking I/O has been selected using the
+    :ref:`O_NONBLOCK <func-open>` flag and no buffer space was
+    available to write the data immediately.
+
+EBADF
+    ``fd`` is not a valid file descriptor or is not open for writing.
+
+EBUSY
+    The driver does not support multiple write streams and the device is
+    already in use.
+
+EFAULT
+    ``buf`` references an inaccessible memory area.
+
+EINTR
+    The call was interrupted by a signal before any data was written.
+
+EIO
+    I/O error. This indicates some hardware problem.
+
+EINVAL
+    The :c:func:`write()` function is not supported by this driver,
+    not on this device, or generally not on this type of device.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/gen-errors.rst b/Documentation/linux_tv/media/v4l/gen-errors.rst
new file mode 100644
index 000000000000..862cdff45f36
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/gen-errors.rst
@@ -0,0 +1,109 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _gen_errors:
+
+*******************
+Generic Error Codes
+*******************
+
+
+.. _gen-errors:
+
+.. flat-table:: Generic error codes
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  EAGAIN (aka EWOULDBLOCK)
+
+       -  The ioctl can't be handled because the device is in state where it
+          can't perform it. This could happen for example in case where
+          device is sleeping and ioctl is performed to query statistics. It
+          is also returned when the ioctl would need to wait for an event,
+          but the device was opened in non-blocking mode.
+
+    -  .. row 2
+
+       -  EBADF
+
+       -  The file descriptor is not a valid.
+
+    -  .. row 3
+
+       -  EBUSY
+
+       -  The ioctl can't be handled because the device is busy. This is
+          typically return while device is streaming, and an ioctl tried to
+          change something that would affect the stream, or would require
+          the usage of a hardware resource that was already allocated. The
+          ioctl must not be retried without performing another action to fix
+          the problem first (typically: stop the stream before retrying).
+
+    -  .. row 4
+
+       -  EFAULT
+
+       -  There was a failure while copying data from/to userspace, probably
+          caused by an invalid pointer reference.
+
+    -  .. row 5
+
+       -  EINVAL
+
+       -  One or more of the ioctl parameters are invalid or out of the
+          allowed range. This is a widely used error code. See the
+          individual ioctl requests for specific causes.
+
+    -  .. row 6
+
+       -  ENODEV
+
+       -  Device not found or was removed.
+
+    -  .. row 7
+
+       -  ENOMEM
+
+       -  There's not enough memory to handle the desired operation.
+
+    -  .. row 8
+
+       -  ENOTTY
+
+       -  The ioctl is not supported by the driver, actually meaning that
+          the required functionality is not available, or the file
+          descriptor is not for a media device.
+
+    -  .. row 9
+
+       -  ENOSPC
+
+       -  On USB devices, the stream ioctl's can return this error, meaning
+          that this request would overcommit the usb bandwidth reserved for
+          periodic transfers (up to 80% of the USB bandwidth).
+
+    -  .. row 10
+
+       -  EPERM
+
+       -  Permission denied. Can be returned if the device needs write
+          permission, or some special capabilities is needed (e. g. root)
+
+
+Note 1: ioctls may return other error codes. Since errors may have side
+effects such as a driver reset, applications should abort on unexpected
+errors.
+
+Note 2: Request-specific error codes are listed in the individual
+requests descriptions.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/hist-v4l2.rst b/Documentation/linux_tv/media/v4l/hist-v4l2.rst
new file mode 100644
index 000000000000..32f999b3c1a4
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/hist-v4l2.rst
@@ -0,0 +1,1490 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _hist-v4l2:
+
+***********************
+Changes of the V4L2 API
+***********************
+
+Soon after the V4L API was added to the kernel it was criticised as too
+inflexible. In August 1998 Bill Dirks proposed a number of improvements
+and began to work on documentation, example drivers and applications.
+With the help of other volunteers this eventually became the V4L2 API,
+not just an extension but a replacement for the V4L API. However it took
+another four years and two stable kernel releases until the new API was
+finally accepted for inclusion into the kernel in its present form.
+
+
+Early Versions
+==============
+
+1998-08-20: First version.
+
+1998-08-27: The :ref:`select() <func-select>` function was introduced.
+
+1998-09-10: New video standard interface.
+
+1998-09-18: The ``VIDIOC_NONCAP`` ioctl was replaced by the otherwise
+meaningless ``O_TRUNC`` :ref:`open() <func-open>` flag, and the
+aliases ``O_NONCAP`` and ``O_NOIO`` were defined. Applications can set
+this flag if they intend to access controls only, as opposed to capture
+applications which need exclusive access. The ``VIDEO_STD_XXX``
+identifiers are now ordinals instead of flags, and the
+:c:func:`video_std_construct()` helper function takes id and
+transmission arguments.
+
+1998-09-28: Revamped video standard. Made video controls individually
+enumerable.
+
+1998-10-02: The ``id`` field was removed from struct
+:c:type:`struct video_standard` and the color subcarrier fields were
+renamed. The :ref:`VIDIOC_QUERYSTD <vidioc-querystd>` ioctl was
+renamed to :ref:`VIDIOC_ENUMSTD <vidioc-enumstd>`,
+:ref:`VIDIOC_G_INPUT <vidioc-g-input>` to
+:ref:`VIDIOC_ENUMINPUT <vidioc-enuminput>`. A first draft of the
+Codec API was released.
+
+1998-11-08: Many minor changes. Most symbols have been renamed. Some
+material changes to struct :ref:`v4l2_capability <v4l2-capability>`.
+
+1998-11-12: The read/write directon of some ioctls was misdefined.
+
+1998-11-14: ``V4L2_PIX_FMT_RGB24`` changed to ``V4L2_PIX_FMT_BGR24``,
+and ``V4L2_PIX_FMT_RGB32`` changed to ``V4L2_PIX_FMT_BGR32``. Audio
+controls are now accessible with the
+:ref:`VIDIOC_G_CTRL <vidioc-g-ctrl>` and
+:ref:`VIDIOC_S_CTRL <vidioc-g-ctrl>` ioctls under names starting
+with ``V4L2_CID_AUDIO``. The ``V4L2_MAJOR`` define was removed from
+``videodev.h`` since it was only used once in the ``videodev`` kernel
+module. The ``YUV422`` and ``YUV411`` planar image formats were added.
+
+1998-11-28: A few ioctl symbols changed. Interfaces for codecs and video
+output devices were added.
+
+1999-01-14: A raw VBI capture interface was added.
+
+1999-01-19: The ``VIDIOC_NEXTBUF`` ioctl was removed.
+
+
+V4L2 Version 0.16 1999-01-31
+============================
+
+1999-01-27: There is now one QBUF ioctl, VIDIOC_QWBUF and VIDIOC_QRBUF
+are gone. VIDIOC_QBUF takes a v4l2_buffer as a parameter. Added
+digital zoom (cropping) controls.
+
+
+V4L2 Version 0.18 1999-03-16
+============================
+
+Added a v4l to V4L2 ioctl compatibility layer to videodev.c. Driver
+writers, this changes how you implement your ioctl handler. See the
+Driver Writer's Guide. Added some more control id codes.
+
+
+V4L2 Version 0.19 1999-06-05
+============================
+
+1999-03-18: Fill in the category and catname fields of v4l2_queryctrl
+objects before passing them to the driver. Required a minor change to
+the VIDIOC_QUERYCTRL handlers in the sample drivers.
+
+1999-03-31: Better compatibility for v4l memory capture ioctls. Requires
+changes to drivers to fully support new compatibility features, see
+Driver Writer's Guide and v4l2cap.c. Added new control IDs:
+V4L2_CID_HFLIP, _VFLIP. Changed V4L2_PIX_FMT_YUV422P to _YUV422P,
+and _YUV411P to _YUV411P.
+
+1999-04-04: Added a few more control IDs.
+
+1999-04-07: Added the button control type.
+
+1999-05-02: Fixed a typo in videodev.h, and added the
+V4L2_CTRL_FLAG_GRAYED (later V4L2_CTRL_FLAG_GRABBED) flag.
+
+1999-05-20: Definition of VIDIOC_G_CTRL was wrong causing a
+malfunction of this ioctl.
+
+1999-06-05: Changed the value of V4L2_CID_WHITENESS.
+
+
+V4L2 Version 0.20 (1999-09-10)
+==============================
+
+Version 0.20 introduced a number of changes which were *not backward
+compatible* with 0.19 and earlier versions. Purpose of these changes was
+to simplify the API, while making it more extensible and following
+common Linux driver API conventions.
+
+1. Some typos in ``V4L2_FMT_FLAG`` symbols were fixed. struct
+   :ref:`v4l2_clip <v4l2-clip>` was changed for compatibility with
+   v4l. (1999-08-30)
+
+2. ``V4L2_TUNER_SUB_LANG1`` was added. (1999-09-05)
+
+3. All ioctl() commands that used an integer argument now take a pointer
+   to an integer. Where it makes sense, ioctls will return the actual
+   new value in the integer pointed to by the argument, a common
+   convention in the V4L2 API. The affected ioctls are: VIDIOC_PREVIEW,
+   VIDIOC_STREAMON, VIDIOC_STREAMOFF, VIDIOC_S_FREQ,
+   VIDIOC_S_INPUT, VIDIOC_S_OUTPUT, VIDIOC_S_EFFECT. For example
+
+
+   .. code-block:: c
+
+       err = ioctl (fd, VIDIOC_XXX, V4L2_XXX);
+
+   becomes
+
+
+   .. code-block:: c
+
+       int a = V4L2_XXX; err = ioctl(fd, VIDIOC_XXX, &a);
+
+4. All the different get- and set-format commands were swept into one
+   :ref:`VIDIOC_G_FMT <vidioc-g-fmt>` and
+   :ref:`VIDIOC_S_FMT <vidioc-g-fmt>` ioctl taking a union and a
+   type field selecting the union member as parameter. Purpose is to
+   simplify the API by eliminating several ioctls and to allow new and
+   driver private data streams without adding new ioctls.
+
+   This change obsoletes the following ioctls: ``VIDIOC_S_INFMT``,
+   ``VIDIOC_G_INFMT``, ``VIDIOC_S_OUTFMT``, ``VIDIOC_G_OUTFMT``,
+   ``VIDIOC_S_VBIFMT`` and ``VIDIOC_G_VBIFMT``. The image format
+   structure :c:type:`struct v4l2_format` was renamed to struct
+   :ref:`v4l2_pix_format <v4l2-pix-format>`, while struct
+   :ref:`v4l2_format <v4l2-format>` is now the envelopping structure
+   for all format negotiations.
+
+5. Similar to the changes above, the ``VIDIOC_G_PARM`` and
+   ``VIDIOC_S_PARM`` ioctls were merged with ``VIDIOC_G_OUTPARM`` and
+   ``VIDIOC_S_OUTPARM``. A ``type`` field in the new struct
+   :ref:`v4l2_streamparm <v4l2-streamparm>` selects the respective
+   union member.
+
+   This change obsoletes the ``VIDIOC_G_OUTPARM`` and
+   ``VIDIOC_S_OUTPARM`` ioctls.
+
+6. Control enumeration was simplified, and two new control flags were
+   introduced and one dropped. The ``catname`` field was replaced by a
+   ``group`` field.
+
+   Drivers can now flag unsupported and temporarily unavailable controls
+   with ``V4L2_CTRL_FLAG_DISABLED`` and ``V4L2_CTRL_FLAG_GRABBED``
+   respectively. The ``group`` name indicates a possibly narrower
+   classification than the ``category``. In other words, there may be
+   multiple groups within a category. Controls within a group would
+   typically be drawn within a group box. Controls in different
+   categories might have a greater separation, or may even appear in
+   separate windows.
+
+7. The struct :ref:`v4l2_buffer <v4l2-buffer>` ``timestamp`` was
+   changed to a 64 bit integer, containing the sampling or output time
+   of the frame in nanoseconds. Additionally timestamps will be in
+   absolute system time, not starting from zero at the beginning of a
+   stream. The data type name for timestamps is stamp_t, defined as a
+   signed 64-bit integer. Output devices should not send a buffer out
+   until the time in the timestamp field has arrived. I would like to
+   follow SGI's lead, and adopt a multimedia timestamping system like
+   their UST (Unadjusted System Time). See
+   http://web.archive.org/web/*/http://reality.sgi.com
+   /cpirazzi_engr/lg/time/intro.html. UST uses timestamps that are
+   64-bit signed integers (not struct timeval's) and given in nanosecond
+   units. The UST clock starts at zero when the system is booted and
+   runs continuously and uniformly. It takes a little over 292 years for
+   UST to overflow. There is no way to set the UST clock. The regular
+   Linux time-of-day clock can be changed periodically, which would
+   cause errors if it were being used for timestamping a multimedia
+   stream. A real UST style clock will require some support in the
+   kernel that is not there yet. But in anticipation, I will change the
+   timestamp field to a 64-bit integer, and I will change the
+   v4l2_masterclock_gettime() function (used only by drivers) to
+   return a 64-bit integer.
+
+8. A ``sequence`` field was added to struct
+   :ref:`v4l2_buffer <v4l2-buffer>`. The ``sequence`` field counts
+   captured frames, it is ignored by output devices. When a capture
+   driver drops a frame, the sequence number of that frame is skipped.
+
+
+V4L2 Version 0.20 incremental changes
+=====================================
+
+1999-12-23: In struct :ref:`v4l2_vbi_format <v4l2-vbi-format>` the
+``reserved1`` field became ``offset``. Previously drivers were required
+to clear the ``reserved1`` field.
+
+2000-01-13: The ``V4L2_FMT_FLAG_NOT_INTERLACED`` flag was added.
+
+2000-07-31: The ``linux/poll.h`` header is now included by
+``videodev.h`` for compatibility with the original ``videodev.h`` file.
+
+2000-11-20: ``V4L2_TYPE_VBI_OUTPUT`` and ``V4L2_PIX_FMT_Y41P`` were
+added.
+
+2000-11-25: ``V4L2_TYPE_VBI_INPUT`` was added.
+
+2000-12-04: A couple typos in symbol names were fixed.
+
+2001-01-18: To avoid namespace conflicts the ``fourcc`` macro defined in
+the ``videodev.h`` header file was renamed to ``v4l2_fourcc``.
+
+2001-01-25: A possible driver-level compatibility problem between the
+``videodev.h`` file in Linux 2.4.0 and the ``videodev.h`` file included
+in the ``videodevX`` patch was fixed. Users of an earlier version of
+``videodevX`` on Linux 2.4.0 should recompile their V4L and V4L2
+drivers.
+
+2001-01-26: A possible kernel-level incompatibility between the
+``videodev.h`` file in the ``videodevX`` patch and the ``videodev.h``
+file in Linux 2.2.x with devfs patches applied was fixed.
+
+2001-03-02: Certain V4L ioctls which pass data in both direction
+although they are defined with read-only parameter, did not work
+correctly through the backward compatibility layer. [Solution?]
+
+2001-04-13: Big endian 16-bit RGB formats were added.
+
+2001-09-17: New YUV formats and the
+:ref:`VIDIOC_G_FREQUENCY <vidioc-g-frequency>` and
+:ref:`VIDIOC_S_FREQUENCY <vidioc-g-frequency>` ioctls were added.
+(The old ``VIDIOC_G_FREQ`` and ``VIDIOC_S_FREQ`` ioctls did not take
+multiple tuners into account.)
+
+2000-09-18: ``V4L2_BUF_TYPE_VBI`` was added. This may *break
+compatibility* as the :ref:`VIDIOC_G_FMT <vidioc-g-fmt>` and
+:ref:`VIDIOC_S_FMT <vidioc-g-fmt>` ioctls may fail now if the struct
+:c:type:`struct v4l2_fmt` ``type`` field does not contain
+``V4L2_BUF_TYPE_VBI``. In the documentation of the struct
+:ref:`v4l2_vbi_format <v4l2-vbi-format>` ``offset`` field the
+ambiguous phrase "rising edge" was changed to "leading edge".
+
+
+V4L2 Version 0.20 2000-11-23
+============================
+
+A number of changes were made to the raw VBI interface.
+
+1. Figures clarifying the line numbering scheme were added to the V4L2
+   API specification. The ``start``\ [0] and ``start``\ [1] fields no
+   longer count line numbers beginning at zero. Rationale: a) The
+   previous definition was unclear. b) The ``start``\ [] values are
+   ordinal numbers. c) There is no point in inventing a new line
+   numbering scheme. We now use line number as defined by ITU-R, period.
+   Compatibility: Add one to the start values. Applications depending on
+   the previous semantics may not function correctly.
+
+2. The restriction "count[0] > 0 and count[1] > 0" has been relaxed to
+   "(count[0] + count[1]) > 0". Rationale: Drivers may allocate
+   resources at scan line granularity and some data services are
+   transmitted only on the first field. The comment that both ``count``
+   values will usually be equal is misleading and pointless and has been
+   removed. This change *breaks compatibility* with earlier versions:
+   Drivers may return EINVAL, applications may not function correctly.
+
+3. Drivers are again permitted to return negative (unknown) start values
+   as proposed earlier. Why this feature was dropped is unclear. This
+   change may *break compatibility* with applications depending on the
+   start values being positive. The use of ``EBUSY`` and ``EINVAL``
+   error codes with the :ref:`VIDIOC_S_FMT <vidioc-g-fmt>` ioctl was
+   clarified. The EBUSY error code was finally documented, and the
+   ``reserved2`` field which was previously mentioned only in the
+   ``videodev.h`` header file.
+
+4. New buffer types ``V4L2_TYPE_VBI_INPUT`` and ``V4L2_TYPE_VBI_OUTPUT``
+   were added. The former is an alias for the old ``V4L2_TYPE_VBI``, the
+   latter was missing in the ``videodev.h`` file.
+
+
+V4L2 Version 0.20 2002-07-25
+============================
+
+Added sliced VBI interface proposal.
+
+
+V4L2 in Linux 2.5.46, 2002-10
+=============================
+
+Around October-November 2002, prior to an announced feature freeze of
+Linux 2.5, the API was revised, drawing from experience with V4L2 0.20.
+This unnamed version was finally merged into Linux 2.5.46.
+
+1.  As specified in :ref:`related`, drivers must make related device
+    functions available under all minor device numbers.
+
+2.  The :ref:`open() <func-open>` function requires access mode
+    ``O_RDWR`` regardless of the device type. All V4L2 drivers
+    exchanging data with applications must support the ``O_NONBLOCK``
+    flag. The ``O_NOIO`` flag, a V4L2 symbol which aliased the
+    meaningless ``O_TRUNC`` to indicate accesses without data exchange
+    (panel applications) was dropped. Drivers must stay in "panel mode"
+    until the application attempts to initiate a data exchange, see
+    :ref:`open`.
+
+3.  The struct :ref:`v4l2_capability <v4l2-capability>` changed
+    dramatically. Note that also the size of the structure changed,
+    which is encoded in the ioctl request code, thus older V4L2 devices
+    will respond with an EINVAL error code to the new
+    :ref:`VIDIOC_QUERYCAP <vidioc-querycap>` ioctl.
+
+    There are new fields to identify the driver, a new RDS device
+    function ``V4L2_CAP_RDS_CAPTURE``, the ``V4L2_CAP_AUDIO`` flag
+    indicates if the device has any audio connectors, another I/O
+    capability ``V4L2_CAP_ASYNCIO`` can be flagged. In response to these
+    changes the ``type`` field became a bit set and was merged into the
+    ``flags`` field. ``V4L2_FLAG_TUNER`` was renamed to
+    ``V4L2_CAP_TUNER``, ``V4L2_CAP_VIDEO_OVERLAY`` replaced
+    ``V4L2_FLAG_PREVIEW`` and ``V4L2_CAP_VBI_CAPTURE`` and
+    ``V4L2_CAP_VBI_OUTPUT`` replaced ``V4L2_FLAG_DATA_SERVICE``.
+    ``V4L2_FLAG_READ`` and ``V4L2_FLAG_WRITE`` were merged into
+    ``V4L2_CAP_READWRITE``.
+
+    The redundant fields ``inputs``, ``outputs`` and ``audios`` were
+    removed. These properties can be determined as described in
+    :ref:`video` and :ref:`audio`.
+
+    The somewhat volatile and therefore barely useful fields
+    ``maxwidth``, ``maxheight``, ``minwidth``, ``minheight``,
+    ``maxframerate`` were removed. This information is available as
+    described in :ref:`format` and :ref:`standard`.
+
+    ``V4L2_FLAG_SELECT`` was removed. We believe the select() function
+    is important enough to require support of it in all V4L2 drivers
+    exchanging data with applications. The redundant
+    ``V4L2_FLAG_MONOCHROME`` flag was removed, this information is
+    available as described in :ref:`format`.
+
+4.  In struct :ref:`v4l2_input <v4l2-input>` the ``assoc_audio``
+    field and the ``capability`` field and its only flag
+    ``V4L2_INPUT_CAP_AUDIO`` was replaced by the new ``audioset`` field.
+    Instead of linking one video input to one audio input this field
+    reports all audio inputs this video input combines with.
+
+    New fields are ``tuner`` (reversing the former link from tuners to
+    video inputs), ``std`` and ``status``.
+
+    Accordingly struct :ref:`v4l2_output <v4l2-output>` lost its
+    ``capability`` and ``assoc_audio`` fields. ``audioset``,
+    ``modulator`` and ``std`` where added instead.
+
+5.  The struct :ref:`v4l2_audio <v4l2-audio>` field ``audio`` was
+    renamed to ``index``, for consistency with other structures. A new
+    capability flag ``V4L2_AUDCAP_STEREO`` was added to indicated if the
+    audio input in question supports stereo sound.
+    ``V4L2_AUDCAP_EFFECTS`` and the corresponding ``V4L2_AUDMODE`` flags
+    where removed. This can be easily implemented using controls.
+    (However the same applies to AVL which is still there.)
+
+    Again for consistency the struct
+    :ref:`v4l2_audioout <v4l2-audioout>` field ``audio`` was renamed
+    to ``index``.
+
+6.  The struct :ref:`v4l2_tuner <v4l2-tuner>` ``input`` field was
+    replaced by an ``index`` field, permitting devices with multiple
+    tuners. The link between video inputs and tuners is now reversed,
+    inputs point to their tuner. The ``std`` substructure became a
+    simple set (more about this below) and moved into struct
+    :ref:`v4l2_input <v4l2-input>`. A ``type`` field was added.
+
+    Accordingly in struct :ref:`v4l2_modulator <v4l2-modulator>` the
+    ``output`` was replaced by an ``index`` field.
+
+    In struct :ref:`v4l2_frequency <v4l2-frequency>` the ``port``
+    field was replaced by a ``tuner`` field containing the respective
+    tuner or modulator index number. A tuner ``type`` field was added
+    and the ``reserved`` field became larger for future extensions
+    (satellite tuners in particular).
+
+7.  The idea of completely transparent video standards was dropped.
+    Experience showed that applications must be able to work with video
+    standards beyond presenting the user a menu. Instead of enumerating
+    supported standards with an ioctl applications can now refer to
+    standards by :ref:`v4l2_std_id <v4l2-std-id>` and symbols
+    defined in the ``videodev2.h`` header file. For details see
+    :ref:`standard`. The :ref:`VIDIOC_G_STD <vidioc-g-std>` and
+    :ref:`VIDIOC_S_STD <vidioc-g-std>` now take a pointer to this
+    type as argument. :ref:`VIDIOC_QUERYSTD <vidioc-querystd>` was
+    added to autodetect the received standard, if the hardware has this
+    capability. In struct :ref:`v4l2_standard <v4l2-standard>` an
+    ``index`` field was added for
+    :ref:`VIDIOC_ENUMSTD <vidioc-enumstd>`. A
+    :ref:`v4l2_std_id <v4l2-std-id>` field named ``id`` was added as
+    machine readable identifier, also replacing the ``transmission``
+    field. The misleading ``framerate`` field was renamed to
+    ``frameperiod``. The now obsolete ``colorstandard`` information,
+    originally needed to distguish between variations of standards, were
+    removed.
+
+    Struct :c:type:`struct v4l2_enumstd` ceased to be.
+    :ref:`VIDIOC_ENUMSTD <vidioc-enumstd>` now takes a pointer to a
+    struct :ref:`v4l2_standard <v4l2-standard>` directly. The
+    information which standards are supported by a particular video
+    input or output moved into struct :ref:`v4l2_input <v4l2-input>`
+    and struct :ref:`v4l2_output <v4l2-output>` fields named ``std``,
+    respectively.
+
+8.  The struct :ref:`v4l2_queryctrl <v4l2-queryctrl>` fields
+    ``category`` and ``group`` did not catch on and/or were not
+    implemented as expected and therefore removed.
+
+9.  The :ref:`VIDIOC_TRY_FMT <vidioc-g-fmt>` ioctl was added to
+    negotiate data formats as with
+    :ref:`VIDIOC_S_FMT <vidioc-g-fmt>`, but without the overhead of
+    programming the hardware and regardless of I/O in progress.
+
+    In struct :ref:`v4l2_format <v4l2-format>` the ``fmt`` union was
+    extended to contain struct :ref:`v4l2_window <v4l2-window>`. All
+    image format negotiations are now possible with ``VIDIOC_G_FMT``,
+    ``VIDIOC_S_FMT`` and ``VIDIOC_TRY_FMT``; ioctl. The ``VIDIOC_G_WIN``
+    and ``VIDIOC_S_WIN`` ioctls to prepare for a video overlay were
+    removed. The ``type`` field changed to type enum
+    :ref:`v4l2_buf_type <v4l2-buf-type>` and the buffer type names
+    changed as follows.
+
+
+
+    .. flat-table::
+        :header-rows:  1
+        :stub-columns: 0
+
+
+        -  .. row 1
+
+           -  Old defines
+
+           -  enum :ref:`v4l2_buf_type <v4l2-buf-type>`
+
+        -  .. row 2
+
+           -  ``V4L2_BUF_TYPE_CAPTURE``
+
+           -  ``V4L2_BUF_TYPE_VIDEO_CAPTURE``
+
+        -  .. row 3
+
+           -  ``V4L2_BUF_TYPE_CODECIN``
+
+           -  Omitted for now
+
+        -  .. row 4
+
+           -  ``V4L2_BUF_TYPE_CODECOUT``
+
+           -  Omitted for now
+
+        -  .. row 5
+
+           -  ``V4L2_BUF_TYPE_EFFECTSIN``
+
+           -  Omitted for now
+
+        -  .. row 6
+
+           -  ``V4L2_BUF_TYPE_EFFECTSIN2``
+
+           -  Omitted for now
+
+        -  .. row 7
+
+           -  ``V4L2_BUF_TYPE_EFFECTSOUT``
+
+           -  Omitted for now
+
+        -  .. row 8
+
+           -  ``V4L2_BUF_TYPE_VIDEOOUT``
+
+           -  ``V4L2_BUF_TYPE_VIDEO_OUTPUT``
+
+        -  .. row 9
+
+           -  ``-``
+
+           -  ``V4L2_BUF_TYPE_VIDEO_OVERLAY``
+
+        -  .. row 10
+
+           -  ``-``
+
+           -  ``V4L2_BUF_TYPE_VBI_CAPTURE``
+
+        -  .. row 11
+
+           -  ``-``
+
+           -  ``V4L2_BUF_TYPE_VBI_OUTPUT``
+
+        -  .. row 12
+
+           -  ``-``
+
+           -  ``V4L2_BUF_TYPE_SLICED_VBI_CAPTURE``
+
+        -  .. row 13
+
+           -  ``-``
+
+           -  ``V4L2_BUF_TYPE_SLICED_VBI_OUTPUT``
+
+        -  .. row 14
+
+           -  ``V4L2_BUF_TYPE_PRIVATE_BASE``
+
+           -  ``V4L2_BUF_TYPE_PRIVATE`` (but this is deprecated)
+
+
+10. In struct :ref:`v4l2_fmtdesc <v4l2-fmtdesc>` a enum
+    :ref:`v4l2_buf_type <v4l2-buf-type>` field named ``type`` was
+    added as in struct :ref:`v4l2_format <v4l2-format>`. The
+    ``VIDIOC_ENUM_FBUFFMT`` ioctl is no longer needed and was removed.
+    These calls can be replaced by
+    :ref:`VIDIOC_ENUM_FMT <vidioc-enum-fmt>` with type
+    ``V4L2_BUF_TYPE_VIDEO_OVERLAY``.
+
+11. In struct :ref:`v4l2_pix_format <v4l2-pix-format>` the ``depth``
+    field was removed, assuming applications which recognize the format
+    by its four-character-code already know the color depth, and others
+    do not care about it. The same rationale lead to the removal of the
+    ``V4L2_FMT_FLAG_COMPRESSED`` flag. The
+    ``V4L2_FMT_FLAG_SWCONVECOMPRESSED`` flag was removed because drivers
+    are not supposed to convert images in kernel space. A user library
+    of conversion functions should be provided instead. The
+    ``V4L2_FMT_FLAG_BYTESPERLINE`` flag was redundant. Applications can
+    set the ``bytesperline`` field to zero to get a reasonable default.
+    Since the remaining flags were replaced as well, the ``flags`` field
+    itself was removed.
+
+    The interlace flags were replaced by a enum
+    :ref:`v4l2_field <v4l2-field>` value in a newly added ``field``
+    field.
+
+
+
+    .. flat-table::
+        :header-rows:  1
+        :stub-columns: 0
+
+
+        -  .. row 1
+
+           -  Old flag
+
+           -  enum :ref:`v4l2_field <v4l2-field>`
+
+        -  .. row 2
+
+           -  ``V4L2_FMT_FLAG_NOT_INTERLACED``
+
+           -  ?
+
+        -  .. row 3
+
+           -  ``V4L2_FMT_FLAG_INTERLACED`` = ``V4L2_FMT_FLAG_COMBINED``
+
+           -  ``V4L2_FIELD_INTERLACED``
+
+        -  .. row 4
+
+           -  ``V4L2_FMT_FLAG_TOPFIELD`` = ``V4L2_FMT_FLAG_ODDFIELD``
+
+           -  ``V4L2_FIELD_TOP``
+
+        -  .. row 5
+
+           -  ``V4L2_FMT_FLAG_BOTFIELD`` = ``V4L2_FMT_FLAG_EVENFIELD``
+
+           -  ``V4L2_FIELD_BOTTOM``
+
+        -  .. row 6
+
+           -  ``-``
+
+           -  ``V4L2_FIELD_SEQ_TB``
+
+        -  .. row 7
+
+           -  ``-``
+
+           -  ``V4L2_FIELD_SEQ_BT``
+
+        -  .. row 8
+
+           -  ``-``
+
+           -  ``V4L2_FIELD_ALTERNATE``
+
+
+    The color space flags were replaced by a enum
+    :ref:`v4l2_colorspace <v4l2-colorspace>` value in a newly added
+    ``colorspace`` field, where one of ``V4L2_COLORSPACE_SMPTE170M``,
+    ``V4L2_COLORSPACE_BT878``, ``V4L2_COLORSPACE_470_SYSTEM_M`` or
+    ``V4L2_COLORSPACE_470_SYSTEM_BG`` replaces ``V4L2_FMT_CS_601YUV``.
+
+12. In struct :ref:`v4l2_requestbuffers <v4l2-requestbuffers>` the
+    ``type`` field was properly defined as enum
+    :ref:`v4l2_buf_type <v4l2-buf-type>`. Buffer types changed as
+    mentioned above. A new ``memory`` field of type enum
+    :ref:`v4l2_memory <v4l2-memory>` was added to distinguish between
+    I/O methods using buffers allocated by the driver or the
+    application. See :ref:`io` for details.
+
+13. In struct :ref:`v4l2_buffer <v4l2-buffer>` the ``type`` field was
+    properly defined as enum :ref:`v4l2_buf_type <v4l2-buf-type>`.
+    Buffer types changed as mentioned above. A ``field`` field of type
+    enum :ref:`v4l2_field <v4l2-field>` was added to indicate if a
+    buffer contains a top or bottom field. The old field flags were
+    removed. Since no unadjusted system time clock was added to the
+    kernel as planned, the ``timestamp`` field changed back from type
+    stamp_t, an unsigned 64 bit integer expressing the sample time in
+    nanoseconds, to struct :c:type:`struct timeval`. With the addition
+    of a second memory mapping method the ``offset`` field moved into
+    union ``m``, and a new ``memory`` field of type enum
+    :ref:`v4l2_memory <v4l2-memory>` was added to distinguish between
+    I/O methods. See :ref:`io` for details.
+
+    The ``V4L2_BUF_REQ_CONTIG`` flag was used by the V4L compatibility
+    layer, after changes to this code it was no longer needed. The
+    ``V4L2_BUF_ATTR_DEVICEMEM`` flag would indicate if the buffer was
+    indeed allocated in device memory rather than DMA-able system
+    memory. It was barely useful and so was removed.
+
+14. In struct :ref:`v4l2_framebuffer <v4l2-framebuffer>` the
+    ``base[3]`` array anticipating double- and triple-buffering in
+    off-screen video memory, however without defining a synchronization
+    mechanism, was replaced by a single pointer. The
+    ``V4L2_FBUF_CAP_SCALEUP`` and ``V4L2_FBUF_CAP_SCALEDOWN`` flags were
+    removed. Applications can determine this capability more accurately
+    using the new cropping and scaling interface. The
+    ``V4L2_FBUF_CAP_CLIPPING`` flag was replaced by
+    ``V4L2_FBUF_CAP_LIST_CLIPPING`` and
+    ``V4L2_FBUF_CAP_BITMAP_CLIPPING``.
+
+15. In struct :ref:`v4l2_clip <v4l2-clip>` the ``x``, ``y``,
+    ``width`` and ``height`` field moved into a ``c`` substructure of
+    type struct :ref:`v4l2_rect <v4l2-rect>`. The ``x`` and ``y``
+    fields were renamed to ``left`` and ``top``, i. e. offsets to a
+    context dependent origin.
+
+16. In struct :ref:`v4l2_window <v4l2-window>` the ``x``, ``y``,
+    ``width`` and ``height`` field moved into a ``w`` substructure as
+    above. A ``field`` field of type %v4l2-field; was added to
+    distinguish between field and frame (interlaced) overlay.
+
+17. The digital zoom interface, including struct
+    :c:type:`struct v4l2_zoomcap`, struct
+    :c:type:`struct v4l2_zoom`, ``V4L2_ZOOM_NONCAP`` and
+    ``V4L2_ZOOM_WHILESTREAMING`` was replaced by a new cropping and
+    scaling interface. The previously unused struct
+    :c:type:`struct v4l2_cropcap` and :c:type:`struct v4l2_crop`
+    where redefined for this purpose. See :ref:`crop` for details.
+
+18. In struct :ref:`v4l2_vbi_format <v4l2-vbi-format>` the
+    ``SAMPLE_FORMAT`` field now contains a four-character-code as used
+    to identify video image formats and ``V4L2_PIX_FMT_GREY`` replaces
+    the ``V4L2_VBI_SF_UBYTE`` define. The ``reserved`` field was
+    extended.
+
+19. In struct :ref:`v4l2_captureparm <v4l2-captureparm>` the type of
+    the ``timeperframe`` field changed from unsigned long to struct
+    :ref:`v4l2_fract <v4l2-fract>`. This allows the accurate
+    expression of multiples of the NTSC-M frame rate 30000 / 1001. A new
+    field ``readbuffers`` was added to control the driver behaviour in
+    read I/O mode.
+
+    Similar changes were made to struct
+    :ref:`v4l2_outputparm <v4l2-outputparm>`.
+
+20. The struct :c:type:`struct v4l2_performance` and
+    ``VIDIOC_G_PERF`` ioctl were dropped. Except when using the
+    :ref:`read/write I/O method <rw>`, which is limited anyway, this
+    information is already available to applications.
+
+21. The example transformation from RGB to YCbCr color space in the old
+    V4L2 documentation was inaccurate, this has been corrected in
+    :ref:`pixfmt`.
+
+
+V4L2 2003-06-19
+===============
+
+1. A new capability flag ``V4L2_CAP_RADIO`` was added for radio devices.
+   Prior to this change radio devices would identify solely by having
+   exactly one tuner whose type field reads ``V4L2_TUNER_RADIO``.
+
+2. An optional driver access priority mechanism was added, see
+   :ref:`app-pri` for details.
+
+3. The audio input and output interface was found to be incomplete.
+
+   Previously the :ref:`VIDIOC_G_AUDIO <vidioc-g-audio>` ioctl would
+   enumerate the available audio inputs. An ioctl to determine the
+   current audio input, if more than one combines with the current video
+   input, did not exist. So ``VIDIOC_G_AUDIO`` was renamed to
+   ``VIDIOC_G_AUDIO_OLD``, this ioctl was removed on Kernel 2.6.39. The
+   :ref:`VIDIOC_ENUMAUDIO <vidioc-enumaudio>` ioctl was added to
+   enumerate audio inputs, while
+   :ref:`VIDIOC_G_AUDIO <vidioc-g-audio>` now reports the current
+   audio input.
+
+   The same changes were made to
+   :ref:`VIDIOC_G_AUDOUT <vidioc-g-audioout>` and
+   :ref:`VIDIOC_ENUMAUDOUT <vidioc-enumaudioout>`.
+
+   Until further the "videodev" module will automatically translate
+   between the old and new ioctls, but drivers and applications must be
+   updated to successfully compile again.
+
+4. The :ref:`VIDIOC_OVERLAY <vidioc-overlay>` ioctl was incorrectly
+   defined with write-read parameter. It was changed to write-only,
+   while the write-read version was renamed to ``VIDIOC_OVERLAY_OLD``.
+   The old ioctl was removed on Kernel 2.6.39. Until further the
+   "videodev" kernel module will automatically translate to the new
+   version, so drivers must be recompiled, but not applications.
+
+5. :ref:`overlay` incorrectly stated that clipping rectangles define
+   regions where the video can be seen. Correct is that clipping
+   rectangles define regions where *no* video shall be displayed and so
+   the graphics surface can be seen.
+
+6. The :ref:`VIDIOC_S_PARM <vidioc-g-parm>` and
+   :ref:`VIDIOC_S_CTRL <vidioc-g-ctrl>` ioctls were defined with
+   write-only parameter, inconsistent with other ioctls modifying their
+   argument. They were changed to write-read, while a ``_OLD`` suffix
+   was added to the write-only versions. The old ioctls were removed on
+   Kernel 2.6.39. Drivers and applications assuming a constant parameter
+   need an update.
+
+
+V4L2 2003-11-05
+===============
+
+1. In :ref:`pixfmt-rgb` the following pixel formats were incorrectly
+   transferred from Bill Dirks' V4L2 specification. Descriptions below
+   refer to bytes in memory, in ascending address order.
+
+
+
+   .. flat-table::
+       :header-rows:  1
+       :stub-columns: 0
+
+
+       -  .. row 1
+
+          -  Symbol
+
+          -  In this document prior to revision 0.5
+
+          -  Corrected
+
+       -  .. row 2
+
+          -  ``V4L2_PIX_FMT_RGB24``
+
+          -  B, G, R
+
+          -  R, G, B
+
+       -  .. row 3
+
+          -  ``V4L2_PIX_FMT_BGR24``
+
+          -  R, G, B
+
+          -  B, G, R
+
+       -  .. row 4
+
+          -  ``V4L2_PIX_FMT_RGB32``
+
+          -  B, G, R, X
+
+          -  R, G, B, X
+
+       -  .. row 5
+
+          -  ``V4L2_PIX_FMT_BGR32``
+
+          -  R, G, B, X
+
+          -  B, G, R, X
+
+
+   The ``V4L2_PIX_FMT_BGR24`` example was always correct.
+
+   In :ref:`v4l-image-properties` the mapping of the V4L
+   ``VIDEO_PALETTE_RGB24`` and ``VIDEO_PALETTE_RGB32`` formats to V4L2
+   pixel formats was accordingly corrected.
+
+2. Unrelated to the fixes above, drivers may still interpret some V4L2
+   RGB pixel formats differently. These issues have yet to be addressed,
+   for details see :ref:`pixfmt-rgb`.
+
+
+V4L2 in Linux 2.6.6, 2004-05-09
+===============================
+
+1. The :ref:`VIDIOC_CROPCAP <vidioc-cropcap>` ioctl was incorrectly
+   defined with read-only parameter. It is now defined as write-read
+   ioctl, while the read-only version was renamed to
+   ``VIDIOC_CROPCAP_OLD``. The old ioctl was removed on Kernel 2.6.39.
+
+
+V4L2 in Linux 2.6.8
+===================
+
+1. A new field ``input`` (former ``reserved[0]``) was added to the
+   struct :ref:`v4l2_buffer <v4l2-buffer>` structure. Purpose of this
+   field is to alternate between video inputs (e. g. cameras) in step
+   with the video capturing process. This function must be enabled with
+   the new ``V4L2_BUF_FLAG_INPUT`` flag. The ``flags`` field is no
+   longer read-only.
+
+
+V4L2 spec erratum 2004-08-01
+============================
+
+1. The return value of the :ref:`func-open` function was incorrectly
+   documented.
+
+2. Audio output ioctls end in -AUDOUT, not -AUDIOOUT.
+
+3. In the Current Audio Input example the ``VIDIOC_G_AUDIO`` ioctl took
+   the wrong argument.
+
+4. The documentation of the :ref:`VIDIOC_QBUF <vidioc-qbuf>` and
+   :ref:`VIDIOC_DQBUF <vidioc-qbuf>` ioctls did not mention the
+   struct :ref:`v4l2_buffer <v4l2-buffer>` ``memory`` field. It was
+   also missing from examples. Also on the ``VIDIOC_DQBUF`` page the EIO
+   error code was not documented.
+
+
+V4L2 in Linux 2.6.14
+====================
+
+1. A new sliced VBI interface was added. It is documented in
+   :ref:`sliced` and replaces the interface first proposed in V4L2
+   specification 0.8.
+
+
+V4L2 in Linux 2.6.15
+====================
+
+1. The :ref:`VIDIOC_LOG_STATUS <vidioc-log-status>` ioctl was added.
+
+2. New video standards ``V4L2_STD_NTSC_443``, ``V4L2_STD_SECAM_LC``,
+   ``V4L2_STD_SECAM_DK`` (a set of SECAM D, K and K1), and
+   ``V4L2_STD_ATSC`` (a set of ``V4L2_STD_ATSC_8_VSB`` and
+   ``V4L2_STD_ATSC_16_VSB``) were defined. Note the ``V4L2_STD_525_60``
+   set now includes ``V4L2_STD_NTSC_443``. See also
+   :ref:`v4l2-std-id`.
+
+3. The ``VIDIOC_G_COMP`` and ``VIDIOC_S_COMP`` ioctl were renamed to
+   ``VIDIOC_G_MPEGCOMP`` and ``VIDIOC_S_MPEGCOMP`` respectively. Their
+   argument was replaced by a struct
+   :c:type:`struct v4l2_mpeg_compression` pointer. (The
+   ``VIDIOC_G_MPEGCOMP`` and ``VIDIOC_S_MPEGCOMP`` ioctls where removed
+   in Linux 2.6.25.)
+
+
+V4L2 spec erratum 2005-11-27
+============================
+
+The capture example in :ref:`capture-example` called the
+:ref:`VIDIOC_S_CROP <vidioc-g-crop>` ioctl without checking if
+cropping is supported. In the video standard selection example in
+:ref:`standard` the :ref:`VIDIOC_S_STD <vidioc-g-std>` call used
+the wrong argument type.
+
+
+V4L2 spec erratum 2006-01-10
+============================
+
+1. The ``V4L2_IN_ST_COLOR_KILL`` flag in struct
+   :ref:`v4l2_input <v4l2-input>` not only indicates if the color
+   killer is enabled, but also if it is active. (The color killer
+   disables color decoding when it detects no color in the video signal
+   to improve the image quality.)
+
+2. :ref:`VIDIOC_S_PARM <vidioc-g-parm>` is a write-read ioctl, not
+   write-only as stated on its reference page. The ioctl changed in 2003
+   as noted above.
+
+
+V4L2 spec erratum 2006-02-03
+============================
+
+1. In struct :ref:`v4l2_captureparm <v4l2-captureparm>` and struct
+   :ref:`v4l2_outputparm <v4l2-outputparm>` the ``timeperframe``
+   field gives the time in seconds, not microseconds.
+
+
+V4L2 spec erratum 2006-02-04
+============================
+
+1. The ``clips`` field in struct :ref:`v4l2_window <v4l2-window>`
+   must point to an array of struct :ref:`v4l2_clip <v4l2-clip>`, not
+   a linked list, because drivers ignore the struct
+   :c:type:`struct v4l2_clip`. ``next`` pointer.
+
+
+V4L2 in Linux 2.6.17
+====================
+
+1. New video standard macros were added: ``V4L2_STD_NTSC_M_KR`` (NTSC M
+   South Korea), and the sets ``V4L2_STD_MN``, ``V4L2_STD_B``,
+   ``V4L2_STD_GH`` and ``V4L2_STD_DK``. The ``V4L2_STD_NTSC`` and
+   ``V4L2_STD_SECAM`` sets now include ``V4L2_STD_NTSC_M_KR`` and
+   ``V4L2_STD_SECAM_LC`` respectively.
+
+2. A new ``V4L2_TUNER_MODE_LANG1_LANG2`` was defined to record both
+   languages of a bilingual program. The use of
+   ``V4L2_TUNER_MODE_STEREO`` for this purpose is deprecated now. See
+   the :ref:`VIDIOC_G_TUNER <vidioc-g-tuner>` section for details.
+
+
+V4L2 spec erratum 2006-09-23 (Draft 0.15)
+=========================================
+
+1. In various places ``V4L2_BUF_TYPE_SLICED_VBI_CAPTURE`` and
+   ``V4L2_BUF_TYPE_SLICED_VBI_OUTPUT`` of the sliced VBI interface were
+   not mentioned along with other buffer types.
+
+2. In :ref:`vidioc-g-audio` it was clarified that the struct
+   :ref:`v4l2_audio <v4l2-audio>` ``mode`` field is a flags field.
+
+3. :ref:`vidioc-querycap` did not mention the sliced VBI and radio
+   capability flags.
+
+4. In :ref:`vidioc-g-frequency` it was clarified that applications
+   must initialize the tuner ``type`` field of struct
+   :ref:`v4l2_frequency <v4l2-frequency>` before calling
+   :ref:`VIDIOC_S_FREQUENCY <vidioc-g-frequency>`.
+
+5. The ``reserved`` array in struct
+   :ref:`v4l2_requestbuffers <v4l2-requestbuffers>` has 2 elements,
+   not 32.
+
+6. In :ref:`output` and :ref:`raw-vbi` the device file names
+   ``/dev/vout`` which never caught on were replaced by ``/dev/video``.
+
+7. With Linux 2.6.15 the possible range for VBI device minor numbers was
+   extended from 224-239 to 224-255. Accordingly device file names
+   ``/dev/vbi0`` to ``/dev/vbi31`` are possible now.
+
+
+V4L2 in Linux 2.6.18
+====================
+
+1. New ioctls :ref:`VIDIOC_G_EXT_CTRLS <vidioc-g-ext-ctrls>`,
+   :ref:`VIDIOC_S_EXT_CTRLS <vidioc-g-ext-ctrls>` and
+   :ref:`VIDIOC_TRY_EXT_CTRLS <vidioc-g-ext-ctrls>` were added, a
+   flag to skip unsupported controls with
+   :ref:`VIDIOC_QUERYCTRL <vidioc-queryctrl>`, new control types
+   ``V4L2_CTRL_TYPE_INTEGER64`` and ``V4L2_CTRL_TYPE_CTRL_CLASS``
+   (:ref:`v4l2-ctrl-type`), and new control flags
+   ``V4L2_CTRL_FLAG_READ_ONLY``, ``V4L2_CTRL_FLAG_UPDATE``,
+   ``V4L2_CTRL_FLAG_INACTIVE`` and ``V4L2_CTRL_FLAG_SLIDER``
+   (:ref:`control-flags`). See :ref:`extended-controls` for details.
+
+
+V4L2 in Linux 2.6.19
+====================
+
+1. In struct :ref:`v4l2_sliced_vbi_cap <v4l2-sliced-vbi-cap>` a
+   buffer type field was added replacing a reserved field. Note on
+   architectures where the size of enum types differs from int types the
+   size of the structure changed. The
+   :ref:`VIDIOC_G_SLICED_VBI_CAP <vidioc-g-sliced-vbi-cap>` ioctl
+   was redefined from being read-only to write-read. Applications must
+   initialize the type field and clear the reserved fields now. These
+   changes may *break the compatibility* with older drivers and
+   applications.
+
+2. The ioctls :ref:`VIDIOC_ENUM_FRAMESIZES <vidioc-enum-framesizes>`
+   and
+   :ref:`VIDIOC_ENUM_FRAMEINTERVALS <vidioc-enum-frameintervals>`
+   were added.
+
+3. A new pixel format ``V4L2_PIX_FMT_RGB444`` (:ref:`rgb-formats`) was
+   added.
+
+
+V4L2 spec erratum 2006-10-12 (Draft 0.17)
+=========================================
+
+1. ``V4L2_PIX_FMT_HM12`` (:ref:`reserved-formats`) is a YUV 4:2:0, not
+   4:2:2 format.
+
+
+V4L2 in Linux 2.6.21
+====================
+
+1. The ``videodev2.h`` header file is now dual licensed under GNU
+   General Public License version two or later, and under a 3-clause
+   BSD-style license.
+
+
+V4L2 in Linux 2.6.22
+====================
+
+1. Two new field orders ``V4L2_FIELD_INTERLACED_TB`` and
+   ``V4L2_FIELD_INTERLACED_BT`` were added. See :ref:`v4l2-field` for
+   details.
+
+2. Three new clipping/blending methods with a global or straight or
+   inverted local alpha value were added to the video overlay interface.
+   See the description of the :ref:`VIDIOC_G_FBUF <vidioc-g-fbuf>`
+   and :ref:`VIDIOC_S_FBUF <vidioc-g-fbuf>` ioctls for details.
+
+   A new ``global_alpha`` field was added to
+   :ref:`v4l2_window <v4l2-window>`, extending the structure. This
+   may *break compatibility* with applications using a struct
+   :c:type:`struct v4l2_window` directly. However the
+   :ref:`VIDIOC_G/S/TRY_FMT <vidioc-g-fmt>` ioctls, which take a
+   pointer to a :ref:`v4l2_format <v4l2-format>` parent structure
+   with padding bytes at the end, are not affected.
+
+3. The format of the ``chromakey`` field in struct
+   :ref:`v4l2_window <v4l2-window>` changed from "host order RGB32"
+   to a pixel value in the same format as the framebuffer. This may
+   *break compatibility* with existing applications. Drivers supporting
+   the "host order RGB32" format are not known.
+
+
+V4L2 in Linux 2.6.24
+====================
+
+1. The pixel formats ``V4L2_PIX_FMT_PAL8``, ``V4L2_PIX_FMT_YUV444``,
+   ``V4L2_PIX_FMT_YUV555``, ``V4L2_PIX_FMT_YUV565`` and
+   ``V4L2_PIX_FMT_YUV32`` were added.
+
+
+V4L2 in Linux 2.6.25
+====================
+
+1. The pixel formats :ref:`V4L2_PIX_FMT_Y16 <V4L2-PIX-FMT-Y16>` and
+   :ref:`V4L2_PIX_FMT_SBGGR16 <V4L2-PIX-FMT-SBGGR16>` were added.
+
+2. New :ref:`controls <control>` ``V4L2_CID_POWER_LINE_FREQUENCY``,
+   ``V4L2_CID_HUE_AUTO``, ``V4L2_CID_WHITE_BALANCE_TEMPERATURE``,
+   ``V4L2_CID_SHARPNESS`` and ``V4L2_CID_BACKLIGHT_COMPENSATION`` were
+   added. The controls ``V4L2_CID_BLACK_LEVEL``, ``V4L2_CID_WHITENESS``,
+   ``V4L2_CID_HCENTER`` and ``V4L2_CID_VCENTER`` were deprecated.
+
+3. A :ref:`Camera controls class <camera-controls>` was added, with
+   the new controls ``V4L2_CID_EXPOSURE_AUTO``,
+   ``V4L2_CID_EXPOSURE_ABSOLUTE``, ``V4L2_CID_EXPOSURE_AUTO_PRIORITY``,
+   ``V4L2_CID_PAN_RELATIVE``, ``V4L2_CID_TILT_RELATIVE``,
+   ``V4L2_CID_PAN_RESET``, ``V4L2_CID_TILT_RESET``,
+   ``V4L2_CID_PAN_ABSOLUTE``, ``V4L2_CID_TILT_ABSOLUTE``,
+   ``V4L2_CID_FOCUS_ABSOLUTE``, ``V4L2_CID_FOCUS_RELATIVE`` and
+   ``V4L2_CID_FOCUS_AUTO``.
+
+4. The ``VIDIOC_G_MPEGCOMP`` and ``VIDIOC_S_MPEGCOMP`` ioctls, which
+   were superseded by the :ref:`extended controls <extended-controls>`
+   interface in Linux 2.6.18, where finally removed from the
+   ``videodev2.h`` header file.
+
+
+V4L2 in Linux 2.6.26
+====================
+
+1. The pixel formats ``V4L2_PIX_FMT_Y16`` and ``V4L2_PIX_FMT_SBGGR16``
+   were added.
+
+2. Added user controls ``V4L2_CID_CHROMA_AGC`` and
+   ``V4L2_CID_COLOR_KILLER``.
+
+
+V4L2 in Linux 2.6.27
+====================
+
+1. The :ref:`VIDIOC_S_HW_FREQ_SEEK <vidioc-s-hw-freq-seek>` ioctl
+   and the ``V4L2_CAP_HW_FREQ_SEEK`` capability were added.
+
+2. The pixel formats ``V4L2_PIX_FMT_YVYU``, ``V4L2_PIX_FMT_PCA501``,
+   ``V4L2_PIX_FMT_PCA505``, ``V4L2_PIX_FMT_PCA508``,
+   ``V4L2_PIX_FMT_PCA561``, ``V4L2_PIX_FMT_SGBRG8``,
+   ``V4L2_PIX_FMT_PAC207`` and ``V4L2_PIX_FMT_PJPG`` were added.
+
+
+V4L2 in Linux 2.6.28
+====================
+
+1. Added ``V4L2_MPEG_AUDIO_ENCODING_AAC`` and
+   ``V4L2_MPEG_AUDIO_ENCODING_AC3`` MPEG audio encodings.
+
+2. Added ``V4L2_MPEG_VIDEO_ENCODING_MPEG_4_AVC`` MPEG video encoding.
+
+3. The pixel formats ``V4L2_PIX_FMT_SGRBG10`` and
+   ``V4L2_PIX_FMT_SGRBG10DPCM8`` were added.
+
+
+V4L2 in Linux 2.6.29
+====================
+
+1. The ``VIDIOC_G_CHIP_IDENT`` ioctl was renamed to
+   ``VIDIOC_G_CHIP_IDENT_OLD`` and ``VIDIOC_DBG_G_CHIP_IDENT`` was
+   introduced in its place. The old struct
+   :c:type:`struct v4l2_chip_ident` was renamed to
+   :c:type:`struct v4l2_chip_ident_old`.
+
+2. The pixel formats ``V4L2_PIX_FMT_VYUY``, ``V4L2_PIX_FMT_NV16`` and
+   ``V4L2_PIX_FMT_NV61`` were added.
+
+3. Added camera controls ``V4L2_CID_ZOOM_ABSOLUTE``,
+   ``V4L2_CID_ZOOM_RELATIVE``, ``V4L2_CID_ZOOM_CONTINUOUS`` and
+   ``V4L2_CID_PRIVACY``.
+
+
+V4L2 in Linux 2.6.30
+====================
+
+1. New control flag ``V4L2_CTRL_FLAG_WRITE_ONLY`` was added.
+
+2. New control ``V4L2_CID_COLORFX`` was added.
+
+
+V4L2 in Linux 2.6.32
+====================
+
+1. In order to be easier to compare a V4L2 API and a kernel version, now
+   V4L2 API is numbered using the Linux Kernel version numeration.
+
+2. Finalized the RDS capture API. See :ref:`rds` for more information.
+
+3. Added new capabilities for modulators and RDS encoders.
+
+4. Add description for libv4l API.
+
+5. Added support for string controls via new type
+   ``V4L2_CTRL_TYPE_STRING``.
+
+6. Added ``V4L2_CID_BAND_STOP_FILTER`` documentation.
+
+7. Added FM Modulator (FM TX) Extended Control Class:
+   ``V4L2_CTRL_CLASS_FM_TX`` and their Control IDs.
+
+8. Added FM Receiver (FM RX) Extended Control Class:
+   ``V4L2_CTRL_CLASS_FM_RX`` and their Control IDs.
+
+9. Added Remote Controller chapter, describing the default Remote
+   Controller mapping for media devices.
+
+
+V4L2 in Linux 2.6.33
+====================
+
+1. Added support for Digital Video timings in order to support HDTV
+   receivers and transmitters.
+
+
+V4L2 in Linux 2.6.34
+====================
+
+1. Added ``V4L2_CID_IRIS_ABSOLUTE`` and ``V4L2_CID_IRIS_RELATIVE``
+   controls to the :ref:`Camera controls class <camera-controls>`.
+
+
+V4L2 in Linux 2.6.37
+====================
+
+1. Remove the vtx (videotext/teletext) API. This API was no longer used
+   and no hardware exists to verify the API. Nor were any userspace
+   applications found that used it. It was originally scheduled for
+   removal in 2.6.35.
+
+
+V4L2 in Linux 2.6.39
+====================
+
+1. The old VIDIOC_*_OLD symbols and V4L1 support were removed.
+
+2. Multi-planar API added. Does not affect the compatibility of current
+   drivers and applications. See :ref:`multi-planar API <planar-apis>`
+   for details.
+
+
+V4L2 in Linux 3.1
+=================
+
+1. VIDIOC_QUERYCAP now returns a per-subsystem version instead of a
+   per-driver one.
+
+   Standardize an error code for invalid ioctl.
+
+   Added V4L2_CTRL_TYPE_BITMASK.
+
+
+V4L2 in Linux 3.2
+=================
+
+1. V4L2_CTRL_FLAG_VOLATILE was added to signal volatile controls to
+   userspace.
+
+2. Add selection API for extended control over cropping and composing.
+   Does not affect the compatibility of current drivers and
+   applications. See :ref:`selection API <selection-api>` for details.
+
+
+V4L2 in Linux 3.3
+=================
+
+1. Added ``V4L2_CID_ALPHA_COMPONENT`` control to the
+   :ref:`User controls class <control>`.
+
+2. Added the device_caps field to struct v4l2_capabilities and added
+   the new V4L2_CAP_DEVICE_CAPS capability.
+
+
+V4L2 in Linux 3.4
+=================
+
+1. Added :ref:`JPEG compression control class <jpeg-controls>`.
+
+2. Extended the DV Timings API:
+   :ref:`VIDIOC_ENUM_DV_TIMINGS <vidioc-enum-dv-timings>`,
+   :ref:`VIDIOC_QUERY_DV_TIMINGS <vidioc-query-dv-timings>` and
+   :ref:`VIDIOC_DV_TIMINGS_CAP <vidioc-dv-timings-cap>`.
+
+
+V4L2 in Linux 3.5
+=================
+
+1. Added integer menus, the new type will be
+   V4L2_CTRL_TYPE_INTEGER_MENU.
+
+2. Added selection API for V4L2 subdev interface:
+   :ref:`VIDIOC_SUBDEV_G_SELECTION <vidioc-subdev-g-selection>` and
+   :ref:`VIDIOC_SUBDEV_S_SELECTION <vidioc-subdev-g-selection>`.
+
+3. Added ``V4L2_COLORFX_ANTIQUE``, ``V4L2_COLORFX_ART_FREEZE``,
+   ``V4L2_COLORFX_AQUA``, ``V4L2_COLORFX_SILHOUETTE``,
+   ``V4L2_COLORFX_SOLARIZATION``, ``V4L2_COLORFX_VIVID`` and
+   ``V4L2_COLORFX_ARBITRARY_CBCR`` menu items to the
+   ``V4L2_CID_COLORFX`` control.
+
+4. Added ``V4L2_CID_COLORFX_CBCR`` control.
+
+5. Added camera controls ``V4L2_CID_AUTO_EXPOSURE_BIAS``,
+   ``V4L2_CID_AUTO_N_PRESET_WHITE_BALANCE``,
+   ``V4L2_CID_IMAGE_STABILIZATION``, ``V4L2_CID_ISO_SENSITIVITY``,
+   ``V4L2_CID_ISO_SENSITIVITY_AUTO``, ``V4L2_CID_EXPOSURE_METERING``,
+   ``V4L2_CID_SCENE_MODE``, ``V4L2_CID_3A_LOCK``,
+   ``V4L2_CID_AUTO_FOCUS_START``, ``V4L2_CID_AUTO_FOCUS_STOP``,
+   ``V4L2_CID_AUTO_FOCUS_STATUS`` and ``V4L2_CID_AUTO_FOCUS_RANGE``.
+
+
+V4L2 in Linux 3.6
+=================
+
+1. Replaced ``input`` in :c:type:`struct v4l2_buffer` by
+   ``reserved2`` and removed ``V4L2_BUF_FLAG_INPUT``.
+
+2. Added V4L2_CAP_VIDEO_M2M and V4L2_CAP_VIDEO_M2M_MPLANE
+   capabilities.
+
+3. Added support for frequency band enumerations:
+   :ref:`VIDIOC_ENUM_FREQ_BANDS <vidioc-enum-freq-bands>`.
+
+
+V4L2 in Linux 3.9
+=================
+
+1. Added timestamp types to ``flags`` field in
+   :c:type:`struct v4l2_buffer`. See :ref:`buffer-flags`.
+
+2. Added ``V4L2_EVENT_CTRL_CH_RANGE`` control event changes flag. See
+   :ref:`ctrl-changes-flags`.
+
+
+V4L2 in Linux 3.10
+==================
+
+1. Removed obsolete and unused DV_PRESET ioctls VIDIOC_G_DV_PRESET,
+   VIDIOC_S_DV_PRESET, VIDIOC_QUERY_DV_PRESET and
+   VIDIOC_ENUM_DV_PRESET. Remove the related v4l2_input/output
+   capability flags V4L2_IN_CAP_PRESETS and V4L2_OUT_CAP_PRESETS.
+
+2. Added new debugging ioctl
+   :ref:`VIDIOC_DBG_G_CHIP_INFO <vidioc-dbg-g-chip-info>`.
+
+
+V4L2 in Linux 3.11
+==================
+
+1. Remove obsolete ``VIDIOC_DBG_G_CHIP_IDENT`` ioctl.
+
+
+V4L2 in Linux 3.14
+==================
+
+1. In struct :c:type:`struct v4l2_rect`, the type of ``width`` and
+   ``height`` fields changed from _s32 to _u32.
+
+
+V4L2 in Linux 3.15
+==================
+
+1. Added Software Defined Radio (SDR) Interface.
+
+
+V4L2 in Linux 3.16
+==================
+
+1. Added event V4L2_EVENT_SOURCE_CHANGE.
+
+
+V4L2 in Linux 3.17
+==================
+
+1. Extended struct :ref:`v4l2_pix_format <v4l2-pix-format>`. Added
+   format flags.
+
+2. Added compound control types and
+   :ref:`VIDIOC_QUERY_EXT_CTRL <vidioc-queryctrl>`.
+
+
+V4L2 in Linux 3.18
+==================
+
+1. Added ``V4L2_CID_PAN_SPEED`` and ``V4L2_CID_TILT_SPEED`` camera
+   controls.
+
+
+V4L2 in Linux 3.19
+==================
+
+1. Rewrote Colorspace chapter, added new enum
+   :ref:`v4l2_ycbcr_encoding <v4l2-ycbcr-encoding>` and enum
+   :ref:`v4l2_quantization <v4l2-quantization>` fields to struct
+   :ref:`v4l2_pix_format <v4l2-pix-format>`, struct
+   :ref:`v4l2_pix_format_mplane <v4l2-pix-format-mplane>` and
+   struct :ref:`v4l2_mbus_framefmt <v4l2-mbus-framefmt>`.
+
+
+V4L2 in Linux 4.4
+=================
+
+1. Renamed ``V4L2_TUNER_ADC`` to ``V4L2_TUNER_SDR``. The use of
+   ``V4L2_TUNER_ADC`` is deprecated now.
+
+2. Added ``V4L2_CID_RF_TUNER_RF_GAIN`` RF Tuner control.
+
+3. Added transmitter support for Software Defined Radio (SDR) Interface.
+
+
+.. _other:
+
+Relation of V4L2 to other Linux multimedia APIs
+===============================================
+
+
+.. _xvideo:
+
+X Video Extension
+-----------------
+
+The X Video Extension (abbreviated XVideo or just Xv) is an extension of
+the X Window system, implemented for example by the XFree86 project. Its
+scope is similar to V4L2, an API to video capture and output devices for
+X clients. Xv allows applications to display live video in a window,
+send window contents to a TV output, and capture or output still images
+in XPixmaps [1]_. With their implementation XFree86 makes the extension
+available across many operating systems and architectures.
+
+Because the driver is embedded into the X server Xv has a number of
+advantages over the V4L2 :ref:`video overlay interface <overlay>`. The
+driver can easily determine the overlay target, i. e. visible graphics
+memory or off-screen buffers for a destructive overlay. It can program
+the RAMDAC for a non-destructive overlay, scaling or color-keying, or
+the clipping functions of the video capture hardware, always in sync
+with drawing operations or windows moving or changing their stacking
+order.
+
+To combine the advantages of Xv and V4L a special Xv driver exists in
+XFree86 and XOrg, just programming any overlay capable Video4Linux
+device it finds. To enable it ``/etc/X11/XF86Config`` must contain these
+lines:
+
+
+
+::
+
+    Section "Module"
+        Load "v4l"
+    EndSection
+As of XFree86 4.2 this driver still supports only V4L ioctls, however it
+should work just fine with all V4L2 devices through the V4L2
+backward-compatibility layer. Since V4L2 permits multiple opens it is
+possible (if supported by the V4L2 driver) to capture video while an X
+client requested video overlay. Restrictions of simultaneous capturing
+and overlay are discussed in :ref:`overlay` apply.
+
+Only marginally related to V4L2, XFree86 extended Xv to support hardware
+YUV to RGB conversion and scaling for faster video playback, and added
+an interface to MPEG-2 decoding hardware. This API is useful to display
+images captured with V4L2 devices.
+
+
+Digital Video
+-------------
+
+V4L2 does not support digital terrestrial, cable or satellite broadcast.
+A separate project aiming at digital receivers exists. You can find its
+homepage at `https://linuxtv.org <https://linuxtv.org>`__. The Linux
+DVB API has no connection to the V4L2 API except that drivers for hybrid
+hardware may support both.
+
+
+Audio Interfaces
+----------------
+
+[to do - OSS/ALSA]
+
+
+.. _experimental:
+
+Experimental API Elements
+=========================
+
+The following V4L2 API elements are currently experimental and may
+change in the future.
+
+-  :ref:`VIDIOC_DBG_G_REGISTER <vidioc-dbg-g-register>` and
+   :ref:`VIDIOC_DBG_S_REGISTER <vidioc-dbg-g-register>` ioctls.
+
+-  :ref:`VIDIOC_DBG_G_CHIP_INFO <vidioc-dbg-g-chip-info>` ioctl.
+
+
+.. _obsolete:
+
+Obsolete API Elements
+=====================
+
+The following V4L2 API elements were superseded by new interfaces and
+should not be implemented in new drivers.
+
+-  ``VIDIOC_G_MPEGCOMP`` and ``VIDIOC_S_MPEGCOMP`` ioctls. Use Extended
+   Controls, :ref:`extended-controls`.
+
+-  VIDIOC_G_DV_PRESET, VIDIOC_S_DV_PRESET,
+   VIDIOC_ENUM_DV_PRESETS and VIDIOC_QUERY_DV_PRESET ioctls. Use
+   the DV Timings API (:ref:`dv-timings`).
+
+-  ``VIDIOC_SUBDEV_G_CROP`` and ``VIDIOC_SUBDEV_S_CROP`` ioctls. Use
+   ``VIDIOC_SUBDEV_G_SELECTION`` and ``VIDIOC_SUBDEV_S_SELECTION``,
+   :ref:`vidioc-subdev-g-selection`.
+
+.. [1]
+   This is not implemented in XFree86.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/io.rst b/Documentation/linux_tv/media/v4l/io.rst
new file mode 100644
index 000000000000..a7ca0d5fc5dd
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/io.rst
@@ -0,0 +1,62 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _io:
+
+############
+Input/Output
+############
+The V4L2 API defines several different methods to read from or write to
+a device. All drivers exchanging data with applications must support at
+least one of them.
+
+The classic I/O method using the :c:func:`read()` and
+:c:func:`write()` function is automatically selected after opening a
+V4L2 device. When the driver does not support this method attempts to
+read or write will fail at any time.
+
+Other methods must be negotiated. To select the streaming I/O method
+with memory mapped or user buffers applications call the
+:ref:`VIDIOC_REQBUFS <vidioc-reqbufs>` ioctl. The asynchronous I/O
+method is not defined yet.
+
+Video overlay can be considered another I/O method, although the
+application does not directly receive the image data. It is selected by
+initiating video overlay with the :ref:`VIDIOC_S_FMT <vidioc-g-fmt>`
+ioctl. For more information see :ref:`overlay`.
+
+Generally exactly one I/O method, including overlay, is associated with
+each file descriptor. The only exceptions are applications not
+exchanging data with a driver ("panel applications", see :ref:`open`)
+and drivers permitting simultaneous video capturing and overlay using
+the same file descriptor, for compatibility with V4L and earlier
+versions of V4L2.
+
+``VIDIOC_S_FMT`` and ``VIDIOC_REQBUFS`` would permit this to some
+degree, but for simplicity drivers need not support switching the I/O
+method (after first switching away from read/write) other than by
+closing and reopening the device.
+
+The following sections describe the various I/O methods in more detail.
+
+
+.. toctree::
+    :maxdepth: 1
+
+    rw
+    mmap
+    userp
+    dmabuf
+    async
+    buffer
+    field-order
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/keytable.c.rst b/Documentation/linux_tv/media/v4l/keytable.c.rst
new file mode 100644
index 000000000000..c69833ca2fb7
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/keytable.c.rst
@@ -0,0 +1,187 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+file: media/v4l/keytable.c
+==========================
+
+.. code-block:: c
+
+    /* keytable.c - This program allows checking/replacing keys at IR
+
+       Copyright (C) 2006-2009 Mauro Carvalho Chehab <mchehab@infradead.org>
+
+       This program is free software; you can redistribute it and/or modify
+       it under the terms of the GNU General Public License as published by
+       the Free Software Foundation, version 2 of the License.
+
+       This program is distributed in the hope that it will be useful,
+       but WITHOUT ANY WARRANTY; without even the implied warranty of
+       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+       GNU General Public License for more details.
+     */
+
+    #include <ctype.h>
+    #include <errno.h>
+    #include <fcntl.h>
+    #include <stdio.h>
+    #include <stdlib.h>
+    #include <string.h>
+    #include <linux/input.h>
+    #include <sys/ioctl.h>
+
+    #include "parse.h"
+
+    void prtcode (int *codes)
+    {
+            struct parse_key *p;
+
+            for (p=keynames;p->name!=NULL;p++) {
+                    if (p->value == (unsigned)codes[1]) {
+                            printf("scancode 0x%04x = %s (0x%02x)\\n", codes[0], p->name, codes[1]);
+                            return;
+                    }
+            }
+
+            if (isprint (codes[1]))
+                    printf("scancode %d = '%c' (0x%02x)\\n", codes[0], codes[1], codes[1]);
+            else
+                    printf("scancode %d = 0x%02x\\n", codes[0], codes[1]);
+    }
+
+    int parse_code(char *string)
+    {
+            struct parse_key *p;
+
+            for (p=keynames;p->name!=NULL;p++) {
+                    if (!strcasecmp(p->name, string)) {
+                            return p->value;
+                    }
+            }
+            return -1;
+    }
+
+    int main (int argc, char *argv[])
+    {
+            int fd;
+            unsigned int i, j;
+            int codes[2];
+
+            if (argc<2 || argc>4) {
+                    printf ("usage: %s <device> to get table; or\\n"
+                            "       %s <device> <scancode> <keycode>\\n"
+                            "       %s <device> <keycode_file>n",*argv,*argv,*argv);
+                    return -1;
+            }
+
+            if ((fd = open(argv[1], O_RDONLY)) < 0) {
+                    perror("Couldn't open input device");
+                    return(-1);
+            }
+
+            if (argc==4) {
+                    int value;
+
+                    value=parse_code(argv[3]);
+
+                    if (value==-1) {
+                            value = strtol(argv[3], NULL, 0);
+                            if (errno)
+                                    perror("value");
+                    }
+
+                    codes [0] = (unsigned) strtol(argv[2], NULL, 0);
+                    codes [1] = (unsigned) value;
+
+                    if(ioctl(fd, EVIOCSKEYCODE, codes))
+                            perror ("EVIOCSKEYCODE");
+
+                    if(ioctl(fd, EVIOCGKEYCODE, codes)==0)
+                            prtcode(codes);
+                    return 0;
+            }
+
+            if (argc==3) {
+                    FILE *fin;
+                    int value;
+                    char *scancode, *keycode, s[2048];
+
+                    fin=fopen(argv[2],"r");
+                    if (fin==NULL) {
+                            perror ("opening keycode file");
+                            return -1;
+                    }
+
+                    /* Clears old table */
+                    for (j = 0; j < 256; j++) {
+                            for (i = 0; i < 256; i++) {
+                                    codes[0] = (j << 8) | i;
+                                    codes[1] = KEY_RESERVED;
+                                    ioctl(fd, EVIOCSKEYCODE, codes);
+                            }
+                    }
+
+                    while (fgets(s,sizeof(s),fin)) {
+                            scancode=strtok(s,"\\n\\t =:");
+                            if (!scancode) {
+                                    perror ("parsing input file scancode");
+                                    return -1;
+                            }
+                            if (!strcasecmp(scancode, "scancode")) {
+                                    scancode = strtok(NULL,"\\n\\t =:");
+                                    if (!scancode) {
+                                            perror ("parsing input file scancode");
+                                            return -1;
+                                    }
+                            }
+
+                            keycode=strtok(NULL,"\\n\\t =:(");
+                            if (!keycode) {
+                                    perror ("parsing input file keycode");
+                                    return -1;
+                            }
+
+                            // printf ("parsing %s=%s:", scancode, keycode);
+                            value=parse_code(keycode);
+                            // printf ("\\tvalue=%d\\n",value);
+
+                            if (value==-1) {
+                                    value = strtol(keycode, NULL, 0);
+                                    if (errno)
+                                            perror("value");
+                            }
+
+                            codes [0] = (unsigned) strtol(scancode, NULL, 0);
+                            codes [1] = (unsigned) value;
+
+                            // printf("\\t%04x=%04x\\n",codes[0], codes[1]);
+                            if(ioctl(fd, EVIOCSKEYCODE, codes)) {
+                                    fprintf(stderr, "Setting scancode 0x%04x with 0x%04x via ",codes[0], codes[1]);
+                                    perror ("EVIOCSKEYCODE");
+                            }
+
+                            if(ioctl(fd, EVIOCGKEYCODE, codes)==0)
+                                    prtcode(codes);
+                    }
+                    return 0;
+            }
+
+            /* Get scancode table */
+            for (j = 0; j < 256; j++) {
+                    for (i = 0; i < 256; i++) {
+                            codes[0] = (j << 8) | i;
+                            if (!ioctl(fd, EVIOCGKEYCODE, codes) && codes[1] != KEY_RESERVED)
+                                    prtcode(codes);
+                    }
+            }
+            return 0;
+    }
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/libv4l-introduction.rst b/Documentation/linux_tv/media/v4l/libv4l-introduction.rst
new file mode 100644
index 000000000000..533ea4e18770
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/libv4l-introduction.rst
@@ -0,0 +1,178 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _libv4l-introduction:
+
+************
+Introduction
+************
+
+libv4l is a collection of libraries which adds a thin abstraction layer
+on top of video4linux2 devices. The purpose of this (thin) layer is to
+make it easy for application writers to support a wide variety of
+devices without having to write separate code for different devices in
+the same class.
+
+An example of using libv4l is provided by
+:ref:`v4l2grab <v4l2grab-example>`.
+
+libv4l consists of 3 different libraries:
+
+
+libv4lconvert
+=============
+
+libv4lconvert is a library that converts several different pixelformats
+found in V4L2 drivers into a few common RGB and YUY formats.
+
+It currently accepts the following V4L2 driver formats:
+:ref:`V4L2_PIX_FMT_BGR24 <V4L2-PIX-FMT-BGR24>`,
+:ref:`V4L2_PIX_FMT_HM12 <V4L2-PIX-FMT-HM12>`,
+:ref:`V4L2_PIX_FMT_JPEG <V4L2-PIX-FMT-JPEG>`,
+:ref:`V4L2_PIX_FMT_MJPEG <V4L2-PIX-FMT-MJPEG>`,
+:ref:`V4L2_PIX_FMT_MR97310A <V4L2-PIX-FMT-MR97310A>`,
+:ref:`V4L2_PIX_FMT_OV511 <V4L2-PIX-FMT-OV511>`,
+:ref:`V4L2_PIX_FMT_OV518 <V4L2-PIX-FMT-OV518>`,
+:ref:`V4L2_PIX_FMT_PAC207 <V4L2-PIX-FMT-PAC207>`,
+:ref:`V4L2_PIX_FMT_PJPG <V4L2-PIX-FMT-PJPG>`,
+:ref:`V4L2_PIX_FMT_RGB24 <V4L2-PIX-FMT-RGB24>`,
+:ref:`V4L2_PIX_FMT_SBGGR8 <V4L2-PIX-FMT-SBGGR8>`,
+:ref:`V4L2_PIX_FMT_SGBRG8 <V4L2-PIX-FMT-SGBRG8>`,
+:ref:`V4L2_PIX_FMT_SGRBG8 <V4L2-PIX-FMT-SGRBG8>`,
+:ref:`V4L2_PIX_FMT_SN9C10X <V4L2-PIX-FMT-SN9C10X>`,
+:ref:`V4L2_PIX_FMT_SN9C20X_I420 <V4L2-PIX-FMT-SN9C20X-I420>`,
+:ref:`V4L2_PIX_FMT_SPCA501 <V4L2-PIX-FMT-SPCA501>`,
+:ref:`V4L2_PIX_FMT_SPCA505 <V4L2-PIX-FMT-SPCA505>`,
+:ref:`V4L2_PIX_FMT_SPCA508 <V4L2-PIX-FMT-SPCA508>`,
+:ref:`V4L2_PIX_FMT_SPCA561 <V4L2-PIX-FMT-SPCA561>`,
+:ref:`V4L2_PIX_FMT_SQ905C <V4L2-PIX-FMT-SQ905C>`,
+``V4L2_PIX_FMT_SRGGB8``,
+:ref:`V4L2_PIX_FMT_UYVY <V4L2-PIX-FMT-UYVY>`,
+:ref:`V4L2_PIX_FMT_YUV420 <V4L2-PIX-FMT-YUV420>`,
+:ref:`V4L2_PIX_FMT_YUYV <V4L2-PIX-FMT-YUYV>`,
+:ref:`V4L2_PIX_FMT_YVU420 <V4L2-PIX-FMT-YVU420>`, and
+:ref:`V4L2_PIX_FMT_YVYU <V4L2-PIX-FMT-YVYU>`.
+
+Later on libv4lconvert was expanded to also be able to do various video
+processing functions to improve webcam video quality. The video
+processing is split in to 2 parts: libv4lconvert/control and
+libv4lconvert/processing.
+
+The control part is used to offer video controls which can be used to
+control the video processing functions made available by
+libv4lconvert/processing. These controls are stored application wide
+(until reboot) by using a persistent shared memory object.
+
+libv4lconvert/processing offers the actual video processing
+functionality.
+
+
+libv4l1
+=======
+
+This library offers functions that can be used to quickly make v4l1
+applications work with v4l2 devices. These functions work exactly like
+the normal open/close/etc, except that libv4l1 does full emulation of
+the v4l1 api on top of v4l2 drivers, in case of v4l1 drivers it will
+just pass calls through.
+
+Since those functions are emulations of the old V4L1 API, it shouldn't
+be used for new applications.
+
+
+libv4l2
+=======
+
+This library should be used for all modern V4L2 applications.
+
+It provides handles to call V4L2 open/ioctl/close/poll methods. Instead
+of just providing the raw output of the device, it enhances the calls in
+the sense that it will use libv4lconvert to provide more video formats
+and to enhance the image quality.
+
+In most cases, libv4l2 just passes the calls directly through to the
+v4l2 driver, intercepting the calls to
+:ref:`VIDIOC_TRY_FMT <vidioc-g-fmt>`,
+:ref:`VIDIOC_G_FMT <vidioc-g-fmt>`
+:ref:`VIDIOC_S_FMT <vidioc-g-fmt>`
+:ref:`VIDIOC_ENUM_FRAMESIZES <vidioc-enum-framesizes>` and
+:ref:`VIDIOC_ENUM_FRAMEINTERVALS <vidioc-enum-frameintervals>` in
+order to emulate the formats
+:ref:`V4L2_PIX_FMT_BGR24 <V4L2-PIX-FMT-BGR24>`,
+:ref:`V4L2_PIX_FMT_RGB24 <V4L2-PIX-FMT-RGB24>`,
+:ref:`V4L2_PIX_FMT_YUV420 <V4L2-PIX-FMT-YUV420>`, and
+:ref:`V4L2_PIX_FMT_YVU420 <V4L2-PIX-FMT-YVU420>`, if they aren't
+available in the driver. :ref:`VIDIOC_ENUM_FMT <vidioc-enum-fmt>`
+keeps enumerating the hardware supported formats, plus the emulated
+formats offered by libv4l at the end.
+
+
+.. _libv4l-ops:
+
+Libv4l device control functions
+-------------------------------
+
+The common file operation methods are provided by libv4l.
+
+Those functions operate just like glibc
+open/close/dup/ioctl/read/mmap/munmap:
+
+-  int v4l2_open(const char *file, int oflag, ...) - operates like the
+   standard :ref:`open() <func-open>` function.
+
+-  int v4l2_close(int fd) - operates like the standard
+   :ref:`close() <func-close>` function.
+
+-  int v4l2_dup(int fd) - operates like the standard dup() function,
+   duplicating a file handler.
+
+-  int v4l2_ioctl (int fd, unsigned long int request, ...) - operates
+   like the standard :ref:`ioctl() <func-ioctl>` function.
+
+-  int v4l2_read (int fd, void* buffer, size_t n) - operates like the
+   standard :ref:`read() <func-read>` function.
+
+-  void v4l2_mmap(void *start, size_t length, int prot, int flags, int
+   fd, int64_t offset); - operates like the standard
+   :ref:`mmap() <func-mmap>` function.
+
+-  int v4l2_munmap(void *_start, size_t length); - operates like the
+   standard :ref:`munmap() <func-munmap>` function.
+
+Those functions provide additional control:
+
+-  int v4l2_fd_open(int fd, int v4l2_flags) - opens an already opened
+   fd for further use through v4l2lib and possibly modify libv4l2's
+   default behavior through the v4l2_flags argument. Currently,
+   v4l2_flags can be ``V4L2_DISABLE_CONVERSION``, to disable format
+   conversion.
+
+-  int v4l2_set_control(int fd, int cid, int value) - This function
+   takes a value of 0 - 65535, and then scales that range to the actual
+   range of the given v4l control id, and then if the cid exists and is
+   not locked sets the cid to the scaled value.
+
+-  int v4l2_get_control(int fd, int cid) - This function returns a
+   value of 0 - 65535, scaled to from the actual range of the given v4l
+   control id. when the cid does not exist, could not be accessed for
+   some reason, or some error occurred 0 is returned.
+
+
+v4l1compat.so wrapper library
+=============================
+
+This library intercepts calls to open/close/ioctl/mmap/mmunmap
+operations and redirects them to the libv4l counterparts, by using
+LD_PRELOAD=/usr/lib/v4l1compat.so. It also emulates V4L1 calls via V4L2
+API.
+
+It allows usage of binary legacy applications that still don't use
+libv4l.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/libv4l.rst b/Documentation/linux_tv/media/v4l/libv4l.rst
new file mode 100644
index 000000000000..a88c52812f14
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/libv4l.rst
@@ -0,0 +1,24 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _libv4l:
+
+************************
+Libv4l Userspace Library
+************************
+
+
+.. toctree::
+    :maxdepth: 1
+
+    libv4l-introduction
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/lirc_dev_intro.rst b/Documentation/linux_tv/media/v4l/lirc_dev_intro.rst
new file mode 100644
index 000000000000..10d4d9a96b15
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/lirc_dev_intro.rst
@@ -0,0 +1,37 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _lirc_dev_intro:
+
+************
+Introduction
+************
+
+The LIRC device interface is a bi-directional interface for transporting
+raw IR data between userspace and kernelspace. Fundamentally, it is just
+a chardev (/dev/lircX, for X = 0, 1, 2, ...), with a number of standard
+struct file_operations defined on it. With respect to transporting raw
+IR data to and fro, the essential fops are read, write and ioctl.
+
+Example dmesg output upon a driver registering w/LIRC:
+
+    $ dmesg |grep lirc_dev
+
+    lirc_dev: IR Remote Control driver registered, major 248
+
+    rc rc0: lirc_dev: driver ir-lirc-codec (mceusb) registered at minor
+    = 0
+
+What you should see for a chardev:
+
+    $ ls -l /dev/lirc*
+
+    crw-rw---- 1 root root 248, 0 Jul 2 22:20 /dev/lirc0
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/lirc_device_interface.rst b/Documentation/linux_tv/media/v4l/lirc_device_interface.rst
new file mode 100644
index 000000000000..7f7bb6815013
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/lirc_device_interface.rst
@@ -0,0 +1,26 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _lirc_dev:
+
+LIRC Device Interface
+=====================
+
+
+.. toctree::
+    :maxdepth: 1
+
+    lirc_dev_intro
+    lirc_read
+    lirc_write
+    lirc_ioctl
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/lirc_ioctl.rst b/Documentation/linux_tv/media/v4l/lirc_ioctl.rst
new file mode 100644
index 000000000000..947c3bf9ae07
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/lirc_ioctl.rst
@@ -0,0 +1,165 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _lirc_ioctl:
+
+**************
+LIRC ioctl fop
+**************
+
+The LIRC device's ioctl definition is bound by the ioctl function
+definition of struct file_operations, leaving us with an unsigned int
+for the ioctl command and an unsigned long for the arg. For the purposes
+of ioctl portability across 32-bit and 64-bit, these values are capped
+to their 32-bit sizes.
+
+The following ioctls can be used to change specific hardware settings.
+In general each driver should have a default set of settings. The driver
+implementation is expected to re-apply the default settings when the
+device is closed by user-space, so that every application opening the
+device can rely on working with the default settings initially.
+
+LIRC_GET_FEATURES
+    Obviously, get the underlying hardware device's features. If a
+    driver does not announce support of certain features, calling of the
+    corresponding ioctls is undefined.
+
+LIRC_GET_SEND_MODE
+    Get supported transmit mode. Only LIRC_MODE_PULSE is supported by
+    lircd.
+
+LIRC_GET_REC_MODE
+    Get supported receive modes. Only LIRC_MODE_MODE2 and
+    LIRC_MODE_LIRCCODE are supported by lircd.
+
+LIRC_GET_SEND_CARRIER
+    Get carrier frequency (in Hz) currently used for transmit.
+
+LIRC_GET_REC_CARRIER
+    Get carrier frequency (in Hz) currently used for IR reception.
+
+LIRC_{G,S}ET_{SEND,REC}_DUTY_CYCLE
+    Get/set the duty cycle (from 0 to 100) of the carrier signal.
+    Currently, no special meaning is defined for 0 or 100, but this
+    could be used to switch off carrier generation in the future, so
+    these values should be reserved.
+
+LIRC_GET_REC_RESOLUTION
+    Some receiver have maximum resolution which is defined by internal
+    sample rate or data format limitations. E.g. it's common that
+    signals can only be reported in 50 microsecond steps. This integer
+    value is used by lircd to automatically adjust the aeps tolerance
+    value in the lircd config file.
+
+LIRC_GET_M{IN,AX}_TIMEOUT
+    Some devices have internal timers that can be used to detect when
+    there's no IR activity for a long time. This can help lircd in
+    detecting that a IR signal is finished and can speed up the decoding
+    process. Returns an integer value with the minimum/maximum timeout
+    that can be set. Some devices have a fixed timeout, in that case
+    both ioctls will return the same value even though the timeout
+    cannot be changed.
+
+LIRC_GET_M{IN,AX}_FILTER_{PULSE,SPACE}
+    Some devices are able to filter out spikes in the incoming signal
+    using given filter rules. These ioctls return the hardware
+    capabilities that describe the bounds of the possible filters.
+    Filter settings depend on the IR protocols that are expected. lircd
+    derives the settings from all protocols definitions found in its
+    config file.
+
+LIRC_GET_LENGTH
+    Retrieves the code length in bits (only for LIRC_MODE_LIRCCODE).
+    Reads on the device must be done in blocks matching the bit count.
+    The bit could should be rounded up so that it matches full bytes.
+
+LIRC_SET_{SEND,REC}_MODE
+    Set send/receive mode. Largely obsolete for send, as only
+    LIRC_MODE_PULSE is supported.
+
+LIRC_SET_{SEND,REC}_CARRIER
+    Set send/receive carrier (in Hz).
+
+LIRC_SET_TRANSMITTER_MASK
+    This enables the given set of transmitters. The first transmitter is
+    encoded by the least significant bit, etc. When an invalid bit mask
+    is given, i.e. a bit is set, even though the device does not have so
+    many transitters, then this ioctl returns the number of available
+    transitters and does nothing otherwise.
+
+LIRC_SET_REC_TIMEOUT
+    Sets the integer value for IR inactivity timeout (cf.
+    LIRC_GET_MIN_TIMEOUT and LIRC_GET_MAX_TIMEOUT). A value of 0
+    (if supported by the hardware) disables all hardware timeouts and
+    data should be reported as soon as possible. If the exact value
+    cannot be set, then the next possible value _greater_ than the
+    given value should be set.
+
+LIRC_SET_REC_TIMEOUT_REPORTS
+    Enable (1) or disable (0) timeout reports in LIRC_MODE_MODE2. By
+    default, timeout reports should be turned off.
+
+LIRC_SET_REC_FILTER_{,PULSE,SPACE}
+    Pulses/spaces shorter than this are filtered out by hardware. If
+    filters cannot be set independently for pulse/space, the
+    corresponding ioctls must return an error and LIRC_SET_REC_FILTER
+    shall be used instead.
+
+LIRC_SET_MEASURE_CARRIER_MODE
+    Enable (1)/disable (0) measure mode. If enabled, from the next key
+    press on, the driver will send LIRC_MODE2_FREQUENCY packets. By
+    default this should be turned off.
+
+LIRC_SET_REC_{DUTY_CYCLE,CARRIER}_RANGE
+    To set a range use
+    LIRC_SET_REC_DUTY_CYCLE_RANGE/LIRC_SET_REC_CARRIER_RANGE
+    with the lower bound first and later
+    LIRC_SET_REC_DUTY_CYCLE/LIRC_SET_REC_CARRIER with the upper
+    bound.
+
+LIRC_NOTIFY_DECODE
+    This ioctl is called by lircd whenever a successful decoding of an
+    incoming IR signal could be done. This can be used by supporting
+    hardware to give visual feedback to the user e.g. by flashing a LED.
+
+LIRC_SETUP_{START,END}
+    Setting of several driver parameters can be optimized by
+    encapsulating the according ioctl calls with
+    LIRC_SETUP_START/LIRC_SETUP_END. When a driver receives a
+    LIRC_SETUP_START ioctl it can choose to not commit further setting
+    changes to the hardware until a LIRC_SETUP_END is received. But
+    this is open to the driver implementation and every driver must also
+    handle parameter changes which are not encapsulated by
+    LIRC_SETUP_START and LIRC_SETUP_END. Drivers can also choose to
+    ignore these ioctls.
+
+LIRC_SET_WIDEBAND_RECEIVER
+    Some receivers are equipped with special wide band receiver which is
+    intended to be used to learn output of existing remote. Calling that
+    ioctl with (1) will enable it, and with (0) disable it. This might
+    be useful of receivers that have otherwise narrow band receiver that
+    prevents them to be used with some remotes. Wide band receiver might
+    also be more precise On the other hand its disadvantage it usually
+    reduced range of reception. Note: wide band receiver might be
+    implictly enabled if you enable carrier reports. In that case it
+    will be disabled as soon as you disable carrier reports. Trying to
+    disable wide band receiver while carrier reports are active will do
+    nothing.
+
+
+.. _lirc_dev_errors:
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/lirc_read.rst b/Documentation/linux_tv/media/v4l/lirc_read.rst
new file mode 100644
index 000000000000..eb2387521862
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/lirc_read.rst
@@ -0,0 +1,28 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _lirc_read:
+
+*************
+LIRC read fop
+*************
+
+The lircd userspace daemon reads raw IR data from the LIRC chardev. The
+exact format of the data depends on what modes a driver supports, and
+what mode has been selected. lircd obtains supported modes and sets the
+active mode via the ioctl interface, detailed at :ref:`lirc_ioctl`.
+The generally preferred mode is LIRC_MODE_MODE2, in which packets
+containing an int value describing an IR signal are read from the
+chardev.
+
+See also
+`http://www.lirc.org/html/technical.html <http://www.lirc.org/html/technical.html>`__
+for more info.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/lirc_write.rst b/Documentation/linux_tv/media/v4l/lirc_write.rst
new file mode 100644
index 000000000000..167d8b5198d8
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/lirc_write.rst
@@ -0,0 +1,23 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _lirc_write:
+
+**************
+LIRC write fop
+**************
+
+The data written to the chardev is a pulse/space sequence of integer
+values. Pulses and spaces are only marked implicitly by their position.
+The data must start and end with a pulse, therefore, the data must
+always include an uneven number of samples. The write function must
+block until the data has been transmitted by the hardware. If more data
+is provided than the hardware can send, the driver returns EINVAL.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/media-controller-intro.rst b/Documentation/linux_tv/media/v4l/media-controller-intro.rst
new file mode 100644
index 000000000000..e7e0d5cfe9ca
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/media-controller-intro.rst
@@ -0,0 +1,42 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _media-controller-intro:
+
+Introduction
+============
+
+Media devices increasingly handle multiple related functions. Many USB
+cameras include microphones, video capture hardware can also output
+video, or SoC camera interfaces also perform memory-to-memory operations
+similar to video codecs.
+
+Independent functions, even when implemented in the same hardware, can
+be modelled as separate devices. A USB camera with a microphone will be
+presented to userspace applications as V4L2 and ALSA capture devices.
+The devices' relationships (when using a webcam, end-users shouldn't
+have to manually select the associated USB microphone), while not made
+available directly to applications by the drivers, can usually be
+retrieved from sysfs.
+
+With more and more advanced SoC devices being introduced, the current
+approach will not scale. Device topologies are getting increasingly
+complex and can't always be represented by a tree structure. Hardware
+blocks are shared between different functions, creating dependencies
+between seemingly unrelated devices.
+
+Kernel abstraction APIs such as V4L2 and ALSA provide means for
+applications to access hardware parameters. As newer hardware expose an
+increasingly high number of those parameters, drivers need to guess what
+applications really require based on limited information, thereby
+implementing policies that belong to userspace.
+
+The media controller API aims at solving those problems.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/media-controller-model.rst b/Documentation/linux_tv/media/v4l/media-controller-model.rst
new file mode 100644
index 000000000000..c9abb8e14302
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/media-controller-model.rst
@@ -0,0 +1,44 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _media-controller-model:
+
+Media device model
+==================
+
+Discovering a device internal topology, and configuring it at runtime,
+is one of the goals of the media controller API. To achieve this,
+hardware devices and Linux Kernel interfaces are modelled as graph
+objects on an oriented graph. The object types that constitute the graph
+are:
+
+-  An **entity** is a basic media hardware or software building block.
+   It can correspond to a large variety of logical blocks such as
+   physical hardware devices (CMOS sensor for instance), logical
+   hardware devices (a building block in a System-on-Chip image
+   processing pipeline), DMA channels or physical connectors.
+
+-  An **interface** is a graph representation of a Linux Kernel
+   userspace API interface, like a device node or a sysfs file that
+   controls one or more entities in the graph.
+
+-  A **pad** is a data connection endpoint through which an entity can
+   interact with other entities. Data (not restricted to video) produced
+   by an entity flows from the entity's output to one or more entity
+   inputs. Pads should not be confused with physical pins at chip
+   boundaries.
+
+-  A **data link** is a point-to-point oriented connection between two
+   pads, either on the same entity or on different entities. Data flows
+   from a source pad to a sink pad.
+
+-  An **interface link** is a point-to-point bidirectional control
+   connection between a Linux Kernel interface and an entity.m
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/media-controller.rst b/Documentation/linux_tv/media/v4l/media-controller.rst
new file mode 100644
index 000000000000..4fd39178ccd7
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/media-controller.rst
@@ -0,0 +1,66 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _media_common:
+
+####################
+Media Controller API
+####################
+
+.. _media_controller:
+
+****************
+Media Controller
+****************
+
+
+.. toctree::
+    :maxdepth: 1
+
+    media-controller-intro
+    media-controller-model
+    media-types
+
+
+.. _media-user-func:
+
+******************
+Function Reference
+******************
+
+
+.. toctree::
+    :maxdepth: 1
+
+    media-func-open
+    media-func-close
+    media-func-ioctl
+    media-ioc-device-info
+    media-ioc-g-topology
+    media-ioc-enum-entities
+    media-ioc-enum-links
+    media-ioc-setup-link
+
+
+**********************
+Revision and Copyright
+**********************
+
+
+:author:    Pinchart Laurent
+:address:   laurent.pinchart@ideasonboard.com
+:contrib:   Initial version.
+
+**Copyright** 2010 : Laurent Pinchart
+
+:revision: 1.0.0 / 2010-11-10 (*lp*)
+
+Initial revision
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/media-func-close.rst b/Documentation/linux_tv/media/v4l/media-func-close.rst
new file mode 100644
index 000000000000..4049db61ac73
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/media-func-close.rst
@@ -0,0 +1,54 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _media-func-close:
+
+*************
+media close()
+*************
+
+*man media-close(2)*
+
+Close a media device
+
+
+Synopsis
+========
+
+.. code-block:: c
+
+    #include <unistd.h>
+
+
+.. c:function:: int close( int fd )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+
+Description
+===========
+
+Closes the media device. Resources associated with the file descriptor
+are freed. The device configuration remain unchanged.
+
+
+Return Value
+============
+
+:c:func:`close()` returns 0 on success. On error, -1 is returned, and
+``errno`` is set appropriately. Possible error codes are:
+
+EBADF
+    ``fd`` is not a valid open file descriptor.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/media-func-ioctl.rst b/Documentation/linux_tv/media/v4l/media-func-ioctl.rst
new file mode 100644
index 000000000000..c07f4c05d0bc
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/media-func-ioctl.rst
@@ -0,0 +1,74 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _media-func-ioctl:
+
+*************
+media ioctl()
+*************
+
+*man media-ioctl(2)*
+
+Control a media device
+
+
+Synopsis
+========
+
+.. code-block:: c
+
+    #include <sys/ioctl.h>
+
+
+.. c:function:: int ioctl( int fd, int request, void *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    Media ioctl request code as defined in the media.h header file, for
+    example MEDIA_IOC_SETUP_LINK.
+
+``argp``
+    Pointer to a request-specific structure.
+
+
+Description
+===========
+
+The :c:func:`ioctl()` function manipulates media device parameters.
+The argument ``fd`` must be an open file descriptor.
+
+The ioctl ``request`` code specifies the media function to be called. It
+has encoded in it whether the argument is an input, output or read/write
+parameter, and the size of the argument ``argp`` in bytes.
+
+Macros and structures definitions specifying media ioctl requests and
+their parameters are located in the media.h header file. All media ioctl
+requests, their respective function and parameters are specified in
+:ref:`media-user-func`.
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+Request-specific error codes are listed in the individual requests
+descriptions.
+
+When an ioctl that takes an output or read/write parameter fails, the
+parameter remains unmodified.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/media-func-open.rst b/Documentation/linux_tv/media/v4l/media-func-open.rst
new file mode 100644
index 000000000000..59b01c294c9c
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/media-func-open.rst
@@ -0,0 +1,76 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _media-func-open:
+
+************
+media open()
+************
+
+*man media-open(2)*
+
+Open a media device
+
+
+Synopsis
+========
+
+.. code-block:: c
+
+    #include <fcntl.h>
+
+
+.. c:function:: int open( const char *device_name, int flags )
+
+Arguments
+=========
+
+``device_name``
+    Device to be opened.
+
+``flags``
+    Open flags. Access mode must be either ``O_RDONLY`` or ``O_RDWR``.
+    Other flags have no effect.
+
+
+Description
+===========
+
+To open a media device applications call :c:func:`open()` with the
+desired device name. The function has no side effects; the device
+configuration remain unchanged.
+
+When the device is opened in read-only mode, attempts to modify its
+configuration will result in an error, and ``errno`` will be set to
+EBADF.
+
+
+Return Value
+============
+
+:c:func:`open()` returns the new file descriptor on success. On error,
+-1 is returned, and ``errno`` is set appropriately. Possible error codes
+are:
+
+EACCES
+    The requested access to the file is not allowed.
+
+EMFILE
+    The process already has the maximum number of files open.
+
+ENFILE
+    The system limit on the total number of open files has been reached.
+
+ENOMEM
+    Insufficient kernel memory was available.
+
+ENXIO
+    No device corresponding to this device special file exists.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/media-ioc-device-info.rst b/Documentation/linux_tv/media/v4l/media-ioc-device-info.rst
new file mode 100644
index 000000000000..7c1b3904fbb2
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/media-ioc-device-info.rst
@@ -0,0 +1,149 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _media-ioc-device-info:
+
+***************************
+ioctl MEDIA_IOC_DEVICE_INFO
+***************************
+
+*man MEDIA_IOC_DEVICE_INFO(2)*
+
+Query device information
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct media_device_info *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <media-func-open>`.
+
+``request``
+    MEDIA_IOC_DEVICE_INFO
+
+``argp``
+
+
+Description
+===========
+
+All media devices must support the ``MEDIA_IOC_DEVICE_INFO`` ioctl. To
+query device information, applications call the ioctl with a pointer to
+a struct :ref:`media_device_info <media-device-info>`. The driver
+fills the structure and returns the information to the application. The
+ioctl never fails.
+
+
+.. _media-device-info:
+
+.. flat-table:: struct media_device_info
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  char
+
+       -  ``driver``\ [16]
+
+       -  Name of the driver implementing the media API as a NUL-terminated
+          ASCII string. The driver version is stored in the
+          ``driver_version`` field.
+
+          Driver specific applications can use this information to verify
+          the driver identity. It is also useful to work around known bugs,
+          or to identify drivers in error reports.
+
+    -  .. row 2
+
+       -  char
+
+       -  ``model``\ [32]
+
+       -  Device model name as a NUL-terminated UTF-8 string. The device
+          version is stored in the ``device_version`` field and is not be
+          appended to the model name.
+
+    -  .. row 3
+
+       -  char
+
+       -  ``serial``\ [40]
+
+       -  Serial number as a NUL-terminated ASCII string.
+
+    -  .. row 4
+
+       -  char
+
+       -  ``bus_info``\ [32]
+
+       -  Location of the device in the system as a NUL-terminated ASCII
+          string. This includes the bus type name (PCI, USB, ...) and a
+          bus-specific identifier.
+
+    -  .. row 5
+
+       -  __u32
+
+       -  ``media_version``
+
+       -  Media API version, formatted with the ``KERNEL_VERSION()`` macro.
+
+    -  .. row 6
+
+       -  __u32
+
+       -  ``hw_revision``
+
+       -  Hardware device revision in a driver-specific format.
+
+    -  .. row 7
+
+       -  __u32
+
+       -  ``driver_version``
+
+       -  Media device driver version, formatted with the
+          ``KERNEL_VERSION()`` macro. Together with the ``driver`` field
+          this identifies a particular driver.
+
+    -  .. row 8
+
+       -  __u32
+
+       -  ``reserved``\ [31]
+
+       -  Reserved for future extensions. Drivers and applications must set
+          this array to zero.
+
+
+The ``serial`` and ``bus_info`` fields can be used to distinguish
+between multiple instances of otherwise identical hardware. The serial
+number takes precedence when provided and can be assumed to be unique.
+If the serial number is an empty string, the ``bus_info`` field can be
+used instead. The ``bus_info`` field is guaranteed to be unique, but can
+vary across reboots or device unplug/replug.
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/media-ioc-enum-entities.rst b/Documentation/linux_tv/media/v4l/media-ioc-enum-entities.rst
new file mode 100644
index 000000000000..842b05438edb
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/media-ioc-enum-entities.rst
@@ -0,0 +1,204 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _media-ioc-enum-entities:
+
+*****************************
+ioctl MEDIA_IOC_ENUM_ENTITIES
+*****************************
+
+*man MEDIA_IOC_ENUM_ENTITIES(2)*
+
+Enumerate entities and their properties
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct media_entity_desc *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <media-func-open>`.
+
+``request``
+    MEDIA_IOC_ENUM_ENTITIES
+
+``argp``
+
+
+Description
+===========
+
+To query the attributes of an entity, applications set the id field of a
+struct :ref:`media_entity_desc <media-entity-desc>` structure and
+call the MEDIA_IOC_ENUM_ENTITIES ioctl with a pointer to this
+structure. The driver fills the rest of the structure or returns an
+EINVAL error code when the id is invalid.
+
+Entities can be enumerated by or'ing the id with the
+``MEDIA_ENT_ID_FLAG_NEXT`` flag. The driver will return information
+about the entity with the smallest id strictly larger than the requested
+one ('next entity'), or the EINVAL error code if there is none.
+
+Entity IDs can be non-contiguous. Applications must *not* try to
+enumerate entities by calling MEDIA_IOC_ENUM_ENTITIES with increasing
+id's until they get an error.
+
+
+.. _media-entity-desc:
+
+.. flat-table:: struct media_entity_desc
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``id``
+
+       -  
+       -  
+       -  Entity id, set by the application. When the id is or'ed with
+          ``MEDIA_ENT_ID_FLAG_NEXT``, the driver clears the flag and returns
+          the first entity with a larger id.
+
+    -  .. row 2
+
+       -  char
+
+       -  ``name``\ [32]
+
+       -  
+       -  
+       -  Entity name as an UTF-8 NULL-terminated string.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``type``
+
+       -  
+       -  
+       -  Entity type, see :ref:`media-entity-type` for details.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``revision``
+
+       -  
+       -  
+       -  Entity revision. Always zero (obsolete)
+
+    -  .. row 5
+
+       -  __u32
+
+       -  ``flags``
+
+       -  
+       -  
+       -  Entity flags, see :ref:`media-entity-flag` for details.
+
+    -  .. row 6
+
+       -  __u32
+
+       -  ``group_id``
+
+       -  
+       -  
+       -  Entity group ID. Always zero (obsolete)
+
+    -  .. row 7
+
+       -  __u16
+
+       -  ``pads``
+
+       -  
+       -  
+       -  Number of pads
+
+    -  .. row 8
+
+       -  __u16
+
+       -  ``links``
+
+       -  
+       -  
+       -  Total number of outbound links. Inbound links are not counted in
+          this field.
+
+    -  .. row 9
+
+       -  union
+
+    -  .. row 10
+
+       -  
+       -  struct
+
+       -  ``dev``
+
+       -  
+       -  Valid for (sub-)devices that create a single device node.
+
+    -  .. row 11
+
+       -  
+       -  
+       -  __u32
+
+       -  ``major``
+
+       -  Device node major number.
+
+    -  .. row 12
+
+       -  
+       -  
+       -  __u32
+
+       -  ``minor``
+
+       -  Device node minor number.
+
+    -  .. row 13
+
+       -  
+       -  __u8
+
+       -  ``raw``\ [184]
+
+       -  
+       -  
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The struct :ref:`media_entity_desc <media-entity-desc>` ``id``
+    references a non-existing entity.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/media-ioc-enum-links.rst b/Documentation/linux_tv/media/v4l/media-ioc-enum-links.rst
new file mode 100644
index 000000000000..17aeb6d210f6
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/media-ioc-enum-links.rst
@@ -0,0 +1,180 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _media-ioc-enum-links:
+
+**************************
+ioctl MEDIA_IOC_ENUM_LINKS
+**************************
+
+*man MEDIA_IOC_ENUM_LINKS(2)*
+
+Enumerate all pads and links for a given entity
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct media_links_enum *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <media-func-open>`.
+
+``request``
+    MEDIA_IOC_ENUM_LINKS
+
+``argp``
+
+
+Description
+===========
+
+To enumerate pads and/or links for a given entity, applications set the
+entity field of a struct :ref:`media_links_enum <media-links-enum>`
+structure and initialize the struct
+:ref:`media_pad_desc <media-pad-desc>` and struct
+:ref:`media_link_desc <media-link-desc>` structure arrays pointed by
+the ``pads`` and ``links`` fields. They then call the
+MEDIA_IOC_ENUM_LINKS ioctl with a pointer to this structure.
+
+If the ``pads`` field is not NULL, the driver fills the ``pads`` array
+with information about the entity's pads. The array must have enough
+room to store all the entity's pads. The number of pads can be retrieved
+with the :ref:`MEDIA_IOC_ENUM_ENTITIES <media-ioc-enum-entities>`
+ioctl.
+
+If the ``links`` field is not NULL, the driver fills the ``links`` array
+with information about the entity's outbound links. The array must have
+enough room to store all the entity's outbound links. The number of
+outbound links can be retrieved with the
+:ref:`MEDIA_IOC_ENUM_ENTITIES <media-ioc-enum-entities>` ioctl.
+
+Only forward links that originate at one of the entity's source pads are
+returned during the enumeration process.
+
+
+.. _media-links-enum:
+
+.. flat-table:: struct media_links_enum
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``entity``
+
+       -  Entity id, set by the application.
+
+    -  .. row 2
+
+       -  struct :ref:`media_pad_desc <media-pad-desc>`
+
+       -  *\ ``pads``
+
+       -  Pointer to a pads array allocated by the application. Ignored if
+          NULL.
+
+    -  .. row 3
+
+       -  struct :ref:`media_link_desc <media-link-desc>`
+
+       -  *\ ``links``
+
+       -  Pointer to a links array allocated by the application. Ignored if
+          NULL.
+
+
+
+.. _media-pad-desc:
+
+.. flat-table:: struct media_pad_desc
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``entity``
+
+       -  ID of the entity this pad belongs to.
+
+    -  .. row 2
+
+       -  __u16
+
+       -  ``index``
+
+       -  0-based pad index.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``flags``
+
+       -  Pad flags, see :ref:`media-pad-flag` for more details.
+
+
+
+.. _media-link-desc:
+
+.. flat-table:: struct media_link_desc
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  struct :ref:`media_pad_desc <media-pad-desc>`
+
+       -  ``source``
+
+       -  Pad at the origin of this link.
+
+    -  .. row 2
+
+       -  struct :ref:`media_pad_desc <media-pad-desc>`
+
+       -  ``sink``
+
+       -  Pad at the target of this link.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``flags``
+
+       -  Link flags, see :ref:`media-link-flag` for more details.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The struct :ref:`media_links_enum <media-links-enum>` ``id``
+    references a non-existing entity.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/media-ioc-g-topology.rst b/Documentation/linux_tv/media/v4l/media-ioc-g-topology.rst
new file mode 100644
index 000000000000..65c817312df4
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/media-ioc-g-topology.rst
@@ -0,0 +1,436 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _media-g-topology:
+
+**************************
+ioctl MEDIA_IOC_G_TOPOLOGY
+**************************
+
+*man MEDIA_IOC_G_TOPOLOGY(2)*
+
+Enumerate the graph topology and graph element properties
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct media_v2_topology *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <media-func-open>`.
+
+``request``
+    MEDIA_IOC_G_TOPOLOGY
+
+``argp``
+
+
+Description
+===========
+
+The typical usage of this ioctl is to call it twice. On the first call,
+the structure defined at struct
+:ref:`media_v2_topology <media-v2-topology>` should be zeroed. At
+return, if no errors happen, this ioctl will return the
+``topology_version`` and the total number of entities, interfaces, pads
+and links.
+
+Before the second call, the userspace should allocate arrays to store
+the graph elements that are desired, putting the pointers to them at the
+ptr_entities, ptr_interfaces, ptr_links and/or ptr_pads, keeping the
+other values untouched.
+
+If the ``topology_version`` remains the same, the ioctl should fill the
+desired arrays with the media graph elements.
+
+
+.. _media-v2-topology:
+
+.. flat-table:: struct media_v2_topology
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  __u64
+
+       -  ``topology_version``
+
+       -  
+       -  
+       -  Version of the media graph topology. When the graph is created,
+          this field starts with zero. Every time a graph element is added
+          or removed, this field is incremented.
+
+    -  .. row 2
+
+       -  __u64
+
+       -  ``num_entities``
+
+       -  
+       -  
+       -  Number of entities in the graph
+
+    -  .. row 3
+
+       -  __u64
+
+       -  ``ptr_entities``
+
+       -  
+       -  
+       -  A pointer to a memory area where the entities array will be
+          stored, converted to a 64-bits integer. It can be zero. if zero,
+          the ioctl won't store the entities. It will just update
+          ``num_entities``
+
+    -  .. row 4
+
+       -  __u64
+
+       -  ``num_interfaces``
+
+       -  
+       -  
+       -  Number of interfaces in the graph
+
+    -  .. row 5
+
+       -  __u64
+
+       -  ``ptr_interfaces``
+
+       -  
+       -  
+       -  A pointer to a memory area where the interfaces array will be
+          stored, converted to a 64-bits integer. It can be zero. if zero,
+          the ioctl won't store the interfaces. It will just update
+          ``num_interfaces``
+
+    -  .. row 6
+
+       -  __u64
+
+       -  ``num_pads``
+
+       -  
+       -  
+       -  Total number of pads in the graph
+
+    -  .. row 7
+
+       -  __u64
+
+       -  ``ptr_pads``
+
+       -  
+       -  
+       -  A pointer to a memory area where the pads array will be stored,
+          converted to a 64-bits integer. It can be zero. if zero, the ioctl
+          won't store the pads. It will just update ``num_pads``
+
+    -  .. row 8
+
+       -  __u64
+
+       -  ``num_links``
+
+       -  
+       -  
+       -  Total number of data and interface links in the graph
+
+    -  .. row 9
+
+       -  __u64
+
+       -  ``ptr_links``
+
+       -  
+       -  
+       -  A pointer to a memory area where the links array will be stored,
+          converted to a 64-bits integer. It can be zero. if zero, the ioctl
+          won't store the links. It will just update ``num_links``
+
+
+
+.. _media-v2-entity:
+
+.. flat-table:: struct media_v2_entity
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``id``
+
+       -  
+       -  
+       -  Unique ID for the entity.
+
+    -  .. row 2
+
+       -  char
+
+       -  ``name``\ [64]
+
+       -  
+       -  
+       -  Entity name as an UTF-8 NULL-terminated string.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``function``
+
+       -  
+       -  
+       -  Entity main function, see :ref:`media-entity-type` for details.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``reserved``\ [12]
+
+       -  Reserved for future extensions. Drivers and applications must set
+          this array to zero.
+
+
+
+.. _media-v2-interface:
+
+.. flat-table:: struct media_v2_interface
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``id``
+
+       -  
+       -  
+       -  Unique ID for the interface.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``intf_type``
+
+       -  
+       -  
+       -  Interface type, see :ref:`media-intf-type` for details.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``flags``
+
+       -  
+       -  
+       -  Interface flags. Currently unused.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``reserved``\ [9]
+
+       -  
+       -  
+       -  Reserved for future extensions. Drivers and applications must set
+          this array to zero.
+
+    -  .. row 5
+
+       -  struct media_v2_intf_devnode
+
+       -  ``devnode``
+
+       -  
+       -  
+       -  Used only for device node interfaces. See
+          :ref:`media-v2-intf-devnode` for details..
+
+
+
+.. _media-v2-intf-devnode:
+
+.. flat-table:: struct media_v2_interface
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``major``
+
+       -  
+       -  
+       -  Device node major number.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``minor``
+
+       -  
+       -  
+       -  Device node minor number.
+
+
+
+.. _media-v2-pad:
+
+.. flat-table:: struct media_v2_pad
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``id``
+
+       -  
+       -  
+       -  Unique ID for the pad.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``entity_id``
+
+       -  
+       -  
+       -  Unique ID for the entity where this pad belongs.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``flags``
+
+       -  
+       -  
+       -  Pad flags, see :ref:`media-pad-flag` for more details.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``reserved``\ [9]
+
+       -  
+       -  
+       -  Reserved for future extensions. Drivers and applications must set
+          this array to zero.
+
+
+
+.. _media-v2-link:
+
+.. flat-table:: struct media_v2_pad
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``id``
+
+       -  
+       -  
+       -  Unique ID for the pad.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``source_id``
+
+       -  
+       -  
+       -  On pad to pad links: unique ID for the source pad.
+
+          On interface to entity links: unique ID for the interface.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``sink_id``
+
+       -  
+       -  
+       -  On pad to pad links: unique ID for the sink pad.
+
+          On interface to entity links: unique ID for the entity.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``flags``
+
+       -  
+       -  
+       -  Link flags, see :ref:`media-link-flag` for more details.
+
+    -  .. row 5
+
+       -  __u32
+
+       -  ``reserved``\ [5]
+
+       -  
+       -  
+       -  Reserved for future extensions. Drivers and applications must set
+          this array to zero.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+ENOSPC
+    This is returned when either one or more of the num_entities,
+    num_interfaces, num_links or num_pads are non-zero and are
+    smaller than the actual number of elements inside the graph. This
+    may happen if the ``topology_version`` changed when compared to the
+    last time this ioctl was called. Userspace should usually free the
+    area for the pointers, zero the struct elements and call this ioctl
+    again.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/media-ioc-setup-link.rst b/Documentation/linux_tv/media/v4l/media-ioc-setup-link.rst
new file mode 100644
index 000000000000..969a71c61309
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/media-ioc-setup-link.rst
@@ -0,0 +1,75 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _media-ioc-setup-link:
+
+**************************
+ioctl MEDIA_IOC_SETUP_LINK
+**************************
+
+*man MEDIA_IOC_SETUP_LINK(2)*
+
+Modify the properties of a link
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct media_link_desc *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <media-func-open>`.
+
+``request``
+    MEDIA_IOC_SETUP_LINK
+
+``argp``
+
+
+Description
+===========
+
+To change link properties applications fill a struct
+:ref:`media_link_desc <media-link-desc>` with link identification
+information (source and sink pad) and the new requested link flags. They
+then call the MEDIA_IOC_SETUP_LINK ioctl with a pointer to that
+structure.
+
+The only configurable property is the ``ENABLED`` link flag to
+enable/disable a link. Links marked with the ``IMMUTABLE`` link flag can
+not be enabled or disabled.
+
+Link configuration has no side effect on other links. If an enabled link
+at the sink pad prevents the link from being enabled, the driver returns
+with an EBUSY error code.
+
+Only links marked with the ``DYNAMIC`` link flag can be enabled/disabled
+while streaming media data. Attempting to enable or disable a streaming
+non-dynamic link will return an EBUSY error code.
+
+If the specified link can't be found the driver returns with an EINVAL
+error code.
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The struct :ref:`media_link_desc <media-link-desc>` references a
+    non-existing link, or the link is immutable and an attempt to modify
+    its configuration was made.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/media-types.rst b/Documentation/linux_tv/media/v4l/media-types.rst
new file mode 100644
index 000000000000..50dec2b6cb3a
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/media-types.rst
@@ -0,0 +1,433 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _media-controller-types:
+
+Types and flags used to represent the media graph elements
+==========================================================
+
+
+.. _media-entity-type:
+
+.. flat-table:: Media entity types
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``MEDIA_ENT_F_UNKNOWN`` and ``MEDIA_ENT_F_V4L2_SUBDEV_UNKNOWN``
+
+       -  Unknown entity. That generally indicates that a driver didn't
+          initialize properly the entity, with is a Kernel bug
+
+    -  .. row 2
+
+       -  ``MEDIA_ENT_F_IO_V4L``
+
+       -  Data streaming input and/or output entity.
+
+    -  .. row 3
+
+       -  ``MEDIA_ENT_F_IO_VBI``
+
+       -  V4L VBI streaming input or output entity
+
+    -  .. row 4
+
+       -  ``MEDIA_ENT_F_IO_SWRADIO``
+
+       -  V4L Software Digital Radio (SDR) streaming input or output entity
+
+    -  .. row 5
+
+       -  ``MEDIA_ENT_F_IO_DTV``
+
+       -  DVB Digital TV streaming input or output entity
+
+    -  .. row 6
+
+       -  ``MEDIA_ENT_F_DTV_DEMOD``
+
+       -  Digital TV demodulator entity.
+
+    -  .. row 7
+
+       -  ``MEDIA_ENT_F_TS_DEMUX``
+
+       -  MPEG Transport stream demux entity. Could be implemented on
+          hardware or in Kernelspace by the Linux DVB subsystem.
+
+    -  .. row 8
+
+       -  ``MEDIA_ENT_F_DTV_CA``
+
+       -  Digital TV Conditional Access module (CAM) entity
+
+    -  .. row 9
+
+       -  ``MEDIA_ENT_F_DTV_NET_DECAP``
+
+       -  Digital TV network ULE/MLE desencapsulation entity. Could be
+          implemented on hardware or in Kernelspace
+
+    -  .. row 10
+
+       -  ``MEDIA_ENT_F_CONN_RF``
+
+       -  Connector for a Radio Frequency (RF) signal.
+
+    -  .. row 11
+
+       -  ``MEDIA_ENT_F_CONN_SVIDEO``
+
+       -  Connector for a S-Video signal.
+
+    -  .. row 12
+
+       -  ``MEDIA_ENT_F_CONN_COMPOSITE``
+
+       -  Connector for a RGB composite signal.
+
+    -  .. row 13
+
+       -  ``MEDIA_ENT_F_CAM_SENSOR``
+
+       -  Camera video sensor entity.
+
+    -  .. row 14
+
+       -  ``MEDIA_ENT_F_FLASH``
+
+       -  Flash controller entity.
+
+    -  .. row 15
+
+       -  ``MEDIA_ENT_F_LENS``
+
+       -  Lens controller entity.
+
+    -  .. row 16
+
+       -  ``MEDIA_ENT_F_ATV_DECODER``
+
+       -  Analog video decoder, the basic function of the video decoder is
+          to accept analogue video from a wide variety of sources such as
+          broadcast, DVD players, cameras and video cassette recorders, in
+          either NTSC, PAL, SECAM or HD format, separating the stream into
+          its component parts, luminance and chrominance, and output it in
+          some digital video standard, with appropriate timing signals.
+
+    -  .. row 17
+
+       -  ``MEDIA_ENT_F_TUNER``
+
+       -  Digital TV, analog TV, radio and/or software radio tuner, with
+          consists on a PLL tuning stage that converts radio frequency (RF)
+          signal into an Intermediate Frequency (IF). Modern tuners have
+          internally IF-PLL decoders for audio and video, but older models
+          have those stages implemented on separate entities.
+
+    -  .. row 18
+
+       -  ``MEDIA_ENT_F_IF_VID_DECODER``
+
+       -  IF-PLL video decoder. It receives the IF from a PLL and decodes
+          the analog TV video signal. This is commonly found on some very
+          old analog tuners, like Philips MK3 designs. They all contain a
+          tda9887 (or some software compatible similar chip, like tda9885).
+          Those devices use a different I2C address than the tuner PLL.
+
+    -  .. row 19
+
+       -  ``MEDIA_ENT_F_IF_AUD_DECODER``
+
+       -  IF-PLL sound decoder. It receives the IF from a PLL and decodes
+          the analog TV audio signal. This is commonly found on some very
+          old analog hardware, like Micronas msp3400, Philips tda9840,
+          tda985x, etc. Those devices use a different I2C address than the
+          tuner PLL and should be controlled together with the IF-PLL video
+          decoder.
+
+    -  .. row 20
+
+       -  ``MEDIA_ENT_F_AUDIO_CAPTURE``
+
+       -  Audio Capture Function Entity.
+
+    -  .. row 21
+
+       -  ``MEDIA_ENT_F_AUDIO_PLAYBACK``
+
+       -  Audio Playback Function Entity.
+
+    -  .. row 22
+
+       -  ``MEDIA_ENT_F_AUDIO_MIXER``
+
+       -  Audio Mixer Function Entity.
+
+
+
+.. _media-entity-flag:
+
+.. flat-table:: Media entity flags
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``MEDIA_ENT_FL_DEFAULT``
+
+       -  Default entity for its type. Used to discover the default audio,
+          VBI and video devices, the default camera sensor, ...
+
+    -  .. row 2
+
+       -  ``MEDIA_ENT_FL_CONNECTOR``
+
+       -  The entity represents a data conector
+
+
+
+.. _media-intf-type:
+
+.. flat-table:: Media interface types
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``MEDIA_INTF_T_DVB_FE``
+
+       -  Device node interface for the Digital TV frontend
+
+       -  typically, /dev/dvb/adapter?/frontend?
+
+    -  .. row 2
+
+       -  ``MEDIA_INTF_T_DVB_DEMUX``
+
+       -  Device node interface for the Digital TV demux
+
+       -  typically, /dev/dvb/adapter?/demux?
+
+    -  .. row 3
+
+       -  ``MEDIA_INTF_T_DVB_DVR``
+
+       -  Device node interface for the Digital TV DVR
+
+       -  typically, /dev/dvb/adapter?/dvr?
+
+    -  .. row 4
+
+       -  ``MEDIA_INTF_T_DVB_CA``
+
+       -  Device node interface for the Digital TV Conditional Access
+
+       -  typically, /dev/dvb/adapter?/ca?
+
+    -  .. row 5
+
+       -  ``MEDIA_INTF_T_DVB_FE``
+
+       -  Device node interface for the Digital TV network control
+
+       -  typically, /dev/dvb/adapter?/net?
+
+    -  .. row 6
+
+       -  ``MEDIA_INTF_T_V4L_VIDEO``
+
+       -  Device node interface for video (V4L)
+
+       -  typically, /dev/video?
+
+    -  .. row 7
+
+       -  ``MEDIA_INTF_T_V4L_VBI``
+
+       -  Device node interface for VBI (V4L)
+
+       -  typically, /dev/vbi?
+
+    -  .. row 8
+
+       -  ``MEDIA_INTF_T_V4L_RADIO``
+
+       -  Device node interface for radio (V4L)
+
+       -  typically, /dev/vbi?
+
+    -  .. row 9
+
+       -  ``MEDIA_INTF_T_V4L_SUBDEV``
+
+       -  Device node interface for a V4L subdevice
+
+       -  typically, /dev/v4l-subdev?
+
+    -  .. row 10
+
+       -  ``MEDIA_INTF_T_V4L_SWRADIO``
+
+       -  Device node interface for Software Defined Radio (V4L)
+
+       -  typically, /dev/swradio?
+
+    -  .. row 11
+
+       -  ``MEDIA_INTF_T_ALSA_PCM_CAPTURE``
+
+       -  Device node interface for ALSA PCM Capture
+
+       -  typically, /dev/snd/pcmC?D?c
+
+    -  .. row 12
+
+       -  ``MEDIA_INTF_T_ALSA_PCM_PLAYBACK``
+
+       -  Device node interface for ALSA PCM Playback
+
+       -  typically, /dev/snd/pcmC?D?p
+
+    -  .. row 13
+
+       -  ``MEDIA_INTF_T_ALSA_CONTROL``
+
+       -  Device node interface for ALSA Control
+
+       -  typically, /dev/snd/controlC?
+
+    -  .. row 14
+
+       -  ``MEDIA_INTF_T_ALSA_COMPRESS``
+
+       -  Device node interface for ALSA Compress
+
+       -  typically, /dev/snd/compr?
+
+    -  .. row 15
+
+       -  ``MEDIA_INTF_T_ALSA_RAWMIDI``
+
+       -  Device node interface for ALSA Raw MIDI
+
+       -  typically, /dev/snd/midi?
+
+    -  .. row 16
+
+       -  ``MEDIA_INTF_T_ALSA_HWDEP``
+
+       -  Device node interface for ALSA Hardware Dependent
+
+       -  typically, /dev/snd/hwC?D?
+
+    -  .. row 17
+
+       -  ``MEDIA_INTF_T_ALSA_SEQUENCER``
+
+       -  Device node interface for ALSA Sequencer
+
+       -  typically, /dev/snd/seq
+
+    -  .. row 18
+
+       -  ``MEDIA_INTF_T_ALSA_TIMER``
+
+       -  Device node interface for ALSA Timer
+
+       -  typically, /dev/snd/timer
+
+
+
+.. _media-pad-flag:
+
+.. flat-table:: Media pad flags
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``MEDIA_PAD_FL_SINK``
+
+       -  Input pad, relative to the entity. Input pads sink data and are
+          targets of links.
+
+    -  .. row 2
+
+       -  ``MEDIA_PAD_FL_SOURCE``
+
+       -  Output pad, relative to the entity. Output pads source data and
+          are origins of links.
+
+    -  .. row 3
+
+       -  ``MEDIA_PAD_FL_MUST_CONNECT``
+
+       -  If this flag is set and the pad is linked to any other pad, then
+          at least one of those links must be enabled for the entity to be
+          able to stream. There could be temporary reasons (e.g. device
+          configuration dependent) for the pad to need enabled links even
+          when this flag isn't set; the absence of the flag doesn't imply
+          there is none.
+
+
+One and only one of ``MEDIA_PAD_FL_SINK`` and ``MEDIA_PAD_FL_SOURCE``
+must be set for every pad.
+
+
+.. _media-link-flag:
+
+.. flat-table:: Media link flags
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  ``MEDIA_LNK_FL_ENABLED``
+
+       -  The link is enabled and can be used to transfer media data. When
+          two or more links target a sink pad, only one of them can be
+          enabled at a time.
+
+    -  .. row 2
+
+       -  ``MEDIA_LNK_FL_IMMUTABLE``
+
+       -  The link enabled state can't be modified at runtime. An immutable
+          link is always enabled.
+
+    -  .. row 3
+
+       -  ``MEDIA_LNK_FL_DYNAMIC``
+
+       -  The link enabled state can be modified during streaming. This flag
+          is set by drivers and is read-only for applications.
+
+    -  .. row 4
+
+       -  ``MEDIA_LNK_FL_LINK_TYPE``
+
+       -  This is a bitmask that defines the type of the link. Currently,
+          two types of links are supported:
+
+          ``MEDIA_LNK_FL_DATA_LINK`` if the link is between two pads
+
+          ``MEDIA_LNK_FL_INTERFACE_LINK`` if the link is between an
+          interface and an entity
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/mmap.rst b/Documentation/linux_tv/media/v4l/mmap.rst
new file mode 100644
index 000000000000..54eb3b607587
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/mmap.rst
@@ -0,0 +1,286 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _mmap:
+
+******************************
+Streaming I/O (Memory Mapping)
+******************************
+
+Input and output devices support this I/O method when the
+``V4L2_CAP_STREAMING`` flag in the ``capabilities`` field of struct
+:ref:`v4l2_capability <v4l2-capability>` returned by the
+:ref:`VIDIOC_QUERYCAP <vidioc-querycap>` ioctl is set. There are two
+streaming methods, to determine if the memory mapping flavor is
+supported applications must call the
+:ref:`VIDIOC_REQBUFS <vidioc-reqbufs>` ioctl.
+
+Streaming is an I/O method where only pointers to buffers are exchanged
+between application and driver, the data itself is not copied. Memory
+mapping is primarily intended to map buffers in device memory into the
+application's address space. Device memory can be for example the video
+memory on a graphics card with a video capture add-on. However, being
+the most efficient I/O method available for a long time, many other
+drivers support streaming as well, allocating buffers in DMA-able main
+memory.
+
+A driver can support many sets of buffers. Each set is identified by a
+unique buffer type value. The sets are independent and each set can hold
+a different type of data. To access different sets at the same time
+different file descriptors must be used. [1]_
+
+To allocate device buffers applications call the
+:ref:`VIDIOC_REQBUFS <vidioc-reqbufs>` ioctl with the desired number
+of buffers and buffer type, for example ``V4L2_BUF_TYPE_VIDEO_CAPTURE``.
+This ioctl can also be used to change the number of buffers or to free
+the allocated memory, provided none of the buffers are still mapped.
+
+Before applications can access the buffers they must map them into their
+address space with the :ref:`mmap() <func-mmap>` function. The
+location of the buffers in device memory can be determined with the
+:ref:`VIDIOC_QUERYBUF <vidioc-querybuf>` ioctl. In the single-planar
+API case, the ``m.offset`` and ``length`` returned in a struct
+:ref:`v4l2_buffer <v4l2-buffer>` are passed as sixth and second
+parameter to the :c:func:`mmap()` function. When using the
+multi-planar API, struct :ref:`v4l2_buffer <v4l2-buffer>` contains an
+array of struct :ref:`v4l2_plane <v4l2-plane>` structures, each
+containing its own ``m.offset`` and ``length``. When using the
+multi-planar API, every plane of every buffer has to be mapped
+separately, so the number of calls to :ref:`mmap() <func-mmap>` should
+be equal to number of buffers times number of planes in each buffer. The
+offset and length values must not be modified. Remember, the buffers are
+allocated in physical memory, as opposed to virtual memory, which can be
+swapped out to disk. Applications should free the buffers as soon as
+possible with the :ref:`munmap() <func-munmap>` function.
+
+
+.. code-block:: c
+
+    struct v4l2_requestbuffers reqbuf;
+    struct {
+        void *start;
+        size_t length;
+    } *buffers;
+    unsigned int i;
+
+    memset(&reqbuf, 0, sizeof(reqbuf));
+    reqbuf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
+    reqbuf.memory = V4L2_MEMORY_MMAP;
+    reqbuf.count = 20;
+
+    if (-1 == ioctl (fd, VIDIOC_REQBUFS, &reqbuf)) {
+        if (errno == EINVAL)
+            printf("Video capturing or mmap-streaming is not supported\\n");
+        else
+            perror("VIDIOC_REQBUFS");
+
+        exit(EXIT_FAILURE);
+    }
+
+    /* We want at least five buffers. */
+
+    if (reqbuf.count < 5) {
+        /* You may need to free the buffers here. */
+        printf("Not enough buffer memory\\n");
+        exit(EXIT_FAILURE);
+    }
+
+    buffers = calloc(reqbuf.count, sizeof(*buffers));
+    assert(buffers != NULL);
+
+    for (i = 0; i < reqbuf.count; i++) {
+        struct v4l2_buffer buffer;
+
+        memset(&buffer, 0, sizeof(buffer));
+        buffer.type = reqbuf.type;
+        buffer.memory = V4L2_MEMORY_MMAP;
+        buffer.index = i;
+
+        if (-1 == ioctl (fd, VIDIOC_QUERYBUF, &buffer)) {
+            perror("VIDIOC_QUERYBUF");
+            exit(EXIT_FAILURE);
+        }
+
+        buffers[i].length = buffer.length; /* remember for munmap() */
+
+        buffers[i].start = mmap(NULL, buffer.length,
+                    PROT_READ | PROT_WRITE, /* recommended */
+                    MAP_SHARED,             /* recommended */
+                    fd, buffer.m.offset);
+
+        if (MAP_FAILED == buffers[i].start) {
+            /* If you do not exit here you should unmap() and free()
+               the buffers mapped so far. */
+            perror("mmap");
+            exit(EXIT_FAILURE);
+        }
+    }
+
+    /* Cleanup. */
+
+    for (i = 0; i < reqbuf.count; i++)
+        munmap(buffers[i].start, buffers[i].length);
+
+
+.. code-block:: c
+
+    struct v4l2_requestbuffers reqbuf;
+    /* Our current format uses 3 planes per buffer */
+    #define FMT_NUM_PLANES = 3
+
+    struct {
+        void *start[FMT_NUM_PLANES];
+        size_t length[FMT_NUM_PLANES];
+    } *buffers;
+    unsigned int i, j;
+
+    memset(&reqbuf, 0, sizeof(reqbuf));
+    reqbuf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE;
+    reqbuf.memory = V4L2_MEMORY_MMAP;
+    reqbuf.count = 20;
+
+    if (ioctl(fd, VIDIOC_REQBUFS, &reqbuf) < 0) {
+        if (errno == EINVAL)
+            printf("Video capturing or mmap-streaming is not supported\\n");
+        else
+            perror("VIDIOC_REQBUFS");
+
+        exit(EXIT_FAILURE);
+    }
+
+    /* We want at least five buffers. */
+
+    if (reqbuf.count < 5) {
+        /* You may need to free the buffers here. */
+        printf("Not enough buffer memory\\n");
+        exit(EXIT_FAILURE);
+    }
+
+    buffers = calloc(reqbuf.count, sizeof(*buffers));
+    assert(buffers != NULL);
+
+    for (i = 0; i < reqbuf.count; i++) {
+        struct v4l2_buffer buffer;
+        struct v4l2_plane planes[FMT_NUM_PLANES];
+
+        memset(&buffer, 0, sizeof(buffer));
+        buffer.type = reqbuf.type;
+        buffer.memory = V4L2_MEMORY_MMAP;
+        buffer.index = i;
+        /* length in struct v4l2_buffer in multi-planar API stores the size
+         * of planes array. */
+        buffer.length = FMT_NUM_PLANES;
+        buffer.m.planes = planes;
+
+        if (ioctl(fd, VIDIOC_QUERYBUF, &buffer) < 0) {
+            perror("VIDIOC_QUERYBUF");
+            exit(EXIT_FAILURE);
+        }
+
+        /* Every plane has to be mapped separately */
+        for (j = 0; j < FMT_NUM_PLANES; j++) {
+            buffers[i].length[j] = buffer.m.planes[j].length; /* remember for munmap() */
+
+            buffers[i].start[j] = mmap(NULL, buffer.m.planes[j].length,
+                     PROT_READ | PROT_WRITE, /* recommended */
+                     MAP_SHARED,             /* recommended */
+                     fd, buffer.m.planes[j].m.offset);
+
+            if (MAP_FAILED == buffers[i].start[j]) {
+                /* If you do not exit here you should unmap() and free()
+                   the buffers and planes mapped so far. */
+                perror("mmap");
+                exit(EXIT_FAILURE);
+            }
+        }
+    }
+
+    /* Cleanup. */
+
+    for (i = 0; i < reqbuf.count; i++)
+        for (j = 0; j < FMT_NUM_PLANES; j++)
+            munmap(buffers[i].start[j], buffers[i].length[j]);
+
+Conceptually streaming drivers maintain two buffer queues, an incoming
+and an outgoing queue. They separate the synchronous capture or output
+operation locked to a video clock from the application which is subject
+to random disk or network delays and preemption by other processes,
+thereby reducing the probability of data loss. The queues are organized
+as FIFOs, buffers will be output in the order enqueued in the incoming
+FIFO, and were captured in the order dequeued from the outgoing FIFO.
+
+The driver may require a minimum number of buffers enqueued at all times
+to function, apart of this no limit exists on the number of buffers
+applications can enqueue in advance, or dequeue and process. They can
+also enqueue in a different order than buffers have been dequeued, and
+the driver can *fill* enqueued *empty* buffers in any order.  [2]_ The
+index number of a buffer (struct :ref:`v4l2_buffer <v4l2-buffer>`
+``index``) plays no role here, it only identifies the buffer.
+
+Initially all mapped buffers are in dequeued state, inaccessible by the
+driver. For capturing applications it is customary to first enqueue all
+mapped buffers, then to start capturing and enter the read loop. Here
+the application waits until a filled buffer can be dequeued, and
+re-enqueues the buffer when the data is no longer needed. Output
+applications fill and enqueue buffers, when enough buffers are stacked
+up the output is started with ``VIDIOC_STREAMON``. In the write loop,
+when the application runs out of free buffers, it must wait until an
+empty buffer can be dequeued and reused.
+
+To enqueue and dequeue a buffer applications use the
+:ref:`VIDIOC_QBUF <vidioc-qbuf>` and
+:ref:`VIDIOC_DQBUF <vidioc-qbuf>` ioctl. The status of a buffer being
+mapped, enqueued, full or empty can be determined at any time using the
+:ref:`VIDIOC_QUERYBUF <vidioc-querybuf>` ioctl. Two methods exist to
+suspend execution of the application until one or more buffers can be
+dequeued. By default ``VIDIOC_DQBUF`` blocks when no buffer is in the
+outgoing queue. When the ``O_NONBLOCK`` flag was given to the
+:ref:`open() <func-open>` function, ``VIDIOC_DQBUF`` returns
+immediately with an EAGAIN error code when no buffer is available. The
+:ref:`select() <func-select>` or :ref:`poll() <func-poll>` functions
+are always available.
+
+To start and stop capturing or output applications call the
+:ref:`VIDIOC_STREAMON <vidioc-streamon>` and
+:ref:`VIDIOC_STREAMOFF <vidioc-streamon>` ioctl. Note
+``VIDIOC_STREAMOFF`` removes all buffers from both queues as a side
+effect. Since there is no notion of doing anything "now" on a
+multitasking system, if an application needs to synchronize with another
+event it should examine the struct :ref:`v4l2_buffer <v4l2-buffer>`
+``timestamp`` of captured or outputted buffers.
+
+Drivers implementing memory mapping I/O must support the
+``VIDIOC_REQBUFS``, ``VIDIOC_QUERYBUF``, ``VIDIOC_QBUF``,
+``VIDIOC_DQBUF``, ``VIDIOC_STREAMON`` and ``VIDIOC_STREAMOFF`` ioctl,
+the :c:func:`mmap()`, :c:func:`munmap()`, :c:func:`select()` and
+:c:func:`poll()` function. [3]_
+
+[capture example]
+
+.. [1]
+   One could use one file descriptor and set the buffer type field
+   accordingly when calling :ref:`VIDIOC_QBUF <vidioc-qbuf>` etc.,
+   but it makes the :c:func:`select()` function ambiguous. We also
+   like the clean approach of one file descriptor per logical stream.
+   Video overlay for example is also a logical stream, although the CPU
+   is not needed for continuous operation.
+
+.. [2]
+   Random enqueue order permits applications processing images out of
+   order (such as video codecs) to return buffers earlier, reducing the
+   probability of data loss. Random fill order allows drivers to reuse
+   buffers on a LIFO-basis, taking advantage of caches holding
+   scatter-gather lists and the like.
+
+.. [3]
+   At the driver level :c:func:`select()` and :c:func:`poll()` are
+   the same, and :c:func:`select()` is too important to be optional.
+   The rest should be evident.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/open.rst b/Documentation/linux_tv/media/v4l/open.rst
new file mode 100644
index 000000000000..7df540fae201
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/open.rst
@@ -0,0 +1,168 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _open:
+
+***************************
+Opening and Closing Devices
+***************************
+
+
+Device Naming
+=============
+
+V4L2 drivers are implemented as kernel modules, loaded manually by the
+system administrator or automatically when a device is first discovered.
+The driver modules plug into the "videodev" kernel module. It provides
+helper functions and a common application interface specified in this
+document.
+
+Each driver thus loaded registers one or more device nodes with major
+number 81 and a minor number between 0 and 255. Minor numbers are
+allocated dynamically unless the kernel is compiled with the kernel
+option CONFIG_VIDEO_FIXED_MINOR_RANGES. In that case minor numbers
+are allocated in ranges depending on the device node type (video, radio,
+etc.).
+
+Many drivers support "video_nr", "radio_nr" or "vbi_nr" module
+options to select specific video/radio/vbi node numbers. This allows the
+user to request that the device node is named e.g. /dev/video5 instead
+of leaving it to chance. When the driver supports multiple devices of
+the same type more than one device node number can be assigned,
+separated by commas:
+
+
+
+::
+
+    > modprobe mydriver video_nr=0,1 radio_nr=0,1
+In ``/etc/modules.conf`` this may be written as:
+
+
+
+::
+
+    options mydriver video_nr=0,1 radio_nr=0,1
+When no device node number is given as module option the driver supplies
+a default.
+
+Normally udev will create the device nodes in /dev automatically for
+you. If udev is not installed, then you need to enable the
+CONFIG_VIDEO_FIXED_MINOR_RANGES kernel option in order to be able to
+correctly relate a minor number to a device node number. I.e., you need
+to be certain that minor number 5 maps to device node name video5. With
+this kernel option different device types have different minor number
+ranges. These ranges are listed in :ref:`devices`.
+
+The creation of character special files (with mknod) is a privileged
+operation and devices cannot be opened by major and minor number. That
+means applications cannot *reliable* scan for loaded or installed
+drivers. The user must enter a device name, or the application can try
+the conventional device names.
+
+
+.. _related:
+
+Related Devices
+===============
+
+Devices can support several functions. For example video capturing, VBI
+capturing and radio support.
+
+The V4L2 API creates different nodes for each of these functions.
+
+The V4L2 API was designed with the idea that one device node could
+support all functions. However, in practice this never worked: this
+'feature' was never used by applications and many drivers did not
+support it and if they did it was certainly never tested. In addition,
+switching a device node between different functions only works when
+using the streaming I/O API, not with the read()/write() API.
+
+Today each device node supports just one function.
+
+Besides video input or output the hardware may also support audio
+sampling or playback. If so, these functions are implemented as ALSA PCM
+devices with optional ALSA audio mixer devices.
+
+One problem with all these devices is that the V4L2 API makes no
+provisions to find these related devices. Some really complex devices
+use the Media Controller (see :ref:`media_controller`) which can be
+used for this purpose. But most drivers do not use it, and while some
+code exists that uses sysfs to discover related devices (see
+libmedia_dev in the
+`v4l-utils <http://git.linuxtv.org/cgit.cgi/v4l-utils.git/>`__ git
+repository), there is no library yet that can provide a single API
+towards both Media Controller-based devices and devices that do not use
+the Media Controller. If you want to work on this please write to the
+linux-media mailing list:
+`https://linuxtv.org/lists.php <https://linuxtv.org/lists.php>`__.
+
+
+Multiple Opens
+==============
+
+V4L2 devices can be opened more than once. [1]_ When this is supported
+by the driver, users can for example start a "panel" application to
+change controls like brightness or audio volume, while another
+application captures video and audio. In other words, panel applications
+are comparable to an ALSA audio mixer application. Just opening a V4L2
+device should not change the state of the device. [2]_
+
+Once an application has allocated the memory buffers needed for
+streaming data (by calling the :ref:`VIDIOC_REQBUFS <vidioc-reqbufs>`
+or :ref:`VIDIOC_CREATE_BUFS <vidioc-create-bufs>` ioctls, or
+implicitly by calling the :ref:`read() <func-read>` or
+:ref:`write() <func-write>` functions) that application (filehandle)
+becomes the owner of the device. It is no longer allowed to make changes
+that would affect the buffer sizes (e.g. by calling the
+:ref:`VIDIOC_S_FMT <vidioc-g-fmt>` ioctl) and other applications are
+no longer allowed to allocate buffers or start or stop streaming. The
+EBUSY error code will be returned instead.
+
+Merely opening a V4L2 device does not grant exclusive access. [3]_
+Initiating data exchange however assigns the right to read or write the
+requested type of data, and to change related properties, to this file
+descriptor. Applications can request additional access privileges using
+the priority mechanism described in :ref:`app-pri`.
+
+
+Shared Data Streams
+===================
+
+V4L2 drivers should not support multiple applications reading or writing
+the same data stream on a device by copying buffers, time multiplexing
+or similar means. This is better handled by a proxy application in user
+space.
+
+
+Functions
+=========
+
+To open and close V4L2 devices applications use the
+:ref:`open() <func-open>` and :ref:`close() <func-close>` function,
+respectively. Devices are programmed using the
+:ref:`ioctl() <func-ioctl>` function as explained in the following
+sections.
+
+.. [1]
+   There are still some old and obscure drivers that have not been
+   updated to allow for multiple opens. This implies that for such
+   drivers :ref:`open() <func-open>` can return an EBUSY error code
+   when the device is already in use.
+
+.. [2]
+   Unfortunately, opening a radio device often switches the state of the
+   device to radio mode in many drivers. This behavior should be fixed
+   eventually as it violates the V4L2 specification.
+
+.. [3]
+   Drivers could recognize the ``O_EXCL`` open flag. Presently this is
+   not required, so applications cannot know if it really works.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-002.rst b/Documentation/linux_tv/media/v4l/pixfmt-002.rst
new file mode 100644
index 000000000000..d72c36552c4e
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-002.rst
@@ -0,0 +1,207 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+******************************
+Single-planar format structure
+******************************
+
+
+.. _v4l2-pix-format:
+
+.. flat-table:: struct v4l2_pix_format
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``width``
+
+       -  Image width in pixels.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``height``
+
+       -  Image height in pixels. If ``field`` is one of ``V4L2_FIELD_TOP``,
+          ``V4L2_FIELD_BOTTOM`` or ``V4L2_FIELD_ALTERNATE`` then height
+          refers to the number of lines in the field, otherwise it refers to
+          the number of lines in the frame (which is twice the field height
+          for interlaced formats).
+
+    -  .. row 3
+
+       -  :cspan:`2` Applications set these fields to request an image
+          size, drivers return the closest possible values. In case of
+          planar formats the ``width`` and ``height`` applies to the largest
+          plane. To avoid ambiguities drivers must return values rounded up
+          to a multiple of the scale factor of any smaller planes. For
+          example when the image format is YUV 4:2:0, ``width`` and
+          ``height`` must be multiples of two.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``pixelformat``
+
+       -  The pixel format or type of compression, set by the application.
+          This is a little endian
+          :ref:`four character code <v4l2-fourcc>`. V4L2 defines standard
+          RGB formats in :ref:`rgb-formats`, YUV formats in
+          :ref:`yuv-formats`, and reserved codes in
+          :ref:`reserved-formats`
+
+    -  .. row 5
+
+       -  enum :ref:`v4l2_field <v4l2-field>`
+
+       -  ``field``
+
+       -  Video images are typically interlaced. Applications can request to
+          capture or output only the top or bottom field, or both fields
+          interlaced or sequentially stored in one buffer or alternating in
+          separate buffers. Drivers return the actual field order selected.
+          For more details on fields see :ref:`field-order`.
+
+    -  .. row 6
+
+       -  __u32
+
+       -  ``bytesperline``
+
+       -  Distance in bytes between the leftmost pixels in two adjacent
+          lines.
+
+    -  .. row 7
+
+       -  :cspan:`2`
+
+          Both applications and drivers can set this field to request
+          padding bytes at the end of each line. Drivers however may ignore
+          the value requested by the application, returning ``width`` times
+          bytes per pixel or a larger value required by the hardware. That
+          implies applications can just set this field to zero to get a
+          reasonable default.
+
+          Video hardware may access padding bytes, therefore they must
+          reside in accessible memory. Consider cases where padding bytes
+          after the last line of an image cross a system page boundary.
+          Input devices may write padding bytes, the value is undefined.
+          Output devices ignore the contents of padding bytes.
+
+          When the image format is planar the ``bytesperline`` value applies
+          to the first plane and is divided by the same factor as the
+          ``width`` field for the other planes. For example the Cb and Cr
+          planes of a YUV 4:2:0 image have half as many padding bytes
+          following each line as the Y plane. To avoid ambiguities drivers
+          must return a ``bytesperline`` value rounded up to a multiple of
+          the scale factor.
+
+          For compressed formats the ``bytesperline`` value makes no sense.
+          Applications and drivers must set this to 0 in that case.
+
+    -  .. row 8
+
+       -  __u32
+
+       -  ``sizeimage``
+
+       -  Size in bytes of the buffer to hold a complete image, set by the
+          driver. Usually this is ``bytesperline`` times ``height``. When
+          the image consists of variable length compressed data this is the
+          maximum number of bytes required to hold an image.
+
+    -  .. row 9
+
+       -  enum :ref:`v4l2_colorspace <v4l2-colorspace>`
+
+       -  ``colorspace``
+
+       -  This information supplements the ``pixelformat`` and must be set
+          by the driver for capture streams and by the application for
+          output streams, see :ref:`colorspaces`.
+
+    -  .. row 10
+
+       -  __u32
+
+       -  ``priv``
+
+       -  This field indicates whether the remaining fields of the
+          :c:type:`struct v4l2_pix_format` structure, also called the
+          extended fields, are valid. When set to
+          ``V4L2_PIX_FMT_PRIV_MAGIC``, it indicates that the extended fields
+          have been correctly initialized. When set to any other value it
+          indicates that the extended fields contain undefined values.
+
+          Applications that wish to use the pixel format extended fields
+          must first ensure that the feature is supported by querying the
+          device for the :ref:`V4L2_CAP_EXT_PIX_FORMAT <querycap>`
+          capability. If the capability isn't set the pixel format extended
+          fields are not supported and using the extended fields will lead
+          to undefined results.
+
+          To use the extended fields, applications must set the ``priv``
+          field to ``V4L2_PIX_FMT_PRIV_MAGIC``, initialize all the extended
+          fields and zero the unused bytes of the
+          :c:type:`struct v4l2_format` ``raw_data`` field.
+
+          When the ``priv`` field isn't set to ``V4L2_PIX_FMT_PRIV_MAGIC``
+          drivers must act as if all the extended fields were set to zero.
+          On return drivers must set the ``priv`` field to
+          ``V4L2_PIX_FMT_PRIV_MAGIC`` and all the extended fields to
+          applicable values.
+
+    -  .. row 11
+
+       -  __u32
+
+       -  ``flags``
+
+       -  Flags set by the application or driver, see :ref:`format-flags`.
+
+    -  .. row 12
+
+       -  enum :ref:`v4l2_ycbcr_encoding <v4l2-ycbcr-encoding>`
+
+       -  ``ycbcr_enc``
+
+       -  This information supplements the ``colorspace`` and must be set by
+          the driver for capture streams and by the application for output
+          streams, see :ref:`colorspaces`.
+
+    -  .. row 13
+
+       -  enum :ref:`v4l2_quantization <v4l2-quantization>`
+
+       -  ``quantization``
+
+       -  This information supplements the ``colorspace`` and must be set by
+          the driver for capture streams and by the application for output
+          streams, see :ref:`colorspaces`.
+
+    -  .. row 14
+
+       -  enum :ref:`v4l2_xfer_func <v4l2-xfer-func>`
+
+       -  ``xfer_func``
+
+       -  This information supplements the ``colorspace`` and must be set by
+          the driver for capture streams and by the application for output
+          streams, see :ref:`colorspaces`.
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-003.rst b/Documentation/linux_tv/media/v4l/pixfmt-003.rst
new file mode 100644
index 000000000000..6ee05ff1dbb5
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-003.rst
@@ -0,0 +1,177 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+******************************
+Multi-planar format structures
+******************************
+
+The :c:type:`struct v4l2_plane_pix_format` structures define size
+and layout for each of the planes in a multi-planar format. The
+:c:type:`struct v4l2_pix_format_mplane` structure contains
+information common to all planes (such as image width and height) and an
+array of :c:type:`struct v4l2_plane_pix_format` structures,
+describing all planes of that format.
+
+
+.. _v4l2-plane-pix-format:
+
+.. flat-table:: struct v4l2_plane_pix_format
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``sizeimage``
+
+       -  Maximum size in bytes required for image data in this plane.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``bytesperline``
+
+       -  Distance in bytes between the leftmost pixels in two adjacent
+          lines. See struct :ref:`v4l2_pix_format <v4l2-pix-format>`.
+
+    -  .. row 3
+
+       -  __u16
+
+       -  ``reserved[6]``
+
+       -  Reserved for future extensions. Should be zeroed by drivers and
+          applications.
+
+
+
+.. _v4l2-pix-format-mplane:
+
+.. flat-table:: struct v4l2_pix_format_mplane
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``width``
+
+       -  Image width in pixels. See struct
+          :ref:`v4l2_pix_format <v4l2-pix-format>`.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``height``
+
+       -  Image height in pixels. See struct
+          :ref:`v4l2_pix_format <v4l2-pix-format>`.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``pixelformat``
+
+       -  The pixel format. Both single- and multi-planar four character
+          codes can be used.
+
+    -  .. row 4
+
+       -  enum :ref:`v4l2_field <v4l2-field>`
+
+       -  ``field``
+
+       -  See struct :ref:`v4l2_pix_format <v4l2-pix-format>`.
+
+    -  .. row 5
+
+       -  enum :ref:`v4l2_colorspace <v4l2-colorspace>`
+
+       -  ``colorspace``
+
+       -  See struct :ref:`v4l2_pix_format <v4l2-pix-format>`.
+
+    -  .. row 6
+
+       -  struct :ref:`v4l2_plane_pix_format <v4l2-plane-pix-format>`
+
+       -  ``plane_fmt[VIDEO_MAX_PLANES]``
+
+       -  An array of structures describing format of each plane this pixel
+          format consists of. The number of valid entries in this array has
+          to be put in the ``num_planes`` field.
+
+    -  .. row 7
+
+       -  __u8
+
+       -  ``num_planes``
+
+       -  Number of planes (i.e. separate memory buffers) for this format
+          and the number of valid entries in the ``plane_fmt`` array.
+
+    -  .. row 8
+
+       -  __u8
+
+       -  ``flags``
+
+       -  Flags set by the application or driver, see :ref:`format-flags`.
+
+    -  .. row 9
+
+       -  enum :ref:`v4l2_ycbcr_encoding <v4l2-ycbcr-encoding>`
+
+       -  ``ycbcr_enc``
+
+       -  This information supplements the ``colorspace`` and must be set by
+          the driver for capture streams and by the application for output
+          streams, see :ref:`colorspaces`.
+
+    -  .. row 10
+
+       -  enum :ref:`v4l2_quantization <v4l2-quantization>`
+
+       -  ``quantization``
+
+       -  This information supplements the ``colorspace`` and must be set by
+          the driver for capture streams and by the application for output
+          streams, see :ref:`colorspaces`.
+
+    -  .. row 11
+
+       -  enum :ref:`v4l2_xfer_func <v4l2-xfer-func>`
+
+       -  ``xfer_func``
+
+       -  This information supplements the ``colorspace`` and must be set by
+          the driver for capture streams and by the application for output
+          streams, see :ref:`colorspaces`.
+
+    -  .. row 12
+
+       -  __u8
+
+       -  ``reserved[7]``
+
+       -  Reserved for future extensions. Should be zeroed by drivers and
+          applications.
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-004.rst b/Documentation/linux_tv/media/v4l/pixfmt-004.rst
new file mode 100644
index 000000000000..a5599b44fd5d
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-004.rst
@@ -0,0 +1,60 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+**********************
+Standard Image Formats
+**********************
+
+In order to exchange images between drivers and applications, it is
+necessary to have standard image data formats which both sides will
+interpret the same way. V4L2 includes several such formats, and this
+section is intended to be an unambiguous specification of the standard
+image data formats in V4L2.
+
+V4L2 drivers are not limited to these formats, however. Driver-specific
+formats are possible. In that case the application may depend on a codec
+to convert images to one of the standard formats when needed. But the
+data can still be stored and retrieved in the proprietary format. For
+example, a device may support a proprietary compressed format.
+Applications can still capture and save the data in the compressed
+format, saving much disk space, and later use a codec to convert the
+images to the X Windows screen format when the video is to be displayed.
+
+Even so, ultimately, some standard formats are needed, so the V4L2
+specification would not be complete without well-defined standard
+formats.
+
+The V4L2 standard formats are mainly uncompressed formats. The pixels
+are always arranged in memory from left to right, and from top to
+bottom. The first byte of data in the image buffer is always for the
+leftmost pixel of the topmost row. Following that is the pixel
+immediately to its right, and so on until the end of the top row of
+pixels. Following the rightmost pixel of the row there may be zero or
+more bytes of padding to guarantee that each row of pixel data has a
+certain alignment. Following the pad bytes, if any, is data for the
+leftmost pixel of the second row from the top, and so on. The last row
+has just as many pad bytes after it as the other rows.
+
+In V4L2 each format has an identifier which looks like ``PIX_FMT_XXX``,
+defined in the :ref:`videodev2.h <videodev>` header file. These
+identifiers represent
+:ref:`four character (FourCC) codes <v4l2-fourcc>` which are also
+listed below, however they are not the same as those used in the Windows
+world.
+
+For some formats, data is stored in separate, discontiguous memory
+buffers. Those formats are identified by a separate set of FourCC codes
+and are referred to as "multi-planar formats". For example, a YUV422
+frame is normally stored in one memory buffer, but it can also be placed
+in two or three separate buffers, with Y component in one buffer and
+CbCr components in another in the 2-planar version or with each
+component in its own buffer in the 3-planar case. Those sub-buffers are
+referred to as "planes".
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-006.rst b/Documentation/linux_tv/media/v4l/pixfmt-006.rst
new file mode 100644
index 000000000000..89a990745111
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-006.rst
@@ -0,0 +1,291 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+****************************
+Defining Colorspaces in V4L2
+****************************
+
+In V4L2 colorspaces are defined by four values. The first is the
+colorspace identifier (enum :ref:`v4l2_colorspace <v4l2-colorspace>`)
+which defines the chromaticities, the default transfer function, the
+default Y'CbCr encoding and the default quantization method. The second
+is the transfer function identifier (enum
+:ref:`v4l2_xfer_func <v4l2-xfer-func>`) to specify non-standard
+transfer functions. The third is the Y'CbCr encoding identifier (enum
+:ref:`v4l2_ycbcr_encoding <v4l2-ycbcr-encoding>`) to specify
+non-standard Y'CbCr encodings and the fourth is the quantization
+identifier (enum :ref:`v4l2_quantization <v4l2-quantization>`) to
+specify non-standard quantization methods. Most of the time only the
+colorspace field of struct :ref:`v4l2_pix_format <v4l2-pix-format>`
+or struct :ref:`v4l2_pix_format_mplane <v4l2-pix-format-mplane>`
+needs to be filled in. Note that the default R'G'B' quantization is full
+range for all colorspaces except for BT.2020 which uses limited range
+R'G'B' quantization.
+
+
+.. _v4l2-colorspace:
+
+.. flat-table:: V4L2 Colorspaces
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  Identifier
+
+       -  Details
+
+    -  .. row 2
+
+       -  ``V4L2_COLORSPACE_DEFAULT``
+
+       -  The default colorspace. This can be used by applications to let
+          the driver fill in the colorspace.
+
+    -  .. row 3
+
+       -  ``V4L2_COLORSPACE_SMPTE170M``
+
+       -  See :ref:`col-smpte-170m`.
+
+    -  .. row 4
+
+       -  ``V4L2_COLORSPACE_REC709``
+
+       -  See :ref:`col-rec709`.
+
+    -  .. row 5
+
+       -  ``V4L2_COLORSPACE_SRGB``
+
+       -  See :ref:`col-srgb`.
+
+    -  .. row 6
+
+       -  ``V4L2_COLORSPACE_ADOBERGB``
+
+       -  See :ref:`col-adobergb`.
+
+    -  .. row 7
+
+       -  ``V4L2_COLORSPACE_BT2020``
+
+       -  See :ref:`col-bt2020`.
+
+    -  .. row 8
+
+       -  ``V4L2_COLORSPACE_DCI_P3``
+
+       -  See :ref:`col-dcip3`.
+
+    -  .. row 9
+
+       -  ``V4L2_COLORSPACE_SMPTE240M``
+
+       -  See :ref:`col-smpte-240m`.
+
+    -  .. row 10
+
+       -  ``V4L2_COLORSPACE_470_SYSTEM_M``
+
+       -  See :ref:`col-sysm`.
+
+    -  .. row 11
+
+       -  ``V4L2_COLORSPACE_470_SYSTEM_BG``
+
+       -  See :ref:`col-sysbg`.
+
+    -  .. row 12
+
+       -  ``V4L2_COLORSPACE_JPEG``
+
+       -  See :ref:`col-jpeg`.
+
+    -  .. row 13
+
+       -  ``V4L2_COLORSPACE_RAW``
+
+       -  The raw colorspace. This is used for raw image capture where the
+          image is minimally processed and is using the internal colorspace
+          of the device. The software that processes an image using this
+          'colorspace' will have to know the internals of the capture
+          device.
+
+
+
+.. _v4l2-xfer-func:
+
+.. flat-table:: V4L2 Transfer Function
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  Identifier
+
+       -  Details
+
+    -  .. row 2
+
+       -  ``V4L2_XFER_FUNC_DEFAULT``
+
+       -  Use the default transfer function as defined by the colorspace.
+
+    -  .. row 3
+
+       -  ``V4L2_XFER_FUNC_709``
+
+       -  Use the Rec. 709 transfer function.
+
+    -  .. row 4
+
+       -  ``V4L2_XFER_FUNC_SRGB``
+
+       -  Use the sRGB transfer function.
+
+    -  .. row 5
+
+       -  ``V4L2_XFER_FUNC_ADOBERGB``
+
+       -  Use the AdobeRGB transfer function.
+
+    -  .. row 6
+
+       -  ``V4L2_XFER_FUNC_SMPTE240M``
+
+       -  Use the SMPTE 240M transfer function.
+
+    -  .. row 7
+
+       -  ``V4L2_XFER_FUNC_NONE``
+
+       -  Do not use a transfer function (i.e. use linear RGB values).
+
+    -  .. row 8
+
+       -  ``V4L2_XFER_FUNC_DCI_P3``
+
+       -  Use the DCI-P3 transfer function.
+
+    -  .. row 9
+
+       -  ``V4L2_XFER_FUNC_SMPTE2084``
+
+       -  Use the SMPTE 2084 transfer function.
+
+
+
+.. _v4l2-ycbcr-encoding:
+
+.. flat-table:: V4L2 Y'CbCr Encodings
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  Identifier
+
+       -  Details
+
+    -  .. row 2
+
+       -  ``V4L2_YCBCR_ENC_DEFAULT``
+
+       -  Use the default Y'CbCr encoding as defined by the colorspace.
+
+    -  .. row 3
+
+       -  ``V4L2_YCBCR_ENC_601``
+
+       -  Use the BT.601 Y'CbCr encoding.
+
+    -  .. row 4
+
+       -  ``V4L2_YCBCR_ENC_709``
+
+       -  Use the Rec. 709 Y'CbCr encoding.
+
+    -  .. row 5
+
+       -  ``V4L2_YCBCR_ENC_XV601``
+
+       -  Use the extended gamut xvYCC BT.601 encoding.
+
+    -  .. row 6
+
+       -  ``V4L2_YCBCR_ENC_XV709``
+
+       -  Use the extended gamut xvYCC Rec. 709 encoding.
+
+    -  .. row 7
+
+       -  ``V4L2_YCBCR_ENC_SYCC``
+
+       -  Use the extended gamut sYCC encoding.
+
+    -  .. row 8
+
+       -  ``V4L2_YCBCR_ENC_BT2020``
+
+       -  Use the default non-constant luminance BT.2020 Y'CbCr encoding.
+
+    -  .. row 9
+
+       -  ``V4L2_YCBCR_ENC_BT2020_CONST_LUM``
+
+       -  Use the constant luminance BT.2020 Yc'CbcCrc encoding.
+
+
+
+.. _v4l2-quantization:
+
+.. flat-table:: V4L2 Quantization Methods
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  Identifier
+
+       -  Details
+
+    -  .. row 2
+
+       -  ``V4L2_QUANTIZATION_DEFAULT``
+
+       -  Use the default quantization encoding as defined by the
+          colorspace. This is always full range for R'G'B' (except for the
+          BT.2020 colorspace) and usually limited range for Y'CbCr.
+
+    -  .. row 3
+
+       -  ``V4L2_QUANTIZATION_FULL_RANGE``
+
+       -  Use the full range quantization encoding. I.e. the range [0…1] is
+          mapped to [0…255] (with possible clipping to [1…254] to avoid the
+          0x00 and 0xff values). Cb and Cr are mapped from [-0.5…0.5] to
+          [0…255] (with possible clipping to [1…254] to avoid the 0x00 and
+          0xff values).
+
+    -  .. row 4
+
+       -  ``V4L2_QUANTIZATION_LIM_RANGE``
+
+       -  Use the limited range quantization encoding. I.e. the range [0…1]
+          is mapped to [16…235]. Cb and Cr are mapped from [-0.5…0.5] to
+          [16…240].
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-007.rst b/Documentation/linux_tv/media/v4l/pixfmt-007.rst
new file mode 100644
index 000000000000..636506cefec1
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-007.rst
@@ -0,0 +1,870 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+********************************
+Detailed Colorspace Descriptions
+********************************
+
+
+.. _col-smpte-170m:
+
+Colorspace SMPTE 170M (V4L2_COLORSPACE_SMPTE170M)
+=================================================
+
+The :ref:`smpte170m` standard defines the colorspace used by NTSC and
+PAL and by SDTV in general. The default transfer function is
+``V4L2_XFER_FUNC_709``. The default Y'CbCr encoding is
+``V4L2_YCBCR_ENC_601``. The default Y'CbCr quantization is limited
+range. The chromaticities of the primary colors and the white reference
+are:
+
+
+
+.. flat-table:: SMPTE 170M Chromaticities
+    :header-rows:  1
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  Color
+
+       -  x
+
+       -  y
+
+    -  .. row 2
+
+       -  Red
+
+       -  0.630
+
+       -  0.340
+
+    -  .. row 3
+
+       -  Green
+
+       -  0.310
+
+       -  0.595
+
+    -  .. row 4
+
+       -  Blue
+
+       -  0.155
+
+       -  0.070
+
+    -  .. row 5
+
+       -  White Reference (D65)
+
+       -  0.3127
+
+       -  0.3290
+
+
+The red, green and blue chromaticities are also often referred to as the
+SMPTE C set, so this colorspace is sometimes called SMPTE C as well.
+
+The transfer function defined for SMPTE 170M is the same as the one
+defined in Rec. 709.
+    L' = -1.099(-L):sup:`0.45` + 0.099 for L ≤ -0.018
+
+    L' = 4.5L for -0.018 < L < 0.018
+
+    L' = 1.099L\ :sup:`0.45` - 0.099 for L ≥ 0.018
+
+Inverse Transfer function:
+    L = -((L' - 0.099) / -1.099):sup:`1/0.45` for L' ≤ -0.081
+
+    L = L' / 4.5 for -0.081 < L' < 0.081
+
+    L = ((L' + 0.099) / 1.099)\ :sup:`1/0.45` for L' ≥ 0.081
+
+The luminance (Y') and color difference (Cb and Cr) are obtained with
+the following ``V4L2_YCBCR_ENC_601`` encoding:
+    Y' = 0.299R' + 0.587G' + 0.114B'
+
+    Cb = -0.169R' - 0.331G' + 0.5B'
+
+    Cr = 0.5R' - 0.419G' - 0.081B'
+
+Y' is clamped to the range [0…1] and Cb and Cr are clamped to the range
+[-0.5…0.5]. This conversion to Y'CbCr is identical to the one defined in
+the :ref:`itu601` standard and this colorspace is sometimes called
+BT.601 as well, even though BT.601 does not mention any color primaries.
+
+The default quantization is limited range, but full range is possible
+although rarely seen.
+
+
+.. _col-rec709:
+
+Colorspace Rec. 709 (V4L2_COLORSPACE_REC709)
+============================================
+
+The :ref:`itu709` standard defines the colorspace used by HDTV in
+general. The default transfer function is ``V4L2_XFER_FUNC_709``. The
+default Y'CbCr encoding is ``V4L2_YCBCR_ENC_709``. The default Y'CbCr
+quantization is limited range. The chromaticities of the primary colors
+and the white reference are:
+
+
+
+.. flat-table:: Rec. 709 Chromaticities
+    :header-rows:  1
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  Color
+
+       -  x
+
+       -  y
+
+    -  .. row 2
+
+       -  Red
+
+       -  0.640
+
+       -  0.330
+
+    -  .. row 3
+
+       -  Green
+
+       -  0.300
+
+       -  0.600
+
+    -  .. row 4
+
+       -  Blue
+
+       -  0.150
+
+       -  0.060
+
+    -  .. row 5
+
+       -  White Reference (D65)
+
+       -  0.3127
+
+       -  0.3290
+
+
+The full name of this standard is Rec. ITU-R BT.709-5.
+
+Transfer function. Normally L is in the range [0…1], but for the
+extended gamut xvYCC encoding values outside that range are allowed.
+    L' = -1.099(-L):sup:`0.45` + 0.099 for L ≤ -0.018
+
+    L' = 4.5L for -0.018 < L < 0.018
+
+    L' = 1.099L\ :sup:`0.45` - 0.099 for L ≥ 0.018
+
+Inverse Transfer function:
+    L = -((L' - 0.099) / -1.099):sup:`1/0.45` for L' ≤ -0.081
+
+    L = L' / 4.5 for -0.081 < L' < 0.081
+
+    L = ((L' + 0.099) / 1.099)\ :sup:`1/0.45` for L' ≥ 0.081
+
+The luminance (Y') and color difference (Cb and Cr) are obtained with
+the following ``V4L2_YCBCR_ENC_709`` encoding:
+    Y' = 0.2126R' + 0.7152G' + 0.0722B'
+
+    Cb = -0.1146R' - 0.3854G' + 0.5B'
+
+    Cr = 0.5R' - 0.4542G' - 0.0458B'
+
+Y' is clamped to the range [0…1] and Cb and Cr are clamped to the range
+[-0.5…0.5].
+
+The default quantization is limited range, but full range is possible
+although rarely seen.
+
+The ``V4L2_YCBCR_ENC_709`` encoding described above is the default for
+this colorspace, but it can be overridden with ``V4L2_YCBCR_ENC_601``,
+in which case the BT.601 Y'CbCr encoding is used.
+
+Two additional extended gamut Y'CbCr encodings are also possible with
+this colorspace:
+
+The xvYCC 709 encoding (``V4L2_YCBCR_ENC_XV709``, :ref:`xvycc`) is
+similar to the Rec. 709 encoding, but it allows for R', G' and B' values
+that are outside the range [0…1]. The resulting Y', Cb and Cr values are
+scaled and offset:
+    Y' = (219 / 256) * (0.2126R' + 0.7152G' + 0.0722B') + (16 / 256)
+
+    Cb = (224 / 256) * (-0.1146R' - 0.3854G' + 0.5B')
+
+    Cr = (224 / 256) * (0.5R' - 0.4542G' - 0.0458B')
+
+The xvYCC 601 encoding (``V4L2_YCBCR_ENC_XV601``, :ref:`xvycc`) is
+similar to the BT.601 encoding, but it allows for R', G' and B' values
+that are outside the range [0…1]. The resulting Y', Cb and Cr values are
+scaled and offset:
+    Y' = (219 / 256) * (0.299R' + 0.587G' + 0.114B') + (16 / 256)
+
+    Cb = (224 / 256) * (-0.169R' - 0.331G' + 0.5B')
+
+    Cr = (224 / 256) * (0.5R' - 0.419G' - 0.081B')
+
+Y' is clamped to the range [0…1] and Cb and Cr are clamped to the range
+[-0.5…0.5]. The non-standard xvYCC 709 or xvYCC 601 encodings can be
+used by selecting ``V4L2_YCBCR_ENC_XV709`` or ``V4L2_YCBCR_ENC_XV601``.
+The xvYCC encodings always use full range quantization.
+
+
+.. _col-srgb:
+
+Colorspace sRGB (V4L2_COLORSPACE_SRGB)
+======================================
+
+The :ref:`srgb` standard defines the colorspace used by most webcams
+and computer graphics. The default transfer function is
+``V4L2_XFER_FUNC_SRGB``. The default Y'CbCr encoding is
+``V4L2_YCBCR_ENC_SYCC``. The default Y'CbCr quantization is full range.
+The chromaticities of the primary colors and the white reference are:
+
+
+
+.. flat-table:: sRGB Chromaticities
+    :header-rows:  1
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  Color
+
+       -  x
+
+       -  y
+
+    -  .. row 2
+
+       -  Red
+
+       -  0.640
+
+       -  0.330
+
+    -  .. row 3
+
+       -  Green
+
+       -  0.300
+
+       -  0.600
+
+    -  .. row 4
+
+       -  Blue
+
+       -  0.150
+
+       -  0.060
+
+    -  .. row 5
+
+       -  White Reference (D65)
+
+       -  0.3127
+
+       -  0.3290
+
+
+These chromaticities are identical to the Rec. 709 colorspace.
+
+Transfer function. Note that negative values for L are only used by the
+Y'CbCr conversion.
+    L' = -1.055(-L):sup:`1/2.4` + 0.055 for L < -0.0031308
+
+    L' = 12.92L for -0.0031308 ≤ L ≤ 0.0031308
+
+    L' = 1.055L\ :sup:`1/2.4` - 0.055 for 0.0031308 < L ≤ 1
+
+Inverse Transfer function:
+    L = -((-L' + 0.055) / 1.055)\ :sup:`2.4` for L' < -0.04045
+
+    L = L' / 12.92 for -0.04045 ≤ L' ≤ 0.04045
+
+    L = ((L' + 0.055) / 1.055)\ :sup:`2.4` for L' > 0.04045
+
+The luminance (Y') and color difference (Cb and Cr) are obtained with
+the following ``V4L2_YCBCR_ENC_SYCC`` encoding as defined by
+:ref:`sycc`:
+    Y' = 0.2990R' + 0.5870G' + 0.1140B'
+
+    Cb = -0.1687R' - 0.3313G' + 0.5B'
+
+    Cr = 0.5R' - 0.4187G' - 0.0813B'
+
+Y' is clamped to the range [0…1] and Cb and Cr are clamped to the range
+[-0.5…0.5]. The ``V4L2_YCBCR_ENC_SYCC`` quantization is always full
+range. Although this Y'CbCr encoding looks very similar to the
+``V4L2_YCBCR_ENC_XV601`` encoding, it is not. The
+``V4L2_YCBCR_ENC_XV601`` scales and offsets the Y'CbCr values before
+quantization, but this encoding does not do that.
+
+
+.. _col-adobergb:
+
+Colorspace Adobe RGB (V4L2_COLORSPACE_ADOBERGB)
+===============================================
+
+The :ref:`adobergb` standard defines the colorspace used by computer
+graphics that use the AdobeRGB colorspace. This is also known as the
+:ref:`oprgb` standard. The default transfer function is
+``V4L2_XFER_FUNC_ADOBERGB``. The default Y'CbCr encoding is
+``V4L2_YCBCR_ENC_601``. The default Y'CbCr quantization is limited
+range. The chromaticities of the primary colors and the white reference
+are:
+
+
+
+.. flat-table:: Adobe RGB Chromaticities
+    :header-rows:  1
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  Color
+
+       -  x
+
+       -  y
+
+    -  .. row 2
+
+       -  Red
+
+       -  0.6400
+
+       -  0.3300
+
+    -  .. row 3
+
+       -  Green
+
+       -  0.2100
+
+       -  0.7100
+
+    -  .. row 4
+
+       -  Blue
+
+       -  0.1500
+
+       -  0.0600
+
+    -  .. row 5
+
+       -  White Reference (D65)
+
+       -  0.3127
+
+       -  0.3290
+
+
+
+Transfer function:
+    L' = L\ :sup:`1/2.19921875`
+
+Inverse Transfer function:
+    L = L'\ :sup:`2.19921875`
+
+The luminance (Y') and color difference (Cb and Cr) are obtained with
+the following ``V4L2_YCBCR_ENC_601`` encoding:
+    Y' = 0.299R' + 0.587G' + 0.114B'
+
+    Cb = -0.169R' - 0.331G' + 0.5B'
+
+    Cr = 0.5R' - 0.419G' - 0.081B'
+
+Y' is clamped to the range [0…1] and Cb and Cr are clamped to the range
+[-0.5…0.5]. This transform is identical to one defined in SMPTE
+170M/BT.601. The Y'CbCr quantization is limited range.
+
+
+.. _col-bt2020:
+
+Colorspace BT.2020 (V4L2_COLORSPACE_BT2020)
+===========================================
+
+The :ref:`itu2020` standard defines the colorspace used by Ultra-high
+definition television (UHDTV). The default transfer function is
+``V4L2_XFER_FUNC_709``. The default Y'CbCr encoding is
+``V4L2_YCBCR_ENC_BT2020``. The default R'G'B' quantization is limited
+range (!), and so is the default Y'CbCr quantization. The chromaticities
+of the primary colors and the white reference are:
+
+
+
+.. flat-table:: BT.2020 Chromaticities
+    :header-rows:  1
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  Color
+
+       -  x
+
+       -  y
+
+    -  .. row 2
+
+       -  Red
+
+       -  0.708
+
+       -  0.292
+
+    -  .. row 3
+
+       -  Green
+
+       -  0.170
+
+       -  0.797
+
+    -  .. row 4
+
+       -  Blue
+
+       -  0.131
+
+       -  0.046
+
+    -  .. row 5
+
+       -  White Reference (D65)
+
+       -  0.3127
+
+       -  0.3290
+
+
+
+Transfer function (same as Rec. 709):
+    L' = 4.5L for 0 ≤ L < 0.018
+
+    L' = 1.099L\ :sup:`0.45` - 0.099 for 0.018 ≤ L ≤ 1
+
+Inverse Transfer function:
+    L = L' / 4.5 for L' < 0.081
+
+    L = ((L' + 0.099) / 1.099)\ :sup:`1/0.45` for L' ≥ 0.081
+
+The luminance (Y') and color difference (Cb and Cr) are obtained with
+the following ``V4L2_YCBCR_ENC_BT2020`` encoding:
+    Y' = 0.2627R' + 0.6780G' + 0.0593B'
+
+    Cb = -0.1396R' - 0.3604G' + 0.5B'
+
+    Cr = 0.5R' - 0.4598G' - 0.0402B'
+
+Y' is clamped to the range [0…1] and Cb and Cr are clamped to the range
+[-0.5…0.5]. The Y'CbCr quantization is limited range.
+
+There is also an alternate constant luminance R'G'B' to Yc'CbcCrc
+(``V4L2_YCBCR_ENC_BT2020_CONST_LUM``) encoding:
+
+Luma:
+    Yc' = (0.2627R + 0.6780G + 0.0593B)'
+
+B' - Yc' ≤ 0:
+    Cbc = (B' - Yc') / 1.9404
+
+B' - Yc' > 0:
+    Cbc = (B' - Yc') / 1.5816
+
+R' - Yc' ≤ 0:
+    Crc = (R' - Y') / 1.7184
+
+R' - Yc' > 0:
+    Crc = (R' - Y') / 0.9936
+
+Yc' is clamped to the range [0…1] and Cbc and Crc are clamped to the
+range [-0.5…0.5]. The Yc'CbcCrc quantization is limited range.
+
+
+.. _col-dcip3:
+
+Colorspace DCI-P3 (V4L2_COLORSPACE_DCI_P3)
+==========================================
+
+The :ref:`smpte431` standard defines the colorspace used by cinema
+projectors that use the DCI-P3 colorspace. The default transfer function
+is ``V4L2_XFER_FUNC_DCI_P3``. The default Y'CbCr encoding is
+``V4L2_YCBCR_ENC_709``. Note that this colorspace does not specify a
+Y'CbCr encoding since it is not meant to be encoded to Y'CbCr. So this
+default Y'CbCr encoding was picked because it is the HDTV encoding. The
+default Y'CbCr quantization is limited range. The chromaticities of the
+primary colors and the white reference are:
+
+
+
+.. flat-table:: DCI-P3 Chromaticities
+    :header-rows:  1
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  Color
+
+       -  x
+
+       -  y
+
+    -  .. row 2
+
+       -  Red
+
+       -  0.6800
+
+       -  0.3200
+
+    -  .. row 3
+
+       -  Green
+
+       -  0.2650
+
+       -  0.6900
+
+    -  .. row 4
+
+       -  Blue
+
+       -  0.1500
+
+       -  0.0600
+
+    -  .. row 5
+
+       -  White Reference
+
+       -  0.3140
+
+       -  0.3510
+
+
+
+Transfer function:
+    L' = L\ :sup:`1/2.6`
+
+Inverse Transfer function:
+    L = L'\ :sup:`2.6`
+
+Y'CbCr encoding is not specified. V4L2 defaults to Rec. 709.
+
+
+.. _col-smpte-240m:
+
+Colorspace SMPTE 240M (V4L2_COLORSPACE_SMPTE240M)
+=================================================
+
+The :ref:`smpte240m` standard was an interim standard used during the
+early days of HDTV (1988-1998). It has been superseded by Rec. 709. The
+default transfer function is ``V4L2_XFER_FUNC_SMPTE240M``. The default
+Y'CbCr encoding is ``V4L2_YCBCR_ENC_SMPTE240M``. The default Y'CbCr
+quantization is limited range. The chromaticities of the primary colors
+and the white reference are:
+
+
+
+.. flat-table:: SMPTE 240M Chromaticities
+    :header-rows:  1
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  Color
+
+       -  x
+
+       -  y
+
+    -  .. row 2
+
+       -  Red
+
+       -  0.630
+
+       -  0.340
+
+    -  .. row 3
+
+       -  Green
+
+       -  0.310
+
+       -  0.595
+
+    -  .. row 4
+
+       -  Blue
+
+       -  0.155
+
+       -  0.070
+
+    -  .. row 5
+
+       -  White Reference (D65)
+
+       -  0.3127
+
+       -  0.3290
+
+
+These chromaticities are identical to the SMPTE 170M colorspace.
+
+Transfer function:
+    L' = 4L for 0 ≤ L < 0.0228
+
+    L' = 1.1115L\ :sup:`0.45` - 0.1115 for 0.0228 ≤ L ≤ 1
+
+Inverse Transfer function:
+    L = L' / 4 for 0 ≤ L' < 0.0913
+
+    L = ((L' + 0.1115) / 1.1115)\ :sup:`1/0.45` for L' ≥ 0.0913
+
+The luminance (Y') and color difference (Cb and Cr) are obtained with
+the following ``V4L2_YCBCR_ENC_SMPTE240M`` encoding:
+    Y' = 0.2122R' + 0.7013G' + 0.0865B'
+
+    Cb = -0.1161R' - 0.3839G' + 0.5B'
+
+    Cr = 0.5R' - 0.4451G' - 0.0549B'
+
+Yc' is clamped to the range [0…1] and Cbc and Crc are clamped to the
+range [-0.5…0.5]. The Y'CbCr quantization is limited range.
+
+
+.. _col-sysm:
+
+Colorspace NTSC 1953 (V4L2_COLORSPACE_470_SYSTEM_M)
+===================================================
+
+This standard defines the colorspace used by NTSC in 1953. In practice
+this colorspace is obsolete and SMPTE 170M should be used instead. The
+default transfer function is ``V4L2_XFER_FUNC_709``. The default Y'CbCr
+encoding is ``V4L2_YCBCR_ENC_601``. The default Y'CbCr quantization is
+limited range. The chromaticities of the primary colors and the white
+reference are:
+
+
+
+.. flat-table:: NTSC 1953 Chromaticities
+    :header-rows:  1
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  Color
+
+       -  x
+
+       -  y
+
+    -  .. row 2
+
+       -  Red
+
+       -  0.67
+
+       -  0.33
+
+    -  .. row 3
+
+       -  Green
+
+       -  0.21
+
+       -  0.71
+
+    -  .. row 4
+
+       -  Blue
+
+       -  0.14
+
+       -  0.08
+
+    -  .. row 5
+
+       -  White Reference (C)
+
+       -  0.310
+
+       -  0.316
+
+
+Note that this colorspace uses Illuminant C instead of D65 as the white
+reference. To correctly convert an image in this colorspace to another
+that uses D65 you need to apply a chromatic adaptation algorithm such as
+the Bradford method.
+
+The transfer function was never properly defined for NTSC 1953. The Rec.
+709 transfer function is recommended in the literature:
+    L' = 4.5L for 0 ≤ L < 0.018
+
+    L' = 1.099L\ :sup:`0.45` - 0.099 for 0.018 ≤ L ≤ 1
+
+Inverse Transfer function:
+    L = L' / 4.5 for L' < 0.081
+
+    L = ((L' + 0.099) / 1.099)\ :sup:`1/0.45` for L' ≥ 0.081
+
+The luminance (Y') and color difference (Cb and Cr) are obtained with
+the following ``V4L2_YCBCR_ENC_601`` encoding:
+    Y' = 0.299R' + 0.587G' + 0.114B'
+
+    Cb = -0.169R' - 0.331G' + 0.5B'
+
+    Cr = 0.5R' - 0.419G' - 0.081B'
+
+Y' is clamped to the range [0…1] and Cb and Cr are clamped to the range
+[-0.5…0.5]. The Y'CbCr quantization is limited range. This transform is
+identical to one defined in SMPTE 170M/BT.601.
+
+
+.. _col-sysbg:
+
+Colorspace EBU Tech. 3213 (V4L2_COLORSPACE_470_SYSTEM_BG)
+=========================================================
+
+The :ref:`tech3213` standard defines the colorspace used by PAL/SECAM
+in 1975. In practice this colorspace is obsolete and SMPTE 170M should
+be used instead. The default transfer function is
+``V4L2_XFER_FUNC_709``. The default Y'CbCr encoding is
+``V4L2_YCBCR_ENC_601``. The default Y'CbCr quantization is limited
+range. The chromaticities of the primary colors and the white reference
+are:
+
+
+
+.. flat-table:: EBU Tech. 3213 Chromaticities
+    :header-rows:  1
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  Color
+
+       -  x
+
+       -  y
+
+    -  .. row 2
+
+       -  Red
+
+       -  0.64
+
+       -  0.33
+
+    -  .. row 3
+
+       -  Green
+
+       -  0.29
+
+       -  0.60
+
+    -  .. row 4
+
+       -  Blue
+
+       -  0.15
+
+       -  0.06
+
+    -  .. row 5
+
+       -  White Reference (D65)
+
+       -  0.3127
+
+       -  0.3290
+
+
+
+The transfer function was never properly defined for this colorspace.
+The Rec. 709 transfer function is recommended in the literature:
+    L' = 4.5L for 0 ≤ L < 0.018
+
+    L' = 1.099L\ :sup:`0.45` - 0.099 for 0.018 ≤ L ≤ 1
+
+Inverse Transfer function:
+    L = L' / 4.5 for L' < 0.081
+
+    L = ((L' + 0.099) / 1.099)\ :sup:`1/0.45` for L' ≥ 0.081
+
+The luminance (Y') and color difference (Cb and Cr) are obtained with
+the following ``V4L2_YCBCR_ENC_601`` encoding:
+    Y' = 0.299R' + 0.587G' + 0.114B'
+
+    Cb = -0.169R' - 0.331G' + 0.5B'
+
+    Cr = 0.5R' - 0.419G' - 0.081B'
+
+Y' is clamped to the range [0…1] and Cb and Cr are clamped to the range
+[-0.5…0.5]. The Y'CbCr quantization is limited range. This transform is
+identical to one defined in SMPTE 170M/BT.601.
+
+
+.. _col-jpeg:
+
+Colorspace JPEG (V4L2_COLORSPACE_JPEG)
+======================================
+
+This colorspace defines the colorspace used by most (Motion-)JPEG
+formats. The chromaticities of the primary colors and the white
+reference are identical to sRGB. The transfer function use is
+``V4L2_XFER_FUNC_SRGB``. The Y'CbCr encoding is ``V4L2_YCBCR_ENC_601``
+with full range quantization where Y' is scaled to [0…255] and Cb/Cr are
+scaled to [-128…128] and then clipped to [-128…127].
+
+Note that the JPEG standard does not actually store colorspace
+information. So if something other than sRGB is used, then the driver
+will have to set that information explicitly. Effectively
+``V4L2_COLORSPACE_JPEG`` can be considered to be an abbreviation for
+``V4L2_COLORSPACE_SRGB``, ``V4L2_YCBCR_ENC_601`` and
+``V4L2_QUANTIZATION_FULL_RANGE``.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-008.rst b/Documentation/linux_tv/media/v4l/pixfmt-008.rst
new file mode 100644
index 000000000000..ef3daf1a5487
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-008.rst
@@ -0,0 +1,41 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+***************************************
+Detailed Transfer Function Descriptions
+***************************************
+
+
+.. _xf-smpte-2084:
+
+Transfer Function SMPTE 2084 (V4L2_XFER_FUNC_SMPTE2084)
+=======================================================
+
+The :ref:`smpte2084` standard defines the transfer function used by
+High Dynamic Range content.
+
+Constants:
+    m1 = (2610 / 4096) / 4
+
+    m2 = (2523 / 4096) * 128
+
+    c1 = 3424 / 4096
+
+    c2 = (2413 / 4096) * 32
+
+    c3 = (2392 / 4096) * 32
+
+Transfer function:
+    L' = ((c1 + c2 * L\ :sup:`m1`) / (1 + c3 * L\ :sup:`m1`))\ :sup:`m2`
+
+Inverse Transfer function:
+    L = (max(L':sup:`1/m2` - c1, 0) / (c2 - c3 *
+    L'\ :sup:`1/m2`))\ :sup:`1/m1`
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-013.rst b/Documentation/linux_tv/media/v4l/pixfmt-013.rst
new file mode 100644
index 000000000000..384876e377b2
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-013.rst
@@ -0,0 +1,140 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+******************
+Compressed Formats
+******************
+
+
+.. _compressed-formats:
+
+.. flat-table:: Compressed Image Formats
+    :header-rows:  1
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  Identifier
+
+       -  Code
+
+       -  Details
+
+    -  .. _`V4L2-PIX-FMT-JPEG`:
+
+       -  ``V4L2_PIX_FMT_JPEG``
+
+       -  'JPEG'
+
+       -  TBD. See also :ref:`VIDIOC_G_JPEGCOMP <vidioc-g-jpegcomp>`,
+          :ref:`VIDIOC_S_JPEGCOMP <vidioc-g-jpegcomp>`.
+
+    -  .. _`V4L2-PIX-FMT-MPEG`:
+
+       -  ``V4L2_PIX_FMT_MPEG``
+
+       -  'MPEG'
+
+       -  MPEG multiplexed stream. The actual format is determined by
+          extended control ``V4L2_CID_MPEG_STREAM_TYPE``, see
+          :ref:`mpeg-control-id`.
+
+    -  .. _`V4L2-PIX-FMT-H264`:
+
+       -  ``V4L2_PIX_FMT_H264``
+
+       -  'H264'
+
+       -  H264 video elementary stream with start codes.
+
+    -  .. _`V4L2-PIX-FMT-H264-NO-SC`:
+
+       -  ``V4L2_PIX_FMT_H264_NO_SC``
+
+       -  'AVC1'
+
+       -  H264 video elementary stream without start codes.
+
+    -  .. _`V4L2-PIX-FMT-H264-MVC`:
+
+       -  ``V4L2_PIX_FMT_H264_MVC``
+
+       -  'M264'
+
+       -  H264 MVC video elementary stream.
+
+    -  .. _`V4L2-PIX-FMT-H263`:
+
+       -  ``V4L2_PIX_FMT_H263``
+
+       -  'H263'
+
+       -  H263 video elementary stream.
+
+    -  .. _`V4L2-PIX-FMT-MPEG1`:
+
+       -  ``V4L2_PIX_FMT_MPEG1``
+
+       -  'MPG1'
+
+       -  MPEG1 video elementary stream.
+
+    -  .. _`V4L2-PIX-FMT-MPEG2`:
+
+       -  ``V4L2_PIX_FMT_MPEG2``
+
+       -  'MPG2'
+
+       -  MPEG2 video elementary stream.
+
+    -  .. _`V4L2-PIX-FMT-MPEG4`:
+
+       -  ``V4L2_PIX_FMT_MPEG4``
+
+       -  'MPG4'
+
+       -  MPEG4 video elementary stream.
+
+    -  .. _`V4L2-PIX-FMT-XVID`:
+
+       -  ``V4L2_PIX_FMT_XVID``
+
+       -  'XVID'
+
+       -  Xvid video elementary stream.
+
+    -  .. _`V4L2-PIX-FMT-VC1-ANNEX-G`:
+
+       -  ``V4L2_PIX_FMT_VC1_ANNEX_G``
+
+       -  'VC1G'
+
+       -  VC1, SMPTE 421M Annex G compliant stream.
+
+    -  .. _`V4L2-PIX-FMT-VC1-ANNEX-L`:
+
+       -  ``V4L2_PIX_FMT_VC1_ANNEX_L``
+
+       -  'VC1L'
+
+       -  VC1, SMPTE 421M Annex L compliant stream.
+
+    -  .. _`V4L2-PIX-FMT-VP8`:
+
+       -  ``V4L2_PIX_FMT_VP8``
+
+       -  'VP80'
+
+       -  VP8 video elementary stream.
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-grey.rst b/Documentation/linux_tv/media/v4l/pixfmt-grey.rst
new file mode 100644
index 000000000000..7a9bfe0ec53a
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-grey.rst
@@ -0,0 +1,89 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-GREY:
+
+**************************
+V4L2_PIX_FMT_GREY ('GREY')
+**************************
+
+*man V4L2_PIX_FMT_GREY(2)*
+
+Grey-scale image
+
+
+Description
+===========
+
+This is a grey-scale image. It is really a degenerate Y'CbCr format
+which simply contains no Cb or Cr data.
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  Y'\ :sub:`00`
+
+       -  Y'\ :sub:`01`
+
+       -  Y'\ :sub:`02`
+
+       -  Y'\ :sub:`03`
+
+    -  .. row 2
+
+       -  start + 4:
+
+       -  Y'\ :sub:`10`
+
+       -  Y'\ :sub:`11`
+
+       -  Y'\ :sub:`12`
+
+       -  Y'\ :sub:`13`
+
+    -  .. row 3
+
+       -  start + 8:
+
+       -  Y'\ :sub:`20`
+
+       -  Y'\ :sub:`21`
+
+       -  Y'\ :sub:`22`
+
+       -  Y'\ :sub:`23`
+
+    -  .. row 4
+
+       -  start + 12:
+
+       -  Y'\ :sub:`30`
+
+       -  Y'\ :sub:`31`
+
+       -  Y'\ :sub:`32`
+
+       -  Y'\ :sub:`33`
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-indexed.rst b/Documentation/linux_tv/media/v4l/pixfmt-indexed.rst
new file mode 100644
index 000000000000..a85b9832035e
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-indexed.rst
@@ -0,0 +1,84 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _pixfmt-indexed:
+
+**************
+Indexed Format
+**************
+
+In this format each pixel is represented by an 8 bit index into a 256
+entry ARGB palette. It is intended for
+:ref:`Video Output Overlays <osd>` only. There are no ioctls to access
+the palette, this must be done with ioctls of the Linux framebuffer API.
+
+
+
+.. flat-table:: Indexed Image Format
+    :header-rows:  2
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  Identifier
+
+       -  Code
+
+       -  
+       -  :cspan:`7` Byte 0
+
+    -  .. row 2
+
+       -  
+       -  
+       -  Bit
+
+       -  7
+
+       -  6
+
+       -  5
+
+       -  4
+
+       -  3
+
+       -  2
+
+       -  1
+
+       -  0
+
+    -  .. _`V4L2-PIX-FMT-PAL8`:
+
+       -  ``V4L2_PIX_FMT_PAL8``
+
+       -  'PAL8'
+
+       -  
+       -  i\ :sub:`7`
+
+       -  i\ :sub:`6`
+
+       -  i\ :sub:`5`
+
+       -  i\ :sub:`4`
+
+       -  i\ :sub:`3`
+
+       -  i\ :sub:`2`
+
+       -  i\ :sub:`1`
+
+       -  i\ :sub:`0`
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-m420.rst b/Documentation/linux_tv/media/v4l/pixfmt-m420.rst
new file mode 100644
index 000000000000..553618ab62cf
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-m420.rst
@@ -0,0 +1,238 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-M420:
+
+**************************
+V4L2_PIX_FMT_M420 ('M420')
+**************************
+
+*man V4L2_PIX_FMT_M420(2)*
+
+Format with ½ horizontal and vertical chroma resolution, also known as
+YUV 4:2:0. Hybrid plane line-interleaved layout.
+
+
+Description
+===========
+
+M420 is a YUV format with ½ horizontal and vertical chroma subsampling
+(YUV 4:2:0). Pixels are organized as interleaved luma and chroma planes.
+Two lines of luma data are followed by one line of chroma data.
+
+The luma plane has one byte per pixel. The chroma plane contains
+interleaved CbCr pixels subsampled by ½ in the horizontal and vertical
+directions. Each CbCr pair belongs to four pixels. For example,
+Cb\ :sub:`0`/Cr:sub:`0` belongs to Y'\ :sub:`00`, Y'\ :sub:`01`,
+Y'\ :sub:`10`, Y'\ :sub:`11`.
+
+All line lengths are identical: if the Y lines include pad bytes so do
+the CbCr lines.
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  Y'\ :sub:`00`
+
+       -  Y'\ :sub:`01`
+
+       -  Y'\ :sub:`02`
+
+       -  Y'\ :sub:`03`
+
+    -  .. row 2
+
+       -  start + 4:
+
+       -  Y'\ :sub:`10`
+
+       -  Y'\ :sub:`11`
+
+       -  Y'\ :sub:`12`
+
+       -  Y'\ :sub:`13`
+
+    -  .. row 3
+
+       -  start + 8:
+
+       -  Cb\ :sub:`00`
+
+       -  Cr\ :sub:`00`
+
+       -  Cb\ :sub:`01`
+
+       -  Cr\ :sub:`01`
+
+    -  .. row 4
+
+       -  start + 16:
+
+       -  Y'\ :sub:`20`
+
+       -  Y'\ :sub:`21`
+
+       -  Y'\ :sub:`22`
+
+       -  Y'\ :sub:`23`
+
+    -  .. row 5
+
+       -  start + 20:
+
+       -  Y'\ :sub:`30`
+
+       -  Y'\ :sub:`31`
+
+       -  Y'\ :sub:`32`
+
+       -  Y'\ :sub:`33`
+
+    -  .. row 6
+
+       -  start + 24:
+
+       -  Cb\ :sub:`10`
+
+       -  Cr\ :sub:`10`
+
+       -  Cb\ :sub:`11`
+
+       -  Cr\ :sub:`11`
+
+
+**Color Sample Location..**
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  
+       -  0
+
+       -  
+       -  1
+
+       -  
+       -  2
+
+       -  
+       -  3
+
+    -  .. row 2
+
+       -  0
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 3
+
+       -  
+       -  
+       -  C
+
+       -  
+       -  
+       -  
+       -  C
+
+       -  
+
+    -  .. row 4
+
+       -  1
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 5
+
+       -  
+
+    -  .. row 6
+
+       -  2
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 7
+
+       -  
+       -  
+       -  C
+
+       -  
+       -  
+       -  
+       -  C
+
+       -  
+
+    -  .. row 8
+
+       -  3
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-nv12.rst b/Documentation/linux_tv/media/v4l/pixfmt-nv12.rst
new file mode 100644
index 000000000000..ffbc9390e5bb
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-nv12.rst
@@ -0,0 +1,241 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-NV12:
+
+******************************************************
+V4L2_PIX_FMT_NV12 ('NV12'), V4L2_PIX_FMT_NV21 ('NV21')
+******************************************************
+
+*man V4L2_PIX_FMT_NV12(2)*
+
+V4L2_PIX_FMT_NV21
+Formats with ½ horizontal and vertical chroma resolution, also known as
+YUV 4:2:0. One luminance and one chrominance plane with alternating
+chroma samples as opposed to ``V4L2_PIX_FMT_YVU420``
+
+
+Description
+===========
+
+These are two-plane versions of the YUV 4:2:0 format. The three
+components are separated into two sub-images or planes. The Y plane is
+first. The Y plane has one byte per pixel. For ``V4L2_PIX_FMT_NV12``, a
+combined CbCr plane immediately follows the Y plane in memory. The CbCr
+plane is the same width, in bytes, as the Y plane (and of the image),
+but is half as tall in pixels. Each CbCr pair belongs to four pixels.
+For example, Cb\ :sub:`0`/Cr:sub:`0` belongs to Y'\ :sub:`00`,
+Y'\ :sub:`01`, Y'\ :sub:`10`, Y'\ :sub:`11`. ``V4L2_PIX_FMT_NV21`` is
+the same except the Cb and Cr bytes are swapped, the CrCb plane starts
+with a Cr byte.
+
+If the Y plane has pad bytes after each row, then the CbCr plane has as
+many pad bytes after its rows.
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  Y'\ :sub:`00`
+
+       -  Y'\ :sub:`01`
+
+       -  Y'\ :sub:`02`
+
+       -  Y'\ :sub:`03`
+
+    -  .. row 2
+
+       -  start + 4:
+
+       -  Y'\ :sub:`10`
+
+       -  Y'\ :sub:`11`
+
+       -  Y'\ :sub:`12`
+
+       -  Y'\ :sub:`13`
+
+    -  .. row 3
+
+       -  start + 8:
+
+       -  Y'\ :sub:`20`
+
+       -  Y'\ :sub:`21`
+
+       -  Y'\ :sub:`22`
+
+       -  Y'\ :sub:`23`
+
+    -  .. row 4
+
+       -  start + 12:
+
+       -  Y'\ :sub:`30`
+
+       -  Y'\ :sub:`31`
+
+       -  Y'\ :sub:`32`
+
+       -  Y'\ :sub:`33`
+
+    -  .. row 5
+
+       -  start + 16:
+
+       -  Cb\ :sub:`00`
+
+       -  Cr\ :sub:`00`
+
+       -  Cb\ :sub:`01`
+
+       -  Cr\ :sub:`01`
+
+    -  .. row 6
+
+       -  start + 20:
+
+       -  Cb\ :sub:`10`
+
+       -  Cr\ :sub:`10`
+
+       -  Cb\ :sub:`11`
+
+       -  Cr\ :sub:`11`
+
+
+**Color Sample Location..**
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  
+       -  0
+
+       -  
+       -  1
+
+       -  
+       -  2
+
+       -  
+       -  3
+
+    -  .. row 2
+
+       -  0
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 3
+
+       -  
+       -  
+       -  C
+
+       -  
+       -  
+       -  
+       -  C
+
+       -  
+
+    -  .. row 4
+
+       -  1
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 5
+
+       -  
+
+    -  .. row 6
+
+       -  2
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 7
+
+       -  
+       -  
+       -  C
+
+       -  
+       -  
+       -  
+       -  C
+
+       -  
+
+    -  .. row 8
+
+       -  3
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-nv12m.rst b/Documentation/linux_tv/media/v4l/pixfmt-nv12m.rst
new file mode 100644
index 000000000000..4a181af07724
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-nv12m.rst
@@ -0,0 +1,256 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-NV12M:
+
+***********************************************************************************
+V4L2_PIX_FMT_NV12M ('NM12'), V4L2_PIX_FMT_NV21M ('NM21'), V4L2_PIX_FMT_NV12MT_16X16
+***********************************************************************************
+
+*man V4L2_PIX_FMT_NV12M(2)*
+
+V4L2_PIX_FMT_NV21M
+V4L2_PIX_FMT_NV12MT_16X16
+Variation of ``V4L2_PIX_FMT_NV12`` and ``V4L2_PIX_FMT_NV21`` with planes
+non contiguous in memory.
+
+
+Description
+===========
+
+This is a multi-planar, two-plane version of the YUV 4:2:0 format. The
+three components are separated into two sub-images or planes.
+``V4L2_PIX_FMT_NV12M`` differs from ``V4L2_PIX_FMT_NV12`` in that the
+two planes are non-contiguous in memory, i.e. the chroma plane do not
+necessarily immediately follows the luma plane. The luminance data
+occupies the first plane. The Y plane has one byte per pixel. In the
+second plane there is a chrominance data with alternating chroma
+samples. The CbCr plane is the same width, in bytes, as the Y plane (and
+of the image), but is half as tall in pixels. Each CbCr pair belongs to
+four pixels. For example, Cb\ :sub:`0`/Cr:sub:`0` belongs to
+Y'\ :sub:`00`, Y'\ :sub:`01`, Y'\ :sub:`10`, Y'\ :sub:`11`.
+``V4L2_PIX_FMT_NV12MT_16X16`` is the tiled version of
+``V4L2_PIX_FMT_NV12M`` with 16x16 macroblock tiles. Here pixels are
+arranged in 16x16 2D tiles and tiles are arranged in linear order in
+memory. ``V4L2_PIX_FMT_NV21M`` is the same as ``V4L2_PIX_FMT_NV12M``
+except the Cb and Cr bytes are swapped, the CrCb plane starts with a Cr
+byte.
+
+``V4L2_PIX_FMT_NV12M`` is intended to be used only in drivers and
+applications that support the multi-planar API, described in
+:ref:`planar-apis`.
+
+If the Y plane has pad bytes after each row, then the CbCr plane has as
+many pad bytes after its rows.
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start0 + 0:
+
+       -  Y'\ :sub:`00`
+
+       -  Y'\ :sub:`01`
+
+       -  Y'\ :sub:`02`
+
+       -  Y'\ :sub:`03`
+
+    -  .. row 2
+
+       -  start0 + 4:
+
+       -  Y'\ :sub:`10`
+
+       -  Y'\ :sub:`11`
+
+       -  Y'\ :sub:`12`
+
+       -  Y'\ :sub:`13`
+
+    -  .. row 3
+
+       -  start0 + 8:
+
+       -  Y'\ :sub:`20`
+
+       -  Y'\ :sub:`21`
+
+       -  Y'\ :sub:`22`
+
+       -  Y'\ :sub:`23`
+
+    -  .. row 4
+
+       -  start0 + 12:
+
+       -  Y'\ :sub:`30`
+
+       -  Y'\ :sub:`31`
+
+       -  Y'\ :sub:`32`
+
+       -  Y'\ :sub:`33`
+
+    -  .. row 5
+
+       -  
+
+    -  .. row 6
+
+       -  start1 + 0:
+
+       -  Cb\ :sub:`00`
+
+       -  Cr\ :sub:`00`
+
+       -  Cb\ :sub:`01`
+
+       -  Cr\ :sub:`01`
+
+    -  .. row 7
+
+       -  start1 + 4:
+
+       -  Cb\ :sub:`10`
+
+       -  Cr\ :sub:`10`
+
+       -  Cb\ :sub:`11`
+
+       -  Cr\ :sub:`11`
+
+
+**Color Sample Location..**
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  
+       -  0
+
+       -  
+       -  1
+
+       -  
+       -  2
+
+       -  
+       -  3
+
+    -  .. row 2
+
+       -  0
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 3
+
+       -  
+       -  
+       -  C
+
+       -  
+       -  
+       -  
+       -  C
+
+       -  
+
+    -  .. row 4
+
+       -  1
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 5
+
+       -  
+
+    -  .. row 6
+
+       -  2
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 7
+
+       -  
+       -  
+       -  C
+
+       -  
+       -  
+       -  
+       -  C
+
+       -  
+
+    -  .. row 8
+
+       -  3
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-nv12mt.rst b/Documentation/linux_tv/media/v4l/pixfmt-nv12mt.rst
new file mode 100644
index 000000000000..8b0b4d1812a0
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-nv12mt.rst
@@ -0,0 +1,71 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-NV12MT:
+
+****************************
+V4L2_PIX_FMT_NV12MT ('TM12')
+****************************
+
+*man V4L2_PIX_FMT_NV12MT(2)*
+
+Formats with ½ horizontal and vertical chroma resolution. This format
+has two planes - one for luminance and one for chrominance. Chroma
+samples are interleaved. The difference to ``V4L2_PIX_FMT_NV12`` is the
+memory layout. Pixels are grouped in macroblocks of 64x32 size. The
+order of macroblocks in memory is also not standard.
+
+
+Description
+===========
+
+This is the two-plane versions of the YUV 4:2:0 format where data is
+grouped into 64x32 macroblocks. The three components are separated into
+two sub-images or planes. The Y plane has one byte per pixel and pixels
+are grouped into 64x32 macroblocks. The CbCr plane has the same width,
+in bytes, as the Y plane (and the image), but is half as tall in pixels.
+The chroma plane is also grouped into 64x32 macroblocks.
+
+Width of the buffer has to be aligned to the multiple of 128, and height
+alignment is 32. Every four adjacent buffers - two horizontally and two
+vertically are grouped together and are located in memory in Z or
+flipped Z order.
+
+Layout of macroblocks in memory is presented in the following figure.
+
+
+.. _nv12mt:
+
+.. figure::  pixfmt-nv12mt_files/nv12mt.*
+    :alt:    nv12mt.gif
+    :align:  center
+
+    V4L2_PIX_FMT_NV12MT macroblock Z shape memory layout
+
+The requirement that width is multiple of 128 is implemented because,
+the Z shape cannot be cut in half horizontally. In case the vertical
+resolution of macroblocks is odd then the last row of macroblocks is
+arranged in a linear order.
+
+In case of chroma the layout is identical. Cb and Cr samples are
+interleaved. Height of the buffer is aligned to 32.
+
+
+.. _nv12mt_ex:
+
+.. figure::  pixfmt-nv12mt_files/nv12mt_example.*
+    :alt:    nv12mt_example.gif
+    :align:  center
+
+    Example V4L2_PIX_FMT_NV12MT memory layout of macroblocks
+
+Memory layout of macroblocks of ``V4L2_PIX_FMT_NV12MT`` format in most
+extreme case.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-nv12mt_files/nv12mt.gif b/Documentation/linux_tv/media/v4l/pixfmt-nv12mt_files/nv12mt.gif
new file mode 100644
index 0000000000000000000000000000000000000000..ef2d4cf8367b97293eb9139de0f33d0a2ac236be
GIT binary patch
literal 2108
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
JfkA-P{{T*w8|nZ6

literal 0
HcmV?d00001

diff --git a/Documentation/linux_tv/media/v4l/pixfmt-nv12mt_files/nv12mt_example.gif b/Documentation/linux_tv/media/v4l/pixfmt-nv12mt_files/nv12mt_example.gif
new file mode 100644
index 0000000000000000000000000000000000000000..df81d68108eeb66569417b475984aa634385eebb
GIT binary patch
literal 6858
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
V-^XO_BChtj?V@hK$vy-q{tq)sSegI;

literal 0
HcmV?d00001

diff --git a/Documentation/linux_tv/media/v4l/pixfmt-nv16.rst b/Documentation/linux_tv/media/v4l/pixfmt-nv16.rst
new file mode 100644
index 000000000000..4c3c638dec33
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-nv16.rst
@@ -0,0 +1,290 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-NV16:
+
+******************************************************
+V4L2_PIX_FMT_NV16 ('NV16'), V4L2_PIX_FMT_NV61 ('NV61')
+******************************************************
+
+*man V4L2_PIX_FMT_NV16(2)*
+
+V4L2_PIX_FMT_NV61
+Formats with ½ horizontal chroma resolution, also known as YUV 4:2:2.
+One luminance and one chrominance plane with alternating chroma samples
+as opposed to ``V4L2_PIX_FMT_YVU420``
+
+
+Description
+===========
+
+These are two-plane versions of the YUV 4:2:2 format. The three
+components are separated into two sub-images or planes. The Y plane is
+first. The Y plane has one byte per pixel. For ``V4L2_PIX_FMT_NV16``, a
+combined CbCr plane immediately follows the Y plane in memory. The CbCr
+plane is the same width and height, in bytes, as the Y plane (and of the
+image). Each CbCr pair belongs to two pixels. For example,
+Cb\ :sub:`0`/Cr:sub:`0` belongs to Y'\ :sub:`00`, Y'\ :sub:`01`.
+``V4L2_PIX_FMT_NV61`` is the same except the Cb and Cr bytes are
+swapped, the CrCb plane starts with a Cr byte.
+
+If the Y plane has pad bytes after each row, then the CbCr plane has as
+many pad bytes after its rows.
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  Y'\ :sub:`00`
+
+       -  Y'\ :sub:`01`
+
+       -  Y'\ :sub:`02`
+
+       -  Y'\ :sub:`03`
+
+    -  .. row 2
+
+       -  start + 4:
+
+       -  Y'\ :sub:`10`
+
+       -  Y'\ :sub:`11`
+
+       -  Y'\ :sub:`12`
+
+       -  Y'\ :sub:`13`
+
+    -  .. row 3
+
+       -  start + 8:
+
+       -  Y'\ :sub:`20`
+
+       -  Y'\ :sub:`21`
+
+       -  Y'\ :sub:`22`
+
+       -  Y'\ :sub:`23`
+
+    -  .. row 4
+
+       -  start + 12:
+
+       -  Y'\ :sub:`30`
+
+       -  Y'\ :sub:`31`
+
+       -  Y'\ :sub:`32`
+
+       -  Y'\ :sub:`33`
+
+    -  .. row 5
+
+       -  start + 16:
+
+       -  Cb\ :sub:`00`
+
+       -  Cr\ :sub:`00`
+
+       -  Cb\ :sub:`01`
+
+       -  Cr\ :sub:`01`
+
+    -  .. row 6
+
+       -  start + 20:
+
+       -  Cb\ :sub:`10`
+
+       -  Cr\ :sub:`10`
+
+       -  Cb\ :sub:`11`
+
+       -  Cr\ :sub:`11`
+
+    -  .. row 7
+
+       -  start + 24:
+
+       -  Cb\ :sub:`20`
+
+       -  Cr\ :sub:`20`
+
+       -  Cb\ :sub:`21`
+
+       -  Cr\ :sub:`21`
+
+    -  .. row 8
+
+       -  start + 28:
+
+       -  Cb\ :sub:`30`
+
+       -  Cr\ :sub:`30`
+
+       -  Cb\ :sub:`31`
+
+       -  Cr\ :sub:`31`
+
+
+**Color Sample Location..**
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  
+       -  0
+
+       -  
+       -  1
+
+       -  
+       -  2
+
+       -  
+       -  3
+
+    -  .. row 2
+
+       -  0
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 3
+
+       -  
+       -  
+       -  C
+
+       -  
+       -  
+       -  
+       -  C
+
+       -  
+
+    -  .. row 4
+
+       -  1
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 5
+
+       -  
+       -  
+       -  C
+
+       -  
+       -  
+       -  
+       -  C
+
+       -  
+
+    -  .. row 6
+
+       -  
+
+    -  .. row 7
+
+       -  2
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 8
+
+       -  
+       -  
+       -  C
+
+       -  
+       -  
+       -  
+       -  C
+
+       -  
+
+    -  .. row 9
+
+       -  3
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 10
+
+       -  
+       -  
+       -  C
+
+       -  
+       -  
+       -  
+       -  C
+
+       -  
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-nv16m.rst b/Documentation/linux_tv/media/v4l/pixfmt-nv16m.rst
new file mode 100644
index 000000000000..e250f2c0bc7a
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-nv16m.rst
@@ -0,0 +1,297 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-NV16M:
+
+********************************************************
+V4L2_PIX_FMT_NV16M ('NM16'), V4L2_PIX_FMT_NV61M ('NM61')
+********************************************************
+
+*man V4L2_PIX_FMT_NV16M(2)*
+
+V4L2_PIX_FMT_NV61M
+Variation of ``V4L2_PIX_FMT_NV16`` and ``V4L2_PIX_FMT_NV61`` with planes
+non contiguous in memory.
+
+
+Description
+===========
+
+This is a multi-planar, two-plane version of the YUV 4:2:2 format. The
+three components are separated into two sub-images or planes.
+``V4L2_PIX_FMT_NV16M`` differs from ``V4L2_PIX_FMT_NV16`` in that the
+two planes are non-contiguous in memory, i.e. the chroma plane does not
+necessarily immediately follow the luma plane. The luminance data
+occupies the first plane. The Y plane has one byte per pixel. In the
+second plane there is chrominance data with alternating chroma samples.
+The CbCr plane is the same width and height, in bytes, as the Y plane.
+Each CbCr pair belongs to two pixels. For example,
+Cb\ :sub:`0`/Cr:sub:`0` belongs to Y'\ :sub:`00`, Y'\ :sub:`01`.
+``V4L2_PIX_FMT_NV61M`` is the same as ``V4L2_PIX_FMT_NV16M`` except the
+Cb and Cr bytes are swapped, the CrCb plane starts with a Cr byte.
+
+``V4L2_PIX_FMT_NV16M`` and ``V4L2_PIX_FMT_NV61M`` are intended to be
+used only in drivers and applications that support the multi-planar API,
+described in :ref:`planar-apis`.
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start0 + 0:
+
+       -  Y'\ :sub:`00`
+
+       -  Y'\ :sub:`01`
+
+       -  Y'\ :sub:`02`
+
+       -  Y'\ :sub:`03`
+
+    -  .. row 2
+
+       -  start0 + 4:
+
+       -  Y'\ :sub:`10`
+
+       -  Y'\ :sub:`11`
+
+       -  Y'\ :sub:`12`
+
+       -  Y'\ :sub:`13`
+
+    -  .. row 3
+
+       -  start0 + 8:
+
+       -  Y'\ :sub:`20`
+
+       -  Y'\ :sub:`21`
+
+       -  Y'\ :sub:`22`
+
+       -  Y'\ :sub:`23`
+
+    -  .. row 4
+
+       -  start0 + 12:
+
+       -  Y'\ :sub:`30`
+
+       -  Y'\ :sub:`31`
+
+       -  Y'\ :sub:`32`
+
+       -  Y'\ :sub:`33`
+
+    -  .. row 5
+
+       -  
+
+    -  .. row 6
+
+       -  start1 + 0:
+
+       -  Cb\ :sub:`00`
+
+       -  Cr\ :sub:`00`
+
+       -  Cb\ :sub:`02`
+
+       -  Cr\ :sub:`02`
+
+    -  .. row 7
+
+       -  start1 + 4:
+
+       -  Cb\ :sub:`10`
+
+       -  Cr\ :sub:`10`
+
+       -  Cb\ :sub:`12`
+
+       -  Cr\ :sub:`12`
+
+    -  .. row 8
+
+       -  start1 + 8:
+
+       -  Cb\ :sub:`20`
+
+       -  Cr\ :sub:`20`
+
+       -  Cb\ :sub:`22`
+
+       -  Cr\ :sub:`22`
+
+    -  .. row 9
+
+       -  start1 + 12:
+
+       -  Cb\ :sub:`30`
+
+       -  Cr\ :sub:`30`
+
+       -  Cb\ :sub:`32`
+
+       -  Cr\ :sub:`32`
+
+
+**Color Sample Location..**
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  
+       -  0
+
+       -  
+       -  1
+
+       -  
+       -  2
+
+       -  
+       -  3
+
+    -  .. row 2
+
+       -  0
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 3
+
+       -  
+       -  
+       -  C
+
+       -  
+       -  
+       -  
+       -  C
+
+       -  
+
+    -  .. row 4
+
+       -  1
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 5
+
+       -  
+       -  
+       -  C
+
+       -  
+       -  
+       -  
+       -  C
+
+       -  
+
+    -  .. row 6
+
+       -  
+
+    -  .. row 7
+
+       -  2
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 8
+
+       -  
+       -  
+       -  C
+
+       -  
+       -  
+       -  
+       -  C
+
+       -  
+
+    -  .. row 9
+
+       -  3
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 10
+
+       -  
+       -  
+       -  C
+
+       -  
+       -  
+       -  
+       -  C
+
+       -  
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-nv24.rst b/Documentation/linux_tv/media/v4l/pixfmt-nv24.rst
new file mode 100644
index 000000000000..5b9716079c25
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-nv24.rst
@@ -0,0 +1,182 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-NV24:
+
+******************************************************
+V4L2_PIX_FMT_NV24 ('NV24'), V4L2_PIX_FMT_NV42 ('NV42')
+******************************************************
+
+*man V4L2_PIX_FMT_NV24(2)*
+
+V4L2_PIX_FMT_NV42
+Formats with full horizontal and vertical chroma resolutions, also known
+as YUV 4:4:4. One luminance and one chrominance plane with alternating
+chroma samples as opposed to ``V4L2_PIX_FMT_YVU420``
+
+
+Description
+===========
+
+These are two-plane versions of the YUV 4:4:4 format. The three
+components are separated into two sub-images or planes. The Y plane is
+first, with each Y sample stored in one byte per pixel. For
+``V4L2_PIX_FMT_NV24``, a combined CbCr plane immediately follows the Y
+plane in memory. The CbCr plane has the same width and height, in
+pixels, as the Y plane (and the image). Each line contains one CbCr pair
+per pixel, with each Cb and Cr sample stored in one byte.
+``V4L2_PIX_FMT_NV42`` is the same except that the Cb and Cr samples are
+swapped, the CrCb plane starts with a Cr sample.
+
+If the Y plane has pad bytes after each row, then the CbCr plane has
+twice as many pad bytes after its rows.
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  Y'\ :sub:`00`
+
+       -  Y'\ :sub:`01`
+
+       -  Y'\ :sub:`02`
+
+       -  Y'\ :sub:`03`
+
+    -  .. row 2
+
+       -  start + 4:
+
+       -  Y'\ :sub:`10`
+
+       -  Y'\ :sub:`11`
+
+       -  Y'\ :sub:`12`
+
+       -  Y'\ :sub:`13`
+
+    -  .. row 3
+
+       -  start + 8:
+
+       -  Y'\ :sub:`20`
+
+       -  Y'\ :sub:`21`
+
+       -  Y'\ :sub:`22`
+
+       -  Y'\ :sub:`23`
+
+    -  .. row 4
+
+       -  start + 12:
+
+       -  Y'\ :sub:`30`
+
+       -  Y'\ :sub:`31`
+
+       -  Y'\ :sub:`32`
+
+       -  Y'\ :sub:`33`
+
+    -  .. row 5
+
+       -  start + 16:
+
+       -  Cb\ :sub:`00`
+
+       -  Cr\ :sub:`00`
+
+       -  Cb\ :sub:`01`
+
+       -  Cr\ :sub:`01`
+
+       -  Cb\ :sub:`02`
+
+       -  Cr\ :sub:`02`
+
+       -  Cb\ :sub:`03`
+
+       -  Cr\ :sub:`03`
+
+    -  .. row 6
+
+       -  start + 24:
+
+       -  Cb\ :sub:`10`
+
+       -  Cr\ :sub:`10`
+
+       -  Cb\ :sub:`11`
+
+       -  Cr\ :sub:`11`
+
+       -  Cb\ :sub:`12`
+
+       -  Cr\ :sub:`12`
+
+       -  Cb\ :sub:`13`
+
+       -  Cr\ :sub:`13`
+
+    -  .. row 7
+
+       -  start + 32:
+
+       -  Cb\ :sub:`20`
+
+       -  Cr\ :sub:`20`
+
+       -  Cb\ :sub:`21`
+
+       -  Cr\ :sub:`21`
+
+       -  Cb\ :sub:`22`
+
+       -  Cr\ :sub:`22`
+
+       -  Cb\ :sub:`23`
+
+       -  Cr\ :sub:`23`
+
+    -  .. row 8
+
+       -  start + 40:
+
+       -  Cb\ :sub:`30`
+
+       -  Cr\ :sub:`30`
+
+       -  Cb\ :sub:`31`
+
+       -  Cr\ :sub:`31`
+
+       -  Cb\ :sub:`32`
+
+       -  Cr\ :sub:`32`
+
+       -  Cb\ :sub:`33`
+
+       -  Cr\ :sub:`33`
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-packed-rgb.rst b/Documentation/linux_tv/media/v4l/pixfmt-packed-rgb.rst
new file mode 100644
index 000000000000..2caf9ccea69a
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-packed-rgb.rst
@@ -0,0 +1,1479 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _packed-rgb:
+
+******************
+Packed RGB formats
+******************
+
+*man Packed RGB formats(2)*
+
+Packed RGB formats
+
+
+Description
+===========
+
+These formats are designed to match the pixel formats of typical PC
+graphics frame buffers. They occupy 8, 16, 24 or 32 bits per pixel.
+These are all packed-pixel formats, meaning all the data for a pixel lie
+next to each other in memory.
+
+
+.. _rgb-formats:
+
+.. flat-table:: Packed RGB Image Formats
+    :header-rows:  2
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  Identifier
+
+       -  Code
+
+       -  
+       -  :cspan:`7` Byte 0 in memory
+
+       -  :cspan:`7` Byte 1
+
+       -  :cspan:`7` Byte 2
+
+       -  :cspan:`7` Byte 3
+
+    -  .. row 2
+
+       -  
+       -  
+       -  Bit
+
+       -  7
+
+       -  6
+
+       -  5
+
+       -  4
+
+       -  3
+
+       -  2
+
+       -  1
+
+       -  0
+
+       -  
+       -  7
+
+       -  6
+
+       -  5
+
+       -  4
+
+       -  3
+
+       -  2
+
+       -  1
+
+       -  0
+
+       -  
+       -  7
+
+       -  6
+
+       -  5
+
+       -  4
+
+       -  3
+
+       -  2
+
+       -  1
+
+       -  0
+
+       -  
+       -  7
+
+       -  6
+
+       -  5
+
+       -  4
+
+       -  3
+
+       -  2
+
+       -  1
+
+       -  0
+
+    -  .. _`V4L2-PIX-FMT-RGB332`:
+
+       -  ``V4L2_PIX_FMT_RGB332``
+
+       -  'RGB1'
+
+       -  
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+    -  .. _`V4L2-PIX-FMT-ARGB444`:
+
+       -  ``V4L2_PIX_FMT_ARGB444``
+
+       -  'AR12'
+
+       -  
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+       -  
+       -  a\ :sub:`3`
+
+       -  a\ :sub:`2`
+
+       -  a\ :sub:`1`
+
+       -  a\ :sub:`0`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+    -  .. _`V4L2-PIX-FMT-XRGB444`:
+
+       -  ``V4L2_PIX_FMT_XRGB444``
+
+       -  'XR12'
+
+       -  
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+    -  .. _`V4L2-PIX-FMT-ARGB555`:
+
+       -  ``V4L2_PIX_FMT_ARGB555``
+
+       -  'AR15'
+
+       -  
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+       -  
+       -  a
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+    -  .. _`V4L2-PIX-FMT-XRGB555`:
+
+       -  ``V4L2_PIX_FMT_XRGB555``
+
+       -  'XR15'
+
+       -  
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+       -  
+       -  -
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+    -  .. _`V4L2-PIX-FMT-RGB565`:
+
+       -  ``V4L2_PIX_FMT_RGB565``
+
+       -  'RGBP'
+
+       -  
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+       -  
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+    -  .. _`V4L2-PIX-FMT-ARGB555X`:
+
+       -  ``V4L2_PIX_FMT_ARGB555X``
+
+       -  'AR15' | (1 << 31)
+
+       -  
+       -  a
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+    -  .. _`V4L2-PIX-FMT-XRGB555X`:
+
+       -  ``V4L2_PIX_FMT_XRGB555X``
+
+       -  'XR15' | (1 << 31)
+
+       -  
+       -  -
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+    -  .. _`V4L2-PIX-FMT-RGB565X`:
+
+       -  ``V4L2_PIX_FMT_RGB565X``
+
+       -  'RGBR'
+
+       -  
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+    -  .. _`V4L2-PIX-FMT-BGR24`:
+
+       -  ``V4L2_PIX_FMT_BGR24``
+
+       -  'BGR3'
+
+       -  
+       -  b\ :sub:`7`
+
+       -  b\ :sub:`6`
+
+       -  b\ :sub:`5`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+       -  
+       -  g\ :sub:`7`
+
+       -  g\ :sub:`6`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  
+       -  r\ :sub:`7`
+
+       -  r\ :sub:`6`
+
+       -  r\ :sub:`5`
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+    -  .. _`V4L2-PIX-FMT-RGB24`:
+
+       -  ``V4L2_PIX_FMT_RGB24``
+
+       -  'RGB3'
+
+       -  
+       -  r\ :sub:`7`
+
+       -  r\ :sub:`6`
+
+       -  r\ :sub:`5`
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+       -  
+       -  g\ :sub:`7`
+
+       -  g\ :sub:`6`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  
+       -  b\ :sub:`7`
+
+       -  b\ :sub:`6`
+
+       -  b\ :sub:`5`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+    -  .. _`V4L2-PIX-FMT-BGR666`:
+
+       -  ``V4L2_PIX_FMT_BGR666``
+
+       -  'BGRH'
+
+       -  
+       -  b\ :sub:`5`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  r\ :sub:`5`
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+    -  .. _`V4L2-PIX-FMT-ABGR32`:
+
+       -  ``V4L2_PIX_FMT_ABGR32``
+
+       -  'AR24'
+
+       -  
+       -  b\ :sub:`7`
+
+       -  b\ :sub:`6`
+
+       -  b\ :sub:`5`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+       -  
+       -  g\ :sub:`7`
+
+       -  g\ :sub:`6`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  
+       -  r\ :sub:`7`
+
+       -  r\ :sub:`6`
+
+       -  r\ :sub:`5`
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+       -  
+       -  a\ :sub:`7`
+
+       -  a\ :sub:`6`
+
+       -  a\ :sub:`5`
+
+       -  a\ :sub:`4`
+
+       -  a\ :sub:`3`
+
+       -  a\ :sub:`2`
+
+       -  a\ :sub:`1`
+
+       -  a\ :sub:`0`
+
+    -  .. _`V4L2-PIX-FMT-XBGR32`:
+
+       -  ``V4L2_PIX_FMT_XBGR32``
+
+       -  'XR24'
+
+       -  
+       -  b\ :sub:`7`
+
+       -  b\ :sub:`6`
+
+       -  b\ :sub:`5`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+       -  
+       -  g\ :sub:`7`
+
+       -  g\ :sub:`6`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  
+       -  r\ :sub:`7`
+
+       -  r\ :sub:`6`
+
+       -  r\ :sub:`5`
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+    -  .. _`V4L2-PIX-FMT-ARGB32`:
+
+       -  ``V4L2_PIX_FMT_ARGB32``
+
+       -  'BA24'
+
+       -  
+       -  a\ :sub:`7`
+
+       -  a\ :sub:`6`
+
+       -  a\ :sub:`5`
+
+       -  a\ :sub:`4`
+
+       -  a\ :sub:`3`
+
+       -  a\ :sub:`2`
+
+       -  a\ :sub:`1`
+
+       -  a\ :sub:`0`
+
+       -  
+       -  r\ :sub:`7`
+
+       -  r\ :sub:`6`
+
+       -  r\ :sub:`5`
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+       -  
+       -  g\ :sub:`7`
+
+       -  g\ :sub:`6`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  
+       -  b\ :sub:`7`
+
+       -  b\ :sub:`6`
+
+       -  b\ :sub:`5`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+    -  .. _`V4L2-PIX-FMT-XRGB32`:
+
+       -  ``V4L2_PIX_FMT_XRGB32``
+
+       -  'BX24'
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  
+       -  r\ :sub:`7`
+
+       -  r\ :sub:`6`
+
+       -  r\ :sub:`5`
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+       -  
+       -  g\ :sub:`7`
+
+       -  g\ :sub:`6`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  
+       -  b\ :sub:`7`
+
+       -  b\ :sub:`6`
+
+       -  b\ :sub:`5`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+
+Bit 7 is the most significant bit.
+
+The usage and value of the alpha bits (a) in the ARGB and ABGR formats
+(collectively referred to as alpha formats) depend on the device type
+and hardware operation. :ref:`Capture <capture>` devices (including
+capture queues of mem-to-mem devices) fill the alpha component in
+memory. When the device outputs an alpha channel the alpha component
+will have a meaningful value. Otherwise, when the device doesn't output
+an alpha channel but can set the alpha bit to a user-configurable value,
+the :ref:`V4L2_CID_ALPHA_COMPONENT <v4l2-alpha-component>` control
+is used to specify that alpha value, and the alpha component of all
+pixels will be set to the value specified by that control. Otherwise a
+corresponding format without an alpha component (XRGB or XBGR) must be
+used instead of an alpha format.
+
+:ref:`Output <output>` devices (including output queues of mem-to-mem
+devices and :ref:`video output overlay <osd>` devices) read the alpha
+component from memory. When the device processes the alpha channel the
+alpha component must be filled with meaningful values by applications.
+Otherwise a corresponding format without an alpha component (XRGB or
+XBGR) must be used instead of an alpha format.
+
+The XRGB and XBGR formats contain undefined bits (-). Applications,
+devices and drivers must ignore those bits, for both
+:ref:`capture <capture>` and :ref:`output <output>` devices.
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1 1 1 1 1 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  B\ :sub:`00`
+
+       -  G\ :sub:`00`
+
+       -  R\ :sub:`00`
+
+       -  B\ :sub:`01`
+
+       -  G\ :sub:`01`
+
+       -  R\ :sub:`01`
+
+       -  B\ :sub:`02`
+
+       -  G\ :sub:`02`
+
+       -  R\ :sub:`02`
+
+       -  B\ :sub:`03`
+
+       -  G\ :sub:`03`
+
+       -  R\ :sub:`03`
+
+    -  .. row 2
+
+       -  start + 12:
+
+       -  B\ :sub:`10`
+
+       -  G\ :sub:`10`
+
+       -  R\ :sub:`10`
+
+       -  B\ :sub:`11`
+
+       -  G\ :sub:`11`
+
+       -  R\ :sub:`11`
+
+       -  B\ :sub:`12`
+
+       -  G\ :sub:`12`
+
+       -  R\ :sub:`12`
+
+       -  B\ :sub:`13`
+
+       -  G\ :sub:`13`
+
+       -  R\ :sub:`13`
+
+    -  .. row 3
+
+       -  start + 24:
+
+       -  B\ :sub:`20`
+
+       -  G\ :sub:`20`
+
+       -  R\ :sub:`20`
+
+       -  B\ :sub:`21`
+
+       -  G\ :sub:`21`
+
+       -  R\ :sub:`21`
+
+       -  B\ :sub:`22`
+
+       -  G\ :sub:`22`
+
+       -  R\ :sub:`22`
+
+       -  B\ :sub:`23`
+
+       -  G\ :sub:`23`
+
+       -  R\ :sub:`23`
+
+    -  .. row 4
+
+       -  start + 36:
+
+       -  B\ :sub:`30`
+
+       -  G\ :sub:`30`
+
+       -  R\ :sub:`30`
+
+       -  B\ :sub:`31`
+
+       -  G\ :sub:`31`
+
+       -  R\ :sub:`31`
+
+       -  B\ :sub:`32`
+
+       -  G\ :sub:`32`
+
+       -  R\ :sub:`32`
+
+       -  B\ :sub:`33`
+
+       -  G\ :sub:`33`
+
+       -  R\ :sub:`33`
+
+
+Formats defined in :ref:`rgb-formats-deprecated` are deprecated and
+must not be used by new drivers. They are documented here for reference.
+The meaning of their alpha bits (a) is ill-defined and interpreted as in
+either the corresponding ARGB or XRGB format, depending on the driver.
+
+
+.. _rgb-formats-deprecated:
+
+.. flat-table:: Deprecated Packed RGB Image Formats
+    :header-rows:  2
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  Identifier
+
+       -  Code
+
+       -  
+       -  :cspan:`7` Byte 0 in memory
+
+       -  :cspan:`7` Byte 1
+
+       -  :cspan:`7` Byte 2
+
+       -  :cspan:`7` Byte 3
+
+    -  .. row 2
+
+       -  
+       -  
+       -  Bit
+
+       -  7
+
+       -  6
+
+       -  5
+
+       -  4
+
+       -  3
+
+       -  2
+
+       -  1
+
+       -  0
+
+       -  
+       -  7
+
+       -  6
+
+       -  5
+
+       -  4
+
+       -  3
+
+       -  2
+
+       -  1
+
+       -  0
+
+       -  
+       -  7
+
+       -  6
+
+       -  5
+
+       -  4
+
+       -  3
+
+       -  2
+
+       -  1
+
+       -  0
+
+       -  
+       -  7
+
+       -  6
+
+       -  5
+
+       -  4
+
+       -  3
+
+       -  2
+
+       -  1
+
+       -  0
+
+    -  .. _`V4L2-PIX-FMT-RGB444`:
+
+       -  ``V4L2_PIX_FMT_RGB444``
+
+       -  'R444'
+
+       -  
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+       -  
+       -  a\ :sub:`3`
+
+       -  a\ :sub:`2`
+
+       -  a\ :sub:`1`
+
+       -  a\ :sub:`0`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+    -  .. _`V4L2-PIX-FMT-RGB555`:
+
+       -  ``V4L2_PIX_FMT_RGB555``
+
+       -  'RGBO'
+
+       -  
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+       -  
+       -  a
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+    -  .. _`V4L2-PIX-FMT-RGB555X`:
+
+       -  ``V4L2_PIX_FMT_RGB555X``
+
+       -  'RGBQ'
+
+       -  
+       -  a
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+    -  .. _`V4L2-PIX-FMT-BGR32`:
+
+       -  ``V4L2_PIX_FMT_BGR32``
+
+       -  'BGR4'
+
+       -  
+       -  b\ :sub:`7`
+
+       -  b\ :sub:`6`
+
+       -  b\ :sub:`5`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+       -  
+       -  g\ :sub:`7`
+
+       -  g\ :sub:`6`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  
+       -  r\ :sub:`7`
+
+       -  r\ :sub:`6`
+
+       -  r\ :sub:`5`
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+       -  
+       -  a\ :sub:`7`
+
+       -  a\ :sub:`6`
+
+       -  a\ :sub:`5`
+
+       -  a\ :sub:`4`
+
+       -  a\ :sub:`3`
+
+       -  a\ :sub:`2`
+
+       -  a\ :sub:`1`
+
+       -  a\ :sub:`0`
+
+    -  .. _`V4L2-PIX-FMT-RGB32`:
+
+       -  ``V4L2_PIX_FMT_RGB32``
+
+       -  'RGB4'
+
+       -  
+       -  a\ :sub:`7`
+
+       -  a\ :sub:`6`
+
+       -  a\ :sub:`5`
+
+       -  a\ :sub:`4`
+
+       -  a\ :sub:`3`
+
+       -  a\ :sub:`2`
+
+       -  a\ :sub:`1`
+
+       -  a\ :sub:`0`
+
+       -  
+       -  r\ :sub:`7`
+
+       -  r\ :sub:`6`
+
+       -  r\ :sub:`5`
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+       -  
+       -  g\ :sub:`7`
+
+       -  g\ :sub:`6`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  
+       -  b\ :sub:`7`
+
+       -  b\ :sub:`6`
+
+       -  b\ :sub:`5`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+
+A test utility to determine which RGB formats a driver actually supports
+is available from the LinuxTV v4l-dvb repository. See
+`https://linuxtv.org/repo/ <https://linuxtv.org/repo/>`__ for access
+instructions.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-packed-yuv.rst b/Documentation/linux_tv/media/v4l/pixfmt-packed-yuv.rst
new file mode 100644
index 000000000000..095871a50436
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-packed-yuv.rst
@@ -0,0 +1,325 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _packed-yuv:
+
+******************
+Packed YUV formats
+******************
+
+*man Packed YUV formats(2)*
+
+Packed YUV formats
+
+
+Description
+===========
+
+Similar to the packed RGB formats these formats store the Y, Cb and Cr
+component of each pixel in one 16 or 32 bit word.
+
+
+
+.. flat-table:: Packed YUV Image Formats
+    :header-rows:  2
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  Identifier
+
+       -  Code
+
+       -  
+       -  :cspan:`7` Byte 0 in memory
+
+       -  
+       -  :cspan:`7` Byte 1
+
+       -  
+       -  :cspan:`7` Byte 2
+
+       -  
+       -  :cspan:`7` Byte 3
+
+    -  .. row 2
+
+       -  
+       -  
+       -  Bit
+
+       -  7
+
+       -  6
+
+       -  5
+
+       -  4
+
+       -  3
+
+       -  2
+
+       -  1
+
+       -  0
+
+       -  
+       -  7
+
+       -  6
+
+       -  5
+
+       -  4
+
+       -  3
+
+       -  2
+
+       -  1
+
+       -  0
+
+       -  
+       -  7
+
+       -  6
+
+       -  5
+
+       -  4
+
+       -  3
+
+       -  2
+
+       -  1
+
+       -  0
+
+       -  
+       -  7
+
+       -  6
+
+       -  5
+
+       -  4
+
+       -  3
+
+       -  2
+
+       -  1
+
+       -  0
+
+    -  .. _`V4L2-PIX-FMT-YUV444`:
+
+       -  ``V4L2_PIX_FMT_YUV444``
+
+       -  'Y444'
+
+       -  
+       -  Cb\ :sub:`3`
+
+       -  Cb\ :sub:`2`
+
+       -  Cb\ :sub:`1`
+
+       -  Cb\ :sub:`0`
+
+       -  Cr\ :sub:`3`
+
+       -  Cr\ :sub:`2`
+
+       -  Cr\ :sub:`1`
+
+       -  Cr\ :sub:`0`
+
+       -  
+       -  a\ :sub:`3`
+
+       -  a\ :sub:`2`
+
+       -  a\ :sub:`1`
+
+       -  a\ :sub:`0`
+
+       -  Y'\ :sub:`3`
+
+       -  Y'\ :sub:`2`
+
+       -  Y'\ :sub:`1`
+
+       -  Y'\ :sub:`0`
+
+    -  .. _`V4L2-PIX-FMT-YUV555`:
+
+       -  ``V4L2_PIX_FMT_YUV555``
+
+       -  'YUVO'
+
+       -  
+       -  Cb\ :sub:`2`
+
+       -  Cb\ :sub:`1`
+
+       -  Cb\ :sub:`0`
+
+       -  Cr\ :sub:`4`
+
+       -  Cr\ :sub:`3`
+
+       -  Cr\ :sub:`2`
+
+       -  Cr\ :sub:`1`
+
+       -  Cr\ :sub:`0`
+
+       -  
+       -  a
+
+       -  Y'\ :sub:`4`
+
+       -  Y'\ :sub:`3`
+
+       -  Y'\ :sub:`2`
+
+       -  Y'\ :sub:`1`
+
+       -  Y'\ :sub:`0`
+
+       -  Cb\ :sub:`4`
+
+       -  Cb\ :sub:`3`
+
+    -  .. _`V4L2-PIX-FMT-YUV565`:
+
+       -  ``V4L2_PIX_FMT_YUV565``
+
+       -  'YUVP'
+
+       -  
+       -  Cb\ :sub:`2`
+
+       -  Cb\ :sub:`1`
+
+       -  Cb\ :sub:`0`
+
+       -  Cr\ :sub:`4`
+
+       -  Cr\ :sub:`3`
+
+       -  Cr\ :sub:`2`
+
+       -  Cr\ :sub:`1`
+
+       -  Cr\ :sub:`0`
+
+       -  
+       -  Y'\ :sub:`4`
+
+       -  Y'\ :sub:`3`
+
+       -  Y'\ :sub:`2`
+
+       -  Y'\ :sub:`1`
+
+       -  Y'\ :sub:`0`
+
+       -  Cb\ :sub:`5`
+
+       -  Cb\ :sub:`4`
+
+       -  Cb\ :sub:`3`
+
+    -  .. _`V4L2-PIX-FMT-YUV32`:
+
+       -  ``V4L2_PIX_FMT_YUV32``
+
+       -  'YUV4'
+
+       -  
+       -  a\ :sub:`7`
+
+       -  a\ :sub:`6`
+
+       -  a\ :sub:`5`
+
+       -  a\ :sub:`4`
+
+       -  a\ :sub:`3`
+
+       -  a\ :sub:`2`
+
+       -  a\ :sub:`1`
+
+       -  a\ :sub:`0`
+
+       -  
+       -  Y'\ :sub:`7`
+
+       -  Y'\ :sub:`6`
+
+       -  Y'\ :sub:`5`
+
+       -  Y'\ :sub:`4`
+
+       -  Y'\ :sub:`3`
+
+       -  Y'\ :sub:`2`
+
+       -  Y'\ :sub:`1`
+
+       -  Y'\ :sub:`0`
+
+       -  
+       -  Cb\ :sub:`7`
+
+       -  Cb\ :sub:`6`
+
+       -  Cb\ :sub:`5`
+
+       -  Cb\ :sub:`4`
+
+       -  Cb\ :sub:`3`
+
+       -  Cb\ :sub:`2`
+
+       -  Cb\ :sub:`1`
+
+       -  Cb\ :sub:`0`
+
+       -  
+       -  Cr\ :sub:`7`
+
+       -  Cr\ :sub:`6`
+
+       -  Cr\ :sub:`5`
+
+       -  Cr\ :sub:`4`
+
+       -  Cr\ :sub:`3`
+
+       -  Cr\ :sub:`2`
+
+       -  Cr\ :sub:`1`
+
+       -  Cr\ :sub:`0`
+
+
+Bit 7 is the most significant bit. The value of a = alpha bits is
+undefined when reading from the driver, ignored when writing to the
+driver, except when alpha blending has been negotiated for a
+:ref:`Video Overlay <overlay>` or :ref:`Video Output Overlay <osd>`.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-reserved.rst b/Documentation/linux_tv/media/v4l/pixfmt-reserved.rst
new file mode 100644
index 000000000000..072f2843c137
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-reserved.rst
@@ -0,0 +1,371 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _pixfmt-reserved:
+
+***************************
+Reserved Format Identifiers
+***************************
+
+These formats are not defined by this specification, they are just
+listed for reference and to avoid naming conflicts. If you want to
+register your own format, send an e-mail to the linux-media mailing list
+`https://linuxtv.org/lists.php <https://linuxtv.org/lists.php>`__
+for inclusion in the ``videodev2.h`` file. If you want to share your
+format with other developers add a link to your documentation and send a
+copy to the linux-media mailing list for inclusion in this section. If
+you think your format should be listed in a standard format section
+please make a proposal on the linux-media mailing list.
+
+
+.. _reserved-formats:
+
+.. flat-table:: Reserved Image Formats
+    :header-rows:  1
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  Identifier
+
+       -  Code
+
+       -  Details
+
+    -  .. _`V4L2-PIX-FMT-DV`:
+
+       -  ``V4L2_PIX_FMT_DV``
+
+       -  'dvsd'
+
+       -  unknown
+
+    -  .. _`V4L2-PIX-FMT-ET61X251`:
+
+       -  ``V4L2_PIX_FMT_ET61X251``
+
+       -  'E625'
+
+       -  Compressed format of the ET61X251 driver.
+
+    -  .. _`V4L2-PIX-FMT-HI240`:
+
+       -  ``V4L2_PIX_FMT_HI240``
+
+       -  'HI24'
+
+       -  8 bit RGB format used by the BTTV driver.
+
+    -  .. _`V4L2-PIX-FMT-HM12`:
+
+       -  ``V4L2_PIX_FMT_HM12``
+
+       -  'HM12'
+
+       -  YUV 4:2:0 format used by the IVTV driver,
+          `http://www.ivtvdriver.org/ <http://www.ivtvdriver.org/>`__
+
+          The format is documented in the kernel sources in the file
+          ``Documentation/video4linux/cx2341x/README.hm12``
+
+    -  .. _`V4L2-PIX-FMT-CPIA1`:
+
+       -  ``V4L2_PIX_FMT_CPIA1``
+
+       -  'CPIA'
+
+       -  YUV format used by the gspca cpia1 driver.
+
+    -  .. _`V4L2-PIX-FMT-JPGL`:
+
+       -  ``V4L2_PIX_FMT_JPGL``
+
+       -  'JPGL'
+
+       -  JPEG-Light format (Pegasus Lossless JPEG) used in Divio webcams NW
+          80x.
+
+    -  .. _`V4L2-PIX-FMT-SPCA501`:
+
+       -  ``V4L2_PIX_FMT_SPCA501``
+
+       -  'S501'
+
+       -  YUYV per line used by the gspca driver.
+
+    -  .. _`V4L2-PIX-FMT-SPCA505`:
+
+       -  ``V4L2_PIX_FMT_SPCA505``
+
+       -  'S505'
+
+       -  YYUV per line used by the gspca driver.
+
+    -  .. _`V4L2-PIX-FMT-SPCA508`:
+
+       -  ``V4L2_PIX_FMT_SPCA508``
+
+       -  'S508'
+
+       -  YUVY per line used by the gspca driver.
+
+    -  .. _`V4L2-PIX-FMT-SPCA561`:
+
+       -  ``V4L2_PIX_FMT_SPCA561``
+
+       -  'S561'
+
+       -  Compressed GBRG Bayer format used by the gspca driver.
+
+    -  .. _`V4L2-PIX-FMT-PAC207`:
+
+       -  ``V4L2_PIX_FMT_PAC207``
+
+       -  'P207'
+
+       -  Compressed BGGR Bayer format used by the gspca driver.
+
+    -  .. _`V4L2-PIX-FMT-MR97310A`:
+
+       -  ``V4L2_PIX_FMT_MR97310A``
+
+       -  'M310'
+
+       -  Compressed BGGR Bayer format used by the gspca driver.
+
+    -  .. _`V4L2-PIX-FMT-JL2005BCD`:
+
+       -  ``V4L2_PIX_FMT_JL2005BCD``
+
+       -  'JL20'
+
+       -  JPEG compressed RGGB Bayer format used by the gspca driver.
+
+    -  .. _`V4L2-PIX-FMT-OV511`:
+
+       -  ``V4L2_PIX_FMT_OV511``
+
+       -  'O511'
+
+       -  OV511 JPEG format used by the gspca driver.
+
+    -  .. _`V4L2-PIX-FMT-OV518`:
+
+       -  ``V4L2_PIX_FMT_OV518``
+
+       -  'O518'
+
+       -  OV518 JPEG format used by the gspca driver.
+
+    -  .. _`V4L2-PIX-FMT-PJPG`:
+
+       -  ``V4L2_PIX_FMT_PJPG``
+
+       -  'PJPG'
+
+       -  Pixart 73xx JPEG format used by the gspca driver.
+
+    -  .. _`V4L2-PIX-FMT-SE401`:
+
+       -  ``V4L2_PIX_FMT_SE401``
+
+       -  'S401'
+
+       -  Compressed RGB format used by the gspca se401 driver
+
+    -  .. _`V4L2-PIX-FMT-SQ905C`:
+
+       -  ``V4L2_PIX_FMT_SQ905C``
+
+       -  '905C'
+
+       -  Compressed RGGB bayer format used by the gspca driver.
+
+    -  .. _`V4L2-PIX-FMT-MJPEG`:
+
+       -  ``V4L2_PIX_FMT_MJPEG``
+
+       -  'MJPG'
+
+       -  Compressed format used by the Zoran driver
+
+    -  .. _`V4L2-PIX-FMT-PWC1`:
+
+       -  ``V4L2_PIX_FMT_PWC1``
+
+       -  'PWC1'
+
+       -  Compressed format of the PWC driver.
+
+    -  .. _`V4L2-PIX-FMT-PWC2`:
+
+       -  ``V4L2_PIX_FMT_PWC2``
+
+       -  'PWC2'
+
+       -  Compressed format of the PWC driver.
+
+    -  .. _`V4L2-PIX-FMT-SN9C10X`:
+
+       -  ``V4L2_PIX_FMT_SN9C10X``
+
+       -  'S910'
+
+       -  Compressed format of the SN9C102 driver.
+
+    -  .. _`V4L2-PIX-FMT-SN9C20X-I420`:
+
+       -  ``V4L2_PIX_FMT_SN9C20X_I420``
+
+       -  'S920'
+
+       -  YUV 4:2:0 format of the gspca sn9c20x driver.
+
+    -  .. _`V4L2-PIX-FMT-SN9C2028`:
+
+       -  ``V4L2_PIX_FMT_SN9C2028``
+
+       -  'SONX'
+
+       -  Compressed GBRG bayer format of the gspca sn9c2028 driver.
+
+    -  .. _`V4L2-PIX-FMT-STV0680`:
+
+       -  ``V4L2_PIX_FMT_STV0680``
+
+       -  'S680'
+
+       -  Bayer format of the gspca stv0680 driver.
+
+    -  .. _`V4L2-PIX-FMT-WNVA`:
+
+       -  ``V4L2_PIX_FMT_WNVA``
+
+       -  'WNVA'
+
+       -  Used by the Winnov Videum driver,
+          `http://www.thedirks.org/winnov/ <http://www.thedirks.org/winnov/>`__
+
+    -  .. _`V4L2-PIX-FMT-TM6000`:
+
+       -  ``V4L2_PIX_FMT_TM6000``
+
+       -  'TM60'
+
+       -  Used by Trident tm6000
+
+    -  .. _`V4L2-PIX-FMT-CIT-YYVYUY`:
+
+       -  ``V4L2_PIX_FMT_CIT_YYVYUY``
+
+       -  'CITV'
+
+       -  Used by xirlink CIT, found at IBM webcams.
+
+          Uses one line of Y then 1 line of VYUY
+
+    -  .. _`V4L2-PIX-FMT-KONICA420`:
+
+       -  ``V4L2_PIX_FMT_KONICA420``
+
+       -  'KONI'
+
+       -  Used by Konica webcams.
+
+          YUV420 planar in blocks of 256 pixels.
+
+    -  .. _`V4L2-PIX-FMT-YYUV`:
+
+       -  ``V4L2_PIX_FMT_YYUV``
+
+       -  'YYUV'
+
+       -  unknown
+
+    -  .. _`V4L2-PIX-FMT-Y4`:
+
+       -  ``V4L2_PIX_FMT_Y4``
+
+       -  'Y04 '
+
+       -  Old 4-bit greyscale format. Only the most significant 4 bits of
+          each byte are used, the other bits are set to 0.
+
+    -  .. _`V4L2-PIX-FMT-Y6`:
+
+       -  ``V4L2_PIX_FMT_Y6``
+
+       -  'Y06 '
+
+       -  Old 6-bit greyscale format. Only the most significant 6 bits of
+          each byte are used, the other bits are set to 0.
+
+    -  .. _`V4L2-PIX-FMT-S5C-UYVY-JPG`:
+
+       -  ``V4L2_PIX_FMT_S5C_UYVY_JPG``
+
+       -  'S5CI'
+
+       -  Two-planar format used by Samsung S5C73MX cameras. The first plane
+          contains interleaved JPEG and UYVY image data, followed by meta
+          data in form of an array of offsets to the UYVY data blocks. The
+          actual pointer array follows immediately the interleaved JPEG/UYVY
+          data, the number of entries in this array equals the height of the
+          UYVY image. Each entry is a 4-byte unsigned integer in big endian
+          order and it's an offset to a single pixel line of the UYVY image.
+          The first plane can start either with JPEG or UYVY data chunk. The
+          size of a single UYVY block equals the UYVY image's width
+          multiplied by 2. The size of a JPEG chunk depends on the image and
+          can vary with each line.
+
+          The second plane, at an offset of 4084 bytes, contains a 4-byte
+          offset to the pointer array in the first plane. This offset is
+          followed by a 4-byte value indicating size of the pointer array.
+          All numbers in the second plane are also in big endian order.
+          Remaining data in the second plane is undefined. The information
+          in the second plane allows to easily find location of the pointer
+          array, which can be different for each frame. The size of the
+          pointer array is constant for given UYVY image height.
+
+          In order to extract UYVY and JPEG frames an application can
+          initially set a data pointer to the start of first plane and then
+          add an offset from the first entry of the pointers table. Such a
+          pointer indicates start of an UYVY image pixel line. Whole UYVY
+          line can be copied to a separate buffer. These steps should be
+          repeated for each line, i.e. the number of entries in the pointer
+          array. Anything what's in between the UYVY lines is JPEG data and
+          should be concatenated to form the JPEG stream.
+
+
+
+.. _format-flags:
+
+.. flat-table:: Format Flags
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_PIX_FMT_FLAG_PREMUL_ALPHA``
+
+       -  0x00000001
+
+       -  The color values are premultiplied by the alpha channel value. For
+          example, if a light blue pixel with 50% transparency was described
+          by RGBA values (128, 192, 255, 128), the same pixel described with
+          premultiplied colors would be described by RGBA values (64, 96,
+          128, 128)
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-rgb.rst b/Documentation/linux_tv/media/v4l/pixfmt-rgb.rst
new file mode 100644
index 000000000000..aa607332af25
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-rgb.rst
@@ -0,0 +1,34 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _pixfmt-rgb:
+
+***********
+RGB Formats
+***********
+
+
+.. toctree::
+    :maxdepth: 1
+
+    pixfmt-packed-rgb
+    pixfmt-sbggr8
+    pixfmt-sgbrg8
+    pixfmt-sgrbg8
+    pixfmt-srggb8
+    pixfmt-sbggr16
+    pixfmt-srggb10
+    pixfmt-srggb10p
+    pixfmt-srggb10alaw8
+    pixfmt-srggb10dpcm8
+    pixfmt-srggb12
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-sbggr16.rst b/Documentation/linux_tv/media/v4l/pixfmt-sbggr16.rst
new file mode 100644
index 000000000000..9c1cf6d76bb6
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-sbggr16.rst
@@ -0,0 +1,125 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-SBGGR16:
+
+*****************************
+V4L2_PIX_FMT_SBGGR16 ('BYR2')
+*****************************
+
+*man V4L2_PIX_FMT_SBGGR16(2)*
+
+Bayer RGB format
+
+
+Description
+===========
+
+This format is similar to
+:ref:`V4L2_PIX_FMT_SBGGR8 <V4L2-PIX-FMT-SBGGR8>`, except each pixel
+has a depth of 16 bits. The least significant byte is stored at lower
+memory addresses (little-endian). Note the actual sampling precision may
+be lower than 16 bits, for example 10 bits per pixel with values in
+range 0 to 1023.
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  B\ :sub:`00low`
+
+       -  B\ :sub:`00high`
+
+       -  G\ :sub:`01low`
+
+       -  G\ :sub:`01high`
+
+       -  B\ :sub:`02low`
+
+       -  B\ :sub:`02high`
+
+       -  G\ :sub:`03low`
+
+       -  G\ :sub:`03high`
+
+    -  .. row 2
+
+       -  start + 8:
+
+       -  G\ :sub:`10low`
+
+       -  G\ :sub:`10high`
+
+       -  R\ :sub:`11low`
+
+       -  R\ :sub:`11high`
+
+       -  G\ :sub:`12low`
+
+       -  G\ :sub:`12high`
+
+       -  R\ :sub:`13low`
+
+       -  R\ :sub:`13high`
+
+    -  .. row 3
+
+       -  start + 16:
+
+       -  B\ :sub:`20low`
+
+       -  B\ :sub:`20high`
+
+       -  G\ :sub:`21low`
+
+       -  G\ :sub:`21high`
+
+       -  B\ :sub:`22low`
+
+       -  B\ :sub:`22high`
+
+       -  G\ :sub:`23low`
+
+       -  G\ :sub:`23high`
+
+    -  .. row 4
+
+       -  start + 24:
+
+       -  G\ :sub:`30low`
+
+       -  G\ :sub:`30high`
+
+       -  R\ :sub:`31low`
+
+       -  R\ :sub:`31high`
+
+       -  G\ :sub:`32low`
+
+       -  G\ :sub:`32high`
+
+       -  R\ :sub:`33low`
+
+       -  R\ :sub:`33high`
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-sbggr8.rst b/Documentation/linux_tv/media/v4l/pixfmt-sbggr8.rst
new file mode 100644
index 000000000000..85d6d1f6e6d9
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-sbggr8.rst
@@ -0,0 +1,93 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-SBGGR8:
+
+****************************
+V4L2_PIX_FMT_SBGGR8 ('BA81')
+****************************
+
+*man V4L2_PIX_FMT_SBGGR8(2)*
+
+Bayer RGB format
+
+
+Description
+===========
+
+This is commonly the native format of digital cameras, reflecting the
+arrangement of sensors on the CCD device. Only one red, green or blue
+value is given for each pixel. Missing components must be interpolated
+from neighbouring pixels. From left to right the first row consists of a
+blue and green value, the second row of a green and red value. This
+scheme repeats to the right and down for every two columns and rows.
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  B\ :sub:`00`
+
+       -  G\ :sub:`01`
+
+       -  B\ :sub:`02`
+
+       -  G\ :sub:`03`
+
+    -  .. row 2
+
+       -  start + 4:
+
+       -  G\ :sub:`10`
+
+       -  R\ :sub:`11`
+
+       -  G\ :sub:`12`
+
+       -  R\ :sub:`13`
+
+    -  .. row 3
+
+       -  start + 8:
+
+       -  B\ :sub:`20`
+
+       -  G\ :sub:`21`
+
+       -  B\ :sub:`22`
+
+       -  G\ :sub:`23`
+
+    -  .. row 4
+
+       -  start + 12:
+
+       -  G\ :sub:`30`
+
+       -  R\ :sub:`31`
+
+       -  G\ :sub:`32`
+
+       -  R\ :sub:`33`
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-sdr-cs08.rst b/Documentation/linux_tv/media/v4l/pixfmt-sdr-cs08.rst
new file mode 100644
index 000000000000..e75129d83def
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-sdr-cs08.rst
@@ -0,0 +1,55 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-SDR-FMT-CS08:
+
+*************************
+V4L2_SDR_FMT_CS8 ('CS08')
+*************************
+
+*man V4L2_SDR_FMT_CS8(2)*
+
+Complex signed 8-bit IQ sample
+
+
+Description
+===========
+
+This format contains sequence of complex number samples. Each complex
+number consist two parts, called In-phase and Quadrature (IQ). Both I
+and Q are represented as a 8 bit signed number. I value comes first and
+Q value after that.
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  I'\ :sub:`0`
+
+    -  .. row 2
+
+       -  start + 1:
+
+       -  Q'\ :sub:`0`
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-sdr-cs14le.rst b/Documentation/linux_tv/media/v4l/pixfmt-sdr-cs14le.rst
new file mode 100644
index 000000000000..cc94ffd90444
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-sdr-cs14le.rst
@@ -0,0 +1,60 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-SDR-FMT-CS14LE:
+
+****************************
+V4L2_SDR_FMT_CS14LE ('CS14')
+****************************
+
+*man V4L2_SDR_FMT_CS14LE(2)*
+
+Complex signed 14-bit little endian IQ sample
+
+
+Description
+===========
+
+This format contains sequence of complex number samples. Each complex
+number consist two parts, called In-phase and Quadrature (IQ). Both I
+and Q are represented as a 14 bit signed little endian number. I value
+comes first and Q value after that. 14 bit value is stored in 16 bit
+space with unused high bits padded with 0.
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  I'\ :sub:`0[7:0]`
+
+       -  I'\ :sub:`0[13:8]`
+
+    -  .. row 2
+
+       -  start + 2:
+
+       -  Q'\ :sub:`0[7:0]`
+
+       -  Q'\ :sub:`0[13:8]`
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-sdr-cu08.rst b/Documentation/linux_tv/media/v4l/pixfmt-sdr-cu08.rst
new file mode 100644
index 000000000000..95c7b40b2d72
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-sdr-cu08.rst
@@ -0,0 +1,55 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-SDR-FMT-CU08:
+
+*************************
+V4L2_SDR_FMT_CU8 ('CU08')
+*************************
+
+*man V4L2_SDR_FMT_CU8(2)*
+
+Complex unsigned 8-bit IQ sample
+
+
+Description
+===========
+
+This format contains sequence of complex number samples. Each complex
+number consist two parts, called In-phase and Quadrature (IQ). Both I
+and Q are represented as a 8 bit unsigned number. I value comes first
+and Q value after that.
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  I'\ :sub:`0`
+
+    -  .. row 2
+
+       -  start + 1:
+
+       -  Q'\ :sub:`0`
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-sdr-cu16le.rst b/Documentation/linux_tv/media/v4l/pixfmt-sdr-cu16le.rst
new file mode 100644
index 000000000000..cc9891dd9c4b
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-sdr-cu16le.rst
@@ -0,0 +1,59 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-SDR-FMT-CU16LE:
+
+****************************
+V4L2_SDR_FMT_CU16LE ('CU16')
+****************************
+
+*man V4L2_SDR_FMT_CU16LE(2)*
+
+Complex unsigned 16-bit little endian IQ sample
+
+
+Description
+===========
+
+This format contains sequence of complex number samples. Each complex
+number consist two parts, called In-phase and Quadrature (IQ). Both I
+and Q are represented as a 16 bit unsigned little endian number. I value
+comes first and Q value after that.
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  I'\ :sub:`0[7:0]`
+
+       -  I'\ :sub:`0[15:8]`
+
+    -  .. row 2
+
+       -  start + 2:
+
+       -  Q'\ :sub:`0[7:0]`
+
+       -  Q'\ :sub:`0[15:8]`
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-sdr-ru12le.rst b/Documentation/linux_tv/media/v4l/pixfmt-sdr-ru12le.rst
new file mode 100644
index 000000000000..8bcead790b3e
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-sdr-ru12le.rst
@@ -0,0 +1,50 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-SDR-FMT-RU12LE:
+
+****************************
+V4L2_SDR_FMT_RU12LE ('RU12')
+****************************
+
+*man V4L2_SDR_FMT_RU12LE(2)*
+
+Real unsigned 12-bit little endian sample
+
+
+Description
+===========
+
+This format contains sequence of real number samples. Each sample is
+represented as a 12 bit unsigned little endian number. Sample is stored
+in 16 bit space with unused high bits padded with 0.
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  I'\ :sub:`0[7:0]`
+
+       -  I'\ :sub:`0[11:8]`
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-sgbrg8.rst b/Documentation/linux_tv/media/v4l/pixfmt-sgbrg8.rst
new file mode 100644
index 000000000000..efcd5269815f
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-sgbrg8.rst
@@ -0,0 +1,93 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-SGBRG8:
+
+****************************
+V4L2_PIX_FMT_SGBRG8 ('GBRG')
+****************************
+
+*man V4L2_PIX_FMT_SGBRG8(2)*
+
+Bayer RGB format
+
+
+Description
+===========
+
+This is commonly the native format of digital cameras, reflecting the
+arrangement of sensors on the CCD device. Only one red, green or blue
+value is given for each pixel. Missing components must be interpolated
+from neighbouring pixels. From left to right the first row consists of a
+green and blue value, the second row of a red and green value. This
+scheme repeats to the right and down for every two columns and rows.
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  G\ :sub:`00`
+
+       -  B\ :sub:`01`
+
+       -  G\ :sub:`02`
+
+       -  B\ :sub:`03`
+
+    -  .. row 2
+
+       -  start + 4:
+
+       -  R\ :sub:`10`
+
+       -  G\ :sub:`11`
+
+       -  R\ :sub:`12`
+
+       -  G\ :sub:`13`
+
+    -  .. row 3
+
+       -  start + 8:
+
+       -  G\ :sub:`20`
+
+       -  B\ :sub:`21`
+
+       -  G\ :sub:`22`
+
+       -  B\ :sub:`23`
+
+    -  .. row 4
+
+       -  start + 12:
+
+       -  R\ :sub:`30`
+
+       -  G\ :sub:`31`
+
+       -  R\ :sub:`32`
+
+       -  G\ :sub:`33`
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-sgrbg8.rst b/Documentation/linux_tv/media/v4l/pixfmt-sgrbg8.rst
new file mode 100644
index 000000000000..fd7506f17a2c
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-sgrbg8.rst
@@ -0,0 +1,93 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-SGRBG8:
+
+****************************
+V4L2_PIX_FMT_SGRBG8 ('GRBG')
+****************************
+
+*man V4L2_PIX_FMT_SGRBG8(2)*
+
+Bayer RGB format
+
+
+Description
+===========
+
+This is commonly the native format of digital cameras, reflecting the
+arrangement of sensors on the CCD device. Only one red, green or blue
+value is given for each pixel. Missing components must be interpolated
+from neighbouring pixels. From left to right the first row consists of a
+green and blue value, the second row of a red and green value. This
+scheme repeats to the right and down for every two columns and rows.
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  G\ :sub:`00`
+
+       -  R\ :sub:`01`
+
+       -  G\ :sub:`02`
+
+       -  R\ :sub:`03`
+
+    -  .. row 2
+
+       -  start + 4:
+
+       -  B\ :sub:`10`
+
+       -  G\ :sub:`11`
+
+       -  B\ :sub:`12`
+
+       -  G\ :sub:`13`
+
+    -  .. row 3
+
+       -  start + 8:
+
+       -  G\ :sub:`20`
+
+       -  R\ :sub:`21`
+
+       -  G\ :sub:`22`
+
+       -  R\ :sub:`23`
+
+    -  .. row 4
+
+       -  start + 12:
+
+       -  B\ :sub:`30`
+
+       -  G\ :sub:`31`
+
+       -  B\ :sub:`32`
+
+       -  G\ :sub:`33`
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-srggb10.rst b/Documentation/linux_tv/media/v4l/pixfmt-srggb10.rst
new file mode 100644
index 000000000000..b8b2b7c3cd91
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-srggb10.rst
@@ -0,0 +1,129 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-SRGGB10:
+
+***************************************************************************************************************************
+V4L2_PIX_FMT_SRGGB10 ('RG10'), V4L2_PIX_FMT_SGRBG10 ('BA10'), V4L2_PIX_FMT_SGBRG10 ('GB10'), V4L2_PIX_FMT_SBGGR10 ('BG10'),
+***************************************************************************************************************************
+
+*man V4L2_PIX_FMT_SRGGB10(2)*
+
+V4L2_PIX_FMT_SGRBG10
+V4L2_PIX_FMT_SGBRG10
+V4L2_PIX_FMT_SBGGR10
+10-bit Bayer formats expanded to 16 bits
+
+
+Description
+===========
+
+These four pixel formats are raw sRGB / Bayer formats with 10 bits per
+colour. Each colour component is stored in a 16-bit word, with 6 unused
+high bits filled with zeros. Each n-pixel row contains n/2 green samples
+and n/2 blue or red samples, with alternating red and blue rows. Bytes
+are stored in memory in little endian order. They are conventionally
+described as GRGR... BGBG..., RGRG... GBGB..., etc. Below is an example
+of one of these formats
+
+**Byte Order..**
+
+Each cell is one byte, high 6 bits in high bytes are 0.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  B\ :sub:`00low`
+
+       -  B\ :sub:`00high`
+
+       -  G\ :sub:`01low`
+
+       -  G\ :sub:`01high`
+
+       -  B\ :sub:`02low`
+
+       -  B\ :sub:`02high`
+
+       -  G\ :sub:`03low`
+
+       -  G\ :sub:`03high`
+
+    -  .. row 2
+
+       -  start + 8:
+
+       -  G\ :sub:`10low`
+
+       -  G\ :sub:`10high`
+
+       -  R\ :sub:`11low`
+
+       -  R\ :sub:`11high`
+
+       -  G\ :sub:`12low`
+
+       -  G\ :sub:`12high`
+
+       -  R\ :sub:`13low`
+
+       -  R\ :sub:`13high`
+
+    -  .. row 3
+
+       -  start + 16:
+
+       -  B\ :sub:`20low`
+
+       -  B\ :sub:`20high`
+
+       -  G\ :sub:`21low`
+
+       -  G\ :sub:`21high`
+
+       -  B\ :sub:`22low`
+
+       -  B\ :sub:`22high`
+
+       -  G\ :sub:`23low`
+
+       -  G\ :sub:`23high`
+
+    -  .. row 4
+
+       -  start + 24:
+
+       -  G\ :sub:`30low`
+
+       -  G\ :sub:`30high`
+
+       -  R\ :sub:`31low`
+
+       -  R\ :sub:`31high`
+
+       -  G\ :sub:`32low`
+
+       -  G\ :sub:`32high`
+
+       -  R\ :sub:`33low`
+
+       -  R\ :sub:`33high`
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-srggb10alaw8.rst b/Documentation/linux_tv/media/v4l/pixfmt-srggb10alaw8.rst
new file mode 100644
index 000000000000..045c7a91203a
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-srggb10alaw8.rst
@@ -0,0 +1,32 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-SBGGR10ALAW8:
+
+***********************************************************************************************************************************************
+V4L2_PIX_FMT_SBGGR10ALAW8 ('aBA8'), V4L2_PIX_FMT_SGBRG10ALAW8 ('aGA8'), V4L2_PIX_FMT_SGRBG10ALAW8 ('agA8'), V4L2_PIX_FMT_SRGGB10ALAW8 ('aRA8'),
+***********************************************************************************************************************************************
+
+*man V4L2_PIX_FMT_SBGGR10ALAW8(2)*
+
+V4L2_PIX_FMT_SGBRG10ALAW8
+V4L2_PIX_FMT_SGRBG10ALAW8
+V4L2_PIX_FMT_SRGGB10ALAW8
+10-bit Bayer formats compressed to 8 bits
+
+
+Description
+===========
+
+These four pixel formats are raw sRGB / Bayer formats with 10 bits per
+color compressed to 8 bits each, using the A-LAW algorithm. Each color
+component consumes 8 bits of memory. In other respects this format is
+similar to :ref:`V4L2-PIX-FMT-SRGGB8`.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-srggb10dpcm8.rst b/Documentation/linux_tv/media/v4l/pixfmt-srggb10dpcm8.rst
new file mode 100644
index 000000000000..581ab5190246
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-srggb10dpcm8.rst
@@ -0,0 +1,33 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-SBGGR10DPCM8:
+
+***********************************************************************************************************************************************
+V4L2_PIX_FMT_SBGGR10DPCM8 ('bBA8'), V4L2_PIX_FMT_SGBRG10DPCM8 ('bGA8'), V4L2_PIX_FMT_SGRBG10DPCM8 ('BD10'), V4L2_PIX_FMT_SRGGB10DPCM8 ('bRA8'),
+***********************************************************************************************************************************************
+
+*man V4L2_PIX_FMT_SBGGR10DPCM8(2)*
+
+V4L2_PIX_FMT_SGBRG10DPCM8
+V4L2_PIX_FMT_SGRBG10DPCM8
+V4L2_PIX_FMT_SRGGB10DPCM8
+10-bit Bayer formats compressed to 8 bits
+
+
+Description
+===========
+
+These four pixel formats are raw sRGB / Bayer formats with 10 bits per
+colour compressed to 8 bits each, using DPCM compression. DPCM,
+differential pulse-code modulation, is lossy. Each colour component
+consumes 8 bits of memory. In other respects this format is similar to
+:ref:`pixfmt-srggb10`.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-srggb10p.rst b/Documentation/linux_tv/media/v4l/pixfmt-srggb10p.rst
new file mode 100644
index 000000000000..503dd3050e02
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-srggb10p.rst
@@ -0,0 +1,112 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-SRGGB10P:
+
+*******************************************************************************************************************************
+V4L2_PIX_FMT_SRGGB10P ('pRAA'), V4L2_PIX_FMT_SGRBG10P ('pgAA'), V4L2_PIX_FMT_SGBRG10P ('pGAA'), V4L2_PIX_FMT_SBGGR10P ('pBAA'),
+*******************************************************************************************************************************
+
+*man V4L2_PIX_FMT_SRGGB10P(2)*
+
+V4L2_PIX_FMT_SGRBG10P
+V4L2_PIX_FMT_SGBRG10P
+V4L2_PIX_FMT_SBGGR10P
+10-bit packed Bayer formats
+
+
+Description
+===========
+
+These four pixel formats are packed raw sRGB / Bayer formats with 10
+bits per colour. Every four consecutive colour components are packed
+into 5 bytes. Each of the first 4 bytes contain the 8 high order bits of
+the pixels, and the fifth byte contains the two least significants bits
+of each pixel, in the same order.
+
+Each n-pixel row contains n/2 green samples and n/2 blue or red samples,
+with alternating green-red and green-blue rows. They are conventionally
+described as GRGR... BGBG..., RGRG... GBGB..., etc. Below is an example
+of one of these formats:
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  B\ :sub:`00high`
+
+       -  G\ :sub:`01high`
+
+       -  B\ :sub:`02high`
+
+       -  G\ :sub:`03high`
+
+       -  B\ :sub:`00low`\ (bits 7--6) G\ :sub:`01low`\ (bits 5--4)
+          B\ :sub:`02low`\ (bits 3--2) G\ :sub:`03low`\ (bits 1--0)
+
+    -  .. row 2
+
+       -  start + 5:
+
+       -  G\ :sub:`10high`
+
+       -  R\ :sub:`11high`
+
+       -  G\ :sub:`12high`
+
+       -  R\ :sub:`13high`
+
+       -  G\ :sub:`10low`\ (bits 7--6) R\ :sub:`11low`\ (bits 5--4)
+          G\ :sub:`12low`\ (bits 3--2) R\ :sub:`13low`\ (bits 1--0)
+
+    -  .. row 3
+
+       -  start + 10:
+
+       -  B\ :sub:`20high`
+
+       -  G\ :sub:`21high`
+
+       -  B\ :sub:`22high`
+
+       -  G\ :sub:`23high`
+
+       -  B\ :sub:`20low`\ (bits 7--6) G\ :sub:`21low`\ (bits 5--4)
+          B\ :sub:`22low`\ (bits 3--2) G\ :sub:`23low`\ (bits 1--0)
+
+    -  .. row 4
+
+       -  start + 15:
+
+       -  G\ :sub:`30high`
+
+       -  R\ :sub:`31high`
+
+       -  G\ :sub:`32high`
+
+       -  R\ :sub:`33high`
+
+       -  G\ :sub:`30low`\ (bits 7--6) R\ :sub:`31low`\ (bits 5--4)
+          G\ :sub:`32low`\ (bits 3--2) R\ :sub:`33low`\ (bits 1--0)
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-srggb12.rst b/Documentation/linux_tv/media/v4l/pixfmt-srggb12.rst
new file mode 100644
index 000000000000..fa10223104d7
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-srggb12.rst
@@ -0,0 +1,129 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-SRGGB12:
+
+***************************************************************************************************************************
+V4L2_PIX_FMT_SRGGB12 ('RG12'), V4L2_PIX_FMT_SGRBG12 ('BA12'), V4L2_PIX_FMT_SGBRG12 ('GB12'), V4L2_PIX_FMT_SBGGR12 ('BG12'),
+***************************************************************************************************************************
+
+*man V4L2_PIX_FMT_SRGGB12(2)*
+
+V4L2_PIX_FMT_SGRBG12
+V4L2_PIX_FMT_SGBRG12
+V4L2_PIX_FMT_SBGGR12
+12-bit Bayer formats expanded to 16 bits
+
+
+Description
+===========
+
+These four pixel formats are raw sRGB / Bayer formats with 12 bits per
+colour. Each colour component is stored in a 16-bit word, with 4 unused
+high bits filled with zeros. Each n-pixel row contains n/2 green samples
+and n/2 blue or red samples, with alternating red and blue rows. Bytes
+are stored in memory in little endian order. They are conventionally
+described as GRGR... BGBG..., RGRG... GBGB..., etc. Below is an example
+of one of these formats
+
+**Byte Order..**
+
+Each cell is one byte, high 6 bits in high bytes are 0.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  B\ :sub:`00low`
+
+       -  B\ :sub:`00high`
+
+       -  G\ :sub:`01low`
+
+       -  G\ :sub:`01high`
+
+       -  B\ :sub:`02low`
+
+       -  B\ :sub:`02high`
+
+       -  G\ :sub:`03low`
+
+       -  G\ :sub:`03high`
+
+    -  .. row 2
+
+       -  start + 8:
+
+       -  G\ :sub:`10low`
+
+       -  G\ :sub:`10high`
+
+       -  R\ :sub:`11low`
+
+       -  R\ :sub:`11high`
+
+       -  G\ :sub:`12low`
+
+       -  G\ :sub:`12high`
+
+       -  R\ :sub:`13low`
+
+       -  R\ :sub:`13high`
+
+    -  .. row 3
+
+       -  start + 16:
+
+       -  B\ :sub:`20low`
+
+       -  B\ :sub:`20high`
+
+       -  G\ :sub:`21low`
+
+       -  G\ :sub:`21high`
+
+       -  B\ :sub:`22low`
+
+       -  B\ :sub:`22high`
+
+       -  G\ :sub:`23low`
+
+       -  G\ :sub:`23high`
+
+    -  .. row 4
+
+       -  start + 24:
+
+       -  G\ :sub:`30low`
+
+       -  G\ :sub:`30high`
+
+       -  R\ :sub:`31low`
+
+       -  R\ :sub:`31high`
+
+       -  G\ :sub:`32low`
+
+       -  G\ :sub:`32high`
+
+       -  R\ :sub:`33low`
+
+       -  R\ :sub:`33high`
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-srggb8.rst b/Documentation/linux_tv/media/v4l/pixfmt-srggb8.rst
new file mode 100644
index 000000000000..b208ea5a2f66
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-srggb8.rst
@@ -0,0 +1,93 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-SRGGB8:
+
+****************************
+V4L2_PIX_FMT_SRGGB8 ('RGGB')
+****************************
+
+*man V4L2_PIX_FMT_SRGGB8(2)*
+
+Bayer RGB format
+
+
+Description
+===========
+
+This is commonly the native format of digital cameras, reflecting the
+arrangement of sensors on the CCD device. Only one red, green or blue
+value is given for each pixel. Missing components must be interpolated
+from neighbouring pixels. From left to right the first row consists of a
+red and green value, the second row of a green and blue value. This
+scheme repeats to the right and down for every two columns and rows.
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  R\ :sub:`00`
+
+       -  G\ :sub:`01`
+
+       -  R\ :sub:`02`
+
+       -  G\ :sub:`03`
+
+    -  .. row 2
+
+       -  start + 4:
+
+       -  G\ :sub:`10`
+
+       -  B\ :sub:`11`
+
+       -  G\ :sub:`12`
+
+       -  B\ :sub:`13`
+
+    -  .. row 3
+
+       -  start + 8:
+
+       -  R\ :sub:`20`
+
+       -  G\ :sub:`21`
+
+       -  R\ :sub:`22`
+
+       -  G\ :sub:`23`
+
+    -  .. row 4
+
+       -  start + 12:
+
+       -  G\ :sub:`30`
+
+       -  B\ :sub:`31`
+
+       -  G\ :sub:`32`
+
+       -  B\ :sub:`33`
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-uv8.rst b/Documentation/linux_tv/media/v4l/pixfmt-uv8.rst
new file mode 100644
index 000000000000..6e126e905ec8
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-uv8.rst
@@ -0,0 +1,88 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-UV8:
+
+************************
+V4L2_PIX_FMT_UV8 ('UV8')
+************************
+
+*man V4L2_PIX_FMT_UV8(2)*
+
+UV plane interleaved
+
+
+Description
+===========
+
+In this format there is no Y plane, Only CbCr plane. ie (UV interleaved)
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  Cb\ :sub:`00`
+
+       -  Cr\ :sub:`00`
+
+       -  Cb\ :sub:`01`
+
+       -  Cr\ :sub:`01`
+
+    -  .. row 2
+
+       -  start + 4:
+
+       -  Cb\ :sub:`10`
+
+       -  Cr\ :sub:`10`
+
+       -  Cb\ :sub:`11`
+
+       -  Cr\ :sub:`11`
+
+    -  .. row 3
+
+       -  start + 8:
+
+       -  Cb\ :sub:`20`
+
+       -  Cr\ :sub:`20`
+
+       -  Cb\ :sub:`21`
+
+       -  Cr\ :sub:`21`
+
+    -  .. row 4
+
+       -  start + 12:
+
+       -  Cb\ :sub:`30`
+
+       -  Cr\ :sub:`30`
+
+       -  Cb\ :sub:`31`
+
+       -  Cr\ :sub:`31`
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-uyvy.rst b/Documentation/linux_tv/media/v4l/pixfmt-uyvy.rst
new file mode 100644
index 000000000000..fcdfb36c58c2
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-uyvy.rst
@@ -0,0 +1,216 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-UYVY:
+
+**************************
+V4L2_PIX_FMT_UYVY ('UYVY')
+**************************
+
+*man V4L2_PIX_FMT_UYVY(2)*
+
+Variation of ``V4L2_PIX_FMT_YUYV`` with different order of samples in
+memory
+
+
+Description
+===========
+
+In this format each four bytes is two pixels. Each four bytes is two
+Y's, a Cb and a Cr. Each Y goes to one of the pixels, and the Cb and Cr
+belong to both pixels. As you can see, the Cr and Cb components have
+half the horizontal resolution of the Y component.
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  Cb\ :sub:`00`
+
+       -  Y'\ :sub:`00`
+
+       -  Cr\ :sub:`00`
+
+       -  Y'\ :sub:`01`
+
+       -  Cb\ :sub:`01`
+
+       -  Y'\ :sub:`02`
+
+       -  Cr\ :sub:`01`
+
+       -  Y'\ :sub:`03`
+
+    -  .. row 2
+
+       -  start + 8:
+
+       -  Cb\ :sub:`10`
+
+       -  Y'\ :sub:`10`
+
+       -  Cr\ :sub:`10`
+
+       -  Y'\ :sub:`11`
+
+       -  Cb\ :sub:`11`
+
+       -  Y'\ :sub:`12`
+
+       -  Cr\ :sub:`11`
+
+       -  Y'\ :sub:`13`
+
+    -  .. row 3
+
+       -  start + 16:
+
+       -  Cb\ :sub:`20`
+
+       -  Y'\ :sub:`20`
+
+       -  Cr\ :sub:`20`
+
+       -  Y'\ :sub:`21`
+
+       -  Cb\ :sub:`21`
+
+       -  Y'\ :sub:`22`
+
+       -  Cr\ :sub:`21`
+
+       -  Y'\ :sub:`23`
+
+    -  .. row 4
+
+       -  start + 24:
+
+       -  Cb\ :sub:`30`
+
+       -  Y'\ :sub:`30`
+
+       -  Cr\ :sub:`30`
+
+       -  Y'\ :sub:`31`
+
+       -  Cb\ :sub:`31`
+
+       -  Y'\ :sub:`32`
+
+       -  Cr\ :sub:`31`
+
+       -  Y'\ :sub:`33`
+
+
+**Color Sample Location..**
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  
+       -  0
+
+       -  
+       -  1
+
+       -  
+       -  2
+
+       -  
+       -  3
+
+    -  .. row 2
+
+       -  0
+
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+    -  .. row 3
+
+       -  1
+
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+    -  .. row 4
+
+       -  2
+
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+    -  .. row 5
+
+       -  3
+
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-vyuy.rst b/Documentation/linux_tv/media/v4l/pixfmt-vyuy.rst
new file mode 100644
index 000000000000..b086bed774b2
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-vyuy.rst
@@ -0,0 +1,216 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-VYUY:
+
+**************************
+V4L2_PIX_FMT_VYUY ('VYUY')
+**************************
+
+*man V4L2_PIX_FMT_VYUY(2)*
+
+Variation of ``V4L2_PIX_FMT_YUYV`` with different order of samples in
+memory
+
+
+Description
+===========
+
+In this format each four bytes is two pixels. Each four bytes is two
+Y's, a Cb and a Cr. Each Y goes to one of the pixels, and the Cb and Cr
+belong to both pixels. As you can see, the Cr and Cb components have
+half the horizontal resolution of the Y component.
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  Cr\ :sub:`00`
+
+       -  Y'\ :sub:`00`
+
+       -  Cb\ :sub:`00`
+
+       -  Y'\ :sub:`01`
+
+       -  Cr\ :sub:`01`
+
+       -  Y'\ :sub:`02`
+
+       -  Cb\ :sub:`01`
+
+       -  Y'\ :sub:`03`
+
+    -  .. row 2
+
+       -  start + 8:
+
+       -  Cr\ :sub:`10`
+
+       -  Y'\ :sub:`10`
+
+       -  Cb\ :sub:`10`
+
+       -  Y'\ :sub:`11`
+
+       -  Cr\ :sub:`11`
+
+       -  Y'\ :sub:`12`
+
+       -  Cb\ :sub:`11`
+
+       -  Y'\ :sub:`13`
+
+    -  .. row 3
+
+       -  start + 16:
+
+       -  Cr\ :sub:`20`
+
+       -  Y'\ :sub:`20`
+
+       -  Cb\ :sub:`20`
+
+       -  Y'\ :sub:`21`
+
+       -  Cr\ :sub:`21`
+
+       -  Y'\ :sub:`22`
+
+       -  Cb\ :sub:`21`
+
+       -  Y'\ :sub:`23`
+
+    -  .. row 4
+
+       -  start + 24:
+
+       -  Cr\ :sub:`30`
+
+       -  Y'\ :sub:`30`
+
+       -  Cb\ :sub:`30`
+
+       -  Y'\ :sub:`31`
+
+       -  Cr\ :sub:`31`
+
+       -  Y'\ :sub:`32`
+
+       -  Cb\ :sub:`31`
+
+       -  Y'\ :sub:`33`
+
+
+**Color Sample Location..**
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  
+       -  0
+
+       -  
+       -  1
+
+       -  
+       -  2
+
+       -  
+       -  3
+
+    -  .. row 2
+
+       -  0
+
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+    -  .. row 3
+
+       -  1
+
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+    -  .. row 4
+
+       -  2
+
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+    -  .. row 5
+
+       -  3
+
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-y10.rst b/Documentation/linux_tv/media/v4l/pixfmt-y10.rst
new file mode 100644
index 000000000000..000dc5536cb4
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-y10.rst
@@ -0,0 +1,122 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-Y10:
+
+*************************
+V4L2_PIX_FMT_Y10 ('Y10 ')
+*************************
+
+*man V4L2_PIX_FMT_Y10(2)*
+
+Grey-scale image
+
+
+Description
+===========
+
+This is a grey-scale image with a depth of 10 bits per pixel. Pixels are
+stored in 16-bit words with unused high bits padded with 0. The least
+significant byte is stored at lower memory addresses (little-endian).
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  Y'\ :sub:`00low`
+
+       -  Y'\ :sub:`00high`
+
+       -  Y'\ :sub:`01low`
+
+       -  Y'\ :sub:`01high`
+
+       -  Y'\ :sub:`02low`
+
+       -  Y'\ :sub:`02high`
+
+       -  Y'\ :sub:`03low`
+
+       -  Y'\ :sub:`03high`
+
+    -  .. row 2
+
+       -  start + 8:
+
+       -  Y'\ :sub:`10low`
+
+       -  Y'\ :sub:`10high`
+
+       -  Y'\ :sub:`11low`
+
+       -  Y'\ :sub:`11high`
+
+       -  Y'\ :sub:`12low`
+
+       -  Y'\ :sub:`12high`
+
+       -  Y'\ :sub:`13low`
+
+       -  Y'\ :sub:`13high`
+
+    -  .. row 3
+
+       -  start + 16:
+
+       -  Y'\ :sub:`20low`
+
+       -  Y'\ :sub:`20high`
+
+       -  Y'\ :sub:`21low`
+
+       -  Y'\ :sub:`21high`
+
+       -  Y'\ :sub:`22low`
+
+       -  Y'\ :sub:`22high`
+
+       -  Y'\ :sub:`23low`
+
+       -  Y'\ :sub:`23high`
+
+    -  .. row 4
+
+       -  start + 24:
+
+       -  Y'\ :sub:`30low`
+
+       -  Y'\ :sub:`30high`
+
+       -  Y'\ :sub:`31low`
+
+       -  Y'\ :sub:`31high`
+
+       -  Y'\ :sub:`32low`
+
+       -  Y'\ :sub:`32high`
+
+       -  Y'\ :sub:`33low`
+
+       -  Y'\ :sub:`33high`
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-y10b.rst b/Documentation/linux_tv/media/v4l/pixfmt-y10b.rst
new file mode 100644
index 000000000000..83b7080643d5
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-y10b.rst
@@ -0,0 +1,56 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-Y10BPACK:
+
+******************************
+V4L2_PIX_FMT_Y10BPACK ('Y10B')
+******************************
+
+*man V4L2_PIX_FMT_Y10BPACK(2)*
+
+Grey-scale image as a bit-packed array
+
+
+Description
+===========
+
+This is a packed grey-scale image format with a depth of 10 bits per
+pixel. Pixels are stored in a bit-packed array of 10bit bits per pixel,
+with no padding between them and with the most significant bits coming
+first from the left.
+
+**Bit-packed representation.**
+
+pixels cross the byte boundary and have a ratio of 5 bytes for each 4
+pixels.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1
+
+
+    -  .. row 1
+
+       -  Y'\ :sub:`00[9:2]`
+
+       -  Y'\ :sub:`00[1:0]`\ Y'\ :sub:`01[9:4]`
+
+       -  Y'\ :sub:`01[3:0]`\ Y'\ :sub:`02[9:6]`
+
+       -  Y'\ :sub:`02[5:0]`\ Y'\ :sub:`03[9:8]`
+
+       -  Y'\ :sub:`03[7:0]`
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-y12.rst b/Documentation/linux_tv/media/v4l/pixfmt-y12.rst
new file mode 100644
index 000000000000..66c16aa8b3d5
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-y12.rst
@@ -0,0 +1,122 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-Y12:
+
+*************************
+V4L2_PIX_FMT_Y12 ('Y12 ')
+*************************
+
+*man V4L2_PIX_FMT_Y12(2)*
+
+Grey-scale image
+
+
+Description
+===========
+
+This is a grey-scale image with a depth of 12 bits per pixel. Pixels are
+stored in 16-bit words with unused high bits padded with 0. The least
+significant byte is stored at lower memory addresses (little-endian).
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  Y'\ :sub:`00low`
+
+       -  Y'\ :sub:`00high`
+
+       -  Y'\ :sub:`01low`
+
+       -  Y'\ :sub:`01high`
+
+       -  Y'\ :sub:`02low`
+
+       -  Y'\ :sub:`02high`
+
+       -  Y'\ :sub:`03low`
+
+       -  Y'\ :sub:`03high`
+
+    -  .. row 2
+
+       -  start + 8:
+
+       -  Y'\ :sub:`10low`
+
+       -  Y'\ :sub:`10high`
+
+       -  Y'\ :sub:`11low`
+
+       -  Y'\ :sub:`11high`
+
+       -  Y'\ :sub:`12low`
+
+       -  Y'\ :sub:`12high`
+
+       -  Y'\ :sub:`13low`
+
+       -  Y'\ :sub:`13high`
+
+    -  .. row 3
+
+       -  start + 16:
+
+       -  Y'\ :sub:`20low`
+
+       -  Y'\ :sub:`20high`
+
+       -  Y'\ :sub:`21low`
+
+       -  Y'\ :sub:`21high`
+
+       -  Y'\ :sub:`22low`
+
+       -  Y'\ :sub:`22high`
+
+       -  Y'\ :sub:`23low`
+
+       -  Y'\ :sub:`23high`
+
+    -  .. row 4
+
+       -  start + 24:
+
+       -  Y'\ :sub:`30low`
+
+       -  Y'\ :sub:`30high`
+
+       -  Y'\ :sub:`31low`
+
+       -  Y'\ :sub:`31high`
+
+       -  Y'\ :sub:`32low`
+
+       -  Y'\ :sub:`32high`
+
+       -  Y'\ :sub:`33low`
+
+       -  Y'\ :sub:`33high`
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-y12i.rst b/Documentation/linux_tv/media/v4l/pixfmt-y12i.rst
new file mode 100644
index 000000000000..18fffaef7f31
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-y12i.rst
@@ -0,0 +1,59 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-Y12I:
+
+**************************
+V4L2_PIX_FMT_Y12I ('Y12I')
+**************************
+
+*man V4L2_PIX_FMT_Y12I(2)*
+
+Interleaved grey-scale image, e.g. from a stereo-pair
+
+
+Description
+===========
+
+This is a grey-scale image with a depth of 12 bits per pixel, but with
+pixels from 2 sources interleaved and bit-packed. Each pixel is stored
+in a 24-bit word in the little-endian order. On a little-endian machine
+these pixels can be deinterlaced using
+
+
+.. code-block:: c
+
+    __u8 *buf;
+    left0 = 0xfff & *(__u16 *)buf;
+    right0 = *(__u16 *)(buf + 1) >> 4;
+
+**Bit-packed representation.**
+
+pixels cross the byte boundary and have a ratio of 3 bytes for each
+interleaved pixel.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1
+
+
+    -  .. row 1
+
+       -  Y'\ :sub:`0left[7:0]`
+
+       -  Y'\ :sub:`0right[3:0]`\ Y'\ :sub:`0left[11:8]`
+
+       -  Y'\ :sub:`0right[11:4]`
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-y16-be.rst b/Documentation/linux_tv/media/v4l/pixfmt-y16-be.rst
new file mode 100644
index 000000000000..05fef3841ed7
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-y16-be.rst
@@ -0,0 +1,123 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-Y16-BE:
+
+****************************************
+V4L2_PIX_FMT_Y16_BE ('Y16 ' | (1 << 31))
+****************************************
+
+*man V4L2_PIX_FMT_Y16_BE(2)*
+
+Grey-scale image
+
+
+Description
+===========
+
+This is a grey-scale image with a depth of 16 bits per pixel. The most
+significant byte is stored at lower memory addresses (big-endian). Note
+the actual sampling precision may be lower than 16 bits, for example 10
+bits per pixel with values in range 0 to 1023.
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  Y'\ :sub:`00high`
+
+       -  Y'\ :sub:`00low`
+
+       -  Y'\ :sub:`01high`
+
+       -  Y'\ :sub:`01low`
+
+       -  Y'\ :sub:`02high`
+
+       -  Y'\ :sub:`02low`
+
+       -  Y'\ :sub:`03high`
+
+       -  Y'\ :sub:`03low`
+
+    -  .. row 2
+
+       -  start + 8:
+
+       -  Y'\ :sub:`10high`
+
+       -  Y'\ :sub:`10low`
+
+       -  Y'\ :sub:`11high`
+
+       -  Y'\ :sub:`11low`
+
+       -  Y'\ :sub:`12high`
+
+       -  Y'\ :sub:`12low`
+
+       -  Y'\ :sub:`13high`
+
+       -  Y'\ :sub:`13low`
+
+    -  .. row 3
+
+       -  start + 16:
+
+       -  Y'\ :sub:`20high`
+
+       -  Y'\ :sub:`20low`
+
+       -  Y'\ :sub:`21high`
+
+       -  Y'\ :sub:`21low`
+
+       -  Y'\ :sub:`22high`
+
+       -  Y'\ :sub:`22low`
+
+       -  Y'\ :sub:`23high`
+
+       -  Y'\ :sub:`23low`
+
+    -  .. row 4
+
+       -  start + 24:
+
+       -  Y'\ :sub:`30high`
+
+       -  Y'\ :sub:`30low`
+
+       -  Y'\ :sub:`31high`
+
+       -  Y'\ :sub:`31low`
+
+       -  Y'\ :sub:`32high`
+
+       -  Y'\ :sub:`32low`
+
+       -  Y'\ :sub:`33high`
+
+       -  Y'\ :sub:`33low`
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-y16.rst b/Documentation/linux_tv/media/v4l/pixfmt-y16.rst
new file mode 100644
index 000000000000..b3c766feb4c6
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-y16.rst
@@ -0,0 +1,123 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-Y16:
+
+*************************
+V4L2_PIX_FMT_Y16 ('Y16 ')
+*************************
+
+*man V4L2_PIX_FMT_Y16(2)*
+
+Grey-scale image
+
+
+Description
+===========
+
+This is a grey-scale image with a depth of 16 bits per pixel. The least
+significant byte is stored at lower memory addresses (little-endian).
+Note the actual sampling precision may be lower than 16 bits, for
+example 10 bits per pixel with values in range 0 to 1023.
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  Y'\ :sub:`00low`
+
+       -  Y'\ :sub:`00high`
+
+       -  Y'\ :sub:`01low`
+
+       -  Y'\ :sub:`01high`
+
+       -  Y'\ :sub:`02low`
+
+       -  Y'\ :sub:`02high`
+
+       -  Y'\ :sub:`03low`
+
+       -  Y'\ :sub:`03high`
+
+    -  .. row 2
+
+       -  start + 8:
+
+       -  Y'\ :sub:`10low`
+
+       -  Y'\ :sub:`10high`
+
+       -  Y'\ :sub:`11low`
+
+       -  Y'\ :sub:`11high`
+
+       -  Y'\ :sub:`12low`
+
+       -  Y'\ :sub:`12high`
+
+       -  Y'\ :sub:`13low`
+
+       -  Y'\ :sub:`13high`
+
+    -  .. row 3
+
+       -  start + 16:
+
+       -  Y'\ :sub:`20low`
+
+       -  Y'\ :sub:`20high`
+
+       -  Y'\ :sub:`21low`
+
+       -  Y'\ :sub:`21high`
+
+       -  Y'\ :sub:`22low`
+
+       -  Y'\ :sub:`22high`
+
+       -  Y'\ :sub:`23low`
+
+       -  Y'\ :sub:`23high`
+
+    -  .. row 4
+
+       -  start + 24:
+
+       -  Y'\ :sub:`30low`
+
+       -  Y'\ :sub:`30high`
+
+       -  Y'\ :sub:`31low`
+
+       -  Y'\ :sub:`31high`
+
+       -  Y'\ :sub:`32low`
+
+       -  Y'\ :sub:`32high`
+
+       -  Y'\ :sub:`33low`
+
+       -  Y'\ :sub:`33high`
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-y41p.rst b/Documentation/linux_tv/media/v4l/pixfmt-y41p.rst
new file mode 100644
index 000000000000..d050d27e7ea1
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-y41p.rst
@@ -0,0 +1,313 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-Y41P:
+
+**************************
+V4L2_PIX_FMT_Y41P ('Y41P')
+**************************
+
+*man V4L2_PIX_FMT_Y41P(2)*
+
+Format with ¼ horizontal chroma resolution, also known as YUV 4:1:1
+
+
+Description
+===========
+
+In this format each 12 bytes is eight pixels. In the twelve bytes are
+two CbCr pairs and eight Y's. The first CbCr pair goes with the first
+four Y's, and the second CbCr pair goes with the other four Y's. The Cb
+and Cr components have one fourth the horizontal resolution of the Y
+component.
+
+Do not confuse this format with
+:ref:`V4L2_PIX_FMT_YUV411P <V4L2-PIX-FMT-YUV411P>`. Y41P is derived
+from "YUV 4:1:1 *packed*", while YUV411P stands for "YUV 4:1:1
+*planar*".
+
+**Byte Order.**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1 1 1 1 1 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  Cb\ :sub:`00`
+
+       -  Y'\ :sub:`00`
+
+       -  Cr\ :sub:`00`
+
+       -  Y'\ :sub:`01`
+
+       -  Cb\ :sub:`01`
+
+       -  Y'\ :sub:`02`
+
+       -  Cr\ :sub:`01`
+
+       -  Y'\ :sub:`03`
+
+       -  Y'\ :sub:`04`
+
+       -  Y'\ :sub:`05`
+
+       -  Y'\ :sub:`06`
+
+       -  Y'\ :sub:`07`
+
+    -  .. row 2
+
+       -  start + 12:
+
+       -  Cb\ :sub:`10`
+
+       -  Y'\ :sub:`10`
+
+       -  Cr\ :sub:`10`
+
+       -  Y'\ :sub:`11`
+
+       -  Cb\ :sub:`11`
+
+       -  Y'\ :sub:`12`
+
+       -  Cr\ :sub:`11`
+
+       -  Y'\ :sub:`13`
+
+       -  Y'\ :sub:`14`
+
+       -  Y'\ :sub:`15`
+
+       -  Y'\ :sub:`16`
+
+       -  Y'\ :sub:`17`
+
+    -  .. row 3
+
+       -  start + 24:
+
+       -  Cb\ :sub:`20`
+
+       -  Y'\ :sub:`20`
+
+       -  Cr\ :sub:`20`
+
+       -  Y'\ :sub:`21`
+
+       -  Cb\ :sub:`21`
+
+       -  Y'\ :sub:`22`
+
+       -  Cr\ :sub:`21`
+
+       -  Y'\ :sub:`23`
+
+       -  Y'\ :sub:`24`
+
+       -  Y'\ :sub:`25`
+
+       -  Y'\ :sub:`26`
+
+       -  Y'\ :sub:`27`
+
+    -  .. row 4
+
+       -  start + 36:
+
+       -  Cb\ :sub:`30`
+
+       -  Y'\ :sub:`30`
+
+       -  Cr\ :sub:`30`
+
+       -  Y'\ :sub:`31`
+
+       -  Cb\ :sub:`31`
+
+       -  Y'\ :sub:`32`
+
+       -  Cr\ :sub:`31`
+
+       -  Y'\ :sub:`33`
+
+       -  Y'\ :sub:`34`
+
+       -  Y'\ :sub:`35`
+
+       -  Y'\ :sub:`36`
+
+       -  Y'\ :sub:`37`
+
+
+**Color Sample Location..**
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  
+       -  0
+
+       -  
+       -  1
+
+       -  
+       -  2
+
+       -  
+       -  3
+
+       -  
+       -  4
+
+       -  
+       -  5
+
+       -  
+       -  6
+
+       -  
+       -  7
+
+    -  .. row 2
+
+       -  0
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 3
+
+       -  1
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 4
+
+       -  2
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 5
+
+       -  3
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-y8i.rst b/Documentation/linux_tv/media/v4l/pixfmt-y8i.rst
new file mode 100644
index 000000000000..69ec8d7e8a06
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-y8i.rst
@@ -0,0 +1,123 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-Y8I:
+
+*************************
+V4L2_PIX_FMT_Y8I ('Y8I ')
+*************************
+
+*man V4L2_PIX_FMT_Y8I(2)*
+
+Interleaved grey-scale image, e.g. from a stereo-pair
+
+
+Description
+===========
+
+This is a grey-scale image with a depth of 8 bits per pixel, but with
+pixels from 2 sources interleaved. Each pixel is stored in a 16-bit
+word. E.g. the R200 RealSense camera stores pixel from the left sensor
+in lower and from the right sensor in the higher 8 bits.
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  Y'\ :sub:`00left`
+
+       -  Y'\ :sub:`00right`
+
+       -  Y'\ :sub:`01left`
+
+       -  Y'\ :sub:`01right`
+
+       -  Y'\ :sub:`02left`
+
+       -  Y'\ :sub:`02right`
+
+       -  Y'\ :sub:`03left`
+
+       -  Y'\ :sub:`03right`
+
+    -  .. row 2
+
+       -  start + 8:
+
+       -  Y'\ :sub:`10left`
+
+       -  Y'\ :sub:`10right`
+
+       -  Y'\ :sub:`11left`
+
+       -  Y'\ :sub:`11right`
+
+       -  Y'\ :sub:`12left`
+
+       -  Y'\ :sub:`12right`
+
+       -  Y'\ :sub:`13left`
+
+       -  Y'\ :sub:`13right`
+
+    -  .. row 3
+
+       -  start + 16:
+
+       -  Y'\ :sub:`20left`
+
+       -  Y'\ :sub:`20right`
+
+       -  Y'\ :sub:`21left`
+
+       -  Y'\ :sub:`21right`
+
+       -  Y'\ :sub:`22left`
+
+       -  Y'\ :sub:`22right`
+
+       -  Y'\ :sub:`23left`
+
+       -  Y'\ :sub:`23right`
+
+    -  .. row 4
+
+       -  start + 24:
+
+       -  Y'\ :sub:`30left`
+
+       -  Y'\ :sub:`30right`
+
+       -  Y'\ :sub:`31left`
+
+       -  Y'\ :sub:`31right`
+
+       -  Y'\ :sub:`32left`
+
+       -  Y'\ :sub:`32right`
+
+       -  Y'\ :sub:`33left`
+
+       -  Y'\ :sub:`33right`
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-yuv410.rst b/Documentation/linux_tv/media/v4l/pixfmt-yuv410.rst
new file mode 100644
index 000000000000..f56902f6faed
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-yuv410.rst
@@ -0,0 +1,219 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-YVU410:
+
+**********************************************************
+V4L2_PIX_FMT_YVU410 ('YVU9'), V4L2_PIX_FMT_YUV410 ('YUV9')
+**********************************************************
+
+*man V4L2_PIX_FMT_YVU410(2)*
+
+V4L2_PIX_FMT_YUV410
+Planar formats with ¼ horizontal and vertical chroma resolution, also
+known as YUV 4:1:0
+
+
+Description
+===========
+
+These are planar formats, as opposed to a packed format. The three
+components are separated into three sub-images or planes. The Y plane is
+first. The Y plane has one byte per pixel. For ``V4L2_PIX_FMT_YVU410``,
+the Cr plane immediately follows the Y plane in memory. The Cr plane is
+¼ the width and ¼ the height of the Y plane (and of the image). Each Cr
+belongs to 16 pixels, a four-by-four square of the image. Following the
+Cr plane is the Cb plane, just like the Cr plane.
+``V4L2_PIX_FMT_YUV410`` is the same, except the Cb plane comes first,
+then the Cr plane.
+
+If the Y plane has pad bytes after each row, then the Cr and Cb planes
+have ¼ as many pad bytes after their rows. In other words, four Cx rows
+(including padding) are exactly as long as one Y row (including
+padding).
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  Y'\ :sub:`00`
+
+       -  Y'\ :sub:`01`
+
+       -  Y'\ :sub:`02`
+
+       -  Y'\ :sub:`03`
+
+    -  .. row 2
+
+       -  start + 4:
+
+       -  Y'\ :sub:`10`
+
+       -  Y'\ :sub:`11`
+
+       -  Y'\ :sub:`12`
+
+       -  Y'\ :sub:`13`
+
+    -  .. row 3
+
+       -  start + 8:
+
+       -  Y'\ :sub:`20`
+
+       -  Y'\ :sub:`21`
+
+       -  Y'\ :sub:`22`
+
+       -  Y'\ :sub:`23`
+
+    -  .. row 4
+
+       -  start + 12:
+
+       -  Y'\ :sub:`30`
+
+       -  Y'\ :sub:`31`
+
+       -  Y'\ :sub:`32`
+
+       -  Y'\ :sub:`33`
+
+    -  .. row 5
+
+       -  start + 16:
+
+       -  Cr\ :sub:`00`
+
+    -  .. row 6
+
+       -  start + 17:
+
+       -  Cb\ :sub:`00`
+
+
+**Color Sample Location..**
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  
+       -  0
+
+       -  
+       -  1
+
+       -  
+       -  2
+
+       -  
+       -  3
+
+    -  .. row 2
+
+       -  0
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 3
+
+       -  
+
+    -  .. row 4
+
+       -  1
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 5
+
+       -  
+       -  
+       -  
+       -  
+       -  C
+
+       -  
+       -  
+       -  
+
+    -  .. row 6
+
+       -  2
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 7
+
+       -  
+
+    -  .. row 8
+
+       -  3
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-yuv411p.rst b/Documentation/linux_tv/media/v4l/pixfmt-yuv411p.rst
new file mode 100644
index 000000000000..bf4fa56b8efb
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-yuv411p.rst
@@ -0,0 +1,237 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-YUV411P:
+
+*****************************
+V4L2_PIX_FMT_YUV411P ('411P')
+*****************************
+
+*man V4L2_PIX_FMT_YUV411P(2)*
+
+Format with ¼ horizontal chroma resolution, also known as YUV 4:1:1.
+Planar layout as opposed to ``V4L2_PIX_FMT_Y41P``
+
+
+Description
+===========
+
+This format is not commonly used. This is a planar format similar to the
+4:2:2 planar format except with half as many chroma. The three
+components are separated into three sub-images or planes. The Y plane is
+first. The Y plane has one byte per pixel. The Cb plane immediately
+follows the Y plane in memory. The Cb plane is ¼ the width of the Y
+plane (and of the image). Each Cb belongs to 4 pixels all on the same
+row. For example, Cb\ :sub:`0` belongs to Y'\ :sub:`00`, Y'\ :sub:`01`,
+Y'\ :sub:`02` and Y'\ :sub:`03`. Following the Cb plane is the Cr plane,
+just like the Cb plane.
+
+If the Y plane has pad bytes after each row, then the Cr and Cb planes
+have ¼ as many pad bytes after their rows. In other words, four C x rows
+(including padding) is exactly as long as one Y row (including padding).
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  Y'\ :sub:`00`
+
+       -  Y'\ :sub:`01`
+
+       -  Y'\ :sub:`02`
+
+       -  Y'\ :sub:`03`
+
+    -  .. row 2
+
+       -  start + 4:
+
+       -  Y'\ :sub:`10`
+
+       -  Y'\ :sub:`11`
+
+       -  Y'\ :sub:`12`
+
+       -  Y'\ :sub:`13`
+
+    -  .. row 3
+
+       -  start + 8:
+
+       -  Y'\ :sub:`20`
+
+       -  Y'\ :sub:`21`
+
+       -  Y'\ :sub:`22`
+
+       -  Y'\ :sub:`23`
+
+    -  .. row 4
+
+       -  start + 12:
+
+       -  Y'\ :sub:`30`
+
+       -  Y'\ :sub:`31`
+
+       -  Y'\ :sub:`32`
+
+       -  Y'\ :sub:`33`
+
+    -  .. row 5
+
+       -  start + 16:
+
+       -  Cb\ :sub:`00`
+
+    -  .. row 6
+
+       -  start + 17:
+
+       -  Cb\ :sub:`10`
+
+    -  .. row 7
+
+       -  start + 18:
+
+       -  Cb\ :sub:`20`
+
+    -  .. row 8
+
+       -  start + 19:
+
+       -  Cb\ :sub:`30`
+
+    -  .. row 9
+
+       -  start + 20:
+
+       -  Cr\ :sub:`00`
+
+    -  .. row 10
+
+       -  start + 21:
+
+       -  Cr\ :sub:`10`
+
+    -  .. row 11
+
+       -  start + 22:
+
+       -  Cr\ :sub:`20`
+
+    -  .. row 12
+
+       -  start + 23:
+
+       -  Cr\ :sub:`30`
+
+
+**Color Sample Location..**
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  
+       -  0
+
+       -  
+       -  1
+
+       -  
+       -  2
+
+       -  
+       -  3
+
+    -  .. row 2
+
+       -  0
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 3
+
+       -  1
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 4
+
+       -  2
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 5
+
+       -  3
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-yuv420.rst b/Documentation/linux_tv/media/v4l/pixfmt-yuv420.rst
new file mode 100644
index 000000000000..dcf3a176d1ba
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-yuv420.rst
@@ -0,0 +1,250 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-YVU420:
+
+**********************************************************
+V4L2_PIX_FMT_YVU420 ('YV12'), V4L2_PIX_FMT_YUV420 ('YU12')
+**********************************************************
+
+*man V4L2_PIX_FMT_YVU420(2)*
+
+V4L2_PIX_FMT_YUV420
+Planar formats with ½ horizontal and vertical chroma resolution, also
+known as YUV 4:2:0
+
+
+Description
+===========
+
+These are planar formats, as opposed to a packed format. The three
+components are separated into three sub- images or planes. The Y plane
+is first. The Y plane has one byte per pixel. For
+``V4L2_PIX_FMT_YVU420``, the Cr plane immediately follows the Y plane in
+memory. The Cr plane is half the width and half the height of the Y
+plane (and of the image). Each Cr belongs to four pixels, a two-by-two
+square of the image. For example, Cr\ :sub:`0` belongs to Y'\ :sub:`00`,
+Y'\ :sub:`01`, Y'\ :sub:`10`, and Y'\ :sub:`11`. Following the Cr plane
+is the Cb plane, just like the Cr plane. ``V4L2_PIX_FMT_YUV420`` is the
+same except the Cb plane comes first, then the Cr plane.
+
+If the Y plane has pad bytes after each row, then the Cr and Cb planes
+have half as many pad bytes after their rows. In other words, two Cx
+rows (including padding) is exactly as long as one Y row (including
+padding).
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  Y'\ :sub:`00`
+
+       -  Y'\ :sub:`01`
+
+       -  Y'\ :sub:`02`
+
+       -  Y'\ :sub:`03`
+
+    -  .. row 2
+
+       -  start + 4:
+
+       -  Y'\ :sub:`10`
+
+       -  Y'\ :sub:`11`
+
+       -  Y'\ :sub:`12`
+
+       -  Y'\ :sub:`13`
+
+    -  .. row 3
+
+       -  start + 8:
+
+       -  Y'\ :sub:`20`
+
+       -  Y'\ :sub:`21`
+
+       -  Y'\ :sub:`22`
+
+       -  Y'\ :sub:`23`
+
+    -  .. row 4
+
+       -  start + 12:
+
+       -  Y'\ :sub:`30`
+
+       -  Y'\ :sub:`31`
+
+       -  Y'\ :sub:`32`
+
+       -  Y'\ :sub:`33`
+
+    -  .. row 5
+
+       -  start + 16:
+
+       -  Cr\ :sub:`00`
+
+       -  Cr\ :sub:`01`
+
+    -  .. row 6
+
+       -  start + 18:
+
+       -  Cr\ :sub:`10`
+
+       -  Cr\ :sub:`11`
+
+    -  .. row 7
+
+       -  start + 20:
+
+       -  Cb\ :sub:`00`
+
+       -  Cb\ :sub:`01`
+
+    -  .. row 8
+
+       -  start + 22:
+
+       -  Cb\ :sub:`10`
+
+       -  Cb\ :sub:`11`
+
+
+**Color Sample Location..**
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  
+       -  0
+
+       -  
+       -  1
+
+       -  
+       -  2
+
+       -  
+       -  3
+
+    -  .. row 2
+
+       -  0
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 3
+
+       -  
+       -  
+       -  C
+
+       -  
+       -  
+       -  
+       -  C
+
+       -  
+
+    -  .. row 4
+
+       -  1
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 5
+
+       -  
+
+    -  .. row 6
+
+       -  2
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 7
+
+       -  
+       -  
+       -  C
+
+       -  
+       -  
+       -  
+       -  C
+
+       -  
+
+    -  .. row 8
+
+       -  3
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-yuv420m.rst b/Documentation/linux_tv/media/v4l/pixfmt-yuv420m.rst
new file mode 100644
index 000000000000..5f918d0d1498
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-yuv420m.rst
@@ -0,0 +1,265 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-YUV420M:
+
+************************************************************
+V4L2_PIX_FMT_YUV420M ('YM12'), V4L2_PIX_FMT_YVU420M ('YM21')
+************************************************************
+
+*man V4L2_PIX_FMT_YUV420M(2)*
+
+V4L2_PIX_FMT_YVU420M
+Variation of ``V4L2_PIX_FMT_YUV420`` and ``V4L2_PIX_FMT_YVU420`` with
+planes non contiguous in memory.
+
+
+Description
+===========
+
+This is a multi-planar format, as opposed to a packed format. The three
+components are separated into three sub-images or planes.
+
+The Y plane is first. The Y plane has one byte per pixel. For
+``V4L2_PIX_FMT_YUV420M`` the Cb data constitutes the second plane which
+is half the width and half the height of the Y plane (and of the image).
+Each Cb belongs to four pixels, a two-by-two square of the image. For
+example, Cb\ :sub:`0` belongs to Y'\ :sub:`00`, Y'\ :sub:`01`,
+Y'\ :sub:`10`, and Y'\ :sub:`11`. The Cr data, just like the Cb plane,
+is in the third plane.
+
+``V4L2_PIX_FMT_YVU420M`` is the same except the Cr data is stored in the
+second plane and the Cb data in the third plane.
+
+If the Y plane has pad bytes after each row, then the Cb and Cr planes
+have half as many pad bytes after their rows. In other words, two Cx
+rows (including padding) is exactly as long as one Y row (including
+padding).
+
+``V4L2_PIX_FMT_YUV420M`` and ``V4L2_PIX_FMT_YVU420M`` are intended to be
+used only in drivers and applications that support the multi-planar API,
+described in :ref:`planar-apis`.
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start0 + 0:
+
+       -  Y'\ :sub:`00`
+
+       -  Y'\ :sub:`01`
+
+       -  Y'\ :sub:`02`
+
+       -  Y'\ :sub:`03`
+
+    -  .. row 2
+
+       -  start0 + 4:
+
+       -  Y'\ :sub:`10`
+
+       -  Y'\ :sub:`11`
+
+       -  Y'\ :sub:`12`
+
+       -  Y'\ :sub:`13`
+
+    -  .. row 3
+
+       -  start0 + 8:
+
+       -  Y'\ :sub:`20`
+
+       -  Y'\ :sub:`21`
+
+       -  Y'\ :sub:`22`
+
+       -  Y'\ :sub:`23`
+
+    -  .. row 4
+
+       -  start0 + 12:
+
+       -  Y'\ :sub:`30`
+
+       -  Y'\ :sub:`31`
+
+       -  Y'\ :sub:`32`
+
+       -  Y'\ :sub:`33`
+
+    -  .. row 5
+
+       -  
+
+    -  .. row 6
+
+       -  start1 + 0:
+
+       -  Cb\ :sub:`00`
+
+       -  Cb\ :sub:`01`
+
+    -  .. row 7
+
+       -  start1 + 2:
+
+       -  Cb\ :sub:`10`
+
+       -  Cb\ :sub:`11`
+
+    -  .. row 8
+
+       -  
+
+    -  .. row 9
+
+       -  start2 + 0:
+
+       -  Cr\ :sub:`00`
+
+       -  Cr\ :sub:`01`
+
+    -  .. row 10
+
+       -  start2 + 2:
+
+       -  Cr\ :sub:`10`
+
+       -  Cr\ :sub:`11`
+
+
+**Color Sample Location..**
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  
+       -  0
+
+       -  
+       -  1
+
+       -  
+       -  2
+
+       -  
+       -  3
+
+    -  .. row 2
+
+       -  0
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 3
+
+       -  
+       -  
+       -  C
+
+       -  
+       -  
+       -  
+       -  C
+
+       -  
+
+    -  .. row 4
+
+       -  1
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 5
+
+       -  
+
+    -  .. row 6
+
+       -  2
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+    -  .. row 7
+
+       -  
+       -  
+       -  C
+
+       -  
+       -  
+       -  
+       -  C
+
+       -  
+
+    -  .. row 8
+
+       -  3
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+       -  
+       -  Y
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-yuv422m.rst b/Documentation/linux_tv/media/v4l/pixfmt-yuv422m.rst
new file mode 100644
index 000000000000..625d4ccf73d9
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-yuv422m.rst
@@ -0,0 +1,274 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-YUV422M:
+
+************************************************************
+V4L2_PIX_FMT_YUV422M ('YM16'), V4L2_PIX_FMT_YVU422M ('YM61')
+************************************************************
+
+*man V4L2_PIX_FMT_YUV422M(2)*
+
+V4L2_PIX_FMT_YVU422M
+Planar formats with ½ horizontal resolution, also known as YUV and YVU
+4:2:2
+
+
+Description
+===========
+
+This is a multi-planar format, as opposed to a packed format. The three
+components are separated into three sub-images or planes.
+
+The Y plane is first. The Y plane has one byte per pixel. For
+``V4L2_PIX_FMT_YUV422M`` the Cb data constitutes the second plane which
+is half the width of the Y plane (and of the image). Each Cb belongs to
+two pixels. For example, Cb\ :sub:`0` belongs to Y'\ :sub:`00`,
+Y'\ :sub:`01`. The Cr data, just like the Cb plane, is in the third
+plane.
+
+``V4L2_PIX_FMT_YVU422M`` is the same except the Cr data is stored in the
+second plane and the Cb data in the third plane.
+
+If the Y plane has pad bytes after each row, then the Cb and Cr planes
+have half as many pad bytes after their rows. In other words, two Cx
+rows (including padding) is exactly as long as one Y row (including
+padding).
+
+``V4L2_PIX_FMT_YUV422M`` and ``V4L2_PIX_FMT_YVU422M`` are intended to be
+used only in drivers and applications that support the multi-planar API,
+described in :ref:`planar-apis`.
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start0 + 0:
+
+       -  Y'\ :sub:`00`
+
+       -  Y'\ :sub:`01`
+
+       -  Y'\ :sub:`02`
+
+       -  Y'\ :sub:`03`
+
+    -  .. row 2
+
+       -  start0 + 4:
+
+       -  Y'\ :sub:`10`
+
+       -  Y'\ :sub:`11`
+
+       -  Y'\ :sub:`12`
+
+       -  Y'\ :sub:`13`
+
+    -  .. row 3
+
+       -  start0 + 8:
+
+       -  Y'\ :sub:`20`
+
+       -  Y'\ :sub:`21`
+
+       -  Y'\ :sub:`22`
+
+       -  Y'\ :sub:`23`
+
+    -  .. row 4
+
+       -  start0 + 12:
+
+       -  Y'\ :sub:`30`
+
+       -  Y'\ :sub:`31`
+
+       -  Y'\ :sub:`32`
+
+       -  Y'\ :sub:`33`
+
+    -  .. row 5
+
+       -  
+
+    -  .. row 6
+
+       -  start1 + 0:
+
+       -  Cb\ :sub:`00`
+
+       -  Cb\ :sub:`01`
+
+    -  .. row 7
+
+       -  start1 + 2:
+
+       -  Cb\ :sub:`10`
+
+       -  Cb\ :sub:`11`
+
+    -  .. row 8
+
+       -  start1 + 4:
+
+       -  Cb\ :sub:`20`
+
+       -  Cb\ :sub:`21`
+
+    -  .. row 9
+
+       -  start1 + 6:
+
+       -  Cb\ :sub:`30`
+
+       -  Cb\ :sub:`31`
+
+    -  .. row 10
+
+       -  
+
+    -  .. row 11
+
+       -  start2 + 0:
+
+       -  Cr\ :sub:`00`
+
+       -  Cr\ :sub:`01`
+
+    -  .. row 12
+
+       -  start2 + 2:
+
+       -  Cr\ :sub:`10`
+
+       -  Cr\ :sub:`11`
+
+    -  .. row 13
+
+       -  start2 + 4:
+
+       -  Cr\ :sub:`20`
+
+       -  Cr\ :sub:`21`
+
+    -  .. row 14
+
+       -  start2 + 6:
+
+       -  Cr\ :sub:`30`
+
+       -  Cr\ :sub:`31`
+
+
+**Color Sample Location..**
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  
+       -  0
+
+       -  
+       -  1
+
+       -  
+       -  2
+
+       -  
+       -  3
+
+    -  .. row 2
+
+       -  0
+
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+    -  .. row 3
+
+       -  1
+
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+    -  .. row 4
+
+       -  2
+
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+    -  .. row 5
+
+       -  3
+
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-yuv422p.rst b/Documentation/linux_tv/media/v4l/pixfmt-yuv422p.rst
new file mode 100644
index 000000000000..d21794b48496
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-yuv422p.rst
@@ -0,0 +1,257 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-YUV422P:
+
+*****************************
+V4L2_PIX_FMT_YUV422P ('422P')
+*****************************
+
+*man V4L2_PIX_FMT_YUV422P(2)*
+
+Format with ½ horizontal chroma resolution, also known as YUV 4:2:2.
+Planar layout as opposed to ``V4L2_PIX_FMT_YUYV``
+
+
+Description
+===========
+
+This format is not commonly used. This is a planar version of the YUYV
+format. The three components are separated into three sub-images or
+planes. The Y plane is first. The Y plane has one byte per pixel. The Cb
+plane immediately follows the Y plane in memory. The Cb plane is half
+the width of the Y plane (and of the image). Each Cb belongs to two
+pixels. For example, Cb\ :sub:`0` belongs to Y'\ :sub:`00`,
+Y'\ :sub:`01`. Following the Cb plane is the Cr plane, just like the Cb
+plane.
+
+If the Y plane has pad bytes after each row, then the Cr and Cb planes
+have half as many pad bytes after their rows. In other words, two Cx
+rows (including padding) is exactly as long as one Y row (including
+padding).
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  Y'\ :sub:`00`
+
+       -  Y'\ :sub:`01`
+
+       -  Y'\ :sub:`02`
+
+       -  Y'\ :sub:`03`
+
+    -  .. row 2
+
+       -  start + 4:
+
+       -  Y'\ :sub:`10`
+
+       -  Y'\ :sub:`11`
+
+       -  Y'\ :sub:`12`
+
+       -  Y'\ :sub:`13`
+
+    -  .. row 3
+
+       -  start + 8:
+
+       -  Y'\ :sub:`20`
+
+       -  Y'\ :sub:`21`
+
+       -  Y'\ :sub:`22`
+
+       -  Y'\ :sub:`23`
+
+    -  .. row 4
+
+       -  start + 12:
+
+       -  Y'\ :sub:`30`
+
+       -  Y'\ :sub:`31`
+
+       -  Y'\ :sub:`32`
+
+       -  Y'\ :sub:`33`
+
+    -  .. row 5
+
+       -  start + 16:
+
+       -  Cb\ :sub:`00`
+
+       -  Cb\ :sub:`01`
+
+    -  .. row 6
+
+       -  start + 18:
+
+       -  Cb\ :sub:`10`
+
+       -  Cb\ :sub:`11`
+
+    -  .. row 7
+
+       -  start + 20:
+
+       -  Cb\ :sub:`20`
+
+       -  Cb\ :sub:`21`
+
+    -  .. row 8
+
+       -  start + 22:
+
+       -  Cb\ :sub:`30`
+
+       -  Cb\ :sub:`31`
+
+    -  .. row 9
+
+       -  start + 24:
+
+       -  Cr\ :sub:`00`
+
+       -  Cr\ :sub:`01`
+
+    -  .. row 10
+
+       -  start + 26:
+
+       -  Cr\ :sub:`10`
+
+       -  Cr\ :sub:`11`
+
+    -  .. row 11
+
+       -  start + 28:
+
+       -  Cr\ :sub:`20`
+
+       -  Cr\ :sub:`21`
+
+    -  .. row 12
+
+       -  start + 30:
+
+       -  Cr\ :sub:`30`
+
+       -  Cr\ :sub:`31`
+
+
+**Color Sample Location..**
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  
+       -  0
+
+       -  
+       -  1
+
+       -  
+       -  2
+
+       -  
+       -  3
+
+    -  .. row 2
+
+       -  0
+
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+    -  .. row 3
+
+       -  1
+
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+    -  .. row 4
+
+       -  2
+
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+    -  .. row 5
+
+       -  3
+
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-yuv444m.rst b/Documentation/linux_tv/media/v4l/pixfmt-yuv444m.rst
new file mode 100644
index 000000000000..3d25c5e0ca00
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-yuv444m.rst
@@ -0,0 +1,294 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-YUV444M:
+
+************************************************************
+V4L2_PIX_FMT_YUV444M ('YM24'), V4L2_PIX_FMT_YVU444M ('YM42')
+************************************************************
+
+*man V4L2_PIX_FMT_YUV444M(2)*
+
+V4L2_PIX_FMT_YVU444M
+Planar formats with full horizontal resolution, also known as YUV and
+YVU 4:4:4
+
+
+Description
+===========
+
+This is a multi-planar format, as opposed to a packed format. The three
+components are separated into three sub-images or planes.
+
+The Y plane is first. The Y plane has one byte per pixel. For
+``V4L2_PIX_FMT_YUV444M`` the Cb data constitutes the second plane which
+is the same width and height as the Y plane (and as the image). The Cr
+data, just like the Cb plane, is in the third plane.
+
+``V4L2_PIX_FMT_YVU444M`` is the same except the Cr data is stored in the
+second plane and the Cb data in the third plane.
+
+If the Y plane has pad bytes after each row, then the Cb and Cr planes
+have the same number of pad bytes after their rows.
+
+``V4L2_PIX_FMT_YUV444M`` and ``V4L2_PIX_FMT_YUV444M`` are intended to be
+used only in drivers and applications that support the multi-planar API,
+described in :ref:`planar-apis`.
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start0 + 0:
+
+       -  Y'\ :sub:`00`
+
+       -  Y'\ :sub:`01`
+
+       -  Y'\ :sub:`02`
+
+       -  Y'\ :sub:`03`
+
+    -  .. row 2
+
+       -  start0 + 4:
+
+       -  Y'\ :sub:`10`
+
+       -  Y'\ :sub:`11`
+
+       -  Y'\ :sub:`12`
+
+       -  Y'\ :sub:`13`
+
+    -  .. row 3
+
+       -  start0 + 8:
+
+       -  Y'\ :sub:`20`
+
+       -  Y'\ :sub:`21`
+
+       -  Y'\ :sub:`22`
+
+       -  Y'\ :sub:`23`
+
+    -  .. row 4
+
+       -  start0 + 12:
+
+       -  Y'\ :sub:`30`
+
+       -  Y'\ :sub:`31`
+
+       -  Y'\ :sub:`32`
+
+       -  Y'\ :sub:`33`
+
+    -  .. row 5
+
+       -  
+
+    -  .. row 6
+
+       -  start1 + 0:
+
+       -  Cb\ :sub:`00`
+
+       -  Cb\ :sub:`01`
+
+       -  Cb\ :sub:`02`
+
+       -  Cb\ :sub:`03`
+
+    -  .. row 7
+
+       -  start1 + 4:
+
+       -  Cb\ :sub:`10`
+
+       -  Cb\ :sub:`11`
+
+       -  Cb\ :sub:`12`
+
+       -  Cb\ :sub:`13`
+
+    -  .. row 8
+
+       -  start1 + 8:
+
+       -  Cb\ :sub:`20`
+
+       -  Cb\ :sub:`21`
+
+       -  Cb\ :sub:`22`
+
+       -  Cb\ :sub:`23`
+
+    -  .. row 9
+
+       -  start1 + 12:
+
+       -  Cb\ :sub:`20`
+
+       -  Cb\ :sub:`21`
+
+       -  Cb\ :sub:`32`
+
+       -  Cb\ :sub:`33`
+
+    -  .. row 10
+
+       -  
+
+    -  .. row 11
+
+       -  start2 + 0:
+
+       -  Cr\ :sub:`00`
+
+       -  Cr\ :sub:`01`
+
+       -  Cr\ :sub:`02`
+
+       -  Cr\ :sub:`03`
+
+    -  .. row 12
+
+       -  start2 + 4:
+
+       -  Cr\ :sub:`10`
+
+       -  Cr\ :sub:`11`
+
+       -  Cr\ :sub:`12`
+
+       -  Cr\ :sub:`13`
+
+    -  .. row 13
+
+       -  start2 + 8:
+
+       -  Cr\ :sub:`20`
+
+       -  Cr\ :sub:`21`
+
+       -  Cr\ :sub:`22`
+
+       -  Cr\ :sub:`23`
+
+    -  .. row 14
+
+       -  start2 + 12:
+
+       -  Cr\ :sub:`30`
+
+       -  Cr\ :sub:`31`
+
+       -  Cr\ :sub:`32`
+
+       -  Cr\ :sub:`33`
+
+
+**Color Sample Location..**
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  
+       -  0
+
+       -  
+       -  1
+
+       -  
+       -  2
+
+       -  
+       -  3
+
+    -  .. row 2
+
+       -  0
+
+       -  YC
+
+       -  
+       -  YC
+
+       -  
+       -  YC
+
+       -  
+       -  YC
+
+    -  .. row 3
+
+       -  1
+
+       -  YC
+
+       -  
+       -  YC
+
+       -  
+       -  YC
+
+       -  
+       -  YC
+
+    -  .. row 4
+
+       -  2
+
+       -  YC
+
+       -  
+       -  YC
+
+       -  
+       -  YC
+
+       -  
+       -  YC
+
+    -  .. row 5
+
+       -  3
+
+       -  YC
+
+       -  
+       -  YC
+
+       -  
+       -  YC
+
+       -  
+       -  YC
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-yuyv.rst b/Documentation/linux_tv/media/v4l/pixfmt-yuyv.rst
new file mode 100644
index 000000000000..2fed9b3c87c3
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-yuyv.rst
@@ -0,0 +1,217 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-YUYV:
+
+**************************
+V4L2_PIX_FMT_YUYV ('YUYV')
+**************************
+
+*man V4L2_PIX_FMT_YUYV(2)*
+
+Packed format with ½ horizontal chroma resolution, also known as YUV
+4:2:2
+
+
+Description
+===========
+
+In this format each four bytes is two pixels. Each four bytes is two
+Y's, a Cb and a Cr. Each Y goes to one of the pixels, and the Cb and Cr
+belong to both pixels. As you can see, the Cr and Cb components have
+half the horizontal resolution of the Y component. ``V4L2_PIX_FMT_YUYV``
+is known in the Windows environment as YUY2.
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  Y'\ :sub:`00`
+
+       -  Cb\ :sub:`00`
+
+       -  Y'\ :sub:`01`
+
+       -  Cr\ :sub:`00`
+
+       -  Y'\ :sub:`02`
+
+       -  Cb\ :sub:`01`
+
+       -  Y'\ :sub:`03`
+
+       -  Cr\ :sub:`01`
+
+    -  .. row 2
+
+       -  start + 8:
+
+       -  Y'\ :sub:`10`
+
+       -  Cb\ :sub:`10`
+
+       -  Y'\ :sub:`11`
+
+       -  Cr\ :sub:`10`
+
+       -  Y'\ :sub:`12`
+
+       -  Cb\ :sub:`11`
+
+       -  Y'\ :sub:`13`
+
+       -  Cr\ :sub:`11`
+
+    -  .. row 3
+
+       -  start + 16:
+
+       -  Y'\ :sub:`20`
+
+       -  Cb\ :sub:`20`
+
+       -  Y'\ :sub:`21`
+
+       -  Cr\ :sub:`20`
+
+       -  Y'\ :sub:`22`
+
+       -  Cb\ :sub:`21`
+
+       -  Y'\ :sub:`23`
+
+       -  Cr\ :sub:`21`
+
+    -  .. row 4
+
+       -  start + 24:
+
+       -  Y'\ :sub:`30`
+
+       -  Cb\ :sub:`30`
+
+       -  Y'\ :sub:`31`
+
+       -  Cr\ :sub:`30`
+
+       -  Y'\ :sub:`32`
+
+       -  Cb\ :sub:`31`
+
+       -  Y'\ :sub:`33`
+
+       -  Cr\ :sub:`31`
+
+
+**Color Sample Location..**
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  
+       -  0
+
+       -  
+       -  1
+
+       -  
+       -  2
+
+       -  
+       -  3
+
+    -  .. row 2
+
+       -  0
+
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+    -  .. row 3
+
+       -  1
+
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+    -  .. row 4
+
+       -  2
+
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+    -  .. row 5
+
+       -  3
+
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-yvyu.rst b/Documentation/linux_tv/media/v4l/pixfmt-yvyu.rst
new file mode 100644
index 000000000000..40eb6eda9fb1
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-yvyu.rst
@@ -0,0 +1,216 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-YVYU:
+
+**************************
+V4L2_PIX_FMT_YVYU ('YVYU')
+**************************
+
+*man V4L2_PIX_FMT_YVYU(2)*
+
+Variation of ``V4L2_PIX_FMT_YUYV`` with different order of samples in
+memory
+
+
+Description
+===========
+
+In this format each four bytes is two pixels. Each four bytes is two
+Y's, a Cb and a Cr. Each Y goes to one of the pixels, and the Cb and Cr
+belong to both pixels. As you can see, the Cr and Cb components have
+half the horizontal resolution of the Y component.
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  Y'\ :sub:`00`
+
+       -  Cr\ :sub:`00`
+
+       -  Y'\ :sub:`01`
+
+       -  Cb\ :sub:`00`
+
+       -  Y'\ :sub:`02`
+
+       -  Cr\ :sub:`01`
+
+       -  Y'\ :sub:`03`
+
+       -  Cb\ :sub:`01`
+
+    -  .. row 2
+
+       -  start + 8:
+
+       -  Y'\ :sub:`10`
+
+       -  Cr\ :sub:`10`
+
+       -  Y'\ :sub:`11`
+
+       -  Cb\ :sub:`10`
+
+       -  Y'\ :sub:`12`
+
+       -  Cr\ :sub:`11`
+
+       -  Y'\ :sub:`13`
+
+       -  Cb\ :sub:`11`
+
+    -  .. row 3
+
+       -  start + 16:
+
+       -  Y'\ :sub:`20`
+
+       -  Cr\ :sub:`20`
+
+       -  Y'\ :sub:`21`
+
+       -  Cb\ :sub:`20`
+
+       -  Y'\ :sub:`22`
+
+       -  Cr\ :sub:`21`
+
+       -  Y'\ :sub:`23`
+
+       -  Cb\ :sub:`21`
+
+    -  .. row 4
+
+       -  start + 24:
+
+       -  Y'\ :sub:`30`
+
+       -  Cr\ :sub:`30`
+
+       -  Y'\ :sub:`31`
+
+       -  Cb\ :sub:`30`
+
+       -  Y'\ :sub:`32`
+
+       -  Cr\ :sub:`31`
+
+       -  Y'\ :sub:`33`
+
+       -  Cb\ :sub:`31`
+
+
+**Color Sample Location..**
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  
+       -  0
+
+       -  
+       -  1
+
+       -  
+       -  2
+
+       -  
+       -  3
+
+    -  .. row 2
+
+       -  0
+
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+    -  .. row 3
+
+       -  1
+
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+    -  .. row 4
+
+       -  2
+
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+    -  .. row 5
+
+       -  3
+
+       -  Y
+
+       -  C
+
+       -  Y
+
+       -  
+       -  Y
+
+       -  C
+
+       -  Y
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt-z16.rst b/Documentation/linux_tv/media/v4l/pixfmt-z16.rst
new file mode 100644
index 000000000000..25badab393ce
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt-z16.rst
@@ -0,0 +1,123 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _V4L2-PIX-FMT-Z16:
+
+*************************
+V4L2_PIX_FMT_Z16 ('Z16 ')
+*************************
+
+*man V4L2_PIX_FMT_Z16(2)*
+
+Interleaved grey-scale image, e.g. from a stereo-pair
+
+
+Description
+===========
+
+This is a 16-bit format, representing depth data. Each pixel is a
+distance to the respective point in the image coordinates. Distance unit
+can vary and has to be negotiated with the device separately. Each pixel
+is stored in a 16-bit word in the little endian byte order.
+
+**Byte Order..**
+
+Each cell is one byte.
+
+
+
+.. flat-table::
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       2 1 1 1 1 1 1 1 1
+
+
+    -  .. row 1
+
+       -  start + 0:
+
+       -  Z\ :sub:`00low`
+
+       -  Z\ :sub:`00high`
+
+       -  Z\ :sub:`01low`
+
+       -  Z\ :sub:`01high`
+
+       -  Z\ :sub:`02low`
+
+       -  Z\ :sub:`02high`
+
+       -  Z\ :sub:`03low`
+
+       -  Z\ :sub:`03high`
+
+    -  .. row 2
+
+       -  start + 8:
+
+       -  Z\ :sub:`10low`
+
+       -  Z\ :sub:`10high`
+
+       -  Z\ :sub:`11low`
+
+       -  Z\ :sub:`11high`
+
+       -  Z\ :sub:`12low`
+
+       -  Z\ :sub:`12high`
+
+       -  Z\ :sub:`13low`
+
+       -  Z\ :sub:`13high`
+
+    -  .. row 3
+
+       -  start + 16:
+
+       -  Z\ :sub:`20low`
+
+       -  Z\ :sub:`20high`
+
+       -  Z\ :sub:`21low`
+
+       -  Z\ :sub:`21high`
+
+       -  Z\ :sub:`22low`
+
+       -  Z\ :sub:`22high`
+
+       -  Z\ :sub:`23low`
+
+       -  Z\ :sub:`23high`
+
+    -  .. row 4
+
+       -  start + 24:
+
+       -  Z\ :sub:`30low`
+
+       -  Z\ :sub:`30high`
+
+       -  Z\ :sub:`31low`
+
+       -  Z\ :sub:`31high`
+
+       -  Z\ :sub:`32low`
+
+       -  Z\ :sub:`32high`
+
+       -  Z\ :sub:`33low`
+
+       -  Z\ :sub:`33high`
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/pixfmt.rst b/Documentation/linux_tv/media/v4l/pixfmt.rst
new file mode 100644
index 000000000000..f5148ac6d781
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/pixfmt.rst
@@ -0,0 +1,46 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _pixfmt:
+
+#############
+Image Formats
+#############
+The V4L2 API was primarily designed for devices exchanging image data
+with applications. The :c:type:`struct v4l2_pix_format` and
+:c:type:`struct v4l2_pix_format_mplane` structures define the
+format and layout of an image in memory. The former is used with the
+single-planar API, while the latter is used with the multi-planar
+version (see :ref:`planar-apis`). Image formats are negotiated with
+the :ref:`VIDIOC_S_FMT <vidioc-g-fmt>` ioctl. (The explanations here
+focus on video capturing and output, for overlay frame buffer formats
+see also :ref:`VIDIOC_G_FBUF <vidioc-g-fbuf>`.)
+
+
+.. toctree::
+    :maxdepth: 1
+
+    pixfmt-002
+    pixfmt-003
+    pixfmt-004
+    colorspaces
+    pixfmt-006
+    pixfmt-007
+    pixfmt-008
+    pixfmt-indexed
+    pixfmt-rgb
+    yuv-formats
+    depth-formats
+    pixfmt-013
+    sdr-formats
+    pixfmt-reserved
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/planar-apis.rst b/Documentation/linux_tv/media/v4l/planar-apis.rst
new file mode 100644
index 000000000000..4c01adcbf525
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/planar-apis.rst
@@ -0,0 +1,74 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _planar-apis:
+
+*****************************
+Single- and multi-planar APIs
+*****************************
+
+Some devices require data for each input or output video frame to be
+placed in discontiguous memory buffers. In such cases, one video frame
+has to be addressed using more than one memory address, i.e. one pointer
+per "plane". A plane is a sub-buffer of the current frame. For examples
+of such formats see :ref:`pixfmt`.
+
+Initially, V4L2 API did not support multi-planar buffers and a set of
+extensions has been introduced to handle them. Those extensions
+constitute what is being referred to as the "multi-planar API".
+
+Some of the V4L2 API calls and structures are interpreted differently,
+depending on whether single- or multi-planar API is being used. An
+application can choose whether to use one or the other by passing a
+corresponding buffer type to its ioctl calls. Multi-planar versions of
+buffer types are suffixed with an `_MPLANE' string. For a list of
+available multi-planar buffer types see enum
+:ref:`v4l2_buf_type <v4l2-buf-type>`.
+
+
+Multi-planar formats
+====================
+
+Multi-planar API introduces new multi-planar formats. Those formats use
+a separate set of FourCC codes. It is important to distinguish between
+the multi-planar API and a multi-planar format. Multi-planar API calls
+can handle all single-planar formats as well (as long as they are passed
+in multi-planar API structures), while the single-planar API cannot
+handle multi-planar formats.
+
+
+Calls that distinguish between single and multi-planar APIs
+===========================================================
+
+:ref:`VIDIOC_QUERYCAP <vidioc-querycap>`
+    Two additional multi-planar capabilities are added. They can be set
+    together with non-multi-planar ones for devices that handle both
+    single- and multi-planar formats.
+
+:ref:`VIDIOC_G_FMT <vidioc-g-fmt>`,
+:ref:`VIDIOC_S_FMT <vidioc-g-fmt>`,
+:ref:`VIDIOC_TRY_FMT <vidioc-g-fmt>`
+    New structures for describing multi-planar formats are added: struct
+    :ref:`v4l2_pix_format_mplane <v4l2-pix-format-mplane>` and
+    struct :ref:`v4l2_plane_pix_format <v4l2-plane-pix-format>`.
+    Drivers may define new multi-planar formats, which have distinct
+    FourCC codes from the existing single-planar ones.
+
+:ref:`VIDIOC_QBUF <vidioc-qbuf>`,
+:ref:`VIDIOC_DQBUF <vidioc-qbuf>`,
+:ref:`VIDIOC_QUERYBUF <vidioc-querybuf>`
+    A new struct :ref:`v4l2_plane <v4l2-plane>` structure for
+    describing planes is added. Arrays of this structure are passed in
+    the new ``m.planes`` field of struct
+    :ref:`v4l2_buffer <v4l2-buffer>`.
+
+:ref:`VIDIOC_REQBUFS <vidioc-reqbufs>`
+    Will allocate multi-planar buffers as requested.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/querycap.rst b/Documentation/linux_tv/media/v4l/querycap.rst
new file mode 100644
index 000000000000..2568820a3954
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/querycap.rst
@@ -0,0 +1,43 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _querycap:
+
+*********************
+Querying Capabilities
+*********************
+
+Because V4L2 covers a wide variety of devices not all aspects of the API
+are equally applicable to all types of devices. Furthermore devices of
+the same type have different capabilities and this specification permits
+the omission of a few complicated and less important parts of the API.
+
+The :ref:`VIDIOC_QUERYCAP <vidioc-querycap>` ioctl is available to
+check if the kernel device is compatible with this specification, and to
+query the :ref:`functions <devices>` and :ref:`I/O methods <io>`
+supported by the device.
+
+Starting with kernel version 3.1, VIDIOC-QUERYCAP will return the V4L2
+API version used by the driver, with generally matches the Kernel
+version. There's no need of using
+:ref:`VIDIOC_QUERYCAP <vidioc-querycap>` to check if a specific ioctl
+is supported, the V4L2 core now returns ENOTTY if a driver doesn't
+provide support for an ioctl.
+
+Other features can be queried by calling the respective ioctl, for
+example :ref:`VIDIOC_ENUMINPUT <vidioc-enuminput>` to learn about the
+number, types and names of video connectors on the device. Although
+abstraction is a major objective of this API, the
+:ref:`VIDIOC_QUERYCAP <vidioc-querycap>` ioctl also allows driver
+specific applications to reliably identify the driver.
+
+All V4L2 drivers must support ``VIDIOC_QUERYCAP``. Applications should
+always call this ioctl after opening the device.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/remote_controllers.rst b/Documentation/linux_tv/media/v4l/remote_controllers.rst
new file mode 100644
index 000000000000..07add9452be2
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/remote_controllers.rst
@@ -0,0 +1,53 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _remotes:
+
+#####################
+Remote Controller API
+#####################
+
+.. _remote_controllers:
+
+******************
+Remote Controllers
+******************
+
+
+.. toctree::
+    :maxdepth: 1
+
+    Remote_controllers_Intro
+    remote_controllers_sysfs_nodes
+    Remote_controllers_tables
+    Remote_controllers_table_change
+    lirc_device_interface
+
+
+**********************
+Revision and Copyright
+**********************
+
+
+:author:    Chehab Mauro (*Carvalho*)
+:address:   m.chehab@samsung.com
+:contrib:   Initial version.
+
+**Copyright** 2009-2014 : Mauro Carvalho Chehab
+
+:revision: 3.15 / 2014-02-06 (*mcc*)
+
+Added the interface description and the RC sysfs class description.
+
+
+:revision: 1.0 / 2009-09-06 (*mcc*)
+
+Initial revision
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/remote_controllers_sysfs_nodes.rst b/Documentation/linux_tv/media/v4l/remote_controllers_sysfs_nodes.rst
new file mode 100644
index 000000000000..e2fb81144a4d
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/remote_controllers_sysfs_nodes.rst
@@ -0,0 +1,152 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _remote_controllers_sysfs_nodes:
+
+*******************************
+Remote Controller's sysfs nodes
+*******************************
+
+As defined at ``Documentation/ABI/testing/sysfs-class-rc``, those are
+the sysfs nodes that control the Remote Controllers:
+
+
+.. _sys_class_rc:
+
+/sys/class/rc/
+==============
+
+The ``/sys/class/rc/`` class sub-directory belongs to the Remote
+Controller core and provides a sysfs interface for configuring infrared
+remote controller receivers.
+
+
+.. _sys_class_rc_rcN:
+
+/sys/class/rc/rcN/
+==================
+
+A ``/sys/class/rc/rcN`` directory is created for each remote control
+receiver device where N is the number of the receiver.
+
+
+.. _sys_class_rc_rcN_protocols:
+
+/sys/class/rc/rcN/protocols
+===========================
+
+Reading this file returns a list of available protocols, something like:
+
+``rc5 [rc6] nec jvc [sony]``
+
+Enabled protocols are shown in [] brackets.
+
+Writing "+proto" will add a protocol to the list of enabled protocols.
+
+Writing "-proto" will remove a protocol from the list of enabled
+protocols.
+
+Writing "proto" will enable only "proto".
+
+Writing "none" will disable all protocols.
+
+Write fails with EINVAL if an invalid protocol combination or unknown
+protocol name is used.
+
+
+.. _sys_class_rc_rcN_filter:
+
+/sys/class/rc/rcN/filter
+========================
+
+Sets the scancode filter expected value.
+
+Use in combination with ``/sys/class/rc/rcN/filter_mask`` to set the
+expected value of the bits set in the filter mask. If the hardware
+supports it then scancodes which do not match the filter will be
+ignored. Otherwise the write will fail with an error.
+
+This value may be reset to 0 if the current protocol is altered.
+
+
+.. _sys_class_rc_rcN_filter_mask:
+
+/sys/class/rc/rcN/filter_mask
+=============================
+
+Sets the scancode filter mask of bits to compare. Use in combination
+with ``/sys/class/rc/rcN/filter`` to set the bits of the scancode which
+should be compared against the expected value. A value of 0 disables the
+filter to allow all valid scancodes to be processed.
+
+If the hardware supports it then scancodes which do not match the filter
+will be ignored. Otherwise the write will fail with an error.
+
+This value may be reset to 0 if the current protocol is altered.
+
+
+.. _sys_class_rc_rcN_wakeup_protocols:
+
+/sys/class/rc/rcN/wakeup_protocols
+==================================
+
+Reading this file returns a list of available protocols to use for the
+wakeup filter, something like:
+
+``rc5 rc6 nec jvc [sony]``
+
+The enabled wakeup protocol is shown in [] brackets.
+
+Writing "+proto" will add a protocol to the list of enabled wakeup
+protocols.
+
+Writing "-proto" will remove a protocol from the list of enabled wakeup
+protocols.
+
+Writing "proto" will use "proto" for wakeup events.
+
+Writing "none" will disable wakeup.
+
+Write fails with EINVAL if an invalid protocol combination or unknown
+protocol name is used, or if wakeup is not supported by the hardware.
+
+
+.. _sys_class_rc_rcN_wakeup_filter:
+
+/sys/class/rc/rcN/wakeup_filter
+===============================
+
+Sets the scancode wakeup filter expected value. Use in combination with
+``/sys/class/rc/rcN/wakeup_filter_mask`` to set the expected value of
+the bits set in the wakeup filter mask to trigger a system wake event.
+
+If the hardware supports it and wakeup_filter_mask is not 0 then
+scancodes which match the filter will wake the system from e.g. suspend
+to RAM or power off. Otherwise the write will fail with an error.
+
+This value may be reset to 0 if the wakeup protocol is altered.
+
+
+.. _sys_class_rc_rcN_wakeup_filter_mask:
+
+/sys/class/rc/rcN/wakeup_filter_mask
+====================================
+
+Sets the scancode wakeup filter mask of bits to compare. Use in
+combination with ``/sys/class/rc/rcN/wakeup_filter`` to set the bits of
+the scancode which should be compared against the expected value to
+trigger a system wake event.
+
+If the hardware supports it and wakeup_filter_mask is not 0 then
+scancodes which match the filter will wake the system from e.g. suspend
+to RAM or power off. Otherwise the write will fail with an error.
+
+This value may be reset to 0 if the wakeup protocol is altered.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/rw.rst b/Documentation/linux_tv/media/v4l/rw.rst
new file mode 100644
index 000000000000..c123d3a1bfbb
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/rw.rst
@@ -0,0 +1,56 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _rw:
+
+**********
+Read/Write
+**********
+
+Input and output devices support the :c:func:`read()` and
+:c:func:`write()` function, respectively, when the
+``V4L2_CAP_READWRITE`` flag in the ``capabilities`` field of struct
+:ref:`v4l2_capability <v4l2-capability>` returned by the
+:ref:`VIDIOC_QUERYCAP <vidioc-querycap>` ioctl is set.
+
+Drivers may need the CPU to copy the data, but they may also support DMA
+to or from user memory, so this I/O method is not necessarily less
+efficient than other methods merely exchanging buffer pointers. It is
+considered inferior though because no meta-information like frame
+counters or timestamps are passed. This information is necessary to
+recognize frame dropping and to synchronize with other data streams.
+However this is also the simplest I/O method, requiring little or no
+setup to exchange data. It permits command line stunts like this (the
+vidctrl tool is fictitious):
+
+
+
+::
+
+    > vidctrl /dev/video --input=0 --format=YUYV --size=352x288
+    > dd if=/dev/video of=myimage.422 bs=202752 count=1
+To read from the device applications use the :ref:`read() <func-read>`
+function, to write the :ref:`write() <func-write>` function. Drivers
+must implement one I/O method if they exchange data with applications,
+but it need not be this. [1]_ When reading or writing is supported, the
+driver must also support the :ref:`select() <func-select>` and
+:ref:`poll() <func-poll>` function. [2]_
+
+.. [1]
+   It would be desirable if applications could depend on drivers
+   supporting all I/O interfaces, but as much as the complex memory
+   mapping I/O can be inadequate for some devices we have no reason to
+   require this interface, which is most useful for simple applications
+   capturing still images.
+
+.. [2]
+   At the driver level :c:func:`select()` and :c:func:`poll()` are
+   the same, and :c:func:`select()` is too important to be optional.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/sdr-formats.rst b/Documentation/linux_tv/media/v4l/sdr-formats.rst
new file mode 100644
index 000000000000..78c373c5b678
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/sdr-formats.rst
@@ -0,0 +1,30 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _sdr-formats:
+
+***********
+SDR Formats
+***********
+
+These formats are used for :ref:`SDR <sdr>` interface only.
+
+
+.. toctree::
+    :maxdepth: 1
+
+    pixfmt-sdr-cu08
+    pixfmt-sdr-cu16le
+    pixfmt-sdr-cs08
+    pixfmt-sdr-cs14le
+    pixfmt-sdr-ru12le
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/selection-api-002.rst b/Documentation/linux_tv/media/v4l/selection-api-002.rst
new file mode 100644
index 000000000000..d1b2bc3d22e5
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/selection-api-002.rst
@@ -0,0 +1,37 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+************
+Introduction
+************
+
+Some video capture devices can sample a subsection of a picture and
+shrink or enlarge it to an image of arbitrary size. Next, the devices
+can insert the image into larger one. Some video output devices can crop
+part of an input image, scale it up or down and insert it at an
+arbitrary scan line and horizontal offset into a video signal. We call
+these abilities cropping, scaling and composing.
+
+On a video *capture* device the source is a video signal, and the
+cropping target determine the area actually sampled. The sink is an
+image stored in a memory buffer. The composing area specifies which part
+of the buffer is actually written to by the hardware.
+
+On a video *output* device the source is an image in a memory buffer,
+and the cropping target is a part of an image to be shown on a display.
+The sink is the display or the graphics screen. The application may
+select the part of display where the image should be displayed. The size
+and position of such a window is controlled by the compose target.
+
+Rectangles for all cropping and composing targets are defined even if
+the device does supports neither cropping nor composing. Their size and
+position will be fixed in such a case. If the device does not support
+scaling then the cropping and composing rectangles have the same size.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/selection-api-003.rst b/Documentation/linux_tv/media/v4l/selection-api-003.rst
new file mode 100644
index 000000000000..9769d87407aa
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/selection-api-003.rst
@@ -0,0 +1,29 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+*****************
+Selection targets
+*****************
+
+
+.. _sel-targets-capture:
+
+.. figure::  selection-api-003_files/selection.*
+    :alt:    selection.png
+    :align:  center
+
+    Cropping and composing targets
+
+    Targets used by a cropping, composing and scaling process
+
+
+
+See :ref:`v4l2-selection-targets` for more information.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/selection-api-003_files/selection.png b/Documentation/linux_tv/media/v4l/selection-api-003_files/selection.png
new file mode 100644
index 0000000000000000000000000000000000000000..bfc523eae570a1edd822a23891b4a499eb9403e1
GIT binary patch
literal 11716
zcmb_?c{r3``1iqJls!b*C6h>svKwTNMkt|dm1VMI4Ph*mkT#*ROtP0PjO?OP$QDMn
zv{=GWmXZBE&-i|S%X?kF>;3)lUR_<|InQ(MbDwiQ_vc>Dxs5Z`XWOx72LOQ0(BQ;r
z08p_2(EUO)!4~@1nq>Gx=W|+L8x*z+{(=uoj>h^Yz!vh4Sex?@wy<~^obv&I{VnpJ
z?$JT^y|9tl*U&_ld2lD1Qyg8&bfgmiQDAsN%i`JqWqA7jpb{Sw&ZR}{B%i8snfBR<
z(T|SaqnpK&FM7pU9)Rd(Wy`|h5=jm0X?l(G5lOC3vY|u(#G>jI=#W1G8pV+x;V50?
zM-2@%2H+YeAM*0Is0=;)8P&2v!JmdE4ihkFdnl=weDbreOJK*`-E&_Dj=e09&{vg_
z4f|DVGqOBeZd_#OH$(CWn~_%wItjo=Bj4%`n>D=6NP0#GI#(v*iqNfEyYbq&!GYio
zkBaAm<ms!-U~y;gm*ZMoFU`-Pm}NH}T&=YAx9nG|pPQ5ulb`Nidsju;vLOW<SC1+A
z%TIq@IB40X%m5~L$M?w%RTWxnNNI7sH9Lo5RAs51o9^B{JFwe_Lg5=M>HG$u=;@i=
zEHR>K#c0#Njxie%vVSB)^_nrqT=KGX#`=x`Z2j+{B|*wvmKgiJ4qPdVSyqm-Plu-Y
z6;E_kBHddTcbYF&qjZZ?m1BWjoq&p@jjFkdEFgqBtZk@G-e?ieoisi;k#si3@9pN1
zKBISCAvWn1XPN0ir`*d@I~O;A(YHcLMQ>!Zu0*faPA6v{FjQWeOl=@*LK)9OzpV!u
zRUD6NcXz=)kfZR`Uz=Mi9xEXMP&O>r^EJ}1QT)RqW5U9cB+2!Z)UzZzw>}k46@J+D
zoAO4ZdTU69`l?THo4X6HVPUt~ZFZePznP8hyBp=dUK(<d`<_eC!G+5HwR?Q3h!R+D
z(`}#DB5rU6KWg?p_TZSx?A)NW$NFk)`*e}AJSEXlz=pc8vVotzuoes#23P;vRyqz@
zI_>~^k}o=Fc&;)eZ1-zH_X>;D`^nzF`YB(lKdDFqqMeda{o%7=?j1)^dcRW#J4GWa
zrF7nIR{8!UKTesBUg16;Ed9RArp_^~>i!gq)7-#YSv<0WPeQ*vZr+#um06<tq~0+I
zGO(Wg3Jre<%nn@0Bgg+9o{`1>t)nJ_?>yT>yYB$N`!w5iNwK;~T!;=3-?y_(bZMdp
z8Z$d$eIc-ukD8dHS7QP0k?hyDTOK;q!yeXq!H3zPTDPd|pyv_dz~wRAdhp@<XO39l
zRdrWLvnp`Up8uzIqpmIh@El*hm{=*5>mInVfKN*MaBR7%Jm>w}Lr0f_<FA~ZQCSv@
z<Z=JIx|;Q)iWD+Oa>Copx|$Qxa-rc7bF;!%tHTCYS4&A@9sX%08}e&sfB4hk;#<T)
zm3N51=ulcHZ{5})<&)gIxlMQ1b47E3p_C0j^6|)m%1bjV%auzVlppu0K^0;0gY`>(
zi=G8j6N;HuK^q%iH44e^+#V(`)s!yQk;i7gv}YMTR)3@!eC12C`gBqG5$9R{ynXb4
zbuV#&;cM*2M;MR!h_#=_DO9{9FMqXLULBaI4`Vw&Qair%bs}+Z^=3JBpn6@_y)0mD
z@>Cnep@goj8*hA*wUV^Z)|ug3t--9g?Dygdy;4#!nsBIQ=XEO6E}NwCETi%B$xvqh
z*la<!@+&AHGbZ}1P2{~Sa`XD2ZTaab?BzNCzH5U?JN6PvD%se;<;>hrW$u)pg>@fG
z!klNA6B3T}tkewG$;cghJ8<;2|LtS_-m2$MGIn)SZh)VXGW7PCWt-aB3O(6RPQIDq
z<HKs&V(XQXc#}3kBmGS4&4Id~BOF#f92aNbG$rO|a4#^`?ljR$(VPghv(r%kExY*W
zu>0{3Eg9TfxW2dD(9@Sn)(GBmvO6e9pBoENG1*wX;@vmS7_+hLToT?fFx|I*aHM*q
zmUJl0b1zF<|1Q><z<nE~WYPV{8eX4zy}l|%_SYyXEq6-53u*5o_`r=O?(L{ZR^K|G
zf64va$dJ2B(Jt){_qpl%PqK2BHk5OrC-;txa16{}5AN!gpv;BUQ&*F7Ui22*`3#<$
zPEpGm^z#t%(dx3^%iuM1=}ETh!qY=ZIznE6AUjL<Io@NZq-tXQTJ-03PWwY@{cEeT
z3*5EAw(EVw%%0G9b(<eZ!so+I?k%jn{Hs56WSnc_HvRjnTXEIvn{&yV34_qrVBDr9
z#+Nl7jD%9Y-W{60%i=up=|@jXCFoRnqzkZ17JQ1`C2=nyU|S#uL#t>I`^RS0;C=y>
z2j1dW!25mhJs}<)36zWwXVP$4B+TyX=Eg)=MN?5&C}n6q@xt+n!h+V58)*`Qyrm=M
z%SG-J160}arRgJ%6=MtaHuL`9lpM@{ar8WXH9BEOh)-Z|meG6{M0y$Qdd`OAFiowi
z3(aHeBh3x_zbufmtfmK8zaLL-yxC~}N;VPuSWQmq-z>i;{Vv#A<8ttDQ+n2=_e@49
z`c@Y6-)+&mpgl}-I?R^mC5HV}$FCj2&;i2xX2pY+nnlmvc2Cc3k@#e0*jy7wmaB%;
z2P=7kWZb_Be6u?Fw2cywN8uIj)v>ae`hI<fw_{|QY<Oq){M^>D-J3E6&Zq3loC9t8
z%<!WM<XQS708|N(PYen3?QIy^I<)_=(ST=|&!BlcrL9(O&ST5^#Z-*)Wln8$m}>;R
zNbW(ct}d*D`-+Xnm{Ey3zBP9ECXf4OV6}SRdB<7+4o4JxYwVtO+H^lOWGLi4Gu$4G
z`}|qnxTG+^{X1XTv0NGHz^j)F51+H%oS^szS)Fb|DAvhXV5;WK0r%9QmErmL*(L!W
z?3l)}h^+Z2T}3<0-u*8QmCx>>`ccaBCOn|~Z(mSxm``j;KuqIB#sN$9g_`x`oER+`
z2d?Tg$G*2oEuTp*+~9}8KO$Mh+HGAFjx(QrP-6S;TW57nM!^ji>F6mjnfw)oD?d*3
zR+8;nt4L~!>;M>eP8XQU-!-!nWKd(|Sl)`?qk4r^B;I3ULB)qrS-v&(>7+Hkj?6CG
zq;;%1|Am(~_Tek+WM!9!(+8-Uy(&=#02KS2JhG5kDz`y-oZ~5L;=jH+FhIq(YCIYm
z4+x7FK8n`5WcE1r?=QaG%6y_kuQtB*Zr~mpkE{xZZIh{n9-@A2K<@7SQ-4<X2<z4d
zs4lm~S_Fwt6g0~$1v%+x?Xo2!8!H~j;u{~tcHA-1P8u_Cl)3xd;PuSmb`NI&l-#eE
z9)3J;>u0=E3rkt!_1Qa8T^V7m!qlS$p%v-u@L;T;;NUJ$&crX7K1wPp4Bo4L%U!Vo
z26h&zbzk@oUkTjkA`7!<x_v2<m^-By?i&+Rv?u?4|LhTy&t)qnNyccgsHfoy0N1b-
zkX!$JQ2S&2*qp}q4a`axqy5uzo3~NYGb%-)%g+zhZ>eT$W+CpA_>OMWxLDM{CEdwD
zmKNCwaSGGrp<|=hzMp%XVDnfRj^20cE2nUXt)>D$&tl-(%b>L=-4kgajzf0|6qmZv
z8`G1UpEYaL31Sh0?R-uC?JTPn6Npkhd<b#P*yoPYG5#xoU9T0s8H}z3tzDY6X|k>w
zHn&PxAGK4Y2O9xxLust{!mivuh^CKW)-B*dV#*Xndv!5R?`eT1yMTxc%f^g29uNA?
zhlabrTMoUQH?Xm%l!8myf+I3oHRGioEg6Oizdm+qM~rpwcOv56?OTaO5uz>~)I5yi
zU;J4dj|rmOZ?)os*YH+TK*~~)%QxWs&X{Ag!JJt6_OgdlXVZyjlx{E*+7d|25jUi6
z7s?X2xZgA`nHl2X)UQaZaU;6<vCo?Z`CgyaiY1~$!){ve@RaKz;uA#P241WQiAqVA
zkI2wLmJ?eQ{($qtX498+orsJkq@`h1)Buet`+ZIlW2B9AlHhpRwiC5DAGjZ5M3bV<
z{v-<9V2~adk&%h?=o}z^kaYlI8oL;EKe9mGh>3J}Innlm6WK(}PGpIH3R|GV!F<>(
zOUwggJ`E#uk%8eLUle0xj0{l}NhijMJ&Mx(g>>hSv1tUWVwe^k_zt@}3JWf-gbK)D
zb|BF^mXhi##tEE5nA!MwZXjX(=u7t3P+0Ctuv;e)gF?pB-w0+Ai#oh<{ny1?_^wZ!
z^mKD4KP$A=T{yIxS?&J)$P7+IZ<&?l_3&GqXu<<Mju>quQHV1{qdHS7rKNfG|Dbg1
zk#!F8)<ZAW|7x|r801^*8PAMmyr8r1TNm6{O+<#Q(hKg%u!kgOB5Wx_TAaD*>2Uo%
zS@)$Sw7OKG10mR&)=07fD=AFSDL8@RM{q>bINMA6Fi)hQ`mcA<(=~9SbX#F(>=s;U
z@M6|dul6iIOH3b2EODG;I(=?ybG~C0KT_-8F>n6Tc{;RE7Vln7Ci&$F*(GsR%O-`*
zleiA+pi$t8*BRVm)yM$sc-r_))8bK$Ystax`C}r19gium#)UU!WRD)h(fj-7Z`Os@
zQ+;mfXp4eLQlkNm2kNF6s-(#%UZT~Jh;?yYSq^);(=f5`q3Yon_oT`YY2GRHUHh!2
zMIL%y2^2k{WKAR@!z4-<_qZH;@z<QW%+`v3e*bT&alV)3l)$=;>ER%sik<g}NB6;x
z>)!AG+@tGvpXj3Mz-1vF@VlgJUE<rRY07+|P-5djI$j-Lp0C%1uSemjOQD+q!RuSo
zORJM*^x$p2BxbcH<QT6ooYIdsw&;ltiL&L8ta0oV#R_{HznnY4i3Yhf^_{=hbrl(D
zw)v4MDY)t0#B#4~FRIq|MJ0qD!5SSC&&8)DMKZNW4c;i{aI2UhPZzl0D~Nfb;yFhP
zlbS2HvVQpZ90vB88U{KGFwu(N#i#X-p;6*lll2YLHi>UZOm`%iYJ7YcS)3-9p2&SF
zM}b8>T*A#_wDhh8g;x^c9|z{0(p1hk7O$#!wGSV<*Lv=ePaz`^4Xn?epAy$HQ)v{>
z?Zh8`;8?73Tn=aaP(H^asbKmJTlYyXbpvMzJ%D4=GP8zX^>n*mEQx$qekq05?X8-B
z=xoW7v&ZotUdH^O;iP6>BO)yberMG-dX=Jx4{sA-_#*3YHpczqa6Ho*o1X`?8E~G9
zXG{zRWr1*u2@xShzsN^V<6j)+=E;(Ptt0W#&}cyPwh8ixjP8wwy9z{kX_6ZVDVamu
zOaOZzB0~)V^8^<?9r&FUX7%l1mp8vG%@jwCFF=)n=bddkoJ>UIeHfXTd0pkwLo-Bd
zu-ykZIQZc9bNktnCetURzdb+pADc^9q34CNu}j<b#tv;2#AT6oJaK)J|0TZfMJ!4;
z4BFvH$d|{vA#L6i!>q!%i&Ym6jXibYMW9=rg4=E4B!pEbTSXM)J{xq*2#j@mp;-a!
zMNMj6cdqXvGyDP{OUyV+Ea5Xm10Wnl$0WjspNP4EiR!Z}$<326L{V|z;xs`fRW|dI
zIO$hg4h4y!5V6=Iqci-yYM%Fr7??z=NWrB7dQzAHNQif!!2|Ggbs@6dVIO9|)C%=T
zUXBw|>z;CyZhA#WcB6y?7mqm7!_BMG_SKo)y+=IFOtj4KQM&h5BTH}?XdwXj-<3MT
ztmnLoM@T{@VnCzp2HZkWy$wS#WEF||@<z9Mbt5tqkbVqjF;Guj3K5f9pJEC>#TsQD
zOhoCr=E+3xh(u|Y({12{m;u%pl4>5L89>nL{T;m~fzl16RYnNoEHT|z_wLy@&L?dB
z^NbN7gf|}+QsXtjB_zVE3=VfLB4ZIDG=P2hZzpg$j&GZEVPysX_8+zd4ac7|>59?B
z+Fwg*m0USu6WTcNLCXv+w(eyJu#eeI<4ySiaJ?f;>uv8P8TQB8I!TlTj9!n(u!Ezp
zJ|90l88EmXOAm_-xW!w=(S^(&Ox7Xn`Kd?ayoEJA>wR_sQ4y`KvyI|}$8S~+MlMnB
zI-FV?yN&_|I=IEu;^<lCJ4_b*FYg9k*ZX2OAqMWXjCl(bo{~gpH!56cpVBS1{*ZVj
z4mvO(PNUw#_MTO>D<g;6wE*E#M8>5sSNb54NdXJ*_bZf|&!hnsKs1fW@RN=ON7(yy
zaAWsh$zElr2ZC3(ITo%e=CJ*4e?h!vN+k3-EHU3%V)-3Mo$p1_Ra3Q}(t{t|Jnqoe
zlpGr3kEv9Ll*@y|JG8p|8^v!5fIa-*tX-a;FT1nA2}B=RM`ZNv@8aX5<Ilx&P}o7I
zkXBbHoasa6DW+-qod9%mBe-zPeM6)>(6d}QT7?3ll3HC?HB<D!#MA5pu$c9YTFHAL
z{tk{6h-zw??SZ|G;&}Lb_oV#1vQ>F$=Y1%I6R~~A*Wuryc?HY-3Kl~{`xXOnIyUtl
zk-yQvUX{i^_POCJs^x6$!R&EvF4F^p)W9{AJ^<4+@67KZI<jV;;uPr<xu~JJ)4Fzq
z5x#5P28gs^<}#m48n5qS&&>!4+M@cxy}cjl%dkj|f9%5z>{%l+E((3(%s#L_mLQ(<
zg!u^5xfuas602B{vcB<Lvq432qJ|V5aNCD58VKYNgWlYoEv5m~md`!;c(r5>5aex-
z(I|=kgZ4YSP}%h7S&`yp3;@gioDqSb%SGZf5g>qe@X{Drs_)y34?hO?d#b7Y;x<~b
z58fyboL__GuuIz<^|&m-z_{aTJgK5K;@)5X?lS-k-VsD#nsNV4yq0)DYR+?R9%W5B
zV0}CY#}iSEZXnq1<@oGBzya(Z6DM~&aD5z0?yt&nXCj9RN3c`S;NC;xB!>eRlPUp!
zA($Spn&1{66-Q@U7j~MRKk+H@_drKS%Aiz#XCc4_Z&W6(?up2li_%q4y(ixpuA$1;
zv!J{abgF7~1;gMWU$U+9Jph$xguD#0-`y_onPp)5S{Mw+!KTup2L1#F09db-iF{(z
zorcS8LC)huF@Sqb=d`+}gYZ%^8C6<8`m`LUw6bivMr|XYac@)#qICak8#fuHJBW@|
zdf99w*sJT+u9%UJ1`YjEiZr0+zX~9_5LjST_~JhxT6{Yn5mCjr>Kl=<5v6Of@a^;<
zwyVGeQiVGWrWt$lxf_;t0&GfJnBZ<6At{*%ElsSev8+Q39wyIEAoFnYnY|;*_hPO5
z=xfiz45HI0Y-#3CG7%#L<F_2{d3xZLK*Y$x%xqDu#IHSsk*p3wE9ykh%xBnp7hji<
zB~qPs;^Z0o)0D?}&oti7Er=a^qZ;Z!HN(%4;a6to-sXuYRBGT(%aJL^;nz#h_ra_}
z^nRL-ZukK}&=^W7eGx+=$VNg}ow<C4D~wImw9JI1V<-JNuUFcl)Odc_zL+}-NwD4`
z{m_lBhzw2(K01rF8!{(hUhRYUKH{tBhfHs?nBL^Qh|P9ALXaBtgZ@BvNk3R*@0~r!
zdo-~{Zv08zHAY7O;w~e;5Y`)>vYd)Hf5r?ZcTRQmx-HTgQ+|hAt?EcFtzK7-3lU0C
z+Kk|VdD$(9GT7mu5mOYhd2VEUx+RSwGZ@A$Xjq)|rPM5EL5|qq<Oz|KaYW~($LQI)
zDIG^a@-90<nz}=CkGQx7j}$pu09?X}lj^%{&98WcQ3?Gg$UO!)=t~c7^o^_*Mq~s+
z-q=;|g_q)C1VnwviXJ))m@A8J;=L9Cta><e^Awn$d;3y2J!1TfLc7KmN)iCCw9<$S
z@=~AaB`)k`dZ^-}Q->5LCg)XjMbJy>mU8v{*ksiX3vTE}g&^8srAWy@6a@%%?zQj{
z@~D!_lWe&#=%ZA6xOvKt-6pk&kFZ}i&r^I<XM2cgiKp_Wg%BOUy%<@`r$G(~u*AcO
zJS!To3A4oc#tn8_trsgbHt^Tk*+~z;Qw2FljgV#~+rG<aOTZ<Y%^?k)<>kqO@sQG=
zR_KbL&q#<bj+S8{pUL;P*lpJ2C#3-EESgLFG!7&f)y2X6rEF&;(qe~U5%ax<+ouf+
z2oBAZ)lA_`l0Tk2=51KD^;w~^w&0u3j~O}b2@U{eBrry>O#b`ld7QZlmYW~y{WLiJ
zbzf*c#B;?nd0$JjLW;ktncbnJ)*q*0$#DG^PvR0_RAC?a;LZI8G$0K0^y%}`g17#>
z6E6GU;1Fpv$Ga!ZrgPrCUTaecr3bNeEM73{u8Jd#mPBuN`|N?h3q&v{DkJ_4EASye
zHun(J{FwT(nLay`;#3xYROuwYZ-3s`kt4YFy$ZVd%g>o<zWWu<of$NsgVw}wxW(Aw
z4~*`(l)x|xv(f8t_*Ise&A;D#!G|B-mFNIK7&rNx>9(46_v}K6cRZZ&suA3Jr&Ja?
zh}TT`XlkV(T0wmDRW33Z4)IoLeC5=OA8ij%x^pnW+i~4>?FbVfRMAL{>3RNS&BoE!
z%wz`ecQ$)5Is4)xGvkTdM3=`bg@10)z4Sj~I|tWD8&`(li!M!+9yEN}=;F52E8qHX
z?caQdDdR|ke8UQii6C9SgK?YJ4u{>KLD~B(e{X-sE}A2T6i_9JL}&`=`cYNBl%lb~
z*tSX(m~5U(Cta)i2Ya;Q`(!-PMbn`RtkaJskJ`T40HDVFJBzC`C*p?b5kX=Y6&UJa
zc@|*aI63WpRgbrlh+%Uun;823t)GC0=;1=gbknkT&Ubg!LhzMU1~9gQRbz8i7#(^=
z5i#lxX3d$K@m#O@0O-#s7hz`nufZ7?pI=MSVm$B92h-&JWO^`J|2^f4F--&<-zAZV
zsTDCj=$PC?Jy@STdi2|aF_q-(j}vSFn-fwC`8_aKX6l}3lYG-vCg}RNgZ2}s`gsOP
zmR^V*2E05CI3Gk~-87VhRBf3HnZe;%LQotHKlCn7?5;ygs@=|(`J>(T#!N1ekM}}S
zS?sIWtB&LVKfgE0qsURmn1E=MD5h!`pS<xH>u70)C*-N?cN<`W2$N*{dvWmz)X#+g
z=<GrWs{2=SNv4_NjYpLg@BE&r(*bWTo)GAzR<$tv32Q_A1+wK504orYu^gqVvT31&
z^*?$3smo_U_nZwtC~a0z<l^}R_xJC254UQR@Bk|q#b|XMap3yIs{Lkk$T^zYdj|YX
zd$Z!5Ky*nh{_yUmQ>;@?s;aw)I|}^n{nshd8>nGB3T{l*pB}_;cI^kCgys<yj-weF
zeAA`o21F>ZEUAwxyHosu2%3{`#+&2AJ$^N~^x*ZZSis>^xH1@XUS@t~Pna#eH2YeK
znGT?zr4e(>4a;umvT<;Fy;Sz}3VnZ-Ytlp0l*$1X&k9s<z?$3KEprj#COd9gt82_#
zIZJ46dPdCUGZ!<6mcpp$S)Dk}aNw|L(U#BnOKQjkPkeenyCERBqjZ~DVp%V{+GEvB
z9=1fk={P{vPg^K{Px4EJlp}>Pg0&J{iSUa}H+0<Wg^C|>R6cgP&d3X)LzxsGU4-k<
zB2%LSYL~vcu^Nt(4!kSj+(8F^Las8l>fw*PbCtO<v_N1^&^z_-3?r~lh2W}BIm47m
zn4WJ7SyD!Uh6}W?i|tP<iLTzKA<(J5iweLTbh8lR{AGh-?l5XqfaEzYbHo7H##)x&
z*r75Z2pafc8UZWojiVn4ZIz>f0(mB7u|DiT^d=F*0lga2jAg}rLXR>t@XFryu8LyK
z*pI|F%5MT0{K@GZ2cZz`UOm<rZQMDOE|XiM5NqG(vUL1M*ag>;3zLjSalk-j8Z>wL
znZf`*xFY_w;+bWKtP7K;WCvTfkY~kaf~!**3kbP;ev}oVJLrK7j^QST{6$J4r)n60
zfiaEp8tA=*{QPY7(07o4{ukstPCm<%0?uKP)jiF=PxeRZMPB8LKQEX5yj>p<YEZg%
za8KC1PNs&j`g|(q5w2vSbGa{a)b&2i;bv||tmm;2&&;V5DWVKipv_Hi^3=kTkG+er
zmPw1KA#{Pb-CA90Fyd+B{0+^@5Lb563Uz=fVQYQ$Yo$%+>=vvpH&mjKunvc9Q`4h|
z&Vo?Wz9Z%W*#;@3ILhL<_tSyS6ZL(&x~f#uYB>?=)6(_{H;s|X%rk{V)lY*kdPg+N
zRg@9r4LB<j{6w-(JB7#L^o%#sC^+R)#e2sH@?Xe^#?u{lqjWo?Pxl(iw{k(@p!~%F
zjN2WU^nUk;K@@RH-uPL}QLQfdMsa>h(-(>djE$OU@Fd8&RSnDfL&hg8X1lt1JZ02%
zMaL38wWUK=?t!He2*MAI>xM9FTR5R$1cNbns%7f5xev_Cet`_jri9!DK+G8_ZV;_K
z0$^a9h>n?ur8yIyY8WMQMi4QQFw<8L=Z4FLq^iYe(PT{+pIXCeC9Gg^zCpyRt}3QQ
zzxUBR)>J7<t0LZ;YVAN2?My`=2IF2`mIO$lZxl@Sh{Xxea?;%R6?ko7^!h)U>=Q&S
zqU5-&+d}dk4+K&UT-c<cSxBX8aobref8yXUJXGpizLHsW62T9euxvNUJ3Px*tqv>t
zNwg#YR6mC55#^q@pWR2RTwu?PpMoy=GA-r@DeX|-&f}*};3t&s=;0P&6hN3ldJuY0
zx(iTIU)qG2SC2<p^0FW`3&4L9QIwOX0CHf%t_7GZNtl@}2DTuPK0SdAQL%HsmKlPo
zedBP)t}WD#-FC4QekdODd`EmW(FNWO04Z1^1m8_sISyE~Kqav35}(X1pdI{MMaDjF
zPtp7(VO#G{*sN9-1z1ZrSiOeMj}ZT8M}o#?U16Ob5k&}$ZFgTYUlo@U@}yw`@Z07M
z4ntI7St2riz!@}T1Sczm{8}HX^N$ygAm*C(wRsDN_tqzIZXQ?00M2hSmABh-r6C$%
za0b|8^Uy}Tm>XedRni*w0saTu83FD@3HI05XghgEBjD?jnUfMSt%HtvfE2rXlXoT*
zlBbJIy)srF!f`t}Xz&3<A$hv?`rG6BoEW+&&d^V)4_`TEElFkEv8^p#syU#AOSlC+
z{iLx;_=CeNAcl)p76b3irE#ZIQ4NIlT)|y5fP!nzvTv_K^jW|zaDRY3M@2PV!|^O6
zbD-5yyy4qUGhqJ!@7VrOcso#|2TDm;7Lc#F9h?DTDBO0UxB400?eL5qxY$W9NSSEr
zyk7s|1v=~gElN9KcrYfK=_&)?_AI4!Y<a|UC^XdQ%B1d97ofRZ$i(O20$)%a3$r_G
zCxN3UqO`i?AO(W&FQW{TTE~npnRT~UV_Aqs>Ih^Yh0%d~9-Y5Wp+7%=7!o_3qL0!#
zkSKAI-kz#@0=IYr&WK?CE=uVDy=1Q;_?3&9dWtkn72HtD%75rcVkG!)SJXgf4J3t<
zRxV7}!BZ!GgbFWWaSBL9yMfbfM?#b#nBeA-g`fltA;tEa`v~WxW8NcMN??No&{_CT
ziU7X{ES1A-BzaG>4GW&E^PW2)NB}Mw8dJ-5y#x?;uq5PKPDy2$EtkxOZ-W#lASgYU
zZujUvi)sM)!p4RR>K44c{~mELK%(e`m3K%_@Q~#`_V(Gl3EBA*WkK<H4jM~Ac4~qO
z^<ZhGTUeZgCWy;PldgiXK2pLWNWUJI{R613nv540P5%kET=du~s>}InuCIsi@^?{c
zaR1cCu*Z!oq{^)y?>n3Ub0wrw3L0>*srRsFH#`yc9K3(zFdSUv&d|+>45StUKnFwp
zj>gPnO7w72N;sE=&+v|I9D^$Y32926-D&rvob7wGd1KwO=n4(B%)F6_5E2;3aSQt?
zwY4TUxP~uyMr6p)gk>?meoUWLFn60JE;~Jbx6|J3(kxuhtN=07e4C*<IiK#)-?OXy
zhqsSUKxf?P1xdOe|JLi^B^D}4-A5o*v6ysWn&MhpPP;J0D(c*OU-V5-L4_PV*cyVl
zJV=opXK@o@TI|Eu<`h;OqiNOt7IlKw;`g#bkJe(Eu;aF#V5d#dQv3<4g#HOiHaw0Y
z1ii<wFl3l9Bb}eqLSkQxzJbDb!bng-z=`dSKX*jy3DG)E$(g`)BGA<?S<7u->SCQN
zAO{7~G_%Kg*7n(W(Mq#$gK1ALwX*-^oqcV=e?C18td*q=c-Z)!eQn=hdyqNp@pmF3
z-cxnj<kx>WogAc$f8IsAFmsbryT8l**~RAh0FkRfzVS=E&v<3O9%7J{77z_tpVdDf
zx)pFT3}!u0)Bm{I6Y2sTE}^7cDQCyMyR;(e|8N`4J^~NB#jL&#t=U+syiKa8*<2|%
z-WAYM>)~<UCh762x<2Wkf2z&hChIj3^}67%rDMrYhBnk;yaX@elqz_IEqmJ7h4oSA
zzO)}DZB5FnR1Fohjx3}-N&G6k{ZYx8r3DoiyX_k?BC)+vHZSZPNppUc!K8)F<-B|!
zYX7Udl8LEP>drHsp0K6?z`gVT-gogC@EIITqo^G%v#O>{FHl#med_bq9N<%qUl5ou
zqZuqzLlJ#0D5S0aljXrI_KQ@H36}~jitF;wx5qIVb3-?wrvzN5Z>qowxLj*2TM6}K
zMu@KndE80m=#`Jd!p~_3m7Q6^qCOl7Bn#e0$;T(pFPRs%<nXNhT@NU7*d0RKC~T%6
zauo0Dt3A=PX62-m8G(VdH7NVtm0EXKimNj|?M3YDmXH%3ebrYrog6qGH5^O|X_X%?
z^{gD!xzQ7_|20%av^qJ*^ppCzEAGOn)@j0|OR6?IF|((%f;URvr8y<8DUrQ}d-Z7B
zsjJrEQ<^31@@q++VV(Qb=Yi7H;Bj5IOWG3&Yl->lMr}I1JO9~;C9Z{F5kt@V_}EH6
z&(;E;;Qag4nw;#himCqws%%C&!b~9<56{1ahWU*AWx|%Za`c&P?YKZY^-r~k-^#{U
z`HcfKp+GIU6w>eKp%?Eje6lR|q}{fX{yy<vFO^ic_pDtDqYPY4#c%arIz;KPuAWi8
z3~EoqTPqC*5}By*4%PH@$H1ogVBmXd^Q;qFv-rCs6V$A6>MeDRLXp@oQN5CujO5I^
zMY+AfeWeqv@8phz-lqfOYpn7c<yqvfTa=*ML)3@V#hv7B%=qNp4al@3y-V~HQRkC{
zqXl<x<lg!C#PFHHC9`}x;nSNzr2)aqv-Nft0qASG8GzjGk=4}5el<a=P#-*pAN77;
zqEuDWHy|>4^2@<k(xzM4m><5?Ztap&s~r1*I-I$C0Gkl1{sREYt9yd&!m5Y)4yMd$
zUi-9Ucba+@!poXB&^7qQ6YnzT{IT+$P2k*OeXeZj?DL-1qHkn|`VW5_8Nuqqqqf%h
zKSP(R$eO{+&K}B&i(|8c_kQSqsHJdpmWo$A8{3RHw|41yU;K%Wl=hHQ)pBQHFjnNy
zlqmgxTdRfQzsox1dZ<enK{K@HwVAW&gX=$cKI=h6>DQsYKC;iTrQ&UJrRhP?qvz=h
zg%Ouq6L#b+OP>8&LaLidqcTr^xqCmLj_Q@u%l@zv4WcQr?!P2ns#9dLi{@=*xvOW@
zPqnDOO7+>uKNElcw!4OR^?42o$Gt&2MUS3Z*2Qwc#kL%qnJ=>wl%lcN?6=gmM}O!+
z4Yi!4!FrLxQd+Jic(K)=)N@KDNQR^#revvEn?z;CWEouQ>gxVfE+sm%aq0QZmAG|r
z1`sz{8CJ24;*e@?A6IxWPCcYA!Tk6YwkxDrr~DsDj$x<EHL)G9&hWW!^kSCg@xd`V
z`4nm_E9i_Y;8@FDdA7fHmRue4r*<&KP4n&uW9L*LBd+`3n^`6zX?U$hJY!2=^QY!R
zTT4rM8tcm%+M(0_IYVUf*cG<W(=$84m5svTe|hvzXo5z_7DK}?jsLjgVR^AVgU5Aa
z<WkT4PbOsVVc`^mz}PFQB|}do5uUveRf45sLtWr~pUJzf^q`-1VL*tRiLN-Q*yRQS
zH$b?Ljy(f!WNrV2+;4Qs(%uVlKifS)Bob5+%i8DHg#w+_fE5Lk&*R6>`@#avyuYsv
z=1WPBK8kQ?)f|omqxlsSn5sA^(@i7x$%ib3kQo1mTg3m@HBH2g{qL?H|9|ed$+6UJ
VA<5u<+89y5P}lTCp|*X*{{g=L&fx$6

literal 0
HcmV?d00001

diff --git a/Documentation/linux_tv/media/v4l/selection-api-004.rst b/Documentation/linux_tv/media/v4l/selection-api-004.rst
new file mode 100644
index 000000000000..d023cd022295
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/selection-api-004.rst
@@ -0,0 +1,146 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+*************
+Configuration
+*************
+
+Applications can use the :ref:`selection API <vidioc-g-selection>` to
+select an area in a video signal or a buffer, and to query for default
+settings and hardware limits.
+
+Video hardware can have various cropping, composing and scaling
+limitations. It may only scale up or down, support only discrete scaling
+factors, or have different scaling abilities in the horizontal and
+vertical directions. Also it may not support scaling at all. At the same
+time the cropping/composing rectangles may have to be aligned, and both
+the source and the sink may have arbitrary upper and lower size limits.
+Therefore, as usual, drivers are expected to adjust the requested
+parameters and return the actual values selected. An application can
+control the rounding behaviour using
+:ref:`constraint flags <v4l2-selection-flags>`.
+
+
+Configuration of video capture
+==============================
+
+See figure :ref:`sel-targets-capture` for examples of the selection
+targets available for a video capture device. It is recommended to
+configure the cropping targets before to the composing targets.
+
+The range of coordinates of the top left corner, width and height of
+areas that can be sampled is given by the ``V4L2_SEL_TGT_CROP_BOUNDS``
+target. It is recommended for the driver developers to put the top/left
+corner at position ``(0,0)``. The rectangle's coordinates are expressed
+in pixels.
+
+The top left corner, width and height of the source rectangle, that is
+the area actually sampled, is given by the ``V4L2_SEL_TGT_CROP`` target.
+It uses the same coordinate system as ``V4L2_SEL_TGT_CROP_BOUNDS``. The
+active cropping area must lie completely inside the capture boundaries.
+The driver may further adjust the requested size and/or position
+according to hardware limitations.
+
+Each capture device has a default source rectangle, given by the
+``V4L2_SEL_TGT_CROP_DEFAULT`` target. This rectangle shall over what the
+driver writer considers the complete picture. Drivers shall set the
+active crop rectangle to the default when the driver is first loaded,
+but not later.
+
+The composing targets refer to a memory buffer. The limits of composing
+coordinates are obtained using ``V4L2_SEL_TGT_COMPOSE_BOUNDS``. All
+coordinates are expressed in pixels. The rectangle's top/left corner
+must be located at position ``(0,0)``. The width and height are equal to
+the image size set by ``VIDIOC_S_FMT``.
+
+The part of a buffer into which the image is inserted by the hardware is
+controlled by the ``V4L2_SEL_TGT_COMPOSE`` target. The rectangle's
+coordinates are also expressed in the same coordinate system as the
+bounds rectangle. The composing rectangle must lie completely inside
+bounds rectangle. The driver must adjust the composing rectangle to fit
+to the bounding limits. Moreover, the driver can perform other
+adjustments according to hardware limitations. The application can
+control rounding behaviour using
+:ref:`constraint flags <v4l2-selection-flags>`.
+
+For capture devices the default composing rectangle is queried using
+``V4L2_SEL_TGT_COMPOSE_DEFAULT``. It is usually equal to the bounding
+rectangle.
+
+The part of a buffer that is modified by the hardware is given by
+``V4L2_SEL_TGT_COMPOSE_PADDED``. It contains all pixels defined using
+``V4L2_SEL_TGT_COMPOSE`` plus all padding data modified by hardware
+during insertion process. All pixels outside this rectangle *must not*
+be changed by the hardware. The content of pixels that lie inside the
+padded area but outside active area is undefined. The application can
+use the padded and active rectangles to detect where the rubbish pixels
+are located and remove them if needed.
+
+
+Configuration of video output
+=============================
+
+For output devices targets and ioctls are used similarly to the video
+capture case. The *composing* rectangle refers to the insertion of an
+image into a video signal. The cropping rectangles refer to a memory
+buffer. It is recommended to configure the composing targets before to
+the cropping targets.
+
+The cropping targets refer to the memory buffer that contains an image
+to be inserted into a video signal or graphical screen. The limits of
+cropping coordinates are obtained using ``V4L2_SEL_TGT_CROP_BOUNDS``.
+All coordinates are expressed in pixels. The top/left corner is always
+point ``(0,0)``. The width and height is equal to the image size
+specified using ``VIDIOC_S_FMT`` ioctl.
+
+The top left corner, width and height of the source rectangle, that is
+the area from which image date are processed by the hardware, is given
+by the ``V4L2_SEL_TGT_CROP``. Its coordinates are expressed in in the
+same coordinate system as the bounds rectangle. The active cropping area
+must lie completely inside the crop boundaries and the driver may
+further adjust the requested size and/or position according to hardware
+limitations.
+
+For output devices the default cropping rectangle is queried using
+``V4L2_SEL_TGT_CROP_DEFAULT``. It is usually equal to the bounding
+rectangle.
+
+The part of a video signal or graphics display where the image is
+inserted by the hardware is controlled by ``V4L2_SEL_TGT_COMPOSE``
+target. The rectangle's coordinates are expressed in pixels. The
+composing rectangle must lie completely inside the bounds rectangle. The
+driver must adjust the area to fit to the bounding limits. Moreover, the
+driver can perform other adjustments according to hardware limitations.
+
+The device has a default composing rectangle, given by the
+``V4L2_SEL_TGT_COMPOSE_DEFAULT`` target. This rectangle shall cover what
+the driver writer considers the complete picture. It is recommended for
+the driver developers to put the top/left corner at position ``(0,0)``.
+Drivers shall set the active composing rectangle to the default one when
+the driver is first loaded.
+
+The devices may introduce additional content to video signal other than
+an image from memory buffers. It includes borders around an image.
+However, such a padded area is driver-dependent feature not covered by
+this document. Driver developers are encouraged to keep padded rectangle
+equal to active one. The padded target is accessed by the
+``V4L2_SEL_TGT_COMPOSE_PADDED`` identifier. It must contain all pixels
+from the ``V4L2_SEL_TGT_COMPOSE`` target.
+
+
+Scaling control
+===============
+
+An application can detect if scaling is performed by comparing the width
+and the height of rectangles obtained using ``V4L2_SEL_TGT_CROP`` and
+``V4L2_SEL_TGT_COMPOSE`` targets. If these are not equal then the
+scaling is applied. The application can compute the scaling ratios using
+these values.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/selection-api-005.rst b/Documentation/linux_tv/media/v4l/selection-api-005.rst
new file mode 100644
index 000000000000..aefab87788db
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/selection-api-005.rst
@@ -0,0 +1,42 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+********************************
+Comparison with old cropping API
+********************************
+
+The selection API was introduced to cope with deficiencies of previous
+:ref:`API <crop>`, that was designed to control simple capture
+devices. Later the cropping API was adopted by video output drivers. The
+ioctls are used to select a part of the display were the video signal is
+inserted. It should be considered as an API abuse because the described
+operation is actually the composing. The selection API makes a clear
+distinction between composing and cropping operations by setting the
+appropriate targets. The V4L2 API lacks any support for composing to and
+cropping from an image inside a memory buffer. The application could
+configure a capture device to fill only a part of an image by abusing
+V4L2 API. Cropping a smaller image from a larger one is achieved by
+setting the field struct
+:ref:`v4l2_pix_format <v4l2-pix-format>```::bytesperline``.
+Introducing an image offsets could be done by modifying field struct
+:ref:`v4l2_buffer <v4l2-buffer>```::m_userptr`` before calling
+``VIDIOC_QBUF``. Those operations should be avoided because they are not
+portable (endianness), and do not work for macroblock and Bayer formats
+and mmap buffers. The selection API deals with configuration of buffer
+cropping/composing in a clear, intuitive and portable way. Next, with
+the selection API the concepts of the padded target and constraints
+flags are introduced. Finally, struct :ref:`v4l2_crop <v4l2-crop>`
+and struct :ref:`v4l2_cropcap <v4l2-cropcap>` have no reserved
+fields. Therefore there is no way to extend their functionality. The new
+struct :ref:`v4l2_selection <v4l2-selection>` provides a lot of place
+for future extensions. Driver developers are encouraged to implement
+only selection API. The former cropping API would be simulated using the
+new one.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/selection-api-006.rst b/Documentation/linux_tv/media/v4l/selection-api-006.rst
new file mode 100644
index 000000000000..61160b6be4f6
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/selection-api-006.rst
@@ -0,0 +1,89 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+********
+Examples
+********
+
+(A video capture device is assumed; change
+``V4L2_BUF_TYPE_VIDEO_CAPTURE`` for other devices; change target to
+``V4L2_SEL_TGT_COMPOSE_*`` family to configure composing area)
+
+
+.. code-block:: c
+
+        struct v4l2_selection sel = {
+            .type = V4L2_BUF_TYPE_VIDEO_CAPTURE,
+            .target = V4L2_SEL_TGT_CROP_DEFAULT,
+        };
+        ret = ioctl(fd, VIDIOC_G_SELECTION, &sel);
+        if (ret)
+            exit(-1);
+        sel.target = V4L2_SEL_TGT_CROP;
+        ret = ioctl(fd, VIDIOC_S_SELECTION, &sel);
+        if (ret)
+            exit(-1);
+
+Setting a composing area on output of size of *at most* half of limit
+placed at a center of a display.
+
+
+.. code-block:: c
+
+        struct v4l2_selection sel = {
+            .type = V4L2_BUF_TYPE_VIDEO_OUTPUT,
+            .target = V4L2_SEL_TGT_COMPOSE_BOUNDS,
+        };
+        struct v4l2_rect r;
+
+        ret = ioctl(fd, VIDIOC_G_SELECTION, &sel);
+        if (ret)
+            exit(-1);
+        /* setting smaller compose rectangle */
+        r.width = sel.r.width / 2;
+        r.height = sel.r.height / 2;
+        r.left = sel.r.width / 4;
+        r.top = sel.r.height / 4;
+        sel.r = r;
+        sel.target = V4L2_SEL_TGT_COMPOSE;
+        sel.flags = V4L2_SEL_FLAG_LE;
+        ret = ioctl(fd, VIDIOC_S_SELECTION, &sel);
+        if (ret)
+            exit(-1);
+
+A video output device is assumed; change ``V4L2_BUF_TYPE_VIDEO_OUTPUT``
+for other devices
+
+
+.. code-block:: c
+
+        struct v4l2_selection compose = {
+            .type = V4L2_BUF_TYPE_VIDEO_OUTPUT,
+            .target = V4L2_SEL_TGT_COMPOSE,
+        };
+        struct v4l2_selection crop = {
+            .type = V4L2_BUF_TYPE_VIDEO_OUTPUT,
+            .target = V4L2_SEL_TGT_CROP,
+        };
+        double hscale, vscale;
+
+        ret = ioctl(fd, VIDIOC_G_SELECTION, &compose);
+        if (ret)
+            exit(-1);
+        ret = ioctl(fd, VIDIOC_G_SELECTION, &crop);
+        if (ret)
+            exit(-1);
+
+        /* computing scaling factors */
+        hscale = (double)compose.r.width / crop.r.width;
+        vscale = (double)compose.r.height / crop.r.height;
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/selection-api.rst b/Documentation/linux_tv/media/v4l/selection-api.rst
new file mode 100644
index 000000000000..1cc3b41b8435
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/selection-api.rst
@@ -0,0 +1,27 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _selection-api:
+
+API for cropping, composing and scaling
+=======================================
+
+
+.. toctree::
+    :maxdepth: 1
+
+    selection-api-002
+    selection-api-003
+    selection-api-004
+    selection-api-005
+    selection-api-006
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/selections-common.rst b/Documentation/linux_tv/media/v4l/selections-common.rst
new file mode 100644
index 000000000000..93efdc398fa9
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/selections-common.rst
@@ -0,0 +1,34 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _v4l2-selections-common:
+
+Common selection definitions
+============================
+
+While the :ref:`V4L2 selection API <selection-api>` and
+:ref:`V4L2 subdev selection APIs <v4l2-subdev-selections>` are very
+similar, there's one fundamental difference between the two. On
+sub-device API, the selection rectangle refers to the media bus format,
+and is bound to a sub-device's pad. On the V4L2 interface the selection
+rectangles refer to the in-memory pixel format.
+
+This section defines the common definitions of the selection interfaces
+on the two APIs.
+
+
+.. toctree::
+    :maxdepth: 1
+
+    v4l2-selection-targets
+    v4l2-selection-flags
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/standard.rst b/Documentation/linux_tv/media/v4l/standard.rst
new file mode 100644
index 000000000000..db80861c1446
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/standard.rst
@@ -0,0 +1,185 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _standard:
+
+***************
+Video Standards
+***************
+
+Video devices typically support one or more different video standards or
+variations of standards. Each video input and output may support another
+set of standards. This set is reported by the ``std`` field of struct
+:ref:`v4l2_input <v4l2-input>` and struct
+:ref:`v4l2_output <v4l2-output>` returned by the
+:ref:`VIDIOC_ENUMINPUT <vidioc-enuminput>` and
+:ref:`VIDIOC_ENUMOUTPUT <vidioc-enumoutput>` ioctls, respectively.
+
+V4L2 defines one bit for each analog video standard currently in use
+worldwide, and sets aside bits for driver defined standards, e. g.
+hybrid standards to watch NTSC video tapes on PAL TVs and vice versa.
+Applications can use the predefined bits to select a particular
+standard, although presenting the user a menu of supported standards is
+preferred. To enumerate and query the attributes of the supported
+standards applications use the :ref:`VIDIOC_ENUMSTD <vidioc-enumstd>`
+ioctl.
+
+Many of the defined standards are actually just variations of a few
+major standards. The hardware may in fact not distinguish between them,
+or do so internal and switch automatically. Therefore enumerated
+standards also contain sets of one or more standard bits.
+
+Assume a hypothetic tuner capable of demodulating B/PAL, G/PAL and I/PAL
+signals. The first enumerated standard is a set of B and G/PAL, switched
+automatically depending on the selected radio frequency in UHF or VHF
+band. Enumeration gives a "PAL-B/G" or "PAL-I" choice. Similar a
+Composite input may collapse standards, enumerating "PAL-B/G/H/I",
+"NTSC-M" and "SECAM-D/K". [1]_
+
+To query and select the standard used by the current video input or
+output applications call the :ref:`VIDIOC_G_STD <vidioc-g-std>` and
+:ref:`VIDIOC_S_STD <vidioc-g-std>` ioctl, respectively. The
+*received* standard can be sensed with the
+:ref:`VIDIOC_QUERYSTD <vidioc-querystd>` ioctl. Note that the
+parameter of all these ioctls is a pointer to a
+:ref:`v4l2_std_id <v4l2-std-id>` type (a standard set), *not* an
+index into the standard enumeration. Drivers must implement all video
+standard ioctls when the device has one or more video inputs or outputs.
+
+Special rules apply to devices such as USB cameras where the notion of
+video standards makes little sense. More generally for any capture or
+output device which is:
+
+-  incapable of capturing fields or frames at the nominal rate of the
+   video standard, or
+
+-  that does not support the video standard formats at all.
+
+Here the driver shall set the ``std`` field of struct
+:ref:`v4l2_input <v4l2-input>` and struct
+:ref:`v4l2_output <v4l2-output>` to zero and the ``VIDIOC_G_STD``,
+``VIDIOC_S_STD``, ``VIDIOC_QUERYSTD`` and ``VIDIOC_ENUMSTD`` ioctls
+shall return the ENOTTY error code or the EINVAL error code.
+
+Applications can make use of the :ref:`input-capabilities` and
+:ref:`output-capabilities` flags to determine whether the video
+standard ioctls can be used with the given input or output.
+
+
+.. code-block:: c
+
+    v4l2_std_id std_id;
+    struct v4l2_standard standard;
+
+    if (-1 == ioctl(fd, VIDIOC_G_STD, &std_id)) {
+        /* Note when VIDIOC_ENUMSTD always returns ENOTTY this
+           is no video device or it falls under the USB exception,
+           and VIDIOC_G_STD returning ENOTTY is no error. */
+
+        perror("VIDIOC_G_STD");
+        exit(EXIT_FAILURE);
+    }
+
+    memset(&standard, 0, sizeof(standard));
+    standard.index = 0;
+
+    while (0 == ioctl(fd, VIDIOC_ENUMSTD, &standard)) {
+        if (standard.id & std_id) {
+               printf("Current video standard: %s\\n", standard.name);
+               exit(EXIT_SUCCESS);
+        }
+
+        standard.index++;
+    }
+
+    /* EINVAL indicates the end of the enumeration, which cannot be
+       empty unless this device falls under the USB exception. */
+
+    if (errno == EINVAL || standard.index == 0) {
+        perror("VIDIOC_ENUMSTD");
+        exit(EXIT_FAILURE);
+    }
+
+
+.. code-block:: c
+
+    struct v4l2_input input;
+    struct v4l2_standard standard;
+
+    memset(&input, 0, sizeof(input));
+
+    if (-1 == ioctl(fd, VIDIOC_G_INPUT, &input.index)) {
+        perror("VIDIOC_G_INPUT");
+        exit(EXIT_FAILURE);
+    }
+
+    if (-1 == ioctl(fd, VIDIOC_ENUMINPUT, &input)) {
+        perror("VIDIOC_ENUM_INPUT");
+        exit(EXIT_FAILURE);
+    }
+
+    printf("Current input %s supports:\\n", input.name);
+
+    memset(&standard, 0, sizeof(standard));
+    standard.index = 0;
+
+    while (0 == ioctl(fd, VIDIOC_ENUMSTD, &standard)) {
+        if (standard.id & input.std)
+            printf("%s\\n", standard.name);
+
+        standard.index++;
+    }
+
+    /* EINVAL indicates the end of the enumeration, which cannot be
+       empty unless this device falls under the USB exception. */
+
+    if (errno != EINVAL || standard.index == 0) {
+        perror("VIDIOC_ENUMSTD");
+        exit(EXIT_FAILURE);
+    }
+
+
+.. code-block:: c
+
+    struct v4l2_input input;
+    v4l2_std_id std_id;
+
+    memset(&input, 0, sizeof(input));
+
+    if (-1 == ioctl(fd, VIDIOC_G_INPUT, &input.index)) {
+        perror("VIDIOC_G_INPUT");
+        exit(EXIT_FAILURE);
+    }
+
+    if (-1 == ioctl(fd, VIDIOC_ENUMINPUT, &input)) {
+        perror("VIDIOC_ENUM_INPUT");
+        exit(EXIT_FAILURE);
+    }
+
+    if (0 == (input.std & V4L2_STD_PAL_BG)) {
+        fprintf(stderr, "Oops. B/G PAL is not supported.\\n");
+        exit(EXIT_FAILURE);
+    }
+
+    /* Note this is also supposed to work when only B
+       or G/PAL is supported. */
+
+    std_id = V4L2_STD_PAL_BG;
+
+    if (-1 == ioctl(fd, VIDIOC_S_STD, &std_id)) {
+        perror("VIDIOC_S_STD");
+        exit(EXIT_FAILURE);
+    }
+
+.. [1]
+   Some users are already confused by technical terms PAL, NTSC and
+   SECAM. There is no point asking them to distinguish between B, G, D,
+   or K when the software or hardware can do that automatically.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/streaming-par.rst b/Documentation/linux_tv/media/v4l/streaming-par.rst
new file mode 100644
index 000000000000..53f4d7c23a8a
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/streaming-par.rst
@@ -0,0 +1,42 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _streaming-par:
+
+********************
+Streaming Parameters
+********************
+
+Streaming parameters are intended to optimize the video capture process
+as well as I/O. Presently applications can request a high quality
+capture mode with the :ref:`VIDIOC_S_PARM <vidioc-g-parm>` ioctl.
+
+The current video standard determines a nominal number of frames per
+second. If less than this number of frames is to be captured or output,
+applications can request frame skipping or duplicating on the driver
+side. This is especially useful when using the
+:ref:`read() <func-read>` or :ref:`write() <func-write>`, which are
+not augmented by timestamps or sequence counters, and to avoid
+unnecessary data copying.
+
+Finally these ioctls can be used to determine the number of buffers used
+internally by a driver in read/write mode. For implications see the
+section discussing the :ref:`read() <func-read>` function.
+
+To get and set the streaming parameters applications call the
+:ref:`VIDIOC_G_PARM <vidioc-g-parm>` and
+:ref:`VIDIOC_S_PARM <vidioc-g-parm>` ioctl, respectively. They take
+a pointer to a struct :ref:`v4l2_streamparm <v4l2-streamparm>`, which
+contains a union holding separate parameters for input and output
+devices.
+
+These ioctls are optional, drivers need not implement them. If so, they
+return the EINVAL error code.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/subdev-formats.rst b/Documentation/linux_tv/media/v4l/subdev-formats.rst
new file mode 100644
index 000000000000..a13c0cba3df0
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/subdev-formats.rst
@@ -0,0 +1,11701 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _v4l2-mbus-format:
+
+Media Bus Formats
+=================
+
+
+.. _v4l2-mbus-framefmt:
+
+.. flat-table:: struct v4l2_mbus_framefmt
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``width``
+
+       -  Image width, in pixels.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``height``
+
+       -  Image height, in pixels.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``code``
+
+       -  Format code, from enum
+          :ref:`v4l2_mbus_pixelcode <v4l2-mbus-pixelcode>`.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``field``
+
+       -  Field order, from enum :ref:`v4l2_field <v4l2-field>`. See
+          :ref:`field-order` for details.
+
+    -  .. row 5
+
+       -  __u32
+
+       -  ``colorspace``
+
+       -  Image colorspace, from enum
+          :ref:`v4l2_colorspace <v4l2-colorspace>`. See
+          :ref:`colorspaces` for details.
+
+    -  .. row 6
+
+       -  enum :ref:`v4l2_ycbcr_encoding <v4l2-ycbcr-encoding>`
+
+       -  ``ycbcr_enc``
+
+       -  This information supplements the ``colorspace`` and must be set by
+          the driver for capture streams and by the application for output
+          streams, see :ref:`colorspaces`.
+
+    -  .. row 7
+
+       -  enum :ref:`v4l2_quantization <v4l2-quantization>`
+
+       -  ``quantization``
+
+       -  This information supplements the ``colorspace`` and must be set by
+          the driver for capture streams and by the application for output
+          streams, see :ref:`colorspaces`.
+
+    -  .. row 8
+
+       -  enum :ref:`v4l2_xfer_func <v4l2-xfer-func>`
+
+       -  ``xfer_func``
+
+       -  This information supplements the ``colorspace`` and must be set by
+          the driver for capture streams and by the application for output
+          streams, see :ref:`colorspaces`.
+
+    -  .. row 9
+
+       -  __u16
+
+       -  ``reserved``\ [11]
+
+       -  Reserved for future extensions. Applications and drivers must set
+          the array to zero.
+
+
+
+.. _v4l2-mbus-pixelcode:
+
+Media Bus Pixel Codes
+---------------------
+
+The media bus pixel codes describe image formats as flowing over
+physical busses (both between separate physical components and inside
+SoC devices). This should not be confused with the V4L2 pixel formats
+that describe, using four character codes, image formats as stored in
+memory.
+
+While there is a relationship between image formats on busses and image
+formats in memory (a raw Bayer image won't be magically converted to
+JPEG just by storing it to memory), there is no one-to-one
+correspondance between them.
+
+
+Packed RGB Formats
+^^^^^^^^^^^^^^^^^^
+
+Those formats transfer pixel data as red, green and blue components. The
+format code is made of the following information.
+
+-  The red, green and blue components order code, as encoded in a pixel
+   sample. Possible values are RGB and BGR.
+
+-  The number of bits per component, for each component. The values can
+   be different for all components. Common values are 555 and 565.
+
+-  The number of bus samples per pixel. Pixels that are wider than the
+   bus width must be transferred in multiple samples. Common values are
+   1 and 2.
+
+-  The bus width.
+
+-  For formats where the total number of bits per pixel is smaller than
+   the number of bus samples per pixel times the bus width, a padding
+   value stating if the bytes are padded in their most high order bits
+   (PADHI) or low order bits (PADLO). A "C" prefix is used for
+   component-wise padding in the most high order bits (CPADHI) or low
+   order bits (CPADLO) of each separate component.
+
+-  For formats where the number of bus samples per pixel is larger than
+   1, an endianness value stating if the pixel is transferred MSB first
+   (BE) or LSB first (LE).
+
+For instance, a format where pixels are encoded as 5-bits red, 5-bits
+green and 5-bit blue values padded on the high bit, transferred as 2
+8-bit samples per pixel with the most significant bits (padding, red and
+half of the green value) transferred first will be named
+``MEDIA_BUS_FMT_RGB555_2X8_PADHI_BE``.
+
+The following tables list existing packed RGB formats.
+
+
+.. _v4l2-mbus-pixelcode-rgb:
+
+.. flat-table:: RGB formats
+    :header-rows:  2
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  Identifier
+
+       -  Code
+
+       -  
+       -  :cspan:`31` Data organization
+
+    -  .. row 2
+
+       -  
+       -  
+       -  Bit
+
+       -  31
+
+       -  30
+
+       -  29
+
+       -  28
+
+       -  27
+
+       -  26
+
+       -  25
+
+       -  24
+
+       -  23
+
+       -  22
+
+       -  21
+
+       -  20
+
+       -  19
+
+       -  18
+
+       -  17
+
+       -  16
+
+       -  15
+
+       -  14
+
+       -  13
+
+       -  12
+
+       -  11
+
+       -  10
+
+       -  9
+
+       -  8
+
+       -  7
+
+       -  6
+
+       -  5
+
+       -  4
+
+       -  3
+
+       -  2
+
+       -  1
+
+       -  0
+
+    -  .. _`MEDIA-BUS-FMT-RGB444-1X12`:
+
+       -  MEDIA_BUS_FMT_RGB444_1X12
+
+       -  0x1016
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-RGB444-2X8-PADHI-BE`:
+
+       -  MEDIA_BUS_FMT_RGB444_2X8_PADHI_BE
+
+       -  0x1001
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  0
+
+       -  0
+
+       -  0
+
+       -  0
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+    -  .. row 5
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-RGB444-2X8-PADHI-LE`:
+
+       -  MEDIA_BUS_FMT_RGB444_2X8_PADHI_LE
+
+       -  0x1002
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+    -  .. row 7
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  0
+
+       -  0
+
+       -  0
+
+       -  0
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-RGB555-2X8-PADHI-BE`:
+
+       -  MEDIA_BUS_FMT_RGB555_2X8_PADHI_BE
+
+       -  0x1003
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  0
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+    -  .. row 9
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-RGB555-2X8-PADHI-LE`:
+
+       -  MEDIA_BUS_FMT_RGB555_2X8_PADHI_LE
+
+       -  0x1004
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+    -  .. row 11
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  0
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+    -  .. _`MEDIA-BUS-FMT-RGB565-1X16`:
+
+       -  MEDIA_BUS_FMT_RGB565_1X16
+
+       -  0x1017
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-BGR565-2X8-BE`:
+
+       -  MEDIA_BUS_FMT_BGR565_2X8_BE
+
+       -  0x1005
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+    -  .. row 14
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-BGR565-2X8-LE`:
+
+       -  MEDIA_BUS_FMT_BGR565_2X8_LE
+
+       -  0x1006
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+    -  .. row 16
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+    -  .. _`MEDIA-BUS-FMT-RGB565-2X8-BE`:
+
+       -  MEDIA_BUS_FMT_RGB565_2X8_BE
+
+       -  0x1007
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+    -  .. row 18
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-RGB565-2X8-LE`:
+
+       -  MEDIA_BUS_FMT_RGB565_2X8_LE
+
+       -  0x1008
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+    -  .. row 20
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+    -  .. _`MEDIA-BUS-FMT-RGB666-1X18`:
+
+       -  MEDIA_BUS_FMT_RGB666_1X18
+
+       -  0x1009
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  r\ :sub:`5`
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  b\ :sub:`5`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-RBG888-1X24`:
+
+       -  MEDIA_BUS_FMT_RBG888_1X24
+
+       -  0x100e
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  r\ :sub:`7`
+
+       -  r\ :sub:`6`
+
+       -  r\ :sub:`5`
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+       -  b\ :sub:`7`
+
+       -  b\ :sub:`6`
+
+       -  b\ :sub:`5`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+       -  g\ :sub:`7`
+
+       -  g\ :sub:`6`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-RGB666-1X24_CPADHI`:
+
+       -  MEDIA_BUS_FMT_RGB666_1X24_CPADHI
+
+       -  0x1015
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  0
+
+       -  0
+
+       -  r\ :sub:`5`
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+       -  0
+
+       -  0
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  0
+
+       -  0
+
+       -  b\ :sub:`5`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-BGR888-1X24`:
+
+       -  MEDIA_BUS_FMT_BGR888_1X24
+
+       -  0x1013
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  b\ :sub:`7`
+
+       -  b\ :sub:`6`
+
+       -  b\ :sub:`5`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+       -  g\ :sub:`7`
+
+       -  g\ :sub:`6`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  r\ :sub:`7`
+
+       -  r\ :sub:`6`
+
+       -  r\ :sub:`5`
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-GBR888-1X24`:
+
+       -  MEDIA_BUS_FMT_GBR888_1X24
+
+       -  0x1014
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  g\ :sub:`7`
+
+       -  g\ :sub:`6`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  b\ :sub:`7`
+
+       -  b\ :sub:`6`
+
+       -  b\ :sub:`5`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+       -  r\ :sub:`7`
+
+       -  r\ :sub:`6`
+
+       -  r\ :sub:`5`
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-RGB888-1X24`:
+
+       -  MEDIA_BUS_FMT_RGB888_1X24
+
+       -  0x100a
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  r\ :sub:`7`
+
+       -  r\ :sub:`6`
+
+       -  r\ :sub:`5`
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+       -  g\ :sub:`7`
+
+       -  g\ :sub:`6`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  b\ :sub:`7`
+
+       -  b\ :sub:`6`
+
+       -  b\ :sub:`5`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-RGB888-2X12-BE`:
+
+       -  MEDIA_BUS_FMT_RGB888_2X12_BE
+
+       -  0x100b
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  r\ :sub:`7`
+
+       -  r\ :sub:`6`
+
+       -  r\ :sub:`5`
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+       -  g\ :sub:`7`
+
+       -  g\ :sub:`6`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+    -  .. row 28
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  b\ :sub:`7`
+
+       -  b\ :sub:`6`
+
+       -  b\ :sub:`5`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-RGB888-2X12-LE`:
+
+       -  MEDIA_BUS_FMT_RGB888_2X12_LE
+
+       -  0x100c
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  b\ :sub:`7`
+
+       -  b\ :sub:`6`
+
+       -  b\ :sub:`5`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+    -  .. row 30
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  r\ :sub:`7`
+
+       -  r\ :sub:`6`
+
+       -  r\ :sub:`5`
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+       -  g\ :sub:`7`
+
+       -  g\ :sub:`6`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+    -  .. _`MEDIA-BUS-FMT-ARGB888-1X32`:
+
+       -  MEDIA_BUS_FMT_ARGB888_1X32
+
+       -  0x100d
+
+       -  
+       -  a\ :sub:`7`
+
+       -  a\ :sub:`6`
+
+       -  a\ :sub:`5`
+
+       -  a\ :sub:`4`
+
+       -  a\ :sub:`3`
+
+       -  a\ :sub:`2`
+
+       -  a\ :sub:`1`
+
+       -  a\ :sub:`0`
+
+       -  r\ :sub:`7`
+
+       -  r\ :sub:`6`
+
+       -  r\ :sub:`5`
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+       -  g\ :sub:`7`
+
+       -  g\ :sub:`6`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  b\ :sub:`7`
+
+       -  b\ :sub:`6`
+
+       -  b\ :sub:`5`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-RGB888-1X32-PADHI`:
+
+       -  MEDIA_BUS_FMT_RGB888_1X32_PADHI
+
+       -  0x100f
+
+       -  
+       -  0
+
+       -  0
+
+       -  0
+
+       -  0
+
+       -  0
+
+       -  0
+
+       -  0
+
+       -  0
+
+       -  r\ :sub:`7`
+
+       -  r\ :sub:`6`
+
+       -  r\ :sub:`5`
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+       -  g\ :sub:`7`
+
+       -  g\ :sub:`6`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+       -  b\ :sub:`7`
+
+       -  b\ :sub:`6`
+
+       -  b\ :sub:`5`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+
+On LVDS buses, usually each sample is transferred serialized in seven
+time slots per pixel clock, on three (18-bit) or four (24-bit)
+differential data pairs at the same time. The remaining bits are used
+for control signals as defined by SPWG/PSWG/VESA or JEIDA standards. The
+24-bit RGB format serialized in seven time slots on four lanes using
+JEIDA defined bit mapping will be named
+``MEDIA_BUS_FMT_RGB888_1X7X4_JEIDA``, for example.
+
+
+.. _v4l2-mbus-pixelcode-rgb-lvds:
+
+.. flat-table:: LVDS RGB formats
+    :header-rows:  2
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  Identifier
+
+       -  Code
+
+       -  
+       -  
+       -  :cspan:`3` Data organization
+
+    -  .. row 2
+
+       -  
+       -  
+       -  Timeslot
+
+       -  Lane
+
+       -  3
+
+       -  2
+
+       -  1
+
+       -  0
+
+    -  .. _`MEDIA-BUS-FMT-RGB666-1X7X3-SPWG`:
+
+       -  MEDIA_BUS_FMT_RGB666_1X7X3_SPWG
+
+       -  0x1010
+
+       -  0
+
+       -  
+       -  -
+
+       -  d
+
+       -  b\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+    -  .. row 4
+
+       -  
+       -  
+       -  1
+
+       -  
+       -  -
+
+       -  d
+
+       -  b\ :sub:`0`
+
+       -  r\ :sub:`5`
+
+    -  .. row 5
+
+       -  
+       -  
+       -  2
+
+       -  
+       -  -
+
+       -  d
+
+       -  g\ :sub:`5`
+
+       -  r\ :sub:`4`
+
+    -  .. row 6
+
+       -  
+       -  
+       -  3
+
+       -  
+       -  -
+
+       -  b\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+    -  .. row 7
+
+       -  
+       -  
+       -  4
+
+       -  
+       -  -
+
+       -  b\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+    -  .. row 8
+
+       -  
+       -  
+       -  5
+
+       -  
+       -  -
+
+       -  b\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+    -  .. row 9
+
+       -  
+       -  
+       -  6
+
+       -  
+       -  -
+
+       -  b\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-RGB888-1X7X4-SPWG`:
+
+       -  MEDIA_BUS_FMT_RGB888_1X7X4_SPWG
+
+       -  0x1011
+
+       -  0
+
+       -  
+       -  d
+
+       -  d
+
+       -  b\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+    -  .. row 11
+
+       -  
+       -  
+       -  1
+
+       -  
+       -  b\ :sub:`7`
+
+       -  d
+
+       -  b\ :sub:`0`
+
+       -  r\ :sub:`5`
+
+    -  .. row 12
+
+       -  
+       -  
+       -  2
+
+       -  
+       -  b\ :sub:`6`
+
+       -  d
+
+       -  g\ :sub:`5`
+
+       -  r\ :sub:`4`
+
+    -  .. row 13
+
+       -  
+       -  
+       -  3
+
+       -  
+       -  g\ :sub:`7`
+
+       -  b\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+    -  .. row 14
+
+       -  
+       -  
+       -  4
+
+       -  
+       -  g\ :sub:`6`
+
+       -  b\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+    -  .. row 15
+
+       -  
+       -  
+       -  5
+
+       -  
+       -  r\ :sub:`7`
+
+       -  b\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+    -  .. row 16
+
+       -  
+       -  
+       -  6
+
+       -  
+       -  r\ :sub:`6`
+
+       -  b\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-RGB888-1X7X4-JEIDA`:
+
+       -  MEDIA_BUS_FMT_RGB888_1X7X4_JEIDA
+
+       -  0x1012
+
+       -  0
+
+       -  
+       -  d
+
+       -  d
+
+       -  b\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+    -  .. row 18
+
+       -  
+       -  
+       -  1
+
+       -  
+       -  b\ :sub:`1`
+
+       -  d
+
+       -  b\ :sub:`2`
+
+       -  r\ :sub:`7`
+
+    -  .. row 19
+
+       -  
+       -  
+       -  2
+
+       -  
+       -  b\ :sub:`0`
+
+       -  d
+
+       -  g\ :sub:`7`
+
+       -  r\ :sub:`6`
+
+    -  .. row 20
+
+       -  
+       -  
+       -  3
+
+       -  
+       -  g\ :sub:`1`
+
+       -  b\ :sub:`7`
+
+       -  g\ :sub:`6`
+
+       -  r\ :sub:`5`
+
+    -  .. row 21
+
+       -  
+       -  
+       -  4
+
+       -  
+       -  g\ :sub:`0`
+
+       -  b\ :sub:`6`
+
+       -  g\ :sub:`5`
+
+       -  r\ :sub:`4`
+
+    -  .. row 22
+
+       -  
+       -  
+       -  5
+
+       -  
+       -  r\ :sub:`1`
+
+       -  b\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+    -  .. row 23
+
+       -  
+       -  
+       -  6
+
+       -  
+       -  r\ :sub:`0`
+
+       -  b\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+
+
+Bayer Formats
+^^^^^^^^^^^^^
+
+Those formats transfer pixel data as red, green and blue components. The
+format code is made of the following information.
+
+-  The red, green and blue components order code, as encoded in a pixel
+   sample. The possible values are shown in :ref:`bayer-patterns`.
+
+-  The number of bits per pixel component. All components are
+   transferred on the same number of bits. Common values are 8, 10 and
+   12.
+
+-  The compression (optional). If the pixel components are ALAW- or
+   DPCM-compressed, a mention of the compression scheme and the number
+   of bits per compressed pixel component.
+
+-  The number of bus samples per pixel. Pixels that are wider than the
+   bus width must be transferred in multiple samples. Common values are
+   1 and 2.
+
+-  The bus width.
+
+-  For formats where the total number of bits per pixel is smaller than
+   the number of bus samples per pixel times the bus width, a padding
+   value stating if the bytes are padded in their most high order bits
+   (PADHI) or low order bits (PADLO).
+
+-  For formats where the number of bus samples per pixel is larger than
+   1, an endianness value stating if the pixel is transferred MSB first
+   (BE) or LSB first (LE).
+
+For instance, a format with uncompressed 10-bit Bayer components
+arranged in a red, green, green, blue pattern transferred as 2 8-bit
+samples per pixel with the least significant bits transferred first will
+be named ``MEDIA_BUS_FMT_SRGGB10_2X8_PADHI_LE``.
+
+
+.. _bayer-patterns:
+
+.. figure::  subdev-formats_files/bayer.*
+    :alt:    bayer.png
+    :align:  center
+
+    Bayer Patterns
+
+    Bayer filter color patterns
+
+
+
+The following table lists existing packed Bayer formats. The data
+organization is given as an example for the first pixel only.
+
+
+.. _v4l2-mbus-pixelcode-bayer:
+
+.. flat-table:: Bayer Formats
+    :header-rows:  2
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  Identifier
+
+       -  Code
+
+       -  
+       -  :cspan:`11` Data organization
+
+    -  .. row 2
+
+       -  
+       -  
+       -  Bit
+
+       -  11
+
+       -  10
+
+       -  9
+
+       -  8
+
+       -  7
+
+       -  6
+
+       -  5
+
+       -  4
+
+       -  3
+
+       -  2
+
+       -  1
+
+       -  0
+
+    -  .. _`MEDIA-BUS-FMT-SBGGR8-1X8`:
+
+       -  MEDIA_BUS_FMT_SBGGR8_1X8
+
+       -  0x3001
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  b\ :sub:`7`
+
+       -  b\ :sub:`6`
+
+       -  b\ :sub:`5`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-SGBRG8-1X8`:
+
+       -  MEDIA_BUS_FMT_SGBRG8_1X8
+
+       -  0x3013
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  g\ :sub:`7`
+
+       -  g\ :sub:`6`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-SGRBG8-1X8`:
+
+       -  MEDIA_BUS_FMT_SGRBG8_1X8
+
+       -  0x3002
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  g\ :sub:`7`
+
+       -  g\ :sub:`6`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-SRGGB8-1X8`:
+
+       -  MEDIA_BUS_FMT_SRGGB8_1X8
+
+       -  0x3014
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  r\ :sub:`7`
+
+       -  r\ :sub:`6`
+
+       -  r\ :sub:`5`
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-SBGGR10-ALAW8-1X8`:
+
+       -  MEDIA_BUS_FMT_SBGGR10_ALAW8_1X8
+
+       -  0x3015
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  b\ :sub:`7`
+
+       -  b\ :sub:`6`
+
+       -  b\ :sub:`5`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-SGBRG10-ALAW8-1X8`:
+
+       -  MEDIA_BUS_FMT_SGBRG10_ALAW8_1X8
+
+       -  0x3016
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  g\ :sub:`7`
+
+       -  g\ :sub:`6`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-SGRBG10-ALAW8-1X8`:
+
+       -  MEDIA_BUS_FMT_SGRBG10_ALAW8_1X8
+
+       -  0x3017
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  g\ :sub:`7`
+
+       -  g\ :sub:`6`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-SRGGB10-ALAW8-1X8`:
+
+       -  MEDIA_BUS_FMT_SRGGB10_ALAW8_1X8
+
+       -  0x3018
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  r\ :sub:`7`
+
+       -  r\ :sub:`6`
+
+       -  r\ :sub:`5`
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-SBGGR10-DPCM8-1X8`:
+
+       -  MEDIA_BUS_FMT_SBGGR10_DPCM8_1X8
+
+       -  0x300b
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  b\ :sub:`7`
+
+       -  b\ :sub:`6`
+
+       -  b\ :sub:`5`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-SGBRG10-DPCM8-1X8`:
+
+       -  MEDIA_BUS_FMT_SGBRG10_DPCM8_1X8
+
+       -  0x300c
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  g\ :sub:`7`
+
+       -  g\ :sub:`6`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-SGRBG10-DPCM8-1X8`:
+
+       -  MEDIA_BUS_FMT_SGRBG10_DPCM8_1X8
+
+       -  0x3009
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  g\ :sub:`7`
+
+       -  g\ :sub:`6`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-SRGGB10-DPCM8-1X8`:
+
+       -  MEDIA_BUS_FMT_SRGGB10_DPCM8_1X8
+
+       -  0x300d
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  r\ :sub:`7`
+
+       -  r\ :sub:`6`
+
+       -  r\ :sub:`5`
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-SBGGR10-2X8-PADHI-BE`:
+
+       -  MEDIA_BUS_FMT_SBGGR10_2X8_PADHI_BE
+
+       -  0x3003
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  0
+
+       -  0
+
+       -  0
+
+       -  0
+
+       -  0
+
+       -  0
+
+       -  b\ :sub:`9`
+
+       -  b\ :sub:`8`
+
+    -  .. row 16
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  b\ :sub:`7`
+
+       -  b\ :sub:`6`
+
+       -  b\ :sub:`5`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-SBGGR10-2X8-PADHI-LE`:
+
+       -  MEDIA_BUS_FMT_SBGGR10_2X8_PADHI_LE
+
+       -  0x3004
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  b\ :sub:`7`
+
+       -  b\ :sub:`6`
+
+       -  b\ :sub:`5`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+    -  .. row 18
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  0
+
+       -  0
+
+       -  0
+
+       -  0
+
+       -  0
+
+       -  0
+
+       -  b\ :sub:`9`
+
+       -  b\ :sub:`8`
+
+    -  .. _`MEDIA-BUS-FMT-SBGGR10-2X8-PADLO-BE`:
+
+       -  MEDIA_BUS_FMT_SBGGR10_2X8_PADLO_BE
+
+       -  0x3005
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  b\ :sub:`9`
+
+       -  b\ :sub:`8`
+
+       -  b\ :sub:`7`
+
+       -  b\ :sub:`6`
+
+       -  b\ :sub:`5`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+    -  .. row 20
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+       -  0
+
+       -  0
+
+       -  0
+
+       -  0
+
+       -  0
+
+       -  0
+
+    -  .. _`MEDIA-BUS-FMT-SBGGR10-2X8-PADLO-LE`:
+
+       -  MEDIA_BUS_FMT_SBGGR10_2X8_PADLO_LE
+
+       -  0x3006
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+       -  0
+
+       -  0
+
+       -  0
+
+       -  0
+
+       -  0
+
+       -  0
+
+    -  .. row 22
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  b\ :sub:`9`
+
+       -  b\ :sub:`8`
+
+       -  b\ :sub:`7`
+
+       -  b\ :sub:`6`
+
+       -  b\ :sub:`5`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+    -  .. _`MEDIA-BUS-FMT-SBGGR10-1X10`:
+
+       -  MEDIA_BUS_FMT_SBGGR10_1X10
+
+       -  0x3007
+
+       -  
+       -  -
+
+       -  -
+
+       -  b\ :sub:`9`
+
+       -  b\ :sub:`8`
+
+       -  b\ :sub:`7`
+
+       -  b\ :sub:`6`
+
+       -  b\ :sub:`5`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-SGBRG10-1X10`:
+
+       -  MEDIA_BUS_FMT_SGBRG10_1X10
+
+       -  0x300e
+
+       -  
+       -  -
+
+       -  -
+
+       -  g\ :sub:`9`
+
+       -  g\ :sub:`8`
+
+       -  g\ :sub:`7`
+
+       -  g\ :sub:`6`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-SGRBG10-1X10`:
+
+       -  MEDIA_BUS_FMT_SGRBG10_1X10
+
+       -  0x300a
+
+       -  
+       -  -
+
+       -  -
+
+       -  g\ :sub:`9`
+
+       -  g\ :sub:`8`
+
+       -  g\ :sub:`7`
+
+       -  g\ :sub:`6`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-SRGGB10-1X10`:
+
+       -  MEDIA_BUS_FMT_SRGGB10_1X10
+
+       -  0x300f
+
+       -  
+       -  -
+
+       -  -
+
+       -  r\ :sub:`9`
+
+       -  r\ :sub:`8`
+
+       -  r\ :sub:`7`
+
+       -  r\ :sub:`6`
+
+       -  r\ :sub:`5`
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-SBGGR12-1X12`:
+
+       -  MEDIA_BUS_FMT_SBGGR12_1X12
+
+       -  0x3008
+
+       -  
+       -  b\ :sub:`11`
+
+       -  b\ :sub:`10`
+
+       -  b\ :sub:`9`
+
+       -  b\ :sub:`8`
+
+       -  b\ :sub:`7`
+
+       -  b\ :sub:`6`
+
+       -  b\ :sub:`5`
+
+       -  b\ :sub:`4`
+
+       -  b\ :sub:`3`
+
+       -  b\ :sub:`2`
+
+       -  b\ :sub:`1`
+
+       -  b\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-SGBRG12-1X12`:
+
+       -  MEDIA_BUS_FMT_SGBRG12_1X12
+
+       -  0x3010
+
+       -  
+       -  g\ :sub:`11`
+
+       -  g\ :sub:`10`
+
+       -  g\ :sub:`9`
+
+       -  g\ :sub:`8`
+
+       -  g\ :sub:`7`
+
+       -  g\ :sub:`6`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-SGRBG12-1X12`:
+
+       -  MEDIA_BUS_FMT_SGRBG12_1X12
+
+       -  0x3011
+
+       -  
+       -  g\ :sub:`11`
+
+       -  g\ :sub:`10`
+
+       -  g\ :sub:`9`
+
+       -  g\ :sub:`8`
+
+       -  g\ :sub:`7`
+
+       -  g\ :sub:`6`
+
+       -  g\ :sub:`5`
+
+       -  g\ :sub:`4`
+
+       -  g\ :sub:`3`
+
+       -  g\ :sub:`2`
+
+       -  g\ :sub:`1`
+
+       -  g\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-SRGGB12-1X12`:
+
+       -  MEDIA_BUS_FMT_SRGGB12_1X12
+
+       -  0x3012
+
+       -  
+       -  r\ :sub:`11`
+
+       -  r\ :sub:`10`
+
+       -  r\ :sub:`9`
+
+       -  r\ :sub:`8`
+
+       -  r\ :sub:`7`
+
+       -  r\ :sub:`6`
+
+       -  r\ :sub:`5`
+
+       -  r\ :sub:`4`
+
+       -  r\ :sub:`3`
+
+       -  r\ :sub:`2`
+
+       -  r\ :sub:`1`
+
+       -  r\ :sub:`0`
+
+
+
+Packed YUV Formats
+^^^^^^^^^^^^^^^^^^
+
+Those data formats transfer pixel data as (possibly downsampled) Y, U
+and V components. Some formats include dummy bits in some of their
+samples and are collectively referred to as "YDYC" (Y-Dummy-Y-Chroma)
+formats. One cannot rely on the values of these dummy bits as those are
+undefined.
+
+The format code is made of the following information.
+
+-  The Y, U and V components order code, as transferred on the bus.
+   Possible values are YUYV, UYVY, YVYU and VYUY for formats with no
+   dummy bit, and YDYUYDYV, YDYVYDYU, YUYDYVYD and YVYDYUYD for YDYC
+   formats.
+
+-  The number of bits per pixel component. All components are
+   transferred on the same number of bits. Common values are 8, 10 and
+   12.
+
+-  The number of bus samples per pixel. Pixels that are wider than the
+   bus width must be transferred in multiple samples. Common values are
+   1, 1.5 (encoded as 1_5) and 2.
+
+-  The bus width. When the bus width is larger than the number of bits
+   per pixel component, several components are packed in a single bus
+   sample. The components are ordered as specified by the order code,
+   with components on the left of the code transferred in the high order
+   bits. Common values are 8 and 16.
+
+For instance, a format where pixels are encoded as 8-bit YUV values
+downsampled to 4:2:2 and transferred as 2 8-bit bus samples per pixel in
+the U, Y, V, Y order will be named ``MEDIA_BUS_FMT_UYVY8_2X8``.
+
+:ref:`v4l2-mbus-pixelcode-yuv8` lists existing packed YUV formats and
+describes the organization of each pixel data in each sample. When a
+format pattern is split across multiple samples each of the samples in
+the pattern is described.
+
+The role of each bit transferred over the bus is identified by one of
+the following codes.
+
+-  y\ :sub:`x` for luma component bit number x
+
+-  u\ :sub:`x` for blue chroma component bit number x
+
+-  v\ :sub:`x` for red chroma component bit number x
+
+-  a\ :sub:`x` for alpha component bit number x
+
+-  - for non-available bits (for positions higher than the bus width)
+
+-  d for dummy bits
+
+
+.. _v4l2-mbus-pixelcode-yuv8:
+
+.. flat-table:: YUV Formats
+    :header-rows:  2
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  Identifier
+
+       -  Code
+
+       -  
+       -  :cspan:`31` Data organization
+
+    -  .. row 2
+
+       -  
+       -  
+       -  Bit
+
+       -  31
+
+       -  30
+
+       -  29
+
+       -  28
+
+       -  27
+
+       -  26
+
+       -  25
+
+       -  24
+
+       -  23
+
+       -  22
+
+       -  21
+
+       -  10
+
+       -  19
+
+       -  18
+
+       -  17
+
+       -  16
+
+       -  15
+
+       -  14
+
+       -  13
+
+       -  12
+
+       -  11
+
+       -  10
+
+       -  9
+
+       -  8
+
+       -  7
+
+       -  6
+
+       -  5
+
+       -  4
+
+       -  3
+
+       -  2
+
+       -  1
+
+       -  0
+
+    -  .. _`MEDIA-BUS-FMT-Y8-1X8`:
+
+       -  MEDIA_BUS_FMT_Y8_1X8
+
+       -  0x2001
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-UV8-1X8`:
+
+       -  MEDIA_BUS_FMT_UV8_1X8
+
+       -  0x2015
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+    -  .. row 5
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-UYVY8-1_5X8`:
+
+       -  MEDIA_BUS_FMT_UYVY8_1_5X8
+
+       -  0x2002
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+    -  .. row 7
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 8
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 9
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+    -  .. row 10
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 11
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-VYUY8-1_5X8`:
+
+       -  MEDIA_BUS_FMT_VYUY8_1_5X8
+
+       -  0x2003
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+    -  .. row 13
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 14
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 15
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+    -  .. row 16
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 17
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-YUYV8-1_5X8`:
+
+       -  MEDIA_BUS_FMT_YUYV8_1_5X8
+
+       -  0x2004
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 19
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 20
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+    -  .. row 21
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 22
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 23
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-YVYU8-1_5X8`:
+
+       -  MEDIA_BUS_FMT_YVYU8_1_5X8
+
+       -  0x2005
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 25
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 26
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+    -  .. row 27
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 28
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 29
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-UYVY8-2X8`:
+
+       -  MEDIA_BUS_FMT_UYVY8_2X8
+
+       -  0x2006
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+    -  .. row 31
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 32
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+    -  .. row 33
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-VYUY8-2X8`:
+
+       -  MEDIA_BUS_FMT_VYUY8_2X8
+
+       -  0x2007
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+    -  .. row 35
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 36
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+    -  .. row 37
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-YUYV8-2X8`:
+
+       -  MEDIA_BUS_FMT_YUYV8_2X8
+
+       -  0x2008
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 39
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+    -  .. row 40
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 41
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-YVYU8-2X8`:
+
+       -  MEDIA_BUS_FMT_YVYU8_2X8
+
+       -  0x2009
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 43
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+    -  .. row 44
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 45
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-Y10-1X10`:
+
+       -  MEDIA_BUS_FMT_Y10_1X10
+
+       -  0x200a
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-UYVY10-2X10`:
+
+       -  MEDIA_BUS_FMT_UYVY10_2X10
+
+       -  0x2018
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  u\ :sub:`9`
+
+       -  u\ :sub:`8`
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+    -  .. row 48
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 49
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  v\ :sub:`9`
+
+       -  v\ :sub:`8`
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+    -  .. row 50
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-VYUY10-2X10`:
+
+       -  MEDIA_BUS_FMT_VYUY10_2X10
+
+       -  0x2019
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  v\ :sub:`9`
+
+       -  v\ :sub:`8`
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+    -  .. row 52
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 53
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  u\ :sub:`9`
+
+       -  u\ :sub:`8`
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+    -  .. row 54
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-YUYV10-2X10`:
+
+       -  MEDIA_BUS_FMT_YUYV10_2X10
+
+       -  0x200b
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 56
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  u\ :sub:`9`
+
+       -  u\ :sub:`8`
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+    -  .. row 57
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 58
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  v\ :sub:`9`
+
+       -  v\ :sub:`8`
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-YVYU10-2X10`:
+
+       -  MEDIA_BUS_FMT_YVYU10_2X10
+
+       -  0x200c
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 60
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  v\ :sub:`9`
+
+       -  v\ :sub:`8`
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+    -  .. row 61
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 62
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  u\ :sub:`9`
+
+       -  u\ :sub:`8`
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-Y12-1X12`:
+
+       -  MEDIA_BUS_FMT_Y12_1X12
+
+       -  0x2013
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`11`
+
+       -  y\ :sub:`10`
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-UYVY12-2X12`:
+
+       -  MEDIA_BUS_FMT_UYVY12_2X12
+
+       -  0x201c
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  u\ :sub:`11`
+
+       -  u\ :sub:`10`
+
+       -  u\ :sub:`9`
+
+       -  u\ :sub:`8`
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+    -  .. row 65
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`11`
+
+       -  y\ :sub:`10`
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 66
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  v\ :sub:`11`
+
+       -  v\ :sub:`10`
+
+       -  v\ :sub:`9`
+
+       -  v\ :sub:`8`
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+    -  .. row 67
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`11`
+
+       -  y\ :sub:`10`
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-VYUY12-2X12`:
+
+       -  MEDIA_BUS_FMT_VYUY12_2X12
+
+       -  0x201d
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  v\ :sub:`11`
+
+       -  v\ :sub:`10`
+
+       -  v\ :sub:`9`
+
+       -  v\ :sub:`8`
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+    -  .. row 69
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`11`
+
+       -  y\ :sub:`10`
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 70
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  u\ :sub:`11`
+
+       -  u\ :sub:`10`
+
+       -  u\ :sub:`9`
+
+       -  u\ :sub:`8`
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+    -  .. row 71
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`11`
+
+       -  y\ :sub:`10`
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-YUYV12-2X12`:
+
+       -  MEDIA_BUS_FMT_YUYV12_2X12
+
+       -  0x201e
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`11`
+
+       -  y\ :sub:`10`
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 73
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  u\ :sub:`11`
+
+       -  u\ :sub:`10`
+
+       -  u\ :sub:`9`
+
+       -  u\ :sub:`8`
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+    -  .. row 74
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`11`
+
+       -  y\ :sub:`10`
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 75
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  v\ :sub:`11`
+
+       -  v\ :sub:`10`
+
+       -  v\ :sub:`9`
+
+       -  v\ :sub:`8`
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-YVYU12-2X12`:
+
+       -  MEDIA_BUS_FMT_YVYU12_2X12
+
+       -  0x201f
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`11`
+
+       -  y\ :sub:`10`
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 77
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  v\ :sub:`11`
+
+       -  v\ :sub:`10`
+
+       -  v\ :sub:`9`
+
+       -  v\ :sub:`8`
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+    -  .. row 78
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`11`
+
+       -  y\ :sub:`10`
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 79
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  u\ :sub:`11`
+
+       -  u\ :sub:`10`
+
+       -  u\ :sub:`9`
+
+       -  u\ :sub:`8`
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-UYVY8-1X16`:
+
+       -  MEDIA_BUS_FMT_UYVY8_1X16
+
+       -  0x200f
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 81
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-VYUY8-1X16`:
+
+       -  MEDIA_BUS_FMT_VYUY8_1X16
+
+       -  0x2010
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 83
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-YUYV8-1X16`:
+
+       -  MEDIA_BUS_FMT_YUYV8_1X16
+
+       -  0x2011
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+    -  .. row 85
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-YVYU8-1X16`:
+
+       -  MEDIA_BUS_FMT_YVYU8_1X16
+
+       -  0x2012
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+    -  .. row 87
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-YDYUYDYV8-1X16`:
+
+       -  MEDIA_BUS_FMT_YDYUYDYV8_1X16
+
+       -  0x2014
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+       -  d
+
+       -  d
+
+       -  d
+
+       -  d
+
+       -  d
+
+       -  d
+
+       -  d
+
+       -  d
+
+    -  .. row 89
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+    -  .. row 90
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+       -  d
+
+       -  d
+
+       -  d
+
+       -  d
+
+       -  d
+
+       -  d
+
+       -  d
+
+       -  d
+
+    -  .. row 91
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-UYVY10-1X20`:
+
+       -  MEDIA_BUS_FMT_UYVY10_1X20
+
+       -  0x201a
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  u\ :sub:`9`
+
+       -  u\ :sub:`8`
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 93
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  v\ :sub:`9`
+
+       -  v\ :sub:`8`
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-VYUY10-1X20`:
+
+       -  MEDIA_BUS_FMT_VYUY10_1X20
+
+       -  0x201b
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  v\ :sub:`9`
+
+       -  v\ :sub:`8`
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 95
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  u\ :sub:`9`
+
+       -  u\ :sub:`8`
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-YUYV10-1X20`:
+
+       -  MEDIA_BUS_FMT_YUYV10_1X20
+
+       -  0x200d
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+       -  u\ :sub:`9`
+
+       -  u\ :sub:`8`
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+    -  .. row 97
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+       -  v\ :sub:`9`
+
+       -  v\ :sub:`8`
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-YVYU10-1X20`:
+
+       -  MEDIA_BUS_FMT_YVYU10_1X20
+
+       -  0x200e
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+       -  v\ :sub:`9`
+
+       -  v\ :sub:`8`
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+    -  .. row 99
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+       -  u\ :sub:`9`
+
+       -  u\ :sub:`8`
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-VUY8-1X24`:
+
+       -  MEDIA_BUS_FMT_VUY8_1X24
+
+       -  0x201a
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-YUV8-1X24`:
+
+       -  MEDIA_BUS_FMT_YUV8_1X24
+
+       -  0x2025
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-UYVY12-1X24`:
+
+       -  MEDIA_BUS_FMT_UYVY12_1X24
+
+       -  0x2020
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  u\ :sub:`11`
+
+       -  u\ :sub:`10`
+
+       -  u\ :sub:`9`
+
+       -  u\ :sub:`8`
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+       -  y\ :sub:`11`
+
+       -  y\ :sub:`10`
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 103
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  v\ :sub:`11`
+
+       -  v\ :sub:`10`
+
+       -  v\ :sub:`9`
+
+       -  v\ :sub:`8`
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+       -  y\ :sub:`11`
+
+       -  y\ :sub:`10`
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-VYUY12-1X24`:
+
+       -  MEDIA_BUS_FMT_VYUY12_1X24
+
+       -  0x2021
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  v\ :sub:`11`
+
+       -  v\ :sub:`10`
+
+       -  v\ :sub:`9`
+
+       -  v\ :sub:`8`
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+       -  y\ :sub:`11`
+
+       -  y\ :sub:`10`
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. row 105
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  u\ :sub:`11`
+
+       -  u\ :sub:`10`
+
+       -  u\ :sub:`9`
+
+       -  u\ :sub:`8`
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+       -  y\ :sub:`11`
+
+       -  y\ :sub:`10`
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-YUYV12-1X24`:
+
+       -  MEDIA_BUS_FMT_YUYV12_1X24
+
+       -  0x2022
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`11`
+
+       -  y\ :sub:`10`
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+       -  u\ :sub:`11`
+
+       -  u\ :sub:`10`
+
+       -  u\ :sub:`9`
+
+       -  u\ :sub:`8`
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+    -  .. row 107
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`11`
+
+       -  y\ :sub:`10`
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+       -  v\ :sub:`11`
+
+       -  v\ :sub:`10`
+
+       -  v\ :sub:`9`
+
+       -  v\ :sub:`8`
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-YVYU12-1X24`:
+
+       -  MEDIA_BUS_FMT_YVYU12_1X24
+
+       -  0x2023
+
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`11`
+
+       -  y\ :sub:`10`
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+       -  v\ :sub:`11`
+
+       -  v\ :sub:`10`
+
+       -  v\ :sub:`9`
+
+       -  v\ :sub:`8`
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+    -  .. row 109
+
+       -  
+       -  
+       -  
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  -
+
+       -  y\ :sub:`11`
+
+       -  y\ :sub:`10`
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+       -  u\ :sub:`11`
+
+       -  u\ :sub:`10`
+
+       -  u\ :sub:`9`
+
+       -  u\ :sub:`8`
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-YUV10-1X30`:
+
+       -  MEDIA_BUS_FMT_YUV10_1X30
+
+       -  0x2016
+
+       -  
+       -  -
+
+       -  -
+
+       -  y\ :sub:`9`
+
+       -  y\ :sub:`8`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+       -  u\ :sub:`9`
+
+       -  u\ :sub:`8`
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+       -  v\ :sub:`9`
+
+       -  v\ :sub:`8`
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+    -  .. _`MEDIA-BUS-FMT-AYUV8-1X32`:
+
+       -  MEDIA_BUS_FMT_AYUV8_1X32
+
+       -  0x2017
+
+       -  
+       -  a\ :sub:`7`
+
+       -  a\ :sub:`6`
+
+       -  a\ :sub:`5`
+
+       -  a\ :sub:`4`
+
+       -  a\ :sub:`3`
+
+       -  a\ :sub:`2`
+
+       -  a\ :sub:`1`
+
+       -  a\ :sub:`0`
+
+       -  y\ :sub:`7`
+
+       -  y\ :sub:`6`
+
+       -  y\ :sub:`5`
+
+       -  y\ :sub:`4`
+
+       -  y\ :sub:`3`
+
+       -  y\ :sub:`2`
+
+       -  y\ :sub:`1`
+
+       -  y\ :sub:`0`
+
+       -  u\ :sub:`7`
+
+       -  u\ :sub:`6`
+
+       -  u\ :sub:`5`
+
+       -  u\ :sub:`4`
+
+       -  u\ :sub:`3`
+
+       -  u\ :sub:`2`
+
+       -  u\ :sub:`1`
+
+       -  u\ :sub:`0`
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+
+
+HSV/HSL Formats
+^^^^^^^^^^^^^^^
+
+Those formats transfer pixel data as RGB values in a
+cylindrical-coordinate system using Hue-Saturation-Value or
+Hue-Saturation-Lightness components. The format code is made of the
+following information.
+
+-  The hue, saturation, value or lightness and optional alpha components
+   order code, as encoded in a pixel sample. The only currently
+   supported value is AHSV.
+
+-  The number of bits per component, for each component. The values can
+   be different for all components. The only currently supported value
+   is 8888.
+
+-  The number of bus samples per pixel. Pixels that are wider than the
+   bus width must be transferred in multiple samples. The only currently
+   supported value is 1.
+
+-  The bus width.
+
+-  For formats where the total number of bits per pixel is smaller than
+   the number of bus samples per pixel times the bus width, a padding
+   value stating if the bytes are padded in their most high order bits
+   (PADHI) or low order bits (PADLO).
+
+-  For formats where the number of bus samples per pixel is larger than
+   1, an endianness value stating if the pixel is transferred MSB first
+   (BE) or LSB first (LE).
+
+The following table lists existing HSV/HSL formats.
+
+
+.. _v4l2-mbus-pixelcode-hsv:
+
+.. flat-table:: HSV/HSL formats
+    :header-rows:  2
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  Identifier
+
+       -  Code
+
+       -  
+       -  :cspan:`31` Data organization
+
+    -  .. row 2
+
+       -  
+       -  
+       -  Bit
+
+       -  31
+
+       -  30
+
+       -  29
+
+       -  28
+
+       -  27
+
+       -  26
+
+       -  25
+
+       -  24
+
+       -  23
+
+       -  22
+
+       -  21
+
+       -  20
+
+       -  19
+
+       -  18
+
+       -  17
+
+       -  16
+
+       -  15
+
+       -  14
+
+       -  13
+
+       -  12
+
+       -  11
+
+       -  10
+
+       -  9
+
+       -  8
+
+       -  7
+
+       -  6
+
+       -  5
+
+       -  4
+
+       -  3
+
+       -  2
+
+       -  1
+
+       -  0
+
+    -  .. _`MEDIA-BUS-FMT-AHSV8888-1X32`:
+
+       -  MEDIA_BUS_FMT_AHSV8888_1X32
+
+       -  0x6001
+
+       -  
+       -  a\ :sub:`7`
+
+       -  a\ :sub:`6`
+
+       -  a\ :sub:`5`
+
+       -  a\ :sub:`4`
+
+       -  a\ :sub:`3`
+
+       -  a\ :sub:`2`
+
+       -  a\ :sub:`1`
+
+       -  a\ :sub:`0`
+
+       -  h\ :sub:`7`
+
+       -  h\ :sub:`6`
+
+       -  h\ :sub:`5`
+
+       -  h\ :sub:`4`
+
+       -  h\ :sub:`3`
+
+       -  h\ :sub:`2`
+
+       -  h\ :sub:`1`
+
+       -  h\ :sub:`0`
+
+       -  s\ :sub:`7`
+
+       -  s\ :sub:`6`
+
+       -  s\ :sub:`5`
+
+       -  s\ :sub:`4`
+
+       -  s\ :sub:`3`
+
+       -  s\ :sub:`2`
+
+       -  s\ :sub:`1`
+
+       -  s\ :sub:`0`
+
+       -  v\ :sub:`7`
+
+       -  v\ :sub:`6`
+
+       -  v\ :sub:`5`
+
+       -  v\ :sub:`4`
+
+       -  v\ :sub:`3`
+
+       -  v\ :sub:`2`
+
+       -  v\ :sub:`1`
+
+       -  v\ :sub:`0`
+
+
+
+JPEG Compressed Formats
+^^^^^^^^^^^^^^^^^^^^^^^
+
+Those data formats consist of an ordered sequence of 8-bit bytes
+obtained from JPEG compression process. Additionally to the ``_JPEG``
+postfix the format code is made of the following information.
+
+-  The number of bus samples per entropy encoded byte.
+
+-  The bus width.
+
+For instance, for a JPEG baseline process and an 8-bit bus width the
+format will be named ``MEDIA_BUS_FMT_JPEG_1X8``.
+
+The following table lists existing JPEG compressed formats.
+
+
+.. _v4l2-mbus-pixelcode-jpeg:
+
+.. flat-table:: JPEG Formats
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  Identifier
+
+       -  Code
+
+       -  Remarks
+
+    -  .. _`MEDIA-BUS-FMT-JPEG-1X8`:
+
+       -  MEDIA_BUS_FMT_JPEG_1X8
+
+       -  0x4001
+
+       -  Besides of its usage for the parallel bus this format is
+          recommended for transmission of JPEG data over MIPI CSI bus using
+          the User Defined 8-bit Data types.
+
+
+
+.. _v4l2-mbus-vendor-spec-fmts:
+
+Vendor and Device Specific Formats
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+This section lists complex data formats that are either vendor or device
+specific.
+
+The following table lists the existing vendor and device specific
+formats.
+
+
+.. _v4l2-mbus-pixelcode-vendor-specific:
+
+.. flat-table:: Vendor and device specific formats
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  Identifier
+
+       -  Code
+
+       -  Comments
+
+    -  .. _`MEDIA-BUS-FMT-S5C-UYVY-JPEG-1X8`:
+
+       -  MEDIA_BUS_FMT_S5C_UYVY_JPEG_1X8
+
+       -  0x5001
+
+       -  Interleaved raw UYVY and JPEG image format with embedded meta-data
+          used by Samsung S3C73MX camera sensors.
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/subdev-formats_files/bayer.png b/Documentation/linux_tv/media/v4l/subdev-formats_files/bayer.png
new file mode 100644
index 0000000000000000000000000000000000000000..9b15fb22e8173c83c3da6df73cd7cdc7d8f41736
GIT binary patch
literal 9725
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
Ulq-hwxG4posiv!1sSJ(ye?2;OE&u=k

literal 0
HcmV?d00001

diff --git a/Documentation/linux_tv/media/v4l/tuner.rst b/Documentation/linux_tv/media/v4l/tuner.rst
new file mode 100644
index 000000000000..bc22a99579e3
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/tuner.rst
@@ -0,0 +1,91 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _tuner:
+
+*********************
+Tuners and Modulators
+*********************
+
+
+Tuners
+======
+
+Video input devices can have one or more tuners demodulating a RF
+signal. Each tuner is associated with one or more video inputs,
+depending on the number of RF connectors on the tuner. The ``type``
+field of the respective struct :ref:`v4l2_input <v4l2-input>`
+returned by the :ref:`VIDIOC_ENUMINPUT <vidioc-enuminput>` ioctl is
+set to ``V4L2_INPUT_TYPE_TUNER`` and its ``tuner`` field contains the
+index number of the tuner.
+
+Radio input devices have exactly one tuner with index zero, no video
+inputs.
+
+To query and change tuner properties applications use the
+:ref:`VIDIOC_G_TUNER <vidioc-g-tuner>` and
+:ref:`VIDIOC_S_TUNER <vidioc-g-tuner>` ioctls, respectively. The
+struct :ref:`v4l2_tuner <v4l2-tuner>` returned by ``VIDIOC_G_TUNER``
+also contains signal status information applicable when the tuner of the
+current video or radio input is queried. Note that ``VIDIOC_S_TUNER``
+does not switch the current tuner, when there is more than one at all.
+The tuner is solely determined by the current video input. Drivers must
+support both ioctls and set the ``V4L2_CAP_TUNER`` flag in the struct
+:ref:`v4l2_capability <v4l2-capability>` returned by the
+:ref:`VIDIOC_QUERYCAP <vidioc-querycap>` ioctl when the device has
+one or more tuners.
+
+
+Modulators
+==========
+
+Video output devices can have one or more modulators, uh, modulating a
+video signal for radiation or connection to the antenna input of a TV
+set or video recorder. Each modulator is associated with one or more
+video outputs, depending on the number of RF connectors on the
+modulator. The ``type`` field of the respective struct
+:ref:`v4l2_output <v4l2-output>` returned by the
+:ref:`VIDIOC_ENUMOUTPUT <vidioc-enumoutput>` ioctl is set to
+``V4L2_OUTPUT_TYPE_MODULATOR`` and its ``modulator`` field contains the
+index number of the modulator.
+
+Radio output devices have exactly one modulator with index zero, no
+video outputs.
+
+A video or radio device cannot support both a tuner and a modulator. Two
+separate device nodes will have to be used for such hardware, one that
+supports the tuner functionality and one that supports the modulator
+functionality. The reason is a limitation with the
+:ref:`VIDIOC_S_FREQUENCY <vidioc-g-frequency>` ioctl where you
+cannot specify whether the frequency is for a tuner or a modulator.
+
+To query and change modulator properties applications use the
+:ref:`VIDIOC_G_MODULATOR <vidioc-g-modulator>` and
+:ref:`VIDIOC_S_MODULATOR <vidioc-g-modulator>` ioctl. Note that
+``VIDIOC_S_MODULATOR`` does not switch the current modulator, when there
+is more than one at all. The modulator is solely determined by the
+current video output. Drivers must support both ioctls and set the
+``V4L2_CAP_MODULATOR`` flag in the struct
+:ref:`v4l2_capability <v4l2-capability>` returned by the
+:ref:`VIDIOC_QUERYCAP <vidioc-querycap>` ioctl when the device has
+one or more modulators.
+
+
+Radio Frequency
+===============
+
+To get and set the tuner or modulator radio frequency applications use
+the :ref:`VIDIOC_G_FREQUENCY <vidioc-g-frequency>` and
+:ref:`VIDIOC_S_FREQUENCY <vidioc-g-frequency>` ioctl which both take
+a pointer to a struct :ref:`v4l2_frequency <v4l2-frequency>`. These
+ioctls are used for TV and radio devices alike. Drivers must support
+both ioctls when the tuner or modulator ioctls are supported, or when
+the device is a radio device.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/user-func.rst b/Documentation/linux_tv/media/v4l/user-func.rst
new file mode 100644
index 000000000000..daa6fd465d30
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/user-func.rst
@@ -0,0 +1,92 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _user-func:
+
+******************
+Function Reference
+******************
+
+
+.. toctree::
+    :maxdepth: 1
+
+    func-close
+    func-ioctl
+    vidioc-create-bufs
+    vidioc-cropcap
+    vidioc-dbg-g-chip-info
+    vidioc-dbg-g-register
+    vidioc-decoder-cmd
+    vidioc-dqevent
+    vidioc-dv-timings-cap
+    vidioc-encoder-cmd
+    vidioc-enumaudio
+    vidioc-enumaudioout
+    vidioc-enum-dv-timings
+    vidioc-enum-fmt
+    vidioc-enum-framesizes
+    vidioc-enum-frameintervals
+    vidioc-enum-freq-bands
+    vidioc-enuminput
+    vidioc-enumoutput
+    vidioc-enumstd
+    vidioc-expbuf
+    vidioc-g-audio
+    vidioc-g-audioout
+    vidioc-g-crop
+    vidioc-g-ctrl
+    vidioc-g-dv-timings
+    vidioc-g-edid
+    vidioc-g-enc-index
+    vidioc-g-ext-ctrls
+    vidioc-g-fbuf
+    vidioc-g-fmt
+    vidioc-g-frequency
+    vidioc-g-input
+    vidioc-g-jpegcomp
+    vidioc-g-modulator
+    vidioc-g-output
+    vidioc-g-parm
+    vidioc-g-priority
+    vidioc-g-selection
+    vidioc-g-sliced-vbi-cap
+    vidioc-g-std
+    vidioc-g-tuner
+    vidioc-log-status
+    vidioc-overlay
+    vidioc-prepare-buf
+    vidioc-qbuf
+    vidioc-querybuf
+    vidioc-querycap
+    vidioc-queryctrl
+    vidioc-query-dv-timings
+    vidioc-querystd
+    vidioc-reqbufs
+    vidioc-s-hw-freq-seek
+    vidioc-streamon
+    vidioc-subdev-enum-frame-interval
+    vidioc-subdev-enum-frame-size
+    vidioc-subdev-enum-mbus-code
+    vidioc-subdev-g-crop
+    vidioc-subdev-g-fmt
+    vidioc-subdev-g-frame-interval
+    vidioc-subdev-g-selection
+    vidioc-subscribe-event
+    func-mmap
+    func-munmap
+    func-open
+    func-poll
+    func-read
+    func-select
+    func-write
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/userp.rst b/Documentation/linux_tv/media/v4l/userp.rst
new file mode 100644
index 000000000000..83558d27bd69
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/userp.rst
@@ -0,0 +1,123 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _userp:
+
+*****************************
+Streaming I/O (User Pointers)
+*****************************
+
+Input and output devices support this I/O method when the
+``V4L2_CAP_STREAMING`` flag in the ``capabilities`` field of struct
+:ref:`v4l2_capability <v4l2-capability>` returned by the
+:ref:`VIDIOC_QUERYCAP <vidioc-querycap>` ioctl is set. If the
+particular user pointer method (not only memory mapping) is supported
+must be determined by calling the
+:ref:`VIDIOC_REQBUFS <vidioc-reqbufs>` ioctl.
+
+This I/O method combines advantages of the read/write and memory mapping
+methods. Buffers (planes) are allocated by the application itself, and
+can reside for example in virtual or shared memory. Only pointers to
+data are exchanged, these pointers and meta-information are passed in
+struct :ref:`v4l2_buffer <v4l2-buffer>` (or in struct
+:ref:`v4l2_plane <v4l2-plane>` in the multi-planar API case). The
+driver must be switched into user pointer I/O mode by calling the
+:ref:`VIDIOC_REQBUFS <vidioc-reqbufs>` with the desired buffer type.
+No buffers (planes) are allocated beforehand, consequently they are not
+indexed and cannot be queried like mapped buffers with the
+``VIDIOC_QUERYBUF`` ioctl.
+
+
+.. code-block:: c
+
+    struct v4l2_requestbuffers reqbuf;
+
+    memset (&reqbuf, 0, sizeof (reqbuf));
+    reqbuf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
+    reqbuf.memory = V4L2_MEMORY_USERPTR;
+
+    if (ioctl (fd, VIDIOC_REQBUFS, &reqbuf) == -1) {
+        if (errno == EINVAL)
+            printf ("Video capturing or user pointer streaming is not supported\\n");
+        else
+            perror ("VIDIOC_REQBUFS");
+
+        exit (EXIT_FAILURE);
+    }
+
+Buffer (plane) addresses and sizes are passed on the fly with the
+:ref:`VIDIOC_QBUF <vidioc-qbuf>` ioctl. Although buffers are commonly
+cycled, applications can pass different addresses and sizes at each
+``VIDIOC_QBUF`` call. If required by the hardware the driver swaps
+memory pages within physical memory to create a continuous area of
+memory. This happens transparently to the application in the virtual
+memory subsystem of the kernel. When buffer pages have been swapped out
+to disk they are brought back and finally locked in physical memory for
+DMA. [1]_
+
+Filled or displayed buffers are dequeued with the
+:ref:`VIDIOC_DQBUF <vidioc-qbuf>` ioctl. The driver can unlock the
+memory pages at any time between the completion of the DMA and this
+ioctl. The memory is also unlocked when
+:ref:`VIDIOC_STREAMOFF <vidioc-streamon>` is called,
+:ref:`VIDIOC_REQBUFS <vidioc-reqbufs>`, or when the device is closed.
+Applications must take care not to free buffers without dequeuing. For
+once, the buffers remain locked until further, wasting physical memory.
+Second the driver will not be notified when the memory is returned to
+the application's free list and subsequently reused for other purposes,
+possibly completing the requested DMA and overwriting valuable data.
+
+For capturing applications it is customary to enqueue a number of empty
+buffers, to start capturing and enter the read loop. Here the
+application waits until a filled buffer can be dequeued, and re-enqueues
+the buffer when the data is no longer needed. Output applications fill
+and enqueue buffers, when enough buffers are stacked up output is
+started. In the write loop, when the application runs out of free
+buffers it must wait until an empty buffer can be dequeued and reused.
+Two methods exist to suspend execution of the application until one or
+more buffers can be dequeued. By default ``VIDIOC_DQBUF`` blocks when no
+buffer is in the outgoing queue. When the ``O_NONBLOCK`` flag was given
+to the :ref:`open() <func-open>` function, ``VIDIOC_DQBUF`` returns
+immediately with an EAGAIN error code when no buffer is available. The
+:ref:`select() <func-select>` or :ref:`poll() <func-poll>` function
+are always available.
+
+To start and stop capturing or output applications call the
+:ref:`VIDIOC_STREAMON <vidioc-streamon>` and
+:ref:`VIDIOC_STREAMOFF <vidioc-streamon>` ioctl. Note
+``VIDIOC_STREAMOFF`` removes all buffers from both queues and unlocks
+all buffers as a side effect. Since there is no notion of doing anything
+"now" on a multitasking system, if an application needs to synchronize
+with another event it should examine the struct
+:ref:`v4l2_buffer <v4l2-buffer>` ``timestamp`` of captured or
+outputted buffers.
+
+Drivers implementing user pointer I/O must support the
+``VIDIOC_REQBUFS``, ``VIDIOC_QBUF``, ``VIDIOC_DQBUF``,
+``VIDIOC_STREAMON`` and ``VIDIOC_STREAMOFF`` ioctl, the
+:c:func:`select()` and :c:func:`poll()` function. [2]_
+
+.. [1]
+   We expect that frequently used buffers are typically not swapped out.
+   Anyway, the process of swapping, locking or generating scatter-gather
+   lists may be time consuming. The delay can be masked by the depth of
+   the incoming buffer queue, and perhaps by maintaining caches assuming
+   a buffer will be soon enqueued again. On the other hand, to optimize
+   memory usage drivers can limit the number of buffers locked in
+   advance and recycle the most recently used buffers first. Of course,
+   the pages of empty buffers in the incoming queue need not be saved to
+   disk. Output buffers must be saved on the incoming and outgoing queue
+   because an application may share them with other processes.
+
+.. [2]
+   At the driver level :c:func:`select()` and :c:func:`poll()` are
+   the same, and :c:func:`select()` is too important to be optional.
+   The rest should be evident.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/v4l2-selection-flags.rst b/Documentation/linux_tv/media/v4l/v4l2-selection-flags.rst
new file mode 100644
index 000000000000..d72d3fb0d057
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/v4l2-selection-flags.rst
@@ -0,0 +1,82 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _v4l2-selection-flags:
+
+***************
+Selection flags
+***************
+
+
+.. _v4l2-selection-flags-table:
+
+.. flat-table:: Selection flag definitions
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  Flag name
+
+       -  id
+
+       -  Definition
+
+       -  Valid for V4L2
+
+       -  Valid for V4L2 subdev
+
+    -  .. row 2
+
+       -  ``V4L2_SEL_FLAG_GE``
+
+       -  (1 << 0)
+
+       -  Suggest the driver it should choose greater or equal rectangle (in
+          size) than was requested. Albeit the driver may choose a lesser
+          size, it will only do so due to hardware limitations. Without this
+          flag (and ``V4L2_SEL_FLAG_LE``) the behaviour is to choose the
+          closest possible rectangle.
+
+       -  Yes
+
+       -  Yes
+
+    -  .. row 3
+
+       -  ``V4L2_SEL_FLAG_LE``
+
+       -  (1 << 1)
+
+       -  Suggest the driver it should choose lesser or equal rectangle (in
+          size) than was requested. Albeit the driver may choose a greater
+          size, it will only do so due to hardware limitations.
+
+       -  Yes
+
+       -  Yes
+
+    -  .. row 4
+
+       -  ``V4L2_SEL_FLAG_KEEP_CONFIG``
+
+       -  (1 << 2)
+
+       -  The configuration must not be propagated to any further processing
+          steps. If this flag is not given, the configuration is propagated
+          inside the subdevice to all further processing steps.
+
+       -  No
+
+       -  Yes
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/v4l2-selection-targets.rst b/Documentation/linux_tv/media/v4l/v4l2-selection-targets.rst
new file mode 100644
index 000000000000..781c4c713394
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/v4l2-selection-targets.rst
@@ -0,0 +1,146 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _v4l2-selection-targets:
+
+*****************
+Selection targets
+*****************
+
+The precise meaning of the selection targets may be dependent on which
+of the two interfaces they are used.
+
+
+.. _v4l2-selection-targets-table:
+
+.. flat-table:: Selection target definitions
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  Target name
+
+       -  id
+
+       -  Definition
+
+       -  Valid for V4L2
+
+       -  Valid for V4L2 subdev
+
+    -  .. row 2
+
+       -  ``V4L2_SEL_TGT_CROP``
+
+       -  0x0000
+
+       -  Crop rectangle. Defines the cropped area.
+
+       -  Yes
+
+       -  Yes
+
+    -  .. row 3
+
+       -  ``V4L2_SEL_TGT_CROP_DEFAULT``
+
+       -  0x0001
+
+       -  Suggested cropping rectangle that covers the "whole picture".
+
+       -  Yes
+
+       -  No
+
+    -  .. row 4
+
+       -  ``V4L2_SEL_TGT_CROP_BOUNDS``
+
+       -  0x0002
+
+       -  Bounds of the crop rectangle. All valid crop rectangles fit inside
+          the crop bounds rectangle.
+
+       -  Yes
+
+       -  Yes
+
+    -  .. row 5
+
+       -  ``V4L2_SEL_TGT_NATIVE_SIZE``
+
+       -  0x0003
+
+       -  The native size of the device, e.g. a sensor's pixel array.
+          ``left`` and ``top`` fields are zero for this target. Setting the
+          native size will generally only make sense for memory to memory
+          devices where the software can create a canvas of a given size in
+          which for example a video frame can be composed. In that case
+          V4L2_SEL_TGT_NATIVE_SIZE can be used to configure the size of
+          that canvas.
+
+       -  Yes
+
+       -  Yes
+
+    -  .. row 6
+
+       -  ``V4L2_SEL_TGT_COMPOSE``
+
+       -  0x0100
+
+       -  Compose rectangle. Used to configure scaling and composition.
+
+       -  Yes
+
+       -  Yes
+
+    -  .. row 7
+
+       -  ``V4L2_SEL_TGT_COMPOSE_DEFAULT``
+
+       -  0x0101
+
+       -  Suggested composition rectangle that covers the "whole picture".
+
+       -  Yes
+
+       -  No
+
+    -  .. row 8
+
+       -  ``V4L2_SEL_TGT_COMPOSE_BOUNDS``
+
+       -  0x0102
+
+       -  Bounds of the compose rectangle. All valid compose rectangles fit
+          inside the compose bounds rectangle.
+
+       -  Yes
+
+       -  Yes
+
+    -  .. row 9
+
+       -  ``V4L2_SEL_TGT_COMPOSE_PADDED``
+
+       -  0x0103
+
+       -  The active area and all padding pixels that are inserted or
+          modified by hardware.
+
+       -  Yes
+
+       -  No
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/v4l2.rst b/Documentation/linux_tv/media/v4l/v4l2.rst
new file mode 100644
index 000000000000..cf636b665d95
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/v4l2.rst
@@ -0,0 +1,392 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _v4l2spec:
+
+#####################################
+Video for Linux Two API Specification
+#####################################
+
+**Revision 4.4**
+
+.. toctree::
+    :maxdepth: 1
+
+    common
+    pixfmt
+    io
+    devices
+    driver
+    libv4l
+    compat
+    user-func
+    common-defs
+    videodev
+    capture-example
+    v4l2grab-example
+    biblio
+
+
+**********************
+Revision and Copyright
+**********************
+
+
+:author:    Schimek Michael (*H*)
+:address:   mschimek@gmx.at
+
+:author:    Dirks Bill
+:contrib:   Original author of the V4L2 API and documentation.
+
+:author:    Verkuil Hans
+:address:   hverkuil@xs4all.nl
+:contrib:   Designed and documented the VIDIOC_LOG_STATUS ioctl, the extended control ioctls, major parts of the sliced VBI API, the MPEG encoder and decoder APIs and the DV Timings API.
+
+:author:    Rubli Martin
+:contrib:   Designed and documented the VIDIOC_ENUM_FRAMESIZES and VIDIOC_ENUM_FRAMEINTERVALS ioctls.
+
+:author:    Walls Andy
+:address:   awalls@md.metrocast.net
+:contrib:   Documented the fielded V4L2_MPEG_STREAM_VBI_FMT_IVTV MPEG stream embedded, sliced VBI data format in this specification.
+
+:author:    Carvalho Chehab Mauro
+:address:   m.chehab@samsung.com
+:contrib:   Documented libv4l, designed and added v4l2grab example, Remote Controller chapter.
+
+:author:    Karicheri Muralidharan
+:address:   m-karicheri2@ti.com
+:contrib:   Documented the Digital Video timings API.
+
+:author:    Osciak Pawel
+:address:   pawel AT osciak.com
+:contrib:   Designed and documented the multi-planar API.
+
+:author:    Ailus Sakari
+:address:   sakari.ailus@iki.fi
+:contrib:   Subdev selections API.
+
+:author:    Palosaari Antti
+:address:   crope@iki.fi
+:contrib:   SDR API.
+
+**Copyright** 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015 : Bill Dirks, Michael H. Schimek, Hans Verkuil, Martin Rubli, Andy Walls, Muralidharan Karicheri, Mauro Carvalho Chehab, Pawel Osciak
+
+Except when explicitly stated as GPL, programming examples within this
+part can be used and distributed without restrictions.
+
+
+:revision: 4.5 / 2015-10-29 (*rr*)
+
+Extend vidioc-g-ext-ctrls;. Replace ctrl_class with a new union with
+ctrl_class and which. Which is used to select the current value of the
+control or the default value.
+
+
+:revision: 4.4 / 2015-05-26 (*ap*)
+
+Renamed V4L2_TUNER_ADC to V4L2_TUNER_SDR. Added
+V4L2_CID_RF_TUNER_RF_GAIN control. Added transmitter support for
+Software Defined Radio (SDR) Interface.
+
+
+:revision: 4.1 / 2015-02-13 (*mcc*)
+
+Fix documentation for media controller device nodes and add support for
+DVB device nodes. Add support for Tuner sub-device.
+
+
+:revision: 3.19 / 2014-12-05 (*hv*)
+
+Rewrote Colorspace chapter, added new enum
+:ref:`v4l2_ycbcr_encoding <v4l2-ycbcr-encoding>` and enum
+:ref:`v4l2_quantization <v4l2-quantization>` fields to struct
+:ref:`v4l2_pix_format <v4l2-pix-format>`, struct
+:ref:`v4l2_pix_format_mplane <v4l2-pix-format-mplane>` and struct
+:ref:`v4l2_mbus_framefmt <v4l2-mbus-framefmt>`.
+
+
+:revision: 3.17 / 2014-08-04 (*lp, hv*)
+
+Extended struct :ref:`v4l2_pix_format <v4l2-pix-format>`. Added
+format flags. Added compound control types and VIDIOC_QUERY_EXT_CTRL.
+
+
+:revision: 3.15 / 2014-02-03 (*hv, ap*)
+
+Update several sections of "Common API Elements": "Opening and Closing
+Devices" "Querying Capabilities", "Application Priority", "Video Inputs
+and Outputs", "Audio Inputs and Outputs" "Tuners and Modulators", "Video
+Standards" and "Digital Video (DV) Timings". Added SDR API.
+
+
+:revision: 3.14 / 2013-11-25 (*rr*)
+
+Set width and height as unsigned on v4l2_rect.
+
+
+:revision: 3.11 / 2013-05-26 (*hv*)
+
+Remove obsolete VIDIOC_DBG_G_CHIP_IDENT ioctl.
+
+
+:revision: 3.10 / 2013-03-25 (*hv*)
+
+Remove obsolete and unused DV_PRESET ioctls: VIDIOC_G_DV_PRESET,
+VIDIOC_S_DV_PRESET, VIDIOC_QUERY_DV_PRESET and
+VIDIOC_ENUM_DV_PRESET. Remove the related v4l2_input/output
+capability flags V4L2_IN_CAP_PRESETS and V4L2_OUT_CAP_PRESETS.
+Added VIDIOC_DBG_G_CHIP_INFO.
+
+
+:revision: 3.9 / 2012-12-03 (*sa, sn*)
+
+Added timestamp types to v4l2_buffer. Added
+V4L2_EVENT_CTRL_CH_RANGE control event changes flag.
+
+
+:revision: 3.6 / 2012-07-02 (*hv*)
+
+Added VIDIOC_ENUM_FREQ_BANDS.
+
+
+:revision: 3.5 / 2012-05-07 (*sa, sn, hv*)
+
+Added V4L2_CTRL_TYPE_INTEGER_MENU and V4L2 subdev selections API.
+Improved the description of V4L2_CID_COLORFX control, added
+V4L2_CID_COLORFX_CBCR control. Added camera controls
+V4L2_CID_AUTO_EXPOSURE_BIAS,
+V4L2_CID_AUTO_N_PRESET_WHITE_BALANCE,
+V4L2_CID_IMAGE_STABILIZATION, V4L2_CID_ISO_SENSITIVITY,
+V4L2_CID_ISO_SENSITIVITY_AUTO, V4L2_CID_EXPOSURE_METERING,
+V4L2_CID_SCENE_MODE, V4L2_CID_3A_LOCK,
+V4L2_CID_AUTO_FOCUS_START, V4L2_CID_AUTO_FOCUS_STOP,
+V4L2_CID_AUTO_FOCUS_STATUS and V4L2_CID_AUTO_FOCUS_RANGE. Added
+VIDIOC_ENUM_DV_TIMINGS, VIDIOC_QUERY_DV_TIMINGS and
+VIDIOC_DV_TIMINGS_CAP.
+
+
+:revision: 3.4 / 2012-01-25 (*sn*)
+
+Added :ref:`JPEG compression control class. <jpeg-controls>`
+
+
+:revision: 3.3 / 2012-01-11 (*hv*)
+
+Added device_caps field to struct v4l2_capabilities.
+
+
+:revision: 3.2 / 2011-08-26 (*hv*)
+
+Added V4L2_CTRL_FLAG_VOLATILE.
+
+
+:revision: 3.1 / 2011-06-27 (*mcc, po, hv*)
+
+Documented that VIDIOC_QUERYCAP now returns a per-subsystem version
+instead of a per-driver one. Standardize an error code for invalid
+ioctl. Added V4L2_CTRL_TYPE_BITMASK.
+
+
+:revision: 2.6.39 / 2011-03-01 (*mcc, po*)
+
+Removed VIDIOC_*_OLD from videodev2.h header and update it to reflect
+latest changes. Added the :ref:`multi-planar API <planar-apis>`.
+
+
+:revision: 2.6.37 / 2010-08-06 (*hv*)
+
+Removed obsolete vtx (videotext) API.
+
+
+:revision: 2.6.33 / 2009-12-03 (*mk*)
+
+Added documentation for the Digital Video timings API.
+
+
+:revision: 2.6.32 / 2009-08-31 (*mcc*)
+
+Now, revisions will match the kernel version where the V4L2 API changes
+will be used by the Linux Kernel. Also added Remote Controller chapter.
+
+
+:revision: 0.29 / 2009-08-26 (*ev*)
+
+Added documentation for string controls and for FM Transmitter controls.
+
+
+:revision: 0.28 / 2009-08-26 (*gl*)
+
+Added V4L2_CID_BAND_STOP_FILTER documentation.
+
+
+:revision: 0.27 / 2009-08-15 (*mcc*)
+
+Added libv4l and Remote Controller documentation; added v4l2grab and
+keytable application examples.
+
+
+:revision: 0.26 / 2009-07-23 (*hv*)
+
+Finalized the RDS capture API. Added modulator and RDS encoder
+capabilities. Added support for string controls.
+
+
+:revision: 0.25 / 2009-01-18 (*hv*)
+
+Added pixel formats VYUY, NV16 and NV61, and changed the debug ioctls
+VIDIOC_DBG_G/S_REGISTER and VIDIOC_DBG_G_CHIP_IDENT. Added camera
+controls V4L2_CID_ZOOM_ABSOLUTE, V4L2_CID_ZOOM_RELATIVE,
+V4L2_CID_ZOOM_CONTINUOUS and V4L2_CID_PRIVACY.
+
+
+:revision: 0.24 / 2008-03-04 (*mhs*)
+
+Added pixel formats Y16 and SBGGR16, new controls and a camera controls
+class. Removed VIDIOC_G/S_MPEGCOMP.
+
+
+:revision: 0.23 / 2007-08-30 (*mhs*)
+
+Fixed a typo in VIDIOC_DBG_G/S_REGISTER. Clarified the byte order of
+packed pixel formats.
+
+
+:revision: 0.22 / 2007-08-29 (*mhs*)
+
+Added the Video Output Overlay interface, new MPEG controls,
+V4L2_FIELD_INTERLACED_TB and V4L2_FIELD_INTERLACED_BT,
+VIDIOC_DBG_G/S_REGISTER, VIDIOC_(TRY_)ENCODER_CMD,
+VIDIOC_G_CHIP_IDENT, VIDIOC_G_ENC_INDEX, new pixel formats.
+Clarifications in the cropping chapter, about RGB pixel formats, the
+mmap(), poll(), select(), read() and write() functions. Typographical
+fixes.
+
+
+:revision: 0.21 / 2006-12-19 (*mhs*)
+
+Fixed a link in the VIDIOC_G_EXT_CTRLS section.
+
+
+:revision: 0.20 / 2006-11-24 (*mhs*)
+
+Clarified the purpose of the audioset field in struct v4l2_input and
+v4l2_output.
+
+
+:revision: 0.19 / 2006-10-19 (*mhs*)
+
+Documented V4L2_PIX_FMT_RGB444.
+
+
+:revision: 0.18 / 2006-10-18 (*mhs*)
+
+Added the description of extended controls by Hans Verkuil. Linked
+V4L2_PIX_FMT_MPEG to V4L2_CID_MPEG_STREAM_TYPE.
+
+
+:revision: 0.17 / 2006-10-12 (*mhs*)
+
+Corrected V4L2_PIX_FMT_HM12 description.
+
+
+:revision: 0.16 / 2006-10-08 (*mhs*)
+
+VIDIOC_ENUM_FRAMESIZES and VIDIOC_ENUM_FRAMEINTERVALS are now part
+of the API.
+
+
+:revision: 0.15 / 2006-09-23 (*mhs*)
+
+Cleaned up the bibliography, added BT.653 and BT.1119.
+capture.c/start_capturing() for user pointer I/O did not initialize the
+buffer index. Documented the V4L MPEG and MJPEG VID_TYPEs and
+V4L2_PIX_FMT_SBGGR8. Updated the list of reserved pixel formats. See
+the history chapter for API changes.
+
+
+:revision: 0.14 / 2006-09-14 (*mr*)
+
+Added VIDIOC_ENUM_FRAMESIZES and VIDIOC_ENUM_FRAMEINTERVALS proposal
+for frame format enumeration of digital devices.
+
+
+:revision: 0.13 / 2006-04-07 (*mhs*)
+
+Corrected the description of struct v4l2_window clips. New V4L2_STD_
+and V4L2_TUNER_MODE_LANG1_LANG2 defines.
+
+
+:revision: 0.12 / 2006-02-03 (*mhs*)
+
+Corrected the description of struct v4l2_captureparm and
+v4l2_outputparm.
+
+
+:revision: 0.11 / 2006-01-27 (*mhs*)
+
+Improved the description of struct v4l2_tuner.
+
+
+:revision: 0.10 / 2006-01-10 (*mhs*)
+
+VIDIOC_G_INPUT and VIDIOC_S_PARM clarifications.
+
+
+:revision: 0.9 / 2005-11-27 (*mhs*)
+
+Improved the 525 line numbering diagram. Hans Verkuil and I rewrote the
+sliced VBI section. He also contributed a VIDIOC_LOG_STATUS page.
+Fixed VIDIOC_S_STD call in the video standard selection example.
+Various updates.
+
+
+:revision: 0.8 / 2004-10-04 (*mhs*)
+
+Somehow a piece of junk slipped into the capture example, removed.
+
+
+:revision: 0.7 / 2004-09-19 (*mhs*)
+
+Fixed video standard selection, control enumeration, downscaling and
+aspect example. Added read and user pointer i/o to video capture
+example.
+
+
+:revision: 0.6 / 2004-08-01 (*mhs*)
+
+v4l2_buffer changes, added video capture example, various corrections.
+
+
+:revision: 0.5 / 2003-11-05 (*mhs*)
+
+Pixel format erratum.
+
+
+:revision: 0.4 / 2003-09-17 (*mhs*)
+
+Corrected source and Makefile to generate a PDF. SGML fixes. Added
+latest API changes. Closed gaps in the history chapter.
+
+
+:revision: 0.3 / 2003-02-05 (*mhs*)
+
+Another draft, more corrections.
+
+
+:revision: 0.2 / 2003-01-15 (*mhs*)
+
+Second draft, with corrections pointed out by Gerd Knorr.
+
+
+:revision: 0.1 / 2002-12-01 (*mhs*)
+
+First draft, based on documentation by Bill Dirks and discussions on the
+V4L mailing list.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/v4l2grab-example.rst b/Documentation/linux_tv/media/v4l/v4l2grab-example.rst
new file mode 100644
index 000000000000..8b933d7a341a
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/v4l2grab-example.rst
@@ -0,0 +1,28 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _v4l2grab-example:
+
+**********************************
+Video Grabber example using libv4l
+**********************************
+
+This program demonstrates how to grab V4L2 images in ppm format by using
+libv4l handlers. The advantage is that this grabber can potentially work
+with any V4L2 driver.
+
+
+.. toctree::
+    :maxdepth: 1
+
+    v4l2grab.c
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/v4l2grab.c.rst b/Documentation/linux_tv/media/v4l/v4l2grab.c.rst
new file mode 100644
index 000000000000..6934294e61d9
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/v4l2grab.c.rst
@@ -0,0 +1,180 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+file: media/v4l/v4l2grab.c
+==========================
+
+.. code-block:: c
+
+    /* V4L2 video picture grabber
+       Copyright (C) 2009 Mauro Carvalho Chehab <mchehab@infradead.org>
+
+       This program is free software; you can redistribute it and/or modify
+       it under the terms of the GNU General Public License as published by
+       the Free Software Foundation version 2 of the License.
+
+       This program is distributed in the hope that it will be useful,
+       but WITHOUT ANY WARRANTY; without even the implied warranty of
+       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+       GNU General Public License for more details.
+     */
+
+    #include <stdio.h>
+    #include <stdlib.h>
+    #include <string.h>
+    #include <fcntl.h>
+    #include <errno.h>
+    #include <sys/ioctl.h>
+    #include <sys/types.h>
+    #include <sys/time.h>
+    #include <sys/mman.h>
+    #include <linux/videodev2.h>
+    #include "../libv4l/include/libv4l2.h"
+
+    #define CLEAR(x) memset(&(x), 0, sizeof(x))
+
+    struct buffer {
+            void   *start;
+            size_t length;
+    };
+
+    static void xioctl(int fh, int request, void *arg)
+    {
+            int r;
+
+            do {
+                    r = v4l2_ioctl(fh, request, arg);
+            } while (r == -1 && ((errno == EINTR) || (errno == EAGAIN)));
+
+            if (r == -1) {
+                    fprintf(stderr, "error %d, %s\\n", errno, strerror(errno));
+                    exit(EXIT_FAILURE);
+            }
+    }
+
+    int main(int argc, char **argv)
+    {
+            struct v4l2_format              fmt;
+            struct v4l2_buffer              buf;
+            struct v4l2_requestbuffers      req;
+            enum v4l2_buf_type              type;
+            fd_set                          fds;
+            struct timeval                  tv;
+            int                             r, fd = -1;
+            unsigned int                    i, n_buffers;
+            char                            *dev_name = "/dev/video0";
+            char                            out_name[256];
+            FILE                            *fout;
+            struct buffer                   *buffers;
+
+            fd = v4l2_open(dev_name, O_RDWR | O_NONBLOCK, 0);
+            if (fd < 0) {
+                    perror("Cannot open device");
+                    exit(EXIT_FAILURE);
+            }
+
+            CLEAR(fmt);
+            fmt.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
+            fmt.fmt.pix.width       = 640;
+            fmt.fmt.pix.height      = 480;
+            fmt.fmt.pix.pixelformat = V4L2_PIX_FMT_RGB24;
+            fmt.fmt.pix.field       = V4L2_FIELD_INTERLACED;
+            xioctl(fd, VIDIOC_S_FMT, &fmt);
+            if (fmt.fmt.pix.pixelformat != V4L2_PIX_FMT_RGB24) {
+                    printf("Libv4l didn't accept RGB24 format. Can't proceed.\\n");
+                    exit(EXIT_FAILURE);
+            }
+            if ((fmt.fmt.pix.width != 640) || (fmt.fmt.pix.height != 480))
+                    printf("Warning: driver is sending image at %dx%d\\n",
+                            fmt.fmt.pix.width, fmt.fmt.pix.height);
+
+            CLEAR(req);
+            req.count = 2;
+            req.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
+            req.memory = V4L2_MEMORY_MMAP;
+            xioctl(fd, VIDIOC_REQBUFS, &req);
+
+            buffers = calloc(req.count, sizeof(*buffers));
+            for (n_buffers = 0; n_buffers < req.count; ++n_buffers) {
+                    CLEAR(buf);
+
+                    buf.type        = V4L2_BUF_TYPE_VIDEO_CAPTURE;
+                    buf.memory      = V4L2_MEMORY_MMAP;
+                    buf.index       = n_buffers;
+
+                    xioctl(fd, VIDIOC_QUERYBUF, &buf);
+
+                    buffers[n_buffers].length = buf.length;
+                    buffers[n_buffers].start = v4l2_mmap(NULL, buf.length,
+                                  PROT_READ | PROT_WRITE, MAP_SHARED,
+                                  fd, buf.m.offset);
+
+                    if (MAP_FAILED == buffers[n_buffers].start) {
+                            perror("mmap");
+                            exit(EXIT_FAILURE);
+                    }
+            }
+
+            for (i = 0; i < n_buffers; ++i) {
+                    CLEAR(buf);
+                    buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
+                    buf.memory = V4L2_MEMORY_MMAP;
+                    buf.index = i;
+                    xioctl(fd, VIDIOC_QBUF, &buf);
+            }
+            type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
+
+            xioctl(fd, VIDIOC_STREAMON, &type);
+            for (i = 0; i < 20; i++) {
+                    do {
+                            FD_ZERO(&fds);
+                            FD_SET(fd, &fds);
+
+                            /* Timeout. */
+                            tv.tv_sec = 2;
+                            tv.tv_usec = 0;
+
+                            r = select(fd + 1, &fds, NULL, NULL, &tv);
+                    } while ((r == -1 && (errno = EINTR)));
+                    if (r == -1) {
+                            perror("select");
+                            return errno;
+                    }
+
+                    CLEAR(buf);
+                    buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
+                    buf.memory = V4L2_MEMORY_MMAP;
+                    xioctl(fd, VIDIOC_DQBUF, &buf);
+
+                    sprintf(out_name, "out%03d.ppm", i);
+                    fout = fopen(out_name, "w");
+                    if (!fout) {
+                            perror("Cannot open image");
+                            exit(EXIT_FAILURE);
+                    }
+                    fprintf(fout, "P6\\n%d %d 255\\n",
+                            fmt.fmt.pix.width, fmt.fmt.pix.height);
+                    fwrite(buffers[buf.index].start, buf.bytesused, 1, fout);
+                    fclose(fout);
+
+                    xioctl(fd, VIDIOC_QBUF, &buf);
+            }
+
+            type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
+            xioctl(fd, VIDIOC_STREAMOFF, &type);
+            for (i = 0; i < n_buffers; ++i)
+                    v4l2_munmap(buffers[i].start, buffers[i].length);
+            v4l2_close(fd);
+
+            return 0;
+    }
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/video.rst b/Documentation/linux_tv/media/v4l/video.rst
new file mode 100644
index 000000000000..803bb37f4be8
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/video.rst
@@ -0,0 +1,73 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _video:
+
+************************
+Video Inputs and Outputs
+************************
+
+Video inputs and outputs are physical connectors of a device. These can
+be for example RF connectors (antenna/cable), CVBS a.k.a. Composite
+Video, S-Video or RGB connectors. Video and VBI capture devices have
+inputs. Video and VBI output devices have outputs, at least one each.
+Radio devices have no video inputs or outputs.
+
+To learn about the number and attributes of the available inputs and
+outputs applications can enumerate them with the
+:ref:`VIDIOC_ENUMINPUT <vidioc-enuminput>` and
+:ref:`VIDIOC_ENUMOUTPUT <vidioc-enumoutput>` ioctl, respectively. The
+struct :ref:`v4l2_input <v4l2-input>` returned by the
+``VIDIOC_ENUMINPUT`` ioctl also contains signal status information
+applicable when the current video input is queried.
+
+The :ref:`VIDIOC_G_INPUT <vidioc-g-input>` and
+:ref:`VIDIOC_G_OUTPUT <vidioc-g-output>` ioctls return the index of
+the current video input or output. To select a different input or output
+applications call the :ref:`VIDIOC_S_INPUT <vidioc-g-input>` and
+:ref:`VIDIOC_S_OUTPUT <vidioc-g-output>` ioctls. Drivers must
+implement all the input ioctls when the device has one or more inputs,
+all the output ioctls when the device has one or more outputs.
+
+
+.. code-block:: c
+
+    struct v4l2_input input;
+    int index;
+
+    if (-1 == ioctl(fd, VIDIOC_G_INPUT, &index)) {
+        perror("VIDIOC_G_INPUT");
+        exit(EXIT_FAILURE);
+    }
+
+    memset(&input, 0, sizeof(input));
+    input.index = index;
+
+    if (-1 == ioctl(fd, VIDIOC_ENUMINPUT, &input)) {
+        perror("VIDIOC_ENUMINPUT");
+        exit(EXIT_FAILURE);
+    }
+
+    printf("Current input: %s\\n", input.name);
+
+
+.. code-block:: c
+
+    int index;
+
+    index = 0;
+
+    if (-1 == ioctl(fd, VIDIOC_S_INPUT, &index)) {
+        perror("VIDIOC_S_INPUT");
+        exit(EXIT_FAILURE);
+    }
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/videodev.rst b/Documentation/linux_tv/media/v4l/videodev.rst
new file mode 100644
index 000000000000..4d1f26a90a68
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/videodev.rst
@@ -0,0 +1,24 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _videodev:
+
+*******************************
+Video For Linux Two Header File
+*******************************
+
+
+.. toctree::
+    :maxdepth: 1
+
+    ../../videodev2.h
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-create-bufs.rst b/Documentation/linux_tv/media/v4l/vidioc-create-bufs.rst
new file mode 100644
index 000000000000..e512fe26569e
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-create-bufs.rst
@@ -0,0 +1,154 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-create-bufs:
+
+************************
+ioctl VIDIOC_CREATE_BUFS
+************************
+
+*man VIDIOC_CREATE_BUFS(2)*
+
+Create buffers for Memory Mapped or User Pointer or DMA Buffer I/O
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_create_buffers *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_CREATE_BUFS
+
+``argp``
+
+
+Description
+===========
+
+This ioctl is used to create buffers for :ref:`memory mapped <mmap>`
+or :ref:`user pointer <userp>` or :ref:`DMA buffer <dmabuf>` I/O. It
+can be used as an alternative or in addition to the
+:ref:`VIDIOC_REQBUFS <vidioc-reqbufs>` ioctl, when a tighter control
+over buffers is required. This ioctl can be called multiple times to
+create buffers of different sizes.
+
+To allocate the device buffers applications must initialize the relevant
+fields of the :c:type:`struct v4l2_create_buffers` structure. The
+``count`` field must be set to the number of requested buffers, the
+``memory`` field specifies the requested I/O method and the ``reserved``
+array must be zeroed.
+
+The ``format`` field specifies the image format that the buffers must be
+able to handle. The application has to fill in this struct
+:ref:`v4l2_format <v4l2-format>`. Usually this will be done using the
+:ref:`VIDIOC_TRY_FMT <vidioc-g-fmt>` or
+:ref:`VIDIOC_G_FMT <vidioc-g-fmt>` ioctls to ensure that the
+requested format is supported by the driver. Based on the format's
+``type`` field the requested buffer size (for single-planar) or plane
+sizes (for multi-planar formats) will be used for the allocated buffers.
+The driver may return an error if the size(s) are not supported by the
+hardware (usually because they are too small).
+
+The buffers created by this ioctl will have as minimum size the size
+defined by the ``format.pix.sizeimage`` field (or the corresponding
+fields for other format types). Usually if the ``format.pix.sizeimage``
+field is less than the minimum required for the given format, then an
+error will be returned since drivers will typically not allow this. If
+it is larger, then the value will be used as-is. In other words, the
+driver may reject the requested size, but if it is accepted the driver
+will use it unchanged.
+
+When the ioctl is called with a pointer to this structure the driver
+will attempt to allocate up to the requested number of buffers and store
+the actual number allocated and the starting index in the ``count`` and
+the ``index`` fields respectively. On return ``count`` can be smaller
+than the number requested.
+
+
+.. _v4l2-create-buffers:
+
+.. flat-table:: struct v4l2_create_buffers
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``index``
+
+       -  The starting buffer index, returned by the driver.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``count``
+
+       -  The number of buffers requested or granted. If count == 0, then
+          ``VIDIOC_CREATE_BUFS`` will set ``index`` to the current number of
+          created buffers, and it will check the validity of ``memory`` and
+          ``format.type``. If those are invalid -1 is returned and errno is
+          set to EINVAL error code, otherwise ``VIDIOC_CREATE_BUFS`` returns
+          0. It will never set errno to EBUSY error code in this particular
+          case.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``memory``
+
+       -  Applications set this field to ``V4L2_MEMORY_MMAP``,
+          ``V4L2_MEMORY_DMABUF`` or ``V4L2_MEMORY_USERPTR``. See
+          :ref:`v4l2-memory`
+
+    -  .. row 4
+
+       -  struct :ref:`v4l2_format <v4l2-format>`
+
+       -  ``format``
+
+       -  Filled in by the application, preserved by the driver.
+
+    -  .. row 5
+
+       -  __u32
+
+       -  ``reserved``\ [8]
+
+       -  A place holder for future extensions. Drivers and applications
+          must set the array to zero.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+ENOMEM
+    No memory to allocate buffers for :ref:`memory mapped <mmap>` I/O.
+
+EINVAL
+    The buffer type (``format.type`` field), requested I/O method
+    (``memory``) or format (``format`` field) is not valid.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-cropcap.rst b/Documentation/linux_tv/media/v4l/vidioc-cropcap.rst
new file mode 100644
index 000000000000..7fa9e2750457
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-cropcap.rst
@@ -0,0 +1,175 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-cropcap:
+
+********************
+ioctl VIDIOC_CROPCAP
+********************
+
+*man VIDIOC_CROPCAP(2)*
+
+Information about the video cropping and scaling abilities
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_cropcap *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_CROPCAP
+
+``argp``
+
+
+Description
+===========
+
+Applications use this function to query the cropping limits, the pixel
+aspect of images and to calculate scale factors. They set the ``type``
+field of a v4l2_cropcap structure to the respective buffer (stream)
+type and call the ``VIDIOC_CROPCAP`` ioctl with a pointer to this
+structure. Drivers fill the rest of the structure. The results are
+constant except when switching the video standard. Remember this switch
+can occur implicit when switching the video input or output.
+
+Do not use the multiplanar buffer types. Use
+``V4L2_BUF_TYPE_VIDEO_CAPTURE`` instead of
+``V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE`` and use
+``V4L2_BUF_TYPE_VIDEO_OUTPUT`` instead of
+``V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE``.
+
+This ioctl must be implemented for video capture or output devices that
+support cropping and/or scaling and/or have non-square pixels, and for
+overlay devices.
+
+
+.. _v4l2-cropcap:
+
+.. flat-table:: struct v4l2_cropcap
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``type``
+
+       -  Type of the data stream, set by the application. Only these types
+          are valid here: ``V4L2_BUF_TYPE_VIDEO_CAPTURE``,
+          ``V4L2_BUF_TYPE_VIDEO_OUTPUT`` and
+          ``V4L2_BUF_TYPE_VIDEO_OVERLAY``. See :ref:`v4l2-buf-type`.
+
+    -  .. row 2
+
+       -  struct :ref:`v4l2_rect <v4l2-rect-crop>`
+
+       -  ``bounds``
+
+       -  Defines the window within capturing or output is possible, this
+          may exclude for example the horizontal and vertical blanking
+          areas. The cropping rectangle cannot exceed these limits. Width
+          and height are defined in pixels, the driver writer is free to
+          choose origin and units of the coordinate system in the analog
+          domain.
+
+    -  .. row 3
+
+       -  struct :ref:`v4l2_rect <v4l2-rect-crop>`
+
+       -  ``defrect``
+
+       -  Default cropping rectangle, it shall cover the "whole picture".
+          Assuming pixel aspect 1/1 this could be for example a 640 × 480
+          rectangle for NTSC, a 768 × 576 rectangle for PAL and SECAM
+          centered over the active picture area. The same co-ordinate system
+          as for ``bounds`` is used.
+
+    -  .. row 4
+
+       -  struct :ref:`v4l2_fract <v4l2-fract>`
+
+       -  ``pixelaspect``
+
+       -  This is the pixel aspect (y / x) when no scaling is applied, the
+          ratio of the actual sampling frequency and the frequency required
+          to get square pixels.
+
+          When cropping coordinates refer to square pixels, the driver sets
+          ``pixelaspect`` to 1/1. Other common values are 54/59 for PAL and
+          SECAM, 11/10 for NTSC sampled according to [:ref:`itu601`].
+
+
+
+.. _v4l2-rect-crop:
+
+.. flat-table:: struct v4l2_rect
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __s32
+
+       -  ``left``
+
+       -  Horizontal offset of the top, left corner of the rectangle, in
+          pixels.
+
+    -  .. row 2
+
+       -  __s32
+
+       -  ``top``
+
+       -  Vertical offset of the top, left corner of the rectangle, in
+          pixels.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``width``
+
+       -  Width of the rectangle, in pixels.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``height``
+
+       -  Height of the rectangle, in pixels.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The struct :ref:`v4l2_cropcap <v4l2-cropcap>` ``type`` is
+    invalid.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-dbg-g-chip-info.rst b/Documentation/linux_tv/media/v4l/vidioc-dbg-g-chip-info.rst
new file mode 100644
index 000000000000..0bb92acd1729
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-dbg-g-chip-info.rst
@@ -0,0 +1,212 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-dbg-g-chip-info:
+
+****************************
+ioctl VIDIOC_DBG_G_CHIP_INFO
+****************************
+
+*man VIDIOC_DBG_G_CHIP_INFO(2)*
+
+Identify the chips on a TV card
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_dbg_chip_info *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_DBG_G_CHIP_INFO
+
+``argp``
+
+
+Description
+===========
+
+    **Note**
+
+    This is an :ref:`experimental <experimental>` interface and may
+    change in the future.
+
+For driver debugging purposes this ioctl allows test applications to
+query the driver about the chips present on the TV card. Regular
+applications must not use it. When you found a chip specific bug, please
+contact the linux-media mailing list
+(`https://linuxtv.org/lists.php <https://linuxtv.org/lists.php>`__)
+so it can be fixed.
+
+Additionally the Linux kernel must be compiled with the
+``CONFIG_VIDEO_ADV_DEBUG`` option to enable this ioctl.
+
+To query the driver applications must initialize the ``match.type`` and
+``match.addr`` or ``match.name`` fields of a struct
+:ref:`v4l2_dbg_chip_info <v4l2-dbg-chip-info>` and call
+``VIDIOC_DBG_G_CHIP_INFO`` with a pointer to this structure. On success
+the driver stores information about the selected chip in the ``name``
+and ``flags`` fields.
+
+When ``match.type`` is ``V4L2_CHIP_MATCH_BRIDGE``, ``match.addr``
+selects the nth bridge 'chip' on the TV card. You can enumerate all
+chips by starting at zero and incrementing ``match.addr`` by one until
+``VIDIOC_DBG_G_CHIP_INFO`` fails with an EINVAL error code. The number
+zero always selects the bridge chip itself, e. g. the chip connected to
+the PCI or USB bus. Non-zero numbers identify specific parts of the
+bridge chip such as an AC97 register block.
+
+When ``match.type`` is ``V4L2_CHIP_MATCH_SUBDEV``, ``match.addr``
+selects the nth sub-device. This allows you to enumerate over all
+sub-devices.
+
+On success, the ``name`` field will contain a chip name and the
+``flags`` field will contain ``V4L2_CHIP_FL_READABLE`` if the driver
+supports reading registers from the device or ``V4L2_CHIP_FL_WRITABLE``
+if the driver supports writing registers to the device.
+
+We recommended the v4l2-dbg utility over calling this ioctl directly. It
+is available from the LinuxTV v4l-dvb repository; see
+`https://linuxtv.org/repo/ <https://linuxtv.org/repo/>`__ for access
+instructions.
+
+
+.. _name-v4l2-dbg-match:
+
+.. flat-table:: struct v4l2_dbg_match
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``type``
+
+       -  See :ref:`name-chip-match-types` for a list of possible types.
+
+    -  .. row 2
+
+       -  union
+
+       -  (anonymous)
+
+    -  .. row 3
+
+       -  
+       -  __u32
+
+       -  ``addr``
+
+       -  Match a chip by this number, interpreted according to the ``type``
+          field.
+
+    -  .. row 4
+
+       -  
+       -  char
+
+       -  ``name[32]``
+
+       -  Match a chip by this name, interpreted according to the ``type``
+          field. Currently unused.
+
+
+
+.. _v4l2-dbg-chip-info:
+
+.. flat-table:: struct v4l2_dbg_chip_info
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  struct v4l2_dbg_match
+
+       -  ``match``
+
+       -  How to match the chip, see :ref:`name-v4l2-dbg-match`.
+
+    -  .. row 2
+
+       -  char
+
+       -  ``name[32]``
+
+       -  The name of the chip.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``flags``
+
+       -  Set by the driver. If ``V4L2_CHIP_FL_READABLE`` is set, then the
+          driver supports reading registers from the device. If
+          ``V4L2_CHIP_FL_WRITABLE`` is set, then it supports writing
+          registers.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``reserved[8]``
+
+       -  Reserved fields, both application and driver must set these to 0.
+
+
+
+.. _name-chip-match-types:
+
+.. flat-table:: Chip Match Types
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_CHIP_MATCH_BRIDGE``
+
+       -  0
+
+       -  Match the nth chip on the card, zero for the bridge chip. Does not
+          match sub-devices.
+
+    -  .. row 2
+
+       -  ``V4L2_CHIP_MATCH_SUBDEV``
+
+       -  4
+
+       -  Match the nth sub-device.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The ``match_type`` is invalid or no device could be matched.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-dbg-g-register.rst b/Documentation/linux_tv/media/v4l/vidioc-dbg-g-register.rst
new file mode 100644
index 000000000000..613fd256d9bc
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-dbg-g-register.rst
@@ -0,0 +1,218 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-dbg-g-register:
+
+**************************************************
+ioctl VIDIOC_DBG_G_REGISTER, VIDIOC_DBG_S_REGISTER
+**************************************************
+
+*man VIDIOC_DBG_G_REGISTER(2)*
+
+VIDIOC_DBG_S_REGISTER
+Read or write hardware registers
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_dbg_register *argp )
+
+.. c:function:: int ioctl( int fd, int request, const struct v4l2_dbg_register *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_DBG_G_REGISTER, VIDIOC_DBG_S_REGISTER
+
+``argp``
+
+
+Description
+===========
+
+    **Note**
+
+    This is an :ref:`experimental <experimental>` interface and may
+    change in the future.
+
+For driver debugging purposes these ioctls allow test applications to
+access hardware registers directly. Regular applications must not use
+them.
+
+Since writing or even reading registers can jeopardize the system
+security, its stability and damage the hardware, both ioctls require
+superuser privileges. Additionally the Linux kernel must be compiled
+with the ``CONFIG_VIDEO_ADV_DEBUG`` option to enable these ioctls.
+
+To write a register applications must initialize all fields of a struct
+:ref:`v4l2_dbg_register <v4l2-dbg-register>` except for ``size`` and
+call ``VIDIOC_DBG_S_REGISTER`` with a pointer to this structure. The
+``match.type`` and ``match.addr`` or ``match.name`` fields select a chip
+on the TV card, the ``reg`` field specifies a register number and the
+``val`` field the value to be written into the register.
+
+To read a register applications must initialize the ``match.type``,
+``match.addr`` or ``match.name`` and ``reg`` fields, and call
+``VIDIOC_DBG_G_REGISTER`` with a pointer to this structure. On success
+the driver stores the register value in the ``val`` field and the size
+(in bytes) of the value in ``size``.
+
+When ``match.type`` is ``V4L2_CHIP_MATCH_BRIDGE``, ``match.addr``
+selects the nth non-sub-device chip on the TV card. The number zero
+always selects the host chip, e. g. the chip connected to the PCI or USB
+bus. You can find out which chips are present with the
+:ref:`VIDIOC_DBG_G_CHIP_INFO <vidioc-dbg-g-chip-info>` ioctl.
+
+When ``match.type`` is ``V4L2_CHIP_MATCH_SUBDEV``, ``match.addr``
+selects the nth sub-device.
+
+These ioctls are optional, not all drivers may support them. However
+when a driver supports these ioctls it must also support
+:ref:`VIDIOC_DBG_G_CHIP_INFO <vidioc-dbg-g-chip-info>`. Conversely
+it may support ``VIDIOC_DBG_G_CHIP_INFO`` but not these ioctls.
+
+``VIDIOC_DBG_G_REGISTER`` and ``VIDIOC_DBG_S_REGISTER`` were introduced
+in Linux 2.6.21, but their API was changed to the one described here in
+kernel 2.6.29.
+
+We recommended the v4l2-dbg utility over calling these ioctls directly.
+It is available from the LinuxTV v4l-dvb repository; see
+`https://linuxtv.org/repo/ <https://linuxtv.org/repo/>`__ for access
+instructions.
+
+
+.. _v4l2-dbg-match:
+
+.. flat-table:: struct v4l2_dbg_match
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``type``
+
+       -  See :ref:`chip-match-types` for a list of possible types.
+
+    -  .. row 2
+
+       -  union
+
+       -  (anonymous)
+
+    -  .. row 3
+
+       -  
+       -  __u32
+
+       -  ``addr``
+
+       -  Match a chip by this number, interpreted according to the ``type``
+          field.
+
+    -  .. row 4
+
+       -  
+       -  char
+
+       -  ``name[32]``
+
+       -  Match a chip by this name, interpreted according to the ``type``
+          field. Currently unused.
+
+
+
+.. _v4l2-dbg-register:
+
+.. flat-table:: struct v4l2_dbg_register
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  struct v4l2_dbg_match
+
+       -  ``match``
+
+       -  How to match the chip, see :ref:`v4l2-dbg-match`.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``size``
+
+       -  The register size in bytes.
+
+    -  .. row 3
+
+       -  __u64
+
+       -  ``reg``
+
+       -  A register number.
+
+    -  .. row 4
+
+       -  __u64
+
+       -  ``val``
+
+       -  The value read from, or to be written into the register.
+
+
+
+.. _chip-match-types:
+
+.. flat-table:: Chip Match Types
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_CHIP_MATCH_BRIDGE``
+
+       -  0
+
+       -  Match the nth chip on the card, zero for the bridge chip. Does not
+          match sub-devices.
+
+    -  .. row 2
+
+       -  ``V4L2_CHIP_MATCH_SUBDEV``
+
+       -  4
+
+       -  Match the nth sub-device.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EPERM
+    Insufficient permissions. Root privileges are required to execute
+    these ioctls.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-decoder-cmd.rst b/Documentation/linux_tv/media/v4l/vidioc-decoder-cmd.rst
new file mode 100644
index 000000000000..77c7bdfb90df
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-decoder-cmd.rst
@@ -0,0 +1,280 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-decoder-cmd:
+
+************************************************
+ioctl VIDIOC_DECODER_CMD, VIDIOC_TRY_DECODER_CMD
+************************************************
+
+*man VIDIOC_DECODER_CMD(2)*
+
+VIDIOC_TRY_DECODER_CMD
+Execute an decoder command
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_decoder_cmd *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_DECODER_CMD, VIDIOC_TRY_DECODER_CMD
+
+``argp``
+
+
+Description
+===========
+
+These ioctls control an audio/video (usually MPEG-) decoder.
+``VIDIOC_DECODER_CMD`` sends a command to the decoder,
+``VIDIOC_TRY_DECODER_CMD`` can be used to try a command without actually
+executing it. To send a command applications must initialize all fields
+of a struct :ref:`v4l2_decoder_cmd <v4l2-decoder-cmd>` and call
+``VIDIOC_DECODER_CMD`` or ``VIDIOC_TRY_DECODER_CMD`` with a pointer to
+this structure.
+
+The ``cmd`` field must contain the command code. Some commands use the
+``flags`` field for additional information.
+
+A :c:func:`write()`() or :ref:`VIDIOC_STREAMON <vidioc-streamon>`
+call sends an implicit START command to the decoder if it has not been
+started yet.
+
+A :c:func:`close()`() or :ref:`VIDIOC_STREAMOFF <vidioc-streamon>`
+call of a streaming file descriptor sends an implicit immediate STOP
+command to the decoder, and all buffered data is discarded.
+
+These ioctls are optional, not all drivers may support them. They were
+introduced in Linux 3.3.
+
+
+.. _v4l2-decoder-cmd:
+
+.. flat-table:: struct v4l2_decoder_cmd
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2 1 1
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``cmd``
+
+       -  
+       -  
+       -  The decoder command, see :ref:`decoder-cmds`.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``flags``
+
+       -  
+       -  
+       -  Flags to go with the command. If no flags are defined for this
+          command, drivers and applications must set this field to zero.
+
+    -  .. row 3
+
+       -  union
+
+       -  (anonymous)
+
+       -  
+       -  
+       -  
+
+    -  .. row 4
+
+       -  
+       -  struct
+
+       -  ``start``
+
+       -  
+       -  Structure containing additional data for the
+          ``V4L2_DEC_CMD_START`` command.
+
+    -  .. row 5
+
+       -  
+       -  
+       -  __s32
+
+       -  ``speed``
+
+       -  Playback speed and direction. The playback speed is defined as
+          ``speed``/1000 of the normal speed. So 1000 is normal playback.
+          Negative numbers denote reverse playback, so -1000 does reverse
+          playback at normal speed. Speeds -1, 0 and 1 have special
+          meanings: speed 0 is shorthand for 1000 (normal playback). A speed
+          of 1 steps just one frame forward, a speed of -1 steps just one
+          frame back.
+
+    -  .. row 6
+
+       -  
+       -  
+       -  __u32
+
+       -  ``format``
+
+       -  Format restrictions. This field is set by the driver, not the
+          application. Possible values are ``V4L2_DEC_START_FMT_NONE`` if
+          there are no format restrictions or ``V4L2_DEC_START_FMT_GOP`` if
+          the decoder operates on full GOPs (*Group Of Pictures*). This is
+          usually the case for reverse playback: the decoder needs full
+          GOPs, which it can then play in reverse order. So to implement
+          reverse playback the application must feed the decoder the last
+          GOP in the video file, then the GOP before that, etc. etc.
+
+    -  .. row 7
+
+       -  
+       -  struct
+
+       -  ``stop``
+
+       -  
+       -  Structure containing additional data for the ``V4L2_DEC_CMD_STOP``
+          command.
+
+    -  .. row 8
+
+       -  
+       -  
+       -  __u64
+
+       -  ``pts``
+
+       -  Stop playback at this ``pts`` or immediately if the playback is
+          already past that timestamp. Leave to 0 if you want to stop after
+          the last frame was decoded.
+
+    -  .. row 9
+
+       -  
+       -  struct
+
+       -  ``raw``
+
+       -  
+       -  
+
+    -  .. row 10
+
+       -  
+       -  
+       -  __u32
+
+       -  ``data``\ [16]
+
+       -  Reserved for future extensions. Drivers and applications must set
+          the array to zero.
+
+
+
+.. _decoder-cmds:
+
+.. flat-table:: Decoder Commands
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_DEC_CMD_START``
+
+       -  0
+
+       -  Start the decoder. When the decoder is already running or paused,
+          this command will just change the playback speed. That means that
+          calling ``V4L2_DEC_CMD_START`` when the decoder was paused will
+          *not* resume the decoder. You have to explicitly call
+          ``V4L2_DEC_CMD_RESUME`` for that. This command has one flag:
+          ``V4L2_DEC_CMD_START_MUTE_AUDIO``. If set, then audio will be
+          muted when playing back at a non-standard speed.
+
+    -  .. row 2
+
+       -  ``V4L2_DEC_CMD_STOP``
+
+       -  1
+
+       -  Stop the decoder. When the decoder is already stopped, this
+          command does nothing. This command has two flags: if
+          ``V4L2_DEC_CMD_STOP_TO_BLACK`` is set, then the decoder will set
+          the picture to black after it stopped decoding. Otherwise the last
+          image will repeat. mem2mem decoders will stop producing new frames
+          altogether. They will send a ``V4L2_EVENT_EOS`` event when the
+          last frame has been decoded and all frames are ready to be
+          dequeued and will set the ``V4L2_BUF_FLAG_LAST`` buffer flag on
+          the last buffer of the capture queue to indicate there will be no
+          new buffers produced to dequeue. This buffer may be empty,
+          indicated by the driver setting the ``bytesused`` field to 0. Once
+          the ``V4L2_BUF_FLAG_LAST`` flag was set, the
+          :ref:`VIDIOC_DQBUF <vidioc-qbuf>` ioctl will not block anymore,
+          but return an EPIPE error code. If
+          ``V4L2_DEC_CMD_STOP_IMMEDIATELY`` is set, then the decoder stops
+          immediately (ignoring the ``pts`` value), otherwise it will keep
+          decoding until timestamp >= pts or until the last of the pending
+          data from its internal buffers was decoded.
+
+    -  .. row 3
+
+       -  ``V4L2_DEC_CMD_PAUSE``
+
+       -  2
+
+       -  Pause the decoder. When the decoder has not been started yet, the
+          driver will return an EPERM error code. When the decoder is
+          already paused, this command does nothing. This command has one
+          flag: if ``V4L2_DEC_CMD_PAUSE_TO_BLACK`` is set, then set the
+          decoder output to black when paused.
+
+    -  .. row 4
+
+       -  ``V4L2_DEC_CMD_RESUME``
+
+       -  3
+
+       -  Resume decoding after a PAUSE command. When the decoder has not
+          been started yet, the driver will return an EPERM error code. When
+          the decoder is already running, this command does nothing. No
+          flags are defined for this command.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The ``cmd`` field is invalid.
+
+EPERM
+    The application sent a PAUSE or RESUME command when the decoder was
+    not running.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-dqevent.rst b/Documentation/linux_tv/media/v4l/vidioc-dqevent.rst
new file mode 100644
index 000000000000..108348e4df29
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-dqevent.rst
@@ -0,0 +1,581 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-dqevent:
+
+********************
+ioctl VIDIOC_DQEVENT
+********************
+
+*man VIDIOC_DQEVENT(2)*
+
+Dequeue event
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_event *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_DQEVENT
+
+``argp``
+
+
+Description
+===========
+
+Dequeue an event from a video device. No input is required for this
+ioctl. All the fields of the struct :ref:`v4l2_event <v4l2-event>`
+structure are filled by the driver. The file handle will also receive
+exceptions which the application may get by e.g. using the select system
+call.
+
+
+.. _v4l2-event:
+
+.. flat-table:: struct v4l2_event
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2 1
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``type``
+
+       -  
+       -  Type of the event, see :ref:`event-type`.
+
+    -  .. row 2
+
+       -  union
+
+       -  ``u``
+
+       -  
+       -  
+
+    -  .. row 3
+
+       -  
+       -  struct :ref:`v4l2_event_vsync <v4l2-event-vsync>`
+
+       -  ``vsync``
+
+       -  Event data for event ``V4L2_EVENT_VSYNC``.
+
+    -  .. row 4
+
+       -  
+       -  struct :ref:`v4l2_event_ctrl <v4l2-event-ctrl>`
+
+       -  ``ctrl``
+
+       -  Event data for event ``V4L2_EVENT_CTRL``.
+
+    -  .. row 5
+
+       -  
+       -  struct :ref:`v4l2_event_frame_sync <v4l2-event-frame-sync>`
+
+       -  ``frame_sync``
+
+       -  Event data for event ``V4L2_EVENT_FRAME_SYNC``.
+
+    -  .. row 6
+
+       -  
+       -  struct :ref:`v4l2_event_motion_det <v4l2-event-motion-det>`
+
+       -  ``motion_det``
+
+       -  Event data for event V4L2_EVENT_MOTION_DET.
+
+    -  .. row 7
+
+       -  
+       -  struct :ref:`v4l2_event_src_change <v4l2-event-src-change>`
+
+       -  ``src_change``
+
+       -  Event data for event V4L2_EVENT_SOURCE_CHANGE.
+
+    -  .. row 8
+
+       -  
+       -  __u8
+
+       -  ``data``\ [64]
+
+       -  Event data. Defined by the event type. The union should be used to
+          define easily accessible type for events.
+
+    -  .. row 9
+
+       -  __u32
+
+       -  ``pending``
+
+       -  
+       -  Number of pending events excluding this one.
+
+    -  .. row 10
+
+       -  __u32
+
+       -  ``sequence``
+
+       -  
+       -  Event sequence number. The sequence number is incremented for
+          every subscribed event that takes place. If sequence numbers are
+          not contiguous it means that events have been lost.
+
+    -  .. row 11
+
+       -  struct timespec
+
+       -  ``timestamp``
+
+       -  
+       -  Event timestamp. The timestamp has been taken from the
+          ``CLOCK_MONOTONIC`` clock. To access the same clock outside V4L2,
+          use :c:func:`clock_gettime(2)`.
+
+    -  .. row 12
+
+       -  u32
+
+       -  ``id``
+
+       -  
+       -  The ID associated with the event source. If the event does not
+          have an associated ID (this depends on the event type), then this
+          is 0.
+
+    -  .. row 13
+
+       -  __u32
+
+       -  ``reserved``\ [8]
+
+       -  
+       -  Reserved for future extensions. Drivers must set the array to
+          zero.
+
+
+
+.. _event-type:
+
+.. flat-table:: Event Types
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_EVENT_ALL``
+
+       -  0
+
+       -  All events. V4L2_EVENT_ALL is valid only for
+          VIDIOC_UNSUBSCRIBE_EVENT for unsubscribing all events at once.
+
+    -  .. row 2
+
+       -  ``V4L2_EVENT_VSYNC``
+
+       -  1
+
+       -  This event is triggered on the vertical sync. This event has a
+          struct :ref:`v4l2_event_vsync <v4l2-event-vsync>` associated
+          with it.
+
+    -  .. row 3
+
+       -  ``V4L2_EVENT_EOS``
+
+       -  2
+
+       -  This event is triggered when the end of a stream is reached. This
+          is typically used with MPEG decoders to report to the application
+          when the last of the MPEG stream has been decoded.
+
+    -  .. row 4
+
+       -  ``V4L2_EVENT_CTRL``
+
+       -  3
+
+       -  This event requires that the ``id`` matches the control ID from
+          which you want to receive events. This event is triggered if the
+          control's value changes, if a button control is pressed or if the
+          control's flags change. This event has a struct
+          :ref:`v4l2_event_ctrl <v4l2-event-ctrl>` associated with it.
+          This struct contains much of the same information as struct
+          :ref:`v4l2_queryctrl <v4l2-queryctrl>` and struct
+          :ref:`v4l2_control <v4l2-control>`.
+
+          If the event is generated due to a call to
+          :ref:`VIDIOC_S_CTRL <vidioc-g-ctrl>` or
+          :ref:`VIDIOC_S_EXT_CTRLS <vidioc-g-ext-ctrls>`, then the
+          event will *not* be sent to the file handle that called the ioctl
+          function. This prevents nasty feedback loops. If you *do* want to
+          get the event, then set the ``V4L2_EVENT_SUB_FL_ALLOW_FEEDBACK``
+          flag.
+
+          This event type will ensure that no information is lost when more
+          events are raised than there is room internally. In that case the
+          struct :ref:`v4l2_event_ctrl <v4l2-event-ctrl>` of the
+          second-oldest event is kept, but the ``changes`` field of the
+          second-oldest event is ORed with the ``changes`` field of the
+          oldest event.
+
+    -  .. row 5
+
+       -  ``V4L2_EVENT_FRAME_SYNC``
+
+       -  4
+
+       -  Triggered immediately when the reception of a frame has begun.
+          This event has a struct
+          :ref:`v4l2_event_frame_sync <v4l2-event-frame-sync>`
+          associated with it.
+
+          If the hardware needs to be stopped in the case of a buffer
+          underrun it might not be able to generate this event. In such
+          cases the ``frame_sequence`` field in struct
+          :ref:`v4l2_event_frame_sync <v4l2-event-frame-sync>` will not
+          be incremented. This causes two consecutive frame sequence numbers
+          to have n times frame interval in between them.
+
+    -  .. row 6
+
+       -  ``V4L2_EVENT_SOURCE_CHANGE``
+
+       -  5
+
+       -  This event is triggered when a source parameter change is detected
+          during runtime by the video device. It can be a runtime resolution
+          change triggered by a video decoder or the format change happening
+          on an input connector. This event requires that the ``id`` matches
+          the input index (when used with a video device node) or the pad
+          index (when used with a subdevice node) from which you want to
+          receive events.
+
+          This event has a struct
+          :ref:`v4l2_event_src_change <v4l2-event-src-change>`
+          associated with it. The ``changes`` bitfield denotes what has
+          changed for the subscribed pad. If multiple events occurred before
+          application could dequeue them, then the changes will have the
+          ORed value of all the events generated.
+
+    -  .. row 7
+
+       -  ``V4L2_EVENT_MOTION_DET``
+
+       -  6
+
+       -  Triggered whenever the motion detection state for one or more of
+          the regions changes. This event has a struct
+          :ref:`v4l2_event_motion_det <v4l2-event-motion-det>`
+          associated with it.
+
+    -  .. row 8
+
+       -  ``V4L2_EVENT_PRIVATE_START``
+
+       -  0x08000000
+
+       -  Base event number for driver-private events.
+
+
+
+.. _v4l2-event-vsync:
+
+.. flat-table:: struct v4l2_event_vsync
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u8
+
+       -  ``field``
+
+       -  The upcoming field. See enum :ref:`v4l2_field <v4l2-field>`.
+
+
+
+.. _v4l2-event-ctrl:
+
+.. flat-table:: struct v4l2_event_ctrl
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2 1
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``changes``
+
+       -  
+       -  A bitmask that tells what has changed. See
+          :ref:`ctrl-changes-flags`.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``type``
+
+       -  
+       -  The type of the control. See enum
+          :ref:`v4l2_ctrl_type <v4l2-ctrl-type>`.
+
+    -  .. row 3
+
+       -  union (anonymous)
+
+       -  
+       -  
+       -  
+
+    -  .. row 4
+
+       -  
+       -  __s32
+
+       -  ``value``
+
+       -  The 32-bit value of the control for 32-bit control types. This is
+          0 for string controls since the value of a string cannot be passed
+          using :ref:`VIDIOC_DQEVENT <vidioc-dqevent>`.
+
+    -  .. row 5
+
+       -  
+       -  __s64
+
+       -  ``value64``
+
+       -  The 64-bit value of the control for 64-bit control types.
+
+    -  .. row 6
+
+       -  __u32
+
+       -  ``flags``
+
+       -  
+       -  The control flags. See :ref:`control-flags`.
+
+    -  .. row 7
+
+       -  __s32
+
+       -  ``minimum``
+
+       -  
+       -  The minimum value of the control. See struct
+          :ref:`v4l2_queryctrl <v4l2-queryctrl>`.
+
+    -  .. row 8
+
+       -  __s32
+
+       -  ``maximum``
+
+       -  
+       -  The maximum value of the control. See struct
+          :ref:`v4l2_queryctrl <v4l2-queryctrl>`.
+
+    -  .. row 9
+
+       -  __s32
+
+       -  ``step``
+
+       -  
+       -  The step value of the control. See struct
+          :ref:`v4l2_queryctrl <v4l2-queryctrl>`.
+
+    -  .. row 10
+
+       -  __s32
+
+       -  ``default_value``
+
+       -  
+       -  The default value value of the control. See struct
+          :ref:`v4l2_queryctrl <v4l2-queryctrl>`.
+
+
+
+.. _v4l2-event-frame-sync:
+
+.. flat-table:: struct v4l2_event_frame_sync
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``frame_sequence``
+
+       -  The sequence number of the frame being received.
+
+
+
+.. _v4l2-event-src-change:
+
+.. flat-table:: struct v4l2_event_src_change
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``changes``
+
+       -  A bitmask that tells what has changed. See
+          :ref:`src-changes-flags`.
+
+
+
+.. _v4l2-event-motion-det:
+
+.. flat-table:: struct v4l2_event_motion_det
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``flags``
+
+       -  Currently only one flag is available: if
+          ``V4L2_EVENT_MD_FL_HAVE_FRAME_SEQ`` is set, then the
+          ``frame_sequence`` field is valid, otherwise that field should be
+          ignored.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``frame_sequence``
+
+       -  The sequence number of the frame being received. Only valid if the
+          ``V4L2_EVENT_MD_FL_HAVE_FRAME_SEQ`` flag was set.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``region_mask``
+
+       -  The bitmask of the regions that reported motion. There is at least
+          one region. If this field is 0, then no motion was detected at
+          all. If there is no ``V4L2_CID_DETECT_MD_REGION_GRID`` control
+          (see :ref:`detect-controls`) to assign a different region to
+          each cell in the motion detection grid, then that all cells are
+          automatically assigned to the default region 0.
+
+
+
+.. _ctrl-changes-flags:
+
+.. flat-table:: Control Changes
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_EVENT_CTRL_CH_VALUE``
+
+       -  0x0001
+
+       -  This control event was triggered because the value of the control
+          changed. Special cases: Volatile controls do no generate this
+          event; If a control has the ``V4L2_CTRL_FLAG_EXECUTE_ON_WRITE``
+          flag set, then this event is sent as well, regardless its value.
+
+    -  .. row 2
+
+       -  ``V4L2_EVENT_CTRL_CH_FLAGS``
+
+       -  0x0002
+
+       -  This control event was triggered because the control flags
+          changed.
+
+    -  .. row 3
+
+       -  ``V4L2_EVENT_CTRL_CH_RANGE``
+
+       -  0x0004
+
+       -  This control event was triggered because the minimum, maximum,
+          step or the default value of the control changed.
+
+
+
+.. _src-changes-flags:
+
+.. flat-table:: Source Changes
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_EVENT_SRC_CH_RESOLUTION``
+
+       -  0x0001
+
+       -  This event gets triggered when a resolution change is detected at
+          an input. This can come from an input connector or from a video
+          decoder.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-dv-timings-cap.rst b/Documentation/linux_tv/media/v4l/vidioc-dv-timings-cap.rst
new file mode 100644
index 000000000000..d8222ad0df52
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-dv-timings-cap.rst
@@ -0,0 +1,259 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-dv-timings-cap:
+
+*********************************************************
+ioctl VIDIOC_DV_TIMINGS_CAP, VIDIOC_SUBDEV_DV_TIMINGS_CAP
+*********************************************************
+
+*man VIDIOC_DV_TIMINGS_CAP(2)*
+
+VIDIOC_SUBDEV_DV_TIMINGS_CAP
+The capabilities of the Digital Video receiver/transmitter
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_dv_timings_cap *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_DV_TIMINGS_CAP, VIDIOC_SUBDEV_DV_TIMINGS_CAP
+
+``argp``
+
+
+Description
+===========
+
+To query the capabilities of the DV receiver/transmitter applications
+initialize the ``pad`` field to 0, zero the reserved array of struct
+:ref:`v4l2_dv_timings_cap <v4l2-dv-timings-cap>` and call the
+``VIDIOC_DV_TIMINGS_CAP`` ioctl on a video node and the driver will fill
+in the structure. Note that drivers may return different values after
+switching the video input or output.
+
+When implemented by the driver DV capabilities of subdevices can be
+queried by calling the ``VIDIOC_SUBDEV_DV_TIMINGS_CAP`` ioctl directly
+on a subdevice node. The capabilities are specific to inputs (for DV
+receivers) or outputs (for DV transmitters), applications must specify
+the desired pad number in the struct
+:ref:`v4l2_dv_timings_cap <v4l2-dv-timings-cap>` ``pad`` field and
+zero the ``reserved`` array. Attempts to query capabilities on a pad
+that doesn't support them will return an EINVAL error code.
+
+
+.. _v4l2-bt-timings-cap:
+
+.. flat-table:: struct v4l2_bt_timings_cap
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``min_width``
+
+       -  Minimum width of the active video in pixels.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``max_width``
+
+       -  Maximum width of the active video in pixels.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``min_height``
+
+       -  Minimum height of the active video in lines.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``max_height``
+
+       -  Maximum height of the active video in lines.
+
+    -  .. row 5
+
+       -  __u64
+
+       -  ``min_pixelclock``
+
+       -  Minimum pixelclock frequency in Hz.
+
+    -  .. row 6
+
+       -  __u64
+
+       -  ``max_pixelclock``
+
+       -  Maximum pixelclock frequency in Hz.
+
+    -  .. row 7
+
+       -  __u32
+
+       -  ``standards``
+
+       -  The video standard(s) supported by the hardware. See
+          :ref:`dv-bt-standards` for a list of standards.
+
+    -  .. row 8
+
+       -  __u32
+
+       -  ``capabilities``
+
+       -  Several flags giving more information about the capabilities. See
+          :ref:`dv-bt-cap-capabilities` for a description of the flags.
+
+    -  .. row 9
+
+       -  __u32
+
+       -  ``reserved``\ [16]
+
+       -  Reserved for future extensions. Drivers must set the array to
+          zero.
+
+
+
+.. _v4l2-dv-timings-cap:
+
+.. flat-table:: struct v4l2_dv_timings_cap
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2 1
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``type``
+
+       -  Type of DV timings as listed in :ref:`dv-timing-types`.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``pad``
+
+       -  Pad number as reported by the media controller API. This field is
+          only used when operating on a subdevice node. When operating on a
+          video node applications must set this field to zero.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``reserved``\ [2]
+
+       -  Reserved for future extensions. Drivers and applications must set
+          the array to zero.
+
+    -  .. row 4
+
+       -  union
+
+       -  
+       -  
+
+    -  .. row 5
+
+       -  
+       -  struct :ref:`v4l2_bt_timings_cap <v4l2-bt-timings-cap>`
+
+       -  ``bt``
+
+       -  BT.656/1120 timings capabilities of the hardware.
+
+    -  .. row 6
+
+       -  
+       -  __u32
+
+       -  ``raw_data``\ [32]
+
+       -  
+
+
+
+.. _dv-bt-cap-capabilities:
+
+.. flat-table:: DV BT Timing capabilities
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  Flag
+
+       -  Description
+
+    -  .. row 2
+
+       -  
+       -  
+
+    -  .. row 3
+
+       -  V4L2_DV_BT_CAP_INTERLACED
+
+       -  Interlaced formats are supported.
+
+    -  .. row 4
+
+       -  V4L2_DV_BT_CAP_PROGRESSIVE
+
+       -  Progressive formats are supported.
+
+    -  .. row 5
+
+       -  V4L2_DV_BT_CAP_REDUCED_BLANKING
+
+       -  CVT/GTF specific: the timings can make use of reduced blanking
+          (CVT) or the 'Secondary GTF' curve (GTF).
+
+    -  .. row 6
+
+       -  V4L2_DV_BT_CAP_CUSTOM
+
+       -  Can support non-standard timings, i.e. timings not belonging to
+          the standards set in the ``standards`` field.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-encoder-cmd.rst b/Documentation/linux_tv/media/v4l/vidioc-encoder-cmd.rst
new file mode 100644
index 000000000000..018f31e38c6d
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-encoder-cmd.rst
@@ -0,0 +1,204 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-encoder-cmd:
+
+************************************************
+ioctl VIDIOC_ENCODER_CMD, VIDIOC_TRY_ENCODER_CMD
+************************************************
+
+*man VIDIOC_ENCODER_CMD(2)*
+
+VIDIOC_TRY_ENCODER_CMD
+Execute an encoder command
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_encoder_cmd *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_ENCODER_CMD, VIDIOC_TRY_ENCODER_CMD
+
+``argp``
+
+
+Description
+===========
+
+These ioctls control an audio/video (usually MPEG-) encoder.
+``VIDIOC_ENCODER_CMD`` sends a command to the encoder,
+``VIDIOC_TRY_ENCODER_CMD`` can be used to try a command without actually
+executing it.
+
+To send a command applications must initialize all fields of a struct
+:ref:`v4l2_encoder_cmd <v4l2-encoder-cmd>` and call
+``VIDIOC_ENCODER_CMD`` or ``VIDIOC_TRY_ENCODER_CMD`` with a pointer to
+this structure.
+
+The ``cmd`` field must contain the command code. The ``flags`` field is
+currently only used by the STOP command and contains one bit: If the
+``V4L2_ENC_CMD_STOP_AT_GOP_END`` flag is set, encoding will continue
+until the end of the current *Group Of Pictures*, otherwise it will stop
+immediately.
+
+A :c:func:`read()`() or :ref:`VIDIOC_STREAMON <vidioc-streamon>`
+call sends an implicit START command to the encoder if it has not been
+started yet. After a STOP command, :c:func:`read()`() calls will read
+the remaining data buffered by the driver. When the buffer is empty,
+:c:func:`read()`() will return zero and the next :c:func:`read()`()
+call will restart the encoder.
+
+A :c:func:`close()`() or :ref:`VIDIOC_STREAMOFF <vidioc-streamon>`
+call of a streaming file descriptor sends an implicit immediate STOP to
+the encoder, and all buffered data is discarded.
+
+These ioctls are optional, not all drivers may support them. They were
+introduced in Linux 2.6.21.
+
+
+.. _v4l2-encoder-cmd:
+
+.. flat-table:: struct v4l2_encoder_cmd
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``cmd``
+
+       -  The encoder command, see :ref:`encoder-cmds`.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``flags``
+
+       -  Flags to go with the command, see :ref:`encoder-flags`. If no
+          flags are defined for this command, drivers and applications must
+          set this field to zero.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``data``\ [8]
+
+       -  Reserved for future extensions. Drivers and applications must set
+          the array to zero.
+
+
+
+.. _encoder-cmds:
+
+.. flat-table:: Encoder Commands
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_ENC_CMD_START``
+
+       -  0
+
+       -  Start the encoder. When the encoder is already running or paused,
+          this command does nothing. No flags are defined for this command.
+
+    -  .. row 2
+
+       -  ``V4L2_ENC_CMD_STOP``
+
+       -  1
+
+       -  Stop the encoder. When the ``V4L2_ENC_CMD_STOP_AT_GOP_END`` flag
+          is set, encoding will continue until the end of the current *Group
+          Of Pictures*, otherwise encoding will stop immediately. When the
+          encoder is already stopped, this command does nothing. mem2mem
+          encoders will send a ``V4L2_EVENT_EOS`` event when the last frame
+          has been encoded and all frames are ready to be dequeued and will
+          set the ``V4L2_BUF_FLAG_LAST`` buffer flag on the last buffer of
+          the capture queue to indicate there will be no new buffers
+          produced to dequeue. This buffer may be empty, indicated by the
+          driver setting the ``bytesused`` field to 0. Once the
+          ``V4L2_BUF_FLAG_LAST`` flag was set, the
+          :ref:`VIDIOC_DQBUF <vidioc-qbuf>` ioctl will not block anymore,
+          but return an EPIPE error code.
+
+    -  .. row 3
+
+       -  ``V4L2_ENC_CMD_PAUSE``
+
+       -  2
+
+       -  Pause the encoder. When the encoder has not been started yet, the
+          driver will return an EPERM error code. When the encoder is
+          already paused, this command does nothing. No flags are defined
+          for this command.
+
+    -  .. row 4
+
+       -  ``V4L2_ENC_CMD_RESUME``
+
+       -  3
+
+       -  Resume encoding after a PAUSE command. When the encoder has not
+          been started yet, the driver will return an EPERM error code. When
+          the encoder is already running, this command does nothing. No
+          flags are defined for this command.
+
+
+
+.. _encoder-flags:
+
+.. flat-table:: Encoder Command Flags
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_ENC_CMD_STOP_AT_GOP_END``
+
+       -  0x0001
+
+       -  Stop encoding at the end of the current *Group Of Pictures*,
+          rather than immediately.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The ``cmd`` field is invalid.
+
+EPERM
+    The application sent a PAUSE or RESUME command when the encoder was
+    not running.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-enum-dv-timings.rst b/Documentation/linux_tv/media/v4l/vidioc-enum-dv-timings.rst
new file mode 100644
index 000000000000..b328829cbf76
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-enum-dv-timings.rst
@@ -0,0 +1,128 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-enum-dv-timings:
+
+***********************************************************
+ioctl VIDIOC_ENUM_DV_TIMINGS, VIDIOC_SUBDEV_ENUM_DV_TIMINGS
+***********************************************************
+
+*man VIDIOC_ENUM_DV_TIMINGS(2)*
+
+VIDIOC_SUBDEV_ENUM_DV_TIMINGS
+Enumerate supported Digital Video timings
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_enum_dv_timings *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_ENUM_DV_TIMINGS, VIDIOC_SUBDEV_ENUM_DV_TIMINGS
+
+``argp``
+
+
+Description
+===========
+
+While some DV receivers or transmitters support a wide range of timings,
+others support only a limited number of timings. With this ioctl
+applications can enumerate a list of known supported timings. Call
+:ref:`VIDIOC_DV_TIMINGS_CAP <vidioc-dv-timings-cap>` to check if it
+also supports other standards or even custom timings that are not in
+this list.
+
+To query the available timings, applications initialize the ``index``
+field, set the ``pad`` field to 0, zero the reserved array of struct
+:ref:`v4l2_enum_dv_timings <v4l2-enum-dv-timings>` and call the
+``VIDIOC_ENUM_DV_TIMINGS`` ioctl on a video node with a pointer to this
+structure. Drivers fill the rest of the structure or return an EINVAL
+error code when the index is out of bounds. To enumerate all supported
+DV timings, applications shall begin at index zero, incrementing by one
+until the driver returns EINVAL. Note that drivers may enumerate a
+different set of DV timings after switching the video input or output.
+
+When implemented by the driver DV timings of subdevices can be queried
+by calling the ``VIDIOC_SUBDEV_ENUM_DV_TIMINGS`` ioctl directly on a
+subdevice node. The DV timings are specific to inputs (for DV receivers)
+or outputs (for DV transmitters), applications must specify the desired
+pad number in the struct
+:ref:`v4l2_enum_dv_timings <v4l2-enum-dv-timings>` ``pad`` field.
+Attempts to enumerate timings on a pad that doesn't support them will
+return an EINVAL error code.
+
+
+.. _v4l2-enum-dv-timings:
+
+.. flat-table:: struct v4l2_enum_dv_timings
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``index``
+
+       -  Number of the DV timings, set by the application.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``pad``
+
+       -  Pad number as reported by the media controller API. This field is
+          only used when operating on a subdevice node. When operating on a
+          video node applications must set this field to zero.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``reserved``\ [2]
+
+       -  Reserved for future extensions. Drivers and applications must set
+          the array to zero.
+
+    -  .. row 4
+
+       -  struct :ref:`v4l2_dv_timings <v4l2-dv-timings>`
+
+       -  ``timings``
+
+       -  The timings.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The struct :ref:`v4l2_enum_dv_timings <v4l2-enum-dv-timings>`
+    ``index`` is out of bounds or the ``pad`` number is invalid.
+
+ENODATA
+    Digital video presets are not supported for this input or output.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-enum-fmt.rst b/Documentation/linux_tv/media/v4l/vidioc-enum-fmt.rst
new file mode 100644
index 000000000000..bcf7eda8bfdf
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-enum-fmt.rst
@@ -0,0 +1,172 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-enum-fmt:
+
+*********************
+ioctl VIDIOC_ENUM_FMT
+*********************
+
+*man VIDIOC_ENUM_FMT(2)*
+
+Enumerate image formats
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_fmtdesc *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_ENUM_FMT
+
+``argp``
+
+
+Description
+===========
+
+To enumerate image formats applications initialize the ``type`` and
+``index`` field of struct :ref:`v4l2_fmtdesc <v4l2-fmtdesc>` and call
+the ``VIDIOC_ENUM_FMT`` ioctl with a pointer to this structure. Drivers
+fill the rest of the structure or return an EINVAL error code. All
+formats are enumerable by beginning at index zero and incrementing by
+one until EINVAL is returned.
+
+Note that after switching input or output the list of enumerated image
+formats may be different.
+
+
+.. _v4l2-fmtdesc:
+
+.. flat-table:: struct v4l2_fmtdesc
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``index``
+
+       -  Number of the format in the enumeration, set by the application.
+          This is in no way related to the ``pixelformat`` field.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``type``
+
+       -  Type of the data stream, set by the application. Only these types
+          are valid here: ``V4L2_BUF_TYPE_VIDEO_CAPTURE``,
+          ``V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE``,
+          ``V4L2_BUF_TYPE_VIDEO_OUTPUT``,
+          ``V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE`` and
+          ``V4L2_BUF_TYPE_VIDEO_OVERLAY``. See :ref:`v4l2-buf-type`.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``flags``
+
+       -  See :ref:`fmtdesc-flags`
+
+    -  .. row 4
+
+       -  __u8
+
+       -  ``description``\ [32]
+
+       -  Description of the format, a NUL-terminated ASCII string. This
+          information is intended for the user, for example: "YUV 4:2:2".
+
+    -  .. row 5
+
+       -  __u32
+
+       -  ``pixelformat``
+
+       -  The image format identifier. This is a four character code as
+          computed by the v4l2_fourcc() macro:
+
+    -  .. row 6
+
+       -  :cspan:`2`
+
+
+          .. _v4l2-fourcc:
+          .. code-block:: c
+
+              #define v4l2_fourcc(a,b,c,d) (((__u32)(a)<<0)|((__u32)(b)<<8)|((__u32)(c)<<16)|((__u32)(d)<<24))
+
+          Several image formats are already defined by this specification in
+          :ref:`pixfmt`. Note these codes are not the same as those used
+          in the Windows world.
+
+    -  .. row 7
+
+       -  __u32
+
+       -  ``reserved``\ [4]
+
+       -  Reserved for future extensions. Drivers must set the array to
+          zero.
+
+
+
+.. _fmtdesc-flags:
+
+.. flat-table:: Image Format Description Flags
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_FMT_FLAG_COMPRESSED``
+
+       -  0x0001
+
+       -  This is a compressed format.
+
+    -  .. row 2
+
+       -  ``V4L2_FMT_FLAG_EMULATED``
+
+       -  0x0002
+
+       -  This format is not native to the device but emulated through
+          software (usually libv4l2), where possible try to use a native
+          format instead for better performance.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The struct :ref:`v4l2_fmtdesc <v4l2-fmtdesc>` ``type`` is not
+    supported or the ``index`` is out of bounds.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-enum-frameintervals.rst b/Documentation/linux_tv/media/v4l/vidioc-enum-frameintervals.rst
new file mode 100644
index 000000000000..245e01ff2e58
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-enum-frameintervals.rst
@@ -0,0 +1,282 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-enum-frameintervals:
+
+********************************
+ioctl VIDIOC_ENUM_FRAMEINTERVALS
+********************************
+
+*man VIDIOC_ENUM_FRAMEINTERVALS(2)*
+
+Enumerate frame intervals
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_frmivalenum *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_ENUM_FRAMEINTERVALS
+
+``argp``
+    Pointer to a struct :ref:`v4l2_frmivalenum <v4l2-frmivalenum>`
+    structure that contains a pixel format and size and receives a frame
+    interval.
+
+
+Description
+===========
+
+This ioctl allows applications to enumerate all frame intervals that the
+device supports for the given pixel format and frame size.
+
+The supported pixel formats and frame sizes can be obtained by using the
+:ref:`VIDIOC_ENUM_FMT <vidioc-enum-fmt>` and
+:ref:`VIDIOC_ENUM_FRAMESIZES <vidioc-enum-framesizes>` functions.
+
+The return value and the content of the ``v4l2_frmivalenum.type`` field
+depend on the type of frame intervals the device supports. Here are the
+semantics of the function for the different cases:
+
+-  **Discrete:** The function returns success if the given index value
+   (zero-based) is valid. The application should increase the index by
+   one for each call until ``EINVAL`` is returned. The
+   `v4l2_frmivalenum.type` field is set to
+   `V4L2_FRMIVAL_TYPE_DISCRETE` by the driver. Of the union only
+   the `discrete` member is valid.
+
+-  **Step-wise:** The function returns success if the given index value
+   is zero and ``EINVAL`` for any other index value. The
+   ``v4l2_frmivalenum.type`` field is set to
+   ``V4L2_FRMIVAL_TYPE_STEPWISE`` by the driver. Of the union only the
+   ``stepwise`` member is valid.
+
+-  **Continuous:** This is a special case of the step-wise type above.
+   The function returns success if the given index value is zero and
+   ``EINVAL`` for any other index value. The ``v4l2_frmivalenum.type``
+   field is set to ``V4L2_FRMIVAL_TYPE_CONTINUOUS`` by the driver. Of
+   the union only the ``stepwise`` member is valid and the ``step``
+   value is set to 1.
+
+When the application calls the function with index zero, it must check
+the ``type`` field to determine the type of frame interval enumeration
+the device supports. Only for the ``V4L2_FRMIVAL_TYPE_DISCRETE`` type
+does it make sense to increase the index value to receive more frame
+intervals.
+
+Note that the order in which the frame intervals are returned has no
+special meaning. In particular does it not say anything about potential
+default frame intervals.
+
+Applications can assume that the enumeration data does not change
+without any interaction from the application itself. This means that the
+enumeration data is consistent if the application does not perform any
+other ioctl calls while it runs the frame interval enumeration.
+
+
+Notes
+=====
+
+-  **Frame intervals and frame rates:** The V4L2 API uses frame
+   intervals instead of frame rates. Given the frame interval the frame
+   rate can be computed as follows:
+
+
+
+   ::
+
+       frame_rate = 1 / frame_interval
+
+
+Structs
+=======
+
+In the structs below, *IN* denotes a value that has to be filled in by
+the application, *OUT* denotes values that the driver fills in. The
+application should zero out all members except for the *IN* fields.
+
+
+.. _v4l2-frmival-stepwise:
+
+.. flat-table:: struct v4l2_frmival_stepwise
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  struct :ref:`v4l2_fract <v4l2-fract>`
+
+       -  ``min``
+
+       -  Minimum frame interval [s].
+
+    -  .. row 2
+
+       -  struct :ref:`v4l2_fract <v4l2-fract>`
+
+       -  ``max``
+
+       -  Maximum frame interval [s].
+
+    -  .. row 3
+
+       -  struct :ref:`v4l2_fract <v4l2-fract>`
+
+       -  ``step``
+
+       -  Frame interval step size [s].
+
+
+
+.. _v4l2-frmivalenum:
+
+.. flat-table:: struct v4l2_frmivalenum
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``index``
+
+       -  
+       -  IN: Index of the given frame interval in the enumeration.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``pixel_format``
+
+       -  
+       -  IN: Pixel format for which the frame intervals are enumerated.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``width``
+
+       -  
+       -  IN: Frame width for which the frame intervals are enumerated.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``height``
+
+       -  
+       -  IN: Frame height for which the frame intervals are enumerated.
+
+    -  .. row 5
+
+       -  __u32
+
+       -  ``type``
+
+       -  
+       -  OUT: Frame interval type the device supports.
+
+    -  .. row 6
+
+       -  union
+
+       -  
+       -  
+       -  OUT: Frame interval with the given index.
+
+    -  .. row 7
+
+       -  
+       -  struct :ref:`v4l2_fract <v4l2-fract>`
+
+       -  ``discrete``
+
+       -  Frame interval [s].
+
+    -  .. row 8
+
+       -  
+       -  struct :ref:`v4l2_frmival_stepwise <v4l2-frmival-stepwise>`
+
+       -  ``stepwise``
+
+       -  
+
+    -  .. row 9
+
+       -  __u32
+
+       -  ``reserved[2]``
+
+       -  
+       -  Reserved space for future use. Must be zeroed by drivers and
+          applications.
+
+
+
+Enums
+=====
+
+
+.. _v4l2-frmivaltypes:
+
+.. flat-table:: enum v4l2_frmivaltypes
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_FRMIVAL_TYPE_DISCRETE``
+
+       -  1
+
+       -  Discrete frame interval.
+
+    -  .. row 2
+
+       -  ``V4L2_FRMIVAL_TYPE_CONTINUOUS``
+
+       -  2
+
+       -  Continuous frame interval.
+
+    -  .. row 3
+
+       -  ``V4L2_FRMIVAL_TYPE_STEPWISE``
+
+       -  3
+
+       -  Step-wise defined frame interval.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-enum-framesizes.rst b/Documentation/linux_tv/media/v4l/vidioc-enum-framesizes.rst
new file mode 100644
index 000000000000..e3d2ad50db74
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-enum-framesizes.rst
@@ -0,0 +1,299 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-enum-framesizes:
+
+****************************
+ioctl VIDIOC_ENUM_FRAMESIZES
+****************************
+
+*man VIDIOC_ENUM_FRAMESIZES(2)*
+
+Enumerate frame sizes
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_frmsizeenum *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_ENUM_FRAMESIZES
+
+``argp``
+    Pointer to a struct :ref:`v4l2_frmsizeenum <v4l2-frmsizeenum>`
+    that contains an index and pixel format and receives a frame width
+    and height.
+
+
+Description
+===========
+
+This ioctl allows applications to enumerate all frame sizes (i. e. width
+and height in pixels) that the device supports for the given pixel
+format.
+
+The supported pixel formats can be obtained by using the
+:ref:`VIDIOC_ENUM_FMT <vidioc-enum-fmt>` function.
+
+The return value and the content of the ``v4l2_frmsizeenum.type`` field
+depend on the type of frame sizes the device supports. Here are the
+semantics of the function for the different cases:
+
+-  **Discrete:** The function returns success if the given index value
+   (zero-based) is valid. The application should increase the index by
+   one for each call until ``EINVAL`` is returned. The
+   ``v4l2_frmsizeenum.type`` field is set to
+   ``V4L2_FRMSIZE_TYPE_DISCRETE`` by the driver. Of the union only the
+   ``discrete`` member is valid.
+
+-  **Step-wise:** The function returns success if the given index value
+   is zero and ``EINVAL`` for any other index value. The
+   ``v4l2_frmsizeenum.type`` field is set to
+   ``V4L2_FRMSIZE_TYPE_STEPWISE`` by the driver. Of the union only the
+   ``stepwise`` member is valid.
+
+-  **Continuous:** This is a special case of the step-wise type above.
+   The function returns success if the given index value is zero and
+   ``EINVAL`` for any other index value. The ``v4l2_frmsizeenum.type``
+   field is set to ``V4L2_FRMSIZE_TYPE_CONTINUOUS`` by the driver. Of
+   the union only the ``stepwise`` member is valid and the
+   ``step_width`` and ``step_height`` values are set to 1.
+
+When the application calls the function with index zero, it must check
+the ``type`` field to determine the type of frame size enumeration the
+device supports. Only for the ``V4L2_FRMSIZE_TYPE_DISCRETE`` type does
+it make sense to increase the index value to receive more frame sizes.
+
+Note that the order in which the frame sizes are returned has no special
+meaning. In particular does it not say anything about potential default
+format sizes.
+
+Applications can assume that the enumeration data does not change
+without any interaction from the application itself. This means that the
+enumeration data is consistent if the application does not perform any
+other ioctl calls while it runs the frame size enumeration.
+
+
+Structs
+=======
+
+In the structs below, *IN* denotes a value that has to be filled in by
+the application, *OUT* denotes values that the driver fills in. The
+application should zero out all members except for the *IN* fields.
+
+
+.. _v4l2-frmsize-discrete:
+
+.. flat-table:: struct v4l2_frmsize_discrete
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``width``
+
+       -  Width of the frame [pixel].
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``height``
+
+       -  Height of the frame [pixel].
+
+
+
+.. _v4l2-frmsize-stepwise:
+
+.. flat-table:: struct v4l2_frmsize_stepwise
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``min_width``
+
+       -  Minimum frame width [pixel].
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``max_width``
+
+       -  Maximum frame width [pixel].
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``step_width``
+
+       -  Frame width step size [pixel].
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``min_height``
+
+       -  Minimum frame height [pixel].
+
+    -  .. row 5
+
+       -  __u32
+
+       -  ``max_height``
+
+       -  Maximum frame height [pixel].
+
+    -  .. row 6
+
+       -  __u32
+
+       -  ``step_height``
+
+       -  Frame height step size [pixel].
+
+
+
+.. _v4l2-frmsizeenum:
+
+.. flat-table:: struct v4l2_frmsizeenum
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``index``
+
+       -  
+       -  IN: Index of the given frame size in the enumeration.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``pixel_format``
+
+       -  
+       -  IN: Pixel format for which the frame sizes are enumerated.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``type``
+
+       -  
+       -  OUT: Frame size type the device supports.
+
+    -  .. row 4
+
+       -  union
+
+       -  
+       -  
+       -  OUT: Frame size with the given index.
+
+    -  .. row 5
+
+       -  
+       -  struct :ref:`v4l2_frmsize_discrete <v4l2-frmsize-discrete>`
+
+       -  ``discrete``
+
+       -  
+
+    -  .. row 6
+
+       -  
+       -  struct :ref:`v4l2_frmsize_stepwise <v4l2-frmsize-stepwise>`
+
+       -  ``stepwise``
+
+       -  
+
+    -  .. row 7
+
+       -  __u32
+
+       -  ``reserved[2]``
+
+       -  
+       -  Reserved space for future use. Must be zeroed by drivers and
+          applications.
+
+
+
+Enums
+=====
+
+
+.. _v4l2-frmsizetypes:
+
+.. flat-table:: enum v4l2_frmsizetypes
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_FRMSIZE_TYPE_DISCRETE``
+
+       -  1
+
+       -  Discrete frame size.
+
+    -  .. row 2
+
+       -  ``V4L2_FRMSIZE_TYPE_CONTINUOUS``
+
+       -  2
+
+       -  Continuous frame size.
+
+    -  .. row 3
+
+       -  ``V4L2_FRMSIZE_TYPE_STEPWISE``
+
+       -  3
+
+       -  Step-wise defined frame size.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-enum-freq-bands.rst b/Documentation/linux_tv/media/v4l/vidioc-enum-freq-bands.rst
new file mode 100644
index 000000000000..7bb726d519be
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-enum-freq-bands.rst
@@ -0,0 +1,198 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-enum-freq-bands:
+
+****************************
+ioctl VIDIOC_ENUM_FREQ_BANDS
+****************************
+
+*man VIDIOC_ENUM_FREQ_BANDS(2)*
+
+Enumerate supported frequency bands
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_frequency_band *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_ENUM_FREQ_BANDS
+
+``argp``
+
+
+Description
+===========
+
+Enumerates the frequency bands that a tuner or modulator supports. To do
+this applications initialize the ``tuner``, ``type`` and ``index``
+fields, and zero out the ``reserved`` array of a struct
+:ref:`v4l2_frequency_band <v4l2-frequency-band>` and call the
+``VIDIOC_ENUM_FREQ_BANDS`` ioctl with a pointer to this structure.
+
+This ioctl is supported if the ``V4L2_TUNER_CAP_FREQ_BANDS`` capability
+of the corresponding tuner/modulator is set.
+
+
+.. _v4l2-frequency-band:
+
+.. flat-table:: struct v4l2_frequency_band
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2 1 1
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``tuner``
+
+       -  The tuner or modulator index number. This is the same value as in
+          the struct :ref:`v4l2_input <v4l2-input>` ``tuner`` field and
+          the struct :ref:`v4l2_tuner <v4l2-tuner>` ``index`` field, or
+          the struct :ref:`v4l2_output <v4l2-output>` ``modulator`` field
+          and the struct :ref:`v4l2_modulator <v4l2-modulator>` ``index``
+          field.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``type``
+
+       -  The tuner type. This is the same value as in the struct
+          :ref:`v4l2_tuner <v4l2-tuner>` ``type`` field. The type must be
+          set to ``V4L2_TUNER_RADIO`` for ``/dev/radioX`` device nodes, and
+          to ``V4L2_TUNER_ANALOG_TV`` for all others. Set this field to
+          ``V4L2_TUNER_RADIO`` for modulators (currently only radio
+          modulators are supported). See :ref:`v4l2-tuner-type`
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``index``
+
+       -  Identifies the frequency band, set by the application.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``capability``
+
+       -  :cspan:`2` The tuner/modulator capability flags for this
+          frequency band, see :ref:`tuner-capability`. The
+          ``V4L2_TUNER_CAP_LOW`` or ``V4L2_TUNER_CAP_1HZ`` capability must
+          be the same for all frequency bands of the selected
+          tuner/modulator. So either all bands have that capability set, or
+          none of them have that capability.
+
+    -  .. row 5
+
+       -  __u32
+
+       -  ``rangelow``
+
+       -  :cspan:`2` The lowest tunable frequency in units of 62.5 kHz, or
+          if the ``capability`` flag ``V4L2_TUNER_CAP_LOW`` is set, in units
+          of 62.5 Hz, for this frequency band. A 1 Hz unit is used when the
+          ``capability`` flag ``V4L2_TUNER_CAP_1HZ`` is set.
+
+    -  .. row 6
+
+       -  __u32
+
+       -  ``rangehigh``
+
+       -  :cspan:`2` The highest tunable frequency in units of 62.5 kHz,
+          or if the ``capability`` flag ``V4L2_TUNER_CAP_LOW`` is set, in
+          units of 62.5 Hz, for this frequency band. A 1 Hz unit is used
+          when the ``capability`` flag ``V4L2_TUNER_CAP_1HZ`` is set.
+
+    -  .. row 7
+
+       -  __u32
+
+       -  ``modulation``
+
+       -  :cspan:`2` The supported modulation systems of this frequency
+          band. See :ref:`band-modulation`. Note that currently only one
+          modulation system per frequency band is supported. More work will
+          need to be done if multiple modulation systems are possible.
+          Contact the linux-media mailing list
+          (`https://linuxtv.org/lists.php <https://linuxtv.org/lists.php>`__)
+          if you need that functionality.
+
+    -  .. row 8
+
+       -  __u32
+
+       -  ``reserved``\ [9]
+
+       -  Reserved for future extensions. Applications and drivers must set
+          the array to zero.
+
+
+
+.. _band-modulation:
+
+.. flat-table:: Band Modulation Systems
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_BAND_MODULATION_VSB``
+
+       -  0x02
+
+       -  Vestigial Sideband modulation, used for analog TV.
+
+    -  .. row 2
+
+       -  ``V4L2_BAND_MODULATION_FM``
+
+       -  0x04
+
+       -  Frequency Modulation, commonly used for analog radio.
+
+    -  .. row 3
+
+       -  ``V4L2_BAND_MODULATION_AM``
+
+       -  0x08
+
+       -  Amplitude Modulation, commonly used for analog radio.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The ``tuner`` or ``index`` is out of bounds or the ``type`` field is
+    wrong.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-enumaudio.rst b/Documentation/linux_tv/media/v4l/vidioc-enumaudio.rst
new file mode 100644
index 000000000000..c42e13bf0578
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-enumaudio.rst
@@ -0,0 +1,63 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-enumaudio:
+
+**********************
+ioctl VIDIOC_ENUMAUDIO
+**********************
+
+*man VIDIOC_ENUMAUDIO(2)*
+
+Enumerate audio inputs
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_audio *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_ENUMAUDIO
+
+``argp``
+
+
+Description
+===========
+
+To query the attributes of an audio input applications initialize the
+``index`` field and zero out the ``reserved`` array of a struct
+:ref:`v4l2_audio <v4l2-audio>` and call the ``VIDIOC_ENUMAUDIO``
+ioctl with a pointer to this structure. Drivers fill the rest of the
+structure or return an EINVAL error code when the index is out of
+bounds. To enumerate all audio inputs applications shall begin at index
+zero, incrementing by one until the driver returns EINVAL.
+
+See :ref:`vidioc-g-audio` for a description of struct
+:ref:`v4l2_audio <v4l2-audio>`.
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The number of the audio input is out of bounds.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-enumaudioout.rst b/Documentation/linux_tv/media/v4l/vidioc-enumaudioout.rst
new file mode 100644
index 000000000000..54157607d90d
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-enumaudioout.rst
@@ -0,0 +1,66 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-enumaudioout:
+
+***********************
+ioctl VIDIOC_ENUMAUDOUT
+***********************
+
+*man VIDIOC_ENUMAUDOUT(2)*
+
+Enumerate audio outputs
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_audioout *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_ENUMAUDOUT
+
+``argp``
+
+
+Description
+===========
+
+To query the attributes of an audio output applications initialize the
+``index`` field and zero out the ``reserved`` array of a struct
+:ref:`v4l2_audioout <v4l2-audioout>` and call the ``VIDIOC_G_AUDOUT``
+ioctl with a pointer to this structure. Drivers fill the rest of the
+structure or return an EINVAL error code when the index is out of
+bounds. To enumerate all audio outputs applications shall begin at index
+zero, incrementing by one until the driver returns EINVAL.
+
+Note connectors on a TV card to loop back the received audio signal to a
+sound card are not audio outputs in this sense.
+
+See :ref:`vidioc-g-audioout` for a description of struct
+:ref:`v4l2_audioout <v4l2-audioout>`.
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The number of the audio output is out of bounds.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-enuminput.rst b/Documentation/linux_tv/media/v4l/vidioc-enuminput.rst
new file mode 100644
index 000000000000..32c8dac7f400
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-enuminput.rst
@@ -0,0 +1,375 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-enuminput:
+
+**********************
+ioctl VIDIOC_ENUMINPUT
+**********************
+
+*man VIDIOC_ENUMINPUT(2)*
+
+Enumerate video inputs
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_input *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_ENUMINPUT
+
+``argp``
+
+
+Description
+===========
+
+To query the attributes of a video input applications initialize the
+``index`` field of struct :ref:`v4l2_input <v4l2-input>` and call the
+``VIDIOC_ENUMINPUT`` ioctl with a pointer to this structure. Drivers
+fill the rest of the structure or return an EINVAL error code when the
+index is out of bounds. To enumerate all inputs applications shall begin
+at index zero, incrementing by one until the driver returns EINVAL.
+
+
+.. _v4l2-input:
+
+.. flat-table:: struct v4l2_input
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``index``
+
+       -  Identifies the input, set by the application.
+
+    -  .. row 2
+
+       -  __u8
+
+       -  ``name``\ [32]
+
+       -  Name of the video input, a NUL-terminated ASCII string, for
+          example: "Vin (Composite 2)". This information is intended for the
+          user, preferably the connector label on the device itself.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``type``
+
+       -  Type of the input, see :ref:`input-type`.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``audioset``
+
+       -  Drivers can enumerate up to 32 video and audio inputs. This field
+          shows which audio inputs were selectable as audio source if this
+          was the currently selected video input. It is a bit mask. The LSB
+          corresponds to audio input 0, the MSB to input 31. Any number of
+          bits can be set, or none.
+
+          When the driver does not enumerate audio inputs no bits must be
+          set. Applications shall not interpret this as lack of audio
+          support. Some drivers automatically select audio sources and do
+          not enumerate them since there is no choice anyway.
+
+          For details on audio inputs and how to select the current input
+          see :ref:`audio`.
+
+    -  .. row 5
+
+       -  __u32
+
+       -  ``tuner``
+
+       -  Capture devices can have zero or more tuners (RF demodulators).
+          When the ``type`` is set to ``V4L2_INPUT_TYPE_TUNER`` this is an
+          RF connector and this field identifies the tuner. It corresponds
+          to struct :ref:`v4l2_tuner <v4l2-tuner>` field ``index``. For
+          details on tuners see :ref:`tuner`.
+
+    -  .. row 6
+
+       -  :ref:`v4l2_std_id <v4l2-std-id>`
+
+       -  ``std``
+
+       -  Every video input supports one or more different video standards.
+          This field is a set of all supported standards. For details on
+          video standards and how to switch see :ref:`standard`.
+
+    -  .. row 7
+
+       -  __u32
+
+       -  ``status``
+
+       -  This field provides status information about the input. See
+          :ref:`input-status` for flags. With the exception of the sensor
+          orientation bits ``status`` is only valid when this is the current
+          input.
+
+    -  .. row 8
+
+       -  __u32
+
+       -  ``capabilities``
+
+       -  This field provides capabilities for the input. See
+          :ref:`input-capabilities` for flags.
+
+    -  .. row 9
+
+       -  __u32
+
+       -  ``reserved``\ [3]
+
+       -  Reserved for future extensions. Drivers must set the array to
+          zero.
+
+
+
+.. _input-type:
+
+.. flat-table:: Input Types
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_INPUT_TYPE_TUNER``
+
+       -  1
+
+       -  This input uses a tuner (RF demodulator).
+
+    -  .. row 2
+
+       -  ``V4L2_INPUT_TYPE_CAMERA``
+
+       -  2
+
+       -  Analog baseband input, for example CVBS / Composite Video,
+          S-Video, RGB.
+
+
+
+.. _input-status:
+
+.. flat-table:: Input Status Flags
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  :cspan:`2` General
+
+    -  .. row 2
+
+       -  ``V4L2_IN_ST_NO_POWER``
+
+       -  0x00000001
+
+       -  Attached device is off.
+
+    -  .. row 3
+
+       -  ``V4L2_IN_ST_NO_SIGNAL``
+
+       -  0x00000002
+
+       -  
+
+    -  .. row 4
+
+       -  ``V4L2_IN_ST_NO_COLOR``
+
+       -  0x00000004
+
+       -  The hardware supports color decoding, but does not detect color
+          modulation in the signal.
+
+    -  .. row 5
+
+       -  :cspan:`2` Sensor Orientation
+
+    -  .. row 6
+
+       -  ``V4L2_IN_ST_HFLIP``
+
+       -  0x00000010
+
+       -  The input is connected to a device that produces a signal that is
+          flipped horizontally and does not correct this before passing the
+          signal to userspace.
+
+    -  .. row 7
+
+       -  ``V4L2_IN_ST_VFLIP``
+
+       -  0x00000020
+
+       -  The input is connected to a device that produces a signal that is
+          flipped vertically and does not correct this before passing the
+          signal to userspace. Note that a 180 degree rotation is the same
+          as HFLIP | VFLIP
+
+    -  .. row 8
+
+       -  :cspan:`2` Analog Video
+
+    -  .. row 9
+
+       -  ``V4L2_IN_ST_NO_H_LOCK``
+
+       -  0x00000100
+
+       -  No horizontal sync lock.
+
+    -  .. row 10
+
+       -  ``V4L2_IN_ST_COLOR_KILL``
+
+       -  0x00000200
+
+       -  A color killer circuit automatically disables color decoding when
+          it detects no color modulation. When this flag is set the color
+          killer is enabled *and* has shut off color decoding.
+
+    -  .. row 11
+
+       -  :cspan:`2` Digital Video
+
+    -  .. row 12
+
+       -  ``V4L2_IN_ST_NO_SYNC``
+
+       -  0x00010000
+
+       -  No synchronization lock.
+
+    -  .. row 13
+
+       -  ``V4L2_IN_ST_NO_EQU``
+
+       -  0x00020000
+
+       -  No equalizer lock.
+
+    -  .. row 14
+
+       -  ``V4L2_IN_ST_NO_CARRIER``
+
+       -  0x00040000
+
+       -  Carrier recovery failed.
+
+    -  .. row 15
+
+       -  :cspan:`2` VCR and Set-Top Box
+
+    -  .. row 16
+
+       -  ``V4L2_IN_ST_MACROVISION``
+
+       -  0x01000000
+
+       -  Macrovision is an analog copy prevention system mangling the video
+          signal to confuse video recorders. When this flag is set
+          Macrovision has been detected.
+
+    -  .. row 17
+
+       -  ``V4L2_IN_ST_NO_ACCESS``
+
+       -  0x02000000
+
+       -  Conditional access denied.
+
+    -  .. row 18
+
+       -  ``V4L2_IN_ST_VTR``
+
+       -  0x04000000
+
+       -  VTR time constant. [?]
+
+
+
+.. _input-capabilities:
+
+.. flat-table:: Input capabilities
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_IN_CAP_DV_TIMINGS``
+
+       -  0x00000002
+
+       -  This input supports setting video timings by using
+          VIDIOC_S_DV_TIMINGS.
+
+    -  .. row 2
+
+       -  ``V4L2_IN_CAP_STD``
+
+       -  0x00000004
+
+       -  This input supports setting the TV standard by using
+          VIDIOC_S_STD.
+
+    -  .. row 3
+
+       -  ``V4L2_IN_CAP_NATIVE_SIZE``
+
+       -  0x00000008
+
+       -  This input supports setting the native size using the
+          ``V4L2_SEL_TGT_NATIVE_SIZE`` selection target, see
+          :ref:`v4l2-selections-common`.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The struct :ref:`v4l2_input <v4l2-input>` ``index`` is out of
+    bounds.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-enumoutput.rst b/Documentation/linux_tv/media/v4l/vidioc-enumoutput.rst
new file mode 100644
index 000000000000..89cccda0ccaa
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-enumoutput.rst
@@ -0,0 +1,230 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-enumoutput:
+
+***********************
+ioctl VIDIOC_ENUMOUTPUT
+***********************
+
+*man VIDIOC_ENUMOUTPUT(2)*
+
+Enumerate video outputs
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_output *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_ENUMOUTPUT
+
+``argp``
+
+
+Description
+===========
+
+To query the attributes of a video outputs applications initialize the
+``index`` field of struct :ref:`v4l2_output <v4l2-output>` and call
+the ``VIDIOC_ENUMOUTPUT`` ioctl with a pointer to this structure.
+Drivers fill the rest of the structure or return an EINVAL error code
+when the index is out of bounds. To enumerate all outputs applications
+shall begin at index zero, incrementing by one until the driver returns
+EINVAL.
+
+
+.. _v4l2-output:
+
+.. flat-table:: struct v4l2_output
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``index``
+
+       -  Identifies the output, set by the application.
+
+    -  .. row 2
+
+       -  __u8
+
+       -  ``name``\ [32]
+
+       -  Name of the video output, a NUL-terminated ASCII string, for
+          example: "Vout". This information is intended for the user,
+          preferably the connector label on the device itself.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``type``
+
+       -  Type of the output, see :ref:`output-type`.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``audioset``
+
+       -  Drivers can enumerate up to 32 video and audio outputs. This field
+          shows which audio outputs were selectable as the current output if
+          this was the currently selected video output. It is a bit mask.
+          The LSB corresponds to audio output 0, the MSB to output 31. Any
+          number of bits can be set, or none.
+
+          When the driver does not enumerate audio outputs no bits must be
+          set. Applications shall not interpret this as lack of audio
+          support. Drivers may automatically select audio outputs without
+          enumerating them.
+
+          For details on audio outputs and how to select the current output
+          see :ref:`audio`.
+
+    -  .. row 5
+
+       -  __u32
+
+       -  ``modulator``
+
+       -  Output devices can have zero or more RF modulators. When the
+          ``type`` is ``V4L2_OUTPUT_TYPE_MODULATOR`` this is an RF connector
+          and this field identifies the modulator. It corresponds to struct
+          :ref:`v4l2_modulator <v4l2-modulator>` field ``index``. For
+          details on modulators see :ref:`tuner`.
+
+    -  .. row 6
+
+       -  :ref:`v4l2_std_id <v4l2-std-id>`
+
+       -  ``std``
+
+       -  Every video output supports one or more different video standards.
+          This field is a set of all supported standards. For details on
+          video standards and how to switch see :ref:`standard`.
+
+    -  .. row 7
+
+       -  __u32
+
+       -  ``capabilities``
+
+       -  This field provides capabilities for the output. See
+          :ref:`output-capabilities` for flags.
+
+    -  .. row 8
+
+       -  __u32
+
+       -  ``reserved``\ [3]
+
+       -  Reserved for future extensions. Drivers must set the array to
+          zero.
+
+
+
+.. _output-type:
+
+.. flat-table:: Output Type
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_OUTPUT_TYPE_MODULATOR``
+
+       -  1
+
+       -  This output is an analog TV modulator.
+
+    -  .. row 2
+
+       -  ``V4L2_OUTPUT_TYPE_ANALOG``
+
+       -  2
+
+       -  Analog baseband output, for example Composite / CVBS, S-Video,
+          RGB.
+
+    -  .. row 3
+
+       -  ``V4L2_OUTPUT_TYPE_ANALOGVGAOVERLAY``
+
+       -  3
+
+       -  [?]
+
+
+
+.. _output-capabilities:
+
+.. flat-table:: Output capabilities
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_OUT_CAP_DV_TIMINGS``
+
+       -  0x00000002
+
+       -  This output supports setting video timings by using
+          VIDIOC_S_DV_TIMINGS.
+
+    -  .. row 2
+
+       -  ``V4L2_OUT_CAP_STD``
+
+       -  0x00000004
+
+       -  This output supports setting the TV standard by using
+          VIDIOC_S_STD.
+
+    -  .. row 3
+
+       -  ``V4L2_OUT_CAP_NATIVE_SIZE``
+
+       -  0x00000008
+
+       -  This output supports setting the native size using the
+          ``V4L2_SEL_TGT_NATIVE_SIZE`` selection target, see
+          :ref:`v4l2-selections-common`.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The struct :ref:`v4l2_output <v4l2-output>` ``index`` is out of
+    bounds.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-enumstd.rst b/Documentation/linux_tv/media/v4l/vidioc-enumstd.rst
new file mode 100644
index 000000000000..d82c49028d83
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-enumstd.rst
@@ -0,0 +1,450 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-enumstd:
+
+********************
+ioctl VIDIOC_ENUMSTD
+********************
+
+*man VIDIOC_ENUMSTD(2)*
+
+Enumerate supported video standards
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_standard *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_ENUMSTD
+
+``argp``
+
+
+Description
+===========
+
+To query the attributes of a video standard, especially a custom (driver
+defined) one, applications initialize the ``index`` field of struct
+:ref:`v4l2_standard <v4l2-standard>` and call the ``VIDIOC_ENUMSTD``
+ioctl with a pointer to this structure. Drivers fill the rest of the
+structure or return an EINVAL error code when the index is out of
+bounds. To enumerate all standards applications shall begin at index
+zero, incrementing by one until the driver returns EINVAL. Drivers may
+enumerate a different set of standards after switching the video input
+or output. [1]_
+
+
+.. _v4l2-standard:
+
+.. flat-table:: struct v4l2_standard
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``index``
+
+       -  Number of the video standard, set by the application.
+
+    -  .. row 2
+
+       -  :ref:`v4l2_std_id <v4l2-std-id>`
+
+       -  ``id``
+
+       -  The bits in this field identify the standard as one of the common
+          standards listed in :ref:`v4l2-std-id`, or if bits 32 to 63 are
+          set as custom standards. Multiple bits can be set if the hardware
+          does not distinguish between these standards, however separate
+          indices do not indicate the opposite. The ``id`` must be unique.
+          No other enumerated :c:type:`struct v4l2_standard` structure,
+          for this input or output anyway, can contain the same set of bits.
+
+    -  .. row 3
+
+       -  __u8
+
+       -  ``name``\ [24]
+
+       -  Name of the standard, a NUL-terminated ASCII string, for example:
+          "PAL-B/G", "NTSC Japan". This information is intended for the
+          user.
+
+    -  .. row 4
+
+       -  struct :ref:`v4l2_fract <v4l2-fract>`
+
+       -  ``frameperiod``
+
+       -  The frame period (not field period) is numerator / denominator.
+          For example M/NTSC has a frame period of 1001 / 30000 seconds.
+
+    -  .. row 5
+
+       -  __u32
+
+       -  ``framelines``
+
+       -  Total lines per frame including blanking, e. g. 625 for B/PAL.
+
+    -  .. row 6
+
+       -  __u32
+
+       -  ``reserved``\ [4]
+
+       -  Reserved for future extensions. Drivers must set the array to
+          zero.
+
+
+
+.. _v4l2-fract:
+
+.. flat-table:: struct v4l2_fract
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``numerator``
+
+       -  
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``denominator``
+
+       -  
+
+
+
+.. _v4l2-std-id:
+
+.. flat-table:: typedef v4l2_std_id
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u64
+
+       -  ``v4l2_std_id``
+
+       -  This type is a set, each bit representing another video standard
+          as listed below and in :ref:`video-standards`. The 32 most
+          significant bits are reserved for custom (driver defined) video
+          standards.
+
+
+
+.. code-block:: c
+
+    #define V4L2_STD_PAL_B          ((v4l2_std_id)0x00000001)
+    #define V4L2_STD_PAL_B1         ((v4l2_std_id)0x00000002)
+    #define V4L2_STD_PAL_G          ((v4l2_std_id)0x00000004)
+    #define V4L2_STD_PAL_H          ((v4l2_std_id)0x00000008)
+    #define V4L2_STD_PAL_I          ((v4l2_std_id)0x00000010)
+    #define V4L2_STD_PAL_D          ((v4l2_std_id)0x00000020)
+    #define V4L2_STD_PAL_D1         ((v4l2_std_id)0x00000040)
+    #define V4L2_STD_PAL_K          ((v4l2_std_id)0x00000080)
+
+    #define V4L2_STD_PAL_M          ((v4l2_std_id)0x00000100)
+    #define V4L2_STD_PAL_N          ((v4l2_std_id)0x00000200)
+    #define V4L2_STD_PAL_Nc         ((v4l2_std_id)0x00000400)
+    #define V4L2_STD_PAL_60         ((v4l2_std_id)0x00000800)
+
+``V4L2_STD_PAL_60`` is a hybrid standard with 525 lines, 60 Hz refresh
+rate, and PAL color modulation with a 4.43 MHz color subcarrier. Some
+PAL video recorders can play back NTSC tapes in this mode for display on
+a 50/60 Hz agnostic PAL TV.
+
+
+.. code-block:: c
+
+    #define V4L2_STD_NTSC_M         ((v4l2_std_id)0x00001000)
+    #define V4L2_STD_NTSC_M_JP      ((v4l2_std_id)0x00002000)
+    #define V4L2_STD_NTSC_443       ((v4l2_std_id)0x00004000)
+
+``V4L2_STD_NTSC_443`` is a hybrid standard with 525 lines, 60 Hz refresh
+rate, and NTSC color modulation with a 4.43 MHz color subcarrier.
+
+
+.. code-block:: c
+
+    #define V4L2_STD_NTSC_M_KR      ((v4l2_std_id)0x00008000)
+
+    #define V4L2_STD_SECAM_B        ((v4l2_std_id)0x00010000)
+    #define V4L2_STD_SECAM_D        ((v4l2_std_id)0x00020000)
+    #define V4L2_STD_SECAM_G        ((v4l2_std_id)0x00040000)
+    #define V4L2_STD_SECAM_H        ((v4l2_std_id)0x00080000)
+    #define V4L2_STD_SECAM_K        ((v4l2_std_id)0x00100000)
+    #define V4L2_STD_SECAM_K1       ((v4l2_std_id)0x00200000)
+    #define V4L2_STD_SECAM_L        ((v4l2_std_id)0x00400000)
+    #define V4L2_STD_SECAM_LC       ((v4l2_std_id)0x00800000)
+
+    /* ATSC/HDTV */
+    #define V4L2_STD_ATSC_8_VSB     ((v4l2_std_id)0x01000000)
+    #define V4L2_STD_ATSC_16_VSB    ((v4l2_std_id)0x02000000)
+
+``V4L2_STD_ATSC_8_VSB`` and ``V4L2_STD_ATSC_16_VSB`` are U.S.
+terrestrial digital TV standards. Presently the V4L2 API does not
+support digital TV. See also the Linux DVB API at
+`https://linuxtv.org <https://linuxtv.org>`__.
+
+
+.. code-block:: c
+
+    #define V4L2_STD_PAL_BG         (V4L2_STD_PAL_B         |
+                     V4L2_STD_PAL_B1        |
+                     V4L2_STD_PAL_G)
+    #define V4L2_STD_B              (V4L2_STD_PAL_B         |
+                     V4L2_STD_PAL_B1        |
+                     V4L2_STD_SECAM_B)
+    #define V4L2_STD_GH             (V4L2_STD_PAL_G         |
+                     V4L2_STD_PAL_H         |
+                     V4L2_STD_SECAM_G       |
+                     V4L2_STD_SECAM_H)
+    #define V4L2_STD_PAL_DK         (V4L2_STD_PAL_D         |
+                     V4L2_STD_PAL_D1        |
+                     V4L2_STD_PAL_K)
+    #define V4L2_STD_PAL            (V4L2_STD_PAL_BG        |
+                     V4L2_STD_PAL_DK        |
+                     V4L2_STD_PAL_H         |
+                     V4L2_STD_PAL_I)
+    #define V4L2_STD_NTSC           (V4L2_STD_NTSC_M        |
+                     V4L2_STD_NTSC_M_JP     |
+                     V4L2_STD_NTSC_M_KR)
+    #define V4L2_STD_MN             (V4L2_STD_PAL_M         |
+                     V4L2_STD_PAL_N         |
+                     V4L2_STD_PAL_Nc        |
+                     V4L2_STD_NTSC)
+    #define V4L2_STD_SECAM_DK       (V4L2_STD_SECAM_D       |
+                     V4L2_STD_SECAM_K       |
+                     V4L2_STD_SECAM_K1)
+    #define V4L2_STD_DK             (V4L2_STD_PAL_DK        |
+                     V4L2_STD_SECAM_DK)
+
+    #define V4L2_STD_SECAM          (V4L2_STD_SECAM_B       |
+                     V4L2_STD_SECAM_G       |
+                     V4L2_STD_SECAM_H       |
+                     V4L2_STD_SECAM_DK      |
+                     V4L2_STD_SECAM_L       |
+                     V4L2_STD_SECAM_LC)
+
+    #define V4L2_STD_525_60         (V4L2_STD_PAL_M         |
+                     V4L2_STD_PAL_60        |
+                     V4L2_STD_NTSC          |
+                     V4L2_STD_NTSC_443)
+    #define V4L2_STD_625_50         (V4L2_STD_PAL           |
+                     V4L2_STD_PAL_N         |
+                     V4L2_STD_PAL_Nc        |
+                     V4L2_STD_SECAM)
+
+    #define V4L2_STD_UNKNOWN        0
+    #define V4L2_STD_ALL            (V4L2_STD_525_60        |
+                     V4L2_STD_625_50)
+
+
+.. _video-standards:
+
+.. flat-table:: Video Standards (based on [])
+    :header-rows:  1
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  Characteristics
+
+       -  M/NTSC [2]_
+
+       -  M/PAL
+
+       -  N/PAL [3]_
+
+       -  B, B1, G/PAL
+
+       -  D, D1, K/PAL
+
+       -  H/PAL
+
+       -  I/PAL
+
+       -  B, G/SECAM
+
+       -  D, K/SECAM
+
+       -  K1/SECAM
+
+       -  L/SECAM
+
+    -  .. row 2
+
+       -  Frame lines
+
+       -  :cspan:`1` 525
+
+       -  :cspan:`9` 625
+
+    -  .. row 3
+
+       -  Frame period (s)
+
+       -  :cspan:`1` 1001/30000
+
+       -  :cspan:`9` 1/25
+
+    -  .. row 4
+
+       -  Chrominance sub-carrier frequency (Hz)
+
+       -  3579545 ± 10
+
+       -  3579611.49 ± 10
+
+       -  4433618.75 ± 5 (3582056.25 ± 5)
+
+       -  :cspan:`3` 4433618.75 ± 5
+
+       -  4433618.75 ± 1
+
+       -  :cspan:`3` f :sub:`OR` = 4406250 ± 2000, f :sub:`OB` = 4250000
+          ± 2000
+
+    -  .. row 5
+
+       -  Nominal radio-frequency channel bandwidth (MHz)
+
+       -  6
+
+       -  6
+
+       -  6
+
+       -  B: 7; B1, G: 8
+
+       -  8
+
+       -  8
+
+       -  8
+
+       -  8
+
+       -  8
+
+       -  8
+
+       -  8
+
+    -  .. row 6
+
+       -  Sound carrier relative to vision carrier (MHz)
+
+       -  + 4.5
+
+       -  + 4.5
+
+       -  + 4.5
+
+       -  + 5.5 ± 0.001  [4]_  [5]_  [6]_  [7]_
+
+       -  + 6.5 ± 0.001
+
+       -  + 5.5
+
+       -  + 5.9996 ± 0.0005
+
+       -  + 5.5 ± 0.001
+
+       -  + 6.5 ± 0.001
+
+       -  + 6.5
+
+       -  + 6.5  [8]_
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The struct :ref:`v4l2_standard <v4l2-standard>` ``index`` is out
+    of bounds.
+
+ENODATA
+    Standard video timings are not supported for this input or output.
+
+.. [1]
+   The supported standards may overlap and we need an unambiguous set to
+   find the current standard returned by ``VIDIOC_G_STD``.
+
+.. [2]
+   Japan uses a standard similar to M/NTSC (V4L2_STD_NTSC_M_JP).
+
+.. [3]
+   The values in brackets apply to the combination N/PAL a.k.a.
+   N :sub:`C` used in Argentina (V4L2_STD_PAL_Nc).
+
+.. [4]
+   In the Federal Republic of Germany, Austria, Italy, the Netherlands,
+   Slovakia and Switzerland a system of two sound carriers is used, the
+   frequency of the second carrier being 242.1875 kHz above the
+   frequency of the first sound carrier. For stereophonic sound
+   transmissions a similar system is used in Australia.
+
+.. [5]
+   New Zealand uses a sound carrier displaced 5.4996 ± 0.0005 MHz from
+   the vision carrier.
+
+.. [6]
+   In Denmark, Finland, New Zealand, Sweden and Spain a system of two
+   sound carriers is used. In Iceland, Norway and Poland the same system
+   is being introduced. The second carrier is 5.85 MHz above the vision
+   carrier and is DQPSK modulated with 728 kbit/s sound and data
+   multiplex. (NICAM system)
+
+.. [7]
+   In the United Kingdom, a system of two sound carriers is used. The
+   second sound carrier is 6.552 MHz above the vision carrier and is
+   DQPSK modulated with a 728 kbit/s sound and data multiplex able to
+   carry two sound channels. (NICAM system)
+
+.. [8]
+   In France, a digital carrier 5.85 MHz away from the vision carrier
+   may be used in addition to the main sound carrier. It is modulated in
+   differentially encoded QPSK with a 728 kbit/s sound and data
+   multiplexer capable of carrying two sound channels. (NICAM system)
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-expbuf.rst b/Documentation/linux_tv/media/v4l/vidioc-expbuf.rst
new file mode 100644
index 000000000000..0de48b945a01
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-expbuf.rst
@@ -0,0 +1,205 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-expbuf:
+
+*******************
+ioctl VIDIOC_EXPBUF
+*******************
+
+*man VIDIOC_EXPBUF(2)*
+
+Export a buffer as a DMABUF file descriptor.
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_exportbuffer *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_EXPBUF
+
+``argp``
+
+
+Description
+===========
+
+This ioctl is an extension to the :ref:`memory mapping <mmap>` I/O
+method, therefore it is available only for ``V4L2_MEMORY_MMAP`` buffers.
+It can be used to export a buffer as a DMABUF file at any time after
+buffers have been allocated with the
+:ref:`VIDIOC_REQBUFS <vidioc-reqbufs>` ioctl.
+
+To export a buffer, applications fill struct
+:ref:`v4l2_exportbuffer <v4l2-exportbuffer>`. The ``type`` field is
+set to the same buffer type as was previously used with struct
+:ref:`v4l2_requestbuffers <v4l2-requestbuffers>` ``type``.
+Applications must also set the ``index`` field. Valid index numbers
+range from zero to the number of buffers allocated with
+:ref:`VIDIOC_REQBUFS <vidioc-reqbufs>` (struct
+:ref:`v4l2_requestbuffers <v4l2-requestbuffers>` ``count``) minus
+one. For the multi-planar API, applications set the ``plane`` field to
+the index of the plane to be exported. Valid planes range from zero to
+the maximal number of valid planes for the currently active format. For
+the single-planar API, applications must set ``plane`` to zero.
+Additional flags may be posted in the ``flags`` field. Refer to a manual
+for open() for details. Currently only O_CLOEXEC, O_RDONLY, O_WRONLY,
+and O_RDWR are supported. All other fields must be set to zero. In the
+case of multi-planar API, every plane is exported separately using
+multiple ``VIDIOC_EXPBUF`` calls.
+
+After calling ``VIDIOC_EXPBUF`` the ``fd`` field will be set by a
+driver. This is a DMABUF file descriptor. The application may pass it to
+other DMABUF-aware devices. Refer to :ref:`DMABUF importing <dmabuf>`
+for details about importing DMABUF files into V4L2 nodes. It is
+recommended to close a DMABUF file when it is no longer used to allow
+the associated memory to be reclaimed.
+
+
+Examples
+========
+
+
+.. code-block:: c
+
+    int buffer_export(int v4lfd, enum v4l2_buf_type bt, int index, int *dmafd)
+    {
+        struct v4l2_exportbuffer expbuf;
+
+        memset(&expbuf, 0, sizeof(expbuf));
+        expbuf.type = bt;
+        expbuf.index = index;
+        if (ioctl(v4lfd, VIDIOC_EXPBUF, &expbuf) == -1) {
+            perror("VIDIOC_EXPBUF");
+            return -1;
+        }
+
+        *dmafd = expbuf.fd;
+
+        return 0;
+    }
+
+
+.. code-block:: c
+
+    int buffer_export_mp(int v4lfd, enum v4l2_buf_type bt, int index,
+        int dmafd[], int n_planes)
+    {
+        int i;
+
+        for (i = 0; i < n_planes; ++i) {
+            struct v4l2_exportbuffer expbuf;
+
+            memset(&expbuf, 0, sizeof(expbuf));
+            expbuf.type = bt;
+            expbuf.index = index;
+            expbuf.plane = i;
+            if (ioctl(v4lfd, VIDIOC_EXPBUF, &expbuf) == -1) {
+                perror("VIDIOC_EXPBUF");
+                while (i)
+                    close(dmafd[--i]);
+                return -1;
+            }
+            dmafd[i] = expbuf.fd;
+        }
+
+        return 0;
+    }
+
+
+.. _v4l2-exportbuffer:
+
+.. flat-table:: struct v4l2_exportbuffer
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``type``
+
+       -  Type of the buffer, same as struct
+          :ref:`v4l2_format <v4l2-format>` ``type`` or struct
+          :ref:`v4l2_requestbuffers <v4l2-requestbuffers>` ``type``, set
+          by the application. See :ref:`v4l2-buf-type`
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``index``
+
+       -  Number of the buffer, set by the application. This field is only
+          used for :ref:`memory mapping <mmap>` I/O and can range from
+          zero to the number of buffers allocated with the
+          :ref:`VIDIOC_REQBUFS <vidioc-reqbufs>` and/or
+          :ref:`VIDIOC_CREATE_BUFS <vidioc-create-bufs>` ioctls.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``plane``
+
+       -  Index of the plane to be exported when using the multi-planar API.
+          Otherwise this value must be set to zero.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``flags``
+
+       -  Flags for the newly created file, currently only ``O_CLOEXEC``,
+          ``O_RDONLY``, ``O_WRONLY``, and ``O_RDWR`` are supported, refer to
+          the manual of open() for more details.
+
+    -  .. row 5
+
+       -  __s32
+
+       -  ``fd``
+
+       -  The DMABUF file descriptor associated with a buffer. Set by the
+          driver.
+
+    -  .. row 6
+
+       -  __u32
+
+       -  ``reserved[11]``
+
+       -  Reserved field for future use. Drivers and applications must set
+          the array to zero.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    A queue is not in MMAP mode or DMABUF exporting is not supported or
+    ``flags`` or ``type`` or ``index`` or ``plane`` fields are invalid.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-audio.rst b/Documentation/linux_tv/media/v4l/vidioc-g-audio.rst
new file mode 100644
index 000000000000..05df90f084e8
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-g-audio.rst
@@ -0,0 +1,171 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-g-audio:
+
+************************************
+ioctl VIDIOC_G_AUDIO, VIDIOC_S_AUDIO
+************************************
+
+*man VIDIOC_G_AUDIO(2)*
+
+VIDIOC_S_AUDIO
+Query or select the current audio input and its attributes
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_audio *argp )
+
+.. c:function:: int ioctl( int fd, int request, const struct v4l2_audio *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_G_AUDIO, VIDIOC_S_AUDIO
+
+``argp``
+
+
+Description
+===========
+
+To query the current audio input applications zero out the ``reserved``
+array of a struct :ref:`v4l2_audio <v4l2-audio>` and call the
+``VIDIOC_G_AUDIO`` ioctl with a pointer to this structure. Drivers fill
+the rest of the structure or return an EINVAL error code when the device
+has no audio inputs, or none which combine with the current video input.
+
+Audio inputs have one writable property, the audio mode. To select the
+current audio input *and* change the audio mode, applications initialize
+the ``index`` and ``mode`` fields, and the ``reserved`` array of a
+:c:type:`struct v4l2_audio` structure and call the ``VIDIOC_S_AUDIO``
+ioctl. Drivers may switch to a different audio mode if the request
+cannot be satisfied. However, this is a write-only ioctl, it does not
+return the actual new audio mode.
+
+
+.. _v4l2-audio:
+
+.. flat-table:: struct v4l2_audio
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``index``
+
+       -  Identifies the audio input, set by the driver or application.
+
+    -  .. row 2
+
+       -  __u8
+
+       -  ``name``\ [32]
+
+       -  Name of the audio input, a NUL-terminated ASCII string, for
+          example: "Line In". This information is intended for the user,
+          preferably the connector label on the device itself.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``capability``
+
+       -  Audio capability flags, see :ref:`audio-capability`.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``mode``
+
+       -  Audio mode flags set by drivers and applications (on
+          ``VIDIOC_S_AUDIO`` ioctl), see :ref:`audio-mode`.
+
+    -  .. row 5
+
+       -  __u32
+
+       -  ``reserved``\ [2]
+
+       -  Reserved for future extensions. Drivers and applications must set
+          the array to zero.
+
+
+
+.. _audio-capability:
+
+.. flat-table:: Audio Capability Flags
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_AUDCAP_STEREO``
+
+       -  0x00001
+
+       -  This is a stereo input. The flag is intended to automatically
+          disable stereo recording etc. when the signal is always monaural.
+          The API provides no means to detect if stereo is *received*,
+          unless the audio input belongs to a tuner.
+
+    -  .. row 2
+
+       -  ``V4L2_AUDCAP_AVL``
+
+       -  0x00002
+
+       -  Automatic Volume Level mode is supported.
+
+
+
+.. _audio-mode:
+
+.. flat-table:: Audio Mode Flags
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_AUDMODE_AVL``
+
+       -  0x00001
+
+       -  AVL mode is on.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    No audio inputs combine with the current video input, or the number
+    of the selected audio input is out of bounds or it does not combine.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-audioout.rst b/Documentation/linux_tv/media/v4l/vidioc-g-audioout.rst
new file mode 100644
index 000000000000..ef4dce35992e
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-g-audioout.rst
@@ -0,0 +1,131 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-g-audioout:
+
+**************************************
+ioctl VIDIOC_G_AUDOUT, VIDIOC_S_AUDOUT
+**************************************
+
+*man VIDIOC_G_AUDOUT(2)*
+
+VIDIOC_S_AUDOUT
+Query or select the current audio output
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_audioout *argp )
+
+.. c:function:: int ioctl( int fd, int request, const struct v4l2_audioout *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_G_AUDOUT, VIDIOC_S_AUDOUT
+
+``argp``
+
+
+Description
+===========
+
+To query the current audio output applications zero out the ``reserved``
+array of a struct :ref:`v4l2_audioout <v4l2-audioout>` and call the
+``VIDIOC_G_AUDOUT`` ioctl with a pointer to this structure. Drivers fill
+the rest of the structure or return an EINVAL error code when the device
+has no audio inputs, or none which combine with the current video
+output.
+
+Audio outputs have no writable properties. Nevertheless, to select the
+current audio output applications can initialize the ``index`` field and
+``reserved`` array (which in the future may contain writable properties)
+of a :c:type:`struct v4l2_audioout` structure and call the
+``VIDIOC_S_AUDOUT`` ioctl. Drivers switch to the requested output or
+return the EINVAL error code when the index is out of bounds. This is a
+write-only ioctl, it does not return the current audio output attributes
+as ``VIDIOC_G_AUDOUT`` does.
+
+Note connectors on a TV card to loop back the received audio signal to a
+sound card are not audio outputs in this sense.
+
+
+.. _v4l2-audioout:
+
+.. flat-table:: struct v4l2_audioout
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``index``
+
+       -  Identifies the audio output, set by the driver or application.
+
+    -  .. row 2
+
+       -  __u8
+
+       -  ``name``\ [32]
+
+       -  Name of the audio output, a NUL-terminated ASCII string, for
+          example: "Line Out". This information is intended for the user,
+          preferably the connector label on the device itself.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``capability``
+
+       -  Audio capability flags, none defined yet. Drivers must set this
+          field to zero.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``mode``
+
+       -  Audio mode, none defined yet. Drivers and applications (on
+          ``VIDIOC_S_AUDOUT``) must set this field to zero.
+
+    -  .. row 5
+
+       -  __u32
+
+       -  ``reserved``\ [2]
+
+       -  Reserved for future extensions. Drivers and applications must set
+          the array to zero.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    No audio outputs combine with the current video output, or the
+    number of the selected audio output is out of bounds or it does not
+    combine.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-crop.rst b/Documentation/linux_tv/media/v4l/vidioc-g-crop.rst
new file mode 100644
index 000000000000..35f70134ac81
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-g-crop.rst
@@ -0,0 +1,122 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-g-crop:
+
+**********************************
+ioctl VIDIOC_G_CROP, VIDIOC_S_CROP
+**********************************
+
+*man VIDIOC_G_CROP(2)*
+
+VIDIOC_S_CROP
+Get or set the current cropping rectangle
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_crop *argp )
+
+.. c:function:: int ioctl( int fd, int request, const struct v4l2_crop *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_G_CROP, VIDIOC_S_CROP
+
+``argp``
+
+
+Description
+===========
+
+To query the cropping rectangle size and position applications set the
+``type`` field of a :c:type:`struct v4l2_crop` structure to the
+respective buffer (stream) type and call the ``VIDIOC_G_CROP`` ioctl
+with a pointer to this structure. The driver fills the rest of the
+structure or returns the EINVAL error code if cropping is not supported.
+
+To change the cropping rectangle applications initialize the ``type``
+and struct :ref:`v4l2_rect <v4l2-rect>` substructure named ``c`` of a
+v4l2_crop structure and call the ``VIDIOC_S_CROP`` ioctl with a pointer
+to this structure.
+
+Do not use the multiplanar buffer types. Use
+``V4L2_BUF_TYPE_VIDEO_CAPTURE`` instead of
+``V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE`` and use
+``V4L2_BUF_TYPE_VIDEO_OUTPUT`` instead of
+``V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE``.
+
+The driver first adjusts the requested dimensions against hardware
+limits, i. e. the bounds given by the capture/output window, and it
+rounds to the closest possible values of horizontal and vertical offset,
+width and height. In particular the driver must round the vertical
+offset of the cropping rectangle to frame lines modulo two, such that
+the field order cannot be confused.
+
+Second the driver adjusts the image size (the opposite rectangle of the
+scaling process, source or target depending on the data direction) to
+the closest size possible while maintaining the current horizontal and
+vertical scaling factor.
+
+Finally the driver programs the hardware with the actual cropping and
+image parameters. ``VIDIOC_S_CROP`` is a write-only ioctl, it does not
+return the actual parameters. To query them applications must call
+``VIDIOC_G_CROP`` and :ref:`VIDIOC_G_FMT <vidioc-g-fmt>`. When the
+parameters are unsuitable the application may modify the cropping or
+image parameters and repeat the cycle until satisfactory parameters have
+been negotiated.
+
+When cropping is not supported then no parameters are changed and
+``VIDIOC_S_CROP`` returns the EINVAL error code.
+
+
+.. _v4l2-crop:
+
+.. flat-table:: struct v4l2_crop
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``type``
+
+       -  Type of the data stream, set by the application. Only these types
+          are valid here: ``V4L2_BUF_TYPE_VIDEO_CAPTURE``,
+          ``V4L2_BUF_TYPE_VIDEO_OUTPUT`` and
+          ``V4L2_BUF_TYPE_VIDEO_OVERLAY``. See :ref:`v4l2-buf-type`.
+
+    -  .. row 2
+
+       -  struct :ref:`v4l2_rect <v4l2-rect>`
+
+       -  ``c``
+
+       -  Cropping rectangle. The same co-ordinate system as for struct
+          :ref:`v4l2_cropcap <v4l2-cropcap>` ``bounds`` is used.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-ctrl.rst b/Documentation/linux_tv/media/v4l/vidioc-g-ctrl.rst
new file mode 100644
index 000000000000..6381d7c13d58
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-g-ctrl.rst
@@ -0,0 +1,114 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-g-ctrl:
+
+**********************************
+ioctl VIDIOC_G_CTRL, VIDIOC_S_CTRL
+**********************************
+
+*man VIDIOC_G_CTRL(2)*
+
+VIDIOC_S_CTRL
+Get or set the value of a control
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_control *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_G_CTRL, VIDIOC_S_CTRL
+
+``argp``
+
+
+Description
+===========
+
+To get the current value of a control applications initialize the ``id``
+field of a struct :c:type:`struct v4l2_control` and call the
+``VIDIOC_G_CTRL`` ioctl with a pointer to this structure. To change the
+value of a control applications initialize the ``id`` and ``value``
+fields of a struct :c:type:`struct v4l2_control` and call the
+``VIDIOC_S_CTRL`` ioctl.
+
+When the ``id`` is invalid drivers return an EINVAL error code. When the
+``value`` is out of bounds drivers can choose to take the closest valid
+value or return an ERANGE error code, whatever seems more appropriate.
+However, ``VIDIOC_S_CTRL`` is a write-only ioctl, it does not return the
+actual new value. If the ``value`` is inappropriate for the control
+(e.g. if it refers to an unsupported menu index of a menu control), then
+EINVAL error code is returned as well.
+
+These ioctls work only with user controls. For other control classes the
+:ref:`VIDIOC_G_EXT_CTRLS <vidioc-g-ext-ctrls>`,
+:ref:`VIDIOC_S_EXT_CTRLS <vidioc-g-ext-ctrls>` or
+:ref:`VIDIOC_TRY_EXT_CTRLS <vidioc-g-ext-ctrls>` must be used.
+
+
+.. _v4l2-control:
+
+.. flat-table:: struct v4l2_control
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``id``
+
+       -  Identifies the control, set by the application.
+
+    -  .. row 2
+
+       -  __s32
+
+       -  ``value``
+
+       -  New value or current value.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The struct :ref:`v4l2_control <v4l2-control>` ``id`` is invalid
+    or the ``value`` is inappropriate for the given control (i.e. if a
+    menu item is selected that is not supported by the driver according
+    to :ref:`VIDIOC_QUERYMENU <vidioc-queryctrl>`).
+
+ERANGE
+    The struct :ref:`v4l2_control <v4l2-control>` ``value`` is out of
+    bounds.
+
+EBUSY
+    The control is temporarily not changeable, possibly because another
+    applications took over control of the device function this control
+    belongs to.
+
+EACCES
+    Attempt to set a read-only control or to get a write-only control.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-dv-timings.rst b/Documentation/linux_tv/media/v4l/vidioc-g-dv-timings.rst
new file mode 100644
index 000000000000..19598b10d425
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-g-dv-timings.rst
@@ -0,0 +1,429 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-g-dv-timings:
+
+**********************************************
+ioctl VIDIOC_G_DV_TIMINGS, VIDIOC_S_DV_TIMINGS
+**********************************************
+
+*man VIDIOC_G_DV_TIMINGS(2)*
+
+VIDIOC_S_DV_TIMINGS
+VIDIOC_SUBDEV_G_DV_TIMINGS
+VIDIOC_SUBDEV_S_DV_TIMINGS
+Get or set DV timings for input or output
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_dv_timings *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_G_DV_TIMINGS, VIDIOC_S_DV_TIMINGS,
+    VIDIOC_SUBDEV_G_DV_TIMINGS, VIDIOC_SUBDEV_S_DV_TIMINGS
+
+``argp``
+
+
+Description
+===========
+
+To set DV timings for the input or output, applications use the
+``VIDIOC_S_DV_TIMINGS`` ioctl and to get the current timings,
+applications use the ``VIDIOC_G_DV_TIMINGS`` ioctl. The detailed timing
+information is filled in using the structure struct
+:ref:`v4l2_dv_timings <v4l2-dv-timings>`. These ioctls take a
+pointer to the struct :ref:`v4l2_dv_timings <v4l2-dv-timings>`
+structure as argument. If the ioctl is not supported or the timing
+values are not correct, the driver returns EINVAL error code.
+
+The ``linux/v4l2-dv-timings.h`` header can be used to get the timings of
+the formats in the :ref:`cea861` and :ref:`vesadmt` standards. If
+the current input or output does not support DV timings (e.g. if
+:ref:`VIDIOC_ENUMINPUT <vidioc-enuminput>` does not set the
+``V4L2_IN_CAP_DV_TIMINGS`` flag), then ENODATA error code is returned.
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    This ioctl is not supported, or the ``VIDIOC_S_DV_TIMINGS``
+    parameter was unsuitable.
+
+ENODATA
+    Digital video timings are not supported for this input or output.
+
+EBUSY
+    The device is busy and therefore can not change the timings.
+
+
+.. _v4l2-bt-timings:
+
+.. flat-table:: struct v4l2_bt_timings
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``width``
+
+       -  Width of the active video in pixels.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``height``
+
+       -  Height of the active video frame in lines. So for interlaced
+          formats the height of the active video in each field is
+          ``height``/2.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``interlaced``
+
+       -  Progressive (0) or interlaced (1)
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``polarities``
+
+       -  This is a bit mask that defines polarities of sync signals. bit 0
+          (V4L2_DV_VSYNC_POS_POL) is for vertical sync polarity and bit
+          1 (V4L2_DV_HSYNC_POS_POL) is for horizontal sync polarity. If
+          the bit is set (1) it is positive polarity and if is cleared (0),
+          it is negative polarity.
+
+    -  .. row 5
+
+       -  __u64
+
+       -  ``pixelclock``
+
+       -  Pixel clock in Hz. Ex. 74.25MHz->74250000
+
+    -  .. row 6
+
+       -  __u32
+
+       -  ``hfrontporch``
+
+       -  Horizontal front porch in pixels
+
+    -  .. row 7
+
+       -  __u32
+
+       -  ``hsync``
+
+       -  Horizontal sync length in pixels
+
+    -  .. row 8
+
+       -  __u32
+
+       -  ``hbackporch``
+
+       -  Horizontal back porch in pixels
+
+    -  .. row 9
+
+       -  __u32
+
+       -  ``vfrontporch``
+
+       -  Vertical front porch in lines. For interlaced formats this refers
+          to the odd field (aka field 1).
+
+    -  .. row 10
+
+       -  __u32
+
+       -  ``vsync``
+
+       -  Vertical sync length in lines. For interlaced formats this refers
+          to the odd field (aka field 1).
+
+    -  .. row 11
+
+       -  __u32
+
+       -  ``vbackporch``
+
+       -  Vertical back porch in lines. For interlaced formats this refers
+          to the odd field (aka field 1).
+
+    -  .. row 12
+
+       -  __u32
+
+       -  ``il_vfrontporch``
+
+       -  Vertical front porch in lines for the even field (aka field 2) of
+          interlaced field formats. Must be 0 for progressive formats.
+
+    -  .. row 13
+
+       -  __u32
+
+       -  ``il_vsync``
+
+       -  Vertical sync length in lines for the even field (aka field 2) of
+          interlaced field formats. Must be 0 for progressive formats.
+
+    -  .. row 14
+
+       -  __u32
+
+       -  ``il_vbackporch``
+
+       -  Vertical back porch in lines for the even field (aka field 2) of
+          interlaced field formats. Must be 0 for progressive formats.
+
+    -  .. row 15
+
+       -  __u32
+
+       -  ``standards``
+
+       -  The video standard(s) this format belongs to. This will be filled
+          in by the driver. Applications must set this to 0. See
+          :ref:`dv-bt-standards` for a list of standards.
+
+    -  .. row 16
+
+       -  __u32
+
+       -  ``flags``
+
+       -  Several flags giving more information about the format. See
+          :ref:`dv-bt-flags` for a description of the flags.
+
+
+
+.. _v4l2-dv-timings:
+
+.. flat-table:: struct v4l2_dv_timings
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2 1
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``type``
+
+       -  
+       -  Type of DV timings as listed in :ref:`dv-timing-types`.
+
+    -  .. row 2
+
+       -  union
+
+       -  
+       -  
+
+    -  .. row 3
+
+       -  
+       -  struct :ref:`v4l2_bt_timings <v4l2-bt-timings>`
+
+       -  ``bt``
+
+       -  Timings defined by BT.656/1120 specifications
+
+    -  .. row 4
+
+       -  
+       -  __u32
+
+       -  ``reserved``\ [32]
+
+       -  
+
+
+
+.. _dv-timing-types:
+
+.. flat-table:: DV Timing types
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  Timing type
+
+       -  value
+
+       -  Description
+
+    -  .. row 2
+
+       -  
+       -  
+       -  
+
+    -  .. row 3
+
+       -  V4L2_DV_BT_656_1120
+
+       -  0
+
+       -  BT.656/1120 timings
+
+
+
+.. _dv-bt-standards:
+
+.. flat-table:: DV BT Timing standards
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  Timing standard
+
+       -  Description
+
+    -  .. row 2
+
+       -  
+       -  
+
+    -  .. row 3
+
+       -  V4L2_DV_BT_STD_CEA861
+
+       -  The timings follow the CEA-861 Digital TV Profile standard
+
+    -  .. row 4
+
+       -  V4L2_DV_BT_STD_DMT
+
+       -  The timings follow the VESA Discrete Monitor Timings standard
+
+    -  .. row 5
+
+       -  V4L2_DV_BT_STD_CVT
+
+       -  The timings follow the VESA Coordinated Video Timings standard
+
+    -  .. row 6
+
+       -  V4L2_DV_BT_STD_GTF
+
+       -  The timings follow the VESA Generalized Timings Formula standard
+
+
+
+.. _dv-bt-flags:
+
+.. flat-table:: DV BT Timing flags
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  Flag
+
+       -  Description
+
+    -  .. row 2
+
+       -  
+       -  
+
+    -  .. row 3
+
+       -  V4L2_DV_FL_REDUCED_BLANKING
+
+       -  CVT/GTF specific: the timings use reduced blanking (CVT) or the
+          'Secondary GTF' curve (GTF). In both cases the horizontal and/or
+          vertical blanking intervals are reduced, allowing a higher
+          resolution over the same bandwidth. This is a read-only flag,
+          applications must not set this.
+
+    -  .. row 4
+
+       -  V4L2_DV_FL_CAN_REDUCE_FPS
+
+       -  CEA-861 specific: set for CEA-861 formats with a framerate that is
+          a multiple of six. These formats can be optionally played at 1 /
+          1.001 speed to be compatible with 60 Hz based standards such as
+          NTSC and PAL-M that use a framerate of 29.97 frames per second. If
+          the transmitter can't generate such frequencies, then the flag
+          will also be cleared. This is a read-only flag, applications must
+          not set this.
+
+    -  .. row 5
+
+       -  V4L2_DV_FL_REDUCED_FPS
+
+       -  CEA-861 specific: only valid for video transmitters, the flag is
+          cleared by receivers. It is also only valid for formats with the
+          V4L2_DV_FL_CAN_REDUCE_FPS flag set, for other formats the
+          flag will be cleared by the driver. If the application sets this
+          flag, then the pixelclock used to set up the transmitter is
+          divided by 1.001 to make it compatible with NTSC framerates. If
+          the transmitter can't generate such frequencies, then the flag
+          will also be cleared.
+
+    -  .. row 6
+
+       -  V4L2_DV_FL_HALF_LINE
+
+       -  Specific to interlaced formats: if set, then the vertical
+          frontporch of field 1 (aka the odd field) is really one half-line
+          longer and the vertical backporch of field 2 (aka the even field)
+          is really one half-line shorter, so each field has exactly the
+          same number of half-lines. Whether half-lines can be detected or
+          used depends on the hardware.
+
+    -  .. row 7
+
+       -  V4L2_DV_FL_IS_CE_VIDEO
+
+       -  If set, then this is a Consumer Electronics (CE) video format.
+          Such formats differ from other formats (commonly called IT
+          formats) in that if R'G'B' encoding is used then by default the
+          R'G'B' values use limited range (i.e. 16-235) as opposed to full
+          range (i.e. 0-255). All formats defined in CEA-861 except for the
+          640x480p59.94 format are CE formats.
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-edid.rst b/Documentation/linux_tv/media/v4l/vidioc-g-edid.rst
new file mode 100644
index 000000000000..3138cfe7a26e
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-g-edid.rst
@@ -0,0 +1,171 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-g-edid:
+
+******************************************************************************
+ioctl VIDIOC_G_EDID, VIDIOC_S_EDID, VIDIOC_SUBDEV_G_EDID, VIDIOC_SUBDEV_S_EDID
+******************************************************************************
+
+*man VIDIOC_G_EDID(2)*
+
+VIDIOC_S_EDID
+VIDIOC_SUBDEV_G_EDID
+VIDIOC_SUBDEV_S_EDID
+Get or set the EDID of a video receiver/transmitter
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_edid *argp )
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_edid *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_G_EDID, VIDIOC_S_EDID, VIDIOC_SUBDEV_G_EDID,
+    VIDIOC_SUBDEV_S_EDID
+
+``argp``
+
+
+Description
+===========
+
+These ioctls can be used to get or set an EDID associated with an input
+from a receiver or an output of a transmitter device. They can be used
+with subdevice nodes (/dev/v4l-subdevX) or with video nodes
+(/dev/videoX).
+
+When used with video nodes the ``pad`` field represents the input (for
+video capture devices) or output (for video output devices) index as is
+returned by :ref:`VIDIOC_ENUMINPUT <vidioc-enuminput>` and
+:ref:`VIDIOC_ENUMOUTPUT <vidioc-enumoutput>` respectively. When used
+with subdevice nodes the ``pad`` field represents the input or output
+pad of the subdevice. If there is no EDID support for the given ``pad``
+value, then the EINVAL error code will be returned.
+
+To get the EDID data the application has to fill in the ``pad``,
+``start_block``, ``blocks`` and ``edid`` fields, zero the ``reserved``
+array and call ``VIDIOC_G_EDID``. The current EDID from block
+``start_block`` and of size ``blocks`` will be placed in the memory
+``edid`` points to. The ``edid`` pointer must point to memory at least
+``blocks`` * 128 bytes large (the size of one block is 128 bytes).
+
+If there are fewer blocks than specified, then the driver will set
+``blocks`` to the actual number of blocks. If there are no EDID blocks
+available at all, then the error code ENODATA is set.
+
+If blocks have to be retrieved from the sink, then this call will block
+until they have been read.
+
+If ``start_block`` and ``blocks`` are both set to 0 when
+``VIDIOC_G_EDID`` is called, then the driver will set ``blocks`` to the
+total number of available EDID blocks and it will return 0 without
+copying any data. This is an easy way to discover how many EDID blocks
+there are. Note that if there are no EDID blocks available at all, then
+the driver will set ``blocks`` to 0 and it returns 0.
+
+To set the EDID blocks of a receiver the application has to fill in the
+``pad``, ``blocks`` and ``edid`` fields, set ``start_block`` to 0 and
+zero the ``reserved`` array. It is not possible to set part of an EDID,
+it is always all or nothing. Setting the EDID data is only valid for
+receivers as it makes no sense for a transmitter.
+
+The driver assumes that the full EDID is passed in. If there are more
+EDID blocks than the hardware can handle then the EDID is not written,
+but instead the error code E2BIG is set and ``blocks`` is set to the
+maximum that the hardware supports. If ``start_block`` is any value
+other than 0 then the error code EINVAL is set.
+
+To disable an EDID you set ``blocks`` to 0. Depending on the hardware
+this will drive the hotplug pin low and/or block the source from reading
+the EDID data in some way. In any case, the end result is the same: the
+EDID is no longer available.
+
+
+.. _v4l2-edid:
+
+.. flat-table:: struct v4l2_edid
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``pad``
+
+       -  Pad for which to get/set the EDID blocks. When used with a video
+          device node the pad represents the input or output index as
+          returned by :ref:`VIDIOC_ENUMINPUT <vidioc-enuminput>` and
+          :ref:`VIDIOC_ENUMOUTPUT <vidioc-enumoutput>` respectively.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``start_block``
+
+       -  Read the EDID from starting with this block. Must be 0 when
+          setting the EDID.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``blocks``
+
+       -  The number of blocks to get or set. Must be less or equal to 256
+          (the maximum number of blocks as defined by the standard). When
+          you set the EDID and ``blocks`` is 0, then the EDID is disabled or
+          erased.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``reserved``\ [5]
+
+       -  Reserved for future extensions. Applications and drivers must set
+          the array to zero.
+
+    -  .. row 5
+
+       -  __u8 *
+
+       -  ``edid``
+
+       -  Pointer to memory that contains the EDID. The minimum size is
+          ``blocks`` * 128.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+ENODATA
+    The EDID data is not available.
+
+E2BIG
+    The EDID data you provided is more than the hardware can handle.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-enc-index.rst b/Documentation/linux_tv/media/v4l/vidioc-g-enc-index.rst
new file mode 100644
index 000000000000..5edf9cb46d15
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-g-enc-index.rst
@@ -0,0 +1,218 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-g-enc-index:
+
+************************
+ioctl VIDIOC_G_ENC_INDEX
+************************
+
+*man VIDIOC_G_ENC_INDEX(2)*
+
+Get meta data about a compressed video stream
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_enc_idx *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_G_ENC_INDEX
+
+``argp``
+
+
+Description
+===========
+
+The ``VIDIOC_G_ENC_INDEX`` ioctl provides meta data about a compressed
+video stream the same or another application currently reads from the
+driver, which is useful for random access into the stream without
+decoding it.
+
+To read the data applications must call ``VIDIOC_G_ENC_INDEX`` with a
+pointer to a struct :ref:`v4l2_enc_idx <v4l2-enc-idx>`. On success
+the driver fills the ``entry`` array, stores the number of elements
+written in the ``entries`` field, and initializes the ``entries_cap``
+field.
+
+Each element of the ``entry`` array contains meta data about one
+picture. A ``VIDIOC_G_ENC_INDEX`` call reads up to
+``V4L2_ENC_IDX_ENTRIES`` entries from a driver buffer, which can hold up
+to ``entries_cap`` entries. This number can be lower or higher than
+``V4L2_ENC_IDX_ENTRIES``, but not zero. When the application fails to
+read the meta data in time the oldest entries will be lost. When the
+buffer is empty or no capturing/encoding is in progress, ``entries``
+will be zero.
+
+Currently this ioctl is only defined for MPEG-2 program streams and
+video elementary streams.
+
+
+.. _v4l2-enc-idx:
+
+.. flat-table:: struct v4l2_enc_idx
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2 1 1
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``entries``
+
+       -  The number of entries the driver stored in the ``entry`` array.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``entries_cap``
+
+       -  The number of entries the driver can buffer. Must be greater than
+          zero.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``reserved``\ [4]
+
+       -  :cspan:`2` Reserved for future extensions. Drivers must set the
+          array to zero.
+
+    -  .. row 4
+
+       -  struct :ref:`v4l2_enc_idx_entry <v4l2-enc-idx-entry>`
+
+       -  ``entry``\ [``V4L2_ENC_IDX_ENTRIES``]
+
+       -  Meta data about a compressed video stream. Each element of the
+          array corresponds to one picture, sorted in ascending order by
+          their ``offset``.
+
+
+
+.. _v4l2-enc-idx-entry:
+
+.. flat-table:: struct v4l2_enc_idx_entry
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u64
+
+       -  ``offset``
+
+       -  The offset in bytes from the beginning of the compressed video
+          stream to the beginning of this picture, that is a *PES packet
+          header* as defined in :ref:`mpeg2part1` or a *picture header* as
+          defined in :ref:`mpeg2part2`. When the encoder is stopped, the
+          driver resets the offset to zero.
+
+    -  .. row 2
+
+       -  __u64
+
+       -  ``pts``
+
+       -  The 33 bit *Presentation Time Stamp* of this picture as defined in
+          :ref:`mpeg2part1`.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``length``
+
+       -  The length of this picture in bytes.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``flags``
+
+       -  Flags containing the coding type of this picture, see
+          :ref:`enc-idx-flags`.
+
+    -  .. row 5
+
+       -  __u32
+
+       -  ``reserved``\ [2]
+
+       -  Reserved for future extensions. Drivers must set the array to
+          zero.
+
+
+
+.. _enc-idx-flags:
+
+.. flat-table:: Index Entry Flags
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_ENC_IDX_FRAME_I``
+
+       -  0x00
+
+       -  This is an Intra-coded picture.
+
+    -  .. row 2
+
+       -  ``V4L2_ENC_IDX_FRAME_P``
+
+       -  0x01
+
+       -  This is a Predictive-coded picture.
+
+    -  .. row 3
+
+       -  ``V4L2_ENC_IDX_FRAME_B``
+
+       -  0x02
+
+       -  This is a Bidirectionally predictive-coded picture.
+
+    -  .. row 4
+
+       -  ``V4L2_ENC_IDX_FRAME_MASK``
+
+       -  0x0F
+
+       -  *AND* the flags field with this mask to obtain the picture coding
+          type.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-ext-ctrls.rst b/Documentation/linux_tv/media/v4l/vidioc-g-ext-ctrls.rst
new file mode 100644
index 000000000000..66dce741a3c0
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-g-ext-ctrls.rst
@@ -0,0 +1,498 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-g-ext-ctrls:
+
+******************************************************************
+ioctl VIDIOC_G_EXT_CTRLS, VIDIOC_S_EXT_CTRLS, VIDIOC_TRY_EXT_CTRLS
+******************************************************************
+
+*man VIDIOC_G_EXT_CTRLS(2)*
+
+VIDIOC_S_EXT_CTRLS
+VIDIOC_TRY_EXT_CTRLS
+Get or set the value of several controls, try control values
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_ext_controls *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_G_EXT_CTRLS, VIDIOC_S_EXT_CTRLS,
+    VIDIOC_TRY_EXT_CTRLS
+
+``argp``
+
+
+Description
+===========
+
+These ioctls allow the caller to get or set multiple controls
+atomically. Control IDs are grouped into control classes (see
+:ref:`ctrl-class`) and all controls in the control array must belong
+to the same control class.
+
+Applications must always fill in the ``count``, ``which``, ``controls``
+and ``reserved`` fields of struct
+:ref:`v4l2_ext_controls <v4l2-ext-controls>`, and initialize the
+struct :ref:`v4l2_ext_control <v4l2-ext-control>` array pointed to
+by the ``controls`` fields.
+
+To get the current value of a set of controls applications initialize
+the ``id``, ``size`` and ``reserved2`` fields of each struct
+:ref:`v4l2_ext_control <v4l2-ext-control>` and call the
+``VIDIOC_G_EXT_CTRLS`` ioctl. String controls controls must also set the
+``string`` field. Controls of compound types
+(``V4L2_CTRL_FLAG_HAS_PAYLOAD`` is set) must set the ``ptr`` field.
+
+If the ``size`` is too small to receive the control result (only
+relevant for pointer-type controls like strings), then the driver will
+set ``size`` to a valid value and return an ENOSPC error code. You
+should re-allocate the memory to this new size and try again. For the
+string type it is possible that the same issue occurs again if the
+string has grown in the meantime. It is recommended to call
+:ref:`VIDIOC_QUERYCTRL <vidioc-queryctrl>` first and use
+``maximum``\ +1 as the new ``size`` value. It is guaranteed that that is
+sufficient memory.
+
+N-dimensional arrays are set and retrieved row-by-row. You cannot set a
+partial array, all elements have to be set or retrieved. The total size
+is calculated as ``elems`` * ``elem_size``. These values can be obtained
+by calling :ref:`VIDIOC_QUERY_EXT_CTRL <vidioc-queryctrl>`.
+
+To change the value of a set of controls applications initialize the
+``id``, ``size``, ``reserved2`` and ``value/value64/string/ptr`` fields
+of each struct :ref:`v4l2_ext_control <v4l2-ext-control>` and call
+the ``VIDIOC_S_EXT_CTRLS`` ioctl. The controls will only be set if *all*
+control values are valid.
+
+To check if a set of controls have correct values applications
+initialize the ``id``, ``size``, ``reserved2`` and
+``value/value64/string/ptr`` fields of each struct
+:ref:`v4l2_ext_control <v4l2-ext-control>` and call the
+``VIDIOC_TRY_EXT_CTRLS`` ioctl. It is up to the driver whether wrong
+values are automatically adjusted to a valid value or if an error is
+returned.
+
+When the ``id`` or ``which`` is invalid drivers return an EINVAL error
+code. When the value is out of bounds drivers can choose to take the
+closest valid value or return an ERANGE error code, whatever seems more
+appropriate. In the first case the new value is set in struct
+:ref:`v4l2_ext_control <v4l2-ext-control>`. If the new control value
+is inappropriate (e.g. the given menu index is not supported by the menu
+control), then this will also result in an EINVAL error code error.
+
+The driver will only set/get these controls if all control values are
+correct. This prevents the situation where only some of the controls
+were set/get. Only low-level errors (e. g. a failed i2c command) can
+still cause this situation.
+
+
+.. _v4l2-ext-control:
+
+.. flat-table:: struct v4l2_ext_control
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``id``
+
+       -  
+       -  Identifies the control, set by the application.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``size``
+
+       -  
+       -  The total size in bytes of the payload of this control. This is
+          normally 0, but for pointer controls this should be set to the
+          size of the memory containing the payload, or that will receive
+          the payload. If ``VIDIOC_G_EXT_CTRLS`` finds that this value is
+          less than is required to store the payload result, then it is set
+          to a value large enough to store the payload result and ENOSPC is
+          returned. Note that for string controls this ``size`` field should
+          not be confused with the length of the string. This field refers
+          to the size of the memory that contains the string. The actual
+          *length* of the string may well be much smaller.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``reserved2``\ [1]
+
+       -  
+       -  Reserved for future extensions. Drivers and applications must set
+          the array to zero.
+
+    -  .. row 4
+
+       -  union
+
+       -  (anonymous)
+
+    -  .. row 5
+
+       -  
+       -  __s32
+
+       -  ``value``
+
+       -  New value or current value. Valid if this control is not of type
+          ``V4L2_CTRL_TYPE_INTEGER64`` and ``V4L2_CTRL_FLAG_HAS_PAYLOAD`` is
+          not set.
+
+    -  .. row 6
+
+       -  
+       -  __s64
+
+       -  ``value64``
+
+       -  New value or current value. Valid if this control is of type
+          ``V4L2_CTRL_TYPE_INTEGER64`` and ``V4L2_CTRL_FLAG_HAS_PAYLOAD`` is
+          not set.
+
+    -  .. row 7
+
+       -  
+       -  char *
+
+       -  ``string``
+
+       -  A pointer to a string. Valid if this control is of type
+          ``V4L2_CTRL_TYPE_STRING``.
+
+    -  .. row 8
+
+       -  
+       -  __u8 *
+
+       -  ``p_u8``
+
+       -  A pointer to a matrix control of unsigned 8-bit values. Valid if
+          this control is of type ``V4L2_CTRL_TYPE_U8``.
+
+    -  .. row 9
+
+       -  
+       -  __u16 *
+
+       -  ``p_u16``
+
+       -  A pointer to a matrix control of unsigned 16-bit values. Valid if
+          this control is of type ``V4L2_CTRL_TYPE_U16``.
+
+    -  .. row 10
+
+       -  
+       -  __u32 *
+
+       -  ``p_u32``
+
+       -  A pointer to a matrix control of unsigned 32-bit values. Valid if
+          this control is of type ``V4L2_CTRL_TYPE_U32``.
+
+    -  .. row 11
+
+       -  
+       -  void *
+
+       -  ``ptr``
+
+       -  A pointer to a compound type which can be an N-dimensional array
+          and/or a compound type (the control's type is >=
+          ``V4L2_CTRL_COMPOUND_TYPES``). Valid if
+          ``V4L2_CTRL_FLAG_HAS_PAYLOAD`` is set for this control.
+
+
+
+.. _v4l2-ext-controls:
+
+.. flat-table:: struct v4l2_ext_controls
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2 1
+
+
+    -  .. row 1
+
+       -  union
+
+       -  (anonymous)
+
+    -  .. row 2
+
+       -  
+       -  __u32
+
+       -  ``ctrl_class``
+
+       -  The control class to which all controls belong, see
+          :ref:`ctrl-class`. Drivers that use a kernel framework for
+          handling controls will also accept a value of 0 here, meaning that
+          the controls can belong to any control class. Whether drivers
+          support this can be tested by setting ``ctrl_class`` to 0 and
+          calling ``VIDIOC_TRY_EXT_CTRLS`` with a ``count`` of 0. If that
+          succeeds, then the driver supports this feature.
+
+    -  .. row 3
+
+       -  
+       -  __u32
+
+       -  ``which``
+
+       -  Which value of the control to get/set/try.
+          ``V4L2_CTRL_WHICH_CUR_VAL`` will return the current value of the
+          control and ``V4L2_CTRL_WHICH_DEF_VAL`` will return the default
+          value of the control. Please note that you can only get the
+          default value of the control, you cannot set or try it.
+
+          For backwards compatibility you can also use a control class here
+          (see :ref:`ctrl-class`). In that case all controls have to
+          belong to that control class. This usage is deprecated, instead
+          just use ``V4L2_CTRL_WHICH_CUR_VAL``. There are some very old
+          drivers that do not yet support ``V4L2_CTRL_WHICH_CUR_VAL`` and
+          that require a control class here. You can test for such drivers
+          by setting ctrl_class to ``V4L2_CTRL_WHICH_CUR_VAL`` and calling
+          VIDIOC_TRY_EXT_CTRLS with a count of 0. If that fails, then the
+          driver does not support ``V4L2_CTRL_WHICH_CUR_VAL``.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``count``
+
+       -  The number of controls in the controls array. May also be zero.
+
+    -  .. row 5
+
+       -  __u32
+
+       -  ``error_idx``
+
+       -  Set by the driver in case of an error. If the error is associated
+          with a particular control, then ``error_idx`` is set to the index
+          of that control. If the error is not related to a specific
+          control, or the validation step failed (see below), then
+          ``error_idx`` is set to ``count``. The value is undefined if the
+          ioctl returned 0 (success).
+
+          Before controls are read from/written to hardware a validation
+          step takes place: this checks if all controls in the list are
+          valid controls, if no attempt is made to write to a read-only
+          control or read from a write-only control, and any other up-front
+          checks that can be done without accessing the hardware. The exact
+          validations done during this step are driver dependent since some
+          checks might require hardware access for some devices, thus making
+          it impossible to do those checks up-front. However, drivers should
+          make a best-effort to do as many up-front checks as possible.
+
+          This check is done to avoid leaving the hardware in an
+          inconsistent state due to easy-to-avoid problems. But it leads to
+          another problem: the application needs to know whether an error
+          came from the validation step (meaning that the hardware was not
+          touched) or from an error during the actual reading from/writing
+          to hardware.
+
+          The, in hindsight quite poor, solution for that is to set
+          ``error_idx`` to ``count`` if the validation failed. This has the
+          unfortunate side-effect that it is not possible to see which
+          control failed the validation. If the validation was successful
+          and the error happened while accessing the hardware, then
+          ``error_idx`` is less than ``count`` and only the controls up to
+          ``error_idx-1`` were read or written correctly, and the state of
+          the remaining controls is undefined.
+
+          Since ``VIDIOC_TRY_EXT_CTRLS`` does not access hardware there is
+          also no need to handle the validation step in this special way, so
+          ``error_idx`` will just be set to the control that failed the
+          validation step instead of to ``count``. This means that if
+          ``VIDIOC_S_EXT_CTRLS`` fails with ``error_idx`` set to ``count``,
+          then you can call ``VIDIOC_TRY_EXT_CTRLS`` to try to discover the
+          actual control that failed the validation step. Unfortunately,
+          there is no ``TRY`` equivalent for ``VIDIOC_G_EXT_CTRLS``.
+
+    -  .. row 6
+
+       -  __u32
+
+       -  ``reserved``\ [2]
+
+       -  Reserved for future extensions. Drivers and applications must set
+          the array to zero.
+
+    -  .. row 7
+
+       -  struct :ref:`v4l2_ext_control <v4l2-ext-control>` *
+
+       -  ``controls``
+
+       -  Pointer to an array of ``count`` v4l2_ext_control structures.
+          Ignored if ``count`` equals zero.
+
+
+
+.. _ctrl-class:
+
+.. flat-table:: Control classes
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_CTRL_CLASS_USER``
+
+       -  0x980000
+
+       -  The class containing user controls. These controls are described
+          in :ref:`control`. All controls that can be set using the
+          :ref:`VIDIOC_S_CTRL <vidioc-g-ctrl>` and
+          :ref:`VIDIOC_G_CTRL <vidioc-g-ctrl>` ioctl belong to this
+          class.
+
+    -  .. row 2
+
+       -  ``V4L2_CTRL_CLASS_MPEG``
+
+       -  0x990000
+
+       -  The class containing MPEG compression controls. These controls are
+          described in :ref:`mpeg-controls`.
+
+    -  .. row 3
+
+       -  ``V4L2_CTRL_CLASS_CAMERA``
+
+       -  0x9a0000
+
+       -  The class containing camera controls. These controls are described
+          in :ref:`camera-controls`.
+
+    -  .. row 4
+
+       -  ``V4L2_CTRL_CLASS_FM_TX``
+
+       -  0x9b0000
+
+       -  The class containing FM Transmitter (FM TX) controls. These
+          controls are described in :ref:`fm-tx-controls`.
+
+    -  .. row 5
+
+       -  ``V4L2_CTRL_CLASS_FLASH``
+
+       -  0x9c0000
+
+       -  The class containing flash device controls. These controls are
+          described in :ref:`flash-controls`.
+
+    -  .. row 6
+
+       -  ``V4L2_CTRL_CLASS_JPEG``
+
+       -  0x9d0000
+
+       -  The class containing JPEG compression controls. These controls are
+          described in :ref:`jpeg-controls`.
+
+    -  .. row 7
+
+       -  ``V4L2_CTRL_CLASS_IMAGE_SOURCE``
+
+       -  0x9e0000
+
+       -  The class containing image source controls. These controls are
+          described in :ref:`image-source-controls`.
+
+    -  .. row 8
+
+       -  ``V4L2_CTRL_CLASS_IMAGE_PROC``
+
+       -  0x9f0000
+
+       -  The class containing image processing controls. These controls are
+          described in :ref:`image-process-controls`.
+
+    -  .. row 9
+
+       -  ``V4L2_CTRL_CLASS_FM_RX``
+
+       -  0xa10000
+
+       -  The class containing FM Receiver (FM RX) controls. These controls
+          are described in :ref:`fm-rx-controls`.
+
+    -  .. row 10
+
+       -  ``V4L2_CTRL_CLASS_RF_TUNER``
+
+       -  0xa20000
+
+       -  The class containing RF tuner controls. These controls are
+          described in :ref:`rf-tuner-controls`.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The struct :ref:`v4l2_ext_control <v4l2-ext-control>` ``id`` is
+    invalid, the struct :ref:`v4l2_ext_controls <v4l2-ext-controls>`
+    ``which`` is invalid, or the struct
+    :ref:`v4l2_ext_control <v4l2-ext-control>` ``value`` was
+    inappropriate (e.g. the given menu index is not supported by the
+    driver). This error code is also returned by the
+    ``VIDIOC_S_EXT_CTRLS`` and ``VIDIOC_TRY_EXT_CTRLS`` ioctls if two or
+    more control values are in conflict.
+
+ERANGE
+    The struct :ref:`v4l2_ext_control <v4l2-ext-control>` ``value``
+    is out of bounds.
+
+EBUSY
+    The control is temporarily not changeable, possibly because another
+    applications took over control of the device function this control
+    belongs to.
+
+ENOSPC
+    The space reserved for the control's payload is insufficient. The
+    field ``size`` is set to a value that is enough to store the payload
+    and this error code is returned.
+
+EACCES
+    Attempt to try or set a read-only control or to get a write-only
+    control.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-fbuf.rst b/Documentation/linux_tv/media/v4l/vidioc-g-fbuf.rst
new file mode 100644
index 000000000000..499881e92a28
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-g-fbuf.rst
@@ -0,0 +1,509 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-g-fbuf:
+
+**********************************
+ioctl VIDIOC_G_FBUF, VIDIOC_S_FBUF
+**********************************
+
+*man VIDIOC_G_FBUF(2)*
+
+VIDIOC_S_FBUF
+Get or set frame buffer overlay parameters
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_framebuffer *argp )
+
+.. c:function:: int ioctl( int fd, int request, const struct v4l2_framebuffer *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_G_FBUF, VIDIOC_S_FBUF
+
+``argp``
+
+
+Description
+===========
+
+Applications can use the ``VIDIOC_G_FBUF`` and ``VIDIOC_S_FBUF`` ioctl
+to get and set the framebuffer parameters for a
+:ref:`Video Overlay <overlay>` or :ref:`Video Output Overlay <osd>`
+(OSD). The type of overlay is implied by the device type (capture or
+output device) and can be determined with the
+:ref:`VIDIOC_QUERYCAP <vidioc-querycap>` ioctl. One ``/dev/videoN``
+device must not support both kinds of overlay.
+
+The V4L2 API distinguishes destructive and non-destructive overlays. A
+destructive overlay copies captured video images into the video memory
+of a graphics card. A non-destructive overlay blends video images into a
+VGA signal or graphics into a video signal. *Video Output Overlays* are
+always non-destructive.
+
+To get the current parameters applications call the ``VIDIOC_G_FBUF``
+ioctl with a pointer to a :c:type:`struct v4l2_framebuffer`
+structure. The driver fills all fields of the structure or returns an
+EINVAL error code when overlays are not supported.
+
+To set the parameters for a *Video Output Overlay*, applications must
+initialize the ``flags`` field of a struct
+:c:type:`struct v4l2_framebuffer`. Since the framebuffer is
+implemented on the TV card all other parameters are determined by the
+driver. When an application calls ``VIDIOC_S_FBUF`` with a pointer to
+this structure, the driver prepares for the overlay and returns the
+framebuffer parameters as ``VIDIOC_G_FBUF`` does, or it returns an error
+code.
+
+To set the parameters for a *non-destructive Video Overlay*,
+applications must initialize the ``flags`` field, the ``fmt``
+substructure, and call ``VIDIOC_S_FBUF``. Again the driver prepares for
+the overlay and returns the framebuffer parameters as ``VIDIOC_G_FBUF``
+does, or it returns an error code.
+
+For a *destructive Video Overlay* applications must additionally provide
+a ``base`` address. Setting up a DMA to a random memory location can
+jeopardize the system security, its stability or even damage the
+hardware, therefore only the superuser can set the parameters for a
+destructive video overlay.
+
+
+.. _v4l2-framebuffer:
+
+.. flat-table:: struct v4l2_framebuffer
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``capability``
+
+       -  
+       -  Overlay capability flags set by the driver, see
+          :ref:`framebuffer-cap`.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``flags``
+
+       -  
+       -  Overlay control flags set by application and driver, see
+          :ref:`framebuffer-flags`
+
+    -  .. row 3
+
+       -  void *
+
+       -  ``base``
+
+       -  
+       -  Physical base address of the framebuffer, that is the address of
+          the pixel in the top left corner of the framebuffer. [1]_
+
+    -  .. row 4
+
+       -  
+       -  
+       -  
+       -  This field is irrelevant to *non-destructive Video Overlays*. For
+          *destructive Video Overlays* applications must provide a base
+          address. The driver may accept only base addresses which are a
+          multiple of two, four or eight bytes. For *Video Output Overlays*
+          the driver must return a valid base address, so applications can
+          find the corresponding Linux framebuffer device (see
+          :ref:`osd`).
+
+    -  .. row 5
+
+       -  struct
+
+       -  ``fmt``
+
+       -  
+       -  Layout of the frame buffer.
+
+    -  .. row 6
+
+       -  
+       -  __u32
+
+       -  ``width``
+
+       -  Width of the frame buffer in pixels.
+
+    -  .. row 7
+
+       -  
+       -  __u32
+
+       -  ``height``
+
+       -  Height of the frame buffer in pixels.
+
+    -  .. row 8
+
+       -  
+       -  __u32
+
+       -  ``pixelformat``
+
+       -  The pixel format of the framebuffer.
+
+    -  .. row 9
+
+       -  
+       -  
+       -  
+       -  For *non-destructive Video Overlays* this field only defines a
+          format for the struct :ref:`v4l2_window <v4l2-window>`
+          ``chromakey`` field.
+
+    -  .. row 10
+
+       -  
+       -  
+       -  
+       -  For *destructive Video Overlays* applications must initialize this
+          field. For *Video Output Overlays* the driver must return a valid
+          format.
+
+    -  .. row 11
+
+       -  
+       -  
+       -  
+       -  Usually this is an RGB format (for example
+          :ref:`V4L2_PIX_FMT_RGB565 <V4L2-PIX-FMT-RGB565>`) but YUV
+          formats (only packed YUV formats when chroma keying is used, not
+          including ``V4L2_PIX_FMT_YUYV`` and ``V4L2_PIX_FMT_UYVY``) and the
+          ``V4L2_PIX_FMT_PAL8`` format are also permitted. The behavior of
+          the driver when an application requests a compressed format is
+          undefined. See :ref:`pixfmt` for information on pixel formats.
+
+    -  .. row 12
+
+       -  
+       -  enum :ref:`v4l2_field <v4l2-field>`
+
+       -  ``field``
+
+       -  Drivers and applications shall ignore this field. If applicable,
+          the field order is selected with the
+          :ref:`VIDIOC_S_FMT <vidioc-g-fmt>` ioctl, using the ``field``
+          field of struct :ref:`v4l2_window <v4l2-window>`.
+
+    -  .. row 13
+
+       -  
+       -  __u32
+
+       -  ``bytesperline``
+
+       -  Distance in bytes between the leftmost pixels in two adjacent
+          lines.
+
+    -  .. row 14
+
+       -  :cspan:`3`
+
+          This field is irrelevant to *non-destructive Video Overlays*.
+
+          For *destructive Video Overlays* both applications and drivers can
+          set this field to request padding bytes at the end of each line.
+          Drivers however may ignore the requested value, returning
+          ``width`` times bytes-per-pixel or a larger value required by the
+          hardware. That implies applications can just set this field to
+          zero to get a reasonable default.
+
+          For *Video Output Overlays* the driver must return a valid value.
+
+          Video hardware may access padding bytes, therefore they must
+          reside in accessible memory. Consider for example the case where
+          padding bytes after the last line of an image cross a system page
+          boundary. Capture devices may write padding bytes, the value is
+          undefined. Output devices ignore the contents of padding bytes.
+
+          When the image format is planar the ``bytesperline`` value applies
+          to the first plane and is divided by the same factor as the
+          ``width`` field for the other planes. For example the Cb and Cr
+          planes of a YUV 4:2:0 image have half as many padding bytes
+          following each line as the Y plane. To avoid ambiguities drivers
+          must return a ``bytesperline`` value rounded up to a multiple of
+          the scale factor.
+
+    -  .. row 15
+
+       -  
+       -  __u32
+
+       -  ``sizeimage``
+
+       -  This field is irrelevant to *non-destructive Video Overlays*. For
+          *destructive Video Overlays* applications must initialize this
+          field. For *Video Output Overlays* the driver must return a valid
+          format.
+
+          Together with ``base`` it defines the framebuffer memory
+          accessible by the driver.
+
+    -  .. row 16
+
+       -  
+       -  enum :ref:`v4l2_colorspace <v4l2-colorspace>`
+
+       -  ``colorspace``
+
+       -  This information supplements the ``pixelformat`` and must be set
+          by the driver, see :ref:`colorspaces`.
+
+    -  .. row 17
+
+       -  
+       -  __u32
+
+       -  ``priv``
+
+       -  Reserved. Drivers and applications must set this field to zero.
+
+
+
+.. _framebuffer-cap:
+
+.. flat-table:: Frame Buffer Capability Flags
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_FBUF_CAP_EXTERNOVERLAY``
+
+       -  0x0001
+
+       -  The device is capable of non-destructive overlays. When the driver
+          clears this flag, only destructive overlays are supported. There
+          are no drivers yet which support both destructive and
+          non-destructive overlays. Video Output Overlays are in practice
+          always non-destructive.
+
+    -  .. row 2
+
+       -  ``V4L2_FBUF_CAP_CHROMAKEY``
+
+       -  0x0002
+
+       -  The device supports clipping by chroma-keying the images. That is,
+          image pixels replace pixels in the VGA or video signal only where
+          the latter assume a certain color. Chroma-keying makes no sense
+          for destructive overlays.
+
+    -  .. row 3
+
+       -  ``V4L2_FBUF_CAP_LIST_CLIPPING``
+
+       -  0x0004
+
+       -  The device supports clipping using a list of clip rectangles.
+
+    -  .. row 4
+
+       -  ``V4L2_FBUF_CAP_BITMAP_CLIPPING``
+
+       -  0x0008
+
+       -  The device supports clipping using a bit mask.
+
+    -  .. row 5
+
+       -  ``V4L2_FBUF_CAP_LOCAL_ALPHA``
+
+       -  0x0010
+
+       -  The device supports clipping/blending using the alpha channel of
+          the framebuffer or VGA signal. Alpha blending makes no sense for
+          destructive overlays.
+
+    -  .. row 6
+
+       -  ``V4L2_FBUF_CAP_GLOBAL_ALPHA``
+
+       -  0x0020
+
+       -  The device supports alpha blending using a global alpha value.
+          Alpha blending makes no sense for destructive overlays.
+
+    -  .. row 7
+
+       -  ``V4L2_FBUF_CAP_LOCAL_INV_ALPHA``
+
+       -  0x0040
+
+       -  The device supports clipping/blending using the inverted alpha
+          channel of the framebuffer or VGA signal. Alpha blending makes no
+          sense for destructive overlays.
+
+    -  .. row 8
+
+       -  ``V4L2_FBUF_CAP_SRC_CHROMAKEY``
+
+       -  0x0080
+
+       -  The device supports Source Chroma-keying. Video pixels with the
+          chroma-key colors are replaced by framebuffer pixels, which is
+          exactly opposite of ``V4L2_FBUF_CAP_CHROMAKEY``
+
+
+
+.. _framebuffer-flags:
+
+.. flat-table:: Frame Buffer Flags
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_FBUF_FLAG_PRIMARY``
+
+       -  0x0001
+
+       -  The framebuffer is the primary graphics surface. In other words,
+          the overlay is destructive. This flag is typically set by any
+          driver that doesn't have the ``V4L2_FBUF_CAP_EXTERNOVERLAY``
+          capability and it is cleared otherwise.
+
+    -  .. row 2
+
+       -  ``V4L2_FBUF_FLAG_OVERLAY``
+
+       -  0x0002
+
+       -  If this flag is set for a video capture device, then the driver
+          will set the initial overlay size to cover the full framebuffer
+          size, otherwise the existing overlay size (as set by
+          :ref:`VIDIOC_S_FMT <vidioc-g-fmt>`) will be used. Only one
+          video capture driver (bttv) supports this flag. The use of this
+          flag for capture devices is deprecated. There is no way to detect
+          which drivers support this flag, so the only reliable method of
+          setting the overlay size is through
+          :ref:`VIDIOC_S_FMT <vidioc-g-fmt>`. If this flag is set for a
+          video output device, then the video output overlay window is
+          relative to the top-left corner of the framebuffer and restricted
+          to the size of the framebuffer. If it is cleared, then the video
+          output overlay window is relative to the video output display.
+
+    -  .. row 3
+
+       -  ``V4L2_FBUF_FLAG_CHROMAKEY``
+
+       -  0x0004
+
+       -  Use chroma-keying. The chroma-key color is determined by the
+          ``chromakey`` field of struct :ref:`v4l2_window <v4l2-window>`
+          and negotiated with the :ref:`VIDIOC_S_FMT <vidioc-g-fmt>`
+          ioctl, see :ref:`overlay` and :ref:`osd`.
+
+    -  .. row 4
+
+       -  :cspan:`2` There are no flags to enable clipping using a list of
+          clip rectangles or a bitmap. These methods are negotiated with the
+          :ref:`VIDIOC_S_FMT <vidioc-g-fmt>` ioctl, see :ref:`overlay`
+          and :ref:`osd`.
+
+    -  .. row 5
+
+       -  ``V4L2_FBUF_FLAG_LOCAL_ALPHA``
+
+       -  0x0008
+
+       -  Use the alpha channel of the framebuffer to clip or blend
+          framebuffer pixels with video images. The blend function is:
+          output = framebuffer pixel * alpha + video pixel * (1 - alpha).
+          The actual alpha depth depends on the framebuffer pixel format.
+
+    -  .. row 6
+
+       -  ``V4L2_FBUF_FLAG_GLOBAL_ALPHA``
+
+       -  0x0010
+
+       -  Use a global alpha value to blend the framebuffer with video
+          images. The blend function is: output = (framebuffer pixel * alpha
+          + video pixel * (255 - alpha)) / 255. The alpha value is
+          determined by the ``global_alpha`` field of struct
+          :ref:`v4l2_window <v4l2-window>` and negotiated with the
+          :ref:`VIDIOC_S_FMT <vidioc-g-fmt>` ioctl, see :ref:`overlay`
+          and :ref:`osd`.
+
+    -  .. row 7
+
+       -  ``V4L2_FBUF_FLAG_LOCAL_INV_ALPHA``
+
+       -  0x0020
+
+       -  Like ``V4L2_FBUF_FLAG_LOCAL_ALPHA``, use the alpha channel of the
+          framebuffer to clip or blend framebuffer pixels with video images,
+          but with an inverted alpha value. The blend function is: output =
+          framebuffer pixel * (1 - alpha) + video pixel * alpha. The actual
+          alpha depth depends on the framebuffer pixel format.
+
+    -  .. row 8
+
+       -  ``V4L2_FBUF_FLAG_SRC_CHROMAKEY``
+
+       -  0x0040
+
+       -  Use source chroma-keying. The source chroma-key color is
+          determined by the ``chromakey`` field of struct
+          :ref:`v4l2_window <v4l2-window>` and negotiated with the
+          :ref:`VIDIOC_S_FMT <vidioc-g-fmt>` ioctl, see :ref:`overlay`
+          and :ref:`osd`. Both chroma-keying are mutual exclusive to each
+          other, so same ``chromakey`` field of struct
+          :ref:`v4l2_window <v4l2-window>` is being used.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EPERM
+    ``VIDIOC_S_FBUF`` can only be called by a privileged user to
+    negotiate the parameters for a destructive overlay.
+
+EINVAL
+    The ``VIDIOC_S_FBUF`` parameters are unsuitable.
+
+.. [1]
+   A physical base address may not suit all platforms. GK notes in
+   theory we should pass something like PCI device + memory region +
+   offset instead. If you encounter problems please discuss on the
+   linux-media mailing list:
+   `https://linuxtv.org/lists.php <https://linuxtv.org/lists.php>`__.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-fmt.rst b/Documentation/linux_tv/media/v4l/vidioc-g-fmt.rst
new file mode 100644
index 000000000000..ed1daa32122b
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-g-fmt.rst
@@ -0,0 +1,198 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-g-fmt:
+
+************************************************
+ioctl VIDIOC_G_FMT, VIDIOC_S_FMT, VIDIOC_TRY_FMT
+************************************************
+
+*man VIDIOC_G_FMT(2)*
+
+VIDIOC_S_FMT
+VIDIOC_TRY_FMT
+Get or set the data format, try a format
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_format *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_G_FMT, VIDIOC_S_FMT, VIDIOC_TRY_FMT
+
+``argp``
+
+
+Description
+===========
+
+These ioctls are used to negotiate the format of data (typically image
+format) exchanged between driver and application.
+
+To query the current parameters applications set the ``type`` field of a
+struct :c:type:`struct v4l2_format` to the respective buffer (stream)
+type. For example video capture devices use
+``V4L2_BUF_TYPE_VIDEO_CAPTURE`` or
+``V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE``. When the application calls the
+``VIDIOC_G_FMT`` ioctl with a pointer to this structure the driver fills
+the respective member of the ``fmt`` union. In case of video capture
+devices that is either the struct
+:ref:`v4l2_pix_format <v4l2-pix-format>` ``pix`` or the struct
+:ref:`v4l2_pix_format_mplane <v4l2-pix-format-mplane>` ``pix_mp``
+member. When the requested buffer type is not supported drivers return
+an EINVAL error code.
+
+To change the current format parameters applications initialize the
+``type`` field and all fields of the respective ``fmt`` union member.
+For details see the documentation of the various devices types in
+:ref:`devices`. Good practice is to query the current parameters
+first, and to modify only those parameters not suitable for the
+application. When the application calls the ``VIDIOC_S_FMT`` ioctl with
+a pointer to a :c:type:`struct v4l2_format` structure the driver
+checks and adjusts the parameters against hardware abilities. Drivers
+should not return an error code unless the ``type`` field is invalid,
+this is a mechanism to fathom device capabilities and to approach
+parameters acceptable for both the application and driver. On success
+the driver may program the hardware, allocate resources and generally
+prepare for data exchange. Finally the ``VIDIOC_S_FMT`` ioctl returns
+the current format parameters as ``VIDIOC_G_FMT`` does. Very simple,
+inflexible devices may even ignore all input and always return the
+default parameters. However all V4L2 devices exchanging data with the
+application must implement the ``VIDIOC_G_FMT`` and ``VIDIOC_S_FMT``
+ioctl. When the requested buffer type is not supported drivers return an
+EINVAL error code on a ``VIDIOC_S_FMT`` attempt. When I/O is already in
+progress or the resource is not available for other reasons drivers
+return the EBUSY error code.
+
+The ``VIDIOC_TRY_FMT`` ioctl is equivalent to ``VIDIOC_S_FMT`` with one
+exception: it does not change driver state. It can also be called at any
+time, never returning EBUSY. This function is provided to negotiate
+parameters, to learn about hardware limitations, without disabling I/O
+or possibly time consuming hardware preparations. Although strongly
+recommended drivers are not required to implement this ioctl.
+
+The format as returned by ``VIDIOC_TRY_FMT`` must be identical to what
+``VIDIOC_S_FMT`` returns for the same input or output.
+
+
+.. _v4l2-format:
+
+.. flat-table:: struct v4l2_format
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``type``
+
+       -  
+       -  Type of the data stream, see :ref:`v4l2-buf-type`.
+
+    -  .. row 2
+
+       -  union
+
+       -  ``fmt``
+
+    -  .. row 3
+
+       -  
+       -  struct :ref:`v4l2_pix_format <v4l2-pix-format>`
+
+       -  ``pix``
+
+       -  Definition of an image format, see :ref:`pixfmt`, used by video
+          capture and output devices.
+
+    -  .. row 4
+
+       -  
+       -  struct :ref:`v4l2_pix_format_mplane <v4l2-pix-format-mplane>`
+
+       -  ``pix_mp``
+
+       -  Definition of an image format, see :ref:`pixfmt`, used by video
+          capture and output devices that support the
+          :ref:`multi-planar version of the API <planar-apis>`.
+
+    -  .. row 5
+
+       -  
+       -  struct :ref:`v4l2_window <v4l2-window>`
+
+       -  ``win``
+
+       -  Definition of an overlaid image, see :ref:`overlay`, used by
+          video overlay devices.
+
+    -  .. row 6
+
+       -  
+       -  struct :ref:`v4l2_vbi_format <v4l2-vbi-format>`
+
+       -  ``vbi``
+
+       -  Raw VBI capture or output parameters. This is discussed in more
+          detail in :ref:`raw-vbi`. Used by raw VBI capture and output
+          devices.
+
+    -  .. row 7
+
+       -  
+       -  struct :ref:`v4l2_sliced_vbi_format <v4l2-sliced-vbi-format>`
+
+       -  ``sliced``
+
+       -  Sliced VBI capture or output parameters. See :ref:`sliced` for
+          details. Used by sliced VBI capture and output devices.
+
+    -  .. row 8
+
+       -  
+       -  struct :ref:`v4l2_sdr_format <v4l2-sdr-format>`
+
+       -  ``sdr``
+
+       -  Definition of a data format, see :ref:`pixfmt`, used by SDR
+          capture and output devices.
+
+    -  .. row 9
+
+       -  
+       -  __u8
+
+       -  ``raw_data``\ [200]
+
+       -  Place holder for future extensions.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The struct :ref:`v4l2_format <v4l2-format>` ``type`` field is
+    invalid or the requested buffer type not supported.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-frequency.rst b/Documentation/linux_tv/media/v4l/vidioc-g-frequency.rst
new file mode 100644
index 000000000000..1d9f0fe86fb0
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-g-frequency.rst
@@ -0,0 +1,132 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-g-frequency:
+
+********************************************
+ioctl VIDIOC_G_FREQUENCY, VIDIOC_S_FREQUENCY
+********************************************
+
+*man VIDIOC_G_FREQUENCY(2)*
+
+VIDIOC_S_FREQUENCY
+Get or set tuner or modulator radio frequency
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_frequency *argp )
+
+.. c:function:: int ioctl( int fd, int request, const struct v4l2_frequency *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_G_FREQUENCY, VIDIOC_S_FREQUENCY
+
+``argp``
+
+
+Description
+===========
+
+To get the current tuner or modulator radio frequency applications set
+the ``tuner`` field of a struct
+:ref:`v4l2_frequency <v4l2-frequency>` to the respective tuner or
+modulator number (only input devices have tuners, only output devices
+have modulators), zero out the ``reserved`` array and call the
+``VIDIOC_G_FREQUENCY`` ioctl with a pointer to this structure. The
+driver stores the current frequency in the ``frequency`` field.
+
+To change the current tuner or modulator radio frequency applications
+initialize the ``tuner``, ``type`` and ``frequency`` fields, and the
+``reserved`` array of a struct :ref:`v4l2_frequency <v4l2-frequency>`
+and call the ``VIDIOC_S_FREQUENCY`` ioctl with a pointer to this
+structure. When the requested frequency is not possible the driver
+assumes the closest possible value. However ``VIDIOC_S_FREQUENCY`` is a
+write-only ioctl, it does not return the actual new frequency.
+
+
+.. _v4l2-frequency:
+
+.. flat-table:: struct v4l2_frequency
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``tuner``
+
+       -  The tuner or modulator index number. This is the same value as in
+          the struct :ref:`v4l2_input <v4l2-input>` ``tuner`` field and
+          the struct :ref:`v4l2_tuner <v4l2-tuner>` ``index`` field, or
+          the struct :ref:`v4l2_output <v4l2-output>` ``modulator`` field
+          and the struct :ref:`v4l2_modulator <v4l2-modulator>` ``index``
+          field.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``type``
+
+       -  The tuner type. This is the same value as in the struct
+          :ref:`v4l2_tuner <v4l2-tuner>` ``type`` field. The type must be
+          set to ``V4L2_TUNER_RADIO`` for ``/dev/radioX`` device nodes, and
+          to ``V4L2_TUNER_ANALOG_TV`` for all others. Set this field to
+          ``V4L2_TUNER_RADIO`` for modulators (currently only radio
+          modulators are supported). See :ref:`v4l2-tuner-type`
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``frequency``
+
+       -  Tuning frequency in units of 62.5 kHz, or if the struct
+          :ref:`v4l2_tuner <v4l2-tuner>` or struct
+          :ref:`v4l2_modulator <v4l2-modulator>` ``capability`` flag
+          ``V4L2_TUNER_CAP_LOW`` is set, in units of 62.5 Hz. A 1 Hz unit is
+          used when the ``capability`` flag ``V4L2_TUNER_CAP_1HZ`` is set.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``reserved``\ [8]
+
+       -  Reserved for future extensions. Drivers and applications must set
+          the array to zero.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The ``tuner`` index is out of bounds or the value in the ``type``
+    field is wrong.
+
+EBUSY
+    A hardware seek is in progress.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-input.rst b/Documentation/linux_tv/media/v4l/vidioc-g-input.rst
new file mode 100644
index 000000000000..fffba83242ed
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-g-input.rst
@@ -0,0 +1,70 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-g-input:
+
+************************************
+ioctl VIDIOC_G_INPUT, VIDIOC_S_INPUT
+************************************
+
+*man VIDIOC_G_INPUT(2)*
+
+VIDIOC_S_INPUT
+Query or select the current video input
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, int *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_G_INPUT, VIDIOC_S_INPUT
+
+``argp``
+
+
+Description
+===========
+
+To query the current video input applications call the
+``VIDIOC_G_INPUT`` ioctl with a pointer to an integer where the driver
+stores the number of the input, as in the struct
+:ref:`v4l2_input <v4l2-input>` ``index`` field. This ioctl will fail
+only when there are no video inputs, returning EINVAL.
+
+To select a video input applications store the number of the desired
+input in an integer and call the ``VIDIOC_S_INPUT`` ioctl with a pointer
+to this integer. Side effects are possible. For example inputs may
+support different video standards, so the driver may implicitly switch
+the current standard. Because of these possible side effects
+applications must select an input before querying or negotiating any
+other parameters.
+
+Information about video inputs is available using the
+:ref:`VIDIOC_ENUMINPUT <vidioc-enuminput>` ioctl.
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The number of the video input is out of bounds.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-jpegcomp.rst b/Documentation/linux_tv/media/v4l/vidioc-g-jpegcomp.rst
new file mode 100644
index 000000000000..05d4ebf221e2
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-g-jpegcomp.rst
@@ -0,0 +1,191 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-g-jpegcomp:
+
+******************************************
+ioctl VIDIOC_G_JPEGCOMP, VIDIOC_S_JPEGCOMP
+******************************************
+
+*man VIDIOC_G_JPEGCOMP(2)*
+
+VIDIOC_S_JPEGCOMP
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, v4l2_jpegcompression *argp )
+
+.. c:function:: int ioctl( int fd, int request, const v4l2_jpegcompression *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_G_JPEGCOMP, VIDIOC_S_JPEGCOMP
+
+``argp``
+
+
+Description
+===========
+
+These ioctls are **deprecated**. New drivers and applications should use
+:ref:`JPEG class controls <jpeg-controls>` for image quality and JPEG
+markers control.
+
+[to do]
+
+Ronald Bultje elaborates:
+
+APP is some application-specific information. The application can set it
+itself, and it'll be stored in the JPEG-encoded fields (eg; interlacing
+information for in an AVI or so). COM is the same, but it's comments,
+like 'encoded by me' or so.
+
+jpeg_markers describes whether the huffman tables, quantization tables
+and the restart interval information (all JPEG-specific stuff) should be
+stored in the JPEG-encoded fields. These define how the JPEG field is
+encoded. If you omit them, applications assume you've used standard
+encoding. You usually do want to add them.
+
+
+.. _v4l2-jpegcompression:
+
+.. flat-table:: struct v4l2_jpegcompression
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  int
+
+       -  ``quality``
+
+       -  Deprecated. If
+          :ref:`V4L2_CID_JPEG_COMPRESSION_QUALITY <jpeg-quality-control>`
+          control is exposed by a driver applications should use it instead
+          and ignore this field.
+
+    -  .. row 2
+
+       -  int
+
+       -  ``APPn``
+
+       -  
+
+    -  .. row 3
+
+       -  int
+
+       -  ``APP_len``
+
+       -  
+
+    -  .. row 4
+
+       -  char
+
+       -  ``APP_data``\ [60]
+
+       -  
+
+    -  .. row 5
+
+       -  int
+
+       -  ``COM_len``
+
+       -  
+
+    -  .. row 6
+
+       -  char
+
+       -  ``COM_data``\ [60]
+
+       -  
+
+    -  .. row 7
+
+       -  __u32
+
+       -  ``jpeg_markers``
+
+       -  See :ref:`jpeg-markers`. Deprecated. If
+          :ref:`V4L2_CID_JPEG_ACTIVE_MARKER <jpeg-active-marker-control>`
+          control is exposed by a driver applications should use it instead
+          and ignore this field.
+
+
+
+.. _jpeg-markers:
+
+.. flat-table:: JPEG Markers Flags
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_JPEG_MARKER_DHT``
+
+       -  (1<<3)
+
+       -  Define Huffman Tables
+
+    -  .. row 2
+
+       -  ``V4L2_JPEG_MARKER_DQT``
+
+       -  (1<<4)
+
+       -  Define Quantization Tables
+
+    -  .. row 3
+
+       -  ``V4L2_JPEG_MARKER_DRI``
+
+       -  (1<<5)
+
+       -  Define Restart Interval
+
+    -  .. row 4
+
+       -  ``V4L2_JPEG_MARKER_COM``
+
+       -  (1<<6)
+
+       -  Comment segment
+
+    -  .. row 5
+
+       -  ``V4L2_JPEG_MARKER_APP``
+
+       -  (1<<7)
+
+       -  App segment, driver will always use APP0
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-modulator.rst b/Documentation/linux_tv/media/v4l/vidioc-g-modulator.rst
new file mode 100644
index 000000000000..3a8ae0a5891a
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-g-modulator.rst
@@ -0,0 +1,264 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-g-modulator:
+
+********************************************
+ioctl VIDIOC_G_MODULATOR, VIDIOC_S_MODULATOR
+********************************************
+
+*man VIDIOC_G_MODULATOR(2)*
+
+VIDIOC_S_MODULATOR
+Get or set modulator attributes
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_modulator *argp )
+
+.. c:function:: int ioctl( int fd, int request, const struct v4l2_modulator *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_G_MODULATOR, VIDIOC_S_MODULATOR
+
+``argp``
+
+
+Description
+===========
+
+To query the attributes of a modulator applications initialize the
+``index`` field and zero out the ``reserved`` array of a struct
+:ref:`v4l2_modulator <v4l2-modulator>` and call the
+``VIDIOC_G_MODULATOR`` ioctl with a pointer to this structure. Drivers
+fill the rest of the structure or return an EINVAL error code when the
+index is out of bounds. To enumerate all modulators applications shall
+begin at index zero, incrementing by one until the driver returns
+EINVAL.
+
+Modulators have two writable properties, an audio modulation set and the
+radio frequency. To change the modulated audio subprograms, applications
+initialize the ``index`` and ``txsubchans`` fields and the ``reserved``
+array and call the ``VIDIOC_S_MODULATOR`` ioctl. Drivers may choose a
+different audio modulation if the request cannot be satisfied. However
+this is a write-only ioctl, it does not return the actual audio
+modulation selected.
+
+:ref:`SDR <sdr>` specific modulator types are ``V4L2_TUNER_SDR`` and
+``V4L2_TUNER_RF``. For SDR devices ``txsubchans`` field must be
+initialized to zero. The term 'modulator' means SDR transmitter in this
+context.
+
+To change the radio frequency the
+:ref:`VIDIOC_S_FREQUENCY <vidioc-g-frequency>` ioctl is available.
+
+
+.. _v4l2-modulator:
+
+.. flat-table:: struct v4l2_modulator
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2 1 1
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``index``
+
+       -  Identifies the modulator, set by the application.
+
+    -  .. row 2
+
+       -  __u8
+
+       -  ``name``\ [32]
+
+       -  Name of the modulator, a NUL-terminated ASCII string. This
+          information is intended for the user.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``capability``
+
+       -  Modulator capability flags. No flags are defined for this field,
+          the tuner flags in struct :ref:`v4l2_tuner <v4l2-tuner>` are
+          used accordingly. The audio flags indicate the ability to encode
+          audio subprograms. They will *not* change for example with the
+          current video standard.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``rangelow``
+
+       -  The lowest tunable frequency in units of 62.5 KHz, or if the
+          ``capability`` flag ``V4L2_TUNER_CAP_LOW`` is set, in units of
+          62.5 Hz, or if the ``capability`` flag ``V4L2_TUNER_CAP_1HZ`` is
+          set, in units of 1 Hz.
+
+    -  .. row 5
+
+       -  __u32
+
+       -  ``rangehigh``
+
+       -  The highest tunable frequency in units of 62.5 KHz, or if the
+          ``capability`` flag ``V4L2_TUNER_CAP_LOW`` is set, in units of
+          62.5 Hz, or if the ``capability`` flag ``V4L2_TUNER_CAP_1HZ`` is
+          set, in units of 1 Hz.
+
+    -  .. row 6
+
+       -  __u32
+
+       -  ``txsubchans``
+
+       -  With this field applications can determine how audio sub-carriers
+          shall be modulated. It contains a set of flags as defined in
+          :ref:`modulator-txsubchans`. Note the tuner ``rxsubchans`` flags
+          are reused, but the semantics are different. Video output devices
+          are assumed to have an analog or PCM audio input with 1-3
+          channels. The ``txsubchans`` flags select one or more channels for
+          modulation, together with some audio subprogram indicator, for
+          example a stereo pilot tone.
+
+    -  .. row 7
+
+       -  __u32
+
+       -  ``type``
+
+       -  :cspan:`2` Type of the modulator, see :ref:`v4l2-tuner-type`.
+
+    -  .. row 8
+
+       -  __u32
+
+       -  ``reserved``\ [3]
+
+       -  Reserved for future extensions. Drivers and applications must set
+          the array to zero.
+
+
+
+.. _modulator-txsubchans:
+
+.. flat-table:: Modulator Audio Transmission Flags
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_TUNER_SUB_MONO``
+
+       -  0x0001
+
+       -  Modulate channel 1 as mono audio, when the input has more
+          channels, a down-mix of channel 1 and 2. This flag does not
+          combine with ``V4L2_TUNER_SUB_STEREO`` or
+          ``V4L2_TUNER_SUB_LANG1``.
+
+    -  .. row 2
+
+       -  ``V4L2_TUNER_SUB_STEREO``
+
+       -  0x0002
+
+       -  Modulate channel 1 and 2 as left and right channel of a stereo
+          audio signal. When the input has only one channel or two channels
+          and ``V4L2_TUNER_SUB_SAP`` is also set, channel 1 is encoded as
+          left and right channel. This flag does not combine with
+          ``V4L2_TUNER_SUB_MONO`` or ``V4L2_TUNER_SUB_LANG1``. When the
+          driver does not support stereo audio it shall fall back to mono.
+
+    -  .. row 3
+
+       -  ``V4L2_TUNER_SUB_LANG1``
+
+       -  0x0008
+
+       -  Modulate channel 1 and 2 as primary and secondary language of a
+          bilingual audio signal. When the input has only one channel it is
+          used for both languages. It is not possible to encode the primary
+          or secondary language only. This flag does not combine with
+          ``V4L2_TUNER_SUB_MONO``, ``V4L2_TUNER_SUB_STEREO`` or
+          ``V4L2_TUNER_SUB_SAP``. If the hardware does not support the
+          respective audio matrix, or the current video standard does not
+          permit bilingual audio the ``VIDIOC_S_MODULATOR`` ioctl shall
+          return an EINVAL error code and the driver shall fall back to mono
+          or stereo mode.
+
+    -  .. row 4
+
+       -  ``V4L2_TUNER_SUB_LANG2``
+
+       -  0x0004
+
+       -  Same effect as ``V4L2_TUNER_SUB_SAP``.
+
+    -  .. row 5
+
+       -  ``V4L2_TUNER_SUB_SAP``
+
+       -  0x0004
+
+       -  When combined with ``V4L2_TUNER_SUB_MONO`` the first channel is
+          encoded as mono audio, the last channel as Second Audio Program.
+          When the input has only one channel it is used for both audio
+          tracks. When the input has three channels the mono track is a
+          down-mix of channel 1 and 2. When combined with
+          ``V4L2_TUNER_SUB_STEREO`` channel 1 and 2 are encoded as left and
+          right stereo audio, channel 3 as Second Audio Program. When the
+          input has only two channels, the first is encoded as left and
+          right channel and the second as SAP. When the input has only one
+          channel it is used for all audio tracks. It is not possible to
+          encode a Second Audio Program only. This flag must combine with
+          ``V4L2_TUNER_SUB_MONO`` or ``V4L2_TUNER_SUB_STEREO``. If the
+          hardware does not support the respective audio matrix, or the
+          current video standard does not permit SAP the
+          ``VIDIOC_S_MODULATOR`` ioctl shall return an EINVAL error code and
+          driver shall fall back to mono or stereo mode.
+
+    -  .. row 6
+
+       -  ``V4L2_TUNER_SUB_RDS``
+
+       -  0x0010
+
+       -  Enable the RDS encoder for a radio FM transmitter.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The struct :ref:`v4l2_modulator <v4l2-modulator>` ``index`` is
+    out of bounds.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-output.rst b/Documentation/linux_tv/media/v4l/vidioc-g-output.rst
new file mode 100644
index 000000000000..8341f1f8a45c
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-g-output.rst
@@ -0,0 +1,72 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-g-output:
+
+**************************************
+ioctl VIDIOC_G_OUTPUT, VIDIOC_S_OUTPUT
+**************************************
+
+*man VIDIOC_G_OUTPUT(2)*
+
+VIDIOC_S_OUTPUT
+Query or select the current video output
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, int *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_G_OUTPUT, VIDIOC_S_OUTPUT
+
+``argp``
+
+
+Description
+===========
+
+To query the current video output applications call the
+``VIDIOC_G_OUTPUT`` ioctl with a pointer to an integer where the driver
+stores the number of the output, as in the struct
+:ref:`v4l2_output <v4l2-output>` ``index`` field. This ioctl will
+fail only when there are no video outputs, returning the EINVAL error
+code.
+
+To select a video output applications store the number of the desired
+output in an integer and call the ``VIDIOC_S_OUTPUT`` ioctl with a
+pointer to this integer. Side effects are possible. For example outputs
+may support different video standards, so the driver may implicitly
+switch the current standard. standard. Because of these possible side
+effects applications must select an output before querying or
+negotiating any other parameters.
+
+Information about video outputs is available using the
+:ref:`VIDIOC_ENUMOUTPUT <vidioc-enumoutput>` ioctl.
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The number of the video output is out of bounds, or there are no
+    video outputs at all.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-parm.rst b/Documentation/linux_tv/media/v4l/vidioc-g-parm.rst
new file mode 100644
index 000000000000..2892653b5bc4
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-g-parm.rst
@@ -0,0 +1,358 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-g-parm:
+
+**********************************
+ioctl VIDIOC_G_PARM, VIDIOC_S_PARM
+**********************************
+
+*man VIDIOC_G_PARM(2)*
+
+VIDIOC_S_PARM
+Get or set streaming parameters
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, v4l2_streamparm *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_G_PARM, VIDIOC_S_PARM
+
+``argp``
+
+
+Description
+===========
+
+The current video standard determines a nominal number of frames per
+second. If less than this number of frames is to be captured or output,
+applications can request frame skipping or duplicating on the driver
+side. This is especially useful when using the :c:func:`read()` or
+:c:func:`write()`, which are not augmented by timestamps or sequence
+counters, and to avoid unnecessary data copying.
+
+Further these ioctls can be used to determine the number of buffers used
+internally by a driver in read/write mode. For implications see the
+section discussing the :ref:`read() <func-read>` function.
+
+To get and set the streaming parameters applications call the
+``VIDIOC_G_PARM`` and ``VIDIOC_S_PARM`` ioctl, respectively. They take a
+pointer to a struct :c:type:`struct v4l2_streamparm` which contains a
+union holding separate parameters for input and output devices.
+
+
+.. _v4l2-streamparm:
+
+.. flat-table:: struct v4l2_streamparm
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``type``
+
+       -  
+       -  The buffer (stream) type, same as struct
+          :ref:`v4l2_format <v4l2-format>` ``type``, set by the
+          application. See :ref:`v4l2-buf-type`
+
+    -  .. row 2
+
+       -  union
+
+       -  ``parm``
+
+       -  
+       -  
+
+    -  .. row 3
+
+       -  
+       -  struct :ref:`v4l2_captureparm <v4l2-captureparm>`
+
+       -  ``capture``
+
+       -  Parameters for capture devices, used when ``type`` is
+          ``V4L2_BUF_TYPE_VIDEO_CAPTURE``.
+
+    -  .. row 4
+
+       -  
+       -  struct :ref:`v4l2_outputparm <v4l2-outputparm>`
+
+       -  ``output``
+
+       -  Parameters for output devices, used when ``type`` is
+          ``V4L2_BUF_TYPE_VIDEO_OUTPUT``.
+
+    -  .. row 5
+
+       -  
+       -  __u8
+
+       -  ``raw_data``\ [200]
+
+       -  A place holder for future extensions.
+
+
+
+.. _v4l2-captureparm:
+
+.. flat-table:: struct v4l2_captureparm
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``capability``
+
+       -  See :ref:`parm-caps`.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``capturemode``
+
+       -  Set by drivers and applications, see :ref:`parm-flags`.
+
+    -  .. row 3
+
+       -  struct :ref:`v4l2_fract <v4l2-fract>`
+
+       -  ``timeperframe``
+
+       -  This is the desired period between successive frames captured by
+          the driver, in seconds. The field is intended to skip frames on
+          the driver side, saving I/O bandwidth.
+
+          Applications store here the desired frame period, drivers return
+          the actual frame period, which must be greater or equal to the
+          nominal frame period determined by the current video standard
+          (struct :ref:`v4l2_standard <v4l2-standard>` ``frameperiod``
+          field). Changing the video standard (also implicitly by switching
+          the video input) may reset this parameter to the nominal frame
+          period. To reset manually applications can just set this field to
+          zero.
+
+          Drivers support this function only when they set the
+          ``V4L2_CAP_TIMEPERFRAME`` flag in the ``capability`` field.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``extendedmode``
+
+       -  Custom (driver specific) streaming parameters. When unused,
+          applications and drivers must set this field to zero. Applications
+          using this field should check the driver name and version, see
+          :ref:`querycap`.
+
+    -  .. row 5
+
+       -  __u32
+
+       -  ``readbuffers``
+
+       -  Applications set this field to the desired number of buffers used
+          internally by the driver in :ref:`read() <func-read>` mode.
+          Drivers return the actual number of buffers. When an application
+          requests zero buffers, drivers should just return the current
+          setting rather than the minimum or an error code. For details see
+          :ref:`rw`.
+
+    -  .. row 6
+
+       -  __u32
+
+       -  ``reserved``\ [4]
+
+       -  Reserved for future extensions. Drivers and applications must set
+          the array to zero.
+
+
+
+.. _v4l2-outputparm:
+
+.. flat-table:: struct v4l2_outputparm
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``capability``
+
+       -  See :ref:`parm-caps`.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``outputmode``
+
+       -  Set by drivers and applications, see :ref:`parm-flags`.
+
+    -  .. row 3
+
+       -  struct :ref:`v4l2_fract <v4l2-fract>`
+
+       -  ``timeperframe``
+
+       -  This is the desired period between successive frames output by the
+          driver, in seconds.
+
+    -  .. row 4
+
+       -  :cspan:`2`
+
+          The field is intended to repeat frames on the driver side in
+          :ref:`write() <func-write>` mode (in streaming mode timestamps
+          can be used to throttle the output), saving I/O bandwidth.
+
+          Applications store here the desired frame period, drivers return
+          the actual frame period, which must be greater or equal to the
+          nominal frame period determined by the current video standard
+          (struct :ref:`v4l2_standard <v4l2-standard>` ``frameperiod``
+          field). Changing the video standard (also implicitly by switching
+          the video output) may reset this parameter to the nominal frame
+          period. To reset manually applications can just set this field to
+          zero.
+
+          Drivers support this function only when they set the
+          ``V4L2_CAP_TIMEPERFRAME`` flag in the ``capability`` field.
+
+    -  .. row 5
+
+       -  __u32
+
+       -  ``extendedmode``
+
+       -  Custom (driver specific) streaming parameters. When unused,
+          applications and drivers must set this field to zero. Applications
+          using this field should check the driver name and version, see
+          :ref:`querycap`.
+
+    -  .. row 6
+
+       -  __u32
+
+       -  ``writebuffers``
+
+       -  Applications set this field to the desired number of buffers used
+          internally by the driver in :c:func:`write()` mode. Drivers
+          return the actual number of buffers. When an application requests
+          zero buffers, drivers should just return the current setting
+          rather than the minimum or an error code. For details see
+          :ref:`rw`.
+
+    -  .. row 7
+
+       -  __u32
+
+       -  ``reserved``\ [4]
+
+       -  Reserved for future extensions. Drivers and applications must set
+          the array to zero.
+
+
+
+.. _parm-caps:
+
+.. flat-table:: Streaming Parameters Capabilites
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_CAP_TIMEPERFRAME``
+
+       -  0x1000
+
+       -  The frame skipping/repeating controlled by the ``timeperframe``
+          field is supported.
+
+
+
+.. _parm-flags:
+
+.. flat-table:: Capture Parameters Flags
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_MODE_HIGHQUALITY``
+
+       -  0x0001
+
+       -  High quality imaging mode. High quality mode is intended for still
+          imaging applications. The idea is to get the best possible image
+          quality that the hardware can deliver. It is not defined how the
+          driver writer may achieve that; it will depend on the hardware and
+          the ingenuity of the driver writer. High quality mode is a
+          different mode from the regular motion video capture modes. In
+          high quality mode:
+
+          -  The driver may be able to capture higher resolutions than for
+             motion capture.
+
+          -  The driver may support fewer pixel formats than motion capture
+             (eg; true color).
+
+          -  The driver may capture and arithmetically combine multiple
+             successive fields or frames to remove color edge artifacts and
+             reduce the noise in the video data.
+
+          -  The driver may capture images in slices like a scanner in order
+             to handle larger format images than would otherwise be
+             possible.
+
+          -  An image capture operation may be significantly slower than
+             motion capture.
+
+          -  Moving objects in the image might have excessive motion blur.
+
+          -  Capture might only work through the :c:func:`read()` call.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-priority.rst b/Documentation/linux_tv/media/v4l/vidioc-g-priority.rst
new file mode 100644
index 000000000000..0706f2f85a79
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-g-priority.rst
@@ -0,0 +1,126 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-g-priority:
+
+******************************************
+ioctl VIDIOC_G_PRIORITY, VIDIOC_S_PRIORITY
+******************************************
+
+*man VIDIOC_G_PRIORITY(2)*
+
+VIDIOC_S_PRIORITY
+Query or request the access priority associated with a file descriptor
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, enum v4l2_priority *argp )
+
+.. c:function:: int ioctl( int fd, int request, const enum v4l2_priority *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_G_PRIORITY, VIDIOC_S_PRIORITY
+
+``argp``
+    Pointer to an enum v4l2_priority type.
+
+
+Description
+===========
+
+To query the current access priority applications call the
+``VIDIOC_G_PRIORITY`` ioctl with a pointer to an enum v4l2_priority
+variable where the driver stores the current priority.
+
+To request an access priority applications store the desired priority in
+an enum v4l2_priority variable and call ``VIDIOC_S_PRIORITY`` ioctl
+with a pointer to this variable.
+
+
+.. _v4l2-priority:
+
+.. flat-table:: enum v4l2_priority
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_PRIORITY_UNSET``
+
+       -  0
+
+       -  
+
+    -  .. row 2
+
+       -  ``V4L2_PRIORITY_BACKGROUND``
+
+       -  1
+
+       -  Lowest priority, usually applications running in background, for
+          example monitoring VBI transmissions. A proxy application running
+          in user space will be necessary if multiple applications want to
+          read from a device at this priority.
+
+    -  .. row 3
+
+       -  ``V4L2_PRIORITY_INTERACTIVE``
+
+       -  2
+
+       -  
+
+    -  .. row 4
+
+       -  ``V4L2_PRIORITY_DEFAULT``
+
+       -  2
+
+       -  Medium priority, usually applications started and interactively
+          controlled by the user. For example TV viewers, Teletext browsers,
+          or just "panel" applications to change the channel or video
+          controls. This is the default priority unless an application
+          requests another.
+
+    -  .. row 5
+
+       -  ``V4L2_PRIORITY_RECORD``
+
+       -  3
+
+       -  Highest priority. Only one file descriptor can have this priority,
+          it blocks any other fd from changing device properties. Usually
+          applications which must not be interrupted, like video recording.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The requested priority value is invalid.
+
+EBUSY
+    Another application already requested higher priority.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-selection.rst b/Documentation/linux_tv/media/v4l/vidioc-g-selection.rst
new file mode 100644
index 000000000000..7846553dc4de
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-g-selection.rst
@@ -0,0 +1,218 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-g-selection:
+
+********************************************
+ioctl VIDIOC_G_SELECTION, VIDIOC_S_SELECTION
+********************************************
+
+*man VIDIOC_G_SELECTION(2)*
+
+VIDIOC_S_SELECTION
+Get or set one of the selection rectangles
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_selection *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_G_SELECTION, VIDIOC_S_SELECTION
+
+``argp``
+
+
+Description
+===========
+
+The ioctls are used to query and configure selection rectangles.
+
+To query the cropping (composing) rectangle set struct
+:ref:`v4l2_selection <v4l2-selection>` ``type`` field to the
+respective buffer type. Do not use the multiplanar buffer types. Use
+``V4L2_BUF_TYPE_VIDEO_CAPTURE`` instead of
+``V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE`` and use
+``V4L2_BUF_TYPE_VIDEO_OUTPUT`` instead of
+``V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE``. The next step is setting the
+value of struct :ref:`v4l2_selection <v4l2-selection>` ``target``
+field to ``V4L2_SEL_TGT_CROP`` (``V4L2_SEL_TGT_COMPOSE``). Please refer
+to table :ref:`v4l2-selections-common` or :ref:`selection-api` for
+additional targets. The ``flags`` and ``reserved`` fields of struct
+:ref:`v4l2_selection <v4l2-selection>` are ignored and they must be
+filled with zeros. The driver fills the rest of the structure or returns
+EINVAL error code if incorrect buffer type or target was used. If
+cropping (composing) is not supported then the active rectangle is not
+mutable and it is always equal to the bounds rectangle. Finally, the
+struct :ref:`v4l2_rect <v4l2-rect>` ``r`` rectangle is filled with
+the current cropping (composing) coordinates. The coordinates are
+expressed in driver-dependent units. The only exception are rectangles
+for images in raw formats, whose coordinates are always expressed in
+pixels.
+
+To change the cropping (composing) rectangle set the struct
+:ref:`v4l2_selection <v4l2-selection>` ``type`` field to the
+respective buffer type. Do not use multiplanar buffers. Use
+``V4L2_BUF_TYPE_VIDEO_CAPTURE`` instead of
+``V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE``. Use
+``V4L2_BUF_TYPE_VIDEO_OUTPUT`` instead of
+``V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE``. The next step is setting the
+value of struct :ref:`v4l2_selection <v4l2-selection>` ``target`` to
+``V4L2_SEL_TGT_CROP`` (``V4L2_SEL_TGT_COMPOSE``). Please refer to table
+:ref:`v4l2-selections-common` or :ref:`selection-api` for additional
+targets. The struct :ref:`v4l2_rect <v4l2-rect>` ``r`` rectangle need
+to be set to the desired active area. Field struct
+:ref:`v4l2_selection <v4l2-selection>` ``reserved`` is ignored and
+must be filled with zeros. The driver may adjust coordinates of the
+requested rectangle. An application may introduce constraints to control
+rounding behaviour. The struct :ref:`v4l2_selection <v4l2-selection>`
+``flags`` field must be set to one of the following:
+
+-  ``0`` - The driver can adjust the rectangle size freely and shall
+   choose a crop/compose rectangle as close as possible to the requested
+   one.
+
+-  ``V4L2_SEL_FLAG_GE`` - The driver is not allowed to shrink the
+   rectangle. The original rectangle must lay inside the adjusted one.
+
+-  ``V4L2_SEL_FLAG_LE`` - The driver is not allowed to enlarge the
+   rectangle. The adjusted rectangle must lay inside the original one.
+
+-  ``V4L2_SEL_FLAG_GE | V4L2_SEL_FLAG_LE`` - The driver must choose the
+   size exactly the same as in the requested rectangle.
+
+Please refer to :ref:`sel-const-adjust`.
+
+The driver may have to adjusts the requested dimensions against hardware
+limits and other parts as the pipeline, i.e. the bounds given by the
+capture/output window or TV display. The closest possible values of
+horizontal and vertical offset and sizes are chosen according to
+following priority:
+
+1. Satisfy constraints from struct
+   :ref:`v4l2_selection <v4l2-selection>` ``flags``.
+
+2. Adjust width, height, left, and top to hardware limits and
+   alignments.
+
+3. Keep center of adjusted rectangle as close as possible to the
+   original one.
+
+4. Keep width and height as close as possible to original ones.
+
+5. Keep horizontal and vertical offset as close as possible to original
+   ones.
+
+On success the struct :ref:`v4l2_rect <v4l2-rect>` ``r`` field
+contains the adjusted rectangle. When the parameters are unsuitable the
+application may modify the cropping (composing) or image parameters and
+repeat the cycle until satisfactory parameters have been negotiated. If
+constraints flags have to be violated at then ERANGE is returned. The
+error indicates that *there exist no rectangle* that satisfies the
+constraints.
+
+Selection targets and flags are documented in
+:ref:`v4l2-selections-common`.
+
+
+.. _sel-const-adjust:
+
+.. figure::  vidioc-g-selection_files/constraints.*
+    :alt:    constraints.png
+    :align:  center
+
+    Size adjustments with constraint flags.
+
+    Behaviour of rectangle adjustment for different constraint flags.
+
+
+
+
+.. _v4l2-selection:
+
+.. flat-table:: struct v4l2_selection
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``type``
+
+       -  Type of the buffer (from enum
+          :ref:`v4l2_buf_type <v4l2-buf-type>`).
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``target``
+
+       -  Used to select between
+          :ref:`cropping and composing rectangles <v4l2-selections-common>`.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``flags``
+
+       -  Flags controlling the selection rectangle adjustments, refer to
+          :ref:`selection flags <v4l2-selection-flags>`.
+
+    -  .. row 4
+
+       -  struct :ref:`v4l2_rect <v4l2-rect>`
+
+       -  ``r``
+
+       -  The selection rectangle.
+
+    -  .. row 5
+
+       -  __u32
+
+       -  ``reserved[9]``
+
+       -  Reserved fields for future use. Drivers and applications must zero
+          this array.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    Given buffer type ``type`` or the selection target ``target`` is not
+    supported, or the ``flags`` argument is not valid.
+
+ERANGE
+    It is not possible to adjust struct :ref:`v4l2_rect <v4l2-rect>`
+    ``r`` rectangle to satisfy all constraints given in the ``flags``
+    argument.
+
+EBUSY
+    It is not possible to apply change of the selection rectangle at the
+    moment. Usually because streaming is in progress.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-selection_files/constraints.png b/Documentation/linux_tv/media/v4l/vidioc-g-selection_files/constraints.png
new file mode 100644
index 0000000000000000000000000000000000000000..20228d2c5504cf3af92d916970f6bfae0e60e121
GIT binary patch
literal 3313
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

literal 0
HcmV?d00001

diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-sliced-vbi-cap.rst b/Documentation/linux_tv/media/v4l/vidioc-g-sliced-vbi-cap.rst
new file mode 100644
index 000000000000..c76f5682ad0a
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-g-sliced-vbi-cap.rst
@@ -0,0 +1,284 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-g-sliced-vbi-cap:
+
+*****************************
+ioctl VIDIOC_G_SLICED_VBI_CAP
+*****************************
+
+*man VIDIOC_G_SLICED_VBI_CAP(2)*
+
+Query sliced VBI capabilities
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_sliced_vbi_cap *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_G_SLICED_VBI_CAP
+
+``argp``
+
+
+Description
+===========
+
+To find out which data services are supported by a sliced VBI capture or
+output device, applications initialize the ``type`` field of a struct
+:ref:`v4l2_sliced_vbi_cap <v4l2-sliced-vbi-cap>`, clear the
+``reserved`` array and call the ``VIDIOC_G_SLICED_VBI_CAP`` ioctl. The
+driver fills in the remaining fields or returns an EINVAL error code if
+the sliced VBI API is unsupported or ``type`` is invalid.
+
+Note the ``type`` field was added, and the ioctl changed from read-only
+to write-read, in Linux 2.6.19.
+
+
+.. _v4l2-sliced-vbi-cap:
+
+.. flat-table:: struct v4l2_sliced_vbi_cap
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 3 2 2 2
+
+
+    -  .. row 1
+
+       -  __u16
+
+       -  ``service_set``
+
+       -  :cspan:`2` A set of all data services supported by the driver.
+          Equal to the union of all elements of the ``service_lines`` array.
+
+    -  .. row 2
+
+       -  __u16
+
+       -  ``service_lines``\ [2][24]
+
+       -  :cspan:`2` Each element of this array contains a set of data
+          services the hardware can look for or insert into a particular
+          scan line. Data services are defined in :ref:`vbi-services`.
+          Array indices map to ITU-R line numbers (see also :ref:`vbi-525`
+          and :ref:`vbi-625`) as follows:
+
+    -  .. row 3
+
+       -  
+       -  
+       -  Element
+
+       -  525 line systems
+
+       -  625 line systems
+
+    -  .. row 4
+
+       -  
+       -  
+       -  ``service_lines``\ [0][1]
+
+       -  1
+
+       -  1
+
+    -  .. row 5
+
+       -  
+       -  
+       -  ``service_lines``\ [0][23]
+
+       -  23
+
+       -  23
+
+    -  .. row 6
+
+       -  
+       -  
+       -  ``service_lines``\ [1][1]
+
+       -  264
+
+       -  314
+
+    -  .. row 7
+
+       -  
+       -  
+       -  ``service_lines``\ [1][23]
+
+       -  286
+
+       -  336
+
+    -  .. row 8
+
+       -  
+
+    -  .. row 9
+
+       -  
+       -  
+       -  :cspan:`2` The number of VBI lines the hardware can capture or
+          output per frame, or the number of services it can identify on a
+          given line may be limited. For example on PAL line 16 the hardware
+          may be able to look for a VPS or Teletext signal, but not both at
+          the same time. Applications can learn about these limits using the
+          :ref:`VIDIOC_S_FMT <vidioc-g-fmt>` ioctl as described in
+          :ref:`sliced`.
+
+    -  .. row 10
+
+       -  
+
+    -  .. row 11
+
+       -  
+       -  
+       -  :cspan:`2` Drivers must set ``service_lines`` [0][0] and
+          ``service_lines``\ [1][0] to zero.
+
+    -  .. row 12
+
+       -  __u32
+
+       -  ``type``
+
+       -  Type of the data stream, see :ref:`v4l2-buf-type`. Should be
+          ``V4L2_BUF_TYPE_SLICED_VBI_CAPTURE`` or
+          ``V4L2_BUF_TYPE_SLICED_VBI_OUTPUT``.
+
+    -  .. row 13
+
+       -  __u32
+
+       -  ``reserved``\ [3]
+
+       -  :cspan:`2` This array is reserved for future extensions.
+          Applications and drivers must set it to zero.
+
+
+
+.. _vbi-services:
+
+.. flat-table:: Sliced VBI services
+    :header-rows:  1
+    :stub-columns: 0
+    :widths:       2 1 1 2 2
+
+
+    -  .. row 1
+
+       -  Symbol
+
+       -  Value
+
+       -  Reference
+
+       -  Lines, usually
+
+       -  Payload
+
+    -  .. row 2
+
+       -  ``V4L2_SLICED_TELETEXT_B`` (Teletext System B)
+
+       -  0x0001
+
+       -  :ref:`ets300706`, :ref:`itu653`
+
+       -  PAL/SECAM line 7-22, 320-335 (second field 7-22)
+
+       -  Last 42 of the 45 byte Teletext packet, that is without clock
+          run-in and framing code, lsb first transmitted.
+
+    -  .. row 3
+
+       -  ``V4L2_SLICED_VPS``
+
+       -  0x0400
+
+       -  :ref:`ets300231`
+
+       -  PAL line 16
+
+       -  Byte number 3 to 15 according to Figure 9 of ETS 300 231, lsb
+          first transmitted.
+
+    -  .. row 4
+
+       -  ``V4L2_SLICED_CAPTION_525``
+
+       -  0x1000
+
+       -  :ref:`cea608`
+
+       -  NTSC line 21, 284 (second field 21)
+
+       -  Two bytes in transmission order, including parity bit, lsb first
+          transmitted.
+
+    -  .. row 5
+
+       -  ``V4L2_SLICED_WSS_625``
+
+       -  0x4000
+
+       -  :ref:`en300294`, :ref:`itu1119`
+
+       -  PAL/SECAM line 23
+
+       -  
+
+          ::
+
+              Byte        0                 1
+                   msb         lsb  msb           lsb
+              Bit  7 6 5 4 3 2 1 0  x x 13 12 11 10 9
+
+    -  .. row 6
+
+       -  ``V4L2_SLICED_VBI_525``
+
+       -  0x1000
+
+       -  :cspan:`2` Set of services applicable to 525 line systems.
+
+    -  .. row 7
+
+       -  ``V4L2_SLICED_VBI_625``
+
+       -  0x4401
+
+       -  :cspan:`2` Set of services applicable to 625 line systems.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The value in the ``type`` field is wrong.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-std.rst b/Documentation/linux_tv/media/v4l/vidioc-g-std.rst
new file mode 100644
index 000000000000..c01e8c1f51d0
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-g-std.rst
@@ -0,0 +1,76 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-g-std:
+
+********************************
+ioctl VIDIOC_G_STD, VIDIOC_S_STD
+********************************
+
+*man VIDIOC_G_STD(2)*
+
+VIDIOC_S_STD
+Query or select the video standard of the current input
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, v4l2_std_id *argp )
+
+.. c:function:: int ioctl( int fd, int request, const v4l2_std_id *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_G_STD, VIDIOC_S_STD
+
+``argp``
+
+
+Description
+===========
+
+To query and select the current video standard applications use the
+``VIDIOC_G_STD`` and ``VIDIOC_S_STD`` ioctls which take a pointer to a
+:ref:`v4l2_std_id <v4l2-std-id>` type as argument. ``VIDIOC_G_STD``
+can return a single flag or a set of flags as in struct
+:ref:`v4l2_standard <v4l2-standard>` field ``id``. The flags must be
+unambiguous such that they appear in only one enumerated
+:c:type:`struct v4l2_standard` structure.
+
+``VIDIOC_S_STD`` accepts one or more flags, being a write-only ioctl it
+does not return the actual new standard as ``VIDIOC_G_STD`` does. When
+no flags are given or the current input does not support the requested
+standard the driver returns an EINVAL error code. When the standard set
+is ambiguous drivers may return EINVAL or choose any of the requested
+standards. If the current input or output does not support standard
+video timings (e.g. if :ref:`VIDIOC_ENUMINPUT <vidioc-enuminput>`
+does not set the ``V4L2_IN_CAP_STD`` flag), then ENODATA error code is
+returned.
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The ``VIDIOC_S_STD`` parameter was unsuitable.
+
+ENODATA
+    Standard video timings are not supported for this input or output.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-g-tuner.rst b/Documentation/linux_tv/media/v4l/vidioc-g-tuner.rst
new file mode 100644
index 000000000000..d897f6862b9d
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-g-tuner.rst
@@ -0,0 +1,724 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-g-tuner:
+
+************************************
+ioctl VIDIOC_G_TUNER, VIDIOC_S_TUNER
+************************************
+
+*man VIDIOC_G_TUNER(2)*
+
+VIDIOC_S_TUNER
+Get or set tuner attributes
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_tuner *argp )
+
+.. c:function:: int ioctl( int fd, int request, const struct v4l2_tuner *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_G_TUNER, VIDIOC_S_TUNER
+
+``argp``
+
+
+Description
+===========
+
+To query the attributes of a tuner applications initialize the ``index``
+field and zero out the ``reserved`` array of a struct
+:ref:`v4l2_tuner <v4l2-tuner>` and call the ``VIDIOC_G_TUNER`` ioctl
+with a pointer to this structure. Drivers fill the rest of the structure
+or return an EINVAL error code when the index is out of bounds. To
+enumerate all tuners applications shall begin at index zero,
+incrementing by one until the driver returns EINVAL.
+
+Tuners have two writable properties, the audio mode and the radio
+frequency. To change the audio mode, applications initialize the
+``index``, ``audmode`` and ``reserved`` fields and call the
+``VIDIOC_S_TUNER`` ioctl. This will *not* change the current tuner,
+which is determined by the current video input. Drivers may choose a
+different audio mode if the requested mode is invalid or unsupported.
+Since this is a write-only ioctl, it does not return the actually
+selected audio mode.
+
+:ref:`SDR <sdr>` specific tuner types are ``V4L2_TUNER_SDR`` and
+``V4L2_TUNER_RF``. For SDR devices ``audmode`` field must be initialized
+to zero. The term 'tuner' means SDR receiver in this context.
+
+To change the radio frequency the
+:ref:`VIDIOC_S_FREQUENCY <vidioc-g-frequency>` ioctl is available.
+
+
+.. _v4l2-tuner:
+
+.. flat-table:: struct v4l2_tuner
+    :header-rows:  0
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``index``
+
+       -  :cspan:`1` Identifies the tuner, set by the application.
+
+    -  .. row 2
+
+       -  __u8
+
+       -  ``name``\ [32]
+
+       -  :cspan:`1`
+
+          Name of the tuner, a NUL-terminated ASCII string. This information
+          is intended for the user.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``type``
+
+       -  :cspan:`1` Type of the tuner, see :ref:`v4l2-tuner-type`.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``capability``
+
+       -  :cspan:`1`
+
+          Tuner capability flags, see :ref:`tuner-capability`. Audio flags
+          indicate the ability to decode audio subprograms. They will *not*
+          change, for example with the current video standard.
+
+          When the structure refers to a radio tuner the
+          ``V4L2_TUNER_CAP_LANG1``, ``V4L2_TUNER_CAP_LANG2`` and
+          ``V4L2_TUNER_CAP_NORM`` flags can't be used.
+
+          If multiple frequency bands are supported, then ``capability`` is
+          the union of all ``capability`` fields of each struct
+          :ref:`v4l2_frequency_band <v4l2-frequency-band>`.
+
+    -  .. row 5
+
+       -  __u32
+
+       -  ``rangelow``
+
+       -  :cspan:`1` The lowest tunable frequency in units of 62.5 kHz, or
+          if the ``capability`` flag ``V4L2_TUNER_CAP_LOW`` is set, in units
+          of 62.5 Hz, or if the ``capability`` flag ``V4L2_TUNER_CAP_1HZ``
+          is set, in units of 1 Hz. If multiple frequency bands are
+          supported, then ``rangelow`` is the lowest frequency of all the
+          frequency bands.
+
+    -  .. row 6
+
+       -  __u32
+
+       -  ``rangehigh``
+
+       -  :cspan:`1` The highest tunable frequency in units of 62.5 kHz,
+          or if the ``capability`` flag ``V4L2_TUNER_CAP_LOW`` is set, in
+          units of 62.5 Hz, or if the ``capability`` flag
+          ``V4L2_TUNER_CAP_1HZ`` is set, in units of 1 Hz. If multiple
+          frequency bands are supported, then ``rangehigh`` is the highest
+          frequency of all the frequency bands.
+
+    -  .. row 7
+
+       -  __u32
+
+       -  ``rxsubchans``
+
+       -  :cspan:`1`
+
+          Some tuners or audio decoders can determine the received audio
+          subprograms by analyzing audio carriers, pilot tones or other
+          indicators. To pass this information drivers set flags defined in
+          :ref:`tuner-rxsubchans` in this field. For example:
+
+    -  .. row 8
+
+       -  
+       -  
+       -  ``V4L2_TUNER_SUB_MONO``
+
+       -  receiving mono audio
+
+    -  .. row 9
+
+       -  
+       -  
+       -  ``STEREO | SAP``
+
+       -  receiving stereo audio and a secondary audio program
+
+    -  .. row 10
+
+       -  
+       -  
+       -  ``MONO | STEREO``
+
+       -  receiving mono or stereo audio, the hardware cannot distinguish
+
+    -  .. row 11
+
+       -  
+       -  
+       -  ``LANG1 | LANG2``
+
+       -  receiving bilingual audio
+
+    -  .. row 12
+
+       -  
+       -  
+       -  ``MONO | STEREO | LANG1 | LANG2``
+
+       -  receiving mono, stereo or bilingual audio
+
+    -  .. row 13
+
+       -  
+       -  
+       -  :cspan:`1`
+
+          When the ``V4L2_TUNER_CAP_STEREO``, ``_LANG1``, ``_LANG2`` or
+          ``_SAP`` flag is cleared in the ``capability`` field, the
+          corresponding ``V4L2_TUNER_SUB_`` flag must not be set here.
+
+          This field is valid only if this is the tuner of the current video
+          input, or when the structure refers to a radio tuner.
+
+    -  .. row 14
+
+       -  __u32
+
+       -  ``audmode``
+
+       -  :cspan:`1`
+
+          The selected audio mode, see :ref:`tuner-audmode` for valid
+          values. The audio mode does not affect audio subprogram detection,
+          and like a :ref:`control <control>` it does not automatically
+          change unless the requested mode is invalid or unsupported. See
+          :ref:`tuner-matrix` for possible results when the selected and
+          received audio programs do not match.
+
+          Currently this is the only field of struct
+          :c:type:`struct v4l2_tuner` applications can change.
+
+    -  .. row 15
+
+       -  __u32
+
+       -  ``signal``
+
+       -  :cspan:`1` The signal strength if known, ranging from 0 to
+          65535. Higher values indicate a better signal.
+
+    -  .. row 16
+
+       -  __s32
+
+       -  ``afc``
+
+       -  :cspan:`1` Automatic frequency control: When the ``afc`` value
+          is negative, the frequency is too low, when positive too high.
+
+    -  .. row 17
+
+       -  __u32
+
+       -  ``reserved``\ [4]
+
+       -  :cspan:`1` Reserved for future extensions. Drivers and
+          applications must set the array to zero.
+
+
+
+.. _v4l2-tuner-type:
+
+.. flat-table:: enum v4l2_tuner_type
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_TUNER_RADIO``
+
+       -  1
+
+       -  
+
+    -  .. row 2
+
+       -  ``V4L2_TUNER_ANALOG_TV``
+
+       -  2
+
+       -  
+
+    -  .. row 3
+
+       -  ``V4L2_TUNER_SDR``
+
+       -  4
+
+       -  
+
+    -  .. row 4
+
+       -  ``V4L2_TUNER_RF``
+
+       -  5
+
+       -  
+
+
+
+.. _tuner-capability:
+
+.. flat-table:: Tuner and Modulator Capability Flags
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_TUNER_CAP_LOW``
+
+       -  0x0001
+
+       -  When set, tuning frequencies are expressed in units of 62.5 Hz
+          instead of 62.5 kHz.
+
+    -  .. row 2
+
+       -  ``V4L2_TUNER_CAP_NORM``
+
+       -  0x0002
+
+       -  This is a multi-standard tuner; the video standard can or must be
+          switched. (B/G PAL tuners for example are typically not considered
+          multi-standard because the video standard is automatically
+          determined from the frequency band.) The set of supported video
+          standards is available from the struct
+          :ref:`v4l2_input <v4l2-input>` pointing to this tuner, see the
+          description of ioctl :ref:`VIDIOC_ENUMINPUT <vidioc-enuminput>`
+          for details. Only ``V4L2_TUNER_ANALOG_TV`` tuners can have this
+          capability.
+
+    -  .. row 3
+
+       -  ``V4L2_TUNER_CAP_HWSEEK_BOUNDED``
+
+       -  0x0004
+
+       -  If set, then this tuner supports the hardware seek functionality
+          where the seek stops when it reaches the end of the frequency
+          range.
+
+    -  .. row 4
+
+       -  ``V4L2_TUNER_CAP_HWSEEK_WRAP``
+
+       -  0x0008
+
+       -  If set, then this tuner supports the hardware seek functionality
+          where the seek wraps around when it reaches the end of the
+          frequency range.
+
+    -  .. row 5
+
+       -  ``V4L2_TUNER_CAP_STEREO``
+
+       -  0x0010
+
+       -  Stereo audio reception is supported.
+
+    -  .. row 6
+
+       -  ``V4L2_TUNER_CAP_LANG1``
+
+       -  0x0040
+
+       -  Reception of the primary language of a bilingual audio program is
+          supported. Bilingual audio is a feature of two-channel systems,
+          transmitting the primary language monaural on the main audio
+          carrier and a secondary language monaural on a second carrier.
+          Only ``V4L2_TUNER_ANALOG_TV`` tuners can have this capability.
+
+    -  .. row 7
+
+       -  ``V4L2_TUNER_CAP_LANG2``
+
+       -  0x0020
+
+       -  Reception of the secondary language of a bilingual audio program
+          is supported. Only ``V4L2_TUNER_ANALOG_TV`` tuners can have this
+          capability.
+
+    -  .. row 8
+
+       -  ``V4L2_TUNER_CAP_SAP``
+
+       -  0x0020
+
+       -  Reception of a secondary audio program is supported. This is a
+          feature of the BTSC system which accompanies the NTSC video
+          standard. Two audio carriers are available for mono or stereo
+          transmissions of a primary language, and an independent third
+          carrier for a monaural secondary language. Only
+          ``V4L2_TUNER_ANALOG_TV`` tuners can have this capability.
+
+          Note the ``V4L2_TUNER_CAP_LANG2`` and ``V4L2_TUNER_CAP_SAP`` flags
+          are synonyms. ``V4L2_TUNER_CAP_SAP`` applies when the tuner
+          supports the ``V4L2_STD_NTSC_M`` video standard.
+
+    -  .. row 9
+
+       -  ``V4L2_TUNER_CAP_RDS``
+
+       -  0x0080
+
+       -  RDS capture is supported. This capability is only valid for radio
+          tuners.
+
+    -  .. row 10
+
+       -  ``V4L2_TUNER_CAP_RDS_BLOCK_IO``
+
+       -  0x0100
+
+       -  The RDS data is passed as unparsed RDS blocks.
+
+    -  .. row 11
+
+       -  ``V4L2_TUNER_CAP_RDS_CONTROLS``
+
+       -  0x0200
+
+       -  The RDS data is parsed by the hardware and set via controls.
+
+    -  .. row 12
+
+       -  ``V4L2_TUNER_CAP_FREQ_BANDS``
+
+       -  0x0400
+
+       -  The :ref:`VIDIOC_ENUM_FREQ_BANDS <vidioc-enum-freq-bands>`
+          ioctl can be used to enumerate the available frequency bands.
+
+    -  .. row 13
+
+       -  ``V4L2_TUNER_CAP_HWSEEK_PROG_LIM``
+
+       -  0x0800
+
+       -  The range to search when using the hardware seek functionality is
+          programmable, see
+          :ref:`VIDIOC_S_HW_FREQ_SEEK <vidioc-s-hw-freq-seek>` for
+          details.
+
+    -  .. row 14
+
+       -  ``V4L2_TUNER_CAP_1HZ``
+
+       -  0x1000
+
+       -  When set, tuning frequencies are expressed in units of 1 Hz
+          instead of 62.5 kHz.
+
+
+
+.. _tuner-rxsubchans:
+
+.. flat-table:: Tuner Audio Reception Flags
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_TUNER_SUB_MONO``
+
+       -  0x0001
+
+       -  The tuner receives a mono audio signal.
+
+    -  .. row 2
+
+       -  ``V4L2_TUNER_SUB_STEREO``
+
+       -  0x0002
+
+       -  The tuner receives a stereo audio signal.
+
+    -  .. row 3
+
+       -  ``V4L2_TUNER_SUB_LANG1``
+
+       -  0x0008
+
+       -  The tuner receives the primary language of a bilingual audio
+          signal. Drivers must clear this flag when the current video
+          standard is ``V4L2_STD_NTSC_M``.
+
+    -  .. row 4
+
+       -  ``V4L2_TUNER_SUB_LANG2``
+
+       -  0x0004
+
+       -  The tuner receives the secondary language of a bilingual audio
+          signal (or a second audio program).
+
+    -  .. row 5
+
+       -  ``V4L2_TUNER_SUB_SAP``
+
+       -  0x0004
+
+       -  The tuner receives a Second Audio Program. Note the
+          ``V4L2_TUNER_SUB_LANG2`` and ``V4L2_TUNER_SUB_SAP`` flags are
+          synonyms. The ``V4L2_TUNER_SUB_SAP`` flag applies when the current
+          video standard is ``V4L2_STD_NTSC_M``.
+
+    -  .. row 6
+
+       -  ``V4L2_TUNER_SUB_RDS``
+
+       -  0x0010
+
+       -  The tuner receives an RDS channel.
+
+
+
+.. _tuner-audmode:
+
+.. flat-table:: Tuner Audio Modes
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_TUNER_MODE_MONO``
+
+       -  0
+
+       -  Play mono audio. When the tuner receives a stereo signal this a
+          down-mix of the left and right channel. When the tuner receives a
+          bilingual or SAP signal this mode selects the primary language.
+
+    -  .. row 2
+
+       -  ``V4L2_TUNER_MODE_STEREO``
+
+       -  1
+
+       -  Play stereo audio. When the tuner receives bilingual audio it may
+          play different languages on the left and right channel or the
+          primary language is played on both channels.
+
+          Playing different languages in this mode is deprecated. New
+          drivers should do this only in ``MODE_LANG1_LANG2``.
+
+          When the tuner receives no stereo signal or does not support
+          stereo reception the driver shall fall back to ``MODE_MONO``.
+
+    -  .. row 3
+
+       -  ``V4L2_TUNER_MODE_LANG1``
+
+       -  3
+
+       -  Play the primary language, mono or stereo. Only
+          ``V4L2_TUNER_ANALOG_TV`` tuners support this mode.
+
+    -  .. row 4
+
+       -  ``V4L2_TUNER_MODE_LANG2``
+
+       -  2
+
+       -  Play the secondary language, mono. When the tuner receives no
+          bilingual audio or SAP, or their reception is not supported the
+          driver shall fall back to mono or stereo mode. Only
+          ``V4L2_TUNER_ANALOG_TV`` tuners support this mode.
+
+    -  .. row 5
+
+       -  ``V4L2_TUNER_MODE_SAP``
+
+       -  2
+
+       -  Play the Second Audio Program. When the tuner receives no
+          bilingual audio or SAP, or their reception is not supported the
+          driver shall fall back to mono or stereo mode. Only
+          ``V4L2_TUNER_ANALOG_TV`` tuners support this mode. Note the
+          ``V4L2_TUNER_MODE_LANG2`` and ``V4L2_TUNER_MODE_SAP`` are
+          synonyms.
+
+    -  .. row 6
+
+       -  ``V4L2_TUNER_MODE_LANG1_LANG2``
+
+       -  4
+
+       -  Play the primary language on the left channel, the secondary
+          language on the right channel. When the tuner receives no
+          bilingual audio or SAP, it shall fall back to ``MODE_LANG1`` or
+          ``MODE_MONO``. Only ``V4L2_TUNER_ANALOG_TV`` tuners support this
+          mode.
+
+
+
+.. _tuner-matrix:
+
+.. flat-table:: Tuner Audio Matrix
+    :header-rows:  2
+    :stub-columns: 0
+
+
+    -  .. row 1
+
+       -  
+       -  :cspan:`5` Selected ``V4L2_TUNER_MODE_``
+
+    -  .. row 2
+
+       -  Received ``V4L2_TUNER_SUB_``
+
+       -  ``MONO``
+
+       -  ``STEREO``
+
+       -  ``LANG1``
+
+       -  ``LANG2 = SAP``
+
+       -  ``LANG1_LANG2``\  [1]_
+
+    -  .. row 3
+
+       -  ``MONO``
+
+       -  Mono
+
+       -  Mono/Mono
+
+       -  Mono
+
+       -  Mono
+
+       -  Mono/Mono
+
+    -  .. row 4
+
+       -  ``MONO | SAP``
+
+       -  Mono
+
+       -  Mono/Mono
+
+       -  Mono
+
+       -  SAP
+
+       -  Mono/SAP (preferred) or Mono/Mono
+
+    -  .. row 5
+
+       -  ``STEREO``
+
+       -  L+R
+
+       -  L/R
+
+       -  Stereo L/R (preferred) or Mono L+R
+
+       -  Stereo L/R (preferred) or Mono L+R
+
+       -  L/R (preferred) or L+R/L+R
+
+    -  .. row 6
+
+       -  ``STEREO | SAP``
+
+       -  L+R
+
+       -  L/R
+
+       -  Stereo L/R (preferred) or Mono L+R
+
+       -  SAP
+
+       -  L+R/SAP (preferred) or L/R or L+R/L+R
+
+    -  .. row 7
+
+       -  ``LANG1 | LANG2``
+
+       -  Language 1
+
+       -  Lang1/Lang2 (deprecated [2]_) or Lang1/Lang1
+
+       -  Language 1
+
+       -  Language 2
+
+       -  Lang1/Lang2 (preferred) or Lang1/Lang1
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The struct :ref:`v4l2_tuner <v4l2-tuner>` ``index`` is out of
+    bounds.
+
+.. [1]
+   This mode has been added in Linux 2.6.17 and may not be supported by
+   older drivers.
+
+.. [2]
+   Playback of both languages in ``MODE_STEREO`` is deprecated. In the
+   future drivers should produce only the primary language in this mode.
+   Applications should request ``MODE_LANG1_LANG2`` to record both
+   languages or a stereo signal.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-log-status.rst b/Documentation/linux_tv/media/v4l/vidioc-log-status.rst
new file mode 100644
index 000000000000..0706274ff6a3
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-log-status.rst
@@ -0,0 +1,48 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-log-status:
+
+***********************
+ioctl VIDIOC_LOG_STATUS
+***********************
+
+*man VIDIOC_LOG_STATUS(2)*
+
+Log driver status information
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request )
+
+Description
+===========
+
+As the video/audio devices become more complicated it becomes harder to
+debug problems. When this ioctl is called the driver will output the
+current device status to the kernel log. This is particular useful when
+dealing with problems like no sound, no video and incorrectly tuned
+channels. Also many modern devices autodetect video and audio standards
+and this ioctl will report what the device thinks what the standard is.
+Mismatches may give an indication where the problem is.
+
+This ioctl is optional and not all drivers support it. It was introduced
+in Linux 2.6.15.
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-overlay.rst b/Documentation/linux_tv/media/v4l/vidioc-overlay.rst
new file mode 100644
index 000000000000..d82d24fd7fb2
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-overlay.rst
@@ -0,0 +1,62 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-overlay:
+
+********************
+ioctl VIDIOC_OVERLAY
+********************
+
+*man VIDIOC_OVERLAY(2)*
+
+Start or stop video overlay
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, const int *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_OVERLAY
+
+``argp``
+
+
+Description
+===========
+
+This ioctl is part of the :ref:`video overlay <overlay>` I/O method.
+Applications call ``VIDIOC_OVERLAY`` to start or stop the overlay. It
+takes a pointer to an integer which must be set to zero by the
+application to stop overlay, to one to start.
+
+Drivers do not support :ref:`VIDIOC_STREAMON <vidioc-streamon>` or
+:ref:`VIDIOC_STREAMOFF <vidioc-streamon>` with
+``V4L2_BUF_TYPE_VIDEO_OVERLAY``.
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The overlay parameters have not been set up. See :ref:`overlay`
+    for the necessary steps.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-prepare-buf.rst b/Documentation/linux_tv/media/v4l/vidioc-prepare-buf.rst
new file mode 100644
index 000000000000..c29757f38066
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-prepare-buf.rst
@@ -0,0 +1,69 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-prepare-buf:
+
+************************
+ioctl VIDIOC_PREPARE_BUF
+************************
+
+*man VIDIOC_PREPARE_BUF(2)*
+
+Prepare a buffer for I/O
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_buffer *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_PREPARE_BUF
+
+``argp``
+
+
+Description
+===========
+
+Applications can optionally call the ``VIDIOC_PREPARE_BUF`` ioctl to
+pass ownership of the buffer to the driver before actually enqueuing it,
+using the ``VIDIOC_QBUF`` ioctl, and to prepare it for future I/O. Such
+preparations may include cache invalidation or cleaning. Performing them
+in advance saves time during the actual I/O. In case such cache
+operations are not required, the application can use one of
+``V4L2_BUF_FLAG_NO_CACHE_INVALIDATE`` and
+``V4L2_BUF_FLAG_NO_CACHE_CLEAN`` flags to skip the respective step.
+
+The :c:type:`struct v4l2_buffer` structure is specified in
+:ref:`buffer`.
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EBUSY
+    File I/O is in progress.
+
+EINVAL
+    The buffer ``type`` is not supported, or the ``index`` is out of
+    bounds, or no buffers have been allocated yet, or the ``userptr`` or
+    ``length`` are invalid.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-qbuf.rst b/Documentation/linux_tv/media/v4l/vidioc-qbuf.rst
new file mode 100644
index 000000000000..6912780b0e3d
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-qbuf.rst
@@ -0,0 +1,158 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-qbuf:
+
+*******************************
+ioctl VIDIOC_QBUF, VIDIOC_DQBUF
+*******************************
+
+*man VIDIOC_QBUF(2)*
+
+VIDIOC_DQBUF
+Exchange a buffer with the driver
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_buffer *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_QBUF, VIDIOC_DQBUF
+
+``argp``
+
+
+Description
+===========
+
+Applications call the ``VIDIOC_QBUF`` ioctl to enqueue an empty
+(capturing) or filled (output) buffer in the driver's incoming queue.
+The semantics depend on the selected I/O method.
+
+To enqueue a buffer applications set the ``type`` field of a struct
+:ref:`v4l2_buffer <v4l2-buffer>` to the same buffer type as was
+previously used with struct :ref:`v4l2_format <v4l2-format>` ``type``
+and struct :ref:`v4l2_requestbuffers <v4l2-requestbuffers>` ``type``.
+Applications must also set the ``index`` field. Valid index numbers
+range from zero to the number of buffers allocated with
+:ref:`VIDIOC_REQBUFS <vidioc-reqbufs>` (struct
+:ref:`v4l2_requestbuffers <v4l2-requestbuffers>` ``count``) minus
+one. The contents of the struct :c:type:`struct v4l2_buffer` returned
+by a :ref:`VIDIOC_QUERYBUF <vidioc-querybuf>` ioctl will do as well.
+When the buffer is intended for output (``type`` is
+``V4L2_BUF_TYPE_VIDEO_OUTPUT``, ``V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE``,
+or ``V4L2_BUF_TYPE_VBI_OUTPUT``) applications must also initialize the
+``bytesused``, ``field`` and ``timestamp`` fields, see :ref:`buffer`
+for details. Applications must also set ``flags`` to 0. The
+``reserved2`` and ``reserved`` fields must be set to 0. When using the
+:ref:`multi-planar API <planar-apis>`, the ``m.planes`` field must
+contain a userspace pointer to a filled-in array of struct
+:ref:`v4l2_plane <v4l2-plane>` and the ``length`` field must be set
+to the number of elements in that array.
+
+To enqueue a :ref:`memory mapped <mmap>` buffer applications set the
+``memory`` field to ``V4L2_MEMORY_MMAP``. When ``VIDIOC_QBUF`` is called
+with a pointer to this structure the driver sets the
+``V4L2_BUF_FLAG_MAPPED`` and ``V4L2_BUF_FLAG_QUEUED`` flags and clears
+the ``V4L2_BUF_FLAG_DONE`` flag in the ``flags`` field, or it returns an
+EINVAL error code.
+
+To enqueue a :ref:`user pointer <userp>` buffer applications set the
+``memory`` field to ``V4L2_MEMORY_USERPTR``, the ``m.userptr`` field to
+the address of the buffer and ``length`` to its size. When the
+multi-planar API is used, ``m.userptr`` and ``length`` members of the
+passed array of struct :ref:`v4l2_plane <v4l2-plane>` have to be used
+instead. When ``VIDIOC_QBUF`` is called with a pointer to this structure
+the driver sets the ``V4L2_BUF_FLAG_QUEUED`` flag and clears the
+``V4L2_BUF_FLAG_MAPPED`` and ``V4L2_BUF_FLAG_DONE`` flags in the
+``flags`` field, or it returns an error code. This ioctl locks the
+memory pages of the buffer in physical memory, they cannot be swapped
+out to disk. Buffers remain locked until dequeued, until the
+:ref:`VIDIOC_STREAMOFF <vidioc-streamon>` or
+:ref:`VIDIOC_REQBUFS <vidioc-reqbufs>` ioctl is called, or until the
+device is closed.
+
+To enqueue a :ref:`DMABUF <dmabuf>` buffer applications set the
+``memory`` field to ``V4L2_MEMORY_DMABUF`` and the ``m.fd`` field to a
+file descriptor associated with a DMABUF buffer. When the multi-planar
+API is used the ``m.fd`` fields of the passed array of struct
+:ref:`v4l2_plane <v4l2-plane>` have to be used instead. When
+``VIDIOC_QBUF`` is called with a pointer to this structure the driver
+sets the ``V4L2_BUF_FLAG_QUEUED`` flag and clears the
+``V4L2_BUF_FLAG_MAPPED`` and ``V4L2_BUF_FLAG_DONE`` flags in the
+``flags`` field, or it returns an error code. This ioctl locks the
+buffer. Locking a buffer means passing it to a driver for a hardware
+access (usually DMA). If an application accesses (reads/writes) a locked
+buffer then the result is undefined. Buffers remain locked until
+dequeued, until the :ref:`VIDIOC_STREAMOFF <vidioc-streamon>` or
+:ref:`VIDIOC_REQBUFS <vidioc-reqbufs>` ioctl is called, or until the
+device is closed.
+
+Applications call the ``VIDIOC_DQBUF`` ioctl to dequeue a filled
+(capturing) or displayed (output) buffer from the driver's outgoing
+queue. They just set the ``type``, ``memory`` and ``reserved`` fields of
+a struct :ref:`v4l2_buffer <v4l2-buffer>` as above, when
+``VIDIOC_DQBUF`` is called with a pointer to this structure the driver
+fills the remaining fields or returns an error code. The driver may also
+set ``V4L2_BUF_FLAG_ERROR`` in the ``flags`` field. It indicates a
+non-critical (recoverable) streaming error. In such case the application
+may continue as normal, but should be aware that data in the dequeued
+buffer might be corrupted. When using the multi-planar API, the planes
+array must be passed in as well.
+
+By default ``VIDIOC_DQBUF`` blocks when no buffer is in the outgoing
+queue. When the ``O_NONBLOCK`` flag was given to the
+:ref:`open() <func-open>` function, ``VIDIOC_DQBUF`` returns
+immediately with an EAGAIN error code when no buffer is available.
+
+The :c:type:`struct v4l2_buffer` structure is specified in
+:ref:`buffer`.
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EAGAIN
+    Non-blocking I/O has been selected using ``O_NONBLOCK`` and no
+    buffer was in the outgoing queue.
+
+EINVAL
+    The buffer ``type`` is not supported, or the ``index`` is out of
+    bounds, or no buffers have been allocated yet, or the ``userptr`` or
+    ``length`` are invalid.
+
+EIO
+    ``VIDIOC_DQBUF`` failed due to an internal error. Can also indicate
+    temporary problems like signal loss. Note the driver might dequeue
+    an (empty) buffer despite returning an error, or even stop
+    capturing. Reusing such buffer may be unsafe though and its details
+    (e.g. ``index``) may not be returned either. It is recommended that
+    drivers indicate recoverable errors by setting the
+    ``V4L2_BUF_FLAG_ERROR`` and returning 0 instead. In that case the
+    application should be able to safely reuse the buffer and continue
+    streaming.
+
+EPIPE
+    ``VIDIOC_DQBUF`` returns this on an empty capture queue for mem2mem
+    codecs if a buffer with the ``V4L2_BUF_FLAG_LAST`` was already
+    dequeued and no new buffers are expected to become available.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-query-dv-timings.rst b/Documentation/linux_tv/media/v4l/vidioc-query-dv-timings.rst
new file mode 100644
index 000000000000..567faa73e23b
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-query-dv-timings.rst
@@ -0,0 +1,91 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-query-dv-timings:
+
+*****************************
+ioctl VIDIOC_QUERY_DV_TIMINGS
+*****************************
+
+*man VIDIOC_QUERY_DV_TIMINGS(2)*
+
+VIDIOC_SUBDEV_QUERY_DV_TIMINGS
+Sense the DV preset received by the current input
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_dv_timings *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_QUERY_DV_TIMINGS, VIDIOC_SUBDEV_QUERY_DV_TIMINGS
+
+``argp``
+
+
+Description
+===========
+
+The hardware may be able to detect the current DV timings automatically,
+similar to sensing the video standard. To do so, applications call
+``VIDIOC_QUERY_DV_TIMINGS`` with a pointer to a struct
+:ref:`v4l2_dv_timings <v4l2-dv-timings>`. Once the hardware detects
+the timings, it will fill in the timings structure.
+
+Please note that drivers shall *not* switch timings automatically if new
+timings are detected. Instead, drivers should send the
+``V4L2_EVENT_SOURCE_CHANGE`` event (if they support this) and expect
+that userspace will take action by calling ``VIDIOC_QUERY_DV_TIMINGS``.
+The reason is that new timings usually mean different buffer sizes as
+well, and you cannot change buffer sizes on the fly. In general,
+applications that receive the Source Change event will have to call
+``VIDIOC_QUERY_DV_TIMINGS``, and if the detected timings are valid they
+will have to stop streaming, set the new timings, allocate new buffers
+and start streaming again.
+
+If the timings could not be detected because there was no signal, then
+ENOLINK is returned. If a signal was detected, but it was unstable and
+the receiver could not lock to the signal, then ENOLCK is returned. If
+the receiver could lock to the signal, but the format is unsupported
+(e.g. because the pixelclock is out of range of the hardware
+capabilities), then the driver fills in whatever timings it could find
+and returns ERANGE. In that case the application can call
+:ref:`VIDIOC_DV_TIMINGS_CAP <vidioc-dv-timings-cap>` to compare the
+found timings with the hardware's capabilities in order to give more
+precise feedback to the user.
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+ENODATA
+    Digital video timings are not supported for this input or output.
+
+ENOLINK
+    No timings could be detected because no signal was found.
+
+ENOLCK
+    The signal was unstable and the hardware could not lock on to it.
+
+ERANGE
+    Timings were found, but they are out of range of the hardware
+    capabilities.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-querybuf.rst b/Documentation/linux_tv/media/v4l/vidioc-querybuf.rst
new file mode 100644
index 000000000000..092ed4586a18
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-querybuf.rst
@@ -0,0 +1,88 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-querybuf:
+
+*********************
+ioctl VIDIOC_QUERYBUF
+*********************
+
+*man VIDIOC_QUERYBUF(2)*
+
+Query the status of a buffer
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_buffer *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_QUERYBUF
+
+``argp``
+
+
+Description
+===========
+
+This ioctl is part of the :ref:`streaming <mmap>` I/O method. It can
+be used to query the status of a buffer at any time after buffers have
+been allocated with the :ref:`VIDIOC_REQBUFS <vidioc-reqbufs>` ioctl.
+
+Applications set the ``type`` field of a struct
+:ref:`v4l2_buffer <v4l2-buffer>` to the same buffer type as was
+previously used with struct :ref:`v4l2_format <v4l2-format>` ``type``
+and struct :ref:`v4l2_requestbuffers <v4l2-requestbuffers>` ``type``,
+and the ``index`` field. Valid index numbers range from zero to the
+number of buffers allocated with
+:ref:`VIDIOC_REQBUFS <vidioc-reqbufs>` (struct
+:ref:`v4l2_requestbuffers <v4l2-requestbuffers>` ``count``) minus
+one. The ``reserved`` and ``reserved2`` fields must be set to 0. When
+using the :ref:`multi-planar API <planar-apis>`, the ``m.planes``
+field must contain a userspace pointer to an array of struct
+:ref:`v4l2_plane <v4l2-plane>` and the ``length`` field has to be set
+to the number of elements in that array. After calling
+``VIDIOC_QUERYBUF`` with a pointer to this structure drivers return an
+error code or fill the rest of the structure.
+
+In the ``flags`` field the ``V4L2_BUF_FLAG_MAPPED``,
+``V4L2_BUF_FLAG_PREPARED``, ``V4L2_BUF_FLAG_QUEUED`` and
+``V4L2_BUF_FLAG_DONE`` flags will be valid. The ``memory`` field will be
+set to the current I/O method. For the single-planar API, the
+``m.offset`` contains the offset of the buffer from the start of the
+device memory, the ``length`` field its size. For the multi-planar API,
+fields ``m.mem_offset`` and ``length`` in the ``m.planes`` array
+elements will be used instead and the ``length`` field of struct
+:ref:`v4l2_buffer <v4l2-buffer>` is set to the number of filled-in
+array elements. The driver may or may not set the remaining fields and
+flags, they are meaningless in this context.
+
+The :c:type:`struct v4l2_buffer` structure is specified in
+:ref:`buffer`.
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The buffer ``type`` is not supported, or the ``index`` is out of
+    bounds.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-querycap.rst b/Documentation/linux_tv/media/v4l/vidioc-querycap.rst
new file mode 100644
index 000000000000..54f86443dfcc
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-querycap.rst
@@ -0,0 +1,442 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-querycap:
+
+*********************
+ioctl VIDIOC_QUERYCAP
+*********************
+
+*man VIDIOC_QUERYCAP(2)*
+
+Query device capabilities
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_capability *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_QUERYCAP
+
+``argp``
+
+
+Description
+===========
+
+All V4L2 devices support the ``VIDIOC_QUERYCAP`` ioctl. It is used to
+identify kernel devices compatible with this specification and to obtain
+information about driver and hardware capabilities. The ioctl takes a
+pointer to a struct :ref:`v4l2_capability <v4l2-capability>` which is
+filled by the driver. When the driver is not compatible with this
+specification the ioctl returns an EINVAL error code.
+
+
+.. _v4l2-capability:
+
+.. flat-table:: struct v4l2_capability
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u8
+
+       -  ``driver``\ [16]
+
+       -  Name of the driver, a unique NUL-terminated ASCII string. For
+          example: "bttv". Driver specific applications can use this
+          information to verify the driver identity. It is also useful to
+          work around known bugs, or to identify drivers in error reports.
+
+          Storing strings in fixed sized arrays is bad practice but
+          unavoidable here. Drivers and applications should take precautions
+          to never read or write beyond the end of the array and to make
+          sure the strings are properly NUL-terminated.
+
+    -  .. row 2
+
+       -  __u8
+
+       -  ``card``\ [32]
+
+       -  Name of the device, a NUL-terminated UTF-8 string. For example:
+          "Yoyodyne TV/FM". One driver may support different brands or
+          models of video hardware. This information is intended for users,
+          for example in a menu of available devices. Since multiple TV
+          cards of the same brand may be installed which are supported by
+          the same driver, this name should be combined with the character
+          device file name (e. g. ``/dev/video2``) or the ``bus_info``
+          string to avoid ambiguities.
+
+    -  .. row 3
+
+       -  __u8
+
+       -  ``bus_info``\ [32]
+
+       -  Location of the device in the system, a NUL-terminated ASCII
+          string. For example: "PCI:0000:05:06.0". This information is
+          intended for users, to distinguish multiple identical devices. If
+          no such information is available the field must simply count the
+          devices controlled by the driver ("platform:vivi-000"). The
+          bus_info must start with "PCI:" for PCI boards, "PCIe:" for PCI
+          Express boards, "usb-" for USB devices, "I2C:" for i2c devices,
+          "ISA:" for ISA devices, "parport" for parallel port devices and
+          "platform:" for platform devices.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``version``
+
+       -  Version number of the driver.
+
+          Starting with kernel 3.1, the version reported is provided by the
+          V4L2 subsystem following the kernel numbering scheme. However, it
+          may not always return the same version as the kernel if, for
+          example, a stable or distribution-modified kernel uses the V4L2
+          stack from a newer kernel.
+
+          The version number is formatted using the ``KERNEL_VERSION()``
+          macro:
+
+    -  .. row 5
+
+       -  :cspan:`2`
+
+
+          .. code-block:: c
+
+              #define KERNEL_VERSION(a,b,c) (((a) << 16) + ((b) << 8) + (c))
+
+              __u32 version = KERNEL_VERSION(0, 8, 1);
+
+              printf ("Version: %u.%u.%u\\n",
+                  (version >> 16) & 0xFF,
+                  (version >> 8) & 0xFF,
+                   version & 0xFF);
+
+    -  .. row 6
+
+       -  __u32
+
+       -  ``capabilities``
+
+       -  Available capabilities of the physical device as a whole, see
+          :ref:`device-capabilities`. The same physical device can export
+          multiple devices in /dev (e.g. /dev/videoX, /dev/vbiY and
+          /dev/radioZ). The ``capabilities`` field should contain a union of
+          all capabilities available around the several V4L2 devices
+          exported to userspace. For all those devices the ``capabilities``
+          field returns the same set of capabilities. This allows
+          applications to open just one of the devices (typically the video
+          device) and discover whether video, vbi and/or radio are also
+          supported.
+
+    -  .. row 7
+
+       -  __u32
+
+       -  ``device_caps``
+
+       -  Device capabilities of the opened device, see
+          :ref:`device-capabilities`. Should contain the available
+          capabilities of that specific device node. So, for example,
+          ``device_caps`` of a radio device will only contain radio related
+          capabilities and no video or vbi capabilities. This field is only
+          set if the ``capabilities`` field contains the
+          ``V4L2_CAP_DEVICE_CAPS`` capability. Only the ``capabilities``
+          field can have the ``V4L2_CAP_DEVICE_CAPS`` capability,
+          ``device_caps`` will never set ``V4L2_CAP_DEVICE_CAPS``.
+
+    -  .. row 8
+
+       -  __u32
+
+       -  ``reserved``\ [3]
+
+       -  Reserved for future extensions. Drivers must set this array to
+          zero.
+
+
+
+.. _device-capabilities:
+
+.. flat-table:: Device Capabilities Flags
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_CAP_VIDEO_CAPTURE``
+
+       -  0x00000001
+
+       -  The device supports the single-planar API through the
+          :ref:`Video Capture <capture>` interface.
+
+    -  .. row 2
+
+       -  ``V4L2_CAP_VIDEO_CAPTURE_MPLANE``
+
+       -  0x00001000
+
+       -  The device supports the :ref:`multi-planar API <planar-apis>`
+          through the :ref:`Video Capture <capture>` interface.
+
+    -  .. row 3
+
+       -  ``V4L2_CAP_VIDEO_OUTPUT``
+
+       -  0x00000002
+
+       -  The device supports the single-planar API through the
+          :ref:`Video Output <output>` interface.
+
+    -  .. row 4
+
+       -  ``V4L2_CAP_VIDEO_OUTPUT_MPLANE``
+
+       -  0x00002000
+
+       -  The device supports the :ref:`multi-planar API <planar-apis>`
+          through the :ref:`Video Output <output>` interface.
+
+    -  .. row 5
+
+       -  ``V4L2_CAP_VIDEO_M2M``
+
+       -  0x00004000
+
+       -  The device supports the single-planar API through the Video
+          Memory-To-Memory interface.
+
+    -  .. row 6
+
+       -  ``V4L2_CAP_VIDEO_M2M_MPLANE``
+
+       -  0x00008000
+
+       -  The device supports the :ref:`multi-planar API <planar-apis>`
+          through the Video Memory-To-Memory interface.
+
+    -  .. row 7
+
+       -  ``V4L2_CAP_VIDEO_OVERLAY``
+
+       -  0x00000004
+
+       -  The device supports the :ref:`Video Overlay <overlay>`
+          interface. A video overlay device typically stores captured images
+          directly in the video memory of a graphics card, with hardware
+          clipping and scaling.
+
+    -  .. row 8
+
+       -  ``V4L2_CAP_VBI_CAPTURE``
+
+       -  0x00000010
+
+       -  The device supports the :ref:`Raw VBI Capture <raw-vbi>`
+          interface, providing Teletext and Closed Caption data.
+
+    -  .. row 9
+
+       -  ``V4L2_CAP_VBI_OUTPUT``
+
+       -  0x00000020
+
+       -  The device supports the :ref:`Raw VBI Output <raw-vbi>`
+          interface.
+
+    -  .. row 10
+
+       -  ``V4L2_CAP_SLICED_VBI_CAPTURE``
+
+       -  0x00000040
+
+       -  The device supports the :ref:`Sliced VBI Capture <sliced>`
+          interface.
+
+    -  .. row 11
+
+       -  ``V4L2_CAP_SLICED_VBI_OUTPUT``
+
+       -  0x00000080
+
+       -  The device supports the :ref:`Sliced VBI Output <sliced>`
+          interface.
+
+    -  .. row 12
+
+       -  ``V4L2_CAP_RDS_CAPTURE``
+
+       -  0x00000100
+
+       -  The device supports the :ref:`RDS <rds>` capture interface.
+
+    -  .. row 13
+
+       -  ``V4L2_CAP_VIDEO_OUTPUT_OVERLAY``
+
+       -  0x00000200
+
+       -  The device supports the :ref:`Video Output Overlay <osd>` (OSD)
+          interface. Unlike the *Video Overlay* interface, this is a
+          secondary function of video output devices and overlays an image
+          onto an outgoing video signal. When the driver sets this flag, it
+          must clear the ``V4L2_CAP_VIDEO_OVERLAY`` flag and vice
+          versa. [1]_
+
+    -  .. row 14
+
+       -  ``V4L2_CAP_HW_FREQ_SEEK``
+
+       -  0x00000400
+
+       -  The device supports the
+          :ref:`VIDIOC_S_HW_FREQ_SEEK <vidioc-s-hw-freq-seek>` ioctl
+          for hardware frequency seeking.
+
+    -  .. row 15
+
+       -  ``V4L2_CAP_RDS_OUTPUT``
+
+       -  0x00000800
+
+       -  The device supports the :ref:`RDS <rds>` output interface.
+
+    -  .. row 16
+
+       -  ``V4L2_CAP_TUNER``
+
+       -  0x00010000
+
+       -  The device has some sort of tuner to receive RF-modulated video
+          signals. For more information about tuner programming see
+          :ref:`tuner`.
+
+    -  .. row 17
+
+       -  ``V4L2_CAP_AUDIO``
+
+       -  0x00020000
+
+       -  The device has audio inputs or outputs. It may or may not support
+          audio recording or playback, in PCM or compressed formats. PCM
+          audio support must be implemented as ALSA or OSS interface. For
+          more information on audio inputs and outputs see :ref:`audio`.
+
+    -  .. row 18
+
+       -  ``V4L2_CAP_RADIO``
+
+       -  0x00040000
+
+       -  This is a radio receiver.
+
+    -  .. row 19
+
+       -  ``V4L2_CAP_MODULATOR``
+
+       -  0x00080000
+
+       -  The device has some sort of modulator to emit RF-modulated
+          video/audio signals. For more information about modulator
+          programming see :ref:`tuner`.
+
+    -  .. row 20
+
+       -  ``V4L2_CAP_SDR_CAPTURE``
+
+       -  0x00100000
+
+       -  The device supports the :ref:`SDR Capture <sdr>` interface.
+
+    -  .. row 21
+
+       -  ``V4L2_CAP_EXT_PIX_FORMAT``
+
+       -  0x00200000
+
+       -  The device supports the struct
+          :ref:`v4l2_pix_format <v4l2-pix-format>` extended fields.
+
+    -  .. row 22
+
+       -  ``V4L2_CAP_SDR_OUTPUT``
+
+       -  0x00400000
+
+       -  The device supports the :ref:`SDR Output <sdr>` interface.
+
+    -  .. row 23
+
+       -  ``V4L2_CAP_READWRITE``
+
+       -  0x01000000
+
+       -  The device supports the :ref:`read() <rw>` and/or
+          :ref:`write() <rw>` I/O methods.
+
+    -  .. row 24
+
+       -  ``V4L2_CAP_ASYNCIO``
+
+       -  0x02000000
+
+       -  The device supports the :ref:`asynchronous <async>` I/O methods.
+
+    -  .. row 25
+
+       -  ``V4L2_CAP_STREAMING``
+
+       -  0x04000000
+
+       -  The device supports the :ref:`streaming <mmap>` I/O method.
+
+    -  .. row 26
+
+       -  ``V4L2_CAP_DEVICE_CAPS``
+
+       -  0x80000000
+
+       -  The driver fills the ``device_caps`` field. This capability can
+          only appear in the ``capabilities`` field and never in the
+          ``device_caps`` field.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+.. [1]
+   The struct :ref:`v4l2_framebuffer <v4l2-framebuffer>` lacks an
+   enum :ref:`v4l2_buf_type <v4l2-buf-type>` field, therefore the
+   type of overlay is implied by the driver capabilities.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-queryctrl.rst b/Documentation/linux_tv/media/v4l/vidioc-queryctrl.rst
new file mode 100644
index 000000000000..116b69c1f818
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-queryctrl.rst
@@ -0,0 +1,790 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-queryctrl:
+
+***************************************************************
+ioctl VIDIOC_QUERYCTRL, VIDIOC_QUERY_EXT_CTRL, VIDIOC_QUERYMENU
+***************************************************************
+
+*man VIDIOC_QUERYCTRL(2)*
+
+VIDIOC_QUERY_EXT_CTRL
+VIDIOC_QUERYMENU
+Enumerate controls and menu control items
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_queryctrl *argp )
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_query_ext_ctrl *argp )
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_querymenu *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_QUERYCTRL, VIDIOC_QUERY_EXT_CTRL, VIDIOC_QUERYMENU
+
+``argp``
+
+
+Description
+===========
+
+To query the attributes of a control applications set the ``id`` field
+of a struct :ref:`v4l2_queryctrl <v4l2-queryctrl>` and call the
+``VIDIOC_QUERYCTRL`` ioctl with a pointer to this structure. The driver
+fills the rest of the structure or returns an EINVAL error code when the
+``id`` is invalid.
+
+It is possible to enumerate controls by calling ``VIDIOC_QUERYCTRL``
+with successive ``id`` values starting from ``V4L2_CID_BASE`` up to and
+exclusive ``V4L2_CID_LASTP1``. Drivers may return EINVAL if a control in
+this range is not supported. Further applications can enumerate private
+controls, which are not defined in this specification, by starting at
+``V4L2_CID_PRIVATE_BASE`` and incrementing ``id`` until the driver
+returns EINVAL.
+
+In both cases, when the driver sets the ``V4L2_CTRL_FLAG_DISABLED`` flag
+in the ``flags`` field this control is permanently disabled and should
+be ignored by the application. [1]_
+
+When the application ORs ``id`` with ``V4L2_CTRL_FLAG_NEXT_CTRL`` the
+driver returns the next supported non-compound control, or EINVAL if
+there is none. In addition, the ``V4L2_CTRL_FLAG_NEXT_COMPOUND`` flag
+can be specified to enumerate all compound controls (i.e. controls with
+type ≥ ``V4L2_CTRL_COMPOUND_TYPES`` and/or array control, in other words
+controls that contain more than one value). Specify both
+``V4L2_CTRL_FLAG_NEXT_CTRL`` and ``V4L2_CTRL_FLAG_NEXT_COMPOUND`` in
+order to enumerate all controls, compound or not. Drivers which do not
+support these flags yet always return EINVAL.
+
+The ``VIDIOC_QUERY_EXT_CTRL`` ioctl was introduced in order to better
+support controls that can use compound types, and to expose additional
+control information that cannot be returned in struct
+:ref:`v4l2_queryctrl <v4l2-queryctrl>` since that structure is full.
+
+``VIDIOC_QUERY_EXT_CTRL`` is used in the same way as
+``VIDIOC_QUERYCTRL``, except that the ``reserved`` array must be zeroed
+as well.
+
+Additional information is required for menu controls: the names of the
+menu items. To query them applications set the ``id`` and ``index``
+fields of struct :ref:`v4l2_querymenu <v4l2-querymenu>` and call the
+``VIDIOC_QUERYMENU`` ioctl with a pointer to this structure. The driver
+fills the rest of the structure or returns an EINVAL error code when the
+``id`` or ``index`` is invalid. Menu items are enumerated by calling
+``VIDIOC_QUERYMENU`` with successive ``index`` values from struct
+:ref:`v4l2_queryctrl <v4l2-queryctrl>` ``minimum`` to ``maximum``,
+inclusive. Note that it is possible for ``VIDIOC_QUERYMENU`` to return
+an EINVAL error code for some indices between ``minimum`` and
+``maximum``. In that case that particular menu item is not supported by
+this driver. Also note that the ``minimum`` value is not necessarily 0.
+
+See also the examples in :ref:`control`.
+
+
+.. _v4l2-queryctrl:
+
+.. flat-table:: struct v4l2_queryctrl
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``id``
+
+       -  Identifies the control, set by the application. See
+          :ref:`control-id` for predefined IDs. When the ID is ORed with
+          V4L2_CTRL_FLAG_NEXT_CTRL the driver clears the flag and
+          returns the first control with a higher ID. Drivers which do not
+          support this flag yet always return an EINVAL error code.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``type``
+
+       -  Type of control, see :ref:`v4l2-ctrl-type`.
+
+    -  .. row 3
+
+       -  __u8
+
+       -  ``name``\ [32]
+
+       -  Name of the control, a NUL-terminated ASCII string. This
+          information is intended for the user.
+
+    -  .. row 4
+
+       -  __s32
+
+       -  ``minimum``
+
+       -  Minimum value, inclusive. This field gives a lower bound for the
+          control. See enum :ref:`v4l2_ctrl_type <v4l2-ctrl-type>` how
+          the minimum value is to be used for each possible control type.
+          Note that this a signed 32-bit value.
+
+    -  .. row 5
+
+       -  __s32
+
+       -  ``maximum``
+
+       -  Maximum value, inclusive. This field gives an upper bound for the
+          control. See enum :ref:`v4l2_ctrl_type <v4l2-ctrl-type>` how
+          the maximum value is to be used for each possible control type.
+          Note that this a signed 32-bit value.
+
+    -  .. row 6
+
+       -  __s32
+
+       -  ``step``
+
+       -  This field gives a step size for the control. See enum
+          :ref:`v4l2_ctrl_type <v4l2-ctrl-type>` how the step value is
+          to be used for each possible control type. Note that this an
+          unsigned 32-bit value.
+
+          Generally drivers should not scale hardware control values. It may
+          be necessary for example when the ``name`` or ``id`` imply a
+          particular unit and the hardware actually accepts only multiples
+          of said unit. If so, drivers must take care values are properly
+          rounded when scaling, such that errors will not accumulate on
+          repeated read-write cycles.
+
+          This field gives the smallest change of an integer control
+          actually affecting hardware. Often the information is needed when
+          the user can change controls by keyboard or GUI buttons, rather
+          than a slider. When for example a hardware register accepts values
+          0-511 and the driver reports 0-65535, step should be 128.
+
+          Note that although signed, the step value is supposed to be always
+          positive.
+
+    -  .. row 7
+
+       -  __s32
+
+       -  ``default_value``
+
+       -  The default value of a ``V4L2_CTRL_TYPE_INTEGER``, ``_BOOLEAN``,
+          ``_BITMASK``, ``_MENU`` or ``_INTEGER_MENU`` control. Not valid
+          for other types of controls. Note that drivers reset controls to
+          their default value only when the driver is first loaded, never
+          afterwards.
+
+    -  .. row 8
+
+       -  __u32
+
+       -  ``flags``
+
+       -  Control flags, see :ref:`control-flags`.
+
+    -  .. row 9
+
+       -  __u32
+
+       -  ``reserved``\ [2]
+
+       -  Reserved for future extensions. Drivers must set the array to
+          zero.
+
+
+
+.. _v4l2-query-ext-ctrl:
+
+.. flat-table:: struct v4l2_query_ext_ctrl
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``id``
+
+       -  Identifies the control, set by the application. See
+          :ref:`control-id` for predefined IDs. When the ID is ORed with
+          ``V4L2_CTRL_FLAG_NEXT_CTRL`` the driver clears the flag and
+          returns the first non-compound control with a higher ID. When the
+          ID is ORed with ``V4L2_CTRL_FLAG_NEXT_COMPOUND`` the driver clears
+          the flag and returns the first compound control with a higher ID.
+          Set both to get the first control (compound or not) with a higher
+          ID.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``type``
+
+       -  Type of control, see :ref:`v4l2-ctrl-type`.
+
+    -  .. row 3
+
+       -  char
+
+       -  ``name``\ [32]
+
+       -  Name of the control, a NUL-terminated ASCII string. This
+          information is intended for the user.
+
+    -  .. row 4
+
+       -  __s64
+
+       -  ``minimum``
+
+       -  Minimum value, inclusive. This field gives a lower bound for the
+          control. See enum :ref:`v4l2_ctrl_type <v4l2-ctrl-type>` how
+          the minimum value is to be used for each possible control type.
+          Note that this a signed 64-bit value.
+
+    -  .. row 5
+
+       -  __s64
+
+       -  ``maximum``
+
+       -  Maximum value, inclusive. This field gives an upper bound for the
+          control. See enum :ref:`v4l2_ctrl_type <v4l2-ctrl-type>` how
+          the maximum value is to be used for each possible control type.
+          Note that this a signed 64-bit value.
+
+    -  .. row 6
+
+       -  __u64
+
+       -  ``step``
+
+       -  This field gives a step size for the control. See enum
+          :ref:`v4l2_ctrl_type <v4l2-ctrl-type>` how the step value is
+          to be used for each possible control type. Note that this an
+          unsigned 64-bit value.
+
+          Generally drivers should not scale hardware control values. It may
+          be necessary for example when the ``name`` or ``id`` imply a
+          particular unit and the hardware actually accepts only multiples
+          of said unit. If so, drivers must take care values are properly
+          rounded when scaling, such that errors will not accumulate on
+          repeated read-write cycles.
+
+          This field gives the smallest change of an integer control
+          actually affecting hardware. Often the information is needed when
+          the user can change controls by keyboard or GUI buttons, rather
+          than a slider. When for example a hardware register accepts values
+          0-511 and the driver reports 0-65535, step should be 128.
+
+    -  .. row 7
+
+       -  __s64
+
+       -  ``default_value``
+
+       -  The default value of a ``V4L2_CTRL_TYPE_INTEGER``, ``_INTEGER64``,
+          ``_BOOLEAN``, ``_BITMASK``, ``_MENU``, ``_INTEGER_MENU``, ``_U8``
+          or ``_U16`` control. Not valid for other types of controls. Note
+          that drivers reset controls to their default value only when the
+          driver is first loaded, never afterwards.
+
+    -  .. row 8
+
+       -  __u32
+
+       -  ``flags``
+
+       -  Control flags, see :ref:`control-flags`.
+
+    -  .. row 9
+
+       -  __u32
+
+       -  ``elem_size``
+
+       -  The size in bytes of a single element of the array. Given a char
+          pointer ``p`` to a 3-dimensional array you can find the position
+          of cell ``(z, y, x)`` as follows:
+          ``p + ((z * dims[1] + y) * dims[0] + x) * elem_size``.
+          ``elem_size`` is always valid, also when the control isn't an
+          array. For string controls ``elem_size`` is equal to
+          ``maximum + 1``.
+
+    -  .. row 10
+
+       -  __u32
+
+       -  ``elems``
+
+       -  The number of elements in the N-dimensional array. If this control
+          is not an array, then ``elems`` is 1. The ``elems`` field can
+          never be 0.
+
+    -  .. row 11
+
+       -  __u32
+
+       -  ``nr_of_dims``
+
+       -  The number of dimension in the N-dimensional array. If this
+          control is not an array, then this field is 0.
+
+    -  .. row 12
+
+       -  __u32
+
+       -  ``dims[V4L2_CTRL_MAX_DIMS]``
+
+       -  The size of each dimension. The first ``nr_of_dims`` elements of
+          this array must be non-zero, all remaining elements must be zero.
+
+    -  .. row 13
+
+       -  __u32
+
+       -  ``reserved``\ [32]
+
+       -  Reserved for future extensions. Applications and drivers must set
+          the array to zero.
+
+
+
+.. _v4l2-querymenu:
+
+.. flat-table:: struct v4l2_querymenu
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2 1
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  
+       -  ``id``
+
+       -  Identifies the control, set by the application from the respective
+          struct :ref:`v4l2_queryctrl <v4l2-queryctrl>` ``id``.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  
+       -  ``index``
+
+       -  Index of the menu item, starting at zero, set by the application.
+
+    -  .. row 3
+
+       -  union
+
+       -  
+       -  
+       -  
+
+    -  .. row 4
+
+       -  
+       -  __u8
+
+       -  ``name``\ [32]
+
+       -  Name of the menu item, a NUL-terminated ASCII string. This
+          information is intended for the user. This field is valid for
+          ``V4L2_CTRL_FLAG_MENU`` type controls.
+
+    -  .. row 5
+
+       -  
+       -  __s64
+
+       -  ``value``
+
+       -  Value of the integer menu item. This field is valid for
+          ``V4L2_CTRL_FLAG_INTEGER_MENU`` type controls.
+
+    -  .. row 6
+
+       -  __u32
+
+       -  
+       -  ``reserved``
+
+       -  Reserved for future extensions. Drivers must set the array to
+          zero.
+
+
+
+.. _v4l2-ctrl-type:
+
+.. flat-table:: enum v4l2_ctrl_type
+    :header-rows:  1
+    :stub-columns: 0
+    :widths:       30 5 5 5 55
+
+
+    -  .. row 1
+
+       -  Type
+
+       -  ``minimum``
+
+       -  ``step``
+
+       -  ``maximum``
+
+       -  Description
+
+    -  .. row 2
+
+       -  ``V4L2_CTRL_TYPE_INTEGER``
+
+       -  any
+
+       -  any
+
+       -  any
+
+       -  An integer-valued control ranging from minimum to maximum
+          inclusive. The step value indicates the increment between values.
+
+    -  .. row 3
+
+       -  ``V4L2_CTRL_TYPE_BOOLEAN``
+
+       -  0
+
+       -  1
+
+       -  1
+
+       -  A boolean-valued control. Zero corresponds to "disabled", and one
+          means "enabled".
+
+    -  .. row 4
+
+       -  ``V4L2_CTRL_TYPE_MENU``
+
+       -  ≥ 0
+
+       -  1
+
+       -  N-1
+
+       -  The control has a menu of N choices. The names of the menu items
+          can be enumerated with the ``VIDIOC_QUERYMENU`` ioctl.
+
+    -  .. row 5
+
+       -  ``V4L2_CTRL_TYPE_INTEGER_MENU``
+
+       -  ≥ 0
+
+       -  1
+
+       -  N-1
+
+       -  The control has a menu of N choices. The values of the menu items
+          can be enumerated with the ``VIDIOC_QUERYMENU`` ioctl. This is
+          similar to ``V4L2_CTRL_TYPE_MENU`` except that instead of strings,
+          the menu items are signed 64-bit integers.
+
+    -  .. row 6
+
+       -  ``V4L2_CTRL_TYPE_BITMASK``
+
+       -  0
+
+       -  n/a
+
+       -  any
+
+       -  A bitmask field. The maximum value is the set of bits that can be
+          used, all other bits are to be 0. The maximum value is interpreted
+          as a __u32, allowing the use of bit 31 in the bitmask.
+
+    -  .. row 7
+
+       -  ``V4L2_CTRL_TYPE_BUTTON``
+
+       -  0
+
+       -  0
+
+       -  0
+
+       -  A control which performs an action when set. Drivers must ignore
+          the value passed with ``VIDIOC_S_CTRL`` and return an EINVAL error
+          code on a ``VIDIOC_G_CTRL`` attempt.
+
+    -  .. row 8
+
+       -  ``V4L2_CTRL_TYPE_INTEGER64``
+
+       -  any
+
+       -  any
+
+       -  any
+
+       -  A 64-bit integer valued control. Minimum, maximum and step size
+          cannot be queried using ``VIDIOC_QUERYCTRL``. Only
+          ``VIDIOC_QUERY_EXT_CTRL`` can retrieve the 64-bit min/max/step
+          values, they should be interpreted as n/a when using
+          ``VIDIOC_QUERYCTRL``.
+
+    -  .. row 9
+
+       -  ``V4L2_CTRL_TYPE_STRING``
+
+       -  ≥ 0
+
+       -  ≥ 1
+
+       -  ≥ 0
+
+       -  The minimum and maximum string lengths. The step size means that
+          the string must be (minimum + N * step) characters long for N ≥ 0.
+          These lengths do not include the terminating zero, so in order to
+          pass a string of length 8 to
+          :ref:`VIDIOC_S_EXT_CTRLS <vidioc-g-ext-ctrls>` you need to
+          set the ``size`` field of struct
+          :ref:`v4l2_ext_control <v4l2-ext-control>` to 9. For
+          :ref:`VIDIOC_G_EXT_CTRLS <vidioc-g-ext-ctrls>` you can set
+          the ``size`` field to ``maximum`` + 1. Which character encoding is
+          used will depend on the string control itself and should be part
+          of the control documentation.
+
+    -  .. row 10
+
+       -  ``V4L2_CTRL_TYPE_CTRL_CLASS``
+
+       -  n/a
+
+       -  n/a
+
+       -  n/a
+
+       -  This is not a control. When ``VIDIOC_QUERYCTRL`` is called with a
+          control ID equal to a control class code (see :ref:`ctrl-class`)
+          + 1, the ioctl returns the name of the control class and this
+          control type. Older drivers which do not support this feature
+          return an EINVAL error code.
+
+    -  .. row 11
+
+       -  ``V4L2_CTRL_TYPE_U8``
+
+       -  any
+
+       -  any
+
+       -  any
+
+       -  An unsigned 8-bit valued control ranging from minimum to maximum
+          inclusive. The step value indicates the increment between values.
+
+    -  .. row 12
+
+       -  ``V4L2_CTRL_TYPE_U16``
+
+       -  any
+
+       -  any
+
+       -  any
+
+       -  An unsigned 16-bit valued control ranging from minimum to maximum
+          inclusive. The step value indicates the increment between values.
+
+    -  .. row 13
+
+       -  ``V4L2_CTRL_TYPE_U32``
+
+       -  any
+
+       -  any
+
+       -  any
+
+       -  An unsigned 32-bit valued control ranging from minimum to maximum
+          inclusive. The step value indicates the increment between values.
+
+
+
+.. _control-flags:
+
+.. flat-table:: Control Flags
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_CTRL_FLAG_DISABLED``
+
+       -  0x0001
+
+       -  This control is permanently disabled and should be ignored by the
+          application. Any attempt to change the control will result in an
+          EINVAL error code.
+
+    -  .. row 2
+
+       -  ``V4L2_CTRL_FLAG_GRABBED``
+
+       -  0x0002
+
+       -  This control is temporarily unchangeable, for example because
+          another application took over control of the respective resource.
+          Such controls may be displayed specially in a user interface.
+          Attempts to change the control may result in an EBUSY error code.
+
+    -  .. row 3
+
+       -  ``V4L2_CTRL_FLAG_READ_ONLY``
+
+       -  0x0004
+
+       -  This control is permanently readable only. Any attempt to change
+          the control will result in an EINVAL error code.
+
+    -  .. row 4
+
+       -  ``V4L2_CTRL_FLAG_UPDATE``
+
+       -  0x0008
+
+       -  A hint that changing this control may affect the value of other
+          controls within the same control class. Applications should update
+          their user interface accordingly.
+
+    -  .. row 5
+
+       -  ``V4L2_CTRL_FLAG_INACTIVE``
+
+       -  0x0010
+
+       -  This control is not applicable to the current configuration and
+          should be displayed accordingly in a user interface. For example
+          the flag may be set on a MPEG audio level 2 bitrate control when
+          MPEG audio encoding level 1 was selected with another control.
+
+    -  .. row 6
+
+       -  ``V4L2_CTRL_FLAG_SLIDER``
+
+       -  0x0020
+
+       -  A hint that this control is best represented as a slider-like
+          element in a user interface.
+
+    -  .. row 7
+
+       -  ``V4L2_CTRL_FLAG_WRITE_ONLY``
+
+       -  0x0040
+
+       -  This control is permanently writable only. Any attempt to read the
+          control will result in an EACCES error code error code. This flag
+          is typically present for relative controls or action controls
+          where writing a value will cause the device to carry out a given
+          action (e. g. motor control) but no meaningful value can be
+          returned.
+
+    -  .. row 8
+
+       -  ``V4L2_CTRL_FLAG_VOLATILE``
+
+       -  0x0080
+
+       -  This control is volatile, which means that the value of the
+          control changes continuously. A typical example would be the
+          current gain value if the device is in auto-gain mode. In such a
+          case the hardware calculates the gain value based on the lighting
+          conditions which can change over time. Note that setting a new
+          value for a volatile control will have no effect and no
+          ``V4L2_EVENT_CTRL_CH_VALUE`` will be sent, unless the
+          ``V4L2_CTRL_FLAG_EXECUTE_ON_WRITE`` flag (see below) is also set.
+          Otherwise the new value will just be ignored.
+
+    -  .. row 9
+
+       -  ``V4L2_CTRL_FLAG_HAS_PAYLOAD``
+
+       -  0x0100
+
+       -  This control has a pointer type, so its value has to be accessed
+          using one of the pointer fields of struct
+          :ref:`v4l2_ext_control <v4l2-ext-control>`. This flag is set
+          for controls that are an array, string, or have a compound type.
+          In all cases you have to set a pointer to memory containing the
+          payload of the control.
+
+    -  .. row 10
+
+       -  ``V4L2_CTRL_FLAG_EXECUTE_ON_WRITE``
+
+       -  0x0200
+
+       -  The value provided to the control will be propagated to the driver
+          even if it remains constant. This is required when the control
+          represents an action on the hardware. For example: clearing an
+          error flag or triggering the flash. All the controls of the type
+          ``V4L2_CTRL_TYPE_BUTTON`` have this flag set.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The struct :ref:`v4l2_queryctrl <v4l2-queryctrl>` ``id`` is
+    invalid. The struct :ref:`v4l2_querymenu <v4l2-querymenu>` ``id``
+    is invalid or ``index`` is out of range (less than ``minimum`` or
+    greater than ``maximum``) or this particular menu item is not
+    supported by the driver.
+
+EACCES
+    An attempt was made to read a write-only control.
+
+.. [1]
+   ``V4L2_CTRL_FLAG_DISABLED`` was intended for two purposes: Drivers
+   can skip predefined controls not supported by the hardware (although
+   returning EINVAL would do as well), or disable predefined and private
+   controls after hardware detection without the trouble of reordering
+   control arrays and indices (EINVAL cannot be used to skip private
+   controls because it would prematurely end the enumeration).
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-querystd.rst b/Documentation/linux_tv/media/v4l/vidioc-querystd.rst
new file mode 100644
index 000000000000..8e22ba4b9c99
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-querystd.rst
@@ -0,0 +1,73 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-querystd:
+
+*********************
+ioctl VIDIOC_QUERYSTD
+*********************
+
+*man VIDIOC_QUERYSTD(2)*
+
+Sense the video standard received by the current input
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, v4l2_std_id *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_QUERYSTD
+
+``argp``
+
+
+Description
+===========
+
+The hardware may be able to detect the current video standard
+automatically. To do so, applications call ``VIDIOC_QUERYSTD`` with a
+pointer to a :ref:`v4l2_std_id <v4l2-std-id>` type. The driver
+stores here a set of candidates, this can be a single flag or a set of
+supported standards if for example the hardware can only distinguish
+between 50 and 60 Hz systems. If no signal was detected, then the driver
+will return V4L2_STD_UNKNOWN. When detection is not possible or fails,
+the set must contain all standards supported by the current video input
+or output.
+
+Please note that drivers shall *not* switch the video standard
+automatically if a new video standard is detected. Instead, drivers
+should send the ``V4L2_EVENT_SOURCE_CHANGE`` event (if they support
+this) and expect that userspace will take action by calling
+``VIDIOC_QUERYSTD``. The reason is that a new video standard can mean
+different buffer sizes as well, and you cannot change buffer sizes on
+the fly. In general, applications that receive the Source Change event
+will have to call ``VIDIOC_QUERYSTD``, and if the detected video
+standard is valid they will have to stop streaming, set the new
+standard, allocate new buffers and start streaming again.
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+ENODATA
+    Standard video timings are not supported for this input or output.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-reqbufs.rst b/Documentation/linux_tv/media/v4l/vidioc-reqbufs.rst
new file mode 100644
index 000000000000..621e3c1e054d
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-reqbufs.rst
@@ -0,0 +1,133 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-reqbufs:
+
+********************
+ioctl VIDIOC_REQBUFS
+********************
+
+*man VIDIOC_REQBUFS(2)*
+
+Initiate Memory Mapping or User Pointer I/O
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_requestbuffers *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_REQBUFS
+
+``argp``
+
+
+Description
+===========
+
+This ioctl is used to initiate :ref:`memory mapped <mmap>`,
+:ref:`user pointer <userp>` or :ref:`DMABUF <dmabuf>` based I/O.
+Memory mapped buffers are located in device memory and must be allocated
+with this ioctl before they can be mapped into the application's address
+space. User buffers are allocated by applications themselves, and this
+ioctl is merely used to switch the driver into user pointer I/O mode and
+to setup some internal structures. Similarly, DMABUF buffers are
+allocated by applications through a device driver, and this ioctl only
+configures the driver into DMABUF I/O mode without performing any direct
+allocation.
+
+To allocate device buffers applications initialize all fields of the
+:c:type:`struct v4l2_requestbuffers` structure. They set the ``type``
+field to the respective stream or buffer type, the ``count`` field to
+the desired number of buffers, ``memory`` must be set to the requested
+I/O method and the ``reserved`` array must be zeroed. When the ioctl is
+called with a pointer to this structure the driver will attempt to
+allocate the requested number of buffers and it stores the actual number
+allocated in the ``count`` field. It can be smaller than the number
+requested, even zero, when the driver runs out of free memory. A larger
+number is also possible when the driver requires more buffers to
+function correctly. For example video output requires at least two
+buffers, one displayed and one filled by the application.
+
+When the I/O method is not supported the ioctl returns an EINVAL error
+code.
+
+Applications can call ``VIDIOC_REQBUFS`` again to change the number of
+buffers, however this cannot succeed when any buffers are still mapped.
+A ``count`` value of zero frees all buffers, after aborting or finishing
+any DMA in progress, an implicit
+:ref:`VIDIOC_STREAMOFF <vidioc-streamon>`.
+
+
+.. _v4l2-requestbuffers:
+
+.. flat-table:: struct v4l2_requestbuffers
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``count``
+
+       -  The number of buffers requested or granted.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``type``
+
+       -  Type of the stream or buffers, this is the same as the struct
+          :ref:`v4l2_format <v4l2-format>` ``type`` field. See
+          :ref:`v4l2-buf-type` for valid values.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``memory``
+
+       -  Applications set this field to ``V4L2_MEMORY_MMAP``,
+          ``V4L2_MEMORY_DMABUF`` or ``V4L2_MEMORY_USERPTR``. See
+          :ref:`v4l2-memory`.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``reserved``\ [2]
+
+       -  A place holder for future extensions. Drivers and applications
+          must set the array to zero.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The buffer type (``type`` field) or the requested I/O method
+    (``memory``) is not supported.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-s-hw-freq-seek.rst b/Documentation/linux_tv/media/v4l/vidioc-s-hw-freq-seek.rst
new file mode 100644
index 000000000000..72ae6ba6bada
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-s-hw-freq-seek.rst
@@ -0,0 +1,187 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-s-hw-freq-seek:
+
+***************************
+ioctl VIDIOC_S_HW_FREQ_SEEK
+***************************
+
+*man VIDIOC_S_HW_FREQ_SEEK(2)*
+
+Perform a hardware frequency seek
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_hw_freq_seek *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_S_HW_FREQ_SEEK
+
+``argp``
+
+
+Description
+===========
+
+Start a hardware frequency seek from the current frequency. To do this
+applications initialize the ``tuner``, ``type``, ``seek_upward``,
+``wrap_around``, ``spacing``, ``rangelow`` and ``rangehigh`` fields, and
+zero out the ``reserved`` array of a struct
+:ref:`v4l2_hw_freq_seek <v4l2-hw-freq-seek>` and call the
+``VIDIOC_S_HW_FREQ_SEEK`` ioctl with a pointer to this structure.
+
+The ``rangelow`` and ``rangehigh`` fields can be set to a non-zero value
+to tell the driver to search a specific band. If the struct
+:ref:`v4l2_tuner <v4l2-tuner>` ``capability`` field has the
+``V4L2_TUNER_CAP_HWSEEK_PROG_LIM`` flag set, these values must fall
+within one of the bands returned by
+:ref:`VIDIOC_ENUM_FREQ_BANDS <vidioc-enum-freq-bands>`. If the
+``V4L2_TUNER_CAP_HWSEEK_PROG_LIM`` flag is not set, then these values
+must exactly match those of one of the bands returned by
+:ref:`VIDIOC_ENUM_FREQ_BANDS <vidioc-enum-freq-bands>`. If the
+current frequency of the tuner does not fall within the selected band it
+will be clamped to fit in the band before the seek is started.
+
+If an error is returned, then the original frequency will be restored.
+
+This ioctl is supported if the ``V4L2_CAP_HW_FREQ_SEEK`` capability is
+set.
+
+If this ioctl is called from a non-blocking filehandle, then EAGAIN
+error code is returned and no seek takes place.
+
+
+.. _v4l2-hw-freq-seek:
+
+.. flat-table:: struct v4l2_hw_freq_seek
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``tuner``
+
+       -  The tuner index number. This is the same value as in the struct
+          :ref:`v4l2_input <v4l2-input>` ``tuner`` field and the struct
+          :ref:`v4l2_tuner <v4l2-tuner>` ``index`` field.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``type``
+
+       -  The tuner type. This is the same value as in the struct
+          :ref:`v4l2_tuner <v4l2-tuner>` ``type`` field. See
+          :ref:`v4l2-tuner-type`
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``seek_upward``
+
+       -  If non-zero, seek upward from the current frequency, else seek
+          downward.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``wrap_around``
+
+       -  If non-zero, wrap around when at the end of the frequency range,
+          else stop seeking. The struct :ref:`v4l2_tuner <v4l2-tuner>`
+          ``capability`` field will tell you what the hardware supports.
+
+    -  .. row 5
+
+       -  __u32
+
+       -  ``spacing``
+
+       -  If non-zero, defines the hardware seek resolution in Hz. The
+          driver selects the nearest value that is supported by the device.
+          If spacing is zero a reasonable default value is used.
+
+    -  .. row 6
+
+       -  __u32
+
+       -  ``rangelow``
+
+       -  If non-zero, the lowest tunable frequency of the band to search in
+          units of 62.5 kHz, or if the struct
+          :ref:`v4l2_tuner <v4l2-tuner>` ``capability`` field has the
+          ``V4L2_TUNER_CAP_LOW`` flag set, in units of 62.5 Hz or if the
+          struct :ref:`v4l2_tuner <v4l2-tuner>` ``capability`` field has
+          the ``V4L2_TUNER_CAP_1HZ`` flag set, in units of 1 Hz. If
+          ``rangelow`` is zero a reasonable default value is used.
+
+    -  .. row 7
+
+       -  __u32
+
+       -  ``rangehigh``
+
+       -  If non-zero, the highest tunable frequency of the band to search
+          in units of 62.5 kHz, or if the struct
+          :ref:`v4l2_tuner <v4l2-tuner>` ``capability`` field has the
+          ``V4L2_TUNER_CAP_LOW`` flag set, in units of 62.5 Hz or if the
+          struct :ref:`v4l2_tuner <v4l2-tuner>` ``capability`` field has
+          the ``V4L2_TUNER_CAP_1HZ`` flag set, in units of 1 Hz. If
+          ``rangehigh`` is zero a reasonable default value is used.
+
+    -  .. row 8
+
+       -  __u32
+
+       -  ``reserved``\ [5]
+
+       -  Reserved for future extensions. Applications must set the array to
+          zero.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The ``tuner`` index is out of bounds, the ``wrap_around`` value is
+    not supported or one of the values in the ``type``, ``rangelow`` or
+    ``rangehigh`` fields is wrong.
+
+EAGAIN
+    Attempted to call ``VIDIOC_S_HW_FREQ_SEEK`` with the filehandle in
+    non-blocking mode.
+
+ENODATA
+    The hardware seek found no channels.
+
+EBUSY
+    Another hardware seek is already in progress.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-streamon.rst b/Documentation/linux_tv/media/v4l/vidioc-streamon.rst
new file mode 100644
index 000000000000..0f7f6e00a759
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-streamon.rst
@@ -0,0 +1,111 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-streamon:
+
+***************************************
+ioctl VIDIOC_STREAMON, VIDIOC_STREAMOFF
+***************************************
+
+*man VIDIOC_STREAMON(2)*
+
+VIDIOC_STREAMOFF
+Start or stop streaming I/O
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, const int *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_STREAMON, VIDIOC_STREAMOFF
+
+``argp``
+
+
+Description
+===========
+
+The ``VIDIOC_STREAMON`` and ``VIDIOC_STREAMOFF`` ioctl start and stop
+the capture or output process during streaming
+(:ref:`memory mapping <mmap>`, :ref:`user pointer <userp>` or
+:ref:`DMABUF <dmabuf>`) I/O.
+
+Capture hardware is disabled and no input buffers are filled (if there
+are any empty buffers in the incoming queue) until ``VIDIOC_STREAMON``
+has been called. Output hardware is disabled and no video signal is
+produced until ``VIDIOC_STREAMON`` has been called. The ioctl will
+succeed when at least one output buffer is in the incoming queue.
+
+Memory-to-memory devices will not start until ``VIDIOC_STREAMON`` has
+been called for both the capture and output stream types.
+
+If ``VIDIOC_STREAMON`` fails then any already queued buffers will remain
+queued.
+
+The ``VIDIOC_STREAMOFF`` ioctl, apart of aborting or finishing any DMA
+in progress, unlocks any user pointer buffers locked in physical memory,
+and it removes all buffers from the incoming and outgoing queues. That
+means all images captured but not dequeued yet will be lost, likewise
+all images enqueued for output but not transmitted yet. I/O returns to
+the same state as after calling
+:ref:`VIDIOC_REQBUFS <vidioc-reqbufs>` and can be restarted
+accordingly.
+
+If buffers have been queued with :ref:`VIDIOC_QBUF <vidioc-qbuf>` and
+``VIDIOC_STREAMOFF`` is called without ever having called
+``VIDIOC_STREAMON``, then those queued buffers will also be removed from
+the incoming queue and all are returned to the same state as after
+calling :ref:`VIDIOC_REQBUFS <vidioc-reqbufs>` and can be restarted
+accordingly.
+
+Both ioctls take a pointer to an integer, the desired buffer or stream
+type. This is the same as struct
+:ref:`v4l2_requestbuffers <v4l2-requestbuffers>` ``type``.
+
+If ``VIDIOC_STREAMON`` is called when streaming is already in progress,
+or if ``VIDIOC_STREAMOFF`` is called when streaming is already stopped,
+then 0 is returned. Nothing happens in the case of ``VIDIOC_STREAMON``,
+but ``VIDIOC_STREAMOFF`` will return queued buffers to their starting
+state as mentioned above.
+
+Note that applications can be preempted for unknown periods right before
+or after the ``VIDIOC_STREAMON`` or ``VIDIOC_STREAMOFF`` calls, there is
+no notion of starting or stopping "now". Buffer timestamps can be used
+to synchronize with other events.
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The buffer ``type`` is not supported, or no buffers have been
+    allocated (memory mapping) or enqueued (output) yet.
+
+EPIPE
+    The driver implements
+    :ref:`pad-level format configuration <pad-level-formats>` and the
+    pipeline configuration is invalid.
+
+ENOLINK
+    The driver implements Media Controller interface and the pipeline
+    link configuration is invalid.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-subdev-enum-frame-interval.rst b/Documentation/linux_tv/media/v4l/vidioc-subdev-enum-frame-interval.rst
new file mode 100644
index 000000000000..87506d6b0e53
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-subdev-enum-frame-interval.rst
@@ -0,0 +1,161 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-subdev-enum-frame-interval:
+
+***************************************
+ioctl VIDIOC_SUBDEV_ENUM_FRAME_INTERVAL
+***************************************
+
+*man VIDIOC_SUBDEV_ENUM_FRAME_INTERVAL(2)*
+
+Enumerate frame intervals
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_subdev_frame_interval_enum * argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_SUBDEV_ENUM_FRAME_INTERVAL
+
+``argp``
+
+
+Description
+===========
+
+This ioctl lets applications enumerate available frame intervals on a
+given sub-device pad. Frame intervals only makes sense for sub-devices
+that can control the frame period on their own. This includes, for
+instance, image sensors and TV tuners.
+
+For the common use case of image sensors, the frame intervals available
+on the sub-device output pad depend on the frame format and size on the
+same pad. Applications must thus specify the desired format and size
+when enumerating frame intervals.
+
+To enumerate frame intervals applications initialize the ``index``,
+``pad``, ``which``, ``code``, ``width`` and ``height`` fields of struct
+:ref:`v4l2_subdev_frame_interval_enum <v4l2-subdev-frame-interval-enum>`
+and call the ``VIDIOC_SUBDEV_ENUM_FRAME_INTERVAL`` ioctl with a pointer
+to this structure. Drivers fill the rest of the structure or return an
+EINVAL error code if one of the input fields is invalid. All frame
+intervals are enumerable by beginning at index zero and incrementing by
+one until EINVAL is returned.
+
+Available frame intervals may depend on the current 'try' formats at
+other pads of the sub-device, as well as on the current active links.
+See :ref:`VIDIOC_SUBDEV_G_FMT <vidioc-subdev-g-fmt>` for more
+information about the try formats.
+
+Sub-devices that support the frame interval enumeration ioctl should
+implemented it on a single pad only. Its behaviour when supported on
+multiple pads of the same sub-device is not defined.
+
+
+.. _v4l2-subdev-frame-interval-enum:
+
+.. flat-table:: struct v4l2_subdev_frame_interval_enum
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``index``
+
+       -  Number of the format in the enumeration, set by the application.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``pad``
+
+       -  Pad number as reported by the media controller API.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``code``
+
+       -  The media bus format code, as defined in
+          :ref:`v4l2-mbus-format`.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``width``
+
+       -  Frame width, in pixels.
+
+    -  .. row 5
+
+       -  __u32
+
+       -  ``height``
+
+       -  Frame height, in pixels.
+
+    -  .. row 6
+
+       -  struct :ref:`v4l2_fract <v4l2-fract>`
+
+       -  ``interval``
+
+       -  Period, in seconds, between consecutive video frames.
+
+    -  .. row 7
+
+       -  __u32
+
+       -  ``which``
+
+       -  Frame intervals to be enumerated, from enum
+          :ref:`v4l2_subdev_format_whence <v4l2-subdev-format-whence>`.
+
+    -  .. row 8
+
+       -  __u32
+
+       -  ``reserved``\ [8]
+
+       -  Reserved for future extensions. Applications and drivers must set
+          the array to zero.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The struct
+    :ref:`v4l2_subdev_frame_interval_enum <v4l2-subdev-frame-interval-enum>`
+    ``pad`` references a non-existing pad, one of the ``code``,
+    ``width`` or ``height`` fields are invalid for the given pad or the
+    ``index`` field is out of bounds.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-subdev-enum-frame-size.rst b/Documentation/linux_tv/media/v4l/vidioc-subdev-enum-frame-size.rst
new file mode 100644
index 000000000000..7f867e2930be
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-subdev-enum-frame-size.rst
@@ -0,0 +1,170 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-subdev-enum-frame-size:
+
+***********************************
+ioctl VIDIOC_SUBDEV_ENUM_FRAME_SIZE
+***********************************
+
+*man VIDIOC_SUBDEV_ENUM_FRAME_SIZE(2)*
+
+Enumerate media bus frame sizes
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_subdev_frame_size_enum * argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_SUBDEV_ENUM_FRAME_SIZE
+
+``argp``
+
+
+Description
+===========
+
+This ioctl allows applications to enumerate all frame sizes supported by
+a sub-device on the given pad for the given media bus format. Supported
+formats can be retrieved with the
+:ref:`VIDIOC_SUBDEV_ENUM_MBUS_CODE <vidioc-subdev-enum-mbus-code>`
+ioctl.
+
+To enumerate frame sizes applications initialize the ``pad``, ``which``
+, ``code`` and ``index`` fields of the struct
+:ref:`v4l2_subdev_mbus_code_enum <v4l2-subdev-mbus-code-enum>` and
+call the ``VIDIOC_SUBDEV_ENUM_FRAME_SIZE`` ioctl with a pointer to the
+structure. Drivers fill the minimum and maximum frame sizes or return an
+EINVAL error code if one of the input parameters is invalid.
+
+Sub-devices that only support discrete frame sizes (such as most
+sensors) will return one or more frame sizes with identical minimum and
+maximum values.
+
+Not all possible sizes in given [minimum, maximum] ranges need to be
+supported. For instance, a scaler that uses a fixed-point scaling ratio
+might not be able to produce every frame size between the minimum and
+maximum values. Applications must use the
+:ref:`VIDIOC_SUBDEV_S_FMT <vidioc-subdev-g-fmt>` ioctl to try the
+sub-device for an exact supported frame size.
+
+Available frame sizes may depend on the current 'try' formats at other
+pads of the sub-device, as well as on the current active links and the
+current values of V4L2 controls. See
+:ref:`VIDIOC_SUBDEV_G_FMT <vidioc-subdev-g-fmt>` for more
+information about try formats.
+
+
+.. _v4l2-subdev-frame-size-enum:
+
+.. flat-table:: struct v4l2_subdev_frame_size_enum
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``index``
+
+       -  Number of the format in the enumeration, set by the application.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``pad``
+
+       -  Pad number as reported by the media controller API.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``code``
+
+       -  The media bus format code, as defined in
+          :ref:`v4l2-mbus-format`.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``min_width``
+
+       -  Minimum frame width, in pixels.
+
+    -  .. row 5
+
+       -  __u32
+
+       -  ``max_width``
+
+       -  Maximum frame width, in pixels.
+
+    -  .. row 6
+
+       -  __u32
+
+       -  ``min_height``
+
+       -  Minimum frame height, in pixels.
+
+    -  .. row 7
+
+       -  __u32
+
+       -  ``max_height``
+
+       -  Maximum frame height, in pixels.
+
+    -  .. row 8
+
+       -  __u32
+
+       -  ``which``
+
+       -  Frame sizes to be enumerated, from enum
+          :ref:`v4l2_subdev_format_whence <v4l2-subdev-format-whence>`.
+
+    -  .. row 9
+
+       -  __u32
+
+       -  ``reserved``\ [8]
+
+       -  Reserved for future extensions. Applications and drivers must set
+          the array to zero.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The struct
+    :ref:`v4l2_subdev_frame_size_enum <v4l2-subdev-frame-size-enum>`
+    ``pad`` references a non-existing pad, the ``code`` is invalid for
+    the given pad or the ``index`` field is out of bounds.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-subdev-enum-mbus-code.rst b/Documentation/linux_tv/media/v4l/vidioc-subdev-enum-mbus-code.rst
new file mode 100644
index 000000000000..97534457db6a
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-subdev-enum-mbus-code.rst
@@ -0,0 +1,123 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-subdev-enum-mbus-code:
+
+**********************************
+ioctl VIDIOC_SUBDEV_ENUM_MBUS_CODE
+**********************************
+
+*man VIDIOC_SUBDEV_ENUM_MBUS_CODE(2)*
+
+Enumerate media bus formats
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_subdev_mbus_code_enum * argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_SUBDEV_ENUM_MBUS_CODE
+
+``argp``
+
+
+Description
+===========
+
+To enumerate media bus formats available at a given sub-device pad
+applications initialize the ``pad``, ``which`` and ``index`` fields of
+struct
+:ref:`v4l2_subdev_mbus_code_enum <v4l2-subdev-mbus-code-enum>` and
+call the ``VIDIOC_SUBDEV_ENUM_MBUS_CODE`` ioctl with a pointer to this
+structure. Drivers fill the rest of the structure or return an EINVAL
+error code if either the ``pad`` or ``index`` are invalid. All media bus
+formats are enumerable by beginning at index zero and incrementing by
+one until EINVAL is returned.
+
+Available media bus formats may depend on the current 'try' formats at
+other pads of the sub-device, as well as on the current active links.
+See :ref:`VIDIOC_SUBDEV_G_FMT <vidioc-subdev-g-fmt>` for more
+information about the try formats.
+
+
+.. _v4l2-subdev-mbus-code-enum:
+
+.. flat-table:: struct v4l2_subdev_mbus_code_enum
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``pad``
+
+       -  Pad number as reported by the media controller API.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``index``
+
+       -  Number of the format in the enumeration, set by the application.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``code``
+
+       -  The media bus format code, as defined in
+          :ref:`v4l2-mbus-format`.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``which``
+
+       -  Media bus format codes to be enumerated, from enum
+          :ref:`v4l2_subdev_format_whence <v4l2-subdev-format-whence>`.
+
+    -  .. row 5
+
+       -  __u32
+
+       -  ``reserved``\ [8]
+
+       -  Reserved for future extensions. Applications and drivers must set
+          the array to zero.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EINVAL
+    The struct
+    :ref:`v4l2_subdev_mbus_code_enum <v4l2-subdev-mbus-code-enum>`
+    ``pad`` references a non-existing pad, or the ``index`` field is out
+    of bounds.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-subdev-g-crop.rst b/Documentation/linux_tv/media/v4l/vidioc-subdev-g-crop.rst
new file mode 100644
index 000000000000..e54a07c8ba1d
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-subdev-g-crop.rst
@@ -0,0 +1,145 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-subdev-g-crop:
+
+************************************************
+ioctl VIDIOC_SUBDEV_G_CROP, VIDIOC_SUBDEV_S_CROP
+************************************************
+
+*man VIDIOC_SUBDEV_G_CROP(2)*
+
+VIDIOC_SUBDEV_S_CROP
+Get or set the crop rectangle on a subdev pad
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_subdev_crop *argp )
+
+.. c:function:: int ioctl( int fd, int request, const struct v4l2_subdev_crop *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_SUBDEV_G_CROP, VIDIOC_SUBDEV_S_CROP
+
+``argp``
+
+
+Description
+===========
+
+    **Note**
+
+    This is an :ref:`obsolete <obsolete>` interface and may be removed
+    in the future. It is superseded by
+    :ref:`the selection API <vidioc-subdev-g-selection>`.
+
+To retrieve the current crop rectangle applications set the ``pad``
+field of a struct :ref:`v4l2_subdev_crop <v4l2-subdev-crop>` to the
+desired pad number as reported by the media API and the ``which`` field
+to ``V4L2_SUBDEV_FORMAT_ACTIVE``. They then call the
+``VIDIOC_SUBDEV_G_CROP`` ioctl with a pointer to this structure. The
+driver fills the members of the ``rect`` field or returns EINVAL error
+code if the input arguments are invalid, or if cropping is not supported
+on the given pad.
+
+To change the current crop rectangle applications set both the ``pad``
+and ``which`` fields and all members of the ``rect`` field. They then
+call the ``VIDIOC_SUBDEV_S_CROP`` ioctl with a pointer to this
+structure. The driver verifies the requested crop rectangle, adjusts it
+based on the hardware capabilities and configures the device. Upon
+return the struct :ref:`v4l2_subdev_crop <v4l2-subdev-crop>`
+contains the current format as would be returned by a
+``VIDIOC_SUBDEV_G_CROP`` call.
+
+Applications can query the device capabilities by setting the ``which``
+to ``V4L2_SUBDEV_FORMAT_TRY``. When set, 'try' crop rectangles are not
+applied to the device by the driver, but are mangled exactly as active
+crop rectangles and stored in the sub-device file handle. Two
+applications querying the same sub-device would thus not interact with
+each other.
+
+Drivers must not return an error solely because the requested crop
+rectangle doesn't match the device capabilities. They must instead
+modify the rectangle to match what the hardware can provide. The
+modified format should be as close as possible to the original request.
+
+
+.. _v4l2-subdev-crop:
+
+.. flat-table:: struct v4l2_subdev_crop
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``pad``
+
+       -  Pad number as reported by the media framework.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``which``
+
+       -  Crop rectangle to get or set, from enum
+          :ref:`v4l2_subdev_format_whence <v4l2-subdev-format-whence>`.
+
+    -  .. row 3
+
+       -  struct :ref:`v4l2_rect <v4l2-rect>`
+
+       -  ``rect``
+
+       -  Crop rectangle boundaries, in pixels.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``reserved``\ [8]
+
+       -  Reserved for future extensions. Applications and drivers must set
+          the array to zero.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EBUSY
+    The crop rectangle can't be changed because the pad is currently
+    busy. This can be caused, for instance, by an active video stream on
+    the pad. The ioctl must not be retried without performing another
+    action to fix the problem first. Only returned by
+    ``VIDIOC_SUBDEV_S_CROP``
+
+EINVAL
+    The struct :ref:`v4l2_subdev_crop <v4l2-subdev-crop>` ``pad``
+    references a non-existing pad, the ``which`` field references a
+    non-existing format, or cropping is not supported on the given
+    subdev pad.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-subdev-g-fmt.rst b/Documentation/linux_tv/media/v4l/vidioc-subdev-g-fmt.rst
new file mode 100644
index 000000000000..5dcbc03b4ffc
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-subdev-g-fmt.rst
@@ -0,0 +1,181 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-subdev-g-fmt:
+
+**********************************************
+ioctl VIDIOC_SUBDEV_G_FMT, VIDIOC_SUBDEV_S_FMT
+**********************************************
+
+*man VIDIOC_SUBDEV_G_FMT(2)*
+
+VIDIOC_SUBDEV_S_FMT
+Get or set the data format on a subdev pad
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_subdev_format *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_SUBDEV_G_FMT, VIDIOC_SUBDEV_S_FMT
+
+``argp``
+
+
+Description
+===========
+
+These ioctls are used to negotiate the frame format at specific subdev
+pads in the image pipeline.
+
+To retrieve the current format applications set the ``pad`` field of a
+struct :ref:`v4l2_subdev_format <v4l2-subdev-format>` to the desired
+pad number as reported by the media API and the ``which`` field to
+``V4L2_SUBDEV_FORMAT_ACTIVE``. When they call the
+``VIDIOC_SUBDEV_G_FMT`` ioctl with a pointer to this structure the
+driver fills the members of the ``format`` field.
+
+To change the current format applications set both the ``pad`` and
+``which`` fields and all members of the ``format`` field. When they call
+the ``VIDIOC_SUBDEV_S_FMT`` ioctl with a pointer to this structure the
+driver verifies the requested format, adjusts it based on the hardware
+capabilities and configures the device. Upon return the struct
+:ref:`v4l2_subdev_format <v4l2-subdev-format>` contains the current
+format as would be returned by a ``VIDIOC_SUBDEV_G_FMT`` call.
+
+Applications can query the device capabilities by setting the ``which``
+to ``V4L2_SUBDEV_FORMAT_TRY``. When set, 'try' formats are not applied
+to the device by the driver, but are changed exactly as active formats
+and stored in the sub-device file handle. Two applications querying the
+same sub-device would thus not interact with each other.
+
+For instance, to try a format at the output pad of a sub-device,
+applications would first set the try format at the sub-device input with
+the ``VIDIOC_SUBDEV_S_FMT`` ioctl. They would then either retrieve the
+default format at the output pad with the ``VIDIOC_SUBDEV_G_FMT`` ioctl,
+or set the desired output pad format with the ``VIDIOC_SUBDEV_S_FMT``
+ioctl and check the returned value.
+
+Try formats do not depend on active formats, but can depend on the
+current links configuration or sub-device controls value. For instance,
+a low-pass noise filter might crop pixels at the frame boundaries,
+modifying its output frame size.
+
+Drivers must not return an error solely because the requested format
+doesn't match the device capabilities. They must instead modify the
+format to match what the hardware can provide. The modified format
+should be as close as possible to the original request.
+
+
+.. _v4l2-subdev-format:
+
+.. flat-table:: struct v4l2_subdev_format
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``pad``
+
+       -  Pad number as reported by the media controller API.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``which``
+
+       -  Format to modified, from enum
+          :ref:`v4l2_subdev_format_whence <v4l2-subdev-format-whence>`.
+
+    -  .. row 3
+
+       -  struct :ref:`v4l2_mbus_framefmt <v4l2-mbus-framefmt>`
+
+       -  ``format``
+
+       -  Definition of an image format, see :ref:`v4l2-mbus-framefmt` for
+          details.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``reserved``\ [8]
+
+       -  Reserved for future extensions. Applications and drivers must set
+          the array to zero.
+
+
+
+.. _v4l2-subdev-format-whence:
+
+.. flat-table:: enum v4l2_subdev_format_whence
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  V4L2_SUBDEV_FORMAT_TRY
+
+       -  0
+
+       -  Try formats, used for querying device capabilities.
+
+    -  .. row 2
+
+       -  V4L2_SUBDEV_FORMAT_ACTIVE
+
+       -  1
+
+       -  Active formats, applied to the hardware.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EBUSY
+    The format can't be changed because the pad is currently busy. This
+    can be caused, for instance, by an active video stream on the pad.
+    The ioctl must not be retried without performing another action to
+    fix the problem first. Only returned by ``VIDIOC_SUBDEV_S_FMT``
+
+EINVAL
+    The struct :ref:`v4l2_subdev_format <v4l2-subdev-format>`
+    ``pad`` references a non-existing pad, or the ``which`` field
+    references a non-existing format.
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-subdev-g-frame-interval.rst b/Documentation/linux_tv/media/v4l/vidioc-subdev-g-frame-interval.rst
new file mode 100644
index 000000000000..af0918900f8a
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-subdev-g-frame-interval.rst
@@ -0,0 +1,131 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-subdev-g-frame-interval:
+
+********************************************************************
+ioctl VIDIOC_SUBDEV_G_FRAME_INTERVAL, VIDIOC_SUBDEV_S_FRAME_INTERVAL
+********************************************************************
+
+*man VIDIOC_SUBDEV_G_FRAME_INTERVAL(2)*
+
+VIDIOC_SUBDEV_S_FRAME_INTERVAL
+Get or set the frame interval on a subdev pad
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_subdev_frame_interval *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_SUBDEV_G_FRAME_INTERVAL,
+    VIDIOC_SUBDEV_S_FRAME_INTERVAL
+
+``argp``
+
+
+Description
+===========
+
+These ioctls are used to get and set the frame interval at specific
+subdev pads in the image pipeline. The frame interval only makes sense
+for sub-devices that can control the frame period on their own. This
+includes, for instance, image sensors and TV tuners. Sub-devices that
+don't support frame intervals must not implement these ioctls.
+
+To retrieve the current frame interval applications set the ``pad``
+field of a struct
+:ref:`v4l2_subdev_frame_interval <v4l2-subdev-frame-interval>` to
+the desired pad number as reported by the media controller API. When
+they call the ``VIDIOC_SUBDEV_G_FRAME_INTERVAL`` ioctl with a pointer to
+this structure the driver fills the members of the ``interval`` field.
+
+To change the current frame interval applications set both the ``pad``
+field and all members of the ``interval`` field. When they call the
+``VIDIOC_SUBDEV_S_FRAME_INTERVAL`` ioctl with a pointer to this
+structure the driver verifies the requested interval, adjusts it based
+on the hardware capabilities and configures the device. Upon return the
+struct
+:ref:`v4l2_subdev_frame_interval <v4l2-subdev-frame-interval>`
+contains the current frame interval as would be returned by a
+``VIDIOC_SUBDEV_G_FRAME_INTERVAL`` call.
+
+Drivers must not return an error solely because the requested interval
+doesn't match the device capabilities. They must instead modify the
+interval to match what the hardware can provide. The modified interval
+should be as close as possible to the original request.
+
+Sub-devices that support the frame interval ioctls should implement them
+on a single pad only. Their behaviour when supported on multiple pads of
+the same sub-device is not defined.
+
+
+.. _v4l2-subdev-frame-interval:
+
+.. flat-table:: struct v4l2_subdev_frame_interval
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``pad``
+
+       -  Pad number as reported by the media controller API.
+
+    -  .. row 2
+
+       -  struct :ref:`v4l2_fract <v4l2-fract>`
+
+       -  ``interval``
+
+       -  Period, in seconds, between consecutive video frames.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``reserved``\ [9]
+
+       -  Reserved for future extensions. Applications and drivers must set
+          the array to zero.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EBUSY
+    The frame interval can't be changed because the pad is currently
+    busy. This can be caused, for instance, by an active video stream on
+    the pad. The ioctl must not be retried without performing another
+    action to fix the problem first. Only returned by
+    ``VIDIOC_SUBDEV_S_FRAME_INTERVAL``
+
+EINVAL
+    The struct
+    :ref:`v4l2_subdev_frame_interval <v4l2-subdev-frame-interval>`
+    ``pad`` references a non-existing pad, or the pad doesn't support
+    frame intervals.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-subdev-g-selection.rst b/Documentation/linux_tv/media/v4l/vidioc-subdev-g-selection.rst
new file mode 100644
index 000000000000..8e4c8e10494e
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-subdev-g-selection.rst
@@ -0,0 +1,153 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-subdev-g-selection:
+
+**********************************************************
+ioctl VIDIOC_SUBDEV_G_SELECTION, VIDIOC_SUBDEV_S_SELECTION
+**********************************************************
+
+*man VIDIOC_SUBDEV_G_SELECTION(2)*
+
+VIDIOC_SUBDEV_S_SELECTION
+Get or set selection rectangles on a subdev pad
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_subdev_selection *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_SUBDEV_G_SELECTION, VIDIOC_SUBDEV_S_SELECTION
+
+``argp``
+
+
+Description
+===========
+
+The selections are used to configure various image processing
+functionality performed by the subdevs which affect the image size. This
+currently includes cropping, scaling and composition.
+
+The selection API replaces
+:ref:`the old subdev crop API <vidioc-subdev-g-crop>`. All the
+function of the crop API, and more, are supported by the selections API.
+
+See :ref:`subdev` for more information on how each selection target
+affects the image processing pipeline inside the subdevice.
+
+
+Types of selection targets
+--------------------------
+
+There are two types of selection targets: actual and bounds. The actual
+targets are the targets which configure the hardware. The BOUNDS target
+will return a rectangle that contain all possible actual rectangles.
+
+
+Discovering supported features
+------------------------------
+
+To discover which targets are supported, the user can perform
+``VIDIOC_SUBDEV_G_SELECTION`` on them. Any unsupported target will
+return ``EINVAL``.
+
+Selection targets and flags are documented in
+:ref:`v4l2-selections-common`.
+
+
+.. _v4l2-subdev-selection:
+
+.. flat-table:: struct v4l2_subdev_selection
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``which``
+
+       -  Active or try selection, from enum
+          :ref:`v4l2_subdev_format_whence <v4l2-subdev-format-whence>`.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``pad``
+
+       -  Pad number as reported by the media framework.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``target``
+
+       -  Target selection rectangle. See :ref:`v4l2-selections-common`.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``flags``
+
+       -  Flags. See :ref:`v4l2-selection-flags`.
+
+    -  .. row 5
+
+       -  struct :ref:`v4l2_rect <v4l2-rect>`
+
+       -  ``r``
+
+       -  Selection rectangle, in pixels.
+
+    -  .. row 6
+
+       -  __u32
+
+       -  ``reserved``\ [8]
+
+       -  Reserved for future extensions. Applications and drivers must set
+          the array to zero.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+EBUSY
+    The selection rectangle can't be changed because the pad is
+    currently busy. This can be caused, for instance, by an active video
+    stream on the pad. The ioctl must not be retried without performing
+    another action to fix the problem first. Only returned by
+    ``VIDIOC_SUBDEV_S_SELECTION``
+
+EINVAL
+    The struct :ref:`v4l2_subdev_selection <v4l2-subdev-selection>`
+    ``pad`` references a non-existing pad, the ``which`` field
+    references a non-existing format, or the selection target is not
+    supported on the given subdev pad.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/vidioc-subscribe-event.rst b/Documentation/linux_tv/media/v4l/vidioc-subscribe-event.rst
new file mode 100644
index 000000000000..f12981c38f63
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/vidioc-subscribe-event.rst
@@ -0,0 +1,144 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _vidioc-subscribe-event:
+
+******************************************************
+ioctl VIDIOC_SUBSCRIBE_EVENT, VIDIOC_UNSUBSCRIBE_EVENT
+******************************************************
+
+*man VIDIOC_SUBSCRIBE_EVENT(2)*
+
+VIDIOC_UNSUBSCRIBE_EVENT
+Subscribe or unsubscribe event
+
+
+Synopsis
+========
+
+.. c:function:: int ioctl( int fd, int request, struct v4l2_event_subscription *argp )
+
+Arguments
+=========
+
+``fd``
+    File descriptor returned by :ref:`open() <func-open>`.
+
+``request``
+    VIDIOC_SUBSCRIBE_EVENT, VIDIOC_UNSUBSCRIBE_EVENT
+
+``argp``
+
+
+Description
+===========
+
+Subscribe or unsubscribe V4L2 event. Subscribed events are dequeued by
+using the :ref:`VIDIOC_DQEVENT <vidioc-dqevent>` ioctl.
+
+
+.. _v4l2-event-subscription:
+
+.. flat-table:: struct v4l2_event_subscription
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       1 1 2
+
+
+    -  .. row 1
+
+       -  __u32
+
+       -  ``type``
+
+       -  Type of the event, see :ref:`event-type`. Note that
+          ``V4L2_EVENT_ALL`` can be used with VIDIOC_UNSUBSCRIBE_EVENT for
+          unsubscribing all events at once.
+
+    -  .. row 2
+
+       -  __u32
+
+       -  ``id``
+
+       -  ID of the event source. If there is no ID associated with the
+          event source, then set this to 0. Whether or not an event needs an
+          ID depends on the event type.
+
+    -  .. row 3
+
+       -  __u32
+
+       -  ``flags``
+
+       -  Event flags, see :ref:`event-flags`.
+
+    -  .. row 4
+
+       -  __u32
+
+       -  ``reserved``\ [5]
+
+       -  Reserved for future extensions. Drivers and applications must set
+          the array to zero.
+
+
+
+.. _event-flags:
+
+.. flat-table:: Event Flags
+    :header-rows:  0
+    :stub-columns: 0
+    :widths:       3 1 4
+
+
+    -  .. row 1
+
+       -  ``V4L2_EVENT_SUB_FL_SEND_INITIAL``
+
+       -  0x0001
+
+       -  When this event is subscribed an initial event will be sent
+          containing the current status. This only makes sense for events
+          that are triggered by a status change such as ``V4L2_EVENT_CTRL``.
+          Other events will ignore this flag.
+
+    -  .. row 2
+
+       -  ``V4L2_EVENT_SUB_FL_ALLOW_FEEDBACK``
+
+       -  0x0002
+
+       -  If set, then events directly caused by an ioctl will also be sent
+          to the filehandle that called that ioctl. For example, changing a
+          control using :ref:`VIDIOC_S_CTRL <vidioc-g-ctrl>` will cause
+          a V4L2_EVENT_CTRL to be sent back to that same filehandle.
+          Normally such events are suppressed to prevent feedback loops
+          where an application changes a control to a one value and then
+          another, and then receives an event telling it that that control
+          has changed to the first value.
+
+          Since it can't tell whether that event was caused by another
+          application or by the :ref:`VIDIOC_S_CTRL <vidioc-g-ctrl>`
+          call it is hard to decide whether to set the control to the value
+          in the event, or ignore it.
+
+          Think carefully when you set this flag so you won't get into
+          situations like that.
+
+
+
+Return Value
+============
+
+On success 0 is returned, on error -1 and the ``errno`` variable is set
+appropriately. The generic error codes are described at the
+:ref:`Generic Error Codes <gen-errors>` chapter.
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media/v4l/yuv-formats.rst b/Documentation/linux_tv/media/v4l/yuv-formats.rst
new file mode 100644
index 000000000000..2592d5b8527d
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/yuv-formats.rst
@@ -0,0 +1,66 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+.. _yuv-formats:
+
+***********
+YUV Formats
+***********
+
+YUV is the format native to TV broadcast and composite video signals. It
+separates the brightness information (Y) from the color information (U
+and V or Cb and Cr). The color information consists of red and blue
+*color difference* signals, this way the green component can be
+reconstructed by subtracting from the brightness component. See
+:ref:`colorspaces` for conversion examples. YUV was chosen because
+early television would only transmit brightness information. To add
+color in a way compatible with existing receivers a new signal carrier
+was added to transmit the color difference signals. Secondary in the YUV
+format the U and V components usually have lower resolution than the Y
+component. This is an analog video compression technique taking
+advantage of a property of the human visual system, being more sensitive
+to brightness information.
+
+
+.. toctree::
+    :maxdepth: 1
+
+    pixfmt-packed-yuv
+    pixfmt-grey
+    pixfmt-y10
+    pixfmt-y12
+    pixfmt-y10b
+    pixfmt-y16
+    pixfmt-y16-be
+    pixfmt-y8i
+    pixfmt-y12i
+    pixfmt-uv8
+    pixfmt-yuyv
+    pixfmt-uyvy
+    pixfmt-yvyu
+    pixfmt-vyuy
+    pixfmt-y41p
+    pixfmt-yuv420
+    pixfmt-yuv420m
+    pixfmt-yuv422m
+    pixfmt-yuv444m
+    pixfmt-yuv410
+    pixfmt-yuv422p
+    pixfmt-yuv411p
+    pixfmt-nv12
+    pixfmt-nv12m
+    pixfmt-nv12mt
+    pixfmt-nv16
+    pixfmt-nv16m
+    pixfmt-nv24
+    pixfmt-m420
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/media_api_files/typical_media_device.pdf b/Documentation/linux_tv/media_api_files/typical_media_device.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..eb30458138157e452e701af0bce24d00dd2e17f6
GIT binary patch
literal 134268
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%0A5po-k-DEWkkh1nOhUAMv?^
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

literal 0
HcmV?d00001

diff --git a/Documentation/linux_tv/media_api_files/typical_media_device.svg b/Documentation/linux_tv/media_api_files/typical_media_device.svg
new file mode 100644
index 000000000000..f0c82f72c4b6
--- /dev/null
+++ b/Documentation/linux_tv/media_api_files/typical_media_device.svg
@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg stroke-linejoin="round" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns="http://www.w3.org/2000/svg" clip-path="url(#a)" xml:space="preserve" fill-rule="evenodd" height="178.78mm" viewBox="0 0 24285.662 17877.829" width="251.99mm" version="1.2" xmlns:cc="http://creativecommons.org/ns#" xmlns:dc="http://purl.org/dc/elements/1.1/" preserveAspectRatio="xMidYMid" stroke-width="28.222"><defs><clipPath id="a" clipPathUnits="userSpaceOnUse"><rect y="0" x="0" width="28000" height="21000"/></clipPath></defs><g transform="matrix(1.004 0 0 1 -2185.6 -2186)" class="com.sun.star.drawing.CustomShape"><path fill="#fcf" d="m12231 4800c-516 0-1031 515-1031 1031v4124c0 516 515 1032 1031 1032h8538c516 0 1032-516 1032-1032v-4124c0-516-516-1031-1032-1031h-8538z"/></g><g transform="translate(-2140.9 -2186)" class="com.sun.star.drawing.CustomShape"><path fill="#ffc" d="m3595 15607c-293 0-585 292-585 585v2340c0 293 292 586 585 586h3275c293 0 586-293 586-586v-2340c0-293-293-585-586-585h-3275z"/></g><g transform="translate(-2197.3 -2186)" class="com.sun.star.drawing.CustomShape"><path fill="#e6e6e6" d="m2663 2186c-461 0-922 461-922 922v11169c0 461 461 923 922 923h3692c461 0 922-462 922-923v-11169c0-461-461-922-922-922h-3692z"/></g><g transform="translate(-2140.9 -2186)" class="com.sun.star.drawing.RectangleShape"><path fill="#ff8080" d="m4461 8602h-2260v-1086h4520v1086h-2260z"/><path fill="none" d="m4461 8602h-2260v-1086h4520v1086h-2260z" stroke="#3465af"/><text class="TextShape"><tspan font-size="635px" font-family="&apos;Times New Roman&apos;, serif" font-weight="400" class="TextParagraph"><tspan y="8275" x="2579" class="TextPosition"><tspan fill="#000000">Audio decoder</tspan></tspan></tspan></text>
+</g><g transform="translate(-2140.9 -2186)" class="com.sun.star.drawing.RectangleShape"><path fill="#ff8080" d="m4461 11772h-2260v-1270h4520v1270h-2260z"/><path fill="none" d="m4461 11772h-2260v-1270h4520v1270h-2260z" stroke="#3465af"/><text class="TextShape"><tspan font-size="635px" font-family="&apos;Times New Roman&apos;, serif" font-weight="400" class="TextParagraph"><tspan y="11353" x="2617" class="TextPosition"><tspan fill="#000000">Video decoder</tspan></tspan></tspan></text>
+</g><g transform="translate(-2140.9 -2186)" class="com.sun.star.drawing.RectangleShape"><path fill="#ff8080" d="m4453 10217h-2269v-1224h4537v1224h-2268z"/><path fill="none" d="m4453 10217h-2269v-1224h4537v1224h-2268z" stroke="#3465af"/><text class="TextShape"><tspan font-size="635px" font-family="&apos;Times New Roman&apos;, serif" font-weight="400" class="TextParagraph"><tspan y="9821" x="2571" class="TextPosition"><tspan fill="#000000">Audio encoder</tspan></tspan></tspan></text>
+</g><g transform="translate(-2140.9 -2468.2)" class="com.sun.star.drawing.RectangleShape"><path fill="#cfc" d="m15711 12832h-3810v-1281h7620v1281h-3810z"/><path fill="none" d="m15711 12832h-3810v-1281h7620v1281h-3810z" stroke="#3465af"/><text class="TextShape"><tspan font-size="635px" font-family="&apos;Times New Roman&apos;, serif" font-weight="400" class="TextParagraph"><tspan y="12407" x="12377" class="TextPosition"><tspan fill="#000000">Button Key/IR input logic</tspan></tspan></tspan></text>
+</g><g transform="translate(-2140.9 -2411.8)" class="com.sun.star.drawing.RectangleShape"><path fill="#cfe7f5" d="m14169 14572h-2268v-1412h4536v1412h-2268z"/><path fill="none" d="m14169 14572h-2268v-1412h4536v1412h-2268z" stroke="#3465af"/><text class="TextShape"><tspan font-size="635px" font-family="&apos;Times New Roman&apos;, serif" font-weight="400" class="TextParagraph"><tspan y="14082" x="12882" class="TextPosition"><tspan fill="#000000">EEPROM</tspan></tspan></tspan></text>
+</g><g transform="translate(-2140.9 -2186)" class="com.sun.star.drawing.RectangleShape"><path fill="#fc9" d="m5140 17662h-1563v-1715h3126v1715h-1563z"/><path fill="none" d="m5140 17662h-1563v-1715h3126v1715h-1563z" stroke="#3465af"/><text class="TextShape"><tspan font-size="635px" font-family="&apos;Times New Roman&apos;, serif" font-weight="400" class="TextParagraph"><tspan y="17020" x="4276" class="TextPosition"><tspan fill="#000000">Sensor</tspan></tspan></tspan></text>
+</g><g transform="translate(-2140.9 -2186)" class="com.sun.star.drawing.CustomShape"><path fill="#729fcf" d="m6719 8030 385-353v176h1167v-176l386 353-386 354v-177h-1167v177l-385-354z"/><path fill="none" d="m6719 8030 385-353v176h1167v-176l386 353-386 354v-177h-1167v177l-385-354z" stroke="#3465af"/></g><g transform="translate(-2140.9 -2186)" class="com.sun.star.drawing.CustomShape"><path fill="#729fcf" d="m6719 9612 385-353v176h1167v-176l386 353-386 354v-177h-1167v177l-385-354z"/><path fill="none" d="m6719 9612 385-353v176h1167v-176l386 353-386 354v-177h-1167v177l-385-354z" stroke="#3465af"/></g><g transform="translate(-2140.9 -2186)" class="com.sun.star.drawing.CustomShape"><path fill="#729fcf" d="m6721 11100 385-353v176h1166v-176l386 353-386 354v-177h-1166v177l-385-354z"/><path fill="none" d="m6721 11100 385-353v176h1166v-176l386 353-386 354v-177h-1166v177l-385-354z" stroke="#3465af"/></g><g transform="translate(-2140.9 -2411.8)" class="com.sun.star.drawing.CustomShape"><path fill="#729fcf" d="m9962 13854 385-353v176h1166v-176l386 353-386 354v-177h-1166v177l-385-354z"/><path fill="none" d="m9962 13854 385-353v176h1166v-176l386 353-386 354v-177h-1166v177l-385-354z" stroke="#3465af"/></g><g transform="translate(-2140.9 -2468.2)" class="com.sun.star.drawing.CustomShape"><path fill="#729fcf" d="m9962 12163 385-353v176h1166v-176l386 353-386 354v-177h-1166v177l-385-354z"/><path fill="none" d="m9962 12163 385-353v176h1166v-176l386 353-386 354v-177h-1166v177l-385-354z" stroke="#3465af"/></g><g transform="translate(-2140.9 -2186)" class="com.sun.star.drawing.CustomShape"><path fill="#729fcf" d="m9962 17158 670-353v176h2028v-176l671 353-671 354v-177h-2028v177l-670-354z"/><path fill="none" d="m9962 17158 670-353v176h2028v-176l671 353-671 354v-177h-2028v177l-670-354z" stroke="#3465af"/></g><g transform="matrix(0 .83339 -1.0005 0 30268 -5276.3)" class="com.sun.star.drawing.CustomShape"><path fill="#729fcf" d="m23229 12779 1009-978 1009 978h-505v2959h505l-1009 979-1009-979h504v-2959h-504z"/><path fill="none" d="m23229 12779 1009-978 1009 978h-505v2959h505l-1009 979-1009-979h504v-2959h-504z" stroke="#3465af"/></g><g transform="translate(-9973.6 -666.6)" class="com.sun.star.drawing.TextShape"><text class="TextShape"><tspan font-size="706px" font-family="&apos;Times New Roman&apos;, serif" font-weight="400" class="TextParagraph"><tspan y="15832" x="24341" class="TextPosition" transform="matrix(0,-1,1,0,8509,40173)"><tspan fill="#000000">System Bus</tspan></tspan></tspan></text>
+</g><g transform="translate(-2140.9 -2186)" class="com.sun.star.drawing.RectangleShape"><path fill="#cff" d="m13151 9262h-1250v-875h2499v875h-1249z"/><path fill="none" d="m13151 9262h-1250v-875h2499v875h-1249z" stroke="#3465af"/><text class="TextShape"><tspan font-size="635px" font-family="&apos;Times New Roman&apos;, serif" font-weight="400" class="TextParagraph"><tspan y="9040" x="12215" class="TextPosition"><tspan fill="#000000">Demux</tspan></tspan></tspan></text>
+</g><g transform="translate(-2140.9 -2186)" class="com.sun.star.drawing.CustomShape"><path fill="#729fcf" d="m9996 8765 373-357v178h1130v-178l374 357-374 358v-179h-1130v179l-373-358z"/><path fill="none" d="m9996 8765 373-357v178h1130v-178l374 357-374 358v-179h-1130v179l-373-358z" stroke="#3465af"/></g><g transform="translate(-2140.9 -2186)" class="com.sun.star.drawing.CustomShape"><path fill="#729fcf" d="m9996 7378 373-358v179h1130v-179l374 358-374 358v-179h-1130v179l-373-358z"/><path fill="none" d="m9996 7378 373-358v179h1130v-179l374 358-374 358v-179h-1130v179l-373-358z" stroke="#3465af"/></g><g transform="translate(-2140.9 -2186)" class="com.sun.star.drawing.RectangleShape"><path fill="#cff" d="m16322 7992h-4421v-1270h8841v1270h-4420z"/><path fill="none" d="m16322 7992h-4421v-1270h8841v1270h-4420z" stroke="#3465af"/><text class="TextShape"><tspan font-size="635px" font-family="&apos;Times New Roman&apos;, serif" font-weight="400" class="TextParagraph"><tspan y="7573" x="12786" class="TextPosition"><tspan fill="#000000">Conditional Access Module</tspan></tspan></tspan></text>
+</g><g transform="translate(-2140.9 -2186)" class="com.sun.star.drawing.RectangleShape"><path fill="#ff8080" d="m4445 13287h-2269v-1224h4537v1224h-2268z"/><path fill="none" d="m4445 13287h-2269v-1224h4537v1224h-2268z" stroke="#3465af"/><text class="TextShape"><tspan font-size="635px" font-family="&apos;Times New Roman&apos;, serif" font-weight="400" class="TextParagraph"><tspan y="12891" x="2601" class="TextPosition"><tspan fill="#000000">Video encoder</tspan></tspan></tspan></text>
+</g><g transform="translate(-2140.9 -2186)" class="com.sun.star.drawing.CustomShape"><path fill="#729fcf" d="m6721 12634 385-353v176h1166v-176l386 353-386 354v-177h-1166v177l-385-354z"/><path fill="none" d="m6721 12634 385-353v176h1166v-176l386 353-386 354v-177h-1166v177l-385-354z" stroke="#3465af"/></g><g transform="translate(-2140.9 -2186)" class="com.sun.star.drawing.CustomShape"><path fill="#729fcf" d="m20791 7545 385-353v176h1166v-176l386 353-386 354v-177h-1166v177l-385-354z"/><path fill="none" d="m20791 7545 385-353v176h1166v-176l386 353-386 354v-177h-1166v177l-385-354z" stroke="#3465af"/></g><g transform="translate(-2028 -2186)" class="com.sun.star.drawing.TextShape"><text class="TextShape"><tspan font-size="635px" font-family="&apos;Times New Roman&apos;, serif" font-weight="400" class="TextParagraph"><tspan y="14478" x="1990" class="TextPosition"><tspan fill="#000000">Radio / Analog TV</tspan></tspan></tspan></text>
+</g><g transform="translate(-2140.9 -2186)" class="com.sun.star.drawing.TextShape"><text class="TextShape"><tspan font-size="635px" font-family="&apos;Times New Roman&apos;, serif" font-weight="700" class="TextParagraph"><tspan y="10724" x="14956" class="TextPosition"><tspan fill="#000000">Digital TV</tspan></tspan></tspan></text>
+</g><g transform="translate(-8970.5 -1395.8)" class="com.sun.star.drawing.TextShape"><text class="TextShape"><tspan font-size="494px" font-family="&apos;Times New Roman&apos;, serif" font-weight="400" class="TextParagraph"><tspan y="19167" x="14724" class="TextPosition"><tspan fill="#000000">PS.: picture is not complete: other blocks may be present</tspan></tspan></tspan></text>
+</g><g transform="translate(-2140.9 -2186)" class="com.sun.star.drawing.TextShape"><text class="TextShape"><tspan font-size="635px" font-family="&apos;Times New Roman&apos;, serif" font-weight="400" class="TextParagraph"><tspan y="18561" x="4199" class="TextPosition"><tspan fill="#000000">Webcam</tspan></tspan></tspan></text>
+</g><g transform="translate(-2140.9 -2468.2)" class="com.sun.star.drawing.RectangleShape"><path fill="#f90" d="m14552 16372h-2650v-1412h5299v1412h-2649z"/><path fill="none" d="m14552 16372h-2650v-1412h5299v1412h-2649z" stroke="#3465af"/><text class="TextShape"><tspan font-size="635px" font-family="&apos;Times New Roman&apos;, serif" font-weight="400" class="TextParagraph"><tspan y="15882" x="12265" class="TextPosition"><tspan fill="#000000">Processing blocks</tspan></tspan></tspan></text>
+</g><g transform="translate(-2140.9 -2468.2)" class="com.sun.star.drawing.CustomShape"><path fill="#729fcf" d="m9962 15654 385-353v176h1166v-176l386 353-386 354v-177h-1166v177l-385-354z"/><path fill="none" d="m9962 15654 385-353v176h1166v-176l386 353-386 354v-177h-1166v177l-385-354z" stroke="#3465af"/></g><g transform="translate(-2140.9 -2186)" class="com.sun.star.drawing.CustomShape"><path fill="#729fcf" d="m6702 16954 397-353v176h1201v-176l398 353-398 354v-177h-1201v177l-397-354z"/><path fill="none" d="m6702 16954 397-353v176h1201v-176l398 353-398 354v-177h-1201v177l-397-354z" stroke="#3465af"/></g><g transform="translate(-2479.5 -2186)" class="com.sun.star.drawing.TextShape"><text class="TextShape"><tspan font-size="635px" font-family="&apos;Times New Roman&apos;, serif" font-weight="400" class="TextParagraph"><tspan y="8792" x="22850" class="TextPosition"><tspan fill="#000000">Smartcard</tspan></tspan></tspan></text>
+</g><g transform="matrix(1.0048 0 0 1 -2207.4 -2186)" class="com.sun.star.drawing.CustomShape"><path fill="#fcf" d="m2766 2600c-333 0-666 333-666 666v2668c0 333 333 666 666 666h18368c333 0 667-333 667-666v-2668c0-333-334-666-667-666h-18368z"/></g><g transform="translate(-2140.9 -2186)" class="com.sun.star.drawing.RectangleShape"><path fill="#ff8080" d="m5121 5155h-1614v-1816h3227v1816h-1613z"/><path fill="none" d="m5121 5155h-1614v-1816h3227v1816h-1613z" stroke="#3465af"/><text font-size="635px" font-family="&apos;Times New Roman&apos;, serif" font-weight="400" class="TextShape"><tspan class="TextParagraph"><tspan y="4111" x="4374" class="TextPosition"><tspan fill="#000000">Tuner</tspan></tspan></tspan><tspan class="TextParagraph"><tspan y="4814" x="4151" class="TextPosition"><tspan fill="#000000">FM/TV</tspan></tspan></tspan></text>
+</g><g transform="translate(-2140.9 -2186)" class="com.sun.star.drawing.CustomShape"><path fill="#ff8080" d="m2902 3702c0 111 40 202 88 202h530c48 0 89-91 89-202 0-110-41-202-89-202h-530c-48 0-88 92-88 202z"/><path fill="none" d="m2902 3702c0 111 40 202 88 202h530c48 0 89-91 89-202 0-110-41-202-89-202h-530c-48 0-88 92-88 202z" stroke="#3465af"/><path fill="#ffb3b3" d="m2902 3702c0 111 40 202 88 202s88-91 88-202c0-110-40-202-88-202s-88 92-88 202z"/><path fill="none" d="m2902 3702c0 111 40 202 88 202s88-91 88-202c0-110-40-202-88-202s-88 92-88 202z" stroke="#3465af"/></g><g transform="translate(-2140.9 -2186)" class="com.sun.star.drawing.CustomShape"><path fill="#ff8080" d="m2903 4267c0 110 40 202 88 202h530c48 0 89-92 89-202s-41-203-89-203h-530c-48 0-88 93-88 203z"/><path fill="none" d="m2903 4267c0 110 40 202 88 202h530c48 0 89-92 89-202s-41-203-89-203h-530c-48 0-88 93-88 203z" stroke="#3465af"/><path fill="#ffb3b3" d="m2903 4267c0 110 40 202 88 202s88-92 88-202-40-203-88-203-88 93-88 203z"/><path fill="none" d="m2903 4267c0 110 40 202 88 202s88-92 88-202-40-203-88-203-88 93-88 203z" stroke="#3465af"/></g><g transform="translate(-2140.9 -2186)" class="com.sun.star.drawing.CustomShape"><path fill="#729fcf" d="m6719 4196 385-353v176h1167v-176l386 353-386 354v-177h-1167v177l-385-354z"/><path fill="none" d="m6719 4196 385-353v176h1167v-176l386 353-386 354v-177h-1167v177l-385-354z" stroke="#3465af"/></g><g transform="translate(-2140.9 -2186)" class="com.sun.star.drawing.CustomShape"><path fill="#729fcf" d="m9979 4150 402-368v184h1217v-184l403 368-403 369v-185h-1217v185l-402-369z"/><path fill="none" d="m9979 4150 402-368v184h1217v-184l403 368-403 369v-185h-1217v185l-402-369z" stroke="#3465af"/></g><g transform="translate(-2140.9 -2186)" class="com.sun.star.drawing.RectangleShape"><path fill="#cff" d="m16500 6189h-4500v-1389h9e3v1389h-4500z"/><path fill="none" d="m16500 6189h-4500v-1389h9e3v1389h-4500z" stroke="#3465af"/><text class="TextShape"><tspan font-size="635px" font-family="&apos;Times New Roman&apos;, serif" font-weight="400" class="TextParagraph"><tspan y="5710" x="12051" class="TextPosition"><tspan fill="#000000">Satellite Equipment Control (SEC)</tspan></tspan></tspan></text>
+</g><g transform="translate(-2140.9 -2186)" class="com.sun.star.drawing.CustomShape"><path fill="#cff" d="m13400 4600h-1400v-1e3h2800v1e3h-1400z"/><path fill="none" d="m13400 4600h-1400v-1e3h2800v1e3h-1400z" stroke="#3465af"/><text class="TextShape"><tspan font-size="635px" font-family="&apos;Times New Roman&apos;, serif" font-weight="400" class="TextParagraph"><tspan y="4316" x="12465" class="TextPosition"><tspan fill="#000000">Demod</tspan></tspan></tspan></text>
+</g><g transform="translate(-2140.9 -2186)" class="com.sun.star.drawing.CustomShape"><path fill="#729fcf" d="m9979 5451 402-368v184h1217v-184l403 368-403 369v-185h-1217v185l-402-369z"/><path fill="none" d="m9979 5451 402-368v184h1217v-184l403 368-403 369v-185h-1217v185l-402-369z" stroke="#3465af"/></g><path fill="#ff9" d="m7855.1 9099v7302h-1270v-14605h1270v7303z"/><path fill="none" d="m7855.1 9099v7302h-1270v-14605h1270v7303z" stroke="#3465af"/><text y="-6640.4663" x="-20770.572" transform="rotate(-90)" class="TextShape"><tspan font-size="635px" font-family="&apos;Times New Roman&apos;, serif" font-weight="400" class="TextParagraph"><tspan y="7409.5396" x="-11193.634" class="TextPosition" transform="matrix(0,-1,1,0,-4473,23627)"><tspan fill="#000000">I2C Bus (control bus)</tspan></tspan></tspan></text>
+<g transform="translate(-2197.3 -2186)" class="com.sun.star.drawing.TextShape"><text class="TextShape"><tspan font-size="635px" font-family="&apos;Times New Roman&apos;, serif" font-weight="400" class="TextParagraph"><tspan y="3278" x="9391" class="TextPosition"><tspan fill="#000000">Digital TV Frontend</tspan></tspan></tspan></text>
+</g><g transform="matrix(1.015 0 0 .99994 -2233.3 -2185.7)" class="com.sun.star.drawing.CustomShape"><g stroke="#3465af" fill="none"><path d="m3e3 2800c-18 0-35 1-53 3"/><path d="m2915 2808c-17 3-35 7-52 12"/><path d="m2832 2830c-16 6-33 12-49 20"/><path d="m2754 2864c-15 8-31 17-46 27"/><path d="m2681 2909c-14 10-28 21-42 32"/><path d="m2614 2962c-13 12-26 24-38 37"/><path d="m2554 3023c-11 13-22 27-33 41"/><path d="m2502 3091c-10 14-19 29-28 45"/><path d="m2459 3164c-8 16-15 32-22 49"/><path d="m2426 3243c-5 17-10 34-14 51"/><path d="m2406 3326c-3 18-5 35-6 53"/><path d="m2400 3411v53"/><path d="m2400 3497v53"/><path d="m2400 3582v53"/><path d="m2400 3668v53"/><path d="m2400 3753v53"/><path d="m2400 3839v53"/><path d="m2400 3924v53"/><path d="m2400 4009v54"/><path d="m2400 4095v53"/><path d="m2400 4180v53"/><path d="m2400 4266v53"/><path d="m2400 4351v53"/><path d="m2400 4437v53"/><path d="m2400 4522v53"/><path d="m2400 4607v54"/><path d="m2400 4693v53"/><path d="m2400 4778v53"/><path d="m2400 4864v53"/><path d="m2400 4949v53"/><path d="m2400 5035v53"/><path d="m2400 5120v53"/><path d="m2400 5205v54"/><path d="m2400 5291v53"/><path d="m2400 5376v53"/><path d="m2400 5462v53"/><path d="m2400 5547v53"/><path d="m2400 5633v53"/><path d="m2400 5718v53"/><path d="m2400 5803c0 18 1 36 3 53"/><path d="m2408 5888c4 18 8 35 13 52"/><path d="m2431 5971c6 16 13 33 20 49"/><path d="m2466 6049c8 15 17 31 27 46"/><path d="m2511 6122c10 14 21 28 32 42"/><path d="m2564 6188c12 13 25 26 38 38"/><path d="m2626 6248c13 11 27 23 41 33"/><path d="m2694 6300c14 10 29 19 45 27"/><path d="m2768 6343c15 7 32 15 48 21"/><path d="m2847 6375c17 5 34 10 51 14"/><path d="m2930 6395c17 2 35 4 53 5"/><path d="m3015 6400h53"/><path d="m3100 6400h53"/><path d="m3186 6400h53"/><path d="m3271 6400h53"/><path d="m3357 6400h53"/><path d="m3442 6400h53"/><path d="m3527 6400h54"/><path d="m3613 6400h53"/><path d="m3698 6400h53"/><path d="m3784 6400h53"/><path d="m3869 6400h53"/><path d="m3955 6400h53"/><path d="m4040 6400h53"/><path d="m4125 6400h54"/><path d="m4211 6400h53"/><path d="m4296 6400h53"/><path d="m4382 6400h53"/><path d="m4467 6400h53"/><path d="m4553 6400h53"/><path d="m4638 6400h53"/><path d="m4723 6400h54"/><path d="m4809 6400h53"/><path d="m4894 6400h53"/><path d="m4980 6400h53"/><path d="m5065 6400h53"/><path d="m5151 6400h53"/><path d="m5236 6400h53"/><path d="m5322 6400h53"/><path d="m5407 6400h53"/><path d="m5492 6400h53"/><path d="m5578 6400h53"/><path d="m5663 6400h53"/><path d="m5749 6400h53"/><path d="m5834 6400h53"/><path d="m5920 6400h53"/><path d="m6005 6400h53"/><path d="m6090 6400h53"/><path d="m6176 6400h53"/><path d="m6261 6400h53"/><path d="m6347 6400h53"/><path d="m6432 6400h53"/><path d="m6518 6400h53"/><path d="m6603 6400h53"/><path d="m6688 6400h54"/><path d="m6774 6400h53"/><path d="m6859 6400h53"/><path d="m6945 6400h53"/><path d="m7030 6400h53"/><path d="m7116 6400h53"/><path d="m7201 6400h53"/><path d="m7286 6400h54"/><path d="m7372 6400h53"/><path d="m7457 6400h53"/><path d="m7543 6400h53"/><path d="m7628 6400h53"/><path d="m7714 6400h53"/><path d="m7799 6400h53"/><path d="m7884 6400h54"/><path d="m7970 6400h53"/><path d="m8055 6400h53"/><path d="m8141 6400h53"/><path d="m8226 6400h53"/><path d="m8312 6400h53"/><path d="m8397 6400h53"/><path d="m8482 6400h54"/><path d="m8568 6400h53"/><path d="m8653 6400h53"/><path d="m8739 6400h53"/><path d="m8824 6400h53"/><path d="m8910 6400h53"/><path d="m8995 6400h53"/><path d="m9081 6400h53"/><path d="m9166 6400h53"/><path d="m9251 6400h53"/><path d="m9337 6400h53"/><path d="m9422 6400h53"/><path d="m9508 6400h53"/><path d="m9593 6400h53"/><path d="m9679 6400h53"/><path d="m9764 6400h53"/><path d="m9849 6400h53"/><path d="m9935 6400h53"/><path d="m10020 6400h53"/><path d="m10106 6400h53"/><path d="m10191 6400h53"/><path d="m10277 6400h53"/><path d="m10362 6400h53"/><path d="m10447 6400h53"/><path d="m10533 6400h53"/><path d="m10618 6400h53"/><path d="m10704 6400h53"/><path d="m10789 6400h53"/><path d="m10875 6400h53"/><path d="m10960 6400h53"/><path d="m11045 6400h54"/><path d="m11131 6400h53"/><path d="m11216 6400h53"/><path d="m11302 6400h53"/><path d="m11387 6400h53"/><path d="m11473 6400h53"/><path d="m11558 6400h53"/><path d="m11643 6400h54"/><path d="m11729 6400h53"/><path d="m11814 6400h53"/><path d="m11900 6400h53"/><path d="m11985 6400h53"/><path d="m12071 6400h53"/><path d="m12156 6400h53"/><path d="m12241 6400h54"/><path d="m12327 6400h53"/><path d="m12412 6400h53"/><path d="m12498 6400h53"/><path d="m12583 6400h53"/><path d="m12669 6400h53"/><path d="m12754 6400h53"/><path d="m12839 6400h54"/><path d="m12925 6400h53"/><path d="m13010 6400h53"/><path d="m13096 6400h53"/><path d="m13181 6400h53"/><path d="m13267 6400h53"/><path d="m13352 6400h53"/><path d="m13438 6400h53"/><path d="m13523 6400h53"/><path d="m13608 6400h53"/><path d="m13694 6400h53"/><path d="m13779 6400h53"/><path d="m13865 6400h53"/><path d="m13950 6400h53"/><path d="m14036 6400h53"/><path d="m14121 6400h53"/><path d="m14206 6400h53"/><path d="m14292 6400h53"/><path d="m14377 6400h53"/><path d="m14463 6400h53"/><path d="m14548 6400h53"/><path d="m14634 6400h53"/><path d="m14719 6400h53"/><path d="m14804 6400h54"/><path d="m14890 6400h53"/><path d="m14975 6400h53"/><path d="m15061 6400h53"/><path d="m15146 6400h53"/><path d="m15232 6400h53"/><path d="m15317 6400h53"/><path d="m15402 6400h54"/><path d="m15488 6400h53"/><path d="m15573 6400h53"/><path d="m15659 6400h53"/><path d="m15744 6400h53"/><path d="m15830 6400h53"/><path d="m15915 6400h53"/><path d="m16000 6400h54"/><path d="m16086 6400h53"/><path d="m16171 6400h53"/><path d="m16257 6400h53"/><path d="m16342 6400h53"/><path d="m16428 6400h53"/><path d="m16513 6400h53"/><path d="m16598 6400h54"/><path d="m16684 6400h53"/><path d="m16769 6400h53"/><path d="m16855 6400h53"/><path d="m16940 6400h53"/><path d="m17026 6400h53"/><path d="m17111 6400h53"/><path d="m17196 6400h54"/><path d="m17282 6400h53"/><path d="m17367 6400h53"/><path d="m17453 6400h53"/><path d="m17538 6400h53"/><path d="m17624 6400h53"/><path d="m17709 6400h53"/><path d="m17795 6400h53"/><path d="m17880 6400h53"/><path d="m17965 6400h53"/><path d="m18051 6400h53"/><path d="m18136 6400h53"/><path d="m18222 6400h53"/><path d="m18307 6400h53"/><path d="m18393 6400h53"/><path d="m18478 6400h53"/><path d="m18563 6400h53"/><path d="m18649 6400h53"/><path d="m18734 6400h53"/><path d="m18820 6400h53"/><path d="m18905 6400h53"/><path d="m18991 6400h53"/><path d="m19076 6400h53"/><path d="m19161 6400h54"/><path d="m19247 6400h53"/><path d="m19332 6400h53"/><path d="m19418 6400h53"/><path d="m19503 6400h53"/><path d="m19589 6400h53"/><path d="m19674 6400h53"/><path d="m19759 6400h54"/><path d="m19845 6400h53"/><path d="m19930 6400h53"/><path d="m20016 6400h53"/><path d="m20101 6400h53"/><path d="m20187 6400h53"/><path d="m20272 6400h53"/><path d="m20357 6400h54"/><path d="m20443 6400h53"/><path d="m20528 6400h53"/><path d="m20614 6400c17-1 35-2 53-5"/><path d="m20699 6390c17-4 34-9 51-14"/><path d="m20781 6365c16-6 32-13 48-21"/><path d="m20858 6329c15-8 31-17 45-27"/><path d="m20930 6283c14-10 28-21 42-32"/><path d="m20996 6229c13-12 25-25 37-38"/><path d="m21055 6167c11-14 22-28 33-42"/><path d="m21106 6098c10-15 19-30 27-45"/><path d="m21148 6024c7-16 14-33 20-49"/><path d="m21179 5944c5-17 9-34 13-51"/><path d="m21197 5861c2-18 4-35 4-53"/><path d="m21201 5776v-54"/><path d="m21201 5690v-53"/><path d="m21201 5605v-53"/><path d="m21201 5519v-53"/><path d="m21201 5434v-53"/><path d="m21201 5348v-53"/><path d="m21201 5263v-53"/><path d="m21201 5178v-54"/><path d="m21201 5092v-53"/><path d="m21201 5007v-53"/><path d="m21201 4921v-53"/><path d="m21201 4836v-53"/><path d="m21201 4750v-53"/><path d="m21201 4665v-53"/><path d="m21201 4579v-53"/><path d="m21201 4494v-53"/><path d="m21201 4409v-53"/><path d="m21201 4323v-53"/><path d="m21201 4238v-53"/><path d="m21201 4152v-53"/><path d="m21201 4067v-53"/><path d="m21201 3981v-53"/><path d="m21201 3896v-53"/><path d="m21201 3811v-53"/><path d="m21201 3725v-53"/><path d="m21201 3640v-53"/><path d="m21201 3554v-53"/><path d="m21201 3469v-53"/><path d="m21201 3383c-1-17-3-35-5-52"/><path d="m21190 3299c-4-17-8-35-14-51"/><path d="m21165 3217c-6-16-13-33-21-49"/><path d="m21129 3140c-9-16-18-31-28-46"/><path d="m21082 3068c-10-14-21-28-33-42"/><path d="m21027 3002c-12-13-24-25-37-37"/><path d="m20965 2944c-14-12-28-22-42-33"/><path d="m20896 2893c-15-9-30-18-46-27"/><path d="m20821 2852c-16-8-32-14-49-20"/><path d="m20741 2821c-17-5-34-9-51-12"/><path d="m20658 2804c-18-3-35-4-53-4"/><path d="m20573 2800h-53"/><path d="m20487 2800h-53"/><path d="m20402 2800h-53"/><path d="m20316 2800h-53"/><path d="m20231 2800h-53"/><path d="m20146 2800h-54"/><path d="m20060 2800h-53"/><path d="m19975 2800h-53"/><path d="m19889 2800h-53"/><path d="m19804 2800h-53"/><path d="m19718 2800h-53"/><path d="m19633 2800h-53"/><path d="m19548 2800h-54"/><path d="m19462 2800h-53"/><path d="m19377 2800h-53"/><path d="m19291 2800h-53"/><path d="m19206 2800h-53"/><path d="m19120 2800h-53"/><path d="m19035 2800h-53"/><path d="m18950 2800h-54"/><path d="m18864 2800h-53"/><path d="m18779 2800h-53"/><path d="m18693 2800h-53"/><path d="m18608 2800h-53"/><path d="m18522 2800h-53"/><path d="m18437 2800h-53"/><path d="m18352 2800h-54"/><path d="m18266 2800h-53"/><path d="m18181 2800h-53"/><path d="m18095 2800h-53"/><path d="m18010 2800h-53"/><path d="m17924 2800h-53"/><path d="m17839 2800h-53"/><path d="m17753 2800h-53"/><path d="m17668 2800h-53"/><path d="m17583 2800h-53"/><path d="m17497 2800h-53"/><path d="m17412 2800h-53"/><path d="m17326 2800h-53"/><path d="m17241 2800h-53"/><path d="m17155 2800h-53"/><path d="m17070 2800h-53"/><path d="m16985 2800h-53"/><path d="m16899 2800h-53"/><path d="m16814 2800h-53"/><path d="m16728 2800h-53"/><path d="m16643 2800h-53"/><path d="m16557 2800h-53"/><path d="m16472 2800h-53"/><path d="m16387 2800h-54"/><path d="m16301 2800h-53"/><path d="m16216 2800h-53"/><path d="m16130 2800h-53"/><path d="m16045 2800h-53"/><path d="m15959 2800h-53"/><path d="m15874 2800h-53"/><path d="m15789 2800h-54"/><path d="m15703 2800h-53"/><path d="m15618 2800h-53"/><path d="m15532 2800h-53"/><path d="m15447 2800h-53"/><path d="m15361 2800h-53"/><path d="m15276 2800h-53"/><path d="m15191 2800h-54"/><path d="m15105 2800h-53"/><path d="m15020 2800h-53"/><path d="m14934 2800h-53"/><path d="m14849 2800h-53"/><path d="m14763 2800h-53"/><path d="m14678 2800h-53"/><path d="m14593 2800h-54"/><path d="m14507 2800h-53"/><path d="m14422 2800h-53"/><path d="m14336 2800h-53"/><path d="m14251 2800h-53"/><path d="m14165 2800h-53"/><path d="m14080 2800h-53"/><path d="m13994 2800h-53"/><path d="m13909 2800h-53"/><path d="m13824 2800h-53"/><path d="m13738 2800h-53"/><path d="m13653 2800h-53"/><path d="m13567 2800h-53"/><path d="m13482 2800h-53"/><path d="m13396 2800h-53"/><path d="m13311 2800h-53"/><path d="m13226 2800h-53"/><path d="m13140 2800h-53"/><path d="m13055 2800h-53"/><path d="m12969 2800h-53"/><path d="m12884 2800h-53"/><path d="m12798 2800h-53"/><path d="m12713 2800h-53"/><path d="m12628 2800h-53"/><path d="m12542 2800h-53"/><path d="m12457 2800h-53"/><path d="m12371 2800h-53"/><path d="m12286 2800h-53"/><path d="m12200 2800h-53"/><path d="m12115 2800h-53"/><path d="m12030 2800h-54"/><path d="m11944 2800h-53"/><path d="m11859 2800h-53"/><path d="m11773 2800h-53"/><path d="m11688 2800h-53"/><path d="m11602 2800h-53"/><path d="m11517 2800h-53"/><path d="m11432 2800h-54"/><path d="m11346 2800h-53"/><path d="m11261 2800h-53"/><path d="m11175 2800h-53"/><path d="m11090 2800h-53"/><path d="m11004 2800h-53"/><path d="m10919 2800h-53"/><path d="m10834 2800h-54"/><path d="m10748 2800h-53"/><path d="m10663 2800h-53"/><path d="m10577 2800h-53"/><path d="m10492 2800h-53"/><path d="m10406 2800h-53"/><path d="m10321 2800h-53"/><path d="m10236 2800h-54"/><path d="m10150 2800h-53"/><path d="m10065 2800h-53"/><path d="m9979 2800h-53"/><path d="m9894 2800h-53"/><path d="m9808 2800h-53"/><path d="m9723 2800h-53"/><path d="m9637 2800h-53"/><path d="m9552 2800h-53"/><path d="m9467 2800h-53"/><path d="m9381 2800h-53"/><path d="m9296 2800h-53"/><path d="m9210 2800h-53"/><path d="m9125 2800h-53"/><path d="m9039 2800h-53"/><path d="m8954 2800h-53"/><path d="m8869 2800h-53"/><path d="m8783 2800h-53"/><path d="m8698 2800h-53"/><path d="m8612 2800h-53"/><path d="m8527 2800h-53"/><path d="m8441 2800h-53"/><path d="m8356 2800h-53"/><path d="m8271 2800h-54"/><path d="m8185 2800h-53"/><path d="m8100 2800h-53"/><path d="m8014 2800h-53"/><path d="m7929 2800h-53"/><path d="m7843 2800h-53"/><path d="m7758 2800h-53"/><path d="m7673 2800h-54"/><path d="m7587 2800h-53"/><path d="m7502 2800h-53"/><path d="m7416 2800h-53"/><path d="m7331 2800h-53"/><path d="m7245 2800h-53"/><path d="m7160 2800h-53"/><path d="m7075 2800h-54"/><path d="m6989 2800h-53"/><path d="m6904 2800h-53"/><path d="m6818 2800h-53"/><path d="m6733 2800h-53"/><path d="m6647 2800h-53"/><path d="m6562 2800h-53"/><path d="m6477 2800h-54"/><path d="m6391 2800h-53"/><path d="m6306 2800h-53"/><path d="m6220 2800h-53"/><path d="m6135 2800h-53"/><path d="m6049 2800h-53"/><path d="m5964 2800h-53"/><path d="m5879 2800h-54"/><path d="m5793 2800h-53"/><path d="m5708 2800h-53"/><path d="m5622 2800h-53"/><path d="m5537 2800h-53"/><path d="m5451 2800h-53"/><path d="m5366 2800h-53"/><path d="m5280 2800h-53"/><path d="m5195 2800h-53"/><path d="m5110 2800h-53"/><path d="m5024 2800h-53"/><path d="m4939 2800h-53"/><path d="m4853 2800h-53"/><path d="m4768 2800h-53"/><path d="m4682 2800h-53"/><path d="m4597 2800h-53"/><path d="m4512 2800h-53"/><path d="m4426 2800h-53"/><path d="m4341 2800h-53"/><path d="m4255 2800h-53"/><path d="m4170 2800h-53"/><path d="m4084 2800h-53"/><path d="m3999 2800h-53"/><path d="m3914 2800h-54"/><path d="m3828 2800h-53"/><path d="m3743 2800h-53"/><path d="m3657 2800h-53"/><path d="m3572 2800h-53"/><path d="m3486 2800h-53"/><path d="m3401 2800h-53"/><path d="m3316 2800h-54"/><path d="m3230 2800h-53"/><path d="m3145 2800h-53"/><path d="m3059 2800h-53"/></g></g><g transform="translate(-2197.3 -2186)"><rect height="1100.7" width="1213.6" y="6917.1" x="23255" fill="#f3e777"/><path fill="#ca4677" d="m22802 7700.4v-405.46l150.7-169.16c82.886-93.039 170.53-186.62 194.77-207.96l44.069-38.798 783.23-0.086 783.23-0.086v613.5 613.5h-978-978v-405.46zm1027.7 136.98v-78.372l-169.91 4.925-169.91 4.9249-5.09 45.854c-8.249 74.303 46.711 101.04 207.69 101.04h137.21v-78.372zm235.86-262.94 4.495-341.31 207.2-8.6408 207.2-8.6408 5.144-46.443c9.596-86.615-41.863-102.05-322.02-96.607l-246.71 4.7956-4.438 419.08-4.439 419.08h74.537 74.538l4.494-341.31zm391.3 313.72c26.41-19.286 36.255-41.399 32.697-73.447l-5.09-45.854h-174.05-174.05l-5.38 48.984c-9.97 90.771 0.993 97.91 150.36 97.91 99.305 0 148.27-7.6982 175.52-27.594zm-627.16-274.84v-77.768h-174.05-174.05v66.246c0 36.436 4.973 71.431 11.051 77.768 6.078 6.3366 84.401 11.521 174.05 11.521h163v-77.768zm659.89-4.9154 5.125-74.042-179.18 4.9155-179.18 4.9155-5.38 48.984c-10.473 95.348-2.259 99.57 183.28 94.197l170.2-4.9284 5.125-74.042zm-659.89-237.63v-78.372l-169.91 4.925-169.91 4.925-5.097 73.447-5.097 73.447h175 175v-78.372zm659.86 4.925-5.097-73.447h-174.05-174.05l-5.38 48.984c-10.289 93.673-2.146 97.91 188.15 97.91h175.52l-5.097-73.447zm-659.86-228.98v-77.768h-137.21c-97.358 0-147.91 7.8138-174.05 26.902-34.952 25.523-49.645 92.242-25.79 117.11 6.078 6.3366 84.401 11.521 174.05 11.521h163v-77.768z"/></g><g transform="matrix(.84874 0 0 .76147 2408.1 3615.3)"><rect height="3076.2" width="2734.3" y="13264" x="19249" fill="#6076b3"/><g stroke-linejoin="round" fill-rule="evenodd" stroke-width="28.222" fill="#e0ee2c"><rect y="13369" width="356.65" x="18937" height="180.95"/><rect y="13708" width="356.65" x="18937" height="180.95"/><rect y="14048" width="356.65" x="18937" height="180.95"/><rect y="14387" width="356.65" x="18937" height="180.95"/><rect y="14726" width="356.65" x="18937" height="180.95"/><rect y="15066" width="356.65" x="18937" height="180.95"/><rect y="15405" width="356.65" x="18937" height="180.95"/><rect y="15744" width="356.65" x="18937" height="180.95"/><rect y="16083" width="356.65" x="18937" height="180.95"/><rect y="13324" width="356.65" x="21939" height="180.95"/><rect y="13663" width="356.65" x="21939" height="180.95"/><rect y="14002" width="356.65" x="21939" height="180.95"/><rect y="14342" width="356.65" x="21939" height="180.95"/><rect y="14681" width="356.65" x="21939" height="180.95"/><rect y="15020" width="356.65" x="21939" height="180.95"/><rect y="15360" width="356.65" x="21939" height="180.95"/><rect y="15699" width="356.65" x="21939" height="180.95"/><rect y="16038" width="356.65" x="21939" height="180.95"/></g><g stroke-linejoin="round" fill-rule="evenodd" transform="matrix(.98702 0 0 .90336 -2675 7020.8)" class="com.sun.star.drawing.TextShape" stroke-width="28.222"><text class="TextShape"><tspan font-size="635px" font-family="&apos;Times New Roman&apos;, serif" font-weight="400" class="TextParagraph"/></text>
+<text style="word-spacing:0px;letter-spacing:0px" xml:space="preserve" font-size="1128.9px" y="9042.0264" x="22439.668" font-family="Sans" line-height="125%" fill="#000000"><tspan y="9042.0264" x="22439.668">CPU</tspan></text>
+</g></g><g stroke-linejoin="round" fill-rule="evenodd" transform="translate(-11752 543.6)" class="com.sun.star.drawing.TextShape" stroke-width="28.222"><text class="TextShape"><tspan font-size="706px" font-family="&apos;Times New Roman&apos;, serif" font-weight="400" class="TextParagraph"><tspan y="15832" x="24341" class="TextPosition" transform="matrix(0,-1,1,0,8509,40173)"><tspan fill="#000000">PCI, USB, SPI, I2C, ...</tspan></tspan></tspan></text>
+</g><g stroke-linejoin="round" fill-rule="evenodd" transform="translate(-655.31 963.83)" class="com.sun.star.drawing.RectangleShape" stroke-width="28.222"><g transform="matrix(.49166 0 0 1.0059 6045.6 -82.24)"><path fill="#cfe7f5" d="m14169 14572h-2268v-1412h4536v1412h-2268z"/><path fill="none" d="m14169 14572h-2268v-1412h4536v1412h-2268z" stroke="#3465af"/></g><text y="-395.11282" x="-790.22229" class="TextShape"><tspan font-size="635px" font-family="&apos;Times New Roman&apos;, serif" font-weight="400" class="TextParagraph"><tspan y="13686.9" x="12091.779" class="TextPosition"><tspan fill="#000000">Bridge</tspan></tspan></tspan></text>
+<text y="338.66486" x="-846.66675" class="TextShape"><tspan font-size="635px" font-family="&apos;Times New Roman&apos;, serif" font-weight="400" class="TextParagraph"><tspan y="14420.677" x="12035.335" class="TextPosition"><tspan fill="#000000"> DMA</tspan></tspan></tspan></text>
+</g></svg>
diff --git a/Documentation/linux_tv/net.h.rst b/Documentation/linux_tv/net.h.rst
new file mode 100644
index 000000000000..c0a0e9310333
--- /dev/null
+++ b/Documentation/linux_tv/net.h.rst
@@ -0,0 +1,70 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+file: net.h
+===========
+
+.. code-block:: c
+
+    /*
+     * net.h
+     *
+     * Copyright (C) 2000 Marcus Metzler <marcus@convergence.de>
+     *                  & Ralph  Metzler <ralph@convergence.de>
+     *                    for convergence integrated media GmbH
+     *
+     * This program is free software; you can redistribute it and/or
+     * modify it under the terms of the GNU Lesser General Public License
+     * as published by the Free Software Foundation; either version 2.1
+     * of the License, or (at your option) any later version.
+     *
+     * This program is distributed in the hope that it will be useful,
+     * but WITHOUT ANY WARRANTY; without even the implied warranty of
+     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+     * GNU General Public License for more details.
+     *
+     * You should have received a copy of the GNU Lesser General Public License
+     * along with this program; if not, write to the Free Software
+     * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+     *
+     */
+
+    #ifndef _DVBNET_H_
+    #define _DVBNET_H_
+
+    #include <linux/types.h>
+
+    struct dvb_net_if {
+            __u16 pid;
+            __u16 if_num;
+            __u8  feedtype;
+    #define DVB_NET_FEEDTYPE_MPE 0  /* multi protocol encapsulation */
+    #define DVB_NET_FEEDTYPE_ULE 1  /* ultra lightweight encapsulation */
+    };
+
+
+    #define NET_ADD_IF    _IOWR('o', 52, struct dvb_net_if)
+    #define NET_REMOVE_IF _IO('o', 53)
+    #define NET_GET_IF    _IOWR('o', 54, struct dvb_net_if)
+
+
+    /* binary compatibility cruft: */
+    struct __dvb_net_if_old {
+            __u16 pid;
+            __u16 if_num;
+    };
+    #define __NET_ADD_IF_OLD _IOWR('o', 52, struct __dvb_net_if_old)
+    #define __NET_GET_IF_OLD _IOWR('o', 54, struct __dvb_net_if_old)
+
+
+    #endif /*_DVBNET_H_*/
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/video.h.rst b/Documentation/linux_tv/video.h.rst
new file mode 100644
index 000000000000..b332a02b8fd6
--- /dev/null
+++ b/Documentation/linux_tv/video.h.rst
@@ -0,0 +1,291 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+file: video.h
+=============
+
+.. code-block:: c
+
+    /*
+     * video.h
+     *
+     * Copyright (C) 2000 Marcus Metzler <marcus@convergence.de>
+     *                  & Ralph  Metzler <ralph@convergence.de>
+     *                    for convergence integrated media GmbH
+     *
+     * This program is free software; you can redistribute it and/or
+     * modify it under the terms of the GNU Lesser General Public License
+     * as published by the Free Software Foundation; either version 2.1
+     * of the License, or (at your option) any later version.
+     *
+     * This program is distributed in the hope that it will be useful,
+     * but WITHOUT ANY WARRANTY; without even the implied warranty of
+     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+     * GNU General Public License for more details.
+     *
+     * You should have received a copy of the GNU Lesser General Public License
+     * along with this program; if not, write to the Free Software
+     * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+     *
+     */
+
+    #ifndef _UAPI_DVBVIDEO_H_
+    #define _UAPI_DVBVIDEO_H_
+
+    #include <linux/types.h>
+    #ifndef __KERNEL__
+    #include <time.h>
+    #endif
+
+    typedef enum {
+            VIDEO_FORMAT_4_3,     /* Select 4:3 format */
+            VIDEO_FORMAT_16_9,    /* Select 16:9 format. */
+            VIDEO_FORMAT_221_1    /* 2.21:1 */
+    } video_format_t;
+
+
+    typedef enum {
+             VIDEO_SYSTEM_PAL,
+             VIDEO_SYSTEM_NTSC,
+             VIDEO_SYSTEM_PALN,
+             VIDEO_SYSTEM_PALNc,
+             VIDEO_SYSTEM_PALM,
+             VIDEO_SYSTEM_NTSC60,
+             VIDEO_SYSTEM_PAL60,
+             VIDEO_SYSTEM_PALM60
+    } video_system_t;
+
+
+    typedef enum {
+            VIDEO_PAN_SCAN,       /* use pan and scan format */
+            VIDEO_LETTER_BOX,     /* use letterbox format */
+            VIDEO_CENTER_CUT_OUT  /* use center cut out format */
+    } video_displayformat_t;
+
+    typedef struct {
+            int w;
+            int h;
+            video_format_t aspect_ratio;
+    } video_size_t;
+
+    typedef enum {
+            VIDEO_SOURCE_DEMUX, /* Select the demux as the main source */
+            VIDEO_SOURCE_MEMORY /* If this source is selected, the stream
+                                   comes from the user through the write
+                                   system call */
+    } video_stream_source_t;
+
+
+    typedef enum {
+            VIDEO_STOPPED, /* Video is stopped */
+            VIDEO_PLAYING, /* Video is currently playing */
+            VIDEO_FREEZED  /* Video is freezed */
+    } video_play_state_t;
+
+
+    /* Decoder commands */
+    #define VIDEO_CMD_PLAY        (0)
+    #define VIDEO_CMD_STOP        (1)
+    #define VIDEO_CMD_FREEZE      (2)
+    #define VIDEO_CMD_CONTINUE    (3)
+
+    /* Flags for VIDEO_CMD_FREEZE */
+    #define VIDEO_CMD_FREEZE_TO_BLACK       (1 << 0)
+
+    /* Flags for VIDEO_CMD_STOP */
+    #define VIDEO_CMD_STOP_TO_BLACK         (1 << 0)
+    #define VIDEO_CMD_STOP_IMMEDIATELY      (1 << 1)
+
+    /* Play input formats: */
+    /* The decoder has no special format requirements */
+    #define VIDEO_PLAY_FMT_NONE         (0)
+    /* The decoder requires full GOPs */
+    #define VIDEO_PLAY_FMT_GOP          (1)
+
+    /* The structure must be zeroed before use by the application
+       This ensures it can be extended safely in the future. */
+    struct video_command {
+            __u32 cmd;
+            __u32 flags;
+            union {
+                    struct {
+                            __u64 pts;
+                    } stop;
+
+                    struct {
+                            /* 0 or 1000 specifies normal speed,
+                               1 specifies forward single stepping,
+                               -1 specifies backward single stepping,
+                               >1: playback at speed/1000 of the normal speed,
+                               <-1: reverse playback at (-speed/1000) of the normal speed. */
+                            __s32 speed;
+                            __u32 format;
+                    } play;
+
+                    struct {
+                            __u32 data[16];
+                    } raw;
+            };
+    };
+
+    /* FIELD_UNKNOWN can be used if the hardware does not know whether
+       the Vsync is for an odd, even or progressive (i.e.ie; non-interlaced)
+       field. */
+    #define VIDEO_VSYNC_FIELD_UNKNOWN       (0)
+    #define VIDEO_VSYNC_FIELD_ODD           (1)
+    #define VIDEO_VSYNC_FIELD_EVEN          (2)
+    #define VIDEO_VSYNC_FIELD_PROGRESSIVE   (3)
+
+    struct video_event {
+            __s32 type;
+    #define VIDEO_EVENT_SIZE_CHANGED        1
+    #define VIDEO_EVENT_FRAME_RATE_CHANGED  2
+    #define VIDEO_EVENT_DECODER_STOPPED     3
+    #define VIDEO_EVENT_VSYNC               4
+            __kernel_time_t timestamp;
+            union {
+                    video_size_t size;
+                    unsigned int frame_rate;        /* in frames per 1000sec */
+                    unsigned char vsync_field;      /* unknown/odd/even/progressive */
+            } u;
+    };
+
+
+    struct video_status {
+            int                   video_blank;   /* blank video on freeze? */
+            video_play_state_t    play_state;    /* current state of playback */
+            video_stream_source_t stream_source; /* current source (demux/memory) */
+            video_format_t        video_format;  /* current aspect ratio of stream*/
+            video_displayformat_t display_format;/* selected cropping mode */
+    };
+
+
+    struct video_still_picture {
+            char __user *iFrame;        /* pointer to a single iframe in memory */
+            __s32 size;
+    };
+
+
+    typedef
+    struct video_highlight {
+            int     active;      /*    1=show highlight, 0=hide highlight */
+            __u8    contrast1;   /*    7- 4  Pattern pixel contrast */
+                                 /*    3- 0  Background pixel contrast */
+            __u8    contrast2;   /*    7- 4  Emphasis pixel-2 contrast */
+                                 /*    3- 0  Emphasis pixel-1 contrast */
+            __u8    color1;      /*    7- 4  Pattern pixel color */
+                                 /*    3- 0  Background pixel color */
+            __u8    color2;      /*    7- 4  Emphasis pixel-2 color */
+                                 /*    3- 0  Emphasis pixel-1 color */
+            __u32    ypos;       /*   23-22  auto action mode */
+                                 /*   21-12  start y */
+                                 /*    9- 0  end y */
+            __u32    xpos;       /*   23-22  button color number */
+                                 /*   21-12  start x */
+                                 /*    9- 0  end x */
+    } video_highlight_t;
+
+
+    typedef struct video_spu {
+            int active;
+            int stream_id;
+    } video_spu_t;
+
+
+    typedef struct video_spu_palette {      /* SPU Palette information */
+            int length;
+            __u8 __user *palette;
+    } video_spu_palette_t;
+
+
+    typedef struct video_navi_pack {
+            int length;          /* 0 ... 1024 */
+            __u8 data[1024];
+    } video_navi_pack_t;
+
+
+    typedef __u16 video_attributes_t;
+    /*   bits: descr. */
+    /*   15-14 Video compression mode (0=MPEG-1, 1=MPEG-2) */
+    /*   13-12 TV system (0=525/60, 1=625/50) */
+    /*   11-10 Aspect ratio (0=4:3, 3=16:9) */
+    /*    9- 8 permitted display mode on 4:3 monitor (0=both, 1=only pan-sca */
+    /*    7    line 21-1 data present in GOP (1=yes, 0=no) */
+    /*    6    line 21-2 data present in GOP (1=yes, 0=no) */
+    /*    5- 3 source resolution (0=720x480/576, 1=704x480/576, 2=352x480/57 */
+    /*    2    source letterboxed (1=yes, 0=no) */
+    /*    0    film/camera mode (0=camera, 1=film (625/50 only)) */
+
+
+    /* bit definitions for capabilities: */
+    /* can the hardware decode MPEG1 and/or MPEG2? */
+    #define VIDEO_CAP_MPEG1   1
+    #define VIDEO_CAP_MPEG2   2
+    /* can you send a system and/or program stream to video device?
+       (you still have to open the video and the audio device but only
+        send the stream to the video device) */
+    #define VIDEO_CAP_SYS     4
+    #define VIDEO_CAP_PROG    8
+    /* can the driver also handle SPU, NAVI and CSS encoded data?
+       (CSS API is not present yet) */
+    #define VIDEO_CAP_SPU    16
+    #define VIDEO_CAP_NAVI   32
+    #define VIDEO_CAP_CSS    64
+
+
+    #define VIDEO_STOP                 _IO('o', 21)
+    #define VIDEO_PLAY                 _IO('o', 22)
+    #define VIDEO_FREEZE               _IO('o', 23)
+    #define VIDEO_CONTINUE             _IO('o', 24)
+    #define VIDEO_SELECT_SOURCE        _IO('o', 25)
+    #define VIDEO_SET_BLANK            _IO('o', 26)
+    #define VIDEO_GET_STATUS           _IOR('o', 27, struct video_status)
+    #define VIDEO_GET_EVENT            _IOR('o', 28, struct video_event)
+    #define VIDEO_SET_DISPLAY_FORMAT   _IO('o', 29)
+    #define VIDEO_STILLPICTURE         _IOW('o', 30, struct video_still_picture)
+    #define VIDEO_FAST_FORWARD         _IO('o', 31)
+    #define VIDEO_SLOWMOTION           _IO('o', 32)
+    #define VIDEO_GET_CAPABILITIES     _IOR('o', 33, unsigned int)
+    #define VIDEO_CLEAR_BUFFER         _IO('o',  34)
+    #define VIDEO_SET_ID               _IO('o', 35)
+    #define VIDEO_SET_STREAMTYPE       _IO('o', 36)
+    #define VIDEO_SET_FORMAT           _IO('o', 37)
+    #define VIDEO_SET_SYSTEM           _IO('o', 38)
+    #define VIDEO_SET_HIGHLIGHT        _IOW('o', 39, video_highlight_t)
+    #define VIDEO_SET_SPU              _IOW('o', 50, video_spu_t)
+    #define VIDEO_SET_SPU_PALETTE      _IOW('o', 51, video_spu_palette_t)
+    #define VIDEO_GET_NAVI             _IOR('o', 52, video_navi_pack_t)
+    #define VIDEO_SET_ATTRIBUTES       _IO('o', 53)
+    #define VIDEO_GET_SIZE             _IOR('o', 55, video_size_t)
+    #define VIDEO_GET_FRAME_RATE       _IOR('o', 56, unsigned int)
+
+    /**
+     * VIDEO_GET_PTS
+     *
+     * Read the 33 bit presentation time stamp as defined
+     * in ITU T-REC-H.222.0 / ISO/IEC 13818-1.
+     *
+     * The PTS should belong to the currently played
+     * frame if possible, but may also be a value close to it
+     * like the PTS of the last decoded frame or the last PTS
+     * extracted by the PES parser.
+     */
+    #define VIDEO_GET_PTS              _IOR('o', 57, __u64)
+
+    /* Read the number of displayed frames since the decoder was started */
+    #define VIDEO_GET_FRAME_COUNT      _IOR('o', 58, __u64)
+
+    #define VIDEO_COMMAND              _IOWR('o', 59, struct video_command)
+    #define VIDEO_TRY_COMMAND          _IOWR('o', 60, struct video_command)
+
+    #endif /* _UAPI_DVBVIDEO_H_ */
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
diff --git a/Documentation/linux_tv/videodev2.h.rst b/Documentation/linux_tv/videodev2.h.rst
new file mode 100644
index 000000000000..78f19aff04a7
--- /dev/null
+++ b/Documentation/linux_tv/videodev2.h.rst
@@ -0,0 +1,2311 @@
+.. -*- coding: utf-8; mode: rst -*-
+
+file: videodev2.h
+=================
+
+.. code-block:: c
+
+    /*
+     *  Video for Linux Two header file
+     *
+     *  Copyright (C) 1999-2012 the contributors
+     *
+     *  This program is free software; you can redistribute it and/or modify
+     *  it under the terms of the GNU General Public License as published by
+     *  the Free Software Foundation; either version 2 of the License, or
+     *  (at your option) any later version.
+     *
+     *  This program is distributed in the hope that it will be useful,
+     *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+     *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+     *  GNU General Public License for more details.
+     *
+     *  Alternatively you can redistribute this file under the terms of the
+     *  BSD license as stated below:
+     *
+     *  Redistribution and use in source and binary forms, with or without
+     *  modification, are permitted provided that the following conditions
+     *  are met:
+     *  1. Redistributions of source code must retain the above copyright
+     *     notice, this list of conditions and the following disclaimer.
+     *  2. Redistributions in binary form must reproduce the above copyright
+     *     notice, this list of conditions and the following disclaimer in
+     *     the documentation and/or other materials provided with the
+     *     distribution.
+     *  3. The names of its contributors may not be used to endorse or promote
+     *     products derived from this software without specific prior written
+     *     permission.
+     *
+     *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+     *  "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+     *  LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+     *  A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+     *  OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+     *  SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+     *  TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+     *  PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+     *  LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+     *  NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+     *  SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+     *
+     *      Header file for v4l or V4L2 drivers and applications
+     * with public API.
+     * All kernel-specific stuff were moved to media/v4l2-dev.h, so
+     * no #if __KERNEL tests are allowed here
+     *
+     *      See https://linuxtv.org for more info
+     *
+     *      Author: Bill Dirks <bill@thedirks.org>
+     *              Justin Schoeman
+     *              Hans Verkuil <hverkuil@xs4all.nl>
+     *              et al.
+     */
+    #ifndef _UAPI__LINUX_VIDEODEV2_H
+    #define _UAPI__LINUX_VIDEODEV2_H
+
+    #ifndef __KERNEL__
+    #include <sys/time.h>
+    #endif
+    #include <linux/compiler.h>
+    #include <linux/ioctl.h>
+    #include <linux/types.h>
+    #include <linux/v4l2-common.h>
+    #include <linux/v4l2-controls.h>
+
+    /*
+     * Common stuff for both V4L1 and V4L2
+     * Moved from videodev.h
+     */
+    #define VIDEO_MAX_FRAME               32
+    #define VIDEO_MAX_PLANES               8
+
+    /*
+     *      M I S C E L L A N E O U S
+     */
+
+    /*  Four-character-code (FOURCC) */
+    #define v4l2_fourcc(a, b, c, d)
+            ((__u32)(a) | ((__u32)(b) << 8) | ((__u32)(c) << 16) | ((__u32)(d) << 24))
+    #define v4l2_fourcc_be(a, b, c, d)      (v4l2_fourcc(a, b, c, d) | (1 << 31))
+
+    /*
+     *      E N U M S
+     */
+    enum v4l2_field {
+            V4L2_FIELD_ANY           = 0, /* driver can choose from none,
+                                             top, bottom, interlaced
+                                             depending on whatever it thinks
+                                             is approximate ... */
+            V4L2_FIELD_NONE          = 1, /* this device has no fields ... */
+            V4L2_FIELD_TOP           = 2, /* top field only */
+            V4L2_FIELD_BOTTOM        = 3, /* bottom field only */
+            V4L2_FIELD_INTERLACED    = 4, /* both fields interlaced */
+            V4L2_FIELD_SEQ_TB        = 5, /* both fields sequential into one
+                                             buffer, top-bottom order */
+            V4L2_FIELD_SEQ_BT        = 6, /* same as above + bottom-top order */
+            V4L2_FIELD_ALTERNATE     = 7, /* both fields alternating into
+                                             separate buffers */
+            V4L2_FIELD_INTERLACED_TB = 8, /* both fields interlaced, top field
+                                             first and the top field is
+                                             transmitted first */
+            V4L2_FIELD_INTERLACED_BT = 9, /* both fields interlaced, top field
+                                             first and the bottom field is
+                                             transmitted first */
+    };
+    #define V4L2_FIELD_HAS_TOP(field)       
+            ((field) == V4L2_FIELD_TOP      ||
+             (field) == V4L2_FIELD_INTERLACED ||
+             (field) == V4L2_FIELD_INTERLACED_TB ||
+             (field) == V4L2_FIELD_INTERLACED_BT ||
+             (field) == V4L2_FIELD_SEQ_TB   ||
+             (field) == V4L2_FIELD_SEQ_BT)
+    #define V4L2_FIELD_HAS_BOTTOM(field)    
+            ((field) == V4L2_FIELD_BOTTOM   ||
+             (field) == V4L2_FIELD_INTERLACED ||
+             (field) == V4L2_FIELD_INTERLACED_TB ||
+             (field) == V4L2_FIELD_INTERLACED_BT ||
+             (field) == V4L2_FIELD_SEQ_TB   ||
+             (field) == V4L2_FIELD_SEQ_BT)
+    #define V4L2_FIELD_HAS_BOTH(field)      
+            ((field) == V4L2_FIELD_INTERLACED ||
+             (field) == V4L2_FIELD_INTERLACED_TB ||
+             (field) == V4L2_FIELD_INTERLACED_BT ||
+             (field) == V4L2_FIELD_SEQ_TB ||
+             (field) == V4L2_FIELD_SEQ_BT)
+    #define V4L2_FIELD_HAS_T_OR_B(field)    
+            ((field) == V4L2_FIELD_BOTTOM ||
+             (field) == V4L2_FIELD_TOP ||
+             (field) == V4L2_FIELD_ALTERNATE)
+
+    enum v4l2_buf_type {
+            V4L2_BUF_TYPE_VIDEO_CAPTURE        = 1,
+            V4L2_BUF_TYPE_VIDEO_OUTPUT         = 2,
+            V4L2_BUF_TYPE_VIDEO_OVERLAY        = 3,
+            V4L2_BUF_TYPE_VBI_CAPTURE          = 4,
+            V4L2_BUF_TYPE_VBI_OUTPUT           = 5,
+            V4L2_BUF_TYPE_SLICED_VBI_CAPTURE   = 6,
+            V4L2_BUF_TYPE_SLICED_VBI_OUTPUT    = 7,
+            V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY = 8,
+            V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE = 9,
+            V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE  = 10,
+            V4L2_BUF_TYPE_SDR_CAPTURE          = 11,
+            V4L2_BUF_TYPE_SDR_OUTPUT           = 12,
+            /* Deprecated, do not use */
+            V4L2_BUF_TYPE_PRIVATE              = 0x80,
+    };
+
+    #define V4L2_TYPE_IS_MULTIPLANAR(type)                  
+            ((type) == V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE   
+             || (type) == V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE)
+
+    #define V4L2_TYPE_IS_OUTPUT(type)                               
+            ((type) == V4L2_BUF_TYPE_VIDEO_OUTPUT                   
+             || (type) == V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE         
+             || (type) == V4L2_BUF_TYPE_VIDEO_OVERLAY               
+             || (type) == V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY        
+             || (type) == V4L2_BUF_TYPE_VBI_OUTPUT                  
+             || (type) == V4L2_BUF_TYPE_SLICED_VBI_OUTPUT           
+             || (type) == V4L2_BUF_TYPE_SDR_OUTPUT)
+
+    enum v4l2_tuner_type {
+            V4L2_TUNER_RADIO             = 1,
+            V4L2_TUNER_ANALOG_TV         = 2,
+            V4L2_TUNER_DIGITAL_TV        = 3,
+            V4L2_TUNER_SDR               = 4,
+            V4L2_TUNER_RF                = 5,
+    };
+
+    /* Deprecated, do not use */
+    #define V4L2_TUNER_ADC  V4L2_TUNER_SDR
+
+    enum v4l2_memory {
+            V4L2_MEMORY_MMAP             = 1,
+            V4L2_MEMORY_USERPTR          = 2,
+            V4L2_MEMORY_OVERLAY          = 3,
+            V4L2_MEMORY_DMABUF           = 4,
+    };
+
+    /* see also http://vektor.theorem.ca/graphics/ycbcr/ */
+    enum v4l2_colorspace {
+            /*
+             * Default colorspace, i.e.ie; let the driver figure it out.
+             * Can only be used with video capture.
+             */
+            V4L2_COLORSPACE_DEFAULT       = 0,
+
+            /* SMPTE 170M: used for broadcast NTSC/PAL SDTV */
+            V4L2_COLORSPACE_SMPTE170M     = 1,
+
+            /* Obsolete pre-1998 SMPTE 240M HDTV standard, superseded by Rec 709 */
+            V4L2_COLORSPACE_SMPTE240M     = 2,
+
+            /* Rec.709: used for HDTV */
+            V4L2_COLORSPACE_REC709        = 3,
+
+            /*
+             * Deprecated, do not use. No driver will ever return this. This was
+             * based on a misunderstanding of the bt878 datasheet.
+             */
+            V4L2_COLORSPACE_BT878         = 4,
+
+            /*
+             * NTSC 1953 colorspace. This only makes sense when dealing with
+             * really, really old NTSC recordings. Superseded by SMPTE 170M.
+             */
+            V4L2_COLORSPACE_470_SYSTEM_M  = 5,
+
+            /*
+             * EBU Tech 3213 PAL/SECAM colorspace. This only makes sense when
+             * dealing with really old PAL/SECAM recordings. Superseded by
+             * SMPTE 170M.
+             */
+            V4L2_COLORSPACE_470_SYSTEM_BG = 6,
+
+            /*
+             * Effectively shorthand for V4L2_COLORSPACE_SRGB, V4L2_YCBCR_ENC_601
+             * and V4L2_QUANTIZATION_FULL_RANGE. To be used for (Motion-)JPEG.
+             */
+            V4L2_COLORSPACE_JPEG          = 7,
+
+            /* For RGB colorspaces such as produces by most webcams. */
+            V4L2_COLORSPACE_SRGB          = 8,
+
+            /* AdobeRGB colorspace */
+            V4L2_COLORSPACE_ADOBERGB      = 9,
+
+            /* BT.2020 colorspace, used for UHDTV. */
+            V4L2_COLORSPACE_BT2020        = 10,
+
+            /* Raw colorspace: for RAW unprocessed images */
+            V4L2_COLORSPACE_RAW           = 11,
+
+            /* DCI-P3 colorspace, used by cinema projectors */
+            V4L2_COLORSPACE_DCI_P3        = 12,
+    };
+
+    /*
+     * Determine how COLORSPACE_DEFAULT should map to a proper colorspace.
+     * This depends on whether this is a SDTV image (use SMPTE 170M), an
+     * HDTV image (use Rec. 709), or something else (use sRGB).
+     */
+    #define V4L2_MAP_COLORSPACE_DEFAULT(is_sdtv, is_hdtv) 
+            ((is_sdtv) ? V4L2_COLORSPACE_SMPTE170M : 
+             ((is_hdtv) ? V4L2_COLORSPACE_REC709 : V4L2_COLORSPACE_SRGB))
+
+    enum v4l2_xfer_func {
+            /*
+             * Mapping of V4L2_XFER_FUNC_DEFAULT to actual transfer functions
+             * for the various colorspaces:
+             *
+             * V4L2_COLORSPACE_SMPTE170M, V4L2_COLORSPACE_470_SYSTEM_M,
+             * V4L2_COLORSPACE_470_SYSTEM_BG, V4L2_COLORSPACE_REC709 and
+             * V4L2_COLORSPACE_BT2020: V4L2_XFER_FUNC_709
+             *
+             * V4L2_COLORSPACE_SRGB, V4L2_COLORSPACE_JPEG: V4L2_XFER_FUNC_SRGB
+             *
+             * V4L2_COLORSPACE_ADOBERGB: V4L2_XFER_FUNC_ADOBERGB
+             *
+             * V4L2_COLORSPACE_SMPTE240M: V4L2_XFER_FUNC_SMPTE240M
+             *
+             * V4L2_COLORSPACE_RAW: V4L2_XFER_FUNC_NONE
+             *
+             * V4L2_COLORSPACE_DCI_P3: V4L2_XFER_FUNC_DCI_P3
+             */
+            V4L2_XFER_FUNC_DEFAULT     = 0,
+            V4L2_XFER_FUNC_709         = 1,
+            V4L2_XFER_FUNC_SRGB        = 2,
+            V4L2_XFER_FUNC_ADOBERGB    = 3,
+            V4L2_XFER_FUNC_SMPTE240M   = 4,
+            V4L2_XFER_FUNC_NONE        = 5,
+            V4L2_XFER_FUNC_DCI_P3      = 6,
+            V4L2_XFER_FUNC_SMPTE2084   = 7,
+    };
+
+    /*
+     * Determine how XFER_FUNC_DEFAULT should map to a proper transfer function.
+     * This depends on the colorspace.
+     */
+    #define V4L2_MAP_XFER_FUNC_DEFAULT(colsp) 
+            ((colsp) == V4L2_COLORSPACE_ADOBERGB ? V4L2_XFER_FUNC_ADOBERGB : 
+             ((colsp) == V4L2_COLORSPACE_SMPTE240M ? V4L2_XFER_FUNC_SMPTE240M : 
+              ((colsp) == V4L2_COLORSPACE_DCI_P3 ? V4L2_XFER_FUNC_DCI_P3 : 
+               ((colsp) == V4L2_COLORSPACE_RAW ? V4L2_XFER_FUNC_NONE : 
+                ((colsp) == V4L2_COLORSPACE_SRGB || (colsp) == V4L2_COLORSPACE_JPEG ? 
+                 V4L2_XFER_FUNC_SRGB : V4L2_XFER_FUNC_709)))))
+
+    enum v4l2_ycbcr_encoding {
+            /*
+             * Mapping of V4L2_YCBCR_ENC_DEFAULT to actual encodings for the
+             * various colorspaces:
+             *
+             * V4L2_COLORSPACE_SMPTE170M, V4L2_COLORSPACE_470_SYSTEM_M,
+             * V4L2_COLORSPACE_470_SYSTEM_BG, V4L2_COLORSPACE_ADOBERGB and
+             * V4L2_COLORSPACE_JPEG: V4L2_YCBCR_ENC_601
+             *
+             * V4L2_COLORSPACE_REC709 and V4L2_COLORSPACE_DCI_P3: V4L2_YCBCR_ENC_709
+             *
+             * V4L2_COLORSPACE_SRGB: V4L2_YCBCR_ENC_SYCC
+             *
+             * V4L2_COLORSPACE_BT2020: V4L2_YCBCR_ENC_BT2020
+             *
+             * V4L2_COLORSPACE_SMPTE240M: V4L2_YCBCR_ENC_SMPTE240M
+             */
+            V4L2_YCBCR_ENC_DEFAULT        = 0,
+
+            /* ITU-R 601 -- SDTV */
+            V4L2_YCBCR_ENC_601            = 1,
+
+            /* Rec. 709 -- HDTV */
+            V4L2_YCBCR_ENC_709            = 2,
+
+            /* ITU-R 601/EN 61966-2-4 Extended Gamut -- SDTV */
+            V4L2_YCBCR_ENC_XV601          = 3,
+
+            /* Rec. 709/EN 61966-2-4 Extended Gamut -- HDTV */
+            V4L2_YCBCR_ENC_XV709          = 4,
+
+            /* sYCC (Y'CbCr encoding of sRGB) */
+            V4L2_YCBCR_ENC_SYCC           = 5,
+
+            /* BT.2020 Non-constant Luminance Y'CbCr */
+            V4L2_YCBCR_ENC_BT2020         = 6,
+
+            /* BT.2020 Constant Luminance Y'CbcCrc */
+            V4L2_YCBCR_ENC_BT2020_CONST_LUM = 7,
+
+            /* SMPTE 240M -- Obsolete HDTV */
+            V4L2_YCBCR_ENC_SMPTE240M      = 8,
+    };
+
+    /*
+     * Determine how YCBCR_ENC_DEFAULT should map to a proper Y'CbCr encoding.
+     * This depends on the colorspace.
+     */
+    #define V4L2_MAP_YCBCR_ENC_DEFAULT(colsp) 
+            (((colsp) == V4L2_COLORSPACE_REC709 || 
+              (colsp) == V4L2_COLORSPACE_DCI_P3) ? V4L2_YCBCR_ENC_709 : 
+             ((colsp) == V4L2_COLORSPACE_BT2020 ? V4L2_YCBCR_ENC_BT2020 : 
+              ((colsp) == V4L2_COLORSPACE_SMPTE240M ? V4L2_YCBCR_ENC_SMPTE240M : 
+               V4L2_YCBCR_ENC_601)))
+
+    enum v4l2_quantization {
+            /*
+             * The default for R'G'B' quantization is always full range, except
+             * for the BT2020 colorspace. For Y'CbCr the quantization is always
+             * limited range, except for COLORSPACE_JPEG, SYCC, XV601 or XV709:
+             * those are full range.
+             */
+            V4L2_QUANTIZATION_DEFAULT     = 0,
+            V4L2_QUANTIZATION_FULL_RANGE  = 1,
+            V4L2_QUANTIZATION_LIM_RANGE   = 2,
+    };
+
+    /*
+     * Determine how QUANTIZATION_DEFAULT should map to a proper quantization.
+     * This depends on whether the image is RGB or not, the colorspace and the
+     * Y'CbCr encoding.
+     */
+    #define V4L2_MAP_QUANTIZATION_DEFAULT(is_rgb, colsp, ycbcr_enc) 
+            (((is_rgb) && (colsp) == V4L2_COLORSPACE_BT2020) ? V4L2_QUANTIZATION_LIM_RANGE : 
+             (((is_rgb) || (ycbcr_enc) == V4L2_YCBCR_ENC_XV601 || 
+              (ycbcr_enc) == V4L2_YCBCR_ENC_XV709 || (colsp) == V4L2_COLORSPACE_JPEG) ? 
+             V4L2_QUANTIZATION_FULL_RANGE : V4L2_QUANTIZATION_LIM_RANGE))
+
+    enum v4l2_priority {
+            V4L2_PRIORITY_UNSET       = 0,  /* not initialized */
+            V4L2_PRIORITY_BACKGROUND  = 1,
+            V4L2_PRIORITY_INTERACTIVE = 2,
+            V4L2_PRIORITY_RECORD      = 3,
+            V4L2_PRIORITY_DEFAULT     = V4L2_PRIORITY_INTERACTIVE,
+    };
+
+    struct v4l2_rect {
+            __s32   left;
+            __s32   top;
+            __u32   width;
+            __u32   height;
+    };
+
+    struct v4l2_fract {
+            __u32   numerator;
+            __u32   denominator;
+    };
+
+    /**
+      * struct v4l2_capability - Describes V4L2 device caps returned by VIDIOC_QUERYCAP
+      *
+      * @driver:       name of the driver module (e.g. "bttv")
+      * @card:         name of the card (e.g. "Hauppauge WinTV")
+      * @bus_info:     name of the bus (e.g. "PCI:" + pci_name(pci_dev) )
+      * @version:      KERNEL_VERSION
+      * @capabilities: capabilities of the physical device as a whole
+      * @device_caps:  capabilities accessed via this particular device (node)
+      * @reserved:     reserved fields for future extensions
+      */
+    struct v4l2_capability {
+            __u8    driver[16];
+            __u8    card[32];
+            __u8    bus_info[32];
+            __u32   version;
+            __u32   capabilities;
+            __u32   device_caps;
+            __u32   reserved[3];
+    };
+
+    /* Values for 'capabilities' field */
+    #define V4L2_CAP_VIDEO_CAPTURE          0x00000001  /* Is a video capture device */
+    #define V4L2_CAP_VIDEO_OUTPUT           0x00000002  /* Is a video output device */
+    #define V4L2_CAP_VIDEO_OVERLAY          0x00000004  /* Can do video overlay */
+    #define V4L2_CAP_VBI_CAPTURE            0x00000010  /* Is a raw VBI capture device */
+    #define V4L2_CAP_VBI_OUTPUT             0x00000020  /* Is a raw VBI output device */
+    #define V4L2_CAP_SLICED_VBI_CAPTURE     0x00000040  /* Is a sliced VBI capture device */
+    #define V4L2_CAP_SLICED_VBI_OUTPUT      0x00000080  /* Is a sliced VBI output device */
+    #define V4L2_CAP_RDS_CAPTURE            0x00000100  /* RDS data capture */
+    #define V4L2_CAP_VIDEO_OUTPUT_OVERLAY   0x00000200  /* Can do video output overlay */
+    #define V4L2_CAP_HW_FREQ_SEEK           0x00000400  /* Can do hardware frequency seek  */
+    #define V4L2_CAP_RDS_OUTPUT             0x00000800  /* Is an RDS encoder */
+
+    /* Is a video capture device that supports multiplanar formats */
+    #define V4L2_CAP_VIDEO_CAPTURE_MPLANE   0x00001000
+    /* Is a video output device that supports multiplanar formats */
+    #define V4L2_CAP_VIDEO_OUTPUT_MPLANE    0x00002000
+    /* Is a video mem-to-mem device that supports multiplanar formats */
+    #define V4L2_CAP_VIDEO_M2M_MPLANE       0x00004000
+    /* Is a video mem-to-mem device */
+    #define V4L2_CAP_VIDEO_M2M              0x00008000
+
+    #define V4L2_CAP_TUNER                  0x00010000  /* has a tuner */
+    #define V4L2_CAP_AUDIO                  0x00020000  /* has audio support */
+    #define V4L2_CAP_RADIO                  0x00040000  /* is a radio device */
+    #define V4L2_CAP_MODULATOR              0x00080000  /* has a modulator */
+
+    #define V4L2_CAP_SDR_CAPTURE            0x00100000  /* Is a SDR capture device */
+    #define V4L2_CAP_EXT_PIX_FORMAT         0x00200000  /* Supports the extended pixel format */
+    #define V4L2_CAP_SDR_OUTPUT             0x00400000  /* Is a SDR output device */
+
+    #define V4L2_CAP_READWRITE              0x01000000  /* read/write systemcalls */
+    #define V4L2_CAP_ASYNCIO                0x02000000  /* async I/O */
+    #define V4L2_CAP_STREAMING              0x04000000  /* streaming I/O ioctls */
+
+    #define V4L2_CAP_DEVICE_CAPS            0x80000000  /* sets device capabilities field */
+
+    /*
+     *      V I D E O   I M A G E   F O R M A T
+     */
+    struct v4l2_pix_format {
+            __u32                   width;
+            __u32                   height;
+            __u32                   pixelformat;
+            __u32                   field;          /* enum v4l2_field */
+            __u32                   bytesperline;   /* for padding, zero if unused */
+            __u32                   sizeimage;
+            __u32                   colorspace;     /* enum v4l2_colorspace */
+            __u32                   priv;           /* private data, depends on pixelformat */
+            __u32                   flags;          /* format flags (V4L2_PIX_FMT_FLAG_*) */
+            __u32                   ycbcr_enc;      /* enum v4l2_ycbcr_encoding */
+            __u32                   quantization;   /* enum v4l2_quantization */
+            __u32                   xfer_func;      /* enum v4l2_xfer_func */
+    };
+
+    /*      Pixel format         FOURCC                          depth  Description  */
+
+    /* RGB formats */
+    #define V4L2_PIX_FMT_RGB332  v4l2_fourcc('R', 'G', 'B', '1') /*  8  RGB-3-3-2     */
+    #define V4L2_PIX_FMT_RGB444  v4l2_fourcc('R', '4', '4', '4') /* 16  xxxxrrrr ggggbbbb */
+    #define V4L2_PIX_FMT_ARGB444 v4l2_fourcc('A', 'R', '1', '2') /* 16  aaaarrrr ggggbbbb */
+    #define V4L2_PIX_FMT_XRGB444 v4l2_fourcc('X', 'R', '1', '2') /* 16  xxxxrrrr ggggbbbb */
+    #define V4L2_PIX_FMT_RGB555  v4l2_fourcc('R', 'G', 'B', 'O') /* 16  RGB-5-5-5     */
+    #define V4L2_PIX_FMT_ARGB555 v4l2_fourcc('A', 'R', '1', '5') /* 16  ARGB-1-5-5-5  */
+    #define V4L2_PIX_FMT_XRGB555 v4l2_fourcc('X', 'R', '1', '5') /* 16  XRGB-1-5-5-5  */
+    #define V4L2_PIX_FMT_RGB565  v4l2_fourcc('R', 'G', 'B', 'P') /* 16  RGB-5-6-5     */
+    #define V4L2_PIX_FMT_RGB555X v4l2_fourcc('R', 'G', 'B', 'Q') /* 16  RGB-5-5-5 BE  */
+    #define V4L2_PIX_FMT_ARGB555X v4l2_fourcc_be('A', 'R', '1', '5') /* 16  ARGB-5-5-5 BE */
+    #define V4L2_PIX_FMT_XRGB555X v4l2_fourcc_be('X', 'R', '1', '5') /* 16  XRGB-5-5-5 BE */
+    #define V4L2_PIX_FMT_RGB565X v4l2_fourcc('R', 'G', 'B', 'R') /* 16  RGB-5-6-5 BE  */
+    #define V4L2_PIX_FMT_BGR666  v4l2_fourcc('B', 'G', 'R', 'H') /* 18  BGR-6-6-6     */
+    #define V4L2_PIX_FMT_BGR24   v4l2_fourcc('B', 'G', 'R', '3') /* 24  BGR-8-8-8     */
+    #define V4L2_PIX_FMT_RGB24   v4l2_fourcc('R', 'G', 'B', '3') /* 24  RGB-8-8-8     */
+    #define V4L2_PIX_FMT_BGR32   v4l2_fourcc('B', 'G', 'R', '4') /* 32  BGR-8-8-8-8   */
+    #define V4L2_PIX_FMT_ABGR32  v4l2_fourcc('A', 'R', '2', '4') /* 32  BGRA-8-8-8-8  */
+    #define V4L2_PIX_FMT_XBGR32  v4l2_fourcc('X', 'R', '2', '4') /* 32  BGRX-8-8-8-8  */
+    #define V4L2_PIX_FMT_RGB32   v4l2_fourcc('R', 'G', 'B', '4') /* 32  RGB-8-8-8-8   */
+    #define V4L2_PIX_FMT_ARGB32  v4l2_fourcc('B', 'A', '2', '4') /* 32  ARGB-8-8-8-8  */
+    #define V4L2_PIX_FMT_XRGB32  v4l2_fourcc('B', 'X', '2', '4') /* 32  XRGB-8-8-8-8  */
+
+    /* Grey formats */
+    #define V4L2_PIX_FMT_GREY    v4l2_fourcc('G', 'R', 'E', 'Y') /*  8  Greyscale     */
+    #define V4L2_PIX_FMT_Y4      v4l2_fourcc('Y', '0', '4', ' ') /*  4  Greyscale     */
+    #define V4L2_PIX_FMT_Y6      v4l2_fourcc('Y', '0', '6', ' ') /*  6  Greyscale     */
+    #define V4L2_PIX_FMT_Y10     v4l2_fourcc('Y', '1', '0', ' ') /* 10  Greyscale     */
+    #define V4L2_PIX_FMT_Y12     v4l2_fourcc('Y', '1', '2', ' ') /* 12  Greyscale     */
+    #define V4L2_PIX_FMT_Y16     v4l2_fourcc('Y', '1', '6', ' ') /* 16  Greyscale     */
+    #define V4L2_PIX_FMT_Y16_BE  v4l2_fourcc_be('Y', '1', '6', ' ') /* 16  Greyscale BE  */
+
+    /* Grey bit-packed formats */
+    #define V4L2_PIX_FMT_Y10BPACK    v4l2_fourcc('Y', '1', '0', 'B') /* 10  Greyscale bit-packed */
+
+    /* Palette formats */
+    #define V4L2_PIX_FMT_PAL8    v4l2_fourcc('P', 'A', 'L', '8') /*  8  8-bit palette */
+
+    /* Chrominance formats */
+    #define V4L2_PIX_FMT_UV8     v4l2_fourcc('U', 'V', '8', ' ') /*  8  UV 4:4 */
+
+    /* Luminance+Chrominance formats */
+    #define V4L2_PIX_FMT_YVU410  v4l2_fourcc('Y', 'V', 'U', '9') /*  9  YVU 4:1:0     */
+    #define V4L2_PIX_FMT_YVU420  v4l2_fourcc('Y', 'V', '1', '2') /* 12  YVU 4:2:0     */
+    #define V4L2_PIX_FMT_YUYV    v4l2_fourcc('Y', 'U', 'Y', 'V') /* 16  YUV 4:2:2     */
+    #define V4L2_PIX_FMT_YYUV    v4l2_fourcc('Y', 'Y', 'U', 'V') /* 16  YUV 4:2:2     */
+    #define V4L2_PIX_FMT_YVYU    v4l2_fourcc('Y', 'V', 'Y', 'U') /* 16 YVU 4:2:2 */
+    #define V4L2_PIX_FMT_UYVY    v4l2_fourcc('U', 'Y', 'V', 'Y') /* 16  YUV 4:2:2     */
+    #define V4L2_PIX_FMT_VYUY    v4l2_fourcc('V', 'Y', 'U', 'Y') /* 16  YUV 4:2:2     */
+    #define V4L2_PIX_FMT_YUV422P v4l2_fourcc('4', '2', '2', 'P') /* 16  YVU422 planar */
+    #define V4L2_PIX_FMT_YUV411P v4l2_fourcc('4', '1', '1', 'P') /* 16  YVU411 planar */
+    #define V4L2_PIX_FMT_Y41P    v4l2_fourcc('Y', '4', '1', 'P') /* 12  YUV 4:1:1     */
+    #define V4L2_PIX_FMT_YUV444  v4l2_fourcc('Y', '4', '4', '4') /* 16  xxxxyyyy uuuuvvvv */
+    #define V4L2_PIX_FMT_YUV555  v4l2_fourcc('Y', 'U', 'V', 'O') /* 16  YUV-5-5-5     */
+    #define V4L2_PIX_FMT_YUV565  v4l2_fourcc('Y', 'U', 'V', 'P') /* 16  YUV-5-6-5     */
+    #define V4L2_PIX_FMT_YUV32   v4l2_fourcc('Y', 'U', 'V', '4') /* 32  YUV-8-8-8-8   */
+    #define V4L2_PIX_FMT_YUV410  v4l2_fourcc('Y', 'U', 'V', '9') /*  9  YUV 4:1:0     */
+    #define V4L2_PIX_FMT_YUV420  v4l2_fourcc('Y', 'U', '1', '2') /* 12  YUV 4:2:0     */
+    #define V4L2_PIX_FMT_HI240   v4l2_fourcc('H', 'I', '2', '4') /*  8  8-bit color   */
+    #define V4L2_PIX_FMT_HM12    v4l2_fourcc('H', 'M', '1', '2') /*  8  YUV 4:2:0 16x16 macroblocks */
+    #define V4L2_PIX_FMT_M420    v4l2_fourcc('M', '4', '2', '0') /* 12  YUV 4:2:0 2 lines y, 1 line uv interleaved */
+
+    /* two planes -- one Y, one Cr + Cb interleaved  */
+    #define V4L2_PIX_FMT_NV12    v4l2_fourcc('N', 'V', '1', '2') /* 12  Y/CbCr 4:2:0  */
+    #define V4L2_PIX_FMT_NV21    v4l2_fourcc('N', 'V', '2', '1') /* 12  Y/CrCb 4:2:0  */
+    #define V4L2_PIX_FMT_NV16    v4l2_fourcc('N', 'V', '1', '6') /* 16  Y/CbCr 4:2:2  */
+    #define V4L2_PIX_FMT_NV61    v4l2_fourcc('N', 'V', '6', '1') /* 16  Y/CrCb 4:2:2  */
+    #define V4L2_PIX_FMT_NV24    v4l2_fourcc('N', 'V', '2', '4') /* 24  Y/CbCr 4:4:4  */
+    #define V4L2_PIX_FMT_NV42    v4l2_fourcc('N', 'V', '4', '2') /* 24  Y/CrCb 4:4:4  */
+
+    /* two non contiguous planes - one Y, one Cr + Cb interleaved  */
+    #define V4L2_PIX_FMT_NV12M   v4l2_fourcc('N', 'M', '1', '2') /* 12  Y/CbCr 4:2:0  */
+    #define V4L2_PIX_FMT_NV21M   v4l2_fourcc('N', 'M', '2', '1') /* 21  Y/CrCb 4:2:0  */
+    #define V4L2_PIX_FMT_NV16M   v4l2_fourcc('N', 'M', '1', '6') /* 16  Y/CbCr 4:2:2  */
+    #define V4L2_PIX_FMT_NV61M   v4l2_fourcc('N', 'M', '6', '1') /* 16  Y/CrCb 4:2:2  */
+    #define V4L2_PIX_FMT_NV12MT  v4l2_fourcc('T', 'M', '1', '2') /* 12  Y/CbCr 4:2:0 64x32 macroblocks */
+    #define V4L2_PIX_FMT_NV12MT_16X16 v4l2_fourcc('V', 'M', '1', '2') /* 12  Y/CbCr 4:2:0 16x16 macroblocks */
+
+    /* three non contiguous planes - Y, Cb, Cr */
+    #define V4L2_PIX_FMT_YUV420M v4l2_fourcc('Y', 'M', '1', '2') /* 12  YUV420 planar */
+    #define V4L2_PIX_FMT_YVU420M v4l2_fourcc('Y', 'M', '2', '1') /* 12  YVU420 planar */
+    #define V4L2_PIX_FMT_YUV422M v4l2_fourcc('Y', 'M', '1', '6') /* 16  YUV422 planar */
+    #define V4L2_PIX_FMT_YVU422M v4l2_fourcc('Y', 'M', '6', '1') /* 16  YVU422 planar */
+    #define V4L2_PIX_FMT_YUV444M v4l2_fourcc('Y', 'M', '2', '4') /* 24  YUV444 planar */
+    #define V4L2_PIX_FMT_YVU444M v4l2_fourcc('Y', 'M', '4', '2') /* 24  YVU444 planar */
+
+    /* Bayer formats - see http://www.siliconimaging.com/RGB%20Bayer.htm */
+    #define V4L2_PIX_FMT_SBGGR8  v4l2_fourcc('B', 'A', '8', '1') /*  8  BGBG.. GRGR.. */
+    #define V4L2_PIX_FMT_SGBRG8  v4l2_fourcc('G', 'B', 'R', 'G') /*  8  GBGB.. RGRG.. */
+    #define V4L2_PIX_FMT_SGRBG8  v4l2_fourcc('G', 'R', 'B', 'G') /*  8  GRGR.. BGBG.. */
+    #define V4L2_PIX_FMT_SRGGB8  v4l2_fourcc('R', 'G', 'G', 'B') /*  8  RGRG.. GBGB.. */
+    #define V4L2_PIX_FMT_SBGGR10 v4l2_fourcc('B', 'G', '1', '0') /* 10  BGBG.. GRGR.. */
+    #define V4L2_PIX_FMT_SGBRG10 v4l2_fourcc('G', 'B', '1', '0') /* 10  GBGB.. RGRG.. */
+    #define V4L2_PIX_FMT_SGRBG10 v4l2_fourcc('B', 'A', '1', '0') /* 10  GRGR.. BGBG.. */
+    #define V4L2_PIX_FMT_SRGGB10 v4l2_fourcc('R', 'G', '1', '0') /* 10  RGRG.. GBGB.. */
+            /* 10bit raw bayer packed, 5 bytes for every 4 pixels */
+    #define V4L2_PIX_FMT_SBGGR10P v4l2_fourcc('p', 'B', 'A', 'A')
+    #define V4L2_PIX_FMT_SGBRG10P v4l2_fourcc('p', 'G', 'A', 'A')
+    #define V4L2_PIX_FMT_SGRBG10P v4l2_fourcc('p', 'g', 'A', 'A')
+    #define V4L2_PIX_FMT_SRGGB10P v4l2_fourcc('p', 'R', 'A', 'A')
+            /* 10bit raw bayer a-law compressed to 8 bits */
+    #define V4L2_PIX_FMT_SBGGR10ALAW8 v4l2_fourcc('a', 'B', 'A', '8')
+    #define V4L2_PIX_FMT_SGBRG10ALAW8 v4l2_fourcc('a', 'G', 'A', '8')
+    #define V4L2_PIX_FMT_SGRBG10ALAW8 v4l2_fourcc('a', 'g', 'A', '8')
+    #define V4L2_PIX_FMT_SRGGB10ALAW8 v4l2_fourcc('a', 'R', 'A', '8')
+            /* 10bit raw bayer DPCM compressed to 8 bits */
+    #define V4L2_PIX_FMT_SBGGR10DPCM8 v4l2_fourcc('b', 'B', 'A', '8')
+    #define V4L2_PIX_FMT_SGBRG10DPCM8 v4l2_fourcc('b', 'G', 'A', '8')
+    #define V4L2_PIX_FMT_SGRBG10DPCM8 v4l2_fourcc('B', 'D', '1', '0')
+    #define V4L2_PIX_FMT_SRGGB10DPCM8 v4l2_fourcc('b', 'R', 'A', '8')
+    #define V4L2_PIX_FMT_SBGGR12 v4l2_fourcc('B', 'G', '1', '2') /* 12  BGBG.. GRGR.. */
+    #define V4L2_PIX_FMT_SGBRG12 v4l2_fourcc('G', 'B', '1', '2') /* 12  GBGB.. RGRG.. */
+    #define V4L2_PIX_FMT_SGRBG12 v4l2_fourcc('B', 'A', '1', '2') /* 12  GRGR.. BGBG.. */
+    #define V4L2_PIX_FMT_SRGGB12 v4l2_fourcc('R', 'G', '1', '2') /* 12  RGRG.. GBGB.. */
+    #define V4L2_PIX_FMT_SBGGR16 v4l2_fourcc('B', 'Y', 'R', '2') /* 16  BGBG.. GRGR.. */
+
+    /* compressed formats */
+    #define V4L2_PIX_FMT_MJPEG    v4l2_fourcc('M', 'J', 'P', 'G') /* Motion-JPEG   */
+    #define V4L2_PIX_FMT_JPEG     v4l2_fourcc('J', 'P', 'E', 'G') /* JFIF JPEG     */
+    #define V4L2_PIX_FMT_DV       v4l2_fourcc('d', 'v', 's', 'd') /* 1394          */
+    #define V4L2_PIX_FMT_MPEG     v4l2_fourcc('M', 'P', 'E', 'G') /* MPEG-1/2/4 Multiplexed */
+    #define V4L2_PIX_FMT_H264     v4l2_fourcc('H', '2', '6', '4') /* H264 with start codes */
+    #define V4L2_PIX_FMT_H264_NO_SC v4l2_fourcc('A', 'V', 'C', '1') /* H264 without start codes */
+    #define V4L2_PIX_FMT_H264_MVC v4l2_fourcc('M', '2', '6', '4') /* H264 MVC */
+    #define V4L2_PIX_FMT_H263     v4l2_fourcc('H', '2', '6', '3') /* H263          */
+    #define V4L2_PIX_FMT_MPEG1    v4l2_fourcc('M', 'P', 'G', '1') /* MPEG-1 ES     */
+    #define V4L2_PIX_FMT_MPEG2    v4l2_fourcc('M', 'P', 'G', '2') /* MPEG-2 ES     */
+    #define V4L2_PIX_FMT_MPEG4    v4l2_fourcc('M', 'P', 'G', '4') /* MPEG-4 part 2 ES */
+    #define V4L2_PIX_FMT_XVID     v4l2_fourcc('X', 'V', 'I', 'D') /* Xvid           */
+    #define V4L2_PIX_FMT_VC1_ANNEX_G v4l2_fourcc('V', 'C', '1', 'G') /* SMPTE 421M Annex G compliant stream */
+    #define V4L2_PIX_FMT_VC1_ANNEX_L v4l2_fourcc('V', 'C', '1', 'L') /* SMPTE 421M Annex L compliant stream */
+    #define V4L2_PIX_FMT_VP8      v4l2_fourcc('V', 'P', '8', '0') /* VP8 */
+
+    /*  Vendor-specific formats   */
+    #define V4L2_PIX_FMT_CPIA1    v4l2_fourcc('C', 'P', 'I', 'A') /* cpia1 YUV */
+    #define V4L2_PIX_FMT_WNVA     v4l2_fourcc('W', 'N', 'V', 'A') /* Winnov hw compress */
+    #define V4L2_PIX_FMT_SN9C10X  v4l2_fourcc('S', '9', '1', '0') /* SN9C10x compression */
+    #define V4L2_PIX_FMT_SN9C20X_I420 v4l2_fourcc('S', '9', '2', '0') /* SN9C20x YUV 4:2:0 */
+    #define V4L2_PIX_FMT_PWC1     v4l2_fourcc('P', 'W', 'C', '1') /* pwc older webcam */
+    #define V4L2_PIX_FMT_PWC2     v4l2_fourcc('P', 'W', 'C', '2') /* pwc newer webcam */
+    #define V4L2_PIX_FMT_ET61X251 v4l2_fourcc('E', '6', '2', '5') /* ET61X251 compression */
+    #define V4L2_PIX_FMT_SPCA501  v4l2_fourcc('S', '5', '0', '1') /* YUYV per line */
+    #define V4L2_PIX_FMT_SPCA505  v4l2_fourcc('S', '5', '0', '5') /* YYUV per line */
+    #define V4L2_PIX_FMT_SPCA508  v4l2_fourcc('S', '5', '0', '8') /* YUVY per line */
+    #define V4L2_PIX_FMT_SPCA561  v4l2_fourcc('S', '5', '6', '1') /* compressed GBRG bayer */
+    #define V4L2_PIX_FMT_PAC207   v4l2_fourcc('P', '2', '0', '7') /* compressed BGGR bayer */
+    #define V4L2_PIX_FMT_MR97310A v4l2_fourcc('M', '3', '1', '0') /* compressed BGGR bayer */
+    #define V4L2_PIX_FMT_JL2005BCD v4l2_fourcc('J', 'L', '2', '0') /* compressed RGGB bayer */
+    #define V4L2_PIX_FMT_SN9C2028 v4l2_fourcc('S', 'O', 'N', 'X') /* compressed GBRG bayer */
+    #define V4L2_PIX_FMT_SQ905C   v4l2_fourcc('9', '0', '5', 'C') /* compressed RGGB bayer */
+    #define V4L2_PIX_FMT_PJPG     v4l2_fourcc('P', 'J', 'P', 'G') /* Pixart 73xx JPEG */
+    #define V4L2_PIX_FMT_OV511    v4l2_fourcc('O', '5', '1', '1') /* ov511 JPEG */
+    #define V4L2_PIX_FMT_OV518    v4l2_fourcc('O', '5', '1', '8') /* ov518 JPEG */
+    #define V4L2_PIX_FMT_STV0680  v4l2_fourcc('S', '6', '8', '0') /* stv0680 bayer */
+    #define V4L2_PIX_FMT_TM6000   v4l2_fourcc('T', 'M', '6', '0') /* tm5600/tm60x0 */
+    #define V4L2_PIX_FMT_CIT_YYVYUY v4l2_fourcc('C', 'I', 'T', 'V') /* one line of Y then 1 line of VYUY */
+    #define V4L2_PIX_FMT_KONICA420  v4l2_fourcc('K', 'O', 'N', 'I') /* YUV420 planar in blocks of 256 pixels */
+    #define V4L2_PIX_FMT_JPGL       v4l2_fourcc('J', 'P', 'G', 'L') /* JPEG-Lite */
+    #define V4L2_PIX_FMT_SE401      v4l2_fourcc('S', '4', '0', '1') /* se401 janggu compressed rgb */
+    #define V4L2_PIX_FMT_S5C_UYVY_JPG v4l2_fourcc('S', '5', 'C', 'I') /* S5C73M3 interleaved UYVY/JPEG */
+    #define V4L2_PIX_FMT_Y8I      v4l2_fourcc('Y', '8', 'I', ' ') /* Greyscale 8-bit L/R interleaved */
+    #define V4L2_PIX_FMT_Y12I     v4l2_fourcc('Y', '1', '2', 'I') /* Greyscale 12-bit L/R interleaved */
+    #define V4L2_PIX_FMT_Z16      v4l2_fourcc('Z', '1', '6', ' ') /* Depth data 16-bit */
+
+    /* SDR formats - used only for Software Defined Radio devices */
+    #define V4L2_SDR_FMT_CU8          v4l2_fourcc('C', 'U', '0', '8') /* IQ u8 */
+    #define V4L2_SDR_FMT_CU16LE       v4l2_fourcc('C', 'U', '1', '6') /* IQ u16le */
+    #define V4L2_SDR_FMT_CS8          v4l2_fourcc('C', 'S', '0', '8') /* complex s8 */
+    #define V4L2_SDR_FMT_CS14LE       v4l2_fourcc('C', 'S', '1', '4') /* complex s14le */
+    #define V4L2_SDR_FMT_RU12LE       v4l2_fourcc('R', 'U', '1', '2') /* real u12le */
+
+    /* priv field value to indicates that subsequent fields are valid. */
+    #define V4L2_PIX_FMT_PRIV_MAGIC         0xfeedcafe
+
+    /* Flags */
+    #define V4L2_PIX_FMT_FLAG_PREMUL_ALPHA  0x00000001
+
+    /*
+     *      F O R M A T   E N U M E R A T I O N
+     */
+    struct v4l2_fmtdesc {
+            __u32               index;             /* Format number      */
+            __u32               type;              /* enum v4l2_buf_type */
+            __u32               flags;
+            __u8                description[32];   /* Description string */
+            __u32               pixelformat;       /* Format fourcc      */
+            __u32               reserved[4];
+    };
+
+    #define V4L2_FMT_FLAG_COMPRESSED 0x0001
+    #define V4L2_FMT_FLAG_EMULATED   0x0002
+
+            /* Frame Size and frame rate enumeration */
+    /*
+     *      F R A M E   S I Z E   E N U M E R A T I O N
+     */
+    enum v4l2_frmsizetypes {
+            V4L2_FRMSIZE_TYPE_DISCRETE      = 1,
+            V4L2_FRMSIZE_TYPE_CONTINUOUS    = 2,
+            V4L2_FRMSIZE_TYPE_STEPWISE      = 3,
+    };
+
+    struct v4l2_frmsize_discrete {
+            __u32                   width;          /* Frame width [pixel] */
+            __u32                   height;         /* Frame height [pixel] */
+    };
+
+    struct v4l2_frmsize_stepwise {
+            __u32                   min_width;      /* Minimum frame width [pixel] */
+            __u32                   max_width;      /* Maximum frame width [pixel] */
+            __u32                   step_width;     /* Frame width step size [pixel] */
+            __u32                   min_height;     /* Minimum frame height [pixel] */
+            __u32                   max_height;     /* Maximum frame height [pixel] */
+            __u32                   step_height;    /* Frame height step size [pixel] */
+    };
+
+    struct v4l2_frmsizeenum {
+            __u32                   index;          /* Frame size number */
+            __u32                   pixel_format;   /* Pixel format */
+            __u32                   type;           /* Frame size type the device supports. */
+
+            union {                                 /* Frame size */
+                    struct v4l2_frmsize_discrete    discrete;
+                    struct v4l2_frmsize_stepwise    stepwise;
+            };
+
+            __u32   reserved[2];                    /* Reserved space for future use */
+    };
+
+    /*
+     *      F R A M E   R A T E   E N U M E R A T I O N
+     */
+    enum v4l2_frmivaltypes {
+            V4L2_FRMIVAL_TYPE_DISCRETE      = 1,
+            V4L2_FRMIVAL_TYPE_CONTINUOUS    = 2,
+            V4L2_FRMIVAL_TYPE_STEPWISE      = 3,
+    };
+
+    struct v4l2_frmival_stepwise {
+            struct v4l2_fract       min;            /* Minimum frame interval [s] */
+            struct v4l2_fract       max;            /* Maximum frame interval [s] */
+            struct v4l2_fract       step;           /* Frame interval step size [s] */
+    };
+
+    struct v4l2_frmivalenum {
+            __u32                   index;          /* Frame format index */
+            __u32                   pixel_format;   /* Pixel format */
+            __u32                   width;          /* Frame width */
+            __u32                   height;         /* Frame height */
+            __u32                   type;           /* Frame interval type the device supports. */
+
+            union {                                 /* Frame interval */
+                    struct v4l2_fract               discrete;
+                    struct v4l2_frmival_stepwise    stepwise;
+            };
+
+            __u32   reserved[2];                    /* Reserved space for future use */
+    };
+
+    /*
+     *      T I M E C O D E
+     */
+    struct v4l2_timecode {
+            __u32   type;
+            __u32   flags;
+            __u8    frames;
+            __u8    seconds;
+            __u8    minutes;
+            __u8    hours;
+            __u8    userbits[4];
+    };
+
+    /*  Type  */
+    #define V4L2_TC_TYPE_24FPS              1
+    #define V4L2_TC_TYPE_25FPS              2
+    #define V4L2_TC_TYPE_30FPS              3
+    #define V4L2_TC_TYPE_50FPS              4
+    #define V4L2_TC_TYPE_60FPS              5
+
+    /*  Flags  */
+    #define V4L2_TC_FLAG_DROPFRAME          0x0001 /* "drop-frame" mode */
+    #define V4L2_TC_FLAG_COLORFRAME         0x0002
+    #define V4L2_TC_USERBITS_field          0x000C
+    #define V4L2_TC_USERBITS_USERDEFINED    0x0000
+    #define V4L2_TC_USERBITS_8BITCHARS      0x0008
+    /* The above is based on SMPTE timecodes */
+
+    struct v4l2_jpegcompression {
+            int quality;
+
+            int  APPn;              /* Number of APP segment to be written,
+                                     * must be 0..15 */
+            int  APP_len;           /* Length of data in JPEG APPn segment */
+            char APP_data[60];      /* Data in the JPEG APPn segment. */
+
+            int  COM_len;           /* Length of data in JPEG COM segment */
+            char COM_data[60];      /* Data in JPEG COM segment */
+
+            __u32 jpeg_markers;     /* Which markers should go into the JPEG
+                                     * output. Unless you exactly know what
+                                     * you do, leave them untouched.
+                                     * Including less markers will make the
+                                     * resulting code smaller, but there will
+                                     * be fewer applications which can read it.
+                                     * The presence of the APP and COM marker
+                                     * is influenced by APP_len and COM_len
+                                     * ONLY, not by this property! */
+
+    #define V4L2_JPEG_MARKER_DHT (1<<3)    /* Define Huffman Tables */
+    #define V4L2_JPEG_MARKER_DQT (1<<4)    /* Define Quantization Tables */
+    #define V4L2_JPEG_MARKER_DRI (1<<5)    /* Define Restart Interval */
+    #define V4L2_JPEG_MARKER_COM (1<<6)    /* Comment segment */
+    #define V4L2_JPEG_MARKER_APP (1<<7)    /* App segment, driver will
+                                            * always use APP0 */
+    };
+
+    /*
+     *      M E M O R Y - M A P P I N G   B U F F E R S
+     */
+    struct v4l2_requestbuffers {
+            __u32                   count;
+            __u32                   type;           /* enum v4l2_buf_type */
+            __u32                   memory;         /* enum v4l2_memory */
+            __u32                   reserved[2];
+    };
+
+    /**
+     * struct v4l2_plane - plane info for multi-planar buffers
+     * @bytesused:          number of bytes occupied by data in the plane (payload)
+     * @length:             size of this plane (NOT the payload) in bytes
+     * @mem_offset:         when memory in the associated struct v4l2_buffer is
+     *                      V4L2_MEMORY_MMAP, equals the offset from the start of
+     *                      the device memory for this plane (or is a "cookie" that
+     *                      should be passed to mmap() called on the video node)
+     * @userptr:            when memory is V4L2_MEMORY_USERPTR, a userspace pointer
+     *                      pointing to this plane
+     * @fd:                 when memory is V4L2_MEMORY_DMABUF, a userspace file
+     *                      descriptor associated with this plane
+     * @data_offset:        offset in the plane to the start of data; usually 0,
+     *                      unless there is a header in front of the data
+     *
+     * Multi-planar buffers consist of one or more planes, e.g. an YCbCr buffer
+     * with two planes can have one plane for Y, and another for interleaved CbCr
+     * components. Each plane can reside in a separate memory buffer, or even in
+     * a completely separate memory node (e.g. in embedded devices).
+     */
+    struct v4l2_plane {
+            __u32                   bytesused;
+            __u32                   length;
+            union {
+                    __u32           mem_offset;
+                    unsigned long   userptr;
+                    __s32           fd;
+            } m;
+            __u32                   data_offset;
+            __u32                   reserved[11];
+    };
+
+    /**
+     * struct v4l2_buffer - video buffer info
+     * @index:      id number of the buffer
+     * @type:       enum v4l2_buf_type; buffer type (type == *_MPLANE for
+     *              multiplanar buffers);
+     * @bytesused:  number of bytes occupied by data in the buffer (payload);
+     *              unused (set to 0) for multiplanar buffers
+     * @flags:      buffer informational flags
+     * @field:      enum v4l2_field; field order of the image in the buffer
+     * @timestamp:  frame timestamp
+     * @timecode:   frame timecode
+     * @sequence:   sequence count of this frame
+     * @memory:     enum v4l2_memory; the method, in which the actual video data is
+     *              passed
+     * @offset:     for non-multiplanar buffers with memory == V4L2_MEMORY_MMAP;
+     *              offset from the start of the device memory for this plane,
+     *              (or a "cookie" that should be passed to mmap() as offset)
+     * @userptr:    for non-multiplanar buffers with memory == V4L2_MEMORY_USERPTR;
+     *              a userspace pointer pointing to this buffer
+     * @fd:         for non-multiplanar buffers with memory == V4L2_MEMORY_DMABUF;
+     *              a userspace file descriptor associated with this buffer
+     * @planes:     for multiplanar buffers; userspace pointer to the array of plane
+     *              info structs for this buffer
+     * @length:     size in bytes of the buffer (NOT its payload) for single-plane
+     *              buffers (when type != *_MPLANE); number of elements in the
+     *              planes array for multi-plane buffers
+     *
+     * Contains data exchanged by application and driver using one of the Streaming
+     * I/O methods.
+     */
+    struct v4l2_buffer {
+            __u32                   index;
+            __u32                   type;
+            __u32                   bytesused;
+            __u32                   flags;
+            __u32                   field;
+            struct timeval          timestamp;
+            struct v4l2_timecode    timecode;
+            __u32                   sequence;
+
+            /* memory location */
+            __u32                   memory;
+            union {
+                    __u32           offset;
+                    unsigned long   userptr;
+                    struct v4l2_plane *planes;
+                    __s32           fd;
+            } m;
+            __u32                   length;
+            __u32                   reserved2;
+            __u32                   reserved;
+    };
+
+    /*  Flags for 'flags' field */
+    /* Buffer is mapped (flag) */
+    #define V4L2_BUF_FLAG_MAPPED                    0x00000001
+    /* Buffer is queued for processing */
+    #define V4L2_BUF_FLAG_QUEUED                    0x00000002
+    /* Buffer is ready */
+    #define V4L2_BUF_FLAG_DONE                      0x00000004
+    /* Image is a keyframe (I-frame) */
+    #define V4L2_BUF_FLAG_KEYFRAME                  0x00000008
+    /* Image is a P-frame */
+    #define V4L2_BUF_FLAG_PFRAME                    0x00000010
+    /* Image is a B-frame */
+    #define V4L2_BUF_FLAG_BFRAME                    0x00000020
+    /* Buffer is ready, but the data contained within is corrupted. */
+    #define V4L2_BUF_FLAG_ERROR                     0x00000040
+    /* timecode field is valid */
+    #define V4L2_BUF_FLAG_TIMECODE                  0x00000100
+    /* Buffer is prepared for queuing */
+    #define V4L2_BUF_FLAG_PREPARED                  0x00000400
+    /* Cache handling flags */
+    #define V4L2_BUF_FLAG_NO_CACHE_INVALIDATE       0x00000800
+    #define V4L2_BUF_FLAG_NO_CACHE_CLEAN            0x00001000
+    /* Timestamp type */
+    #define V4L2_BUF_FLAG_TIMESTAMP_MASK            0x0000e000
+    #define V4L2_BUF_FLAG_TIMESTAMP_UNKNOWN         0x00000000
+    #define V4L2_BUF_FLAG_TIMESTAMP_MONOTONIC       0x00002000
+    #define V4L2_BUF_FLAG_TIMESTAMP_COPY            0x00004000
+    /* Timestamp sources. */
+    #define V4L2_BUF_FLAG_TSTAMP_SRC_MASK           0x00070000
+    #define V4L2_BUF_FLAG_TSTAMP_SRC_EOF            0x00000000
+    #define V4L2_BUF_FLAG_TSTAMP_SRC_SOE            0x00010000
+    /* mem2mem encoder/decoder */
+    #define V4L2_BUF_FLAG_LAST                      0x00100000
+
+    /**
+     * struct v4l2_exportbuffer - export of video buffer as DMABUF file descriptor
+     *
+     * @index:      id number of the buffer
+     * @type:       enum v4l2_buf_type; buffer type (type == *_MPLANE for
+     *              multiplanar buffers);
+     * @plane:      index of the plane to be exported, 0 for single plane queues
+     * @flags:      flags for newly created file, currently only O_CLOEXEC is
+     *              supported, refer to manual of open syscall for more details
+     * @fd:         file descriptor associated with DMABUF (set by driver)
+     *
+     * Contains data used for exporting a video buffer as DMABUF file descriptor.
+     * The buffer is identified by a 'cookie' returned by VIDIOC_QUERYBUF
+     * (identical to the cookie used to mmap() the buffer to userspace). All
+     * reserved fields must be set to zero. The field reserved0 is expected to
+     * become a structure 'type' allowing an alternative layout of the structure
+     * content. Therefore this field should not be used for any other extensions.
+     */
+    struct v4l2_exportbuffer {
+            __u32           type; /* enum v4l2_buf_type */
+            __u32           index;
+            __u32           plane;
+            __u32           flags;
+            __s32           fd;
+            __u32           reserved[11];
+    };
+
+    /*
+     *      O V E R L A Y   P R E V I E W
+     */
+    struct v4l2_framebuffer {
+            __u32                   capability;
+            __u32                   flags;
+    /* FIXME: in theory we should pass something like PCI device + memory
+     * region + offset instead of some physical address */
+            void                    *base;
+            struct {
+                    __u32           width;
+                    __u32           height;
+                    __u32           pixelformat;
+                    __u32           field;          /* enum v4l2_field */
+                    __u32           bytesperline;   /* for padding, zero if unused */
+                    __u32           sizeimage;
+                    __u32           colorspace;     /* enum v4l2_colorspace */
+                    __u32           priv;           /* reserved field, set to 0 */
+            } fmt;
+    };
+    /*  Flags for the 'capability' field. Read only */
+    #define V4L2_FBUF_CAP_EXTERNOVERLAY     0x0001
+    #define V4L2_FBUF_CAP_CHROMAKEY         0x0002
+    #define V4L2_FBUF_CAP_LIST_CLIPPING     0x0004
+    #define V4L2_FBUF_CAP_BITMAP_CLIPPING   0x0008
+    #define V4L2_FBUF_CAP_LOCAL_ALPHA       0x0010
+    #define V4L2_FBUF_CAP_GLOBAL_ALPHA      0x0020
+    #define V4L2_FBUF_CAP_LOCAL_INV_ALPHA   0x0040
+    #define V4L2_FBUF_CAP_SRC_CHROMAKEY     0x0080
+    /*  Flags for the 'flags' field. */
+    #define V4L2_FBUF_FLAG_PRIMARY          0x0001
+    #define V4L2_FBUF_FLAG_OVERLAY          0x0002
+    #define V4L2_FBUF_FLAG_CHROMAKEY        0x0004
+    #define V4L2_FBUF_FLAG_LOCAL_ALPHA      0x0008
+    #define V4L2_FBUF_FLAG_GLOBAL_ALPHA     0x0010
+    #define V4L2_FBUF_FLAG_LOCAL_INV_ALPHA  0x0020
+    #define V4L2_FBUF_FLAG_SRC_CHROMAKEY    0x0040
+
+    struct v4l2_clip {
+            struct v4l2_rect        c;
+            struct v4l2_clip        __user *next;
+    };
+
+    struct v4l2_window {
+            struct v4l2_rect        w;
+            __u32                   field;   /* enum v4l2_field */
+            __u32                   chromakey;
+            struct v4l2_clip        __user *clips;
+            __u32                   clipcount;
+            void                    __user *bitmap;
+            __u8                    global_alpha;
+    };
+
+    /*
+     *      C A P T U R E   P A R A M E T E R S
+     */
+    struct v4l2_captureparm {
+            __u32              capability;    /*  Supported modes */
+            __u32              capturemode;   /*  Current mode */
+            struct v4l2_fract  timeperframe;  /*  Time per frame in seconds */
+            __u32              extendedmode;  /*  Driver-specific extensions */
+            __u32              readbuffers;   /*  # of buffers for read */
+            __u32              reserved[4];
+    };
+
+    /*  Flags for 'capability' and 'capturemode' fields */
+    #define V4L2_MODE_HIGHQUALITY   0x0001  /*  High quality imaging mode */
+    #define V4L2_CAP_TIMEPERFRAME   0x1000  /*  timeperframe field is supported */
+
+    struct v4l2_outputparm {
+            __u32              capability;   /*  Supported modes */
+            __u32              outputmode;   /*  Current mode */
+            struct v4l2_fract  timeperframe; /*  Time per frame in seconds */
+            __u32              extendedmode; /*  Driver-specific extensions */
+            __u32              writebuffers; /*  # of buffers for write */
+            __u32              reserved[4];
+    };
+
+    /*
+     *      I N P U T   I M A G E   C R O P P I N G
+     */
+    struct v4l2_cropcap {
+            __u32                   type;   /* enum v4l2_buf_type */
+            struct v4l2_rect        bounds;
+            struct v4l2_rect        defrect;
+            struct v4l2_fract       pixelaspect;
+    };
+
+    struct v4l2_crop {
+            __u32                   type;   /* enum v4l2_buf_type */
+            struct v4l2_rect        c;
+    };
+
+    /**
+     * struct v4l2_selection - selection info
+     * @type:       buffer type (do not use *_MPLANE types)
+     * @target:     Selection target, used to choose one of possible rectangles;
+     *              defined in v4l2-common.h; V4L2_SEL_TGT_* .
+     * @flags:      constraints flags, defined in v4l2-common.h; V4L2_SEL_FLAG_*.
+     * @r:          coordinates of selection window
+     * @reserved:   for future use, rounds structure size to 64 bytes, set to zero
+     *
+     * Hardware may use multiple helper windows to process a video stream.
+     * The structure is used to exchange this selection areas between
+     * an application and a driver.
+     */
+    struct v4l2_selection {
+            __u32                   type;
+            __u32                   target;
+            __u32                   flags;
+            struct v4l2_rect        r;
+            __u32                   reserved[9];
+    };
+
+
+    /*
+     *      A N A L O G   V I D E O   S T A N D A R D
+     */
+
+    typedef __u64 v4l2_std_id;
+
+    /* one bit for each */
+    #define V4L2_STD_PAL_B          ((v4l2_std_id)0x00000001)
+    #define V4L2_STD_PAL_B1         ((v4l2_std_id)0x00000002)
+    #define V4L2_STD_PAL_G          ((v4l2_std_id)0x00000004)
+    #define V4L2_STD_PAL_H          ((v4l2_std_id)0x00000008)
+    #define V4L2_STD_PAL_I          ((v4l2_std_id)0x00000010)
+    #define V4L2_STD_PAL_D          ((v4l2_std_id)0x00000020)
+    #define V4L2_STD_PAL_D1         ((v4l2_std_id)0x00000040)
+    #define V4L2_STD_PAL_K          ((v4l2_std_id)0x00000080)
+
+    #define V4L2_STD_PAL_M          ((v4l2_std_id)0x00000100)
+    #define V4L2_STD_PAL_N          ((v4l2_std_id)0x00000200)
+    #define V4L2_STD_PAL_Nc         ((v4l2_std_id)0x00000400)
+    #define V4L2_STD_PAL_60         ((v4l2_std_id)0x00000800)
+
+    #define V4L2_STD_NTSC_M         ((v4l2_std_id)0x00001000)       /* BTSC */
+    #define V4L2_STD_NTSC_M_JP      ((v4l2_std_id)0x00002000)       /* EIA-J */
+    #define V4L2_STD_NTSC_443       ((v4l2_std_id)0x00004000)
+    #define V4L2_STD_NTSC_M_KR      ((v4l2_std_id)0x00008000)       /* FM A2 */
+
+    #define V4L2_STD_SECAM_B        ((v4l2_std_id)0x00010000)
+    #define V4L2_STD_SECAM_D        ((v4l2_std_id)0x00020000)
+    #define V4L2_STD_SECAM_G        ((v4l2_std_id)0x00040000)
+    #define V4L2_STD_SECAM_H        ((v4l2_std_id)0x00080000)
+    #define V4L2_STD_SECAM_K        ((v4l2_std_id)0x00100000)
+    #define V4L2_STD_SECAM_K1       ((v4l2_std_id)0x00200000)
+    #define V4L2_STD_SECAM_L        ((v4l2_std_id)0x00400000)
+    #define V4L2_STD_SECAM_LC       ((v4l2_std_id)0x00800000)
+
+    /* ATSC/HDTV */
+    #define V4L2_STD_ATSC_8_VSB     ((v4l2_std_id)0x01000000)
+    #define V4L2_STD_ATSC_16_VSB    ((v4l2_std_id)0x02000000)
+
+    /* FIXME:
+       Although std_id is 64 bits, there is an issue on PPC32 architecture that
+       makes switch(__u64) to break. So, there's a hack on v4l2-common.c rounding
+       this value to 32 bits.
+       As, currently, the max value is for V4L2_STD_ATSC_16_VSB (30 bits wide),
+       it should work fine. However, if needed to add more than two standards,
+       v4l2-common.c should be fixed.
+     */
+
+    /*
+     * Some macros to merge video standards in order to make live easier for the
+     * drivers and V4L2 applications
+     */
+
+    /*
+     * "Common" NTSC/M - It should be noticed that V4L2_STD_NTSC_443 is
+     * Missing here.
+     */
+    #define V4L2_STD_NTSC           (V4L2_STD_NTSC_M        |
+                                     V4L2_STD_NTSC_M_JP     |
+                                     V4L2_STD_NTSC_M_KR)
+    /* Secam macros */
+    #define V4L2_STD_SECAM_DK       (V4L2_STD_SECAM_D       |
+                                     V4L2_STD_SECAM_K       |
+                                     V4L2_STD_SECAM_K1)
+    /* All Secam Standards */
+    #define V4L2_STD_SECAM          (V4L2_STD_SECAM_B       |
+                                     V4L2_STD_SECAM_G       |
+                                     V4L2_STD_SECAM_H       |
+                                     V4L2_STD_SECAM_DK      |
+                                     V4L2_STD_SECAM_L       |
+                                     V4L2_STD_SECAM_LC)
+    /* PAL macros */
+    #define V4L2_STD_PAL_BG         (V4L2_STD_PAL_B         |
+                                     V4L2_STD_PAL_B1        |
+                                     V4L2_STD_PAL_G)
+    #define V4L2_STD_PAL_DK         (V4L2_STD_PAL_D         |
+                                     V4L2_STD_PAL_D1        |
+                                     V4L2_STD_PAL_K)
+    /*
+     * "Common" PAL - This macro is there to be compatible with the old
+     * V4L1 concept of "PAL": /BGDKHI.
+     * Several PAL standards are missing here: /M, /N and /Nc
+     */
+    #define V4L2_STD_PAL            (V4L2_STD_PAL_BG        |
+                                     V4L2_STD_PAL_DK        |
+                                     V4L2_STD_PAL_H         |
+                                     V4L2_STD_PAL_I)
+    /* Chroma "agnostic" standards */
+    #define V4L2_STD_B              (V4L2_STD_PAL_B         |
+                                     V4L2_STD_PAL_B1        |
+                                     V4L2_STD_SECAM_B)
+    #define V4L2_STD_G              (V4L2_STD_PAL_G         |
+                                     V4L2_STD_SECAM_G)
+    #define V4L2_STD_H              (V4L2_STD_PAL_H         |
+                                     V4L2_STD_SECAM_H)
+    #define V4L2_STD_L              (V4L2_STD_SECAM_L       |
+                                     V4L2_STD_SECAM_LC)
+    #define V4L2_STD_GH             (V4L2_STD_G             |
+                                     V4L2_STD_H)
+    #define V4L2_STD_DK             (V4L2_STD_PAL_DK        |
+                                     V4L2_STD_SECAM_DK)
+    #define V4L2_STD_BG             (V4L2_STD_B             |
+                                     V4L2_STD_G)
+    #define V4L2_STD_MN             (V4L2_STD_PAL_M         |
+                                     V4L2_STD_PAL_N         |
+                                     V4L2_STD_PAL_Nc        |
+                                     V4L2_STD_NTSC)
+
+    /* Standards where MTS/BTSC stereo could be found */
+    #define V4L2_STD_MTS            (V4L2_STD_NTSC_M        |
+                                     V4L2_STD_PAL_M         |
+                                     V4L2_STD_PAL_N         |
+                                     V4L2_STD_PAL_Nc)
+
+    /* Standards for Countries with 60Hz Line frequency */
+    #define V4L2_STD_525_60         (V4L2_STD_PAL_M         |
+                                     V4L2_STD_PAL_60        |
+                                     V4L2_STD_NTSC          |
+                                     V4L2_STD_NTSC_443)
+    /* Standards for Countries with 50Hz Line frequency */
+    #define V4L2_STD_625_50         (V4L2_STD_PAL           |
+                                     V4L2_STD_PAL_N         |
+                                     V4L2_STD_PAL_Nc        |
+                                     V4L2_STD_SECAM)
+
+    #define V4L2_STD_ATSC           (V4L2_STD_ATSC_8_VSB    |
+                                     V4L2_STD_ATSC_16_VSB)
+    /* Macros with none and all analog standards */
+    #define V4L2_STD_UNKNOWN        0
+    #define V4L2_STD_ALL            (V4L2_STD_525_60        |
+                                     V4L2_STD_625_50)
+
+    struct v4l2_standard {
+            __u32                index;
+            v4l2_std_id          id;
+            __u8                 name[24];
+            struct v4l2_fract    frameperiod; /* Frames, not fields */
+            __u32                framelines;
+            __u32                reserved[4];
+    };
+
+    /*
+     *      D V     B T     T I M I N G S
+     */
+
+    /** struct v4l2_bt_timings - BT.656/BT.1120 timing data
+     * @width:      total width of the active video in pixels
+     * @height:     total height of the active video in lines
+     * @interlaced: Interlaced or progressive
+     * @polarities: Positive or negative polarities
+     * @pixelclock: Pixel clock in HZ. Ex. 74.25MHz->74250000
+     * @hfrontporch:Horizontal front porch in pixels
+     * @hsync:      Horizontal Sync length in pixels
+     * @hbackporch: Horizontal back porch in pixels
+     * @vfrontporch:Vertical front porch in lines
+     * @vsync:      Vertical Sync length in lines
+     * @vbackporch: Vertical back porch in lines
+     * @il_vfrontporch:Vertical front porch for the even field
+     *              (aka field 2) of interlaced field formats
+     * @il_vsync:   Vertical Sync length for the even field
+     *              (aka field 2) of interlaced field formats
+     * @il_vbackporch:Vertical back porch for the even field
+     *              (aka field 2) of interlaced field formats
+     * @standards:  Standards the timing belongs to
+     * @flags:      Flags
+     * @reserved:   Reserved fields, must be zeroed.
+     *
+     * A note regarding vertical interlaced timings: height refers to the total
+     * height of the active video frame (= two fields). The blanking timings refer
+     * to the blanking of each field. So the height of the total frame is
+     * calculated as follows:
+     *
+     * tot_height = height + vfrontporch + vsync + vbackporch +
+     *                       il_vfrontporch + il_vsync + il_vbackporch
+     *
+     * The active height of each field is height / 2.
+     */
+    struct v4l2_bt_timings {
+            __u32   width;
+            __u32   height;
+            __u32   interlaced;
+            __u32   polarities;
+            __u64   pixelclock;
+            __u32   hfrontporch;
+            __u32   hsync;
+            __u32   hbackporch;
+            __u32   vfrontporch;
+            __u32   vsync;
+            __u32   vbackporch;
+            __u32   il_vfrontporch;
+            __u32   il_vsync;
+            __u32   il_vbackporch;
+            __u32   standards;
+            __u32   flags;
+            __u32   reserved[14];
+    } __attribute__ ((packed));
+
+    /* Interlaced or progressive format */
+    #define V4L2_DV_PROGRESSIVE     0
+    #define V4L2_DV_INTERLACED      1
+
+    /* Polarities. If bit is not set, it is assumed to be negative polarity */
+    #define V4L2_DV_VSYNC_POS_POL   0x00000001
+    #define V4L2_DV_HSYNC_POS_POL   0x00000002
+
+    /* Timings standards */
+    #define V4L2_DV_BT_STD_CEA861   (1 << 0)  /* CEA-861 Digital TV Profile */
+    #define V4L2_DV_BT_STD_DMT      (1 << 1)  /* VESA Discrete Monitor Timings */
+    #define V4L2_DV_BT_STD_CVT      (1 << 2)  /* VESA Coordinated Video Timings */
+    #define V4L2_DV_BT_STD_GTF      (1 << 3)  /* VESA Generalized Timings Formula */
+
+    /* Flags */
+
+    /* CVT/GTF specific: timing uses reduced blanking (CVT) or the 'Secondary
+       GTF' curve (GTF). In both cases the horizontal and/or vertical blanking
+       intervals are reduced, allowing a higher resolution over the same
+       bandwidth. This is a read-only flag. */
+    #define V4L2_DV_FL_REDUCED_BLANKING             (1 << 0)
+    /* CEA-861 specific: set for CEA-861 formats with a framerate of a multiple
+       of six. These formats can be optionally played at 1 / 1.001 speed.
+       This is a read-only flag. */
+    #define V4L2_DV_FL_CAN_REDUCE_FPS               (1 << 1)
+    /* CEA-861 specific: only valid for video transmitters, the flag is cleared
+       by receivers.
+       If the framerate of the format is a multiple of six, then the pixelclock
+       used to set up the transmitter is divided by 1.001 to make it compatible
+       with 60 Hz based standards such as NTSC and PAL-M that use a framerate of
+       29.97 Hz. Otherwise this flag is cleared. If the transmitter can't generate
+       such frequencies, then the flag will also be cleared. */
+    #define V4L2_DV_FL_REDUCED_FPS                  (1 << 2)
+    /* Specific to interlaced formats: if set, then field 1 is really one half-line
+       longer and field 2 is really one half-line shorter, so each field has
+       exactly the same number of half-lines. Whether half-lines can be detected
+       or used depends on the hardware. */
+    #define V4L2_DV_FL_HALF_LINE                    (1 << 3)
+    /* If set, then this is a Consumer Electronics (CE) video format. Such formats
+     * differ from other formats (commonly called IT formats) in that if RGB
+     * encoding is used then by default the RGB values use limited range (i.e.ie;
+     * use the range 16-235) as opposed to 0-255. All formats defined in CEA-861
+     * except for the 640x480 format are CE formats. */
+    #define V4L2_DV_FL_IS_CE_VIDEO                  (1 << 4)
+
+    /* A few useful defines to calculate the total blanking and frame sizes */
+    #define V4L2_DV_BT_BLANKING_WIDTH(bt) 
+            ((bt)->hfrontporch + (bt)->hsync + (bt)->hbackporch)
+    #define V4L2_DV_BT_FRAME_WIDTH(bt) 
+            ((bt)->width + V4L2_DV_BT_BLANKING_WIDTH(bt))
+    #define V4L2_DV_BT_BLANKING_HEIGHT(bt) 
+            ((bt)->vfrontporch + (bt)->vsync + (bt)->vbackporch + \\
+             (bt)->il_vfrontporch + (bt)->il_vsync + (bt)->il_vbackporch)
+    #define V4L2_DV_BT_FRAME_HEIGHT(bt) 
+            ((bt)->height + V4L2_DV_BT_BLANKING_HEIGHT(bt))
+
+    /** struct v4l2_dv_timings - DV timings
+     * @type:       the type of the timings
+     * @bt: BT656/1120 timings
+     */
+    struct v4l2_dv_timings {
+            __u32 type;
+            union {
+                    struct v4l2_bt_timings  bt;
+                    __u32   reserved[32];
+            };
+    } __attribute__ ((packed));
+
+    /* Values for the type field */
+    #define V4L2_DV_BT_656_1120     0       /* BT.656/1120 timing type */
+
+
+    /** struct v4l2_enum_dv_timings - DV timings enumeration
+     * @index:      enumeration index
+     * @pad:        the pad number for which to enumerate timings (used with
+     *              v4l-subdev nodes only)
+     * @reserved:   must be zeroed
+     * @timings:    the timings for the given index
+     */
+    struct v4l2_enum_dv_timings {
+            __u32 index;
+            __u32 pad;
+            __u32 reserved[2];
+            struct v4l2_dv_timings timings;
+    };
+
+    /** struct v4l2_bt_timings_cap - BT.656/BT.1120 timing capabilities
+     * @min_width:          width in pixels
+     * @max_width:          width in pixels
+     * @min_height:         height in lines
+     * @max_height:         height in lines
+     * @min_pixelclock:     Pixel clock in HZ. Ex. 74.25MHz->74250000
+     * @max_pixelclock:     Pixel clock in HZ. Ex. 74.25MHz->74250000
+     * @standards:          Supported standards
+     * @capabilities:       Supported capabilities
+     * @reserved:           Must be zeroed
+     */
+    struct v4l2_bt_timings_cap {
+            __u32   min_width;
+            __u32   max_width;
+            __u32   min_height;
+            __u32   max_height;
+            __u64   min_pixelclock;
+            __u64   max_pixelclock;
+            __u32   standards;
+            __u32   capabilities;
+            __u32   reserved[16];
+    } __attribute__ ((packed));
+
+    /* Supports interlaced formats */
+    #define V4L2_DV_BT_CAP_INTERLACED       (1 << 0)
+    /* Supports progressive formats */
+    #define V4L2_DV_BT_CAP_PROGRESSIVE      (1 << 1)
+    /* Supports CVT/GTF reduced blanking */
+    #define V4L2_DV_BT_CAP_REDUCED_BLANKING (1 << 2)
+    /* Supports custom formats */
+    #define V4L2_DV_BT_CAP_CUSTOM           (1 << 3)
+
+    /** struct v4l2_dv_timings_cap - DV timings capabilities
+     * @type:       the type of the timings (same as in struct v4l2_dv_timings)
+     * @pad:        the pad number for which to query capabilities (used with
+     *              v4l-subdev nodes only)
+     * @bt:         the BT656/1120 timings capabilities
+     */
+    struct v4l2_dv_timings_cap {
+            __u32 type;
+            __u32 pad;
+            __u32 reserved[2];
+            union {
+                    struct v4l2_bt_timings_cap bt;
+                    __u32 raw_data[32];
+            };
+    };
+
+
+    /*
+     *      V I D E O   I N P U T S
+     */
+    struct v4l2_input {
+            __u32        index;             /*  Which input */
+            __u8         name[32];          /*  Label */
+            __u32        type;              /*  Type of input */
+            __u32        audioset;          /*  Associated audios (bitfield) */
+            __u32        tuner;             /*  enum v4l2_tuner_type */
+            v4l2_std_id  std;
+            __u32        status;
+            __u32        capabilities;
+            __u32        reserved[3];
+    };
+
+    /*  Values for the 'type' field */
+    #define V4L2_INPUT_TYPE_TUNER           1
+    #define V4L2_INPUT_TYPE_CAMERA          2
+
+    /* field 'status' - general */
+    #define V4L2_IN_ST_NO_POWER    0x00000001  /* Attached device is off */
+    #define V4L2_IN_ST_NO_SIGNAL   0x00000002
+    #define V4L2_IN_ST_NO_COLOR    0x00000004
+
+    /* field 'status' - sensor orientation */
+    /* If sensor is mounted upside down set both bits */
+    #define V4L2_IN_ST_HFLIP       0x00000010 /* Frames are flipped horizontally */
+    #define V4L2_IN_ST_VFLIP       0x00000020 /* Frames are flipped vertically */
+
+    /* field 'status' - analog */
+    #define V4L2_IN_ST_NO_H_LOCK   0x00000100  /* No horizontal sync lock */
+    #define V4L2_IN_ST_COLOR_KILL  0x00000200  /* Color killer is active */
+
+    /* field 'status' - digital */
+    #define V4L2_IN_ST_NO_SYNC     0x00010000  /* No synchronization lock */
+    #define V4L2_IN_ST_NO_EQU      0x00020000  /* No equalizer lock */
+    #define V4L2_IN_ST_NO_CARRIER  0x00040000  /* Carrier recovery failed */
+
+    /* field 'status' - VCR and set-top box */
+    #define V4L2_IN_ST_MACROVISION 0x01000000  /* Macrovision detected */
+    #define V4L2_IN_ST_NO_ACCESS   0x02000000  /* Conditional access denied */
+    #define V4L2_IN_ST_VTR         0x04000000  /* VTR time constant */
+
+    /* capabilities flags */
+    #define V4L2_IN_CAP_DV_TIMINGS          0x00000002 /* Supports S_DV_TIMINGS */
+    #define V4L2_IN_CAP_CUSTOM_TIMINGS      V4L2_IN_CAP_DV_TIMINGS /* For compatibility */
+    #define V4L2_IN_CAP_STD                 0x00000004 /* Supports S_STD */
+    #define V4L2_IN_CAP_NATIVE_SIZE         0x00000008 /* Supports setting native size */
+
+    /*
+     *      V I D E O   O U T P U T S
+     */
+    struct v4l2_output {
+            __u32        index;             /*  Which output */
+            __u8         name[32];          /*  Label */
+            __u32        type;              /*  Type of output */
+            __u32        audioset;          /*  Associated audios (bitfield) */
+            __u32        modulator;         /*  Associated modulator */
+            v4l2_std_id  std;
+            __u32        capabilities;
+            __u32        reserved[3];
+    };
+    /*  Values for the 'type' field */
+    #define V4L2_OUTPUT_TYPE_MODULATOR              1
+    #define V4L2_OUTPUT_TYPE_ANALOG                 2
+    #define V4L2_OUTPUT_TYPE_ANALOGVGAOVERLAY       3
+
+    /* capabilities flags */
+    #define V4L2_OUT_CAP_DV_TIMINGS         0x00000002 /* Supports S_DV_TIMINGS */
+    #define V4L2_OUT_CAP_CUSTOM_TIMINGS     V4L2_OUT_CAP_DV_TIMINGS /* For compatibility */
+    #define V4L2_OUT_CAP_STD                0x00000004 /* Supports S_STD */
+    #define V4L2_OUT_CAP_NATIVE_SIZE        0x00000008 /* Supports setting native size */
+
+    /*
+     *      C O N T R O L S
+     */
+    struct v4l2_control {
+            __u32                id;
+            __s32                value;
+    };
+
+    struct v4l2_ext_control {
+            __u32 id;
+            __u32 size;
+            __u32 reserved2[1];
+            union {
+                    __s32 value;
+                    __s64 value64;
+                    char __user *string;
+                    __u8 __user *p_u8;
+                    __u16 __user *p_u16;
+                    __u32 __user *p_u32;
+                    void __user *ptr;
+            };
+    } __attribute__ ((packed));
+
+    struct v4l2_ext_controls {
+            union {
+    #ifndef __KERNEL__
+                    __u32 ctrl_class;
+    #endif
+                    __u32 which;
+            };
+            __u32 count;
+            __u32 error_idx;
+            __u32 reserved[2];
+            struct v4l2_ext_control *controls;
+    };
+
+    #define V4L2_CTRL_ID_MASK         (0x0fffffff)
+    #ifndef __KERNEL__
+    #define V4L2_CTRL_ID2CLASS(id)    ((id) & 0x0fff0000UL)
+    #endif
+    #define V4L2_CTRL_ID2WHICH(id)    ((id) & 0x0fff0000UL)
+    #define V4L2_CTRL_DRIVER_PRIV(id) (((id) & 0xffff) >= 0x1000)
+    #define V4L2_CTRL_MAX_DIMS        (4)
+    #define V4L2_CTRL_WHICH_CUR_VAL   0
+    #define V4L2_CTRL_WHICH_DEF_VAL   0x0f000000
+
+    enum v4l2_ctrl_type {
+            V4L2_CTRL_TYPE_INTEGER       = 1,
+            V4L2_CTRL_TYPE_BOOLEAN       = 2,
+            V4L2_CTRL_TYPE_MENU          = 3,
+            V4L2_CTRL_TYPE_BUTTON        = 4,
+            V4L2_CTRL_TYPE_INTEGER64     = 5,
+            V4L2_CTRL_TYPE_CTRL_CLASS    = 6,
+            V4L2_CTRL_TYPE_STRING        = 7,
+            V4L2_CTRL_TYPE_BITMASK       = 8,
+            V4L2_CTRL_TYPE_INTEGER_MENU  = 9,
+
+            /* Compound types are >= 0x0100 */
+            V4L2_CTRL_COMPOUND_TYPES     = 0x0100,
+            V4L2_CTRL_TYPE_U8            = 0x0100,
+            V4L2_CTRL_TYPE_U16           = 0x0101,
+            V4L2_CTRL_TYPE_U32           = 0x0102,
+    };
+
+    /*  Used in the VIDIOC_QUERYCTRL ioctl for querying controls */
+    struct v4l2_queryctrl {
+            __u32                id;
+            __u32                type;      /* enum v4l2_ctrl_type */
+            __u8                 name[32];  /* Whatever */
+            __s32                minimum;   /* Note signedness */
+            __s32                maximum;
+            __s32                step;
+            __s32                default_value;
+            __u32                flags;
+            __u32                reserved[2];
+    };
+
+    /*  Used in the VIDIOC_QUERY_EXT_CTRL ioctl for querying extended controls */
+    struct v4l2_query_ext_ctrl {
+            __u32                id;
+            __u32                type;
+            char                 name[32];
+            __s64                minimum;
+            __s64                maximum;
+            __u64                step;
+            __s64                default_value;
+            __u32                flags;
+            __u32                elem_size;
+            __u32                elems;
+            __u32                nr_of_dims;
+            __u32                dims[V4L2_CTRL_MAX_DIMS];
+            __u32                reserved[32];
+    };
+
+    /*  Used in the VIDIOC_QUERYMENU ioctl for querying menu items */
+    struct v4l2_querymenu {
+            __u32           id;
+            __u32           index;
+            union {
+                    __u8    name[32];       /* Whatever */
+                    __s64   value;
+            };
+            __u32           reserved;
+    } __attribute__ ((packed));
+
+    /*  Control flags  */
+    #define V4L2_CTRL_FLAG_DISABLED         0x0001
+    #define V4L2_CTRL_FLAG_GRABBED          0x0002
+    #define V4L2_CTRL_FLAG_READ_ONLY        0x0004
+    #define V4L2_CTRL_FLAG_UPDATE           0x0008
+    #define V4L2_CTRL_FLAG_INACTIVE         0x0010
+    #define V4L2_CTRL_FLAG_SLIDER           0x0020
+    #define V4L2_CTRL_FLAG_WRITE_ONLY       0x0040
+    #define V4L2_CTRL_FLAG_VOLATILE         0x0080
+    #define V4L2_CTRL_FLAG_HAS_PAYLOAD      0x0100
+    #define V4L2_CTRL_FLAG_EXECUTE_ON_WRITE 0x0200
+
+    /*  Query flags, to be ORed with the control ID */
+    #define V4L2_CTRL_FLAG_NEXT_CTRL        0x80000000
+    #define V4L2_CTRL_FLAG_NEXT_COMPOUND    0x40000000
+
+    /*  User-class control IDs defined by V4L2 */
+    #define V4L2_CID_MAX_CTRLS              1024
+    /*  IDs reserved for driver specific controls */
+    #define V4L2_CID_PRIVATE_BASE           0x08000000
+
+
+    /*
+     *      T U N I N G
+     */
+    struct v4l2_tuner {
+            __u32                   index;
+            __u8                    name[32];
+            __u32                   type;   /* enum v4l2_tuner_type */
+            __u32                   capability;
+            __u32                   rangelow;
+            __u32                   rangehigh;
+            __u32                   rxsubchans;
+            __u32                   audmode;
+            __s32                   signal;
+            __s32                   afc;
+            __u32                   reserved[4];
+    };
+
+    struct v4l2_modulator {
+            __u32                   index;
+            __u8                    name[32];
+            __u32                   capability;
+            __u32                   rangelow;
+            __u32                   rangehigh;
+            __u32                   txsubchans;
+            __u32                   type;   /* enum v4l2_tuner_type */
+            __u32                   reserved[3];
+    };
+
+    /*  Flags for the 'capability' field */
+    #define V4L2_TUNER_CAP_LOW              0x0001
+    #define V4L2_TUNER_CAP_NORM             0x0002
+    #define V4L2_TUNER_CAP_HWSEEK_BOUNDED   0x0004
+    #define V4L2_TUNER_CAP_HWSEEK_WRAP      0x0008
+    #define V4L2_TUNER_CAP_STEREO           0x0010
+    #define V4L2_TUNER_CAP_LANG2            0x0020
+    #define V4L2_TUNER_CAP_SAP              0x0020
+    #define V4L2_TUNER_CAP_LANG1            0x0040
+    #define V4L2_TUNER_CAP_RDS              0x0080
+    #define V4L2_TUNER_CAP_RDS_BLOCK_IO     0x0100
+    #define V4L2_TUNER_CAP_RDS_CONTROLS     0x0200
+    #define V4L2_TUNER_CAP_FREQ_BANDS       0x0400
+    #define V4L2_TUNER_CAP_HWSEEK_PROG_LIM  0x0800
+    #define V4L2_TUNER_CAP_1HZ              0x1000
+
+    /*  Flags for the 'rxsubchans' field */
+    #define V4L2_TUNER_SUB_MONO             0x0001
+    #define V4L2_TUNER_SUB_STEREO           0x0002
+    #define V4L2_TUNER_SUB_LANG2            0x0004
+    #define V4L2_TUNER_SUB_SAP              0x0004
+    #define V4L2_TUNER_SUB_LANG1            0x0008
+    #define V4L2_TUNER_SUB_RDS              0x0010
+
+    /*  Values for the 'audmode' field */
+    #define V4L2_TUNER_MODE_MONO            0x0000
+    #define V4L2_TUNER_MODE_STEREO          0x0001
+    #define V4L2_TUNER_MODE_LANG2           0x0002
+    #define V4L2_TUNER_MODE_SAP             0x0002
+    #define V4L2_TUNER_MODE_LANG1           0x0003
+    #define V4L2_TUNER_MODE_LANG1_LANG2     0x0004
+
+    struct v4l2_frequency {
+            __u32   tuner;
+            __u32   type;   /* enum v4l2_tuner_type */
+            __u32   frequency;
+            __u32   reserved[8];
+    };
+
+    #define V4L2_BAND_MODULATION_VSB        (1 << 1)
+    #define V4L2_BAND_MODULATION_FM         (1 << 2)
+    #define V4L2_BAND_MODULATION_AM         (1 << 3)
+
+    struct v4l2_frequency_band {
+            __u32   tuner;
+            __u32   type;   /* enum v4l2_tuner_type */
+            __u32   index;
+            __u32   capability;
+            __u32   rangelow;
+            __u32   rangehigh;
+            __u32   modulation;
+            __u32   reserved[9];
+    };
+
+    struct v4l2_hw_freq_seek {
+            __u32   tuner;
+            __u32   type;   /* enum v4l2_tuner_type */
+            __u32   seek_upward;
+            __u32   wrap_around;
+            __u32   spacing;
+            __u32   rangelow;
+            __u32   rangehigh;
+            __u32   reserved[5];
+    };
+
+    /*
+     *      R D S
+     */
+
+    struct v4l2_rds_data {
+            __u8    lsb;
+            __u8    msb;
+            __u8    block;
+    } __attribute__ ((packed));
+
+    #define V4L2_RDS_BLOCK_MSK       0x7
+    #define V4L2_RDS_BLOCK_A         0
+    #define V4L2_RDS_BLOCK_B         1
+    #define V4L2_RDS_BLOCK_C         2
+    #define V4L2_RDS_BLOCK_D         3
+    #define V4L2_RDS_BLOCK_C_ALT     4
+    #define V4L2_RDS_BLOCK_INVALID   7
+
+    #define V4L2_RDS_BLOCK_CORRECTED 0x40
+    #define V4L2_RDS_BLOCK_ERROR     0x80
+
+    /*
+     *      A U D I O
+     */
+    struct v4l2_audio {
+            __u32   index;
+            __u8    name[32];
+            __u32   capability;
+            __u32   mode;
+            __u32   reserved[2];
+    };
+
+    /*  Flags for the 'capability' field */
+    #define V4L2_AUDCAP_STEREO              0x00001
+    #define V4L2_AUDCAP_AVL                 0x00002
+
+    /*  Flags for the 'mode' field */
+    #define V4L2_AUDMODE_AVL                0x00001
+
+    struct v4l2_audioout {
+            __u32   index;
+            __u8    name[32];
+            __u32   capability;
+            __u32   mode;
+            __u32   reserved[2];
+    };
+
+    /*
+     *      M P E G   S E R V I C E S
+     */
+    #if 1
+    #define V4L2_ENC_IDX_FRAME_I    (0)
+    #define V4L2_ENC_IDX_FRAME_P    (1)
+    #define V4L2_ENC_IDX_FRAME_B    (2)
+    #define V4L2_ENC_IDX_FRAME_MASK (0xf)
+
+    struct v4l2_enc_idx_entry {
+            __u64 offset;
+            __u64 pts;
+            __u32 length;
+            __u32 flags;
+            __u32 reserved[2];
+    };
+
+    #define V4L2_ENC_IDX_ENTRIES (64)
+    struct v4l2_enc_idx {
+            __u32 entries;
+            __u32 entries_cap;
+            __u32 reserved[4];
+            struct v4l2_enc_idx_entry entry[V4L2_ENC_IDX_ENTRIES];
+    };
+
+
+    #define V4L2_ENC_CMD_START      (0)
+    #define V4L2_ENC_CMD_STOP       (1)
+    #define V4L2_ENC_CMD_PAUSE      (2)
+    #define V4L2_ENC_CMD_RESUME     (3)
+
+    /* Flags for V4L2_ENC_CMD_STOP */
+    #define V4L2_ENC_CMD_STOP_AT_GOP_END    (1 << 0)
+
+    struct v4l2_encoder_cmd {
+            __u32 cmd;
+            __u32 flags;
+            union {
+                    struct {
+                            __u32 data[8];
+                    } raw;
+            };
+    };
+
+    /* Decoder commands */
+    #define V4L2_DEC_CMD_START       (0)
+    #define V4L2_DEC_CMD_STOP        (1)
+    #define V4L2_DEC_CMD_PAUSE       (2)
+    #define V4L2_DEC_CMD_RESUME      (3)
+
+    /* Flags for V4L2_DEC_CMD_START */
+    #define V4L2_DEC_CMD_START_MUTE_AUDIO   (1 << 0)
+
+    /* Flags for V4L2_DEC_CMD_PAUSE */
+    #define V4L2_DEC_CMD_PAUSE_TO_BLACK     (1 << 0)
+
+    /* Flags for V4L2_DEC_CMD_STOP */
+    #define V4L2_DEC_CMD_STOP_TO_BLACK      (1 << 0)
+    #define V4L2_DEC_CMD_STOP_IMMEDIATELY   (1 << 1)
+
+    /* Play format requirements (returned by the driver): */
+
+    /* The decoder has no special format requirements */
+    #define V4L2_DEC_START_FMT_NONE         (0)
+    /* The decoder requires full GOPs */
+    #define V4L2_DEC_START_FMT_GOP          (1)
+
+    /* The structure must be zeroed before use by the application
+       This ensures it can be extended safely in the future. */
+    struct v4l2_decoder_cmd {
+            __u32 cmd;
+            __u32 flags;
+            union {
+                    struct {
+                            __u64 pts;
+                    } stop;
+
+                    struct {
+                            /* 0 or 1000 specifies normal speed,
+                               1 specifies forward single stepping,
+                               -1 specifies backward single stepping,
+                               >1: playback at speed/1000 of the normal speed,
+                               <-1: reverse playback at (-speed/1000) of the normal speed. */
+                            __s32 speed;
+                            __u32 format;
+                    } start;
+
+                    struct {
+                            __u32 data[16];
+                    } raw;
+            };
+    };
+    #endif
+
+
+    /*
+     *      D A T A   S E R V I C E S   ( V B I )
+     *
+     *      Data services API by Michael Schimek
+     */
+
+    /* Raw VBI */
+    struct v4l2_vbi_format {
+            __u32   sampling_rate;          /* in 1 Hz */
+            __u32   offset;
+            __u32   samples_per_line;
+            __u32   sample_format;          /* V4L2_PIX_FMT_* */
+            __s32   start[2];
+            __u32   count[2];
+            __u32   flags;                  /* V4L2_VBI_* */
+            __u32   reserved[2];            /* must be zero */
+    };
+
+    /*  VBI flags  */
+    #define V4L2_VBI_UNSYNC         (1 << 0)
+    #define V4L2_VBI_INTERLACED     (1 << 1)
+
+    /* ITU-R start lines for each field */
+    #define V4L2_VBI_ITU_525_F1_START (1)
+    #define V4L2_VBI_ITU_525_F2_START (264)
+    #define V4L2_VBI_ITU_625_F1_START (1)
+    #define V4L2_VBI_ITU_625_F2_START (314)
+
+    /* Sliced VBI
+     *
+     *    This implements is a proposal V4L2 API to allow SLICED VBI
+     * required for some hardware encoders. It should change without
+     * notice in the definitive implementation.
+     */
+
+    struct v4l2_sliced_vbi_format {
+            __u16   service_set;
+            /* service_lines[0][...] specifies lines 0-23 (1-23 used) of the first field
+               service_lines[1][...] specifies lines 0-23 (1-23 used) of the second field
+                                     (equals frame lines 313-336 for 625 line video
+                                      standards, 263-286 for 525 line standards) */
+            __u16   service_lines[2][24];
+            __u32   io_size;
+            __u32   reserved[2];            /* must be zero */
+    };
+
+    /* Teletext World System Teletext
+       (WST), defined on ITU-R BT.653-2 */
+    #define V4L2_SLICED_TELETEXT_B          (0x0001)
+    /* Video Program System, defined on ETS 300 231*/
+    #define V4L2_SLICED_VPS                 (0x0400)
+    /* Closed Caption, defined on EIA-608 */
+    #define V4L2_SLICED_CAPTION_525         (0x1000)
+    /* Wide Screen System, defined on ITU-R BT1119.1 */
+    #define V4L2_SLICED_WSS_625             (0x4000)
+
+    #define V4L2_SLICED_VBI_525             (V4L2_SLICED_CAPTION_525)
+    #define V4L2_SLICED_VBI_625             (V4L2_SLICED_TELETEXT_B | V4L2_SLICED_VPS | V4L2_SLICED_WSS_625)
+
+    struct v4l2_sliced_vbi_cap {
+            __u16   service_set;
+            /* service_lines[0][...] specifies lines 0-23 (1-23 used) of the first field
+               service_lines[1][...] specifies lines 0-23 (1-23 used) of the second field
+                                     (equals frame lines 313-336 for 625 line video
+                                      standards, 263-286 for 525 line standards) */
+            __u16   service_lines[2][24];
+            __u32   type;           /* enum v4l2_buf_type */
+            __u32   reserved[3];    /* must be 0 */
+    };
+
+    struct v4l2_sliced_vbi_data {
+            __u32   id;
+            __u32   field;          /* 0: first field, 1: second field */
+            __u32   line;           /* 1-23 */
+            __u32   reserved;       /* must be 0 */
+            __u8    data[48];
+    };
+
+    /*
+     * Sliced VBI data inserted into MPEG Streams
+     */
+
+    /*
+     * V4L2_MPEG_STREAM_VBI_FMT_IVTV:
+     *
+     * Structure of payload contained in an MPEG 2 Private Stream 1 PES Packet in an
+     * MPEG-2 Program Pack that contains V4L2_MPEG_STREAM_VBI_FMT_IVTV Sliced VBI
+     * data
+     *
+     * Note, the MPEG-2 Program Pack and Private Stream 1 PES packet header
+     * definitions are not included here.  See the MPEG-2 specifications for details
+     * on these headers.
+     */
+
+    /* Line type IDs */
+    #define V4L2_MPEG_VBI_IVTV_TELETEXT_B     (1)
+    #define V4L2_MPEG_VBI_IVTV_CAPTION_525    (4)
+    #define V4L2_MPEG_VBI_IVTV_WSS_625        (5)
+    #define V4L2_MPEG_VBI_IVTV_VPS            (7)
+
+    struct v4l2_mpeg_vbi_itv0_line {
+            __u8 id;        /* One of V4L2_MPEG_VBI_IVTV_* above */
+            __u8 data[42];  /* Sliced VBI data for the line */
+    } __attribute__ ((packed));
+
+    struct v4l2_mpeg_vbi_itv0 {
+            __le32 linemask[2]; /* Bitmasks of VBI service lines present */
+            struct v4l2_mpeg_vbi_itv0_line line[35];
+    } __attribute__ ((packed));
+
+    struct v4l2_mpeg_vbi_ITV0 {
+            struct v4l2_mpeg_vbi_itv0_line line[36];
+    } __attribute__ ((packed));
+
+    #define V4L2_MPEG_VBI_IVTV_MAGIC0       "itv0"
+    #define V4L2_MPEG_VBI_IVTV_MAGIC1       "ITV0"
+
+    struct v4l2_mpeg_vbi_fmt_ivtv {
+            __u8 magic[4];
+            union {
+                    struct v4l2_mpeg_vbi_itv0 itv0;
+                    struct v4l2_mpeg_vbi_ITV0 ITV0;
+            };
+    } __attribute__ ((packed));
+
+    /*
+     *      A G G R E G A T E   S T R U C T U R E S
+     */
+
+    /**
+     * struct v4l2_plane_pix_format - additional, per-plane format definition
+     * @sizeimage:          maximum size in bytes required for data, for which
+     *                      this plane will be used
+     * @bytesperline:       distance in bytes between the leftmost pixels in two
+     *                      adjacent lines
+     */
+    struct v4l2_plane_pix_format {
+            __u32           sizeimage;
+            __u32           bytesperline;
+            __u16           reserved[6];
+    } __attribute__ ((packed));
+
+    /**
+     * struct v4l2_pix_format_mplane - multiplanar format definition
+     * @width:              image width in pixels
+     * @height:             image height in pixels
+     * @pixelformat:        little endian four character code (fourcc)
+     * @field:              enum v4l2_field; field order (for interlaced video)
+     * @colorspace:         enum v4l2_colorspace; supplemental to pixelformat
+     * @plane_fmt:          per-plane information
+     * @num_planes:         number of planes for this format
+     * @flags:              format flags (V4L2_PIX_FMT_FLAG_*)
+     * @ycbcr_enc:          enum v4l2_ycbcr_encoding, Y'CbCr encoding
+     * @quantization:       enum v4l2_quantization, colorspace quantization
+     * @xfer_func:          enum v4l2_xfer_func, colorspace transfer function
+     */
+    struct v4l2_pix_format_mplane {
+            __u32                           width;
+            __u32                           height;
+            __u32                           pixelformat;
+            __u32                           field;
+            __u32                           colorspace;
+
+            struct v4l2_plane_pix_format    plane_fmt[VIDEO_MAX_PLANES];
+            __u8                            num_planes;
+            __u8                            flags;
+            __u8                            ycbcr_enc;
+            __u8                            quantization;
+            __u8                            xfer_func;
+            __u8                            reserved[7];
+    } __attribute__ ((packed));
+
+    /**
+     * struct v4l2_sdr_format - SDR format definition
+     * @pixelformat:        little endian four character code (fourcc)
+     * @buffersize:         maximum size in bytes required for data
+     */
+    struct v4l2_sdr_format {
+            __u32                           pixelformat;
+            __u32                           buffersize;
+            __u8                            reserved[24];
+    } __attribute__ ((packed));
+
+    /**
+     * struct v4l2_format - stream data format
+     * @type:       enum v4l2_buf_type; type of the data stream
+     * @pix:        definition of an image format
+     * @pix_mp:     definition of a multiplanar image format
+     * @win:        definition of an overlaid image
+     * @vbi:        raw VBI capture or output parameters
+     * @sliced:     sliced VBI capture or output parameters
+     * @raw_data:   placeholder for future extensions and custom formats
+     */
+    struct v4l2_format {
+            __u32    type;
+            union {
+                    struct v4l2_pix_format          pix;     /* V4L2_BUF_TYPE_VIDEO_CAPTURE */
+                    struct v4l2_pix_format_mplane   pix_mp;  /* V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE */
+                    struct v4l2_window              win;     /* V4L2_BUF_TYPE_VIDEO_OVERLAY */
+                    struct v4l2_vbi_format          vbi;     /* V4L2_BUF_TYPE_VBI_CAPTURE */
+                    struct v4l2_sliced_vbi_format   sliced;  /* V4L2_BUF_TYPE_SLICED_VBI_CAPTURE */
+                    struct v4l2_sdr_format          sdr;     /* V4L2_BUF_TYPE_SDR_CAPTURE */
+                    __u8    raw_data[200];                   /* user-defined */
+            } fmt;
+    };
+
+    /*      Stream type-dependent parameters
+     */
+    struct v4l2_streamparm {
+            __u32    type;                  /* enum v4l2_buf_type */
+            union {
+                    struct v4l2_captureparm capture;
+                    struct v4l2_outputparm  output;
+                    __u8    raw_data[200];  /* user-defined */
+            } parm;
+    };
+
+    /*
+     *      E V E N T S
+     */
+
+    #define V4L2_EVENT_ALL                          0
+    #define V4L2_EVENT_VSYNC                        1
+    #define V4L2_EVENT_EOS                          2
+    #define V4L2_EVENT_CTRL                         3
+    #define V4L2_EVENT_FRAME_SYNC                   4
+    #define V4L2_EVENT_SOURCE_CHANGE                5
+    #define V4L2_EVENT_MOTION_DET                   6
+    #define V4L2_EVENT_PRIVATE_START                0x08000000
+
+    /* Payload for V4L2_EVENT_VSYNC */
+    struct v4l2_event_vsync {
+            /* Can be V4L2_FIELD_ANY, _NONE, _TOP or _BOTTOM */
+            __u8 field;
+    } __attribute__ ((packed));
+
+    /* Payload for V4L2_EVENT_CTRL */
+    #define V4L2_EVENT_CTRL_CH_VALUE                (1 << 0)
+    #define V4L2_EVENT_CTRL_CH_FLAGS                (1 << 1)
+    #define V4L2_EVENT_CTRL_CH_RANGE                (1 << 2)
+
+    struct v4l2_event_ctrl {
+            __u32 changes;
+            __u32 type;
+            union {
+                    __s32 value;
+                    __s64 value64;
+            };
+            __u32 flags;
+            __s32 minimum;
+            __s32 maximum;
+            __s32 step;
+            __s32 default_value;
+    };
+
+    struct v4l2_event_frame_sync {
+            __u32 frame_sequence;
+    };
+
+    #define V4L2_EVENT_SRC_CH_RESOLUTION            (1 << 0)
+
+    struct v4l2_event_src_change {
+            __u32 changes;
+    };
+
+    #define V4L2_EVENT_MD_FL_HAVE_FRAME_SEQ (1 << 0)
+
+    /**
+     * struct v4l2_event_motion_det - motion detection event
+     * @flags:             if V4L2_EVENT_MD_FL_HAVE_FRAME_SEQ is set, then the
+     *                     frame_sequence field is valid.
+     * @frame_sequence:    the frame sequence number associated with this event.
+     * @region_mask:       which regions detected motion.
+     */
+    struct v4l2_event_motion_det {
+            __u32 flags;
+            __u32 frame_sequence;
+            __u32 region_mask;
+    };
+
+    struct v4l2_event {
+            __u32                           type;
+            union {
+                    struct v4l2_event_vsync         vsync;
+                    struct v4l2_event_ctrl          ctrl;
+                    struct v4l2_event_frame_sync    frame_sync;
+                    struct v4l2_event_src_change    src_change;
+                    struct v4l2_event_motion_det    motion_det;
+                    __u8                            data[64];
+            } u;
+            __u32                           pending;
+            __u32                           sequence;
+            struct timespec                 timestamp;
+            __u32                           id;
+            __u32                           reserved[8];
+    };
+
+    #define V4L2_EVENT_SUB_FL_SEND_INITIAL          (1 << 0)
+    #define V4L2_EVENT_SUB_FL_ALLOW_FEEDBACK        (1 << 1)
+
+    struct v4l2_event_subscription {
+            __u32                           type;
+            __u32                           id;
+            __u32                           flags;
+            __u32                           reserved[5];
+    };
+
+    /*
+     *      A D V A N C E D   D E B U G G I N G
+     *
+     *      NOTE: EXPERIMENTAL API, NEVER RELY ON THIS IN APPLICATIONS!
+     *      FOR DEBUGGING, TESTING AND INTERNAL USE ONLY!
+     */
+
+    /* VIDIOC_DBG_G_REGISTER and VIDIOC_DBG_S_REGISTER */
+
+    #define V4L2_CHIP_MATCH_BRIDGE      0  /* Match against chip ID on the bridge (0 for the bridge) */
+    #define V4L2_CHIP_MATCH_SUBDEV      4  /* Match against subdev index */
+
+    /* The following four defines are no longer in use */
+    #define V4L2_CHIP_MATCH_HOST V4L2_CHIP_MATCH_BRIDGE
+    #define V4L2_CHIP_MATCH_I2C_DRIVER  1  /* Match against I2C driver name */
+    #define V4L2_CHIP_MATCH_I2C_ADDR    2  /* Match against I2C 7-bit address */
+    #define V4L2_CHIP_MATCH_AC97        3  /* Match against ancillary AC97 chip */
+
+    struct v4l2_dbg_match {
+            __u32 type; /* Match type */
+            union {     /* Match this chip, meaning determined by type */
+                    __u32 addr;
+                    char name[32];
+            };
+    } __attribute__ ((packed));
+
+    struct v4l2_dbg_register {
+            struct v4l2_dbg_match match;
+            __u32 size;     /* register size in bytes */
+            __u64 reg;
+            __u64 val;
+    } __attribute__ ((packed));
+
+    #define V4L2_CHIP_FL_READABLE (1 << 0)
+    #define V4L2_CHIP_FL_WRITABLE (1 << 1)
+
+    /* VIDIOC_DBG_G_CHIP_INFO */
+    struct v4l2_dbg_chip_info {
+            struct v4l2_dbg_match match;
+            char name[32];
+            __u32 flags;
+            __u32 reserved[32];
+    } __attribute__ ((packed));
+
+    /**
+     * struct v4l2_create_buffers - VIDIOC_CREATE_BUFS argument
+     * @index:      on return, index of the first created buffer
+     * @count:      entry: number of requested buffers,
+     *              return: number of created buffers
+     * @memory:     enum v4l2_memory; buffer memory type
+     * @format:     frame format, for which buffers are requested
+     * @reserved:   future extensions
+     */
+    struct v4l2_create_buffers {
+            __u32                   index;
+            __u32                   count;
+            __u32                   memory;
+            struct v4l2_format      format;
+            __u32                   reserved[8];
+    };
+
+    /*
+     *      I O C T L   C O D E S   F O R   V I D E O   D E V I C E S
+     *
+     */
+    #define VIDIOC_QUERYCAP          _IOR('V',  0, struct v4l2_capability)
+    #define VIDIOC_RESERVED           _IO('V',  1)
+    #define VIDIOC_ENUM_FMT         _IOWR('V',  2, struct v4l2_fmtdesc)
+    #define VIDIOC_G_FMT            _IOWR('V',  4, struct v4l2_format)
+    #define VIDIOC_S_FMT            _IOWR('V',  5, struct v4l2_format)
+    #define VIDIOC_REQBUFS          _IOWR('V',  8, struct v4l2_requestbuffers)
+    #define VIDIOC_QUERYBUF         _IOWR('V',  9, struct v4l2_buffer)
+    #define VIDIOC_G_FBUF            _IOR('V', 10, struct v4l2_framebuffer)
+    #define VIDIOC_S_FBUF            _IOW('V', 11, struct v4l2_framebuffer)
+    #define VIDIOC_OVERLAY           _IOW('V', 14, int)
+    #define VIDIOC_QBUF             _IOWR('V', 15, struct v4l2_buffer)
+    #define VIDIOC_EXPBUF           _IOWR('V', 16, struct v4l2_exportbuffer)
+    #define VIDIOC_DQBUF            _IOWR('V', 17, struct v4l2_buffer)
+    #define VIDIOC_STREAMON          _IOW('V', 18, int)
+    #define VIDIOC_STREAMOFF         _IOW('V', 19, int)
+    #define VIDIOC_G_PARM           _IOWR('V', 21, struct v4l2_streamparm)
+    #define VIDIOC_S_PARM           _IOWR('V', 22, struct v4l2_streamparm)
+    #define VIDIOC_G_STD             _IOR('V', 23, v4l2_std_id)
+    #define VIDIOC_S_STD             _IOW('V', 24, v4l2_std_id)
+    #define VIDIOC_ENUMSTD          _IOWR('V', 25, struct v4l2_standard)
+    #define VIDIOC_ENUMINPUT        _IOWR('V', 26, struct v4l2_input)
+    #define VIDIOC_G_CTRL           _IOWR('V', 27, struct v4l2_control)
+    #define VIDIOC_S_CTRL           _IOWR('V', 28, struct v4l2_control)
+    #define VIDIOC_G_TUNER          _IOWR('V', 29, struct v4l2_tuner)
+    #define VIDIOC_S_TUNER           _IOW('V', 30, struct v4l2_tuner)
+    #define VIDIOC_G_AUDIO           _IOR('V', 33, struct v4l2_audio)
+    #define VIDIOC_S_AUDIO           _IOW('V', 34, struct v4l2_audio)
+    #define VIDIOC_QUERYCTRL        _IOWR('V', 36, struct v4l2_queryctrl)
+    #define VIDIOC_QUERYMENU        _IOWR('V', 37, struct v4l2_querymenu)
+    #define VIDIOC_G_INPUT           _IOR('V', 38, int)
+    #define VIDIOC_S_INPUT          _IOWR('V', 39, int)
+    #define VIDIOC_G_EDID           _IOWR('V', 40, struct v4l2_edid)
+    #define VIDIOC_S_EDID           _IOWR('V', 41, struct v4l2_edid)
+    #define VIDIOC_G_OUTPUT          _IOR('V', 46, int)
+    #define VIDIOC_S_OUTPUT         _IOWR('V', 47, int)
+    #define VIDIOC_ENUMOUTPUT       _IOWR('V', 48, struct v4l2_output)
+    #define VIDIOC_G_AUDOUT          _IOR('V', 49, struct v4l2_audioout)
+    #define VIDIOC_S_AUDOUT          _IOW('V', 50, struct v4l2_audioout)
+    #define VIDIOC_G_MODULATOR      _IOWR('V', 54, struct v4l2_modulator)
+    #define VIDIOC_S_MODULATOR       _IOW('V', 55, struct v4l2_modulator)
+    #define VIDIOC_G_FREQUENCY      _IOWR('V', 56, struct v4l2_frequency)
+    #define VIDIOC_S_FREQUENCY       _IOW('V', 57, struct v4l2_frequency)
+    #define VIDIOC_CROPCAP          _IOWR('V', 58, struct v4l2_cropcap)
+    #define VIDIOC_G_CROP           _IOWR('V', 59, struct v4l2_crop)
+    #define VIDIOC_S_CROP            _IOW('V', 60, struct v4l2_crop)
+    #define VIDIOC_G_JPEGCOMP        _IOR('V', 61, struct v4l2_jpegcompression)
+    #define VIDIOC_S_JPEGCOMP        _IOW('V', 62, struct v4l2_jpegcompression)
+    #define VIDIOC_QUERYSTD          _IOR('V', 63, v4l2_std_id)
+    #define VIDIOC_TRY_FMT          _IOWR('V', 64, struct v4l2_format)
+    #define VIDIOC_ENUMAUDIO        _IOWR('V', 65, struct v4l2_audio)
+    #define VIDIOC_ENUMAUDOUT       _IOWR('V', 66, struct v4l2_audioout)
+    #define VIDIOC_G_PRIORITY        _IOR('V', 67, __u32) /* enum v4l2_priority */
+    #define VIDIOC_S_PRIORITY        _IOW('V', 68, __u32) /* enum v4l2_priority */
+    #define VIDIOC_G_SLICED_VBI_CAP _IOWR('V', 69, struct v4l2_sliced_vbi_cap)
+    #define VIDIOC_LOG_STATUS         _IO('V', 70)
+    #define VIDIOC_G_EXT_CTRLS      _IOWR('V', 71, struct v4l2_ext_controls)
+    #define VIDIOC_S_EXT_CTRLS      _IOWR('V', 72, struct v4l2_ext_controls)
+    #define VIDIOC_TRY_EXT_CTRLS    _IOWR('V', 73, struct v4l2_ext_controls)
+    #define VIDIOC_ENUM_FRAMESIZES  _IOWR('V', 74, struct v4l2_frmsizeenum)
+    #define VIDIOC_ENUM_FRAMEINTERVALS _IOWR('V', 75, struct v4l2_frmivalenum)
+    #define VIDIOC_G_ENC_INDEX       _IOR('V', 76, struct v4l2_enc_idx)
+    #define VIDIOC_ENCODER_CMD      _IOWR('V', 77, struct v4l2_encoder_cmd)
+    #define VIDIOC_TRY_ENCODER_CMD  _IOWR('V', 78, struct v4l2_encoder_cmd)
+
+    /*
+     * Experimental, meant for debugging, testing and internal use.
+     * Only implemented if CONFIG_VIDEO_ADV_DEBUG is defined.
+     * You must be root to use these ioctls. Never use these in applications!
+     */
+    #define VIDIOC_DBG_S_REGISTER    _IOW('V', 79, struct v4l2_dbg_register)
+    #define VIDIOC_DBG_G_REGISTER   _IOWR('V', 80, struct v4l2_dbg_register)
+
+    #define VIDIOC_S_HW_FREQ_SEEK    _IOW('V', 82, struct v4l2_hw_freq_seek)
+    #define VIDIOC_S_DV_TIMINGS     _IOWR('V', 87, struct v4l2_dv_timings)
+    #define VIDIOC_G_DV_TIMINGS     _IOWR('V', 88, struct v4l2_dv_timings)
+    #define VIDIOC_DQEVENT           _IOR('V', 89, struct v4l2_event)
+    #define VIDIOC_SUBSCRIBE_EVENT   _IOW('V', 90, struct v4l2_event_subscription)
+    #define VIDIOC_UNSUBSCRIBE_EVENT _IOW('V', 91, struct v4l2_event_subscription)
+    #define VIDIOC_CREATE_BUFS      _IOWR('V', 92, struct v4l2_create_buffers)
+    #define VIDIOC_PREPARE_BUF      _IOWR('V', 93, struct v4l2_buffer)
+    #define VIDIOC_G_SELECTION      _IOWR('V', 94, struct v4l2_selection)
+    #define VIDIOC_S_SELECTION      _IOWR('V', 95, struct v4l2_selection)
+    #define VIDIOC_DECODER_CMD      _IOWR('V', 96, struct v4l2_decoder_cmd)
+    #define VIDIOC_TRY_DECODER_CMD  _IOWR('V', 97, struct v4l2_decoder_cmd)
+    #define VIDIOC_ENUM_DV_TIMINGS  _IOWR('V', 98, struct v4l2_enum_dv_timings)
+    #define VIDIOC_QUERY_DV_TIMINGS  _IOR('V', 99, struct v4l2_dv_timings)
+    #define VIDIOC_DV_TIMINGS_CAP   _IOWR('V', 100, struct v4l2_dv_timings_cap)
+    #define VIDIOC_ENUM_FREQ_BANDS  _IOWR('V', 101, struct v4l2_frequency_band)
+
+    /*
+     * Experimental, meant for debugging, testing and internal use.
+     * Never use this in applications!
+     */
+    #define VIDIOC_DBG_G_CHIP_INFO  _IOWR('V', 102, struct v4l2_dbg_chip_info)
+
+    #define VIDIOC_QUERY_EXT_CTRL   _IOWR('V', 103, struct v4l2_query_ext_ctrl)
+
+    /* Reminder: when adding new ioctls please add support for them to
+       drivers/media/v4l2-core/v4l2-compat-ioctl32.c as well! */
+
+    #define BASE_VIDIOC_PRIVATE     192             /* 192-255 are private */
+
+    #endif /* _UAPI__LINUX_VIDEODEV2_H */
+
+
+
+
+.. ------------------------------------------------------------------------------
+.. This file was automatically converted from DocBook-XML with the dbxml
+.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
+.. from the linux kernel, refer to:
+..
+.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
+.. ------------------------------------------------------------------------------
-- 
2.34.1