Commit 57161016 authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab
Browse files

media: docs: sliced-vbi: fix V4L2_SLICED_WSS_625 docs 



While fixing issues with PDF generation, I noticed that
bit 8 was missing for WSS 625 format.

While here, convert the literal block into a tables,
as it becomes more visible.

I opted to move the payload into a separate table, as
Sphinx has troubles with complex nested tables.

This way, it should work fine on both html and LaTeX/PDF
formats.

Signed-off-by: default avatarMauro Carvalho Chehab <mchehab+huawei@kernel.org>
parent a78801a4

Documentation/userspace-api/media/v4l/dev-sliced-vbi.rst

+16 −7
Original line number Diff line number Diff line
@@ -253,13 +253,7 @@ Sliced VBI services 


	: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

      -  See :ref:`v4l2-sliced-wss-625-payload` below.

    * - ``V4L2_SLICED_VBI_525``

      - 0x1000

      - :cspan:`2` Set of services applicable to 525 line systems.
@@ -282,6 +276,21 @@ format while i/o is in progress (between a 
:ref:`VIDIOC_STREAMOFF <VIDIOC_STREAMON>` call, and after the first

:c:func:`read()` or :c:func:`write()` call).



.. _v4l2-sliced-wss-625-payload:



V4L2_SLICED_WSS_625 payload

~~~~~~~~~~~~~~~~~~~~~~~~~~~



The payload for ``V4L2_SLICED_WSS_625`` is:



           +-----+------------------+-----------------------+

	   |Byte |        0         |           1           |

           +-----+--------+---------+-----------+-----------+

	   |     | msb    | lsb     | msb       | lsb       |

           |     +-+-+-+--+--+-+-+--+--+-+--+---+---+--+-+--+

	   | Bit |7|6|5|4 | 3|2|1|0 | x|x|13|12 | 11|10|9|8 |

           +-----+-+-+-+--+--+-+-+--+--+-+--+---+---+--+-+--+



Reading and writing sliced VBI data

===================================

Documentation/userspace-api/media/v4l/vidioc-g-sliced-vbi-cap.rst

+17 −7
Original line number Diff line number Diff line
@@ -162,13 +162,7 @@ the sliced VBI API is unsupported or ``type`` is invalid. 


	: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

      - See :ref:`v4l2-sliced-vbi-cap-wss-625-payload` below.

    * - ``V4L2_SLICED_VBI_525``

      - 0x1000

      - :cspan:`2` Set of services applicable to 525 line systems.
@@ -180,6 +174,22 @@ the sliced VBI API is unsupported or ``type`` is invalid. 


    \normalsize



.. _v4l2-sliced-vbi-cap-wss-625-payload:



V4L2_SLICED_VBI_CAP WSS_625 payload

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~



The payload for ``V4L2_SLICED_WSS_625`` is:



	    +-----+------------------+-----------------------+

	    |Byte |        0         |           1           |

	    +-----+--------+---------+-----------+-----------+

	    |     | msb    | lsb     | msb       | lsb       |

	    |     +-+-+-+--+--+-+-+--+--+-+--+---+---+--+-+--+

	    | Bit |7|6|5|4 | 3|2|1|0 | x|x|13|12 | 11|10|9|8 |

	    +-----+-+-+-+--+--+-+-+--+--+-+--+---+---+--+-+--+





Return Value

============