Add device tree bindings for the Texas Instruments TAC5x1x family of audio codecs with integrated GPIO controller, describing the MFD core device interface, power supplies, and clock configuration. Signed-off-by: Niranjan H Y --- .../devicetree/bindings/mfd/ti,tac5x1x.yaml | 247 ++++++++++++++++++ 1 file changed, 247 insertions(+) create mode 100644 Documentation/devicetree/bindings/mfd/ti,tac5x1x.yaml diff --git a/Documentation/devicetree/bindings/mfd/ti,tac5x1x.yaml b/Documentation/devicetree/bindings/mfd/ti,tac5x1x.yaml new file mode 100644 index 000000000000..3d7943c0411f --- /dev/null +++ b/Documentation/devicetree/bindings/mfd/ti,tac5x1x.yaml @@ -0,0 +1,247 @@ +# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/mfd/ti,tac5x1x.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Texas Instruments TAC5x1x Multi-Function Audio Device + +maintainers: + - Niranjan H Y + +description: | + TAC5x1x family of low-power, high-performance audio codecs with integrated + GPIO controller and diagnostic capabilities. + + This is the parent binding. Child nodes are bound by these bindings: + - Pin controller: Documentation/devicetree/bindings/pinctrl/ti,tac5x1x-pinctrl.yaml + - Audio codec: Documentation/devicetree/bindings/sound/ti,tac5x1x.yaml + + Hardware features: + - Audio ADC/DAC with configurable impedance and voltage references + - 4-pin GPIO controller with alternate functions (PDM, IRQ) + - Analog voltage and current monitoring circuits + - Diagnostic fault detection with interrupt generation + + Device datasheets can be found at: + TAA5212: https://www.ti.com/lit/ds/symlink/taa5212.pdf + TAA5412-Q1: https://www.ti.com/lit/ds/symlink/taa5412-q1.pdf + TAC5111: https://www.ti.com/lit/ds/symlink/tac5111.pdf + TAC5112: https://www.ti.com/lit/ds/symlink/tac5112.pdf + TAC5211: https://www.ti.com/lit/ds/symlink/tac5211.pdf + TAC5212: https://www.ti.com/lit/ds/symlink/tac5212.pdf + TAC5301: https://www.ti.com/lit/ds/symlink/tac5301-q1.pdf + TAC5311-Q1: https://www.ti.com/lit/ds/symlink/tac5311-q1.pdf + TAC5312-Q1: https://www.ti.com/lit/ds/symlink/tac5312-q1.pdf + TAC5411-Q1: https://www.ti.com/lit/ds/symlink/tac5411-q1.pdf + TAC5412-Q1: https://www.ti.com/lit/ds/symlink/tac5412-q1.pdf + TAD5112: https://www.ti.com/lit/ds/symlink/tad5112.pdf + TAD5212: https://www.ti.com/lit/ds/symlink/tad5212.pdf + +properties: + compatible: + enum: + - ti,taa5212 + - ti,taa5412 + - ti,tac5111 + - ti,tac5112 + - ti,tac5211 + - ti,tac5212 + - ti,tac5301 + - ti,tac5311 + - ti,tac5312 + - ti,tac5411 + - ti,tac5412 + - ti,tad5112 + - ti,tad5212 + + reg: + maxItems: 1 + description: I2C slave address + + reset-gpios: + maxItems: 1 + description: Hardware reset control pin (active low) + + interrupts: + maxItems: 1 + description: | + Interrupt from device diagnostic circuits to host processor. + Generated on voltage/current fault conditions and other diagnostic events. + + clocks: + maxItems: 1 + description: Master clock input (MCLK) + + clock-names: + items: + - const: mclk + + avdd-supply: + description: | + Analog supply voltage input (AVDD pin). + Typical voltages: 1.8V, 3.0V, 3.3V, 5.0V + + iovdd-supply: + description: | + Digital I/O supply voltage input (IOVDD pin). + Typical voltages: 1.8V, 3.3V + + ti,vref-voltage: + description: | + Internal voltage reference setting in microvolts. + + Supported values: + - 1375000: VREF = 1.375V + - 2500000: VREF = 2.5V + - 2750000: VREF = 2.75V + + Constraint: Selected VREF must be lower than AVDD supply voltage. + $ref: /schemas/types.yaml#/definitions/uint32 + enum: [1375000, 2500000, 2750000] + default: 2500000 + + ti,micbias-voltage: + description: | + Microphone bias output voltage in microvolts. + + Configuration options: + - VREF voltage: Set to same value as ti,vref-voltage + - 0.5 × VREF: Set to half of ti,vref-voltage value + - AVDD voltage: Set to AVDD supply voltage value + + Note: When set to AVDD voltage, hardware automatically overrides + VREF setting to 2.75V regardless of ti,vref-voltage property. + $ref: /schemas/types.yaml#/definitions/uint32 + minimum: 687500 + maximum: 3300000 + + ti,adc1-impedance: + description: | + ADC Channel 1 input impedance in Ohms. + Supported impedance values: + - 5000: 5k input impedance + - 10000: 10k input impedance + - 40000: 40k input impedance + Available only for TAC5111, TAC5211, TAC5212, and TAA5212 variants. + $ref: /schemas/types.yaml#/definitions/uint32 + enum: [5000, 10000, 40000] + default: 10000 + + ti,adc2-impedance: + description: | + ADC Channel 2 input impedance in Ohms. + Supported impedance values: + - 5000: 5k input impedance + - 10000: 10k input impedance + - 40000: 40k input impedance + Available on stereo variants only (TAA5212, TAC5212). + $ref: /schemas/types.yaml#/definitions/uint32 + enum: [5000, 10000, 40000] + default: 10000 + + ti,out2x-vcom-cfg: + description: | + Channel OUT2x VCOM reference voltage selection. + + Configuration options: + - 0: VCOM = 0.6 × VREF + - 1: VCOM = AVDD / 2 + + Available on devices with stereo DAC output. + $ref: /schemas/types.yaml#/definitions/uint32 + enum: [0, 1] + default: 0 + + ti,gpa-threshold: + description: | + General Purpose Analog voltage monitoring thresholds in millivolts. + Format: [low_threshold_mv, high_threshold_mv] + + Monitoring range: 0mV to 6000mV, Resolution: ~24mV per step + Default thresholds: 200mV (low), 2600mV (high) + + Generates interrupt on voltage fault conditions. + $ref: /schemas/types.yaml#/definitions/uint32-array + minItems: 2 + maxItems: 2 + items: + minimum: 200 + maximum: 6000 + default: [200, 2600] + + ti,in-ch-en: + description: | + Enable input channel diagnostic monitoring circuits. + + When enabled (1), activates hardware monitoring for: + - Input channel fault detection + - Micbias current monitoring (if ti,micbias-threshold configured) + - Input overvoltage detection + + Available on: TAC5301, TAC5311, TAC5312, TAC5411, TAC5412, TAA5412 + $ref: /schemas/types.yaml#/definitions/uint32 + enum: [0, 1] + default: 0 + + ti,out-ch-en: + description: | + Enable output channel diagnostic monitoring circuits. + + When enabled (1), activates hardware monitoring for: + - Output channel fault detection + - Driver fault monitoring + - Short circuit detection + + Available on: TAC5301, TAC5311, TAC5312, TAC5411, TAC5412, TAA5412 + $ref: /schemas/types.yaml#/definitions/uint32 + enum: [0, 1] + default: 0 + + ti,incl-se-inm: + description: | + Include INxM pins in single-ended input diagnostic scan. + + When enabled (1), includes negative input pins (INxM) in diagnostic + monitoring for single-ended input configurations. + $ref: /schemas/types.yaml#/definitions/uint32 + enum: [0, 1] + default: 0 + + ti,incl-ac-coup: + description: | + Include AC-coupled input channels in diagnostic scan. + + When enabled (1), includes AC-coupled input channels in the + diagnostic monitoring system. + $ref: /schemas/types.yaml#/definitions/uint32 + enum: [0, 1] + default: 0 + + ti,micbias-threshold: + description: | + Microphone bias current monitoring thresholds in microamps. + Format: [low_threshold_ua, high_threshold_ua] + + Current monitoring range: 100uA to 33000uA, Resolution: ~132uA per step + Default thresholds: 2600uA (low), 18000uA (high) + + Hardware monitors actual current flow through MICBIAS pin. + Generates interrupts on fault conditions when ti,in-ch-en = <1>. + + Available on: TAC5301, TAC5311, TAC5312, TAC5411, TAC5412, TAA5412 + $ref: /schemas/types.yaml#/definitions/uint32-array + minItems: 2 + maxItems: 2 + items: + minimum: 100 + maximum: 33000 + default: [2600, 18000] + +required: + - compatible + - reg + - avdd-supply + - iovdd-supply + +unevaluatedProperties: false -- 2.34.1