1# SPDX-License-Identifier: (GPL-2.0+ OR BSD-2-Clause) 2# Copyright (C) 2019 Texas Instruments Incorporated 3%YAML 1.2 4--- 5$id: http://devicetree.org/schemas/sound/tlv320adcx140.yaml# 6$schema: http://devicetree.org/meta-schemas/core.yaml# 7 8title: Texas Instruments TLV320ADCX140 Quad Channel Analog-to-Digital Converter 9 10maintainers: 11 - Dan Murphy <dmurphy@ti.com> 12 13description: | 14 The TLV320ADCX140 are multichannel (4-ch analog recording or 8-ch digital 15 PDM microphones recording), high-performance audio, analog-to-digital 16 converter (ADC) with analog inputs supporting up to 2V RMS. The TLV320ADCX140 17 family supports line and microphone Inputs, and offers a programmable 18 microphone bias or supply voltage generation. 19 20 Specifications can be found at: 21 https://www.ti.com/lit/ds/symlink/tlv320adc3140.pdf 22 https://www.ti.com/lit/ds/symlink/tlv320adc5140.pdf 23 https://www.ti.com/lit/ds/symlink/tlv320adc6140.pdf 24 25properties: 26 compatible: 27 enum: 28 - ti,tlv320adc3140 29 - ti,tlv320adc5140 30 - ti,tlv320adc6140 31 32 reg: 33 maxItems: 1 34 description: | 35 I2C addresss of the device can be one of these 0x4c, 0x4d, 0x4e or 0x4f 36 37 reset-gpios: 38 maxItems: 1 39 description: | 40 GPIO used for hardware reset. 41 42 areg-supply: 43 description: | 44 Regulator with AVDD at 3.3V. If not defined then the internal regulator 45 is enabled. 46 47 ti,mic-bias-source: 48 description: | 49 Indicates the source for MIC Bias. 50 0 - Mic bias is set to VREF 51 1 - Mic bias is set to VREF × 1.096 52 6 - Mic bias is set to AVDD 53 $ref: /schemas/types.yaml#/definitions/uint32 54 enum: [0, 1, 6] 55 56 ti,vref-source: 57 description: | 58 Indicates the source for MIC Bias. 59 0 - Set VREF to 2.75V 60 1 - Set VREF to 2.5V 61 2 - Set VREF to 1.375V 62 $ref: /schemas/types.yaml#/definitions/uint32 63 enum: [0, 1, 2] 64 65 ti,pdm-edge-select: 66 description: | 67 Defines the PDMCLK sampling edge configuration for the PDM inputs. This 68 array is defined as <PDMIN1 PDMIN2 PDMIN3 PDMIN4>. 69 70 0 - (default) Odd channel is latched on the negative edge and even 71 channel is latched on the the positive edge. 72 1 - Odd channel is latched on the positive edge and even channel is 73 latched on the the negative edge. 74 75 PDMIN1 - PDMCLK latching edge used for channel 1 and 2 data 76 PDMIN2 - PDMCLK latching edge used for channel 3 and 4 data 77 PDMIN3 - PDMCLK latching edge used for channel 5 and 6 data 78 PDMIN4 - PDMCLK latching edge used for channel 7 and 8 data 79 80 $ref: /schemas/types.yaml#/definitions/uint32-array 81 minItems: 1 82 maxItems: 4 83 items: 84 maximum: 1 85 default: [0, 0, 0, 0] 86 87 ti,gpi-config: 88 description: | 89 Defines the configuration for the general purpose input pins (GPI). 90 The array is defined as <GPI1 GPI2 GPI3 GPI4>. 91 92 0 - (default) disabled 93 1 - GPIX is configured as a general-purpose input (GPI) 94 2 - GPIX is configured as a master clock input (MCLK) 95 3 - GPIX is configured as an ASI input for daisy-chain (SDIN) 96 4 - GPIX is configured as a PDM data input for channel 1 and channel 97 (PDMDIN1) 98 5 - GPIX is configured as a PDM data input for channel 3 and channel 99 (PDMDIN2) 100 6 - GPIX is configured as a PDM data input for channel 5 and channel 101 (PDMDIN3) 102 7 - GPIX is configured as a PDM data input for channel 7 and channel 103 (PDMDIN4) 104 105 $ref: /schemas/types.yaml#/definitions/uint32-array 106 minItems: 1 107 maxItems: 4 108 items: 109 maximum: 7 110 default: [0, 0, 0, 0] 111 112 ti,asi-tx-drive: 113 type: boolean 114 description: | 115 When set the device will set the Tx ASI output to a Hi-Z state for unused 116 data cycles. Default is to drive the output low on unused ASI cycles. 117 118patternProperties: 119 '^ti,gpo-config-[1-4]$': 120 $ref: /schemas/types.yaml#/definitions/uint32-array 121 description: | 122 Defines the configuration and output driver for the general purpose 123 output pins (GPO). These values are pairs, the first value is for the 124 configuration type and the second value is for the output drive type. 125 The array is defined as <GPO_CFG GPO_DRV> 126 127 GPO output configuration can be one of the following: 128 129 0 - (default) disabled 130 1 - GPOX is configured as a general-purpose output (GPO) 131 2 - GPOX is configured as a device interrupt output (IRQ) 132 3 - GPOX is configured as a secondary ASI output (SDOUT2) 133 4 - GPOX is configured as a PDM clock output (PDMCLK) 134 135 GPO output drive configuration for the GPO pins can be one of the following: 136 137 0d - (default) Hi-Z output 138 1d - Drive active low and active high 139 2d - Drive active low and weak high 140 3d - Drive active low and Hi-Z 141 4d - Drive weak low and active high 142 5d - Drive Hi-Z and active high 143 144 ti,gpio-config: 145 description: | 146 Defines the configuration and output drive for the General Purpose 147 Input and Output pin (GPIO1). Its value is a pair, the first value is for 148 the configuration type and the second value is for the output drive 149 type. The array is defined as <GPIO1_CFG GPIO1_DRV> 150 151 configuration for the GPIO pin can be one of the following: 152 0 - disabled 153 1 - GPIO1 is configured as a general-purpose output (GPO) 154 2 - (default) GPIO1 is configured as a device interrupt output (IRQ) 155 3 - GPIO1 is configured as a secondary ASI output (SDOUT2) 156 4 - GPIO1 is configured as a PDM clock output (PDMCLK) 157 8 - GPIO1 is configured as an input to control when MICBIAS turns on or 158 off (MICBIAS_EN) 159 9 - GPIO1 is configured as a general-purpose input (GPI) 160 10 - GPIO1 is configured as a master clock input (MCLK) 161 11 - GPIO1 is configured as an ASI input for daisy-chain (SDIN) 162 12 - GPIO1 is configured as a PDM data input for channel 1 and channel 2 163 (PDMDIN1) 164 13 - GPIO1 is configured as a PDM data input for channel 3 and channel 4 165 (PDMDIN2) 166 14 - GPIO1 is configured as a PDM data input for channel 5 and channel 6 167 (PDMDIN3) 168 15 - GPIO1 is configured as a PDM data input for channel 7 and channel 8 169 (PDMDIN4) 170 171 output drive type for the GPIO pin can be one of the following: 172 0 - Hi-Z output 173 1 - Drive active low and active high 174 2 - (default) Drive active low and weak high 175 3 - Drive active low and Hi-Z 176 4 - Drive weak low and active high 177 5 - Drive Hi-Z and active high 178 179 allOf: 180 - $ref: /schemas/types.yaml#/definitions/uint32-array 181 - minItems: 2 182 maxItems: 2 183 items: 184 maximum: 15 185 default: [2, 2] 186 187required: 188 - compatible 189 - reg 190 191additionalProperties: false 192 193examples: 194 - | 195 #include <dt-bindings/gpio/gpio.h> 196 i2c0 { 197 #address-cells = <1>; 198 #size-cells = <0>; 199 codec: codec@4c { 200 compatible = "ti,tlv320adc5140"; 201 reg = <0x4c>; 202 ti,mic-bias-source = <6>; 203 ti,pdm-edge-select = <0 1 0 1>; 204 ti,gpi-config = <4 5 6 7>; 205 ti,gpio-config = <10 2>; 206 ti,gpo-config-1 = <0 0>; 207 ti,gpo-config-2 = <0 0>; 208 reset-gpios = <&gpio0 14 GPIO_ACTIVE_HIGH>; 209 }; 210 }; 211