요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
V4L2 topology와 구현
c3-isp.rst:48-101Sub-device, video node, meta format, libcamera 연동을 정리합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
.. SPDX-License-Identifier: (GPL-2.0-only OR MIT)
.. include:: <isonum.txt>
=================================================
Amlogic C3 Image Signal Processing (C3ISP) driver
=================================================
Introduction
============
This file documents the Amlogic C3ISP driver located under
drivers/media/platform/amlogic/c3/isp.
The current version of the driver supports the C3ISP found on
Amlogic C308L processor.
The driver implements V4L2, Media controller and V4L2 subdev interfaces.
Camera sensor using V4L2 subdev interface in the kernel is supported.
The driver has been tested on AW419-C308L-Socket platform.
Amlogic C3 ISP
==============
The Camera hardware found on C308L processors and supported by
the driver consists of:
- 1 MIPI-CSI-2 module: handles the physical layer of the MIPI CSI-2 receiver and
receives data from the connected camera sensor.
- 1 MIPI-ADAPTER module: organizes MIPI data to meet ISP input requirements and
send MIPI data to ISP.
- 1 ISP (Image Signal Processing) module: contains a pipeline of image processing
hardware blocks. The ISP pipeline contains three resizers at the end each of
them connected to a DMA interface which writes the output data to memory.
A high-level functional view of the C3 ISP is presented below.::
+----------+ +-------+
| Resizer |--->| WRMIF |
+---------+ +------------+ +--------------+ +-------+ |----------+ +-------+
| Sensor |--->| MIPI CSI-2 |--->| MIPI ADAPTER |--->| ISP |---|----------+ +-------+
+---------+ +------------+ +--------------+ +-------+ | Resizer |--->| WRMIF |
+----------+ +-------+
|----------+ +-------+
| Resizer |--->| WRMIF |
+----------+ +-------+
Driver architecture and design
==============================
With the goal to model the hardware links between the modules and to expose a
clean, logical and usable interface, the driver registers the following V4L2
sub-devices:
- 1 `c3-mipi-csi2` sub-device - the MIPI CSI-2 receiver
- 1 `c3-mipi-adapter` sub-device - the MIPI adapter
- 1 `c3-isp-core` sub-device - the ISP core
- 3 `c3-isp-resizer` sub-devices - the ISP resizers
The `c3-isp-core` sub-device is linked to 2 video device nodes for statistics
capture and parameters programming:
- the `c3-isp-stats` capture video device node for statistics capture
- the `c3-isp-params` output video device for parameters programming
Each `c3-isp-resizer` sub-device is linked to a capture video device node where
frames are captured from:
- `c3-isp-resizer0` is linked to the `c3-isp-cap0` capture video device
- `c3-isp-resizer1` is linked to the `c3-isp-cap1` capture video device
- `c3-isp-resizer2` is linked to the `c3-isp-cap2` capture video device
The media controller pipeline graph is as follows (with connected a
IMX290 camera sensor):
.. _isp_topology_graph:
.. kernel-figure:: c3-isp.dot
:alt: c3-isp.dot
:align: center
Media pipeline topology
Implementation
==============
Runtime configuration of the ISP hardware is performed on the `c3-isp-params`
video device node using the :ref:`V4L2_META_FMT_C3ISP_PARAMS
<v4l2-meta-fmt-c3isp-params>` as data format. The buffer structure is defined by
:c:type:`c3_isp_params_cfg`.
Statistics are captured from the `c3-isp-stats` video device node using the
:ref:`V4L2_META_FMT_C3ISP_STATS <v4l2-meta-fmt-c3isp-stats>` data format.
The final picture size and format is configured using the V4L2 video
capture interface on the `c3-isp-cap[0, 2]` video device nodes.
The Amlogic C3 ISP is supported by `libcamera <https://libcamera.org>`_ with a
dedicated pipeline handler and algorithms that perform run-time image correction
and enhancement.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Amlogic C3ISP driver 소개
1-21이 문서는 `drivers/media/platform/amlogic/c3/isp`에 있는 Amlogic C3 Image Signal Processing(C3ISP) driver를 설명합니다.
현재 driver는 Amlogic C308L processor의 C3ISP를 지원하며 V4L2, Media controller, V4L2 subdev interface를 구현합니다. Kernel에서 V4L2 subdev interface를 사용하는 camera sensor도 지원합니다.
Driver는 AW419-C308L-Socket platform에서 시험되었습니다.
C308L camera hardware pipeline
22-47Driver가 지원하는 C308L camera hardware는 다음 module로 구성됩니다.
| 수량 | Module | 역할 |
|---|---|---|
| 1 | `MIPI-CSI-2` | MIPI CSI-2 receiver의 physical layer를 처리하고 연결된 camera sensor에서 data를 받습니다. |
| 1 | `MIPI-ADAPTER` | MIPI data를 ISP input 요구 사항에 맞게 정리해 ISP로 보냅니다. |
| 1 | `ISP` | Image-processing hardware block의 pipeline입니다. 끝에는 각각 DMA write interface인 WRMIF에 연결된 resizer 세 개가 있습니다. |
Sensor data는 CSI-2 receiver와 adapter, ISP를 지난 뒤 세 resizer branch에서 각각 WRMIF를 통해 memory에 기록됩니다.
Driver architecture와 media topology
48-84Hardware module 사이 link를 model로 만들고 깔끔하고 논리적이며 사용 가능한 interface를 노출하기 위해 driver는 다음 V4L2 sub-device를 등록합니다.
| 개수 | Sub-device | 기능 |
|---|---|---|
| 1 | `c3-mipi-csi2` | MIPI CSI-2 receiver |
| 1 | `c3-mipi-adapter` | MIPI adapter |
| 1 | `c3-isp-core` | ISP core |
| 3 | `c3-isp-resizer` | ISP resizer |
`c3-isp-core` sub-device는 statistics capture용 `c3-isp-stats` capture video device node와 parameter programming용 `c3-isp-params` output video device node에 연결됩니다.
| Resizer sub-device | Capture video device |
|---|---|
| `c3-isp-resizer0` | `c3-isp-cap0` |
| `c3-isp-resizer1` | `c3-isp-cap1` |
| `c3-isp-resizer2` | `c3-isp-cap2` |
IMX290 camera sensor를 연결한 media controller pipeline graph는 원문의 anchor `isp_topology_graph`와 `c3-isp.dot` kernel figure로 제공되며 caption은 `Media pipeline topology`입니다.
Sensor에서 ISP core로 들어온 data가 capture branch 세 개와 statistics·parameter node로 연결되는 논리 topology입니다.
Runtime 설정과 image capture
85-101ISP hardware의 runtime 설정은 `c3-isp-params` video device node에서 `V4L2_META_FMT_C3ISP_PARAMS` data format을 사용해 수행합니다. Buffer 구조는 `c3_isp_params_cfg`로 정의됩니다.
Statistics는 `c3-isp-stats` video device node에서 `V4L2_META_FMT_C3ISP_STATS` data format으로 capture합니다.
최종 picture size와 format은 `c3-isp-cap[0, 2]` video device node의 V4L2 video capture interface로 설정합니다.
Amlogic C3 ISP는 runtime image correction과 enhancement를 수행하는 전용 pipeline handler 및 algorithm과 함께 `libcamera`에서 지원됩니다.
Hardware pipeline
c3-isp.rst:1-47MIPI CSI-2에서 ISP와 3개 resizer·WRMIF로 이어지는 data path를 보여 줍니다.