Documentation/userspace-api/media/drivers/thp7312.rst GitHub 원문 ↗

Linux 6.18.37 · Userspace API / Media / Drivers

THine THP7312 ISP driver

THP7312의 저조도 보정, 자동초점 방식, 노이즈 감소 컨트롤을 설명합니다.

Source pathDocumentation/userspace-api/media/drivers/thp7312.rst
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.

1. 요약·해설

원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.

요약·해설

thp7312.rst:1-39

THP7312 전용 컨트롤은 저조도에서 프레임 레이트를 조정하고, 카메라 모듈 기능에 맞춰 contrast-based·PDAF·hybrid 자동초점 값을 제공하며, 자동 또는 0~10 강도의 노이즈 감소를 설정합니다.

2. 영어 원문 전체

번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.

원문 전체 펼치기
1 .. SPDX-License-Identifier: GPL-2.0-only
2
3 THine THP7312 ISP driver
4 ========================
5
6 The THP7312 driver implements the following driver-specific controls:
7
8 ``V4L2_CID_THP7312_LOW_LIGHT_COMPENSATION``
9 Enable/Disable auto-adjustment, based on lighting conditions, of the frame
10 rate when auto-exposure is enabled.
11
12 ``V4L2_CID_THP7312_AUTO_FOCUS_METHOD``
13 Set method of auto-focus. Only takes effect when auto-focus is enabled.
14
15 .. flat-table::
16 :header-rows: 0
17 :stub-columns: 0
18 :widths: 1 4
19
20 * - ``0``
21 - Contrast-based auto-focus
22 * - ``1``
23 - PDAF
24 * - ``2``
25 - Hybrid of contrast-based and PDAF
26
27 Supported values for the control depend on the camera sensor module
28 connected to the THP7312. If the module doesn't have a focus lens actuator,
29 this control will not be exposed by the THP7312 driver. If the module has a
30 controllable focus lens but the sensor doesn't support PDAF, only the
31 contrast-based auto-focus value will be valid. Otherwise all values for the
32 controls will be supported.
33
34 ``V4L2_CID_THP7312_NOISE_REDUCTION_AUTO``
35 Enable/Disable auto noise reduction.
36
37 ``V4L2_CID_THP7312_NOISE_REDUCTION_ABSOLUTE``
38 Set the noise reduction strength, where 0 is the weakest and 10 is the
39 strongest.
40

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.

저조도 보정

1-10

이 문서는 GPL-2.0-only 라이선스를 따르며 THine THP7312 ISP 드라이버 전용 컨트롤을 설명합니다.

`V4L2_CID_THP7312_LOW_LIGHT_COMPENSATION`은 자동 노출이 활성화되었을 때 조명 조건에 따라 프레임 레이트를 자동 조정하는 기능을 활성화하거나 비활성화합니다.

.. SPDX-License-Identifier: GPL-2.0-only

THine THP7312 ISP driver
========================

The THP7312 driver implements the following driver-specific controls:

``V4L2_CID_THP7312_LOW_LIGHT_COMPENSATION``
    Enable/Disable auto-adjustment, based on lighting conditions, of the frame
    rate when auto-exposure is enabled.

자동초점 방식

11-32

`V4L2_CID_THP7312_AUTO_FOCUS_METHOD`는 자동초점 방식을 설정하며 자동초점이 활성화된 경우에만 설정이 적용됩니다.

THP7312 자동초점 방식
값자동초점 방식
0Contrast-based auto-focus
1PDAF
2Contrast-based와 PDAF의 hybrid

원문의 flat-table 값을 구조화해 보존합니다.

지원되는 컨트롤 값은 THP7312에 연결된 카메라 센서 모듈에 따라 달라집니다. 모듈에 초점 렌즈 액추에이터가 없으면 THP7312 드라이버는 이 컨트롤을 제공하지 않습니다.

모듈에 제어 가능한 초점 렌즈가 있지만 센서가 PDAF를 지원하지 않으면 contrast-based auto-focus 값만 유효합니다. 그 밖의 경우에는 컨트롤의 모든 값이 지원됩니다.

자동초점 컨트롤 제공 여부 판단
초점 렌즈 액추에이터 유무 확인없으면 AUTO_FOCUS_METHOD 컨트롤 미제공있으면 센서의 PDAF 지원 확인PDAF 미지원이면 값 0만 허용PDAF 지원이면 값 0, 1, 2 모두 허용

렌즈 액추에이터와 PDAF 지원 여부가 사용 가능한 값을 결정합니다.


``V4L2_CID_THP7312_AUTO_FOCUS_METHOD``
    Set method of auto-focus. Only takes effect when auto-focus is enabled.

    .. flat-table::
        :header-rows:  0
        :stub-columns: 0
        :widths:       1 4

        * - ``0``
          - Contrast-based auto-focus
        * - ``1``
          - PDAF
        * - ``2``
          - Hybrid of contrast-based and PDAF

    Supported values for the control depend on the camera sensor module
    connected to the THP7312. If the module doesn't have a focus lens actuator,
    this control will not be exposed by the THP7312 driver. If the module has a
    controllable focus lens but the sensor doesn't support PDAF, only the
    contrast-based auto-focus value will be valid. Otherwise all values for the
    controls will be supported.

노이즈 감소

33-39

`V4L2_CID_THP7312_NOISE_REDUCTION_AUTO`는 자동 노이즈 감소를 활성화하거나 비활성화합니다.

`V4L2_CID_THP7312_NOISE_REDUCTION_ABSOLUTE`는 노이즈 감소 강도를 설정합니다. 0이 가장 약하고 10이 가장 강합니다.

THP7312 노이즈 감소 컨트롤
항목설명
V4L2_CID_THP7312_NOISE_REDUCTION_AUTO자동 노이즈 감소 활성화 또는 비활성화
V4L2_CID_THP7312_NOISE_REDUCTION_ABSOLUTE0(가장 약함)부터 10(가장 강함)까지의 강도

자동 모드와 절대 강도 설정을 구분합니다.


``V4L2_CID_THP7312_NOISE_REDUCTION_AUTO``
    Enable/Disable auto noise reduction.

``V4L2_CID_THP7312_NOISE_REDUCTION_ABSOLUTE``
    Set the noise reduction strength, where 0 is the weakest and 10 is the
    strongest.