ti,tas2781.yaml

  1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
  2# Copyright (C) 2022 - 2025 Texas Instruments Incorporated
  3%YAML 1.2
  4---
  5$id: http://devicetree.org/schemas/sound/ti,tas2781.yaml#
  6$schema: http://devicetree.org/meta-schemas/core.yaml#
  7
  8title: Texas Instruments TAS2563/TAS2781 SmartAMP
  9
 10maintainers:
 11  - Shenghao Ding <shenghao-ding@ti.com>
 12
 13description: |
 14  The TAS2118/TAS2X20 is mono, digital input Class-D audio
 15  amplifier optimized for efficiently driving high peak power into
 16  small loudspeakers.
 17  The TAS257x is mono, digital input Class-D audio amplifier optimized
 18  for efficiently driving high peak power into small loudspeakers.
 19  Integrated speaker voltage and current sense provides for real time
 20  monitoring of loudspeaker behavior.
 21  The TAS2563/TAS2781 is a mono, digital input Class-D audio
 22  amplifier optimized for efficiently driving high peak power into
 23  small loudspeakers. An integrated on-chip DSP supports Texas
 24  Instruments Smart Amp speaker protection algorithm. The
 25  integrated speaker voltage and current sense provides for real time
 26  monitoring of loudspeaker behavior.
 27  The TAS5802/TAS5815/TAS5822/TAS5825/TAS5827/TAS5828 is a stereo,
 28  digital input Class-D audio amplifier optimized for efficiently driving
 29  high peak power into small loudspeakers. An integrated on-chip DSP
 30  supports Texas Instruments Smart Amp speaker protection algorithm.
 31
 32  Specifications about the audio amplifier can be found at:
 33    https://www.ti.com/lit/gpn/tas2120
 34    https://www.ti.com/lit/gpn/tas2320
 35    https://www.ti.com/lit/gpn/tas2563
 36    https://www.ti.com/lit/gpn/tas2572
 37    https://www.ti.com/lit/gpn/tas2574
 38    https://www.ti.com/lit/gpn/tas2781
 39    https://www.ti.com/lit/gpn/tas5806m
 40    https://www.ti.com/lit/gpn/tas5806md
 41    https://www.ti.com/lit/gpn/tas5815
 42    https://www.ti.com/lit/gpn/tas5822m
 43    https://www.ti.com/lit/gpn/tas5825m
 44    https://www.ti.com/lit/gpn/tas5827
 45    https://www.ti.com/lit/gpn/tas5828m
 46    https://www.ti.com/lit/gpn/tas5830
 47
 48properties:
 49  compatible:
 50    description: |
 51      ti,tas2020: 3.2-W Mono Digital Input Class-D Speaker Amp with 5.5V PVDD
 52      Support.
 53
 54      ti,tas2118: 5-W Mono Digital Input Class-D Speaker Amp with Integrated
 55      8.4-V Class-H Boost.
 56
 57      ti,tas2120: 8.2-W Mono Digital Input Class-D Speaker Amp with
 58      Integrated 14.75V Class-H Boost.
 59
 60      ti,tas2320: 15-W Mono Digital Input Class-D Speaker Amp with 15V Support.
 61
 62      ti,tas2563: 6.1-W Boosted Class-D Audio Amplifier With Integrated
 63      DSP and IV Sense, 16/20/24/32bit stereo I2S or multichannel TDM.
 64
 65      ti,tas2568: 5.3-W Digital Input Smart Amp with I/V Sense and Integrated
 66      10.75-V Class-H Boost
 67
 68      ti,tas2570: 5.8-W Digital Input smart amp with I/V sense and integrated
 69      11-V Class-H Boost
 70
 71      ti,tas2572: 6.6-W Digital Input smart amp with I/V sense and integrated
 72      13-V Class-H Boost
 73
 74      ti,tas2574: 8.5-W Digital Input smart amp with I/V sense and integrated
 75      15-V Class-H Boost
 76
 77      ti,tas2781: 24-V Class-D Amplifier with Real Time Integrated Speaker
 78      Protection and Audio Processing, 16/20/24/32bit stereo I2S or
 79      multichannel TDM.
 80
 81      ti,tas5802: 22-W, Inductor-Less, Digital Input, Closed-Loop Class-D
 82      Audio Amplifier with 96-Khz Extended Processing and Low Idle Power
 83      Dissipation.
 84
 85      ti,tas5806m: 23-W, Inductor-Less, Digital Input, Stereo, Closed-Loop
 86      Class-D Audio Amplifier with Enhanced Processing and Low Power
 87      Dissipation.
 88
 89      ti,tas5806md: 23-W, Inductor-Less, Digital Input, Stereo, Closed-Loop
 90      Class-D Audio Amplifier with Enhanced Processing and DirectPath(TM)
 91      HP Driver
 92
 93      ti,tas5815: 30-W, Digital Input, Stereo, Closed-loop Class-D Audio
 94      Amplifier with 96 kHz Enhanced Processing
 95
 96      ti,tas5822: 35-W, Digital Input, Stereo, Closed-Loop Class-D Audio
 97      Amplifier with 96 kHz Enhanced Processing
 98
 99      ti,tas5825: 38-W Stereo, Inductor-Less, Digital Input, Closed-Loop 4.5V
