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: 301991
Return-Path:
X-Original-To: incoming-dt@patchwork.ozlabs.org
Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org
Received: from vger.kernel.org (vger.kernel.org [209.132.180.67])
by ozlabs.org (Postfix) with ESMTP id 3F1AB2C00A8
for ;
Tue, 17 Dec 2013 15:18:51 +1100 (EST)
Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand
id S1752675Ab3LQERP (ORCPT
);
Mon, 16 Dec 2013 23:17:15 -0500
Received: from co9ehsobe003.messaging.microsoft.com ([207.46.163.26]:27954
"EHLO co9outboundpool.messaging.microsoft.com"
rhost-flags-OK-OK-OK-OK)
by vger.kernel.org with ESMTP id S1752733Ab3LQERH (ORCPT
); Mon, 16 Dec 2013 23:17:07 -0500
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: , , ,
CC: , ,
, ,
, ,
, , ,
, ,
, ,
, ,
, ,
, ,
,
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%
Sender: devicetree-owner@vger.kernel.org
Precedence: bulk
List-ID:
X-Mailing-List: devicetree@vger.kernel.org
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;
+};