Unverified Commit 27173bb0 authored by Prasad Kumpatla's avatar Prasad Kumpatla Committed by Mark Brown
Browse files

ASoC: dt-bindings: document wcd937x Audio Codec 



Document the Qualcomm WCD9370/WCD9375 Audio Codec and the
Soundwire devices than can be found on Qualcomm QCM6490 based platforms.

The Qualcomm WCD9370/WCD9375 Audio Codec communicates
with the host SoC over 2 Soundwire links to provide:
- 3 TX ADC paths with 4 differential AMIC inputs
- 6 DMIC inputs that are shared with AMIC input
- 4 Microphone BIAS
- RX paths with 4 PAs – HPHL/R, EAR and AUX
- Stereo Headphone output
- MBHC engine for Headset Detection

Signed-off-by: default avatarPrasad Kumpatla <quic_pkumpatl@quicinc.com>
Co-developed-by: default avatarMohammad Rafi Shaik <quic_mohs@quicinc.com>
Signed-off-by: default avatarMohammad Rafi Shaik <quic_mohs@quicinc.com>
Reviewed-by: default avatarKrzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Link: https://lore.kernel.org/r/20240524035535.3119208-2-quic_mohs@quicinc.com


Signed-off-by: default avatarMark Brown <broonie@kernel.org>
parent a1708fda

Documentation/devicetree/bindings/sound/qcom,wcd937x-sdw.yaml

0 → 100644
+91 −0
Original line number Diff line number Diff line 
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)

%YAML 1.2

---

$id: http://devicetree.org/schemas/sound/qcom,wcd937x-sdw.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#



title: Qualcomm SoundWire Slave devices on WCD9370/WCD9375



maintainers:

  - Srinivas Kandagatla <srinivas.kandagatla@linaro.org>



description: |

  Qualcomm WCD9370/WCD9375 Codec is a standalone Hi-Fi audio codec IC.

  It has RX and TX Soundwire slave devices. This bindings is for the

  slave devices.



properties:

  compatible:

    const: sdw20217010a00



  reg:

    maxItems: 1



  qcom,tx-port-mapping:

    description: |

      Specifies static port mapping between device and host tx ports.

      In the order of the device port index which are adc1_port, adc23_port,

      dmic03_mbhc_port, dmic46_port.

      Supports maximum 4 tx soundwire ports.



      WCD9370 TX Port 1 (ADC1)               <=> SWR2 Port 2

      WCD9370 TX Port 2 (ADC2, 3)            <=> SWR2 Port 2

      WCD9370 TX Port 3 (DMIC0,1,2,3 & MBHC) <=> SWR2 Port 3

      WCD9370 TX Port 4 (DMIC4,5,6,7)        <=> SWR2 Port 4



    $ref: /schemas/types.yaml#/definitions/uint32-array

    minItems: 4

    maxItems: 4

    items:

      enum: [1, 2, 3, 4]



  qcom,rx-port-mapping:

    description: |

      Specifies static port mapping between device and host rx ports.

      In the order of device port index which are hph_port, clsh_port,

      comp_port, lo_port, dsd port.

      Supports maximum 5 rx soundwire ports.



      WCD9370 RX Port 1 (HPH_L/R)       <==>    SWR1 Port 1 (HPH_L/R)

      WCD9370 RX Port 2 (CLSH)          <==>    SWR1 Port 2 (CLSH)

      WCD9370 RX Port 3 (COMP_L/R)      <==>    SWR1 Port 3 (COMP_L/R)

      WCD9370 RX Port 4 (LO)            <==>    SWR1 Port 4 (LO)

      WCD9370 RX Port 5 (DSD_L/R)       <==>    SWR1 Port 5 (DSD)



    $ref: /schemas/types.yaml#/definitions/uint32-array

    minItems: 5

    maxItems: 5

    items:

      enum: [1, 2, 3, 4, 5]



required:

  - compatible

  - reg



additionalProperties: false



examples:

  - |

    soundwire@3210000 {

        reg = <0x03210000 0x2000>;

        #address-cells = <2>;

        #size-cells = <0>;

        wcd937x_rx: codec@0,4 {

            compatible = "sdw20217010a00";

            reg = <0 4>;

            qcom,rx-port-mapping = <1 2 3 4 5>;

        };

    };



    soundwire@3230000 {

        reg = <0x03230000 0x2000>;

        #address-cells = <2>;

        #size-cells = <0>;

        wcd937x_tx: codec@0,3 {

            compatible = "sdw20217010a00";

            reg = <0 3>;

            qcom,tx-port-mapping = <2 2 3 4>;

        };

    };



...

Documentation/devicetree/bindings/sound/qcom,wcd937x.yaml

0 → 100644
+82 −0
Original line number Diff line number Diff line 
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)

%YAML 1.2

---

$id: http://devicetree.org/schemas/sound/qcom,wcd937x.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#



title: Qualcomm WCD9370/WCD9375 Audio Codec



maintainers:

  - Srinivas Kandagatla <srinivas.kandagatla@linaro.org>



description:

  Qualcomm WCD9370/WCD9375 Codec is a standalone Hi-Fi audio codec IC.

  It has RX and TX Soundwire slave devices.



allOf:

  - $ref: dai-common.yaml#

  - $ref: qcom,wcd93xx-common.yaml#



properties:

  compatible:

    oneOf:

      - const: qcom,wcd9370-codec

      - items:

          - const: qcom,wcd9375-codec

          - const: qcom,wcd9370-codec



  vdd-px-supply:

    description: A reference to the 1.8V I/O supply



required:

  - compatible

  - vdd-px-supply



unevaluatedProperties: false



examples:

  - |

    #include <dt-bindings/gpio/gpio.h>

    codec {

        compatible = "qcom,wcd9370-codec";

        pinctrl-names = "default", "sleep";

        pinctrl-0 = <&wcd_reset_n>;

        pinctrl-1 = <&wcd_reset_n_sleep>;

        reset-gpios = <&tlmm 83 GPIO_ACTIVE_HIGH>;

        vdd-buck-supply = <&vreg_l17b_1p8>;

        vdd-rxtx-supply = <&vreg_l18b_1p8>;

        vdd-px-supply = <&vreg_l18b_1p8>;

        vdd-mic-bias-supply = <&vreg_bob>;

        qcom,micbias1-microvolt = <1800000>;

        qcom,micbias2-microvolt = <1800000>;

        qcom,micbias3-microvolt = <1800000>;

        qcom,micbias4-microvolt = <1800000>;

        qcom,rx-device = <&wcd937x_rx>;

        qcom,tx-device = <&wcd937x_tx>;

        #sound-dai-cells = <1>;

    };



    /* ... */



    soundwire@3210000 {

        reg = <0x03210000 0x2000>;

        #address-cells = <2>;

        #size-cells = <0>;

        wcd937x_rx: codec@0,4 {

            compatible = "sdw20217010a00";

            reg = <0 4>;

            qcom,rx-port-mapping = <1 2 3 4 5>;

        };

    };



    soundwire@3230000 {

        reg = <0x03230000 0x2000>;

        #address-cells = <2>;

        #size-cells = <0>;

        wcd937x_tx: codec@0,3 {

            compatible = "sdw20217010a00";

            reg = <0 3>;

            qcom,tx-port-mapping = <1 2 3 4>;

        };

    };

...