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
7 title: Texas Instruments TLV320ADC3001/TLV320ADC3101 Stereo ADC
8
9 maintainers:
10 - Ricard Wanderlof <ricardw@axis.com>
11
12 description: |
13 Texas Instruments TLV320ADC3001 and TLV320ADC3101 Stereo ADC
14 https://www.ti.com/product/TLV320ADC3001
15 https://www.ti.com/product/TLV320ADC3101
16
17 allOf:
18 - $ref: dai-common.yaml#
19
20 properties:
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
127 dependencies:
128 ti,micbias1-gpo: ['ti,micbias1-vg']
129 ti,micbias2-gpo: ['ti,micbias2-vg']
130
131 required:
132 - compatible
133 - reg
134 - clocks
135
136 unevaluatedProperties: false
137
138 examples:
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 ...
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.