← Documents Documentation/devicetree/bindings/sound/dlg,da7213.yaml GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings / Sound

Dialog DA7212/DA7213 audio codec

DA7212/DA7213의 clock, mic bias, DMIC과 audio graph 속성을 설명합니다.

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

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

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

요약과 해설

dlg,da7213.yaml:1-103

Dialog, generic DMIC, Eukrea와 Everest audio binding의 schema 구조, 필수 속성과 DTS 구성을 먼저 해설하고, 접을 수 있는 영어 원문 전체와 원문 줄 좌표를 보존한 한국어 전문 번역을 제공합니다.

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/dlg,da7213.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: Dialog Semiconductor DA7212/DA7213 Audio Codec
8
9 maintainers:
10 - Support Opensource <[email protected]>
11
12 allOf:
13 - $ref: dai-common.yaml#
14
15 properties:
16 compatible:
17 enum:
18 - dlg,da7212
19 - dlg,da7213
20
21 reg:
22 maxItems: 1
23
24 clocks:
25 maxItems: 1
26
27 clock-names:
28 const: mclk
29
30 "#sound-dai-cells":
31 const: 0
32
33 dlg,micbias1-lvl:
34 description: Voltage (mV) for Mic Bias 1
35 $ref: /schemas/types.yaml#/definitions/uint32
36 enum: [ 1600, 2200, 2500, 3000 ]
37
38 dlg,micbias2-lvl:
39 description: Voltage (mV) for Mic Bias 2
40 $ref: /schemas/types.yaml#/definitions/uint32
41 enum: [ 1600, 2200, 2500, 3000 ]
42
43 dlg,dmic-data-sel:
44 description: DMIC channel select based on clock edge
45 enum: [ lrise_rfall, lfall_rrise ]
46
47 dlg,dmic-samplephase:
48 description: When to sample audio from DMIC
49 enum: [ on_clkedge, between_clkedge ]
50
51 dlg,dmic-clkrate:
52 description: DMIC clock frequency (Hz)
53 $ref: /schemas/types.yaml#/definitions/uint32
54 enum: [ 1500000, 3000000 ]
55
56 VDDA-supply:
57 description: Analogue power supply
58
59 VDDIO-supply:
60 description: I/O power supply
61
62 VDDMIC-supply:
63 description: Mic Bias
64
65 VDDSP-supply:
66 description: Speaker supply
67
68 ports:
69 $ref: audio-graph-port.yaml#/definitions/ports
70
71 port:
72 $ref: audio-graph-port.yaml#
73 unevaluatedProperties: false
74
75 required:
76 - compatible
77 - reg
78
79 unevaluatedProperties: false
80
81 examples:
82 - |
83 i2c {
84 #address-cells = <1>;
85 #size-cells = <0>;
86
87 codec@1a {
88 compatible = "dlg,da7213";
89 reg = <0x1a>;
90
91 clocks = <&clks 201>;
92 clock-names = "mclk";
93
94 #sound-dai-cells = <0>;
95
96 dlg,micbias1-lvl = <2500>;
97 dlg,micbias2-lvl = <2500>;
98
99 dlg,dmic-data-sel = "lrise_rfall";
100 dlg,dmic-samplephase = "between_clkedge";
101 dlg,dmic-clkrate = <3000000>;
102 };
103 };
104

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

DA7212/DA7213 codec schema

1-14

이 YAML binding은 GPL-2.0-only 또는 BSD-2-Clause로 배포되며 Dialog Semiconductor DA7212/DA7213 audio codec을 정의합니다. Schema ID는 `http://devicetree.org/schemas/sound/dlg,da7213.yaml#`이고 core meta-schema를 사용합니다.

Maintainer는 Support Opensource이며 `allOf`에서 `dai-common.yaml#`을 참조해 공통 DAI 속성을 상속합니다.

Compatible, clock과 DAI cell

15-31

`compatible`은 `dlg,da7212` 또는 `dlg,da7213`입니다. `reg`와 `clocks`는 각각 최대 한 항목이며 `clock-names`는 `mclk`로 고정됩니다.

`#sound-dai-cells`는 0으로 고정되어 DAI phandle에 추가 specifier cell을 사용하지 않습니다.

Mic bias와 digital microphone 설정

32-55

`dlg,micbias1-lvl`과 `dlg,micbias2-lvl`은 각각 Mic Bias 1과 2의 전압(mV)을 정하는 `uint32`이며 1600, 2200, 2500, 3000 중 하나입니다.

`dlg,dmic-data-sel`은 clock edge에 따른 DMIC channel 선택으로 `lrise_rfall` 또는 `lfall_rrise`입니다. `dlg,dmic-samplephase`는 DMIC audio sampling 시점을 `on_clkedge` 또는 `between_clkedge`로 정합니다.

`dlg,dmic-clkrate`는 DMIC clock frequency(Hz)를 지정하는 `uint32`이며 1500000 또는 3000000입니다.

전원 rail과 audio graph port

56-74

`VDDA-supply`는 analogue power, `VDDIO-supply`는 I/O power, `VDDMIC-supply`는 mic bias, `VDDSP-supply`는 speaker supply를 참조합니다.

`ports`는 `audio-graph-port.yaml#/definitions/ports`, 단일 `port`는 `audio-graph-port.yaml#`을 참조합니다. 단일 port에는 참조 schema에서 평가되지 않은 속성을 허용하지 않습니다.

필수 속성과 확장 제한

75-80

필수 속성은 `compatible`과 `reg`입니다. `unevaluatedProperties: false`이므로 이 schema와 참조한 공통 schema에서 정의하지 않은 속성은 허용하지 않습니다.

DA7213 I2C 예제

81-103

예제는 I2C address `0x1a`의 DA7213에 clock 201을 `mclk`로 연결하고 `#sound-dai-cells`를 0으로 설정합니다. 두 mic bias는 2500 mV이며 DMIC은 left rising/right falling edge 선택, edge 사이 sampling, 3 MHz clock으로 구성됩니다.

i2c {
    #address-cells = <1>;
    #size-cells = <0>;

    codec@1a {
        compatible = "dlg,da7213";
        reg = <0x1a>;

        clocks = <&clks 201>;
        clock-names = "mclk";

        #sound-dai-cells = <0>;

        dlg,micbias1-lvl = <2500>;
        dlg,micbias2-lvl = <2500>;

        dlg,dmic-data-sel = "lrise_rfall";
        dlg,dmic-samplephase = "between_clkedge";
        dlg,dmic-clkrate = <3000000>;
    };
};