Re: [PATCH v4 1/7] ASoC: dt-bindings: document wcd937x Audio Codec

On 16/05/2024 06:47, Mohammad Rafi Shaik wrote:

From: Prasad Kumpatla quic_pkumpatl@quicinc.com

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

Thank you for your patch. There is something to discuss/improve.

• 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:

•  oneOf:
  

oneOf here is not needed. Previously used enum should be fine.

•    - minimum: 1
  

•      maximum: 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:

•  oneOf:
  

Again, no need for oneof.

•    - minimum: 1
  

•      maximum: 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>;
  

•    };
  

• };

+... diff --git a/Documentation/devicetree/bindings/sound/qcom,wcd937x.yaml b/Documentation/devicetree/bindings/sound/qcom,wcd937x.yaml new file mode 100644 index 000000000000..5c76083691ea --- /dev/null +++ b/Documentation/devicetree/bindings/sound/qcom,wcd937x.yaml @@ -0,0 +1,80 @@ +# 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

I guess VDDPX is not really optional in the hardware is it?

+unevaluatedProperties: false

+examples:

• • |
• codec {

•    compatible = "qcom,wcd9370-codec";
  

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

•    pinctrl-0 = <&wcd_reset_n>;
  

•    pinctrl-1 = <&wcd_reset_n_sleep>;
  

•    reset-gpios = <&tlmm 83 0>;
  

Use defines for common/known flags, like GPIO flags.

•    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>;
  

Just one space goes before = This applies to all places.

•        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>;
  

Best regards, Krzysztof