Lines Matching +full:lsb +full:- +full:first
1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
17 :ref:`raw VBI interface <raw-vbi>`. The data is passed as short
51 .. _sliced-vbi-format-negotitation:
96 :ref:`VIDIOC_STREAMON` ioctl and the first
103 -----------------------------
115 .. flat-table::
116 :header-rows: 0
117 :stub-columns: 0
120 * - __u16
121 - ``service_set``
122 - :cspan:`2`
124 If ``service_set`` is non-zero when passed with
130 a driver for the cx25840 video decoder sets lines 7-22 of both
131 fields [#f1]_ to ``V4L2_SLICED_TELETEXT_B`` and line 23 of the first
140 * - __u16
141 - ``service_lines``\ [2][24]
142 - :cspan:`2`
152 Data services are defined in :ref:`vbi-services2`. Array indices
153 map to ITU-R line numbers\ [#f2]_ as follows:
154 * -
155 -
156 - Element
157 - 525 line systems
158 - 625 line systems
159 * -
160 -
161 - ``service_lines``\ [0][1]
162 - 1
163 - 1
164 * -
165 -
166 - ``service_lines``\ [0][23]
167 - 23
168 - 23
169 * -
170 -
171 - ``service_lines``\ [1][1]
172 - 264
173 - 314
174 * -
175 -
176 - ``service_lines``\ [1][23]
177 - 286
178 - 336
179 * -
180 -
181 - :cspan:`2` Drivers must set ``service_lines`` [0][0] and
188 * - __u32
189 - ``io_size``
190 - :cspan:`2` Maximum number of bytes passed by one
197 number of non-zero elements in the returned ``service_lines``
199 * - __u32
200 - ``reserved``\ [2]
201 - :cspan:`2` This array is reserved for future extensions.
209 .. _vbi-services2:
212 -------------------
220 .. flat-table::
221 :header-rows: 1
222 :stub-columns: 0
225 * - Symbol
226 - Value
227 - Reference
228 - Lines, usually
229 - Payload
230 * - ``V4L2_SLICED_TELETEXT_B`` (Teletext System B)
231 - 0x0001
232 - :ref:`ets300706`,
235 - PAL/SECAM line 7-22, 320-335 (second field 7-22)
236 - Last 42 of the 45 byte Teletext packet, that is without clock
237 run-in and framing code, lsb first transmitted.
238 * - ``V4L2_SLICED_VPS``
239 - 0x0400
240 - :ref:`ets300231`
241 - PAL line 16
242 - Byte number 3 to 15 according to Figure 9 of ETS 300 231, lsb
243 first transmitted.
244 * - ``V4L2_SLICED_CAPTION_525``
245 - 0x1000
246 - :ref:`cea608`
247 - NTSC line 21, 284 (second field 21)
248 - Two bytes in transmission order, including parity bit, lsb first
250 * - ``V4L2_SLICED_WSS_625``
251 - 0x4000
252 - :ref:`itu1119`,
255 - PAL/SECAM line 23
256 - See :ref:`v4l2-sliced-wss-625-payload` below.
257 * - ``V4L2_SLICED_VBI_525``
258 - 0x1000
259 - :cspan:`2` Set of services applicable to 525 line systems.
260 * - ``V4L2_SLICED_VBI_625``
261 - 0x4401
262 - :cspan:`2` Set of services applicable to 625 line systems.
276 :ref:`VIDIOC_STREAMOFF <VIDIOC_STREAMON>` call, and after the first
279 .. _v4l2-sliced-wss-625-payload:
286 +-----+------------------+-----------------------+
288 +-----+--------+---------+-----------+-----------+
289 | | msb | lsb | msb | lsb |
290 | +-+-+-+--+--+-+-+--+--+-+--+---+---+--+-+--+
292 +-----+-+-+-+--+--+-+-+--+--+-+--+---+---+--+-+--+
308 ---------------------------
312 .. flat-table::
313 :header-rows: 0
314 :stub-columns: 0
317 * - __u32
318 - ``id``
319 - A flag from :ref:`vbi-services` identifying the type of data in
326 * - __u32
327 - ``field``
328 - The video field number this data has been captured from, or shall
329 be inserted at. ``0`` for the first field, ``1`` for the second
331 * - __u32
332 - ``line``
333 - The field (as opposed to frame) line number this data has been
334 captured from, or shall be inserted at. See :ref:`vbi-525` and
335 :ref:`vbi-625` for valid values. Sliced VBI capture devices can
339 * - __u32
340 - ``reserved``
341 - This field is reserved for future extensions. Applications and
343 * - __u8
344 - ``data``\ [48]
345 - The packet payload. See :ref:`vbi-services` for the contents and
380 :ref:`negotiated sliced VBI services <sliced-vbi-format-negotitation>`
383 :ref:`V4L2_CID_MPEG_STREAM_VBI_FMT <v4l2-mpeg-stream-vbi-fmt>`
387 :ref:`V4L2_CID_MPEG_STREAM_VBI_FMT <v4l2-mpeg-stream-vbi-fmt>`
389 :ref:`V4L2_MPEG_STREAM_VBI_FMT_NONE <v4l2-mpeg-stream-vbi-fmt>`,
393 :ref:`V4L2_CID_MPEG_STREAM_VBI_FMT <v4l2-mpeg-stream-vbi-fmt>`
400 certain types of MPEG streams: for example in an MPEG-2 PS but not an
401 MPEG-2 TS. In this situation, if sliced VBI data insertion is requested,
410 --------------------------------------------------
413 :ref:`V4L2_MPEG_STREAM_VBI_FMT_NONE <v4l2-mpeg-stream-vbi-fmt>`
421 --------------------------------------------------
424 :ref:`V4L2_MPEG_STREAM_VBI_FMT_IVTV <v4l2-mpeg-stream-vbi-fmt>`
426 embed up to 36 lines of sliced VBI data per frame in an MPEG-2 *Private
427 Stream 1 PES* packet encapsulated in an MPEG-2 *Program Pack* in the
433 in the file ``Documentation/userspace-api/media/drivers/cx2341x-uapi.rst`` . The
442 ``cx18`` driver provides sliced VBI data insertion into an MPEG-2 PS in
445 The following definitions specify the payload of the MPEG-2 *Private
447 :ref:`V4L2_MPEG_STREAM_VBI_FMT_IVTV <v4l2-mpeg-stream-vbi-fmt>`
448 is set. (The MPEG-2 *Private Stream 1 PES* packet header and
449 encapsulating MPEG-2 *Program Pack* header are not detailed here. Please
450 refer to the MPEG-2 specifications for details on those packet headers.)
452 The payload of the MPEG-2 *Private Stream 1 PES* packets that contain
458 4-byte boundary. The payload shall never exceed 1552 bytes (2 fields
465 -----------------------------
469 .. flat-table::
470 :header-rows: 0
471 :stub-columns: 0
474 * - __u8
475 - ``magic``\ [4]
476 - A "magic" constant from :ref:`v4l2-mpeg-vbi-fmt-ivtv-magic` that
480 * - union {
481 - (anonymous)
482 * - struct :c:type:`v4l2_mpeg_vbi_itv0`
483 - ``itv0``
484 - The primary form of the sliced VBI data payload that contains
488 * - struct :ref:`v4l2_mpeg_vbi_ITV0 <v4l2-mpeg-vbi-itv0-1>`
489 - ``ITV0``
490 - An alternate form of the sliced VBI data payload used when 36
494 * - }
495 -
497 .. _v4l2-mpeg-vbi-fmt-ivtv-magic:
500 -------------------------------------------------------------
504 .. flat-table::
505 :header-rows: 1
506 :stub-columns: 0
509 * - Defined Symbol
510 - Value
511 - Description
512 * - ``V4L2_MPEG_VBI_IVTV_MAGIC0``
513 - "itv0"
514 - Indicates the ``itv0`` member of the union in struct
517 * - ``V4L2_MPEG_VBI_IVTV_MAGIC1``
518 - "ITV0"
519 - Indicates the ``ITV0`` member of the union in struct
529 -------------------------------------------------
537 .. flat-table::
538 :header-rows: 0
539 :stub-columns: 0
542 * - __le32
543 - ``linemask``\ [2]
544 - Bitmasks indicating the VBI service lines present. These
554 linemask[0] b0: line 6 first field
555 linemask[0] b17: line 23 first field
560 linemask[1] b4-b31: unused and set to 0
561 * - struct
563 - ``line``\ [35]
564 - This is a variable length array that holds from 1 to 35 lines of
569 ``linemask``\ [1]. ``line``\ [0] corresponds to the first bit
580 .. _v4l2-mpeg-vbi-itv0-1:
583 -------------------------
587 .. flat-table::
588 :header-rows: 0
589 :stub-columns: 0
592 * - struct
594 - ``line``\ [36]
595 - A fixed length array of 36 lines of sliced VBI data. ``line``\ [0]
597 first field. ``line``\ [18] through ``line``\ [35] corresponds to
604 ------------------------------
608 .. flat-table::
609 :header-rows: 0
610 :stub-columns: 0
613 * - __u8
614 - ``id``
615 - A line identifier value from
616 :ref:`ITV0-Line-Identifier-Constants` that indicates the type of
618 * - __u8
619 - ``data``\ [42]
620 - The sliced VBI data for the line.
623 .. _ITV0-Line-Identifier-Constants:
626 ------------------------------------------------------------
630 .. flat-table::
631 :header-rows: 1
632 :stub-columns: 0
635 * - Defined Symbol
636 - Value
637 - Description
638 * - ``V4L2_MPEG_VBI_IVTV_TELETEXT_B``
639 - 1
640 - Refer to :ref:`Sliced VBI services <vbi-services2>` for a
642 * - ``V4L2_MPEG_VBI_IVTV_CAPTION_525``
643 - 4
644 - Refer to :ref:`Sliced VBI services <vbi-services2>` for a
646 * - ``V4L2_MPEG_VBI_IVTV_WSS_625``
647 - 5
648 - Refer to :ref:`Sliced VBI services <vbi-services2>` for a
650 * - ``V4L2_MPEG_VBI_IVTV_VPS``
651 - 7
652 - Refer to :ref:`Sliced VBI services <vbi-services2>` for a
657 According to :ref:`ETS 300 706 <ets300706>` lines 6-22 of the first
658 field and lines 5-22 of the second field may carry Teletext data.
661 See also :ref:`vbi-525` and :ref:`vbi-625`.