All of lore.kernel.org
 help / color / mirror / Atom feed
From: Rob Herring <robh-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org>
To: olivier moysan <olivier.moysan-qxv4g6HH51o@public.gmane.org>
Cc: lgirdwood-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org,
	broonie-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org,
	perex-/Fr2/VpizcU@public.gmane.org,
	tiwai-IBi9RG/b67k@public.gmane.org,
	mcoquelin.stm32-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org,
	alexandre.torgue-qxv4g6HH51o@public.gmane.org,
	alsa-devel-K7yf7f+aM1XWsZ/bQMPhNw@public.gmane.org,
	mark.rutland-5wv7dgnIgG8@public.gmane.org,
	devicetree-u79uwXL29TY76Z2rM5mHXA@public.gmane.org,
	linux-arm-kernel-IAPFreCvJWM7uuMidbF8XUB+6BGkLq7r@public.gmane.org,
	arnaud.pouliquen-qxv4g6HH51o@public.gmane.org
Subject: Re: [RESEND PATCH v2 1/2] ASoC: stm32: add bindings for SAI
Date: Wed, 15 Mar 2017 12:46:06 -0500	[thread overview]
Message-ID: <20170315174606.rrvhuuzplzwwucph@rob-hp-laptop> (raw)
In-Reply-To: <1488879872-7839-2-git-send-email-olivier.moysan-qxv4g6HH51o@public.gmane.org>

On Tue, Mar 07, 2017 at 10:44:31AM +0100, olivier moysan wrote:
> This patch adds documentation of device tree bindings for the
> STM32 SAI ASoC driver.
> 
> Signed-off-by: olivier moysan <olivier.moysan-qxv4g6HH51o@public.gmane.org>
> ---
>  .../devicetree/bindings/sound/st,stm32-sai.txt     | 79 ++++++++++++++++++++++
>  1 file changed, 79 insertions(+)
>  create mode 100644 Documentation/devicetree/bindings/sound/st,stm32-sai.txt
> 
> diff --git a/Documentation/devicetree/bindings/sound/st,stm32-sai.txt b/Documentation/devicetree/bindings/sound/st,stm32-sai.txt
> new file mode 100644
> index 0000000..b3be26d
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/sound/st,stm32-sai.txt
> @@ -0,0 +1,79 @@
> +STMicroelectronics STM32 Serial Audio Interface (SAI).
> +
> +The SAI interface (Serial Audio Interface) offers a wide set of audio protocols
> +as I2S standards, LSB or MSB-justified, PCM/DSP, TDM, and AC'97.
> +The SAI contains two independent audio sub-blocks. Each sub-block has
> +its own clock generator and I/O lines controller.
> +
> +Required properties:
> +  - compatible: Should be "st,stm32f4-sai"
> +  - reg: Base address and size of SAI common register set.
> +  - clocks: Must contain phandle and clock specifier pairs for each entry
> +	in clock-names.
> +  - clock-names: Must contain "clk_x8k" and "clk_x11k"
> +	"clk_x8k": SAI parent clock for sampling rates multiple of 8kHz.
> +	"clk_x11k": SAI parent clock for sampling rates multiple of 11.025kHz.

clk_ is redundant.

> +  - interrupts: cpu DAI interrupt line shared by SAI sub-blocks
> +
> +Note: Each SAI controller should have an alias correctly numbered
> +in "aliases" node, to provide explicit name to CPU DAI.

No, it shouldn't. Why do you need that?


