From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753054AbbCWNya (ORCPT ); Mon, 23 Mar 2015 09:54:30 -0400 Received: from mail-bn1bbn0100.outbound.protection.outlook.com ([157.56.111.100]:49709 "EHLO na01-bn1-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1752288AbbCWNy0 (ORCPT ); Mon, 23 Mar 2015 09:54:26 -0400 X-Greylist: delayed 884 seconds by postgrey-1.27 at vger.kernel.org; Mon, 23 Mar 2015 09:54:26 EDT From: Graham Moore To: CC: David Woodhouse , Brian Norris , , Alan Tull , Dinh Nguyen , Yves Vandervennet , Graham Moore Subject: [PATCH V4 1/2] mtd: spi-nor: Bindings for Cadence Quad SPI Flash Controller driver. Date: Mon, 23 Mar 2015 08:36:21 -0500 Message-ID: <1427117782-14764-1-git-send-email-grmoore@opensource.altera.com> X-Mailer: git-send-email 1.7.9.5 MIME-Version: 1.0 Content-Type: text/plain X-Originating-IP: [64.129.157.38] X-ClientProxiedBy: SN1PR07CA0039.namprd07.prod.outlook.com (25.162.170.177) To DM2PR03MB446.namprd03.prod.outlook.com (10.141.85.17) Authentication-Results: lists.infradead.org; dkim=none (message not signed) header.d=none;lists.infradead.org; dkim=none (message not signed) header.d=none; X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:DM2PR03MB446;UriScan:;BCL:0;PCL:0;RULEID:;SRVR:BN1PR03MB282; X-Microsoft-Antispam-PRVS: X-Forefront-Antispam-Report-Untrusted: BMV:1;SFV:NSPM;SFS:(10009020)(6009001)(66066001)(62966003)(50466002)(47776003)(48376002)(87976001)(53416004)(77096005)(19580395003)(19580405001)(42186005)(86362001)(77156002)(92566002)(50986999)(50226001)(551934003)(46102003)(40100003)(122386002)(33646002)(229853001)(2351001)(110136001);DIR:OUT;SFP:1101;SCL:1;SRVR:DM2PR03MB446;H:lava-test-server.altera.com;FPR:;SPF:None;MLV:sfv;LANG:en; X-Exchange-Antispam-Report-Test: UriScan:;UriScan:; X-Exchange-Antispam-Report-CFA-Test: BCL:0;PCL:0;RULEID:(601004)(5005006)(5002010);SRVR:DM2PR03MB446;BCL:0;PCL:0;RULEID:;SRVR:DM2PR03MB446;BCL:0;PCL:0;RULEID:(601004)(5002010)(5005006);SRVR:BN1PR03MB282;BCL:0;PCL:0;RULEID:;SRVR:BN1PR03MB282; X-Forefront-PRVS: 05245CA661 X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM2PR03MB446 X-EOPAttributedMessage: 0 X-MS-Exchange-Transport-CrossTenantHeadersStripped: BN1AFFO11FD055.protection.gbl Authentication-Results: spf=fail (sender IP is 66.35.236.227) smtp.mailfrom=grmoore@opensource.altera.com; X-Forefront-Antispam-Report: CIP:66.35.236.227;CTRY:US;IPV:NLI;EFV:NLI;BMV:1;SFV:NSPM;SFS:(10009020)(6009001)(339900001)(199003)(189002)(92566002)(85426001)(77096005)(68736005)(77156002)(122386002)(19580405001)(6806004)(19580395003)(40100003)(53416004)(66066001)(47776003)(87936001)(62966003)(50986999)(48376002)(50466002)(97736003)(16796002)(50226001)(575784001)(86362001)(105606002)(551934003)(46102003)(110136001)(2351001)(229853001)(33646002)(106466001)(7099025);DIR:OUT;SFP:1101;SCL:1;SRVR:BN1PR03MB282;H:sj-itexedge03.altera.priv.altera.com;FPR:;SPF:Fail;MLV:ovrnspm;A:0;MX:1;PTR:InfoDomainNonexistent;LANG:en; X-Forefront-PRVS: 05245CA661 X-OriginatorOrg: opensource.altera.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 23 Mar 2015 13:39:39.2671 (UTC) X-MS-Exchange-CrossTenant-Id: fbd72e03-d4a5-4110-adce-614d51f2077a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=fbd72e03-d4a5-4110-adce-614d51f2077a;Ip=[66.35.236.227];Helo=[sj-itexedge03.altera.priv.altera.com] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: BN1PR03MB282 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Signed-off-by: Graham Moore --- V2: Add cdns prefix to driver-specific bindings. V3: Use existing property "is-decoded-cs" instead of creating a duplicate, "ext-decoder". Timing parameters are in nanoseconds, not master reference clocks. Remove bus-num completely. --- .../devicetree/bindings/mtd/cadence_quadspi.txt | 50 ++++++++++++++++++++ 1 file changed, 50 insertions(+) create mode 100644 Documentation/devicetree/bindings/mtd/cadence_quadspi.txt diff --git a/Documentation/devicetree/bindings/mtd/cadence_quadspi.txt b/Documentation/devicetree/bindings/mtd/cadence_quadspi.txt new file mode 100644 index 0000000..1cf0d7e --- /dev/null +++ b/Documentation/devicetree/bindings/mtd/cadence_quadspi.txt @@ -0,0 +1,50 @@ +* Cadence Quad SPI controller + +Required properties: +- compatible : Should be "cdns,qspi-nor". +- reg : Contains two entries, each of which is a tuple consisting of a + physical address and length. The first entry is the address and + length of the controller register set. The second entry is the + address and length of the QSPI Controller data area. +- interrupts : Unit interrupt specifier for the controller interrupt. +- clocks : phandle to the Quad SPI clock. +- fifo-depth : Size of the data FIFO in words. + +Optional properties: +- is-decoded-cs : Flag to indicate whether decoder is used or not. + +Optional subnodes: +Subnodes of the Cadence Quad SPI controller are spi slave nodes with additional +custom properties: +- cdns,page-size : Size, in bytes, of the device's write page +- cdns,block-size : Size of the device's erase block +- cdns,read-delay : Delay for read capture logic, in clock cycles +- cdns,tshsl-ns : Delay in nanoseconds for the length that the master mode chip select outputs are de-asserted between transactions. +- cdns,tsd2d-ns : Delay in nanoseconds between one chip select being de-activated and the activation of another. +- cdns,tchsh-ns : Delay in nanoseconds between last bit of current transaction and deasserting the device chip select (qspi_n_ss_out). +- cdns,tslch-ns : Delay in nanoseconds between setting qspi_n_ss_out low and first bit transfer. + +Example: + + qspi: spi@ff705000 { + compatible = "cdns,qspi-nor"; + #address-cells = <1>; + #size-cells = <0>; + reg = <0xff705000 0x1000>, + <0xffa00000 0x1000>; + interrupts = <0 151 4>; + clocks = <&qspi_clk>; + is-decoded-cs = <1>; + fifo-depth = <128>; + + flash0: n25q00@0 { + ... + cdns,page-size = <256>; + cdns,block-size = <16>; + cdns,read-delay = <4>; + cdns,tshsl-ns = <50>; + cdns,tsd2d-ns = <50>; + cdns,tchsh-ns = <4>; + cdns,tslch-ns = <4>; + } + } -- 1.7.9.5