요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.
1. 요약·해설
원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.
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 <[email protected]>
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. 한국어 전문 번역
영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, 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 구성을 먼저 해설하고, 접을 수 있는 영어 원문 전체와 원문 줄 좌표를 보존한 한국어 전문 번역을 제공합니다.