← Documents Documentation/userspace-api/media/v4l/metafmt-pisp-be.rst GitHub 원문 ↗

Linux 6.18.37 · Userspace API / Media / V4L

Raspberry Pi PiSP Back End 구성 형식

PiSP Back End의 프레임 공통 구성과 160바이트 tile 매개변수를 설명합니다.

Source pathDocumentation/userspace-api/media/v4l/metafmt-pisp-be.rst
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

요약·해설

metafmt-pisp-be.rst:PiSP Back End 구성은 모든 tile에 공유하는 global 값과 tile마다 하나씩 필요한 160바이트 매개변수 집합으로 나뉩니다.

1-56

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 .. SPDX-License-Identifier: GPL-2.0
2
3 .. _v4l2-meta-fmt-rpi-be-cfg:
4
5 ************************
6 V4L2_META_FMT_RPI_BE_CFG
7 ************************
8
9 Raspberry Pi PiSP Back End configuration format
10 ===============================================
11
12 The Raspberry Pi PiSP Back End memory-to-memory image signal processor is
13 configured by userspace by providing a buffer of configuration parameters
14 to the `pispbe-config` output video device node using the
15 :c:type:`v4l2_meta_format` interface.
16
17 The PiSP Back End processes images in tiles, and its configuration requires
18 specifying two different sets of parameters by populating the members of
19 :c:type:`pisp_be_tiles_config` defined in the ``pisp_be_config.h`` header file.
20
21 The `Raspberry Pi PiSP technical specification
22 <https://datasheets.raspberrypi.com/camera/raspberry-pi-image-signal-processor-specification.pdf>`_
23 provide detailed description of the ISP back end configuration and programming
24 model.
25
26 Global configuration data
27 -------------------------
28
29 The global configuration data describe how the pixels in a particular image are
30 to be processed and is therefore shared across all the tiles of the image. So
31 for example, LSC (Lens Shading Correction) or Denoise parameters would be common
32 across all tiles from the same frame.
33
34 Global configuration data are passed to the ISP by populating the member of
35 :c:type:`pisp_be_config`.
36
37 Tile parameters
38 ---------------
39
40 As the ISP processes images in tiles, each set of tiles parameters describe how
41 a single tile in an image is going to be processed. A single set of tile
42 parameters consist of 160 bytes of data and to process a batch of tiles several
43 sets of tiles parameters are required.
44
45 Tiles parameters are passed to the ISP by populating the member of
46 ``pisp_tile`` and the ``num_tiles`` fields of :c:type:`pisp_be_tiles_config`.
47
48 Raspberry Pi PiSP Back End uAPI data types
49 ==========================================
50
51 This section describes the data types exposed to userspace by the Raspberry Pi
52 PiSP Back End. The section is informative only, for a detailed description of
53 each field refer to the `Raspberry Pi PiSP technical specification
54 <https://datasheets.raspberrypi.com/camera/raspberry-pi-image-signal-processor-specification.pdf>`_.
55
56 .. kernel-doc:: include/uapi/linux/media/raspberrypi/pisp_be_config.h
57

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

메모리 대 메모리 ISP 구성

1-25

Raspberry Pi PiSP Back End는 memory-to-memory image signal processor입니다. 사용자 공간은 `v4l2_meta_format`을 이용해 `pispbe-config` 출력 비디오 노드에 구성 매개변수 버퍼를 제공해 ISP를 설정합니다.

Back End는 영상을 tile 단위로 처리하므로 `pisp_be_config.h`의 `pisp_be_tiles_config` 멤버를 채워 global configuration과 tile parameter 두 집합을 모두 지정해야 합니다. 상세 프로그래밍 모델은 Raspberry Pi PiSP 기술 명세가 정의합니다.

.. SPDX-License-Identifier: GPL-2.0

.. _v4l2-meta-fmt-rpi-be-cfg:

************************
V4L2_META_FMT_RPI_BE_CFG
************************

Raspberry Pi PiSP Back End configuration format
===============================================

The Raspberry Pi PiSP Back End memory-to-memory image signal processor is
configured by userspace by providing a buffer of configuration parameters
to the `pispbe-config` output video device node using the
:c:type:`v4l2_meta_format` interface.

The PiSP Back End processes images in tiles, and its configuration requires
specifying two different sets of parameters by populating the members of
:c:type:`pisp_be_tiles_config` defined in the ``pisp_be_config.h`` header file.

The `Raspberry Pi PiSP technical specification
<https://datasheets.raspberrypi.com/camera/raspberry-pi-image-signal-processor-specification.pdf>`_
provide detailed description of the ISP back end configuration and programming
model.

프레임 전체에 공유되는 global configuration

26-36

Global configuration은 특정 영상의 픽셀 처리 방식을 설명하며 모든 tile에 공유됩니다. 같은 프레임의 LSC(Lens Shading Correction)나 denoise 매개변수가 대표적입니다. `pisp_be_config` 멤버를 채워 ISP에 전달합니다.

Global configuration data
-------------------------

The global configuration data describe how the pixels in a particular image are
to be processed and is therefore shared across all the tiles of the image. So
for example, LSC (Lens Shading Correction) or Denoise parameters would be common
across all tiles from the same frame.

Global configuration data are passed to the ISP by populating the member of
:c:type:`pisp_be_config`.

tile별 160바이트 매개변수

37-47

각 tile parameter 집합은 영상의 tile 하나를 어떻게 처리할지 설명하는 160바이트 데이터입니다. 여러 tile을 한 batch로 처리하려면 집합도 여러 개 필요합니다. `pisp_be_tiles_config`의 `pisp_tile`과 `num_tiles`를 채워 전달합니다.

PiSP Back End 구성
프레임 전체의 LSC·denoise 등 global 값 작성처리할 tile 수 계산각 tile마다 160바이트 parameter 작성`pisp_tile` 배열과 `num_tiles` 설정`pispbe-config` 출력 노드로 버퍼 큐잉

프레임 공통값과 tile별 값을 결합합니다.

Tile parameters
---------------

As the ISP processes images in tiles, each set of tiles parameters describe how
a single tile in an image is going to be processed. A single set of tile
parameters consist of 160 bytes of data and to process a batch of tiles several
sets of tiles parameters are required.

Tiles parameters are passed to the ISP by populating the member of
``pisp_tile`` and the ``num_tiles`` fields of :c:type:`pisp_be_tiles_config`.

PiSP Back End uAPI 자료형

48-56

이 절의 kernel-doc은 사용자 공간에 노출되는 자료형을 안내하지만 각 필드의 규범적이고 상세한 설명은 PiSP 기술 명세를 참조해야 합니다. uAPI 선언은 `include/uapi/linux/media/raspberrypi/pisp_be_config.h`에 있습니다.

Raspberry Pi PiSP Back End uAPI data types
==========================================

This section describes the data types exposed to userspace by the Raspberry Pi
PiSP Back End. The section is informative only, for a detailed description of
each field refer to the `Raspberry Pi PiSP technical specification
<https://datasheets.raspberrypi.com/camera/raspberry-pi-image-signal-processor-specification.pdf>`_.

.. kernel-doc:: include/uapi/linux/media/raspberrypi/pisp_be_config.h