Unverified Commit 125b7492 authored by Lukasz Majewski's avatar Lukasz Majewski Committed by Mark Brown
Browse files

ASoC: dt-bindings: Convert mxs-saif.txt to fsl,saif.yaml (imx28 saif) 



The 'fsl,imx28-saif' compatible has already the mxs-saif.txt description.
This patch converts (and removes it) this file to fsl,saif.yaml (to follow
current fsl convention).

Changes for the mxs-saif.txt:
- Adds 'clocks', '#clock-cells' and '#sound-dai-cells' properties
- Provide device description

Signed-off-by: default avatarLukasz Majewski <lukma@denx.de>
Reviewed-by: default avatarKrzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Link: https://patch.msgid.link/20240828092709.2626359-1-lukma@denx.de


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

Documentation/devicetree/bindings/sound/fsl,saif.yaml

0 → 100644
+83 −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/fsl,saif.yaml#

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



title: Freescale MXS Serial Audio Interface (SAIF)



maintainers:

  - Lukasz Majewski <lukma@denx.de>



allOf:

  - $ref: dai-common.yaml#



description:

  The SAIF is based on I2S module that is used to communicate with audio codecs,

  but only with half-duplex manner (i.e. it can either transmit or receive PCM

  audio).



properties:

  compatible:

    const: fsl,imx28-saif



  reg:

    maxItems: 1



  "#sound-dai-cells":

    const: 0



  interrupts:

    maxItems: 1



  dmas:

    maxItems: 1



  dma-names:

    const: rx-tx



  "#clock-cells":

    description: Configure the I2S device as MCLK clock provider.

    const: 0



  clocks:

    maxItems: 1



  fsl,saif-master:

    description: Indicate that saif is a slave and its phandle points to master

    $ref: /schemas/types.yaml#/definitions/phandle



required:

  - compatible

  - reg

  - "#sound-dai-cells"

  - interrupts

  - dmas

  - dma-names

  - clocks



unevaluatedProperties: false



examples:

  - |

    saif0: saif@80042000 {

        compatible = "fsl,imx28-saif";

        reg = <0x80042000 2000>;

        #sound-dai-cells = <0>;

        interrupts = <59>;

        dmas = <&dma_apbx 4>;

        dma-names = "rx-tx";

        #clock-cells = <0>;

        clocks = <&clks 53>;

    };

  - |

    saif1: saif@80046000 {

        compatible = "fsl,imx28-saif";

        reg = <0x80046000 2000>;

        #sound-dai-cells = <0>;

        interrupts = <58>;

        dmas = <&dma_apbx 5>;

        dma-names = "rx-tx";

        clocks = <&clks 53>;

        fsl,saif-master = <&saif0>;

    };

Documentation/devicetree/bindings/sound/mxs-saif.txt

deleted100644 → 0
+0 −41
Original line number Diff line number Diff line 
* Freescale MXS Serial Audio Interface (SAIF)



Required properties:

- compatible: Should be "fsl,<chip>-saif"

- reg: Should contain registers location and length

- interrupts: Should contain ERROR interrupt number

- dmas: DMA specifier, consisting of a phandle to DMA controller node

  and SAIF DMA channel ID.

  Refer to dma.txt and fsl-mxs-dma.txt for details.

- dma-names: Must be "rx-tx".



Optional properties:

- fsl,saif-master: phandle to the master SAIF.  It's only required for

  the slave SAIF.



Note: Each SAIF controller should have an alias correctly numbered

in "aliases" node.



Example:



aliases {

	saif0 = &saif0;

	saif1 = &saif1;

};



saif0: saif@80042000 {

	compatible = "fsl,imx28-saif";

	reg = <0x80042000 2000>;

	interrupts = <59>;

	dmas = <&dma_apbx 4>;

	dma-names = "rx-tx";

};



saif1: saif@80046000 {

	compatible = "fsl,imx28-saif";

	reg = <0x80046000 2000>;

	interrupts = <58>;

	dmas = <&dma_apbx 5>;

	dma-names = "rx-tx";

	fsl,saif-master = <&saif0>;

};