1 # SPDX-License-Identifier: (GPL-2.0-only OR BS 1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/sound/dialo 4 $id: http://devicetree.org/schemas/sound/dialog,da7219.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: Dialog Semiconductor DA7219 Audio Codec 7 title: Dialog Semiconductor DA7219 Audio Codec
8 8
9 maintainers: 9 maintainers:
10 - David Rau <David.Rau.opensource@dm.renesas. 10 - David Rau <David.Rau.opensource@dm.renesas.com>
11 11
12 description: 12 description:
13 The DA7219 is an ultra low-power audio codec 13 The DA7219 is an ultra low-power audio codec with
14 in-built advanced accessory detection (AAD) 14 in-built advanced accessory detection (AAD) for mobile
15 computing and accessory applications, which 15 computing and accessory applications, which supports
16 sample rates up to 96 kHz at 24-bit resoluti 16 sample rates up to 96 kHz at 24-bit resolution.
17 17
18 properties: 18 properties:
19 compatible: 19 compatible:
20 const: dlg,da7219 20 const: dlg,da7219
21 21
22 reg: 22 reg:
23 maxItems: 1 23 maxItems: 1
24 24
25 interrupts: 25 interrupts:
26 maxItems: 1 26 maxItems: 1
27 27
28 VDD-supply: 28 VDD-supply:
29 description: 29 description:
30 VDD power supply for the device. 30 VDD power supply for the device.
31 31
32 VDDMIC-supply: 32 VDDMIC-supply:
33 description: 33 description:
34 VDDMIC power supply for the device. 34 VDDMIC power supply for the device.
35 35
36 VDDIO-supply: 36 VDDIO-supply:
37 description: 37 description:
38 VDDIO power supply for the device. 38 VDDIO power supply for the device.
39 39
40 interrupt-names: 40 interrupt-names:
41 description: 41 description:
42 Should be "wakeup" if interrupt is to be 42 Should be "wakeup" if interrupt is to be used to wake system,
43 otherwise "irq" should be used. 43 otherwise "irq" should be used.
44 enum: 44 enum:
45 - wakeup 45 - wakeup
46 - irq 46 - irq
47 47
48 wakeup-source: 48 wakeup-source:
49 type: boolean 49 type: boolean
50 description: 50 description:
51 Flag to indicate this device can wake sy 51 Flag to indicate this device can wake system (suspend/resume).
52 52
53 "#clock-cells": 53 "#clock-cells":
54 const: 1 54 const: 1
55 55
56 clock-output-names: 56 clock-output-names:
57 minItems: 2 57 minItems: 2
58 maxItems: 2 58 maxItems: 2
59 description: 59 description:
60 Name given for DAI WCLK and BCLK outputs 60 Name given for DAI WCLK and BCLK outputs.
61 61
62 clocks: 62 clocks:
63 maxItems: 1 63 maxItems: 1
64 description: 64 description:
65 phandle and clock specifier for codec MC 65 phandle and clock specifier for codec MCLK.
66 66
67 clock-names: 67 clock-names:
68 const: mclk 68 const: mclk
69 69
70 dlg,micbias-lvl: 70 dlg,micbias-lvl:
71 enum: [1600, 1800, 2000, 2200, 2400, 2600] 71 enum: [1600, 1800, 2000, 2200, 2400, 2600]
72 description: 72 description:
73 Voltage (mV) for Mic Bias. 73 Voltage (mV) for Mic Bias.
74 $ref: /schemas/types.yaml#/definitions/uin 74 $ref: /schemas/types.yaml#/definitions/uint32
75 75
76 dlg,mic-amp-in-sel: 76 dlg,mic-amp-in-sel:
77 enum: [diff, se_p, se_n] 77 enum: [diff, se_p, se_n]
78 description: 78 description:
79 Mic input source type. 79 Mic input source type.
80 80
81 diff - Differential. 81 diff - Differential.
82 82
83 se_p - MIC_P. 83 se_p - MIC_P.
84 Positive differential analog microphone 84 Positive differential analog microphone input.
85 85
86 se_n - MIC_N. 86 se_n - MIC_N.
87 Negative differential analog microphone 87 Negative differential analog microphone input.
88 $ref: /schemas/types.yaml#/definitions/str 88 $ref: /schemas/types.yaml#/definitions/string
89 89
90 da7219_aad: 90 da7219_aad:
91 type: object 91 type: object
92 additionalProperties: false 92 additionalProperties: false
93 description: 93 description:
94 Configuration of advanced accessory dete 94 Configuration of advanced accessory detection.
95 properties: 95 properties:
96 dlg,micbias-pulse-lvl: 96 dlg,micbias-pulse-lvl:
97 enum: [2800, 2900] 97 enum: [2800, 2900]
98 description: 98 description:
99 Mic bias higher voltage pulse level 99 Mic bias higher voltage pulse level (mV).
100 $ref: /schemas/types.yaml#/definitions 100 $ref: /schemas/types.yaml#/definitions/uint32
101 101
102 dlg,micbias-pulse-time: 102 dlg,micbias-pulse-time:
103 description: 103 description:
104 Mic bias higher voltage pulse durati 104 Mic bias higher voltage pulse duration (ms).
105 $ref: /schemas/types.yaml#/definitions 105 $ref: /schemas/types.yaml#/definitions/uint32
106 minimum: 0 106 minimum: 0
107 107
108 dlg,btn-cfg: 108 dlg,btn-cfg:
109 enum: [2, 5, 10, 50, 100, 200, 500] 109 enum: [2, 5, 10, 50, 100, 200, 500]
110 description: 110 description:
111 Periodic button press measurements f 111 Periodic button press measurements for 4-pole jack (ms).
112 $ref: /schemas/types.yaml#/definitions 112 $ref: /schemas/types.yaml#/definitions/uint32
113 113
114 dlg,mic-det-thr: 114 dlg,mic-det-thr:
115 enum: [200, 500, 750, 1000] 115 enum: [200, 500, 750, 1000]
116 description: 116 description:
117 Impedance threshold for mic detectio 117 Impedance threshold for mic detection measurement (Ohms).
118 $ref: /schemas/types.yaml#/definitions 118 $ref: /schemas/types.yaml#/definitions/uint32
119 119
120 dlg,jack-ins-deb: 120 dlg,jack-ins-deb:
121 enum: [5, 10, 20, 50, 100, 200, 500, 1 121 enum: [5, 10, 20, 50, 100, 200, 500, 1000]
122 description: 122 description:
123 Debounce time for jack insertion (ms 123 Debounce time for jack insertion (ms).
124 $ref: /schemas/types.yaml#/definitions 124 $ref: /schemas/types.yaml#/definitions/uint32
125 125
126 dlg,jack-ins-det-pty: 126 dlg,jack-ins-det-pty:
127 enum: [low, high] 127 enum: [low, high]
128 description: 128 description:
129 Polarity for jack insertion detectio 129 Polarity for jack insertion detection.
130 $ref: /schemas/types.yaml#/definitions 130 $ref: /schemas/types.yaml#/definitions/string
131 131
132 dlg,jack-det-rate: 132 dlg,jack-det-rate:
133 enum: ["32_64", "64_128", "128_256", " 133 enum: ["32_64", "64_128", "128_256", "256_512"]
134 description: 134 description:
135 Jack type (3/4 pole) detection laten 135 Jack type (3/4 pole) detection latency (ms).
136 $ref: /schemas/types.yaml#/definitions 136 $ref: /schemas/types.yaml#/definitions/string
137 137
138 dlg,jack-rem-deb: 138 dlg,jack-rem-deb:
139 enum: [1, 5, 10, 20] 139 enum: [1, 5, 10, 20]
140 description: 140 description:
141 Debounce time for jack removal (ms). 141 Debounce time for jack removal (ms).
142 $ref: /schemas/types.yaml#/definitions 142 $ref: /schemas/types.yaml#/definitions/uint32
143 143
144 dlg,a-d-btn-thr: 144 dlg,a-d-btn-thr:
145 description: 145 description:
146 Impedance threshold between buttons 146 Impedance threshold between buttons A and D.
147 $ref: /schemas/types.yaml#/definitions 147 $ref: /schemas/types.yaml#/definitions/uint32
148 minimum: 0 148 minimum: 0
149 maximum: 255 149 maximum: 255
150 150
151 dlg,d-b-btn-thr: 151 dlg,d-b-btn-thr:
152 description: 152 description:
153 Impedance threshold between buttons 153 Impedance threshold between buttons D and B.
154 $ref: /schemas/types.yaml#/definitions 154 $ref: /schemas/types.yaml#/definitions/uint32
155 minimum: 0 155 minimum: 0
156 maximum: 255 156 maximum: 255
157 157
158 dlg,b-c-btn-thr: 158 dlg,b-c-btn-thr:
159 description: 159 description:
160 Impedance threshold between buttons 160 Impedance threshold between buttons B and C.
161 $ref: /schemas/types.yaml#/definitions 161 $ref: /schemas/types.yaml#/definitions/uint32
162 minimum: 0 162 minimum: 0
163 maximum: 255 163 maximum: 255
164 164
165 dlg,c-mic-btn-thr: 165 dlg,c-mic-btn-thr:
166 description: 166 description:
167 Impedance threshold between button C 167 Impedance threshold between button C and Mic.
168 $ref: /schemas/types.yaml#/definitions 168 $ref: /schemas/types.yaml#/definitions/uint32
169 minimum: 0 169 minimum: 0
170 maximum: 255 170 maximum: 255
171 171
172 dlg,btn-avg: 172 dlg,btn-avg:
173 enum: [1, 2, 4, 8] 173 enum: [1, 2, 4, 8]
174 description: 174 description:
175 Number of 8-bit readings for average 175 Number of 8-bit readings for averaged button measurement.
176 $ref: /schemas/types.yaml#/definitions 176 $ref: /schemas/types.yaml#/definitions/uint32
177 177
178 dlg,adc-1bit-rpt: 178 dlg,adc-1bit-rpt:
179 enum: [1, 2, 4, 8] 179 enum: [1, 2, 4, 8]
180 description: 180 description:
181 Repeat count for 1-bit button measur 181 Repeat count for 1-bit button measurement.
182 $ref: /schemas/types.yaml#/definitions 182 $ref: /schemas/types.yaml#/definitions/uint32
183 183
184 required: 184 required:
185 - compatible 185 - compatible
186 - reg 186 - reg
187 - interrupts 187 - interrupts
188 - VDD-supply 188 - VDD-supply
189 - VDDMIC-supply 189 - VDDMIC-supply
190 - VDDIO-supply 190 - VDDIO-supply
191 191
192 additionalProperties: false 192 additionalProperties: false
193 193
194 examples: 194 examples:
195 - | 195 - |
196 #include <dt-bindings/interrupt-controller 196 #include <dt-bindings/interrupt-controller/irq.h>
197 i2c { 197 i2c {
198 #address-cells = <1>; 198 #address-cells = <1>;
199 #size-cells = <0>; 199 #size-cells = <0>;
200 200
201 codec: da7219@1a { 201 codec: da7219@1a {
202 compatible = "dlg,da7219"; 202 compatible = "dlg,da7219";
203 reg = <0x1a>; 203 reg = <0x1a>;
204 204
205 interrupt-parent = <&gpio6>; 205 interrupt-parent = <&gpio6>;
206 interrupts = <11 IRQ_TYPE_LEVEL_LOW> 206 interrupts = <11 IRQ_TYPE_LEVEL_LOW>;
207 207
208 VDD-supply = <&vdd_reg>; 208 VDD-supply = <&vdd_reg>;
209 VDDMIC-supply = <&vddmic_reg>; 209 VDDMIC-supply = <&vddmic_reg>;
210 VDDIO-supply = <&vddio_reg>; 210 VDDIO-supply = <&vddio_reg>;
211 211
212 #clock-cells = <1>; 212 #clock-cells = <1>;
213 clock-output-names = "da7219-dai-wcl 213 clock-output-names = "da7219-dai-wclk", "da7219-dai-bclk";
214 214
215 clocks = <&clks 201>; 215 clocks = <&clks 201>;
216 clock-names = "mclk"; 216 clock-names = "mclk";
217 217
218 dlg,micbias-lvl = <2600>; 218 dlg,micbias-lvl = <2600>;
219 dlg,mic-amp-in-sel = "diff"; 219 dlg,mic-amp-in-sel = "diff";
220 220
221 da7219_aad { 221 da7219_aad {
222 dlg,btn-cfg = <50>; 222 dlg,btn-cfg = <50>;
223 dlg,mic-det-thr = <500>; 223 dlg,mic-det-thr = <500>;
224 dlg,jack-ins-deb = <20>; 224 dlg,jack-ins-deb = <20>;
225 dlg,jack-ins-det-pty = "low"; 225 dlg,jack-ins-det-pty = "low";
226 dlg,jack-det-rate = "32_64"; 226 dlg,jack-det-rate = "32_64";
227 dlg,jack-rem-deb = <1>; 227 dlg,jack-rem-deb = <1>;
228 228
229 dlg,a-d-btn-thr = <0xa>; 229 dlg,a-d-btn-thr = <0xa>;
230 dlg,d-b-btn-thr = <0x16>; 230 dlg,d-b-btn-thr = <0x16>;
231 dlg,b-c-btn-thr = <0x21>; 231 dlg,b-c-btn-thr = <0x21>;
232 dlg,c-mic-btn-thr = <0x3E>; 232 dlg,c-mic-btn-thr = <0x3E>;
233 233
234 dlg,btn-avg = <4>; 234 dlg,btn-avg = <4>;
235 dlg,adc-1bit-rpt = <1>; 235 dlg,adc-1bit-rpt = <1>;
236 }; 236 };
237 }; 237 };
238 }; 238 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.