Documentation/devicetree/bindings/sound/everest,es8316.yaml GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings / Sound

Everest ES8311/ES8316/ES8323 codecs

ES8311/16/23의 route pin, MCLK와 audio graph binding을 설명합니다.

Source pathDocumentation/devicetree/bindings/sound/everest,es8316.yaml
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

요약과 해설

everest,es8316.yaml:1-78

Everest audio codec의 route pin, clock, 전원과 jack interrupt 조건을 먼저 해설하고, 접을 수 있는 영어 원문 전체와 원문 줄 좌표를 보존한 한국어 전문 번역을 제공합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2 %YAML 1.2
3 ---
4 $id: http://devicetree.org/schemas/sound/everest,es8316.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: Everest ES8311, ES8316 and ES8323 audio CODECs
8
9 maintainers:
10 - Daniel Drake <[email protected]>
11 - Katsuhiro Suzuki <[email protected]>
12 - Matteo Martelli <[email protected]>
13 - Binbin Zhou <[email protected]>
14
15 description: |
16 Everest ES8311, ES8316 and ES8323 audio CODECs
17
18 Pins on the device (for linking into audio routes):
19
20 Outputs:
21 * LOUT: Left Analog Output
22 * ROUT: Right Analog Output
23 * MICBIAS: Microphone Bias
24
25 Inputs:
26 * MIC1P: Microphone 1 Positive Analog Input
27 * MIC1N: Microphone 1 Negative Analog Input
28 * MIC2P: Microphone 2 Positive Analog Input
29 * MIC2N: Microphone 2 Negative Analog Input
30
31 allOf:
32 - $ref: dai-common.yaml#
33
34 properties:
35 compatible:
36 enum:
37 - everest,es8311
38 - everest,es8316
39 - everest,es8323
40
41 reg:
42 maxItems: 1
43
44 clocks:
45 items:
46 - description: clock for master clock (MCLK)
47
48 clock-names:
49 items:
50 - const: mclk
51
52 port:
53 $ref: audio-graph-port.yaml#
54 unevaluatedProperties: false
55
56 "#sound-dai-cells":
57 const: 0
58
59 required:
60 - compatible
61 - reg
62 - "#sound-dai-cells"
63
64 unevaluatedProperties: false
65
66 examples:
67 - |
68 i2c {
69 #address-cells = <1>;
70 #size-cells = <0>;
71 es8316: codec@11 {
72 compatible = "everest,es8316";
73 reg = <0x11>;
74 clocks = <&clks 10>;
75 clock-names = "mclk";
76 #sound-dai-cells = <0>;
77 };
78 };
79

3. 한국어 전문 번역

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

ES8311/ES8316/ES8323 schema

1-14

이 YAML binding은 Everest ES8311, ES8316, ES8323 audio codec을 정의하며 GPL-2.0-only 또는 BSD-2-Clause로 배포됩니다. Schema ID는 `http://devicetree.org/schemas/sound/everest,es8316.yaml#`이고 네 maintainer가 기재되어 있습니다.

Audio route pin

15-30

Audio route에 연결할 output pin은 left analog output `LOUT`, right analog output `ROUT`, microphone bias `MICBIAS`입니다.

Input pin은 microphone 1의 positive/negative analog input `MIC1P`, `MIC1N`과 microphone 2의 `MIC2P`, `MIC2N`입니다.

Compatible, MCLK와 graph port

31-58

`dai-common.yaml#`을 상속하며 `compatible`은 `everest,es8311`, `everest,es8316`, `everest,es8323` 중 하나입니다. `reg`는 최대 한 항목입니다.

`clocks`는 master clock(MCLK) 한 항목이고 `clock-names`는 `mclk`입니다. `port`는 `audio-graph-port.yaml#`을 참조하며 정의되지 않은 속성을 허용하지 않습니다. `#sound-dai-cells`는 0입니다.

필수 속성과 확장 제한

59-65

필수 속성은 `compatible`, `reg`, `#sound-dai-cells`입니다. `unevaluatedProperties: false`이므로 이 schema와 참조 schema에서 평가하지 않은 속성은 허용하지 않습니다.

ES8316 I2C 예제

66-78

예제는 I2C address `0x11`의 ES8316에 clock 10을 `mclk`로 연결하고 DAI cell 수를 0으로 설정합니다.

i2c {
  #address-cells = <1>;
  #size-cells = <0>;
  es8316: codec@11 {
    compatible = "everest,es8316";
    reg = <0x11>;
    clocks = <&clks 10>;
    clock-names = "mclk";
    #sound-dai-cells = <0>;
  };
};