linux-stable.git/Documentation/media/kapi, branch v5.4

media: docs-rst: Clarify duration of LP-11 mode

2019-08-15T11:15:25+00:00

Add a sentence that makes it more clear when the CSI-2 transmitter
must, if possible, exit LP-11 mode. That is, maintain LP-11 mode
until stream on, at which point the transmitter activates the clock
lane and transition to HS mode.

Signed-off-by: Steve Longerbeam 
Signed-off-by: Sakari Ailus 
Signed-off-by: Mauro Carvalho Chehab

media: v4l: Documentation: Serial busses use parallel mbus codes

2019-08-15T11:08:47+00:00

When the support for serial busses was introduced in V4L2, it was decided
to use the existing parallel bus media bus pixel codes to describe them.
While this was a practical choice at the time, it necessitates choosing
which one of the many parallel mbus pixel codes to use, for on the serial
busses these formats are effectively all equivalent.

The practice has always been to use the pixel code that describes a bus
that transfers a single sample per clock. Document this.

Signed-off-by: Sakari Ailus 
Acked-by: Hans Verkuil 
Signed-off-by: Mauro Carvalho Chehab

media: v4l: ctrls: Add debug messages

2019-07-25T10:26:49+00:00

Currently, the v4l2 control code is a bit silent on errors.
Add debug messages on (hopefully) most of the error paths.

Signed-off-by: Ezequiel Garcia 
Signed-off-by: Hans Verkuil 
Signed-off-by: Mauro Carvalho Chehab

media: docs: v4l2-controls: remove outdated paragraph

2019-06-21T21:06:25+00:00

This paragraph was added by commit a42b57f5aacf ("V4L/DVB: Documentation:
add v4l2-controls.txt documenting the new controls API") back in 2010, when
the controls API has been improved. Nowadays it is a bit anachronistic, so
remove it.

The same information is stated in up-to-date wording a few paragraphs later

> You’re done! And this is sufficient for most of the drivers we have. No
> need to do any validation of control values, or implement QUERYCTRL,
> QUERY_EXT_CTRL and QUERYMENU. And G/S_CTRL as well as G/TRY/S_EXT_CTRLS
> are automatically supported.

Signed-off-by: Luca Ceresoli 
Signed-off-by: Hans Verkuil 
Signed-off-by: Mauro Carvalho Chehab

media: docs: v4l2-controls: document file to include

2019-06-21T21:05:18+00:00

The tutorial in this section is almost complete, add the one missing bit.

Signed-off-by: Luca Ceresoli 
Signed-off-by: Hans Verkuil 
Signed-off-by: Mauro Carvalho Chehab

media: docs: v4l2-controls: convert code blocks to C

2019-06-21T21:04:57+00:00

All these code blocks contain C code, enable C formatting for a nicer
reading.

Signed-off-by: Luca Ceresoli 
Signed-off-by: Hans Verkuil 
Signed-off-by: Mauro Carvalho Chehab

media: docs: v4l2-controls: add links to functions

2019-06-21T21:04:25+00:00

This section lacks links to functions. Add one to simplify reading.

Signed-off-by: Luca Ceresoli 
Signed-off-by: Hans Verkuil 
Signed-off-by: Mauro Carvalho Chehab

media: docs: v4l2-controls: rearrange control initialization sequence

2019-06-21T21:04:03+00:00

The code snippet showing how to add controls to the driver’s top-level
struct is present twice, but only the second time it is split in the V4L2
and subdev cases. Consolidate everything at the beginning.

Also remove the "Where foo->bar is of type struct baz" sentences, this
obvious from the code.

Signed-off-by: Luca Ceresoli 
Signed-off-by: Hans Verkuil 
Signed-off-by: Mauro Carvalho Chehab

media: docs: v4l2-controls: add links to structs

2019-06-21T21:03:16+00:00

This section lacks links to struct definitions. Add one where each struct
is introduced.

Signed-off-by: Luca Ceresoli 
Signed-off-by: Hans Verkuil 
Signed-off-by: Mauro Carvalho Chehab

media: docs: fix minor typos

2019-06-05T15:31:51+00:00

Fix minor typos in the DVB demux documentation.

Signed-off-by: Marc Gonzalez 
Signed-off-by: Mauro Carvalho Chehab