100      to 26.4V Class-D Audio Amplifier with 192-kHz Extended Audio Processing.
101
102      ti,tas5827: 47-W Stereo, Digital Input, High Efficiency Closed-Loop
103      Class-D Amplifier with Class-H Algorithm
104
105      ti,tas5828: 50-W Stereo, Digital Input, High Efficiency Closed-Loop
106      Class-D Amplifier with Hybrid-Pro Algorithm
107
108      ti,tas5830: 65-W Stereo, Digital Input, High Efficiency Closed-Loop
109      Class-D Amplifier with Class-H Algorithm
110    oneOf:
111      - items:
112          - enum:
113              - ti,tas2020
114              - ti,tas2118
115              - ti,tas2120
116              - ti,tas2320
117              - ti,tas2563
118              - ti,tas2568
119              - ti,tas2570
120              - ti,tas2572
121              - ti,tas2574
122              - ti,tas5802
123              - ti,tas5806m
124              - ti,tas5806md
125              - ti,tas5815
126              - ti,tas5822
127              - ti,tas5825
128              - ti,tas5827
129              - ti,tas5828
130              - ti,tas5830
131          - const: ti,tas2781
132      - enum:
133          - ti,tas2781
134
135  reg:
136    description:
137      I2C address, in multiple-AMP case, all the i2c address
138      aggregate as one Audio Device to support multiple audio slots.
139    maxItems: 8
140    minItems: 1
141
142  reset-gpios:
143    maxItems: 1
144
145  interrupts:
146    maxItems: 1
147
148  '#sound-dai-cells':
149    const: 0
150
151required:
152  - compatible
153  - reg
154
155allOf:
156  - $ref: dai-common.yaml#
157  - if:
158      properties:
159        compatible:
160          contains:
161            enum:
162              - ti,tas2020
163              - ti,tas2118
164              - ti,tas2120
165              - ti,tas2320
166              - ti,tas2568
167              - ti,tas2574
168    then:
169      properties:
170        reg:
171          maxItems: 4
172          items:
173            minimum: 0x48
174            maximum: 0x4b
175
176  - if:
177      properties:
178        compatible:
179          contains:
180            enum:
181              - ti,tas2563
182              - ti,tas5825
183    then:
184      properties:
185        reg:
186          description:
187            I2C address, in multiple-AMP case, all the i2c address
188            aggregate as one Audio Device to support multiple audio slots.
189          maxItems: 4
190          minItems: 1
191          items:
192            minimum: 0x4c
193            maximum: 0x4f
194
195  - if:
196      properties:
197        compatible:
198          contains:
199            enum:
200              - ti,tas2570
201              - ti,tas2572
202    then:
203      properties:
204        reg:
205          maxItems: 4
206          items:
207            minimum: 0x48
208            maximum: 0x4b
209
210  - if:
211      properties:
212        compatible:
213          contains:
214            enum:
215              - ti,tas2781
216    then:
217      properties:
218        reg:
219          description:
220            I2C address, in multiple-AMP case, all the i2c address
221            aggregate as one Audio Device to support multiple audio slots.
222          maxItems: 8
223          minItems: 1
224          items:
225            minimum: 0x38
226            maximum: 0x3f
227
228  - if:
229      properties:
230        compatible:
231          contains:
232            enum:
233              - ti,tas5802
234              - ti,tas5815
235    then:
236      properties:
237        reg:
238          maxItems: 4
239          items:
240            minimum: 0x54
241            maximum: 0x57
242
243  - if:
244      properties:
245        compatible:
246          contains:
247            enum:
248              - ti,tas5806m
249              - ti,tas5806md
250              - ti,tas5822
251    then:
252      properties:
253        reg:
254          maxItems: 4
255          items:
256            minimum: 0x2c
257            maximum: 0x2f
258
259  - if:
260      properties:
261        compatible:
262          contains:
263            enum:
264              - ti,tas5827
265              - ti,tas5828
266              - ti,tas5830
267    then:
268      properties:
269        reg:
270          maxItems: 6
271          items:
272            minimum: 0x60
273            maximum: 0x65
274
275additionalProperties: false
276
277examples:
278  - |
279    #include <dt-bindings/gpio/gpio.h>
280
281    i2c {
282        /* example with quad tas2781s, such as tablet or pad device */
283        #address-cells = <1>;
284        #size-cells = <0>;
285
286        audio-codec@38 {
287            compatible = "ti,tas2781";
288            reg = <0x38>, /* Audio slot 0 */
289                  <0x3a>, /* Audio slot 1 */
290                  <0x39>, /* Audio slot 2 */
291                  <0x3b>; /* Audio slot 3 */
292
293            #sound-dai-cells = <0>;
294            reset-gpios = <&gpio1 10 GPIO_ACTIVE_HIGH>;
295            interrupt-parent = <&gpio1>;
296            interrupts = <15>;
297        };
298    };
299...