Re: [RESEND] dt-bindings: soundwire: Convert text file to yaml format

Quoting Srinivasa Rao Mandadapu (2022-10-15 00:54:01)

diff --git a/Documentation/devicetree/bindings/soundwire/qcom,sdw.txt b/Documentation/devicetree/bindings/soundwire/qcom,sdw.txt deleted file mode 100644 index c85c257..0000000 --- a/Documentation/devicetree/bindings/soundwire/qcom,sdw.txt +++ /dev/null @@ -1,214 +0,0 @@

[...]

-- interrupts:

•   Usage: required
  

•   Value type: <prop-encoded-array>
  

•   Definition: should specify the SoundWire Controller core and optional
  

•               wake IRQ
  

-- interrupt-names:

•   Usage: Optional
  

•   Value type: boolean
  

•   Value type: <stringlist>
  

•   Definition: should be "core" for core and "wakeup" for wake interrupt.
  

-- wakeup-source:

This property is removed?

•   Usage: Optional
  

•   Value type: boolean
  

•   Definition: should specify if SoundWire Controller is wake up capable.
  

[...]

diff --git a/Documentation/devicetree/bindings/soundwire/qcom,sdw.yaml b/Documentation/devicetree/bindings/soundwire/qcom,sdw.yaml new file mode 100644 index 0000000..bf8f6c1 --- /dev/null +++ b/Documentation/devicetree/bindings/soundwire/qcom,sdw.yaml @@ -0,0 +1,185 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/soundwire/qcom,sdw.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml#

+title: Qualcomm SoundWire Controller

+maintainers:

[...]

+additionalProperties: false

+examples:

• • |
• #include <dt-bindings/interrupt-controller/arm-gic.h>
• #include <dt-bindings/interrupt-controller/irq.h>
• #include <dt-bindings/clock/qcom,lpassaudiocc-sc7280.h>
• soundwire@3210000 {

•    compatible = "qcom,soundwire-v1.6.0";
  

•    reg = <0x03210000 0x2000>;
  

•    interrupts = <GIC_SPI 155 IRQ_TYPE_LEVEL_HIGH>;
  

•    clocks = <&lpass_rx_macro>;
  

•    clock-names = "iface";
  

•    qcom,din-ports = <0>;
  

•    qcom,dout-ports = <5>;
  

•    resets = <&lpass_audiocc LPASS_AUDIO_SWR_RX_CGCR>;
  

•    reset-names = "swr_audio_cgcr";
  

•    qcom,ports-word-length =        /bits/ 8 <0x01 0x07 0x04 0xff 0xff>;
  

•    qcom,ports-sinterval-low =      /bits/ 8 <0x03 0x3f 0x1f 0x03 0x03>;
  

•    qcom,ports-offset1 =            /bits/ 8 <0x00 0x00 0x0b 0x01 0x01>;
  

•    qcom,ports-offset2 =            /bits/ 8 <0x00 0x00 0x0b 0x00 0x00>;
  

•    qcom,ports-lane-control =       /bits/ 8 <0x01 0x00 0x00 0x00 0x00>;
  

•    qcom,ports-block-pack-mode =    /bits/ 8 <0xff 0x00 0x01 0xff 0xff>;
  

•    qcom,ports-hstart =             /bits/ 8 <0xff 0x03 0xff 0xff 0xff>;
  

•    qcom,ports-hstop =              /bits/ 8 <0xff 0x06 0xff 0xff 0xff>;
  

•    qcom,ports-block-group-count =  /bits/ 8 <0xff 0xff 0xff 0xff 0x00>;
  

•    #sound-dai-cells = <1>;
  

•    #address-cells = <2>;
  

•    #size-cells = <0>;
  

•    status = "disabled";
  

Please omit status from the example.