> +
> +Optional properties:
> +  - resets: Reference to a reset controller asserting the SAI
> +
> +SAI subnodes:
> +Two subnodes corresponding to SAI sub-block instances A et B can be defined.
> +Subnode can be omitted for unsused sub-block.
> +
> +SAI subnodes required properties:
> +  - compatible: Should be "st,stm32-sai-sub-a" or "st,stm32-sai-sub-b"
> +	for SAI sub-block A or B respectively.
> +  - reg: Base address and size of SAI sub-block register set.
> +  - clocks: Must contain one phandle and clock specifier pair
> +	for sai_ck which feeds the internal clock generator.
> +  - clock-names: Must contain "sai_ck".
> +  - dmas: see Documentation/devicetree/bindings/dma/stm32-dma.txt
> +  - dma-names: identifier string for each DMA request line
> +	"tx": if sai sub-block is configured as playback DAI
> +	"rx": if sai sub-block is configured as capture DAI
> +  - pinctrl-names: should contain only value "default"
> +  - pinctrl-0: see Documentation/devicetree/bindings/pinctrl/pinctrl-stm32.txt
> +
> +Example:
> +sai1: sai1@40015800 {
> +	compatible = "st,stm32f4-sai";
> +	reg = <0x40015800 0x400>;
> +	clocks = <&rcc 1 CLK_SAIQ_PDIV>, <&rcc 1 CLK_I2SQ_PDIV>;
> +	clock-names = "clk_x8k", "clk_x11k";
> +	interrupts = <87>;
> +	resets = <&rcc 310>;
> +
> +	sai1b: sai@1 {

unit address needs a reg property.

audio-controller@1

> +		#sound-dai-cells = <0>;
> +		compatible = "st,stm32-sai-sub-b";
> +		clocks = <&rcc 1 CLK_SAI2>;
> +		clock-names = "sai_ck";
> +		dmas = <&dma2 5 0 0x400 0x1>;
> +		dma-names = "tx";
> +	};
> +};
> +
> +sound {
> +	compatible = "simple-audio-card";

Perhaps you want to use the graph-card here. It's getting close to 
merging.

> +	simple-audio-card,name = "STM32-Sound-Card";
> +	status = "okay";
> +
> +	simple-audio-card,dai-link@0 {
> +		format = "i2s";
> +		cpu {
> +			sound-dai = <&sai1b>;
> +		};
> +		codec {
> +			sound-dai = <&codec>;
> +		};
> +	};
> +};
> +
> +aliases {
> +	sai1 = &sai1;
> +};
> -- 
> 1.9.1
> 
--
To unsubscribe from this list: send the line "unsubscribe devicetree" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

WARNING: multiple messages have this Message-ID (diff)
From: robh@kernel.org (Rob Herring)
To: linux-arm-kernel@lists.infradead.org
Subject: [RESEND PATCH v2 1/2] ASoC: stm32: add bindings for SAI
Date: Wed, 15 Mar 2017 12:46:06 -0500	[thread overview]
Message-ID: <20170315174606.rrvhuuzplzwwucph@rob-hp-laptop> (raw)
In-Reply-To: <1488879872-7839-2-git-send-email-olivier.moysan@st.com>

On Tue, Mar 07, 2017 at 10:44:31AM +0100, olivier moysan wrote:
> This patch adds documentation of device tree bindings for the
> STM32 SAI ASoC driver.
> 
> Signed-off-by: olivier moysan <olivier.moysan@st.com>
> ---
>  .../devicetree/bindings/sound/st,stm32-sai.txt     | 79 ++++++++++++++++++++++
>  1 file changed, 79 insertions(+)
>  create mode 100644 Documentation/devicetree/bindings/sound/st,stm32-sai.txt
> 
> diff --git a/Documentation/devicetree/bindings/sound/st,stm32-sai.txt b/Documentation/devicetree/bindings/sound/st,stm32-sai.txt
> new file mode 100644
> index 0000000..b3be26d
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/sound/st,stm32-sai.txt
> @@ -0,0 +1,79 @@
> +STMicroelectronics STM32 Serial Audio Interface (SAI).
> +
> +The SAI interface (Serial Audio Interface) offers a wide set of audio protocols
> +as I2S standards, LSB or MSB-justified, PCM/DSP, TDM, and AC'97.
> +The SAI contains two independent audio sub-blocks. Each sub-block has
> +its own clock generator and I/O lines controller.
> +
> +Required properties:
> +  - compatible: Should be "st,stm32f4-sai"
> +  - reg: Base address and size of SAI common register set.
> +  - clocks: Must contain phandle and clock specifier pairs for each entry
> +	in clock-names.
> +  - clock-names: Must contain "clk_x8k" and "clk_x11k"
> +	"clk_x8k": SAI parent clock for sampling rates multiple of 8kHz.
> +	"clk_x11k": SAI parent clock for sampling rates multiple of 11.025kHz.

clk_ is redundant.

> +  - interrupts: cpu DAI interrupt line shared by SAI sub-blocks
> +
> +Note: Each SAI controller should have an alias correctly numbered
> +in "aliases" node, to provide explicit name to CPU DAI.

No, it shouldn't. Why do you need that?


