xref: /freebsd/sys/contrib/device-tree/Bindings/sound/tas2562.yaml (revision a03411e84728e9b267056fd31c7d1d9d1dc1b01e)
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2# Copyright (C) 2019 Texas Instruments Incorporated
3%YAML 1.2
4---
5$id: "http://devicetree.org/schemas/sound/tas2562.yaml#"
6$schema: "http://devicetree.org/meta-schemas/core.yaml#"
7
8title: Texas Instruments TAS2562 Smart PA
9
10maintainers:
11  - Andrew Davis <afd@ti.com>
12
13description: |
14  The TAS2562 is a mono, digital input Class-D audio amplifier optimized for
15  efficiently driving high peak power into small loudspeakers.
16  Integrated speaker voltage and current sense provides for
17  real time monitoring of loudspeaker behavior.
18
19  Specifications about the audio amplifier can be found at:
20    https://www.ti.com/lit/gpn/tas2562
21    https://www.ti.com/lit/gpn/tas2563
22    https://www.ti.com/lit/gpn/tas2564
23    https://www.ti.com/lit/gpn/tas2110
24
25allOf:
26  - $ref: dai-common.yaml#
27
28properties:
29  compatible:
30    enum:
31      - ti,tas2562
32      - ti,tas2563
33      - ti,tas2564
34      - ti,tas2110
35
36  reg:
37    maxItems: 1
38    description: |
39       I2C address of the device can be one of these 0x4c, 0x4d, 0x4e or 0x4f
40
41  shut-down-gpios:
42    maxItems: 1
43    description: GPIO used to control the state of the device.
44    deprecated: true
45
46  shutdown-gpios:
47    maxItems: 1
48    description: GPIO used to control the state of the device.
49
50  interrupts:
51    maxItems: 1
52
53  ti,imon-slot-no:
54    $ref: /schemas/types.yaml#/definitions/uint32
55    description: TDM TX current sense time slot.
56
57  '#sound-dai-cells':
58    # The codec has a single DAI, the #sound-dai-cells=<1>; case is left in for backward
59    # compatibility but is deprecated.
60    enum: [0, 1]
61
62required:
63  - compatible
64  - reg
65
66unevaluatedProperties: false
67
68examples:
69  - |
70   #include <dt-bindings/gpio/gpio.h>
71   i2c {
72     #address-cells = <1>;
73     #size-cells = <0>;
74     codec: codec@4c {
75       compatible = "ti,tas2562";
76       reg = <0x4c>;
77       #sound-dai-cells = <0>;
78       interrupt-parent = <&gpio1>;
79       interrupts = <14>;
80       shutdown-gpios = <&gpio1 15 0>;
81       ti,imon-slot-no = <0>;
82     };
83   };
84