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

Linux 6.18.37 · Devicetree Bindings / Sound

Everest ES8328 audio codec

ES8328/ES8388 호환, clock, audio route와 네 전원 rail을 설명합니다.

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

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

1. 요약·해설

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

요약과 해설

everest,es8328.yaml:1-86

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,es8328.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: Everest ES8328 audio CODEC
8
9 description:
10 Everest Audio Codec, which can be connected via I2C or SPI.
11 Pins on the device (for linking into audio routes) are
12 * LOUT1
13 * LOUT2
14 * ROUT1
15 * ROUT2
16 * LINPUT1
17 * RINPUT1
18 * LINPUT2
19 * RINPUT2
20 * Mic Bias
21
22 maintainers:
23 - David Yang <[email protected]>
24
25 properties:
26 compatible:
27 oneOf:
28 - enum:
29 - everest,es8328
30 - items:
31 - enum:
32 - everest,es8388
33 - const: everest,es8328
34
35 reg:
36 maxItems: 1
37
38 "#sound-dai-cells":
39 const: 0
40
41 clocks:
42 items:
43 - description: A 22.5792 or 11.2896 MHz clock
44
45 DVDD-supply:
46 description: Regulator providing digital core supply voltage 1.8 - 3.6V
47
48 AVDD-supply:
49 description: Regulator providing analog supply voltage 3.3V
50
51 PVDD-supply:
52 description: Regulator providing digital IO supply voltage 1.8 - 3.6V
53
54 HPVDD-supply:
55 description: Regulator providing analog output voltage 3.3V
56
57 port:
58 $ref: audio-graph-port.yaml#
59 unevaluatedProperties: false
60
61 required:
62 - compatible
63 - reg
64 - clocks
65 - DVDD-supply
66 - AVDD-supply
67 - PVDD-supply
68 - HPVDD-supply
69
70 additionalProperties: false
71
72 examples:
73 - |
74 i2c {
75 #address-cells = <1>;
76 #size-cells = <0>;
77 es8328: codec@11 {
78 compatible = "everest,es8328";
79 reg = <0x11>;
80 AVDD-supply = <&reg_3p3v>;
81 DVDD-supply = <&reg_3p3v>;
82 HPVDD-supply = <&reg_3p3v>;
83 PVDD-supply = <&reg_3p3v>;
84 clocks = <&clks 169>;
85 };
86 };
87

3. 한국어 전문 번역

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

ES8328 codec과 route pin

1-24

이 YAML binding은 I2C 또는 SPI로 연결할 수 있는 Everest ES8328 audio codec을 정의합니다. Schema ID는 `http://devicetree.org/schemas/sound/everest,es8328.yaml#`이고 maintainer는 David Yang입니다.

Audio route pin은 output `LOUT1`, `LOUT2`, `ROUT1`, `ROUT2`, input `LINPUT1`, `RINPUT1`, `LINPUT2`, `RINPUT2`, 그리고 `Mic Bias`입니다.

Compatible, 주소와 clock

25-44

`compatible`은 단일 `everest,es8328`이거나, `everest,es8388` 뒤에 fallback `everest,es8328`을 둔 두 항목입니다. `reg`는 최대 한 항목이고 `#sound-dai-cells`는 0입니다.

`clocks`는 22.5792 MHz 또는 11.2896 MHz clock 한 항목입니다.

전원 rail과 graph port

45-60

`DVDD-supply`는 1.8~3.6V digital core, `AVDD-supply`는 3.3V analog, `PVDD-supply`는 1.8~3.6V digital I/O, `HPVDD-supply`는 3.3V analog output regulator를 참조합니다.

`port`는 `audio-graph-port.yaml#`을 참조하며 참조 schema에서 평가되지 않은 속성을 허용하지 않습니다.

필수 clock과 전원

61-71

필수 속성은 `compatible`, `reg`, `clocks`와 네 전원 `DVDD-supply`, `AVDD-supply`, `PVDD-supply`, `HPVDD-supply`입니다. 추가 속성은 허용하지 않습니다.

ES8328 I2C와 3.3V 전원 예제

72-86

예제는 I2C address `0x11`의 ES8328에 네 supply 모두 `reg_3p3v`를 연결하고 clock 169를 제공합니다.

i2c {
  #address-cells = <1>;
  #size-cells = <0>;
  es8328: codec@11 {
    compatible = "everest,es8328";
    reg = <0x11>;
    AVDD-supply = <&reg_3p3v>;
    DVDD-supply = <&reg_3p3v>;
    HPVDD-supply = <&reg_3p3v>;
    PVDD-supply = <&reg_3p3v>;
    clocks = <&clks 169>;
  };
};