From patchwork Tue Dec 17 03:24:41 2013
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
X-Patchwork-Submitter: Xiubo Li
X-Patchwork-Id: 3358761
Return-Path:
X-Original-To: patchwork-linux-arm@patchwork.kernel.org
Delivered-To: patchwork-parsemail@patchwork2.web.kernel.org
Received: from mail.kernel.org (mail.kernel.org [198.145.19.201])
by patchwork2.web.kernel.org (Postfix) with ESMTP id CD93EC0D4A
for ;
Tue, 17 Dec 2013 04:20:05 +0000 (UTC)
Received: from mail.kernel.org (localhost [127.0.0.1])
by mail.kernel.org (Postfix) with ESMTP id EE39F2035C
for ;
Tue, 17 Dec 2013 04:20:04 +0000 (UTC)
Received: from casper.infradead.org (casper.infradead.org [85.118.1.10])
(using TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384 (256/256 bits))
(No client certificate requested)
by mail.kernel.org (Postfix) with ESMTPS id EC4382034F
for ;
Tue, 17 Dec 2013 04:20:03 +0000 (UTC)
Received: from merlin.infradead.org ([2001:4978:20e::2])
by casper.infradead.org with esmtps (Exim 4.80.1 #2 (Red Hat Linux))
id 1Vsm77-0004pI-Av; Tue, 17 Dec 2013 04:18:34 +0000
Received: from localhost ([::1] helo=merlin.infradead.org)
by merlin.infradead.org with esmtp (Exim 4.80.1 #2 (Red Hat Linux))
id 1Vsm6h-0007uv-5U; Tue, 17 Dec 2013 04:18:07 +0000
Received: from co9ehsobe001.messaging.microsoft.com ([207.46.163.24]
helo=co9outboundpool.messaging.microsoft.com)
by merlin.infradead.org with esmtps (Exim 4.80.1 #2 (Red Hat Linux))
id 1Vsm65-0007ng-2E for linux-arm-kernel@lists.infradead.org;
Tue, 17 Dec 2013 04:17:32 +0000
Received: from mail119-co9-R.bigfish.com (10.236.132.247) by
CO9EHSOBE032.bigfish.com (10.236.130.95) with Microsoft SMTP Server
id 14.1.225.22; Tue, 17 Dec 2013 04:17:07 +0000
Received: from mail119-co9 (localhost [127.0.0.1]) by
mail119-co9-R.bigfish.com (Postfix) with ESMTP id 365CE7002E1;
Tue, 17 Dec 2013 04:17:07 +0000 (UTC)
X-Forefront-Antispam-Report: CIP:70.37.183.190; KIP:(null); UIP:(null);
IPV:NLI;
H:mail.freescale.net; RD:none; EFVD:NLI
X-SpamScore: 0
X-BigFish:
VS0(zzzz1f42h2148h208ch1ee6h1de0h1fdah2073h2146h1202h1e76h2189h1d1ah1d2ah1fc6hzz1de098h8275bh1de097hz2dh2a8h839he5bhf0ah1288h12a5h12a9h12bdh12e5h137ah139eh13b6h1441h1504h1537h162dh1631h1758h1898h18e1h1946h19b5h1ad9h1b0ah1b2fh2222h224fh1fb3h1d0ch1d2eh1d3fh1dfeh1dffh1e23h1fe8h1ff5h2218h2216h226dh22d0h2327h2336h1155h)
Received: from mail119-co9 (localhost.localdomain [127.0.0.1]) by mail119-co9
(MessageSwitch) id 1387253824805134_13876;
Tue, 17 Dec 2013 04:17:04 +0000 (UTC)
Received: from CO9EHSMHS027.bigfish.com (unknown [10.236.132.244]) by
mail119-co9.bigfish.com (Postfix) with ESMTP id B02666A0048;
Tue, 17 Dec 2013 04:17:04 +0000 (UTC)
Received: from mail.freescale.net (70.37.183.190) by CO9EHSMHS027.bigfish.com
(10.236.130.37) with Microsoft SMTP Server (TLS) id 14.16.227.3;
Tue, 17 Dec 2013 04:17:04 +0000
Received: from tx30smr01.am.freescale.net (10.81.153.31) by
039-SN1MMR1-003.039d.mgd.msft.net (10.84.1.16) with Microsoft SMTP
Server (TLS) id 14.3.158.2; Tue, 17 Dec 2013 04:17:03 +0000
Received: from rock.am.freescale.net (rock.ap.freescale.net [10.193.20.106])
by tx30smr01.am.freescale.net (8.14.3/8.14.0) with ESMTP id
rBH4GBtp003092; Mon, 16 Dec 2013 21:16:56 -0700
From: Xiubo Li
To: , , ,
Subject: [PATCHv3 4/7] Documentation: Add device tree bindings for Freescale
SAI.
Date: Tue, 17 Dec 2013 11:24:41 +0800
Message-ID: <1387250684-23406-5-git-send-email-Li.Xiubo@freescale.com>
X-Mailer: git-send-email 1.8.0
In-Reply-To: <1387250684-23406-1-git-send-email-Li.Xiubo@freescale.com>
References: <1387250684-23406-1-git-send-email-Li.Xiubo@freescale.com>
MIME-Version: 1.0
X-OriginatorOrg: freescale.com
X-FOPE-CONNECTOR: Id%0$Dn%*$RO%0$TLS%0$FQDN%$TlsDn%
X-FOPE-CONNECTOR:
Id%0$Dn%FREESCALE.MAIL.ONMICROSOFT.COM$RO%1$TLS%0$FQDN%$TlsDn%
X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3
X-CRM114-CacheID: sfid-20131216_231729_348361_A4FAD413
X-CRM114-Status: UNSURE ( 8.92 )
X-CRM114-Notice: Please train this message.
X-Spam-Score: -2.9 (--)
Cc: mark.rutland@arm.com, fabio.estevam@freescale.com,
alsa-devel@alsa-project.org, linux@arm.linux.org.uk,
ian.campbell@citrix.com,
pawel.moll@arm.com, swarren@wwwdotorg.org, tiwai@suse.de,
b42378@freescale.com,
b18965@freescale.com, linux-kernel@vger.kernel.org,
rob.herring@calxeda.com,
linux-doc@vger.kernel.org, grant.likely@linaro.org,
devicetree@vger.kernel.org,
linux-arm-kernel@lists.infradead.org, rob@landley.net,
r64188@freescale.com,
shawn.guo@linaro.org, oskar@scara.com, LW@KARO-electronics.de
X-BeenThere: linux-arm-kernel@lists.infradead.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id:
List-Unsubscribe:
,
List-Archive:
List-Post:
List-Help:
List-Subscribe:
,
Sender: "linux-arm-kernel"
Errors-To:
linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org
X-Spam-Status: No, score=-2.0 required=5.0 tests=BAYES_00, RCVD_IN_DNSWL_MED,
RP_MATCHES_RCVD,UNPARSEABLE_RELAY,UNRESOLVED_TEMPLATE,URIBL_RHS_DOB
autolearn=unavailable version=3.3.1
X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on mail.kernel.org
X-Virus-Scanned: ClamAV using ClamSMTP
This adds the Document for Freescale SAI driver under
Documentation/devicetree/bindings/sound/.
Signed-off-by: Xiubo Li
---
.../devicetree/bindings/sound/fsl-sai.txt | 40 ++++++++++++++++++++++
1 file changed, 40 insertions(+)
create mode 100644 Documentation/devicetree/bindings/sound/fsl-sai.txt
diff --git a/Documentation/devicetree/bindings/sound/fsl-sai.txt b/Documentation/devicetree/bindings/sound/fsl-sai.txt
new file mode 100644
index 0000000..ca49ad1
--- /dev/null
+++ b/Documentation/devicetree/bindings/sound/fsl-sai.txt
@@ -0,0 +1,40 @@
+Freescale Synchronous Audio Interface (SAI).
+
+The SAI is based on I2S module that used communicating with audio codecs,
+which provides a synchronous audio interface that supports fullduplex
+serial interfaces with frame synchronization such as I2S, AC97, TDM, and
+codec/DSP interfaces.
+
+
+Required properties:
+- compatible: Compatible list, contains "fsl,vf610-sai".
+- reg: Offset and length of the register set for the device.
+- clocks: Must contain an entry for each entry in clock-names.
+- clock-names : Must include the "sai" entry.
+- dmas : Generic dma devicetree binding as described in
+ Documentation/devicetree/bindings/dma/dma.txt.
+- dma-names : Two dmas have to be defined, "tx" and "rx".
+- pinctrl-names: Must contain a "default" entry.
+- pinctrl-NNN: One property must exist for each entry in pinctrl-names.
+ See ../pinctrl/pinctrl-bindings.txt for details of the property values.
+- big-endian-regs: If this property is absent, the little endian mode will
+ be in use as default, or the big endian mode will be in use for all the
+ device registers.
+- big-endian-data: If this property is absent, the little endian mode will
+ be in use as default, or the big endian mode will be in use for all the
+ fifo data.
+
+Example:
+sai2: sai@40031000 {
+ compatible = "fsl,vf610-sai";
+ reg = <0x40031000 0x1000>;
+ pinctrl-names = "default";
+ pinctrl-0 = <&pinctrl_sai2_1>;
+ clocks = <&clks VF610_CLK_SAI2>;
+ clock-names = "sai";
+ dma-names = "tx", "rx";
+ dmas = <&edma0 0 VF610_EDMA_MUXID0_SAI2_TX>,
+ <&edma0 0 VF610_EDMA_MUXID0_SAI2_RX>;
+ big-endian_regs;
+ big-endian_data;
+};