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

Linux 6.18.37 · Devicetree Bindings / Sound

Everest ES8375 audio codec

ES8375의 analogue·interface 전원과 MCLK/SCLK source 선택을 설명합니다.

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

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

1. 요약·해설

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

요약과 해설

everest,es8375.yaml:1-71

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,es8375.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: Everest ES8375 audio CODEC
8
9 maintainers:
10 - Michael Zhang <[email protected]>
11
12 allOf:
13 - $ref: dai-common.yaml#
14
15 properties:
16 compatible:
17 const: everest,es8375
18
19 reg:
20 maxItems: 1
21
22 clocks:
23 items:
24 - description: clock for master clock (MCLK)
25
26 clock-names:
27 items:
28 - const: mclk
29
30 vdda-supply:
31 description:
32 Analogue power supply.
33
34 vddd-supply:
35 description:
36 Interface power supply.
37
38 everest,mclk-src:
39 $ref: /schemas/types.yaml#/definitions/uint8
40 description: |
41 Represents the MCLK/SCLK pair pins used as the internal clock.
42 0 represents selecting MCLK.
43 1 represents selecting SCLK.
44 enum: [0, 1]
45 default: 0
46
47 "#sound-dai-cells":
48 const: 0
49
50 required:
51 - compatible
52 - reg
53 - "#sound-dai-cells"
54 - vdda-supply
55 - vddd-supply
56
57 additionalProperties: false
58
59 examples:
60 - |
61 i2c {
62 #address-cells = <1>;
63 #size-cells = <0>;
64 es8375: codec@18 {
65 compatible = "everest,es8375";
66 reg = <0x18>;
67 vdda-supply = <&vdd3v3>;
68 vddd-supply = <&vdd3v3>;
69 #sound-dai-cells = <0>;
70 };
71 };
72

3. 한국어 전문 번역

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

ES8375 codec schema

1-14

이 YAML binding은 Everest ES8375 audio codec을 정의합니다. Schema ID는 `http://devicetree.org/schemas/sound/everest,es8375.yaml#`, maintainer는 Michael Zhang이며 `dai-common.yaml#`을 상속합니다.

주소와 master clock

15-29

`compatible`은 `everest,es8375`, `reg`는 최대 한 항목입니다. `clocks`는 MCLK 한 항목이고 `clock-names`는 `mclk`입니다.

전원과 내부 clock source

30-49

`vdda-supply`는 analogue power, `vddd-supply`는 interface power를 참조합니다.

`everest,mclk-src`는 internal clock에 사용할 MCLK/SCLK pin pair를 정하는 `uint8`입니다. 0은 MCLK, 1은 SCLK를 선택하며 기본값은 0입니다. `#sound-dai-cells`는 0입니다.

필수 전원과 추가 속성

50-58

필수 속성은 `compatible`, `reg`, `#sound-dai-cells`, `vdda-supply`, `vddd-supply`입니다. `additionalProperties: false`이므로 정의되지 않은 속성을 허용하지 않습니다.

ES8375 전원 예제

59-71

예제는 I2C address `0x18`의 ES8375에 analogue와 interface 전원 모두 `vdd3v3`을 연결하고 DAI cell 수를 0으로 설정합니다.

i2c {
  #address-cells = <1>;
  #size-cells = <0>;
  es8375: codec@18 {
    compatible = "everest,es8375";
    reg = <0x18>;
    vdda-supply = <&vdd3v3>;
    vddd-supply = <&vdd3v3>;
    #sound-dai-cells = <0>;
  };
};