Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753175AbbG1Rnw (ORCPT ); Tue, 28 Jul 2015 13:43:52 -0400 Received: from mail-by2on0068.outbound.protection.outlook.com ([207.46.100.68]:40898 "EHLO na01-by2-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1751355AbbG1Rnv (ORCPT ); Tue, 28 Jul 2015 13:43:51 -0400 Authentication-Results: spf=fail (sender IP is 66.35.236.236) smtp.mailfrom=opensource.altera.com; st.com; dkim=none (message not signed) header.d=none; Authentication-Results: lists.infradead.org; dkim=none (message not signed) header.d=none; From: Graham Moore To: CC: David Woodhouse , Brian Norris , Vikas MANOCHA , "Marek Vasut" , , Alan Tull , Dinh Nguyen , Yves Vandervennet , Graham Moore Subject: [PATCH V6 1/2] mtd: spi-nor: Bindings for Cadence Quad SPI Flash Controller driver. Date: Tue, 28 Jul 2015 12:38:02 -0500 Message-ID: <1438105083-19738-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: BY2PR21CA0005.namprd21.prod.outlook.com (25.162.74.143) To BL2PR03MB436.namprd03.prod.outlook.com (10.141.92.26) X-Microsoft-Exchange-Diagnostics-untrusted: 1;BL2PR03MB436;2:n2dpVmpjbBn79WTFz6WarBzkUX3TAJYj3K/hjeBzQ7ZozZs7eC+ftiUZwvX63/1BPuiVouKH86I6bzvYjWxlJdksJ7PNcoYAz4Z4VVcQ1gB4y+NdWix8y5JhAq4NOmRrAaVn0b2CEbBZr3duLbh3Db75zv4In+Yygi8Yu4unDt8=;3:h7nQQt+P0D9brtoZzyHRBtYTrUrbhm6CA266FKKcjF4JyhJKRWavy9e1S3dtCeqOgVHV9d8ZdJVaFg5oma8gujdKoytflp8pMAKriqr8Yp7rxWTsX0w5H8YlFKYai4stl+yEj2cBEhYaxqxasw47jw==;25:/wzNLixKkoweb/C6XdV0NPPVIWD5oacPITjU9Ftn+4QHrVzPsj0bokJEQrn23sWKccZHUxZuMLD/D0zPkZ5tgAWWzoOjqQYwBZy/tUebzBs5FV+MdBLAyCcpXRUZfIh4jwUDUqpBKpoP+gUIFp6KWPvREzmKvjPqD9z0SMtzUcSBp050TcyP13g07WYBsup3bUJwxpletiq8Oso0ZwM8x1Gq2FtcbYzqIm2noEriClfoP501oiOMgbX6P6+7PcbX;20:fLprvrwtH3ZaRkuBGxJqWL/RfvBi1/pteesbo5xb06cWG+XB36NITT0PLy8NYyW/P7na4hb5U2SQwO+j5ktmSphXRgSow+SDV0b2WmVKtmDodYR+ejIs5rW6sTvGd6AvchN2LysOAfnW4e29FZt+tu2sZh2S6gMYRTj8fvEzr/U= X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:BL2PR03MB436;UriScan:;BCL:0;PCL:0;RULEID:;SRVR:BLUPR03MB1490; X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:;UriScan:; X-Exchange-Antispam-Report-CFA-Test: BCL:0;PCL:0;RULEID:(601004)(5005006)(3002001);SRVR:BL2PR03MB436;BCL:0;PCL:0;RULEID:;SRVR:BL2PR03MB436;BCL:0;PCL:0;RULEID:(601004)(5005006)(3002001);SRVR:BLUPR03MB1490;BCL:0;PCL:0;RULEID:;SRVR:BLUPR03MB1490; X-Microsoft-Exchange-Diagnostics-untrusted: 1;BL2PR03MB436;4:dM29OuZTxcAYo3ocSnG5embRE5WCT1lAkXGpXKbHCDiz32HPY8jPqGIr7MONtfiMdH0eExVhWrpQZlSYJ9yy4WyDSqpqxdS4kiWZJsazPPxbfs3orVN5WNiSblpV04x8lqK07xRRh5WSRoHG7FfOEv0i1/apGsQpFIZIgGrZYVmG3iV5pc2JcdNJP9hkSZJTxk0E/kU4pK5LS0ERb2yfabigB247dhR16idEawZ0rVmsPdYPmC2qz7sAWrUJrQt//AKA5x1/2kypmS1OYCdgZm+VKWj5XFn90Etb8unPRUo= X-Forefront-PRVS: 06515DA04B X-Forefront-Antispam-Report-Untrusted: SFV:NSPM;SFS:(10009020)(6009001)(19580405001)(46102003)(47776003)(62966003)(2351001)(33646002)(87976001)(229853001)(86362001)(50466002)(50986999)(551934003)(42186005)(5003940100001)(110136002)(19580395003)(40100003)(107886002)(53416004)(97736004)(189998001)(122386002)(92566002)(50226001)(5001960100002)(77156002)(48376002)(64706001)(77096005)(66066001)(68736005)(4001430100001);DIR:OUT;SFP:1101;SCL:1;SRVR:BL2PR03MB436;H:lava-test-server.altera.com;FPR:;SPF:None;MLV:nov;PTR:InfoNoRecords;LANG:en; X-Microsoft-Exchange-Diagnostics-untrusted: 1;BL2PR03MB436;23:SAeFjss217iH8XfG1CWHjuUJVhTuvizieJ2LUyj66vcQYTkBS1G1HQJFXh0A2LsByHepfzJek/oq6QOURKJaplTHzRsa5Fb5UStNMoCXY4QoJrtdBH9wnRS0juyhG+0X7Dt3GdVlKTv698rzQPx7iBng5L6wMF/MyZTmPYH5u7L2ECkfmKIIKDjYPOF+Wy4hPTBvN073Bqcuad1gj610OXngJ8ji88eyHpktczhh+kTEAK+A4z4TZae5WRkWPqYOg3Wl0B1wQQyEvdJ8YhEz9/rbytzAEKpF3zW0RBsQdmdUEkErrf8EU3AT9Y3n7lWtdTvirWjPOMrKujzWtKEzbEwpqEIkqaRO+Y79PeDEMYmZl/J8CZhtiK7BdSEUhdLKhsZSeojYp+JrsMhQ65oDlDTEHrbB4Gjlb4YwALuMsumrxgRGodMZyGVIyCV9TiUPRzQI6vv3boE+GpC0xC4LEdQ4o9ZfbijucKrQVJBCH2L7ooa67xrdd0pbEqwcFLWPjwDNQ6Umy8i1NZJwVl2D2BlOkd4RDDhhj+QYU9/x9gEdqfTSh2E9ckZthsf8SJOud/UuedXCk/M0IaF5HoN9/VWPUCm3wqmu+osK+eT7+W1p3bO4aKyN7T2IzHXt+RenfHCbg57Ka6OmSW0WMAEpxtNOilq3Obzia7Qp0DsWpLG+JeKOatuHJxN2kIcGAtO9PLS4WF07WUbWObuTrMs823lzv455qGZYBOG12PgukyKEIDmwaMAVqNAP58wCUcLy0ubg+7fJX7kz28t68KyO+2t2L2oXZZN0XMKB9xZO5vKkwr2z9cYxhzR85RZ5qGdrj82KnidZG2i5G7Ek9d+/8S9js1hs0Fdnjpzm2BBwDkXMFDVvCwqOVgSS9g0xIHjHwIMfrzSUUy7GtSkYD06MRAUfbnGt/Xc+sfrHVtlwvxs= X-Microsoft-Exchange-Diagnostics-untrusted: 1;BL2PR03MB436;5:wTDt8Tq9zfcyB0xKhW8gqK+02dxb+TOqjsmAqvSriHBeX8CjCNCxDNqtdv9+TrOeeB7Cek4xefXz6630INqBdstaiDmiOTdujWnvYmNHLAZSZICCfbFjfP2uhl/saq5/uTkYw2HDzcva9ALIbXBDXg==;24:B+9Q1rinFdpoFez1LSV+9/AOdNu3V1KTCORbOnisIQmR1Brhj0CBSvwAtgXoPL3l8cWSZu+6TWx8TgfyxXErRpaIKjvuJrUDq7TP9omxj1M=;20:/CqK0Tt69YLXPk890T5bXW+abDLADOvM5SBu15RwawEOydy0NNKuNJodINT+hKjqELcJqIyEXuhawZ4H3GKejT+UGGlBAXseMOBTXuxDea3cUyx/qrjFxPftJhe48nIs6OnFLZMYBfP002PtGISEsOYk/LjVuv9tt9TduxfD+UQ= X-MS-Exchange-Transport-CrossTenantHeadersStamped: BL2PR03MB436 X-EOPAttributedMessage: 0 X-MS-Exchange-Transport-CrossTenantHeadersStripped: BN1AFFO11FD051.protection.gbl X-Microsoft-Exchange-Diagnostics: 1;BN1AFFO11FD051;1:2beuFJeK2lP5L5YUdkJTprkpf+Zawlay4ZPl3wOHoB/oaUcbViUuaRyhiNsVPuhB6kBc+udwaNKaVSohGtoaP+vXNJRaCRflGrcsKQk8Fhu6htfYHeFlVFocgqGSLqi8ltyjtdFvkGBhaq6iXXW5mf8SCil8zVFWHM9OUmY+2l/Yv3VmCfqKVJlWBXoU4Y6J0E7n38B/Ro+NWMsWHsSvdTQL1WTl84i0sHYtsISX4fLFPhxQVAkAd4HuZR6btWJBRb4pfj2jf2H90z0vRdBnSFJncZJ2W7uWMbfLJPQ5+3tDffSO1YefXFCpln5NJElKuSn8vHSOJzA/LZfB2hvxUA== X-Forefront-Antispam-Report: CIP:66.35.236.236;CTRY:US;IPV:NLI;EFV:NLI;SFV:NSPM;SFS:(10009020)(6009001)(2980300002)(339900001)(199003)(189002)(48376002)(16796002)(105606002)(46102003)(2351001)(97736004)(85426001)(106466001)(50226001)(50986999)(110136002)(62966003)(92566002)(77096005)(551934003)(189998001)(5001960100002)(33646002)(50466002)(87936001)(64706001)(86362001)(229853001)(66066001)(19580395003)(77156002)(5003940100001)(6806004)(107886002)(68736005)(19580405001)(47776003)(40100003)(53416004)(122386002)(7099028)(4001430100001);DIR:OUT;SFP:1101;SCL:1;SRVR:BLUPR03MB1490;H:sj-itexedge04.altera.priv.altera.com;FPR:;SPF:Fail;MLV:nov;A:0;MX:1;PTR:InfoDomainNonexistent;LANG:en; X-Microsoft-Exchange-Diagnostics: 1;BLUPR03MB1490;2:3gnzHSVATGq+4LrsYNdBboifrpDzWK3V/pBhU2OhlyYvgYVCwobYUqsFj/UNGr1F;3:h56Dp/X3x5pfFddGpvzjapY1CXO7jiYJMsq5sfHK3nEqW+1AdY0alTfZx1aGCZ0PDfN8/PIQ3JzTNvZu161hAbodgDCq2IDDGzuhdrLBSnDRgeBUJM8vRAWS7O72+1FQsyOMkYPRDv+416j6KDZt5BqFwCaCqTG7PA27mykeFbj1JffJXU0oKuqTaxbmI64nxZ2t0LJHNFck3pJK4w881dpmAyuy8oOoMgiCntnHh4g=;25:AdgMwM43OCwQcZS6ZXysRo5xNDmzH9CuexFMcj1fVLNxxe/uqR7zzwgH4pgJc2QOC+Xkptq78KoldUcZFu24JsghI8ayMkqdV5VgR6R+6PyJKAWFufRv826KWH9qjfTa31NpH2qAVCBpuiVc5L+ZwnHmAh9sWDnZ8+1knbiJrQFCfOdA+J0G9bvOXaqKsu4hKMsoHO/JrXXiTlF4VDR6rFUAm4tG4BCNJwwfqR2tEfSSZ/9nz/USTmiJfDiL4dxF;20:8ZkLdrtgskfco+D8h+Ct6lH+v94FFaJmvB3wCqvq7fumBrIm23wAYgZnqeAZMWPmCzgDvTSTKqJ3xDCAq/k+l01TEr4OGx8VIKFS0t+Iiid5n7dz8KFiUOnw9ry7Mvi8vZ2xLTIoOuZ09+7jwF1LbcDrKEZTfT5x8CEQkBDYv3s= BLUPR03MB1490: X-MS-Exchange-Organization-RulesExecuted X-Microsoft-Exchange-Diagnostics: 1;BLUPR03MB1490;4:NB32ZcO7hI2HcBNNg1IoFN3VTBV1oDgqYze2BCS6cVofap9UgtiD2jcZxPunroVApWTcRmgscbn9t6iee78tCNF3oqdabmtKlId0qt4OGJGL9b3+zHkybFotvGhXt8LHuQNeTOSPQn/nYOO+EmmWhB1B/AR8RxHgtC7xL2jAtQpmrGLu3wQx3YWbIOFDgCjdEgJ+x/tVeXZ7MRPzv/QId0AL5ElKSfbEUhLQRaAhna+gBIJbZ4hzC7pDNUNlcbTMgvvW3wEPJGgEvQNh4Qbfbs+OiLtdsst5/r+wcqoCXrY= X-Forefront-PRVS: 06515DA04B X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1;BLUPR03MB1490;23:HyFX3H3k+/y+GYAMdHGPdQ7h9EMyOb9dh8f9fbWFT?= =?us-ascii?Q?p03YITe4PsW0gDJ8dH5WsZxWHMLeHLlep0Gnfx7viKRsJ04GimaBY1UqkU4H?= =?us-ascii?Q?jK3NMgFgkY0TzEF8L0o5exc/AL4ybWA8d2rpQ24MxoQ0rAZ5Xivo2yQwJRTe?= =?us-ascii?Q?zSR/BT/sIjdceKDymf/rLRHJ+QSnwS5xjn6dH3JQQoVXWCSK+5Ts2U2AtGDs?= =?us-ascii?Q?YDTEvV4QaF9VqEid//+XNWfvRblctAnbjys0PrD5MGVaaz9AxtqOkwsoC2Ya?= =?us-ascii?Q?yCruGAxTfdlywZuo4MJqps8c+kC/nLa21NCzlgI9ZM1MwfjMUTj++PcHZfiu?= =?us-ascii?Q?mMxvbV6gjmdY3lvNGogwtyEbUDw6Iwyb1phS/C27qwNIwami+iqMf2PuzhWb?= =?us-ascii?Q?iHzqYscN1wfwFY/YXqDilchYBgGrJeppVftyntnEKorDWiVm/xNPTPUbtXBe?= =?us-ascii?Q?q/TWgkk1MtIc7TwoVu9D3Y6eyERnbLgEjr0+X8ewq1jVcExJSs8Cf2olaDmi?= =?us-ascii?Q?znBmEaD36Ub374xVpfRM3Np01zaGiKRHQwadbdHTw5VkQpYKU6EvkyhtPolM?= =?us-ascii?Q?FgERx5DeErDgxuhPhfXxkSIISBmNmk6dmVTGHt41W/1lXIq2pjEI+F8dlVCr?= =?us-ascii?Q?isjT2R/1isZyjEbVhwdKrCN0Gne0ayqr6t2Rr8lU0eNDQMkdz38IedIuD389?= =?us-ascii?Q?dS/j1kfEimB4Gxkj8N9jJXxD4MXFGhsB5WvB5o67Dnm658JgLwhvqRjf46ZM?= =?us-ascii?Q?CI8i+n/2WlsxRdzVag6kQ3yqP+pQgOUWSGKCx8UZ6KtT1Djein/yBYfLeESt?= =?us-ascii?Q?k+v4Kg+SKAaBYgqmgsUrkK/vtWK5EPbI8kGxvdPft1yhDTgZoXO79OUt10i3?= =?us-ascii?Q?aIyQdD8BObvjmooZWtSGJGeUcROT+3q5IYOdwt0OlxQ7zRBNSM5cvSw344OA?= =?us-ascii?Q?7WKzz0/aKcbPrY7ThEMCGr22L4KsP02gWSLoNoAt7o1OWrMK2wQDb9NYDnaj?= =?us-ascii?Q?mQIadMnMJ7BstX6hApg/n3xkdbqMXm6/QbeXlPckVRo0kiEWV9aT0YbMob0X?= =?us-ascii?Q?CAlYi9/Dyw+JxmT5a8Tms28WHaqopvsNdXE26CY6QGuW8Bn2Q=3D=3D?= X-Microsoft-Exchange-Diagnostics: 1;BLUPR03MB1490;5:EtOiUVDeiB1ZfGHFMFC94uaiHscrNDIlnCbIf0KI5GHkbFuLDVBcAbz4rPLyGP2IwQpMuUP6QwH5wRB5y8SoNsgmZAF1oxBSmGrRz6RgFPjKOtBNVfj1Zxk/6eYmjKiftIJnXch5yu9jUfDlckAwOQ==;24:r7XuT4JrxZdYourbgFDtYZksYxp3aHEtPstAnapqHr1aNFJfKoEBccQJJWyAok0v05Nd6XYvIPyn3NrvtPbgFBSb8G4Ivjz2G8BIWQsKBh4=;20:ud6PsTlgge/sUBKRkV5lm67mLmTBZ29Y+1kGP6EGPyPOBgbTFy56sxARAF8KOxemOAAGwxbi4UQ49jaPn/NF2jQkWBOHJx33/QMVUstjx8dSXBCOXY3oLVvDcM0H7Hg5yuhqBHmabz8A6xKyXxZaCeseld15OmulPLA44CwuWQs= X-OriginatorOrg: opensource.altera.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 28 Jul 2015 17:42:29.2797 (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.236];Helo=[sj-itexedge04.altera.priv.altera.com] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: BLUPR03MB1490 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 3142 Lines: 80 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. V4: Add new properties fifo-width and trigger-address --- .../devicetree/bindings/mtd/cadence_quadspi.txt | 54 ++++++++++++++++++++ 1 file changed, 54 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..d7e6fdd --- /dev/null +++ b/Documentation/devicetree/bindings/mtd/cadence_quadspi.txt @@ -0,0 +1,54 @@ +* 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. +- fifo-width: Bus width of the data FIFO in bytes. +- trigger-address : 32-bit indirect AHB trigger address. + +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>; + fifo-width = <4>; + trigger-address = <0x00000000>; + + 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 -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/