devicetree.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
From: Songjun Wu <songjun.wu@atmel.com>
To: nicolas.ferre@atmel.com, lgirdwood@gmail.com, broonie@kernel.org,
	perex@perex.cz, tiwai@suse.com, linux-kernel@vger.kernel.org,
	alsa-devel@alsa-project.org, robh+dt@kernel.org,
	pawel.moll@arm.com, mark.rutland@arm.com,
	ijc+devicetree@hellion.org.uk, galak@codeaurora.org,
	devicetree@vger.kernel.org
Cc: Songjun Wu <songjun.wu@atmel.com>
Subject: [PATCH 2/2] ASoC: atmel-classd: DT binding for Class D audio amplifier driver
Date: Tue, 1 Sep 2015 13:41:41 +0800	[thread overview]
Message-ID: <1441086101-15303-3-git-send-email-songjun.wu@atmel.com> (raw)
In-Reply-To: <1441086101-15303-1-git-send-email-songjun.wu@atmel.com>

DT binding documentation for this new ASoC driver.

Signed-off-by: Songjun Wu <songjun.wu@atmel.com>
---
 .../devicetree/bindings/sound/atmel-classd.txt     |   73 ++++++++++++++++++++
 1 file changed, 73 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/sound/atmel-classd.txt

diff --git a/Documentation/devicetree/bindings/sound/atmel-classd.txt b/Documentation/devicetree/bindings/sound/atmel-classd.txt
new file mode 100644
index 0000000..29d181a
--- /dev/null
+++ b/Documentation/devicetree/bindings/sound/atmel-classd.txt
@@ -0,0 +1,73 @@
+* Atmel ClassD driver under ALSA SoC architecture
+
+* Atmel ClassD driver
+Required properties:
+- compatible
+	Should be "atmel,sama5d2-classd".
+- reg
+	Should contain ClassD registers location and length.
+- interrupts
+	Should contain the IRQ line for the ClassD.
+- dmas
+	One DMA specifiers as described in atmel-dma.txt and dma.txt files.
+- dma-names
+	Must be "tx".
+- clock-names
+	tuple listing input clock names.
+	Required elements: "pclk", "gclk" and "aclk".
+- clocks
+	phandles to input clocks.
+
+Optional properties:
+- pinctrl-names, pinctrl-0
+	Please refer to pinctrl-bindings.txt.
+- atmel,pwm-type
+	PWM modulation type, "single" or "diff".
+- atmel,non-overlap-time
+	Set non-overlapping time, the unit is nanosecond(ns).
+	There are four values,
+	<5>, <10>, <15>, <20>, the default value is <10>.
+	Non-overlapping will be disabled if not specified.
+
+Example:
+classd: classd@fc048000 {
+		compatible = "atmel,sama5d2-classd";
+		reg = <0xfc048000 0x100>;
+		interrupts = <59 IRQ_TYPE_LEVEL_HIGH 7>;
+		dmas = <&dma0
+			(AT91_XDMAC_DT_MEM_IF(0) | AT91_XDMAC_DT_PER_IF(1)
+			| AT91_XDMAC_DT_PERID(47))>;
+		dma-names = "tx";
+		clocks = <&classd_clk>, <&classd_gclk>, <&audio_pll_pmc>;
+		clock-names = "pclk", "gclk", "aclk";
+
+		pinctrl-names = "default";
+		pinctrl-0 = <&pinctrl_classd_default>;
+		atmel,pwm-type = "diff";
+		atmel,non-overlap-time = <10>;
+};
+
+
+* Atmel ASoC driver with ClassD
+Required properties:
+- compatible
+	Should be "atmel,asoc-classd".
+- atmel,model
+	The user-visible name of this sound complex.
+- atmel,audio-platform
+	Should be <&classd>.
+- atmel,audio-cpu-dai-name
+	The name of the CPU DAI in ALSA SoC architecture.
+	The format is <classd registers location>.classd.
+- atmel,audio-codec
+	Should be <&classd>.
+
+Example:
+sound {
+		compatible = "atmel,asoc-classd";
+
+		atmel,model = "classd @ SAMA5D2-Xplained";
+		atmel,audio-platform = <&classd>;
+		atmel,audio-cpu-dai-name = "fc048000.classd";
+		atmel,audio-codec = <&classd>;
+};
-- 
1.7.9.5

  parent reply	other threads:[~2015-09-01  5:41 UTC|newest]

