Bindings/sound/ti,tas2781.yaml

   1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
   2 # Copyright (C) 2022 - 2023 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
   8 title: Texas Instruments TAS2563/TAS2781 SmartAMP
   9
  10 maintainers:
  11   - Shenghao Ding <shenghao-ding@ti.com>
  12
  13 description: |
  14   The TAS2563/TAS2781 is a mono, digital input Class-D audio
  15   amplifier optimized for efficiently driving high peak power into
  16   small loudspeakers. An integrated on-chip DSP supports Texas
  17   Instruments Smart Amp speaker protection algorithm. The
  18   integrated speaker voltage and current sense provides for real time
  19   monitoring of loudspeaker behavior.
  20
  21   Specifications about the audio amplifier can be found at:
  22     https://www.ti.com/lit/gpn/tas2563
  23     https://www.ti.com/lit/gpn/tas2781
  24
  25 properties:
  26   compatible:
  27     description: |
  28       ti,tas2563: 6.1-W Boosted Class-D Audio Amplifier With Integrated
  29       DSP and IV Sense, 16/20/24/32bit stereo I2S or multichannel TDM.
  30
  31       ti,tas2781: 24-V Class-D Amplifier with Real Time Integrated Speaker
  32       Protection and Audio Processing, 16/20/24/32bit stereo I2S or
  33       multichannel TDM.
  34     oneOf:
  35       - items:
  36           - enum:
  37               - ti,tas2563
  38           - const: ti,tas2781
  39       - enum:
  40           - ti,tas2781
  41
  42   reg:
  43     description:
  44       I2C address, in multiple-AMP case, all the i2c address
  45       aggregate as one Audio Device to support multiple audio slots.
  46     maxItems: 8
  47     minItems: 1
  48
  49   reset-gpios:
  50     maxItems: 1
  51
  52   interrupts:
  53     maxItems: 1
  54
  55   '#sound-dai-cells':
  56     const: 0
  57
  58 required:
  59   - compatible
  60   - reg
  61
  62 allOf:
  63   - $ref: dai-common.yaml#
  64   - if:
  65       properties:
  66         compatible:
  67           contains:
  68             enum:
  69               - ti,tas2563
  70     then:
  71       properties:
  72         reg:
  73           description:
  74             I2C address, in multiple-AMP case, all the i2c address
  75             aggregate as one Audio Device to support multiple audio slots.
  76           maxItems: 4
  77           minItems: 1
  78           items:
  79             minimum: 0x4c
  80             maximum: 0x4f
  81
  82   - if:
  83       properties:
  84         compatible:
  85           contains:
  86             enum:
  87               - ti,tas2781
  88     then:
  89       properties:
  90         reg:
  91           description:
  92             I2C address, in multiple-AMP case, all the i2c address
  93             aggregate as one Audio Device to support multiple audio slots.
  94           maxItems: 8
  95           minItems: 1
  96           items:
  97             minimum: 0x38
  98             maximum: 0x3f
  99
 100 additionalProperties: false
 101
 102 examples:
 103   - |
 104    #include <dt-bindings/gpio/gpio.h>
 105    i2c {
 106      /* example with quad tas2781s, such as tablet or pad device */
 107      #address-cells = <1>;
 108      #size-cells = <0>;
 109      quad_tas2781: tas2781@38 {
 110        compatible = "ti,tas2781";
 111        reg = <0x38>, /* Audio slot 0 */
 112              <0x3a>, /* Audio slot 1 */
 113              <0x39>, /* Audio slot 2 */
 114              <0x3b>; /* Audio slot 3 */
 115
 116        #sound-dai-cells = <0>;
 117        reset-gpios = <&gpio1 10 GPIO_ACTIVE_HIGH>;
 118        interrupt-parent = <&gpio1>;
 119        interrupts = <15>;
 120      };
 121    };
 122 ...