~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

TOMOYO Linux Cross Reference
Linux/Documentation/userspace-api/media/v4l/metafmt-uvc.rst

Version: ~ [ linux-6.12-rc7 ] ~ [ linux-6.11.7 ] ~ [ linux-6.10.14 ] ~ [ linux-6.9.12 ] ~ [ linux-6.8.12 ] ~ [ linux-6.7.12 ] ~ [ linux-6.6.60 ] ~ [ linux-6.5.13 ] ~ [ linux-6.4.16 ] ~ [ linux-6.3.13 ] ~ [ linux-6.2.16 ] ~ [ linux-6.1.116 ] ~ [ linux-6.0.19 ] ~ [ linux-5.19.17 ] ~ [ linux-5.18.19 ] ~ [ linux-5.17.15 ] ~ [ linux-5.16.20 ] ~ [ linux-5.15.171 ] ~ [ linux-5.14.21 ] ~ [ linux-5.13.19 ] ~ [ linux-5.12.19 ] ~ [ linux-5.11.22 ] ~ [ linux-5.10.229 ] ~ [ linux-5.9.16 ] ~ [ linux-5.8.18 ] ~ [ linux-5.7.19 ] ~ [ linux-5.6.19 ] ~ [ linux-5.5.19 ] ~ [ linux-5.4.285 ] ~ [ linux-5.3.18 ] ~ [ linux-5.2.21 ] ~ [ linux-5.1.21 ] ~ [ linux-5.0.21 ] ~ [ linux-4.20.17 ] ~ [ linux-4.19.323 ] ~ [ linux-4.18.20 ] ~ [ linux-4.17.19 ] ~ [ linux-4.16.18 ] ~ [ linux-4.15.18 ] ~ [ linux-4.14.336 ] ~ [ linux-4.13.16 ] ~ [ linux-4.12.14 ] ~ [ linux-4.11.12 ] ~ [ linux-4.10.17 ] ~ [ linux-4.9.337 ] ~ [ linux-4.4.302 ] ~ [ linux-3.10.108 ] ~ [ linux-2.6.32.71 ] ~ [ linux-2.6.0 ] ~ [ linux-2.4.37.11 ] ~ [ unix-v6-master ] ~ [ ccs-tools-1.8.12 ] ~ [ policy-sample ] ~
Architecture: ~ [ i386 ] ~ [ alpha ] ~ [ m68k ] ~ [ mips ] ~ [ ppc ] ~ [ sparc ] ~ [ sparc64 ] ~

Diff markup

Differences between /Documentation/userspace-api/media/v4l/metafmt-uvc.rst (Architecture ppc) and /Documentation/userspace-api/media/v4l/metafmt-uvc.rst (Architecture i386)


  1 .. SPDX-License-Identifier: GFDL-1.1-no-invari      1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
  2                                                     2 
  3 .. _v4l2-meta-fmt-uvc:                              3 .. _v4l2-meta-fmt-uvc:
  4                                                     4 
  5 *******************************                     5 *******************************
  6 V4L2_META_FMT_UVC ('UVCH')                          6 V4L2_META_FMT_UVC ('UVCH')
  7 *******************************                     7 *******************************
  8                                                     8 
  9 UVC Payload Header Data                             9 UVC Payload Header Data
 10                                                    10 
 11                                                    11 
 12 Description                                        12 Description
 13 ===========                                        13 ===========
 14                                                    14 
 15 This format describes standard UVC metadata, e     15 This format describes standard UVC metadata, extracted from UVC packet headers
 16 and provided by the UVC driver through metadat     16 and provided by the UVC driver through metadata video nodes. That data includes
 17 exact copies of the standard part of UVC Paylo     17 exact copies of the standard part of UVC Payload Header contents and auxiliary
 18 timing information, required for precise inter     18 timing information, required for precise interpretation of timestamps, contained
 19 in those headers. See section "2.4.3.3 Video a     19 in those headers. See section "2.4.3.3 Video and Still Image Payload Headers" of
 20 the "UVC 1.5 Class specification" for details.     20 the "UVC 1.5 Class specification" for details.
 21                                                    21 
 22 Each UVC payload header can be between 2 and 1     22 Each UVC payload header can be between 2 and 12 bytes large. Buffers can
 23 contain multiple headers, if multiple such hea     23 contain multiple headers, if multiple such headers have been transmitted by the
 24 camera for the respective frame. However, the      24 camera for the respective frame. However, the driver may drop headers when the
 25 buffer is full, when they contain no useful in     25 buffer is full, when they contain no useful information (e.g. those without the
 26 SCR field or with that field identical to the      26 SCR field or with that field identical to the previous header), or generally to
 27 perform rate limiting when the device sends a      27 perform rate limiting when the device sends a large number of headers.
 28                                                    28 
 29 Each individual block contains the following f     29 Each individual block contains the following fields:
 30                                                    30 
 31 .. flat-table:: UVC Metadata Block                 31 .. flat-table:: UVC Metadata Block
 32     :widths: 1 4                                   32     :widths: 1 4
 33     :header-rows:  1                               33     :header-rows:  1
 34     :stub-columns: 0                               34     :stub-columns: 0
 35                                                    35 
 36     * - Field                                      36     * - Field
 37       - Description                                37       - Description
 38     * - __u64 ts;                                  38     * - __u64 ts;
 39       - system timestamp in host byte order, m     39       - system timestamp in host byte order, measured by the driver upon
 40         reception of the payload                   40         reception of the payload
 41     * - __u16 sof;                                 41     * - __u16 sof;
 42       - USB Frame Number in host byte order, a     42       - USB Frame Number in host byte order, also obtained by the driver as
 43         close as possible to the above timesta     43         close as possible to the above timestamp to enable correlation between
 44         them                                       44         them
 45     * - :cspan:`1` *The rest is an exact copy      45     * - :cspan:`1` *The rest is an exact copy of the UVC payload header:*
 46     * - __u8 length;                               46     * - __u8 length;
 47       - length of the rest of the block, inclu     47       - length of the rest of the block, including this field
 48     * - __u8 flags;                                48     * - __u8 flags;
 49       - Flags, indicating presence of other st     49       - Flags, indicating presence of other standard UVC fields
 50     * - __u8 buf[];                                50     * - __u8 buf[];
 51       - The rest of the header, possibly inclu     51       - The rest of the header, possibly including UVC PTS and SCR fields
                                                      

~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

kernel.org | git.kernel.org | LWN.net | Project Home | SVN repository | Mail admin

Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.

sflogo.php