Thread overview: 22+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2015-09-01  5:41 [PATCH 0/2] ASoC: atmel-classd: add the Audio Class D Amplifier Songjun Wu
     [not found] ` <1441086101-15303-1-git-send-email-songjun.wu-AIFe0yeh4nAAvxtiuMwx3w@public.gmane.org>
2015-09-01  5:41   ` [PATCH 1/2] ASoC: atmel-classd: add the Audio Class D Amplifier code Songjun Wu
     [not found]     ` <1441086101-15303-2-git-send-email-songjun.wu-AIFe0yeh4nAAvxtiuMwx3w@public.gmane.org>
2015-09-03 11:37       ` Mark Brown
     [not found]         ` <20150903113716.GU12027-GFdadSzt00ze9xe1eoZjHA@public.gmane.org>
2015-09-06  9:44           ` Wu, Songjun
2015-09-07 16:23             ` Mark Brown
2015-09-08  9:36               ` Wu, Songjun
     [not found]                 ` <55EEAC01.3080409-AIFe0yeh4nAAvxtiuMwx3w@public.gmane.org>
2015-09-08 12:23                   ` Mark Brown
     [not found]                     ` <20150908122322.GB9751-GFdadSzt00ze9xe1eoZjHA@public.gmane.org>
2015-09-09  3:16                       ` Wu, Songjun
     [not found]                         ` <55EFA478.1000109-AIFe0yeh4nAAvxtiuMwx3w@public.gmane.org>
2015-09-09  9:52                           ` Mark Brown
2015-09-10  2:31                             ` Wu, Songjun
     [not found]                               ` <55F0EB68.9070800-AIFe0yeh4nAAvxtiuMwx3w@public.gmane.org>
2015-09-11 10:34                                 ` Mark Brown
     [not found]                                   ` <20150911103417.GF12027-GFdadSzt00ze9xe1eoZjHA@public.gmane.org>
2015-09-14  6:34                                     ` Wu, Songjun
2015-09-01  5:41 ` Songjun Wu [this message]
     [not found]   ` <1441086101-15303-3-git-send-email-songjun.wu-AIFe0yeh4nAAvxtiuMwx3w@public.gmane.org>
2015-09-03 11:43     ` [PATCH 2/2] ASoC: atmel-classd: DT binding for Class D audio amplifier driver Mark Brown
     [not found]       ` <20150903114316.GV12027-GFdadSzt00ze9xe1eoZjHA@public.gmane.org>
2015-09-06  9:44         ` Wu, Songjun
2015-09-07 16:25           ` Mark Brown
2015-09-08  9:36             ` Wu, Songjun
2015-09-08 12:23               ` Mark Brown
     [not found]                 ` <20150908122340.GC9751-GFdadSzt00ze9xe1eoZjHA@public.gmane.org>
2015-09-09  3:16                   ` Wu, Songjun
2015-09-15  3:11                   ` Wu, Songjun
     [not found]                     ` <55F78C79.30102-AIFe0yeh4nAAvxtiuMwx3w@public.gmane.org>
2015-09-16 19:42                       ` Mark Brown
     [not found]                         ` <20150916194234.GR12027-GFdadSzt00ze9xe1eoZjHA@public.gmane.org>
2015-09-17  3:07                           ` Wu, Songjun

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=1441086101-15303-3-git-send-email-songjun.wu@atmel.com \
    --to=songjun.wu@atmel.com \
    --cc=alsa-devel@alsa-project.org \
    --cc=broonie@kernel.org \
    --cc=devicetree@vger.kernel.org \
    --cc=galak@codeaurora.org \
    --cc=ijc+devicetree@hellion.org.uk \
    --cc=lgirdwood@gmail.com \
    --cc=linux-kernel@vger.kernel.org \
    --cc=mark.rutland@arm.com \
    --cc=nicolas.ferre@atmel.com \
    --cc=pawel.moll@arm.com \
    --cc=perex@perex.cz \
    --cc=robh+dt@kernel.org \
    --cc=tiwai@suse.com \
    /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 a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).