1 .. SPDX-License-Identifier: GFDL-1.1-no-invari !! 1 .. Permission is granted to copy, distribute and/or modify this
>> 2 .. document under the terms of the GNU Free Documentation License,
>> 3 .. Version 1.1 or any later version published by the Free Software
>> 4 .. Foundation, with no Invariant Sections, no Front-Cover Texts
>> 5 .. and no Back-Cover Texts. A copy of the license is included at
>> 6 .. Documentation/userspace-api/media/fdl-appendix.rst.
>> 7 ..
>> 8 .. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections
2 9
3 .. _V4L2-SDR-FMT-PCU20BE: 10 .. _V4L2-SDR-FMT-PCU20BE:
4 11
5 ****************************** 12 ******************************
6 V4L2_SDR_FMT_PCU20BE ('PC20') 13 V4L2_SDR_FMT_PCU20BE ('PC20')
7 ****************************** 14 ******************************
8 15
9 Planar complex unsigned 20-bit big endian IQ s 16 Planar complex unsigned 20-bit big endian IQ sample
10 17
11 Description 18 Description
12 =========== 19 ===========
13 20
14 This format contains a sequence of complex num 21 This format contains a sequence of complex number samples. Each complex
15 number consist of two parts called In-phase an 22 number consist of two parts called In-phase and Quadrature (IQ). Both I
16 and Q are represented as a 20 bit unsigned big 23 and Q are represented as a 20 bit unsigned big endian number stored in
17 32 bit space. The remaining unused bits within 24 32 bit space. The remaining unused bits within the 32 bit space will be
18 padded with 0. I value starts first and Q valu 25 padded with 0. I value starts first and Q value starts at an offset
19 equalling half of the buffer size (i.e.) offse 26 equalling half of the buffer size (i.e.) offset = buffersize/2. Out of
20 the 20 bits, bit 19:2 (18 bit) is data and bit 27 the 20 bits, bit 19:2 (18 bit) is data and bit 1:0 (2 bit) can be any
21 value. 28 value.
22 29
23 **Byte Order.** 30 **Byte Order.**
24 Each cell is one byte. 31 Each cell is one byte.
25 32
26 .. flat-table:: 33 .. flat-table::
27 :header-rows: 1 34 :header-rows: 1
28 :stub-columns: 0 35 :stub-columns: 0
29 36
30 * - Offset: 37 * - Offset:
31 - Byte B0 38 - Byte B0
32 - Byte B1 39 - Byte B1
33 - Byte B2 40 - Byte B2
34 - Byte B3 41 - Byte B3
35 * - start + 0: 42 * - start + 0:
36 - I'\ :sub:`0[19:12]` 43 - I'\ :sub:`0[19:12]`
37 - I'\ :sub:`0[11:4]` 44 - I'\ :sub:`0[11:4]`
38 - I'\ :sub:`0[3:0]; B2[3:0]=pad` 45 - I'\ :sub:`0[3:0]; B2[3:0]=pad`
39 - pad 46 - pad
40 * - start + 4: 47 * - start + 4:
41 - I'\ :sub:`1[19:12]` 48 - I'\ :sub:`1[19:12]`
42 - I'\ :sub:`1[11:4]` 49 - I'\ :sub:`1[11:4]`
43 - I'\ :sub:`1[3:0]; B2[3:0]=pad` 50 - I'\ :sub:`1[3:0]; B2[3:0]=pad`
44 - pad 51 - pad
45 * - ... 52 * - ...
46 * - start + offset: 53 * - start + offset:
47 - Q'\ :sub:`0[19:12]` 54 - Q'\ :sub:`0[19:12]`
48 - Q'\ :sub:`0[11:4]` 55 - Q'\ :sub:`0[11:4]`
49 - Q'\ :sub:`0[3:0]; B2[3:0]=pad` 56 - Q'\ :sub:`0[3:0]; B2[3:0]=pad`
50 - pad 57 - pad
51 * - start + offset + 4: 58 * - start + offset + 4:
52 - Q'\ :sub:`1[19:12]` 59 - Q'\ :sub:`1[19:12]`
53 - Q'\ :sub:`1[11:4]` 60 - Q'\ :sub:`1[11:4]`
54 - Q'\ :sub:`1[3:0]; B2[3:0]=pad` 61 - Q'\ :sub:`1[3:0]; B2[3:0]=pad`
55 - pad 62 - pad
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.