xref: /linux/Documentation/devicetree/bindings/sound/ti,tlv320adc3xxx.yaml (revision c532de5a67a70f8533d495f8f2aaa9a0491c3ad0) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/sound/ti,tlv320adc3xxx.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Texas Instruments TLV320ADC3001/TLV320ADC3101 Stereo ADC
8
9maintainers:
10  - Ricard Wanderlof <ricardw@axis.com>
11
12description: |
13  Texas Instruments TLV320ADC3001 and TLV320ADC3101 Stereo ADC
14  https://www.ti.com/product/TLV320ADC3001
15  https://www.ti.com/product/TLV320ADC3101
16
17allOf:
18  - $ref: dai-common.yaml#
19
20properties:
21  compatible:
22    enum:
23      - ti,tlv320adc3001
24      - ti,tlv320adc3101
25
26  reg:
27    maxItems: 1
28    description: I2C address
29
30  '#sound-dai-cells':
31    const: 0
32
33  '#gpio-cells':
34    const: 2
35
36  gpio-controller: true
37
38  reset-gpios:
39    maxItems: 1
40    description: GPIO pin used for codec reset (RESET pin)
41
42  clocks:
43    maxItems: 1
44    description: Master clock (MCLK)
45
46  ti,dmdin-gpio1:
47    $ref: /schemas/types.yaml#/definitions/uint32
48    enum:
49      - 0 # ADC3XXX_GPIO_DISABLED       - I/O buffers powered down and not used
50      - 1 # ADC3XXX_GPIO_INPUT          - Various non-GPIO input functions
51      - 2 # ADC3XXX_GPIO_GPI            - General purpose input
52      - 3 # ADC3XXX_GPIO_GPO            - General purpose output
53      - 4 # ADC3XXX_GPIO_CLKOUT         - Clock source set in CLKOUT_MUX reg
54      - 5 # ADC3XXX_GPIO_INT1           - INT1 output
55      - 6 # ADC3XXX_GPIO_SECONDARY_BCLK - Codec interface secondary BCLK
56      - 7 # ADC3XXX_GPIO_SECONDARY_WCLK - Codec interface secondary WCLK
57    default: 0
58    description: |
59      Configuration for DMDIN/GPIO1 pin.
60
61      When ADC3XXX_GPIO_GPO is selected, the pin may be controlled via the
62      GPIO framework, as pin number 0 on the device.
63
64  ti,dmclk-gpio2:
65    $ref: /schemas/types.yaml#/definitions/uint32
66    enum:
67      - 0 # ADC3XXX_GPIO_DISABLED       - I/O buffers powered down and not used
68      - 1 # ADC3XXX_GPIO_INPUT          - Various non-GPIO input functions
69      - 2 # ADC3XXX_GPIO_GPI            - General purpose input
70      - 3 # ADC3XXX_GPIO_GPO            - General purpose output
71      - 4 # ADC3XXX_GPIO_CLKOUT         - Clock source set in CLKOUT_MUX reg
72      - 5 # ADC3XXX_GPIO_INT1           - INT1 output
73      - 6 # ADC3XXX_GPIO_SECONDARY_BCLK - Codec interface secondary BCLK
74      - 7 # ADC3XXX_GPIO_SECONDARY_WCLK - Codec interface secondary WCLK
75    default: 0
76    description: |
77      Configuration for DMCLK/GPIO2 pin.
78
79      When ADC3XXX_GPIO_GPO is selected, the pin may be controlled via the
80      GPIO framework, as pin number 1 on the device.
81
82      Note that there is currently no support for reading the GPIO pins as
83      inputs.
84
85  ti,micbias1-gpo:
86    type: boolean
87    description: |
88      When set, the MICBIAS1 pin may be controlled via the GPIO framework,
89      as pin number 3 on the device.
90
91      In this mode, when the pin is activated, it will be set to the voltage
92      specified by the ti,micbias1-vg property. When deactivated, the pin will
93      float.
94
95  ti,micbias2-gpo:
96    type: boolean
97    description: |
98      When set, the MICBIAS2 pin may be controlled via the GPIO framework,
99      as pin number 4 on the device.
100
101      In this mode, when the pin is activated, it will be set to the voltage
102      specified by the ti,micbias2-vg property. When deactivated, the pin will
103      float.
104
105  ti,micbias1-vg:
106    $ref: /schemas/types.yaml#/definitions/uint32
107    enum:
108      - 0 # ADC3XXX_MICBIAS_OFF		- Mic bias is powered down
109      - 1 # ADC3XXX_MICBIAS_2_0V	- Mic bias is set to 2.0V
110      - 2 # ADC3XXX_MICBIAS_2_5V	- Mic bias is set to 2.5V
111      - 3 # ADC3XXX_MICBIAS_AVDD	- Mic bias is same as AVDD supply
112    default: 0
113    description: |
114      Mic bias voltage output on MICBIAS1 pin
115
116  ti,micbias2-vg:
117    $ref: /schemas/types.yaml#/definitions/uint32
118    enum:
119      - 0 # ADC3XXX_MICBIAS_OFF		- Mic bias is powered down
120      - 1 # ADC3XXX_MICBIAS_2_0V	- Mic bias is set to 2.0V
121      - 2 # ADC3XXX_MICBIAS_2_5V	- Mic bias is set to 2.5V
122      - 3 # ADC3XXX_MICBIAS_AVDD	- Mic bias is same as AVDD supply
123    default: 0
124    description: |
125      Mic bias voltage output on MICBIAS2 pin
126
127dependencies:
128  ti,micbias1-gpo: ['ti,micbias1-vg']
129  ti,micbias2-gpo: ['ti,micbias2-vg']
130
131required:
132  - compatible
133  - reg
134  - clocks
135
136unevaluatedProperties: false
137
138examples:
139  - |
140
141    #include <dt-bindings/gpio/gpio.h>
142    #include <dt-bindings/sound/tlv320adc3xxx.h>
143
144    i2c {
145        #address-cells = <1>;
146        #size-cells = <0>;
147        tlv320adc3101: audio-codec@18 {
148            compatible = "ti,tlv320adc3101";
149            reg = <0x18>;
150            reset-gpios = <&gpio_pc 3 GPIO_ACTIVE_LOW>;
151            clocks = <&audio_mclk>;
152            gpio-controller;
153            #gpio-cells = <2>;
154            ti,dmdin-gpio1 = <ADC3XXX_GPIO_GPO>;
155            ti,micbias1-vg = <ADC3XXX_MICBIAS_AVDD>;
156        };
157    };
158
159    audio_mclk: clock {
160        compatible = "fixed-clock";
161        #clock-cells = <0>;
162        clock-frequency = <24576000>;
163    };
164...
165