Unverified Commit 9032cdd9 authored by Olivier Moysan's avatar Olivier Moysan Committed by Mark Brown
Browse files

ASoC: dt-bindings: stm32: convert spdfirx to json-schema



Convert the STM32 SPDIFRX bindings to DT schema format using json-schema.

Signed-off-by: default avatarOlivier Moysan <olivier.moysan@st.com>
Reviewed-by: default avatarRob Herring <robh@kernel.org>
Link: https://lore.kernel.org/r/20200117170352.16040-1-olivier.moysan@st.com


Signed-off-by: default avatarMark Brown <broonie@kernel.org>
parent 103ae955
Loading
Loading
Loading
Loading
+0 −56
Original line number Diff line number Diff line
STMicroelectronics STM32 S/PDIF receiver (SPDIFRX).

The SPDIFRX peripheral, is designed to receive an S/PDIF flow compliant with
IEC-60958 and IEC-61937.

Required properties:
  - compatible: should be "st,stm32h7-spdifrx"
  - reg: cpu DAI IP base address and size
  - clocks: must contain an entry for kclk (used as S/PDIF signal reference)
  - clock-names: must contain "kclk"
  - interrupts: cpu DAI interrupt line
  - dmas: DMA specifiers for audio data DMA and iec control flow DMA
    See STM32 DMA bindings, Documentation/devicetree/bindings/dma/stm32-dma.txt
  - dma-names: two dmas have to be defined, "rx" and "rx-ctrl"

Optional properties:
  - resets: Reference to a reset controller asserting the SPDIFRX

The device node should contain one 'port' child node with one child 'endpoint'
node, according to the bindings defined in Documentation/devicetree/bindings/
graph.txt.

Example:
spdifrx: spdifrx@40004000 {
	compatible = "st,stm32h7-spdifrx";
	reg = <0x40004000 0x400>;
	clocks = <&rcc SPDIFRX_CK>;
	clock-names = "kclk";
	interrupts = <97>;
	dmas = <&dmamux1 2 93 0x400 0x0>,
	       <&dmamux1 3 94 0x400 0x0>;
	dma-names = "rx", "rx-ctrl";
	pinctrl-0 = <&spdifrx_pins>;
	pinctrl-names = "default";

	spdifrx_port: port {
		cpu_endpoint: endpoint {
			remote-endpoint = <&codec_endpoint>;
		};
	};
};

spdif_in: spdif-in {
	compatible = "linux,spdif-dir";

	codec_port: port {
		codec_endpoint: endpoint {
			remote-endpoint = <&cpu_endpoint>;
		};
	};
};

soundcard {
	compatible = "audio-graph-card";
	dais = <&spdifrx_port>;
};
+80 −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/st,stm32-spdifrx.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: STMicroelectronics STM32 S/PDIF receiver (SPDIFRX)

maintainers:
  - Olivier Moysan <olivier.moysan@st.com>

description: |
  The SPDIFRX peripheral, is designed to receive an S/PDIF flow compliant with
  IEC-60958 and IEC-61937.

properties:
  compatible:
    enum:
      - st,stm32h7-spdifrx

  "#sound-dai-cells":
    const: 0

  reg:
    maxItems: 1

  clocks:
    maxItems: 1

  clock-names:
    items:
      - const: kclk

  interrupts:
    maxItems: 1

  dmas:
    items:
      - description: audio data capture DMA
      - description: IEC status bits capture DMA

  dma-names:
    items:
      - const: rx
      - const: rx-ctrl

  resets:
    maxItems: 1

required:
  - compatible
  - "#sound-dai-cells"
  - reg
  - clocks
  - clock-names
  - interrupts
  - dmas
  - dma-names

additionalProperties: false

examples:
  - |
    #include <dt-bindings/interrupt-controller/arm-gic.h>
    #include <dt-bindings/clock/stm32mp1-clks.h>
    spdifrx: spdifrx@40004000 {
        compatible = "st,stm32h7-spdifrx";
        #sound-dai-cells = <0>;
        reg = <0x40004000 0x400>;
        clocks = <&rcc SPDIF_K>;
        clock-names = "kclk";
        interrupts = <GIC_SPI 97 IRQ_TYPE_LEVEL_HIGH>;
        dmas = <&dmamux1 2 93 0x400 0x0>,
               <&dmamux1 3 94 0x400 0x0>;
        dma-names = "rx", "rx-ctrl";
        pinctrl-0 = <&spdifrx_pins>;
        pinctrl-names = "default";
    };

...