> +
> +Optional properties:
> +  - resets: Reference to a reset controller asserting the SAI
> +
> +SAI subnodes:
> +Two subnodes corresponding to SAI sub-block instances A et B can be defined.
> +Subnode can be omitted for unsused sub-block.
> +
> +SAI subnodes required properties:
> +  - compatible: Should be "st,stm32-sai-sub-a" or "st,stm32-sai-sub-b"
> +	for SAI sub-block A or B respectively.
> +  - reg: Base address and size of SAI sub-block register set.
> +  - clocks: Must contain one phandle and clock specifier pair
> +	for sai_ck which feeds the internal clock generator.
> +  - clock-names: Must contain "sai_ck".
> +  - dmas: see Documentation/devicetree/bindings/dma/stm32-dma.txt
> +  - dma-names: identifier string for each DMA request line
> +	"tx": if sai sub-block is configured as playback DAI
> +	"rx": if sai sub-block is configured as capture DAI
> +  - pinctrl-names: should contain only value "default"
> +  - pinctrl-0: see Documentation/devicetree/bindings/pinctrl/pinctrl-stm32.txt
> +
> +Example:
> +sai1: sai1 at 40015800 {
> +	compatible = "st,stm32f4-sai";
> +	reg = <0x40015800 0x400>;
> +	clocks = <&rcc 1 CLK_SAIQ_PDIV>, <&rcc 1 CLK_I2SQ_PDIV>;
> +	clock-names = "clk_x8k", "clk_x11k";
> +	interrupts = <87>;
> +	resets = <&rcc 310>;
> +
> +	sai1b: sai at 1 {

unit address needs a reg property.

audio-controller at 1

> +		#sound-dai-cells = <0>;
> +		compatible = "st,stm32-sai-sub-b";
> +		clocks = <&rcc 1 CLK_SAI2>;
> +		clock-names = "sai_ck";
> +		dmas = <&dma2 5 0 0x400 0x1>;
> +		dma-names = "tx";
> +	};
> +};
> +
> +sound {
> +	compatible = "simple-audio-card";

Perhaps you want to use the graph-card here. It's getting close to 
merging.

> +	simple-audio-card,name = "STM32-Sound-Card";
> +	status = "okay";
> +
> +	simple-audio-card,dai-link at 0 {
> +		format = "i2s";
> +		cpu {
> +			sound-dai = <&sai1b>;
> +		};
> +		codec {
> +			sound-dai = <&codec>;
> +		};
> +	};
> +};
> +
> +aliases {
> +	sai1 = &sai1;
> +};
> -- 
> 1.9.1
> 

  parent reply	other threads:[~2017-03-15 17:46 UTC|newest]

Thread overview: 14+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2017-03-07  9:44 [RESEND PATCH v2 0/2] Add STM32 SAI support olivier moysan
2017-03-07  9:44 ` olivier moysan
2017-03-07  9:44 ` [RESEND PATCH v2 1/2] ASoC: stm32: add bindings for SAI olivier moysan
2017-03-07  9:44   ` olivier moysan
     [not found]   ` <1488879872-7839-2-git-send-email-olivier.moysan-qxv4g6HH51o@public.gmane.org>
2017-03-15 17:46     ` Rob Herring [this message]
2017-03-15 17:46       ` Rob Herring
2017-03-16 10:50       ` Olivier MOYSAN
2017-03-16 10:50         ` Olivier MOYSAN
2017-03-18 20:43         ` Rob Herring
2017-03-18 20:43           ` Rob Herring
2017-03-07  9:44 ` [RESEND PATCH v2 2/2] ASoC: stm32: add SAI driver olivier moysan
2017-03-07  9:44   ` olivier moysan
     [not found] <f6a9354e-dbab-f485-c763-21c8e3af3d62@st.com>
2017-03-21 10:31 ` [RESEND PATCH v2 1/2] ASoC: stm32: add bindings for SAI Olivier MOYSAN
2017-03-21 10:31   ` Olivier MOYSAN

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20170315174606.rrvhuuzplzwwucph@rob-hp-laptop \
    --to=robh-dgejt+ai2ygdnm+yrofe0a@public.gmane.org \
    --cc=alexandre.torgue-qxv4g6HH51o@public.gmane.org \
    --cc=alsa-devel-K7yf7f+aM1XWsZ/bQMPhNw@public.gmane.org \
    --cc=arnaud.pouliquen-qxv4g6HH51o@public.gmane.org \
    --cc=broonie-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org \
    --cc=devicetree-u79uwXL29TY76Z2rM5mHXA@public.gmane.org \
    --cc=lgirdwood-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org \
    --cc=linux-arm-kernel-IAPFreCvJWM7uuMidbF8XUB+6BGkLq7r@public.gmane.org \
    --cc=mark.rutland-5wv7dgnIgG8@public.gmane.org \
    --cc=mcoquelin.stm32-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org \
    --cc=olivier.moysan-qxv4g6HH51o@public.gmane.org \
    --cc=perex-/Fr2/VpizcU@public.gmane.org \
    --cc=tiwai-IBi9RG/b67k@public.gmane.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.