← Documents 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 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

요약과 해설

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 <yangxiaohua@everest-semi.com>
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. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 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>;
  };
};