Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754641AbbGXRWH (ORCPT ); Fri, 24 Jul 2015 13:22:07 -0400 Received: from mail-bn1on0097.outbound.protection.outlook.com ([157.56.110.97]:13760 "EHLO na01-bn1-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1754628AbbGXRWD (ORCPT ); Fri, 24 Jul 2015 13:22:03 -0400 Authentication-Results: spf=fail (sender IP is 66.35.236.227) smtp.mailfrom=opensource.altera.com; gmail.com; dkim=none (message not signed) header.d=none; Authentication-Results: denx.de; dkim=none (message not signed) header.d=none; From: Graham Moore To: Marek Vasut CC: , David Woodhouse , Brian Norris , , Alan Tull , Dinh Nguyen , Yves Vandervennet , Graham Moore Subject: [PATCH V5 1/2] mtd: spi-nor: Bindings for Cadence Quad SPI Flash Controller driver. Date: Fri, 24 Jul 2015 12:17:38 -0500 Message-ID: <1437758259-28299-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: SN1PR07CA0036.namprd07.prod.outlook.com (25.162.170.174) To DM2PR03MB446.namprd03.prod.outlook.com (10.141.85.17) X-Microsoft-Exchange-Diagnostics-untrusted: 1;DM2PR03MB446;2:39JG1L6D/Z51bQgS/eLPS2aiyhgmIuvLqy7YlW/EN54+qRW+0EBlUEyoEBd+6N2xPKrZ72fnT+MwgYE3kXSY8suI2Rz2Zijc9BFm9PXOcrR3Xg3J/ADdZk5wWC4I2b0vxVcLK1qCMeCubIXuMrztPgIx8vYTHITrp82r182n1Vc=;3:uw1WyaxWN1DT3ja+fBKoQvzPtxiG22mVhLmxb3hymd47HYgW/fjGrhtdoJYA75a/SKs+UavjHWD+4mRZLdAqfyayFL7H6rR28D39ThduVhF09DyDzlIG5PWVcNCdmy02vhvFRThszH0tG8SFRTa9HQ==;25:Et4bEuEyaFSpm/LiMXzSUzvCdNEI4nAfl0nOpNB8OVSXM4vDik5IxsJl2/+qr5QRx/8i0R4wSV1yNb4rUbnro1TY+9l6NjQVsAkDVfu/mKX/kVss70DSundZFZd32YzOFFIcAEwDgPA02iOAnhBkmbsBA5i7yN8UDP0XGNna/3GgKybnLq9jDveeqkp25sxPKVBaMily/cRUA//b2UIumWO001FWQdOhGIdkteSLNYXWeMiy4EP7rH+gO2plszv7;20:K/GZaYKqGGerYYPix0z16s7YQaMqQsntD5KPRhle1bvCZjKFqWP89sDcbz1LqXVRRPpsWbM6Oa6fF0ayBspZtZvYvInmasXJN1sjotWNhbpQgg24A05rnEWF0TQ1QawRnFKDJxAoWMDCRnTo6CWtGe2Eq/FYkaCRXkzOpt0YBWY= X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:DM2PR03MB446;UriScan:;BCL:0;PCL:0;RULEID:;SRVR:BN1PR03MB235; DM2PR03MB446: X-MS-Exchange-Organization-RulesExecuted 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:DM2PR03MB446;BCL:0;PCL:0;RULEID:;SRVR:DM2PR03MB446;BCL:0;PCL:0;RULEID:(601004)(5005006)(3002001);SRVR:BN1PR03MB235;BCL:0;PCL:0;RULEID:;SRVR:BN1PR03MB235; X-Microsoft-Exchange-Diagnostics-untrusted: 1;DM2PR03MB446;4:YchqMDaQGnK2DfCkOeLsdy3qHdOz7OeHi+uFFzgQq1QefdbzaFmHDEaRFkFbNjOOqEW7gDmxRki12559OBARX7ZMWwDU5SY6Lybg4CfN2VAF5dfL0Ayuri0/hPGAxXVgJ3+CRepiYAkS98x3onEuzY47X7IHplmf337PUXJTdpoRGY6C9GiqbcSXj31kwRmcnc2oxKxSFpnYrQPqTm+FSTK7RhWsQZ+VAa31TcArN1nQt4rUl23wsyP1DlPL2VYJhsZUt5rmkxDbV+4V3/doZp7a8E5QZcS85S2BALz4+k0= X-Forefront-PRVS: 0647963F84 X-Forefront-Antispam-Report-Untrusted: SFV:NSPM;SFS:(10009020)(6009001)(87976001)(50986999)(122386002)(66066001)(19580405001)(62966003)(19580395003)(50226001)(77156002)(92566002)(47776003)(86362001)(46102003)(40100003)(53416004)(5001960100002)(33646002)(189998001)(551934003)(575784001)(110136002)(50466002)(42186005)(229853001)(107886002)(77096005)(48376002)(4001430100001);DIR:OUT;SFP:1101;SCL:1;SRVR:DM2PR03MB446;H:lava-test-server.altera.com;FPR:;SPF:None;MLV:sfv;LANG:en; X-Microsoft-Exchange-Diagnostics-untrusted: 1;DM2PR03MB446;23:entgjyWpuYSfcgqhlLWXt1j46edO2TWlbv4bXJ+DPNBCvTHIiK+9zsOQKpF3gVHx6+xKvqr+zhmcgTzc33P+3QcXU18gtP09Rr24iH9fmAWrgTOMDaaD8HcDUnhiQ/VJhaIF7TFRCRrWveGiRV7yPzgdmN72KbUYaE5ZXbReTuR0C+lfnjFHDKe2VKPU9T958iKzjXPSmFmBhOm67wSxh9CSkXMe0XYNrU7T9yLUqqBZ5jQK1Bnv6lvMeSp7OmCaVz50vJLabO6hZLUIOrLSo/TTGDCprWf1fzlhgD+zaCTj5OMHtkCiXnID+RgoVEOc2UFcRnz/4q5dFiBrO1YY3GP5w86m69QDA/2Y7gXIZXlK4JFfFoV7uOOH4awZ+zAX06SduDJwcr4TKI/Q5uyoDRH038Fj99gY/eSfGMfiSIrq2HBUClHJUJ10cEwpUsiDwbvbwPF1iVwQVVXPbrEVTNLBOrYH4aKOIw3knkR/4FGK/RFMy2Cv6tW2CAJSywRUrZW8O3bqNYEz5R5N6HOXiLd9ruOKfmZuvHSQnJhKzV9gPRHrzTOg+dD6ooSn2CqjLJUElrkFZRe2GKRgMEjM38LExhGVJJxC2gb6jgyTWR+BiIeIEUA+A24UCcdCirD6Q354SMrWM67ECrtrT3Ig4jQz7CCrSCienymi1+/I0zAEDRr56MmVgnUlnQ5RCdtscR/h5zqXSSAyX6/J9eiUyG+mW4UjwffvMNcGdg5vVjg+LoldMyeMiGxzL4fCyc5BjSk9rA+9WGAQElUAGmNzCdW6HrTI5hXjn9t7ijqIQ7f8FU6br5fjyFfbpOFTv6qD X-Microsoft-Exchange-Diagnostics-untrusted: 1;DM2PR03MB446;5:6ylHZsDV8+lOm928pSu1TyLDBUOfhhaoTFMNCgLb54FCje0Gs0hEtioPQY7sw72NVJd5ae/t/PPJ4nw9AuwaQ2zLVfAQ3SA2n+C7ifyIygr5/yanI0wH0KFk/uGwcz9/yOOz5ERcERDIFBQjeTwcoQ==;24:dXV6DmRC/RSOcx8L5b+xMveETvVCswv8vO9c7bDU3+gD49Wr2ugdRrifUsfdPcC+naIQQPQRVAIGUuqnHMcTOMZErtrLpV9tKTp87mzP8KY=;20:bgRJukQ1jkD99N5P0RiH1Wx/ojGV1o6DOsNa+Yc1dwdG5lwS4oqKOF7t3wmgbDnRtEf981wP6oIs2MHnGnGBJijUf2CYMGQrV/35gl3WrykcxuGPKwFIw7Pj7gve41K4cjoSnLOnCFATli9eKfLiIH4y5kUJnrDKRPfU9kq/fsQ= X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM2PR03MB446 X-EOPAttributedMessage: 0 X-MS-Exchange-Transport-CrossTenantHeadersStripped: BN1BFFO11FD016.protection.gbl X-Microsoft-Exchange-Diagnostics: 1;BN1BFFO11FD016;1:AP7RId5J5F051UsMXs1Dbh7nHqcxrzwMLnmTTTXe3fl5KboZC5ZGJfj3OiDEKHnSkda+kZr+qrIDrrmz/yMLktncrbPbMWEGqacL0GQRjPzdub2hENrN37UWg8+cLU1KUXCw3OBw+BULyGvjQE9RD5z7k9vr+4JlkwLa6rISes/1ny8xcfB4xf8XAjDBzrsO/iuH1WnCm8GyPZvIE23Zd317n9zdDTsKKGz2YNik4NE4BRqDTt0UY4rI44h8cJRA5QyygW8iATEKmOris1aZAOSYndIOfHPt3Iy2cccAL1SCc6qR6E5Z4V6Uj7Xh/aPW X-Forefront-Antispam-Report: CIP:66.35.236.227;CTRY:US;IPV:NLI;EFV:NLI;SFV:NSPM;SFS:(10009020)(6009001)(2980300002)(339900001)(199003)(189002)(16796002)(86362001)(19580405001)(33646002)(110136002)(6806004)(47776003)(46102003)(551934003)(107886002)(5001960100002)(92566002)(575784001)(66066001)(53416004)(189998001)(50466002)(50986999)(19580395003)(87936001)(62966003)(48376002)(229853001)(77156002)(5001920100001)(106466001)(122386002)(77096005)(105606002)(85426001)(40100003)(50226001)(7099028)(4001430100001);DIR:OUT;SFP:1101;SCL:1;SRVR:BN1PR03MB235;H:sj-itexedge03.altera.priv.altera.com;FPR:;SPF:Fail;MLV:sfv;A:0;MX:1;LANG:en; X-Microsoft-Exchange-Diagnostics: 1;BN1PR03MB235;2:rL4SbzwA2LYcdKC5nlyZ0Mxz4ijc8/mr+Sya6ai1/2bGHZuroiie2WZK8L1jwOCn;3:rPvmbxSwDjFH6HE54ljspcskgV8mEh90kVmMG5mMTyb7R4oeO5274A8rNUdAF6wu8xTgIZLEe5EK78IfmOu07WeLaGEOdpfeIvD8saneOaQhQVQKxM2uvVclmNPC6a40DCeBVbLpA0KWUCRHLiiPiAmzda3dJGP8aLT6tjylWVc8lDYysbgWBTXhcwzMIiqLgD5auvl8aey0acQR1dnJtXaFryQAZZv+sHG/cNWuy54=;25:oECShUQQo6RTESzH83Ahmq5qzbgplSD2Yw4tm9PNykjamgBQZL+7WbCidOtkAK0YieMitJV5WZBEdKhfjwnSlvgdqKRJ0gkpM5yy5KLIFt1EN2EqO3owMI3dfcLgLvRQmMDnz1kFt2jxhpKC8Y02HhOkEdDB+Crikugfpd5OdmUmw8kOicbrbk6yuKabfH/wGUP2NxYOKWj/Msxp3ufcdVjpvg6Tc6R4PSNwhR6fAL/Bi0rTVP8QkZGxgB5Td4co;20:+iN1aap/Kfrm77ZVjo4Nsm1taDRfsBFjEGjmmRTYS6eKDLmjPG/lxIX39jjFqM2Jv+dpLiIueM1oMmvkP9FnqRYx3C6V59Kmh02CbD0fAQC0aQ5FWHVFbYIL2/cRMaGDXRFIjf8pKdQWhpwMs8gdDA+YltelV9NpHYinmVLVmA0= BN1PR03MB235: X-MS-Exchange-Organization-RulesExecuted X-Microsoft-Exchange-Diagnostics: 1;BN1PR03MB235;4:KQ+SOuWHip8O/5jhMXqWn9F6CtEJ68KTIG3KH2JSU4QMYb3ZGLyJ4C0ZdBj233tS/1VFAUHAdxK2aS+Yhe5cyUvlEzDs/RsWUhiNZpPAI39oK1zyJgojEArsmSl7VV1/26o/cgBpmVnEwxVE2bO4zhuVJLqsqvtdVisXAVmnTpUtK/auxBlmczK+U23mR7tK/7XqD9WMEO4izL/EATviTMLn3GfnmKqpYCzzYhnSbl+0QX3lbO9USt4ZchSvIwSwU5yukITtHupJgNf2OdZN68uPguwq0QaNDvJyLLRtg8Q= X-Forefront-PRVS: 0647963F84 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1;BN1PR03MB235;23:zMCAU3OmRcKEnUeDB+WeW2ZMchMLNNm3Milh69BFen?= =?us-ascii?Q?Vsby8C8dzv1ePAN98qsCopIZeCyLK4UUerpg1TwbVQI/iGbmjd9TV/+Lq8ev?= =?us-ascii?Q?ENSC2MLVPDDBaU3ULh7UDMvHWnOThNr0ka4TkcQTEZX3tLMnr7uwIWI9UNeB?= =?us-ascii?Q?/1bpEwP4lrW/sSSYvvPd7G0bmH3SanTPvxEpQAg6kW8gPUiZwWdwxEEQqJ7n?= =?us-ascii?Q?dxr13E0D08XR9Rq2TQfx3OiAnVkJGXOrCPw3qzjEjkV1jfbDAtBDQC7BtpWw?= =?us-ascii?Q?YMALEO62shpdp0/aBeatjXIcqcJTown8kyQfgmEx/xGjpQ/X5YXBKJNlGg2F?= =?us-ascii?Q?mq6alh5afehYFDXwQXiKNAFj4gkDxBqpkzhiu9vnfm4sddX3529L0xrgQMRW?= =?us-ascii?Q?BedAl1B9tyY4ttUFRXmGkpRHFsRR8mreGaLIed2tQOMHVIV4jdxgOUgnaiRD?= =?us-ascii?Q?u6k/PuqheoeamodfxOnqACRrDBP7KRLKNBi9N7k/qHWfYLZH+dsyCLPvX5IP?= =?us-ascii?Q?z1eqxYWBdF5Ie/iusmCX6j8kPsNbTLYN2zPHpS5Oy+bZCATCFzFk/Msr0BC7?= =?us-ascii?Q?ACiNiqDExJx190ETofE7cbuUrB6C1U1zKUkEuHn7cl+DmmFmwryeBEzm6YVR?= =?us-ascii?Q?VvGiEH05/AdMN6R3WJTziA7YIUGSS4Z3SW4CqT4GYrhJBxZtI1P42TqRTIiJ?= =?us-ascii?Q?ypSeHn9N2IZXUqaxHjzQcdRKoRwxdzoZmC8aX/4jPul/M83hGGxLIEkiAJ2H?= =?us-ascii?Q?DSG/UbMidsl8rTLSMGxRo/NG/hqLBho8PDh92UOyXDMhrPKWNlWCvY44is46?= =?us-ascii?Q?CW3VpUl9KVQ7+ZQqVed5dlBKFpEhjZxa0CU6KmNxHIGJfpIvsTd8Txx1lzzP?= =?us-ascii?Q?719jY9HJwAJGW+huy3bYPPSsVFy26i/1XFH5lnH4S16u8eSxxMzkgNq312WQ?= =?us-ascii?Q?CFZAo26tUioIpidgfSU3Bde+RoUffUx4B1uXb1Tfou0Av3G0DisuqazmKEeq?= =?us-ascii?Q?DWsHzTu55FeoQJFYsQu7nDCA4twBfU+DbWp8sG5P1g1A=3D=3D?= X-Microsoft-Exchange-Diagnostics: 1;BN1PR03MB235;5:n9aVZmbOeUqe9jMiXePmqdeUrT6Hne9Qdb0rgZtESayHzn72evPyzz2x41yp3NXs2g3T1V9tsmTxdliXwDAKaC1NwtgBszGFOAcE3uIw5iWK4IFrwXWo0CNdmFer37lGTPC6Z1qmwqLF9rCw25t6Aw==;24:T4YE2kSeTq8LSOXD69VTesszPBlpURUKqN+4Pj+7Md3iKz8TV+Pn9dFwWP4PK7dmZM1Ba/LSS2E5M1/odjPsfcM8zs7emYHuR9zKEvXO+uE=;20:Y9OsGdqwIlYpHA73brPdxCn3Casd4LBzS6jm0NYPn7opWg21iB0w3A/hKYFqURIqCykNAWz3idKmJH7Lejp0f27sLJNXwtThaqdRnRfGkWfLamPNP9Nssvf8uU8oitxYRlpa80QcoG80ItzgPDceZwjzPh8QYdvVu6B2/7rDXv0= X-OriginatorOrg: opensource.altera.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 24 Jul 2015 17:21:58.3329 (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: BN1PR03MB235 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 2922 Lines: 75 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 -- 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/