요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-no-invariants-or-later
3
********************************************************************************************************************************************************************************************************************************************************************************
4
V4L2_META_FMT_GENERIC_8 ('MET8'), V4L2_META_FMT_GENERIC_CSI2_10 ('MC1A'), V4L2_META_FMT_GENERIC_CSI2_12 ('MC1C'), V4L2_META_FMT_GENERIC_CSI2_14 ('MC1E'), V4L2_META_FMT_GENERIC_CSI2_16 ('MC1G'), V4L2_META_FMT_GENERIC_CSI2_20 ('MC1K'), V4L2_META_FMT_GENERIC_CSI2_24 ('MC1O')
5
********************************************************************************************************************************************************************************************************************************************************************************
8
Generic line-based metadata formats
11
Description
12
===========
14
These generic line-based metadata formats define the memory layout of the data
15
without defining the format or meaning of the metadata itself.
17
.. _v4l2-meta-fmt-generic-8:
19
V4L2_META_FMT_GENERIC_8
20
-----------------------
22
The V4L2_META_FMT_GENERIC_8 format is a plain 8-bit metadata format. This format
23
is used on CSI-2 for 8 bits per :term:`Data Unit`.
25
Additionally it is used for 16 bits per Data Unit when two bytes of metadata are
26
packed into one 16-bit Data Unit. Otherwise the 16 bits per pixel dataformat is
27
:ref:`V4L2_META_FMT_GENERIC_CSI2_16 <v4l2-meta-fmt-generic-csi2-16>`.
29
**Byte Order Of V4L2_META_FMT_GENERIC_8.**
30
Each cell is one byte. "M" denotes a byte of metadata.
32
.. tabularcolumns:: |p{2.4cm}|p{1.2cm}|p{1.2cm}|p{1.2cm}|p{1.2cm}|
34
.. flat-table:: Sample 4x2 Metadata Frame
35
:header-rows: 0
36
:stub-columns: 0
37
:widths: 12 8 8 8 8
39
* - start + 0:
40
- M\ :sub:`00`
41
- M\ :sub:`10`
42
- M\ :sub:`20`
43
- M\ :sub:`30`
44
* - start + 4:
45
- M\ :sub:`01`
46
- M\ :sub:`11`
47
- M\ :sub:`21`
48
- M\ :sub:`31`
50
.. _v4l2-meta-fmt-generic-csi2-10:
52
V4L2_META_FMT_GENERIC_CSI2_10
53
-----------------------------
55
V4L2_META_FMT_GENERIC_CSI2_10 contains 8-bit generic metadata packed in 10-bit
56
Data Units, with one padding byte after every four bytes of metadata. This
57
format is typically used by CSI-2 receivers with a source that transmits
58
MEDIA_BUS_FMT_META_10 and the CSI-2 receiver writes the received data to memory
59
as-is.
61
The packing of the data follows the MIPI CSI-2 specification and the padding of
62
the data is defined in the MIPI CCS specification.
64
This format is also used in conjunction with 20 bits per :term:`Data Unit`
65
formats that pack two bytes of metadata into one Data Unit. Otherwise the
66
20 bits per pixel dataformat is :ref:`V4L2_META_FMT_GENERIC_CSI2_20
67
<v4l2-meta-fmt-generic-csi2-20>`.
69
This format is little endian.
71
**Byte Order Of V4L2_META_FMT_GENERIC_CSI2_10.**
72
Each cell is one byte. "M" denotes a byte of metadata and "x" a byte of padding.
74
.. tabularcolumns:: |p{2.4cm}|p{1.2cm}|p{1.2cm}|p{1.2cm}|p{1.2cm}|p{1.8cm}|
76
.. flat-table:: Sample 4x2 Metadata Frame
77
:header-rows: 0
78
:stub-columns: 0
79
:widths: 12 8 8 8 8 8
81
* - start + 0:
82
- M\ :sub:`00`
83
- M\ :sub:`10`
84
- M\ :sub:`20`
85
- M\ :sub:`30`
86
- x
87
* - start + 5:
88
- M\ :sub:`01`
89
- M\ :sub:`11`
90
- M\ :sub:`21`
91
- M\ :sub:`31`
92
- x
94
.. _v4l2-meta-fmt-generic-csi2-12:
96
V4L2_META_FMT_GENERIC_CSI2_12
97
-----------------------------
99
V4L2_META_FMT_GENERIC_CSI2_12 contains 8-bit generic metadata packed in 12-bit
100
Data Units, with one padding byte after every two bytes of metadata. This format
101
is typically used by CSI-2 receivers with a source that transmits
102
MEDIA_BUS_FMT_META_12 and the CSI-2 receiver writes the received data to memory
103
as-is.
105
The packing of the data follows the MIPI CSI-2 specification and the padding of
106
the data is defined in the MIPI CCS specification.
108
This format is also used in conjunction with 24 bits per :term:`Data Unit`
109
formats that pack two bytes of metadata into one Data Unit. Otherwise the
110
24 bits per pixel dataformat is :ref:`V4L2_META_FMT_GENERIC_CSI2_24
111
<v4l2-meta-fmt-generic-csi2-24>`.
113
This format is little endian.
115
**Byte Order Of V4L2_META_FMT_GENERIC_CSI2_12.**
116
Each cell is one byte. "M" denotes a byte of metadata and "x" a byte of padding.
118
.. tabularcolumns:: |p{2.4cm}|p{1.2cm}|p{1.2cm}|p{1.8cm}|p{1.2cm}|p{1.2cm}|p{1.8cm}|
120
.. flat-table:: Sample 4x2 Metadata Frame
121
:header-rows: 0
122
:stub-columns: 0
123
:widths: 12 8 8 8 8 8 8
125
* - start + 0:
126
- M\ :sub:`00`
127
- M\ :sub:`10`
128
- x
129
- M\ :sub:`20`
130
- M\ :sub:`30`
131
- x
132
* - start + 6:
133
- M\ :sub:`01`
134
- M\ :sub:`11`
135
- x
136
- M\ :sub:`21`
137
- M\ :sub:`31`
138
- x
140
.. _v4l2-meta-fmt-generic-csi2-14:
142
V4L2_META_FMT_GENERIC_CSI2_14
143
-----------------------------
145
V4L2_META_FMT_GENERIC_CSI2_14 contains 8-bit generic metadata packed in 14-bit
146
Data Units, with three padding bytes after every four bytes of metadata. This
147
format is typically used by CSI-2 receivers with a source that transmits
148
MEDIA_BUS_FMT_META_14 and the CSI-2 receiver writes the received data to memory
149
as-is.
151
The packing of the data follows the MIPI CSI-2 specification and the padding of
152
the data is defined in the MIPI CCS specification.
154
This format is little endian.
156
**Byte Order Of V4L2_META_FMT_GENERIC_CSI2_14.**
157
Each cell is one byte. "M" denotes a byte of metadata and "x" a byte of padding.
159
.. tabularcolumns:: |p{2.4cm}|p{1.2cm}|p{1.2cm}|p{1.2cm}|p{1.2cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|
161
.. flat-table:: Sample 4x2 Metadata Frame
162
:header-rows: 0
163
:stub-columns: 0
164
:widths: 12 8 8 8 8 8 8 8
166
* - start + 0:
167
- M\ :sub:`00`
168
- M\ :sub:`10`
169
- M\ :sub:`20`
170
- M\ :sub:`30`
171
- x
172
- x
173
- x
174
* - start + 7:
175
- M\ :sub:`01`
176
- M\ :sub:`11`
177
- M\ :sub:`21`
178
- M\ :sub:`31`
179
- x
180
- x
181
- x
183
.. _v4l2-meta-fmt-generic-csi2-16:
185
V4L2_META_FMT_GENERIC_CSI2_16
186
-----------------------------
188
V4L2_META_FMT_GENERIC_CSI2_16 contains 8-bit generic metadata packed in 16-bit
189
Data Units, with one padding byte after every byte of metadata. This format is
190
typically used by CSI-2 receivers with a source that transmits
191
MEDIA_BUS_FMT_META_16 and the CSI-2 receiver writes the received data to memory
192
as-is.
194
The packing of the data follows the MIPI CSI-2 specification and the padding of
195
the data is defined in the MIPI CCS specification.
197
Some devices support more efficient packing of metadata in conjunction with
198
16-bit image data. In that case the dataformat is
199
:ref:`V4L2_META_FMT_GENERIC_8 <v4l2-meta-fmt-generic-8>`.
201
This format is little endian.
203
**Byte Order Of V4L2_META_FMT_GENERIC_CSI2_16.**
204
Each cell is one byte. "M" denotes a byte of metadata and "x" a byte of padding.
206
.. tabularcolumns:: |p{2.4cm}|p{1.2cm}|p{.8cm}|p{1.2cm}|p{.8cm}|p{1.2cm}|p{.8cm}|p{1.2cm}|p{.8cm}|
208
.. flat-table:: Sample 4x2 Metadata Frame
209
:header-rows: 0
210
:stub-columns: 0
211
:widths: 12 8 8 8 8 8 8 8 8
213
* - start + 0:
214
- M\ :sub:`00`
215
- x
216
- M\ :sub:`10`
217
- x
218
- M\ :sub:`20`
219
- x
220
- M\ :sub:`30`
221
- x
222
* - start + 8:
223
- M\ :sub:`01`
224
- x
225
- M\ :sub:`11`
226
- x
227
- M\ :sub:`21`
228
- x
229
- M\ :sub:`31`
230
- x
232
.. _v4l2-meta-fmt-generic-csi2-20:
234
V4L2_META_FMT_GENERIC_CSI2_20
235
-----------------------------
237
V4L2_META_FMT_GENERIC_CSI2_20 contains 8-bit generic metadata packed in 20-bit
238
Data Units, with alternating one or two padding bytes after every byte of
239
metadata. This format is typically used by CSI-2 receivers with a source that
240
transmits MEDIA_BUS_FMT_META_20 and the CSI-2 receiver writes the received data
241
to memory as-is.
243
The packing of the data follows the MIPI CSI-2 specification and the padding of
244
the data is defined in the MIPI CCS specification.
246
Some devices support more efficient packing of metadata in conjunction with
247
16-bit image data. In that case the dataformat is
248
:ref:`V4L2_META_FMT_GENERIC_CSI2_10 <v4l2-meta-fmt-generic-csi2-10>`.
250
This format is little endian.
252
**Byte Order Of V4L2_META_FMT_GENERIC_CSI2_20.**
253
Each cell is one byte. "M" denotes a byte of metadata and "x" a byte of padding.
255
.. tabularcolumns:: |p{2.4cm}|p{1.2cm}|p{1.2cm}|p{1.2cm}|p{1.2cm}|p{1.8cm}|p{1.2cm}|p{1.2cm}|p{1.2cm}|p{1.2cm}|p{1.8cm}
257
.. flat-table:: Sample 4x2 Metadata Frame
258
:header-rows: 0
259
:stub-columns: 0
260
:widths: 12 8 8 8 8 8 8 8 8 8 8
262
* - start + 0:
263
- M\ :sub:`00`
264
- x
265
- M\ :sub:`10`
266
- x
267
- x
268
- M\ :sub:`20`
269
- x
270
- M\ :sub:`30`
271
- x
272
- x
273
* - start + 10:
274
- M\ :sub:`01`
275
- x
276
- M\ :sub:`11`
277
- x
278
- x
279
- M\ :sub:`21`
280
- x
281
- M\ :sub:`31`
282
- x
283
- x
285
.. _v4l2-meta-fmt-generic-csi2-24:
287
V4L2_META_FMT_GENERIC_CSI2_24
288
-----------------------------
290
V4L2_META_FMT_GENERIC_CSI2_24 contains 8-bit generic metadata packed in 24-bit
291
Data Units, with two padding bytes after every byte of metadata. This format is
292
typically used by CSI-2 receivers with a source that transmits
293
MEDIA_BUS_FMT_META_24 and the CSI-2 receiver writes the received data to memory
294
as-is.
296
The packing of the data follows the MIPI CSI-2 specification and the padding of
297
the data is defined in the MIPI CCS specification.
299
Some devices support more efficient packing of metadata in conjunction with
300
16-bit image data. In that case the dataformat is
301
:ref:`V4L2_META_FMT_GENERIC_CSI2_12 <v4l2-meta-fmt-generic-csi2-12>`.
303
This format is little endian.
305
**Byte Order Of V4L2_META_FMT_GENERIC_CSI2_24.**
306
Each cell is one byte. "M" denotes a byte of metadata and "x" a byte of padding.
308
.. tabularcolumns:: |p{2.4cm}|p{1.2cm}|p{.8cm}|p{.8cm}|p{1.2cm}|p{.8cm}|p{.8cm}|p{1.2cm}|p{.8cm}|p{.8cm}|p{1.2cm}|p{.8cm}|p{.8cm}|
310
.. flat-table:: Sample 4x2 Metadata Frame
311
:header-rows: 0
312
:stub-columns: 0
313
:widths: 12 8 8 8 8 8 8 8 8 8 8 8 8
315
* - start + 0:
316
- M\ :sub:`00`
317
- x
318
- x
319
- M\ :sub:`10`
320
- x
321
- x
322
- M\ :sub:`20`
323
- x
324
- x
325
- M\ :sub:`30`
326
- x
327
- x
328
* - start + 12:
329
- M\ :sub:`01`
330
- x
331
- x
332
- M\ :sub:`11`
333
- x
334
- x
335
- M\ :sub:`21`
336
- x
337
- x
338
- M\ :sub:`31`
339
- x
340
- x
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
형식이 아니라 메모리 배치를 정의하는 메타데이터
1-18이 범용 line-based metadata 형식은 메타데이터의 의미나 내부 형식을 정의하지 않고, 메모리에 바이트가 놓이는 방식만 정의합니다. 장치와 사용자 공간은 별도 규약으로 각 metadata byte의 의미를 합의해야 합니다.
항목설명
`MET8``V4L2_META_FMT_GENERIC_8`
`MC1A``V4L2_META_FMT_GENERIC_CSI2_10`
`MC1C``V4L2_META_FMT_GENERIC_CSI2_12`
`MC1E``V4L2_META_FMT_GENERIC_CSI2_14`
`MC1G``V4L2_META_FMT_GENERIC_CSI2_16`
`MC1K``V4L2_META_FMT_GENERIC_CSI2_20`
`MC1O``V4L2_META_FMT_GENERIC_CSI2_24`
Data Unit 폭별 범용 형식입니다.
.. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-no-invariants-or-later
********************************************************************************************************************************************************************************************************************************************************************************
V4L2_META_FMT_GENERIC_8 ('MET8'), V4L2_META_FMT_GENERIC_CSI2_10 ('MC1A'), V4L2_META_FMT_GENERIC_CSI2_12 ('MC1C'), V4L2_META_FMT_GENERIC_CSI2_14 ('MC1E'), V4L2_META_FMT_GENERIC_CSI2_16 ('MC1G'), V4L2_META_FMT_GENERIC_CSI2_20 ('MC1K'), V4L2_META_FMT_GENERIC_CSI2_24 ('MC1O')
********************************************************************************************************************************************************************************************************************************************************************************
Generic line-based metadata formats
Description
===========
These generic line-based metadata formats define the memory layout of the data
without defining the format or meaning of the metadata itself.
.. _v4l2-meta-fmt-generic-8:
GENERIC_8: padding 없는 8비트 배열
19-51`V4L2_META_FMT_GENERIC_8`은 평범한 8비트 메타데이터 형식이며 CSI-2에서 Data Unit당 8비트일 때 사용합니다. 두 metadata byte를 하나의 16비트 Data Unit에 조밀하게 넣는 경우에도 이 형식을 사용합니다. 16비트 Data Unit에서 byte마다 padding이 있는 배치는 `GENERIC_CSI2_16`입니다.
4×2 예제 행메모리의 바이트 순서
첫째 행start+0: M00, M10, M20, M30
둘째 행start+4: M01, M11, M21, M31
`Mxy`는 x번째 열, y번째 행의 metadata byte이고 `x`는 padding byte입니다.
V4L2_META_FMT_GENERIC_8
-----------------------
The V4L2_META_FMT_GENERIC_8 format is a plain 8-bit metadata format. This format
is used on CSI-2 for 8 bits per :term:`Data Unit`.
Additionally it is used for 16 bits per Data Unit when two bytes of metadata are
packed into one 16-bit Data Unit. Otherwise the 16 bits per pixel dataformat is
:ref:`V4L2_META_FMT_GENERIC_CSI2_16 <v4l2-meta-fmt-generic-csi2-16>`.
**Byte Order Of V4L2_META_FMT_GENERIC_8.**
Each cell is one byte. "M" denotes a byte of metadata.
.. tabularcolumns:: |p{2.4cm}|p{1.2cm}|p{1.2cm}|p{1.2cm}|p{1.2cm}|
.. flat-table:: Sample 4x2 Metadata Frame
:header-rows: 0
:stub-columns: 0
:widths: 12 8 8 8 8
* - start + 0:
- M\ :sub:`00`
- M\ :sub:`10`
- M\ :sub:`20`
- M\ :sub:`30`
* - start + 4:
- M\ :sub:`01`
- M\ :sub:`11`
- M\ :sub:`21`
- M\ :sub:`31`
.. _v4l2-meta-fmt-generic-csi2-10:
CSI2_10: metadata 4바이트마다 padding 1바이트
52-95`V4L2_META_FMT_GENERIC_CSI2_10`은 8비트 metadata를 10비트 Data Unit에 담아 metadata 네 바이트 뒤마다 padding 한 바이트를 둡니다. 보통 source가 `MEDIA_BUS_FMT_META_10`을 전송하고 CSI-2 receiver가 수신 데이터를 변환하지 않고 메모리에 쓸 때 사용합니다.
데이터 packing은 MIPI CSI-2 명세를, padding은 MIPI CCS 명세를 따르며 little endian입니다. 20비트 Data Unit에 metadata 두 바이트를 조밀하게 담는 형식과 함께 이 배치를 쓸 수 있고, 그렇지 않은 20비트 배치는 `GENERIC_CSI2_20`입니다.
4×2 예제 행메모리의 바이트 순서
첫째 행start+0: M00, M10, M20, M30, x
둘째 행start+5: M01, M11, M21, M31, x
`Mxy`는 x번째 열, y번째 행의 metadata byte이고 `x`는 padding byte입니다.
V4L2_META_FMT_GENERIC_CSI2_10
-----------------------------
V4L2_META_FMT_GENERIC_CSI2_10 contains 8-bit generic metadata packed in 10-bit
Data Units, with one padding byte after every four bytes of metadata. This
format is typically used by CSI-2 receivers with a source that transmits
MEDIA_BUS_FMT_META_10 and the CSI-2 receiver writes the received data to memory
as-is.
The packing of the data follows the MIPI CSI-2 specification and the padding of
the data is defined in the MIPI CCS specification.
This format is also used in conjunction with 20 bits per :term:`Data Unit`
formats that pack two bytes of metadata into one Data Unit. Otherwise the
20 bits per pixel dataformat is :ref:`V4L2_META_FMT_GENERIC_CSI2_20
<v4l2-meta-fmt-generic-csi2-20>`.
This format is little endian.
**Byte Order Of V4L2_META_FMT_GENERIC_CSI2_10.**
Each cell is one byte. "M" denotes a byte of metadata and "x" a byte of padding.
.. tabularcolumns:: |p{2.4cm}|p{1.2cm}|p{1.2cm}|p{1.2cm}|p{1.2cm}|p{1.8cm}|
.. flat-table:: Sample 4x2 Metadata Frame
:header-rows: 0
:stub-columns: 0
:widths: 12 8 8 8 8 8
* - start + 0:
- M\ :sub:`00`
- M\ :sub:`10`
- M\ :sub:`20`
- M\ :sub:`30`
- x
* - start + 5:
- M\ :sub:`01`
- M\ :sub:`11`
- M\ :sub:`21`
- M\ :sub:`31`
- x
.. _v4l2-meta-fmt-generic-csi2-12:
CSI2_12: metadata 2바이트마다 padding 1바이트
96-141`V4L2_META_FMT_GENERIC_CSI2_12`는 8비트 metadata를 12비트 Data Unit에 담아 두 metadata byte마다 padding 한 바이트를 둡니다. `MEDIA_BUS_FMT_META_12` source의 CSI-2 수신 데이터를 그대로 기록할 때 쓰는 little-endian 형식입니다.
MIPI CSI-2 packing과 MIPI CCS padding을 따릅니다. 24비트 Data Unit에 metadata 두 바이트를 조밀하게 담는 경우 이 형식을 쓰며, 일반적인 24비트 배치는 `GENERIC_CSI2_24`입니다.
4×2 예제 행메모리의 바이트 순서
첫째 행start+0: M00, M10, x, M20, M30, x
둘째 행start+6: M01, M11, x, M21, M31, x
`Mxy`는 x번째 열, y번째 행의 metadata byte이고 `x`는 padding byte입니다.
V4L2_META_FMT_GENERIC_CSI2_12
-----------------------------
V4L2_META_FMT_GENERIC_CSI2_12 contains 8-bit generic metadata packed in 12-bit
Data Units, with one padding byte after every two bytes of metadata. This format
is typically used by CSI-2 receivers with a source that transmits
MEDIA_BUS_FMT_META_12 and the CSI-2 receiver writes the received data to memory
as-is.
The packing of the data follows the MIPI CSI-2 specification and the padding of
the data is defined in the MIPI CCS specification.
This format is also used in conjunction with 24 bits per :term:`Data Unit`
formats that pack two bytes of metadata into one Data Unit. Otherwise the
24 bits per pixel dataformat is :ref:`V4L2_META_FMT_GENERIC_CSI2_24
<v4l2-meta-fmt-generic-csi2-24>`.
This format is little endian.
**Byte Order Of V4L2_META_FMT_GENERIC_CSI2_12.**
Each cell is one byte. "M" denotes a byte of metadata and "x" a byte of padding.
.. tabularcolumns:: |p{2.4cm}|p{1.2cm}|p{1.2cm}|p{1.8cm}|p{1.2cm}|p{1.2cm}|p{1.8cm}|
.. flat-table:: Sample 4x2 Metadata Frame
:header-rows: 0
:stub-columns: 0
:widths: 12 8 8 8 8 8 8
* - start + 0:
- M\ :sub:`00`
- M\ :sub:`10`
- x
- M\ :sub:`20`
- M\ :sub:`30`
- x
* - start + 6:
- M\ :sub:`01`
- M\ :sub:`11`
- x
- M\ :sub:`21`
- M\ :sub:`31`
- x
.. _v4l2-meta-fmt-generic-csi2-14:
CSI2_14: metadata 4바이트마다 padding 3바이트
142-184`V4L2_META_FMT_GENERIC_CSI2_14`는 14비트 Data Unit에 8비트 metadata를 담아 metadata 네 바이트마다 padding 세 바이트를 붙입니다. `MEDIA_BUS_FMT_META_14` source를 receiver가 그대로 메모리에 쓸 때 사용하며 MIPI CSI-2/CCS 배치와 little-endian 순서를 따릅니다.
4×2 예제 행메모리의 바이트 순서
첫째 행start+0: M00, M10, M20, M30, x, x, x
둘째 행start+7: M01, M11, M21, M31, x, x, x
`Mxy`는 x번째 열, y번째 행의 metadata byte이고 `x`는 padding byte입니다.
V4L2_META_FMT_GENERIC_CSI2_14
-----------------------------
V4L2_META_FMT_GENERIC_CSI2_14 contains 8-bit generic metadata packed in 14-bit
Data Units, with three padding bytes after every four bytes of metadata. This
format is typically used by CSI-2 receivers with a source that transmits
MEDIA_BUS_FMT_META_14 and the CSI-2 receiver writes the received data to memory
as-is.
The packing of the data follows the MIPI CSI-2 specification and the padding of
the data is defined in the MIPI CCS specification.
This format is little endian.
**Byte Order Of V4L2_META_FMT_GENERIC_CSI2_14.**
Each cell is one byte. "M" denotes a byte of metadata and "x" a byte of padding.
.. tabularcolumns:: |p{2.4cm}|p{1.2cm}|p{1.2cm}|p{1.2cm}|p{1.2cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|
.. flat-table:: Sample 4x2 Metadata Frame
:header-rows: 0
:stub-columns: 0
:widths: 12 8 8 8 8 8 8 8
* - start + 0:
- M\ :sub:`00`
- M\ :sub:`10`
- M\ :sub:`20`
- M\ :sub:`30`
- x
- x
- x
* - start + 7:
- M\ :sub:`01`
- M\ :sub:`11`
- M\ :sub:`21`
- M\ :sub:`31`
- x
- x
- x
.. _v4l2-meta-fmt-generic-csi2-16:
CSI2_16: metadata 1바이트마다 padding 1바이트
185-233`V4L2_META_FMT_GENERIC_CSI2_16`은 16비트 Data Unit 하나마다 8비트 metadata 한 바이트와 padding 한 바이트를 둡니다. `MEDIA_BUS_FMT_META_16` 수신 데이터를 그대로 저장하는 little-endian CSI-2/CCS 배치입니다.
일부 장치는 16비트 영상 데이터와 함께 metadata를 더 효율적으로 packing해 두 바이트를 한 Data Unit에 넣습니다. 그 경우 padding 없는 `V4L2_META_FMT_GENERIC_8`을 사용합니다.
4×2 예제 행메모리의 바이트 순서
첫째 행start+0: M00, x, M10, x, M20, x, M30, x
둘째 행start+8: M01, x, M11, x, M21, x, M31, x
`Mxy`는 x번째 열, y번째 행의 metadata byte이고 `x`는 padding byte입니다.
V4L2_META_FMT_GENERIC_CSI2_16
-----------------------------
V4L2_META_FMT_GENERIC_CSI2_16 contains 8-bit generic metadata packed in 16-bit
Data Units, with one padding byte after every byte of metadata. This format is
typically used by CSI-2 receivers with a source that transmits
MEDIA_BUS_FMT_META_16 and the CSI-2 receiver writes the received data to memory
as-is.
The packing of the data follows the MIPI CSI-2 specification and the padding of
the data is defined in the MIPI CCS specification.
Some devices support more efficient packing of metadata in conjunction with
16-bit image data. In that case the dataformat is
:ref:`V4L2_META_FMT_GENERIC_8 <v4l2-meta-fmt-generic-8>`.
This format is little endian.
**Byte Order Of V4L2_META_FMT_GENERIC_CSI2_16.**
Each cell is one byte. "M" denotes a byte of metadata and "x" a byte of padding.
.. tabularcolumns:: |p{2.4cm}|p{1.2cm}|p{.8cm}|p{1.2cm}|p{.8cm}|p{1.2cm}|p{.8cm}|p{1.2cm}|p{.8cm}|
.. flat-table:: Sample 4x2 Metadata Frame
:header-rows: 0
:stub-columns: 0
:widths: 12 8 8 8 8 8 8 8 8
* - start + 0:
- M\ :sub:`00`
- x
- M\ :sub:`10`
- x
- M\ :sub:`20`
- x
- M\ :sub:`30`
- x
* - start + 8:
- M\ :sub:`01`
- x
- M\ :sub:`11`
- x
- M\ :sub:`21`
- x
- M\ :sub:`31`
- x
.. _v4l2-meta-fmt-generic-csi2-20:
CSI2_20: metadata 뒤 padding 1·2바이트 교대
234-286`V4L2_META_FMT_GENERIC_CSI2_20`은 20비트 Data Unit에 8비트 metadata를 넣고 각 metadata byte 뒤에 padding 한 바이트와 두 바이트를 번갈아 둡니다. `MEDIA_BUS_FMT_META_20` 수신 데이터의 little-endian MIPI CSI-2/CCS 배치입니다.
원문은 일부 장치가 16비트 영상 데이터와 함께 더 효율적으로 metadata를 packing할 수 있다고 설명하며, 이 경우 `V4L2_META_FMT_GENERIC_CSI2_10`을 사용하도록 지정합니다.
4×2 예제 행메모리의 바이트 순서
첫째 행start+0: M00, x, M10, x, x, M20, x, M30, x, x
둘째 행start+10: M01, x, M11, x, x, M21, x, M31, x, x
`Mxy`는 x번째 열, y번째 행의 metadata byte이고 `x`는 padding byte입니다.
V4L2_META_FMT_GENERIC_CSI2_20
-----------------------------
V4L2_META_FMT_GENERIC_CSI2_20 contains 8-bit generic metadata packed in 20-bit
Data Units, with alternating one or two padding bytes after every byte of
metadata. This format is typically used by CSI-2 receivers with a source that
transmits MEDIA_BUS_FMT_META_20 and the CSI-2 receiver writes the received data
to memory as-is.
The packing of the data follows the MIPI CSI-2 specification and the padding of
the data is defined in the MIPI CCS specification.
Some devices support more efficient packing of metadata in conjunction with
16-bit image data. In that case the dataformat is
:ref:`V4L2_META_FMT_GENERIC_CSI2_10 <v4l2-meta-fmt-generic-csi2-10>`.
This format is little endian.
**Byte Order Of V4L2_META_FMT_GENERIC_CSI2_20.**
Each cell is one byte. "M" denotes a byte of metadata and "x" a byte of padding.
.. tabularcolumns:: |p{2.4cm}|p{1.2cm}|p{1.2cm}|p{1.2cm}|p{1.2cm}|p{1.8cm}|p{1.2cm}|p{1.2cm}|p{1.2cm}|p{1.2cm}|p{1.8cm}
.. flat-table:: Sample 4x2 Metadata Frame
:header-rows: 0
:stub-columns: 0
:widths: 12 8 8 8 8 8 8 8 8 8 8
* - start + 0:
- M\ :sub:`00`
- x
- M\ :sub:`10`
- x
- x
- M\ :sub:`20`
- x
- M\ :sub:`30`
- x
- x
* - start + 10:
- M\ :sub:`01`
- x
- M\ :sub:`11`
- x
- x
- M\ :sub:`21`
- x
- M\ :sub:`31`
- x
- x
.. _v4l2-meta-fmt-generic-csi2-24:
CSI2_24: metadata 1바이트마다 padding 2바이트
287-340`V4L2_META_FMT_GENERIC_CSI2_24`는 24비트 Data Unit마다 8비트 metadata 한 바이트와 padding 두 바이트를 둡니다. `MEDIA_BUS_FMT_META_24` source의 데이터를 그대로 기록하며 little endian, MIPI CSI-2 packing, MIPI CCS padding 규칙을 따릅니다.
일부 장치가 16비트 영상 데이터와 함께 metadata를 더 조밀하게 packing할 때는 `V4L2_META_FMT_GENERIC_CSI2_12`를 사용합니다.
4×2 예제 행메모리의 바이트 순서
첫째 행start+0: M00, x, x, M10, x, x, M20, x, x, M30, x, x
둘째 행start+12: M01, x, x, M11, x, x, M21, x, x, M31, x, x
`Mxy`는 x번째 열, y번째 행의 metadata byte이고 `x`는 padding byte입니다.
V4L2_META_FMT_GENERIC_CSI2_24
-----------------------------
V4L2_META_FMT_GENERIC_CSI2_24 contains 8-bit generic metadata packed in 24-bit
Data Units, with two padding bytes after every byte of metadata. This format is
typically used by CSI-2 receivers with a source that transmits
MEDIA_BUS_FMT_META_24 and the CSI-2 receiver writes the received data to memory
as-is.
The packing of the data follows the MIPI CSI-2 specification and the padding of
the data is defined in the MIPI CCS specification.
Some devices support more efficient packing of metadata in conjunction with
16-bit image data. In that case the dataformat is
:ref:`V4L2_META_FMT_GENERIC_CSI2_12 <v4l2-meta-fmt-generic-csi2-12>`.
This format is little endian.
**Byte Order Of V4L2_META_FMT_GENERIC_CSI2_24.**
Each cell is one byte. "M" denotes a byte of metadata and "x" a byte of padding.
.. tabularcolumns:: |p{2.4cm}|p{1.2cm}|p{.8cm}|p{.8cm}|p{1.2cm}|p{.8cm}|p{.8cm}|p{1.2cm}|p{.8cm}|p{.8cm}|p{1.2cm}|p{.8cm}|p{.8cm}|
.. flat-table:: Sample 4x2 Metadata Frame
:header-rows: 0
:stub-columns: 0
:widths: 12 8 8 8 8 8 8 8 8 8 8 8 8
* - start + 0:
- M\ :sub:`00`
- x
- x
- M\ :sub:`10`
- x
- x
- M\ :sub:`20`
- x
- x
- M\ :sub:`30`
- x
- x
* - start + 12:
- M\ :sub:`01`
- x
- x
- M\ :sub:`11`
- x
- x
- M\ :sub:`21`
- x
- x
- M\ :sub:`31`
- x
- x
요약·해설
metafmt-generic.rst:범용 형식은 metadata의 의미가 아니라 Data Unit 폭에 따른 metadata와 padding의 메모리 배치만 규정합니다.1-340