xref: /freebsd/sys/contrib/device-tree/Bindings/sound/tas2562.yaml (revision 02e9120893770924227138ba49df1edb3896112a)
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