Merge tag 'tegra-for-4.8-i2c' of git://git.kernel.org/pub/scm/linux/kernel/git/tegra...
[cascardo/linux.git] / Documentation / media / uapi / v4l / common.rst
1 .. -*- coding: utf-8; mode: rst -*-
2
3 .. _common:
4
5 ###################
6 Common API Elements
7 ###################
8 Programming a V4L2 device consists of these steps:
9
10 -  Opening the device
11
12 -  Changing device properties, selecting a video and audio input, video
13    standard, picture brightness a. o.
14
15 -  Negotiating a data format
16
17 -  Negotiating an input/output method
18
19 -  The actual input/output loop
20
21 -  Closing the device
22
23 In practice most steps are optional and can be executed out of order. It
24 depends on the V4L2 device type, you can read about the details in
25 :ref:`devices`. In this chapter we will discuss the basic concepts
26 applicable to all devices.
27
28
29 .. toctree::
30     :maxdepth: 1
31
32     open
33     querycap
34     app-pri
35     video
36     audio
37     tuner
38     standard
39     dv-timings
40     control
41     extended-controls
42     format
43     planar-apis
44     crop
45     selection-api
46     streaming-par