요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
# SPDX-License-Identifier: GPL-2.0
%YAML 1.2
---
$id: http://devicetree.org/schemas/sound/dmic-codec.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#
title: Generic PDM Digital microphone (DMIC) codec
maintainers:
- Arnaud Pouliquen <arnaud.pouliquen@foss.st.com>
allOf:
- $ref: dai-common.yaml#
properties:
compatible:
const: dmic-codec
'#sound-dai-cells':
const: 0
vref-supply:
description: Phandle to the digital microphone reference supply
dmicen-gpios:
description: GPIO specifier for DMIC to control start and stop
maxItems: 1
num-channels:
description: Number of microphones on this DAI
$ref: /schemas/types.yaml#/definitions/uint32
minimum: 1
maximum: 8
default: 8
modeswitch-delay-ms:
description: Delay (in ms) to complete DMIC mode switch
wakeup-delay-ms:
description: Delay (in ms) after enabling the DMIC
required:
- compatible
unevaluatedProperties: false
examples:
- |
#include <dt-bindings/gpio/gpio.h>
dmic {
compatible = "dmic-codec";
dmicen-gpios = <&gpio4 3 GPIO_ACTIVE_HIGH>;
num-channels = <1>;
wakeup-delay-ms = <50>;
modeswitch-delay-ms = <35>;
};
...
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Generic PDM DMIC codec schema
1-14이 GPL-2.0 YAML binding은 generic PDM digital microphone(DMIC) codec을 정의합니다. Schema ID는 `http://devicetree.org/schemas/sound/dmic-codec.yaml#`, maintainer는 Arnaud Pouliquen이며 `dai-common.yaml#`의 공통 속성을 상속합니다.
Compatible, DAI cell과 제어 GPIO
15-28`compatible`은 `dmic-codec`, `#sound-dai-cells`는 0입니다. `vref-supply`는 digital microphone reference supply의 phandle입니다.
`dmicen-gpios`는 DMIC start와 stop을 제어하는 GPIO specifier이며 최대 한 항목입니다.
Microphone 수와 전환 지연
29-41`num-channels`는 이 DAI에 연결된 microphone 수를 나타내는 `uint32`입니다. 범위는 1~8이고 기본값은 8입니다.
`modeswitch-delay-ms`는 DMIC mode switch가 완료될 때까지의 지연(ms), `wakeup-delay-ms`는 DMIC을 enable한 뒤의 지연(ms)입니다.
필수 속성과 추가 속성
42-46필수 속성은 `compatible`입니다. `unevaluatedProperties: false`이므로 이 schema와 공통 DAI schema에서 정의하지 않은 속성은 허용하지 않습니다.
GPIO 제어 DMIC 예제
47-58예제는 GPIO4의 pin 3을 active-high enable 신호로 사용하고 microphone 한 개를 설정합니다. Wakeup delay는 50 ms, mode-switch delay는 35 ms입니다.
#include <dt-bindings/gpio/gpio.h>
dmic {
compatible = "dmic-codec";
dmicen-gpios = <&gpio4 3 GPIO_ACTIVE_HIGH>;
num-channels = <1>;
wakeup-delay-ms = <50>;
modeswitch-delay-ms = <35>;
};
...
요약과 해설
dmic-codec.yaml:1-58Dialog, generic DMIC, Eukrea와 Everest audio binding의 schema 구조, 필수 속성과 DTS 구성을 먼저 해설하고, 접을 수 있는 영어 원문 전체와 원문 줄 좌표를 보존한 한국어 전문 번역을 제공합니다.