Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752399AbbGQQLk (ORCPT ); Fri, 17 Jul 2015 12:11:40 -0400 Received: from mail-bn1bon0054.outbound.protection.outlook.com ([157.56.111.54]:45712 "EHLO na01-bn1-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1752170AbbGQQLb (ORCPT ); Fri, 17 Jul 2015 12:11:31 -0400 X-Greylist: delayed 884 seconds by postgrey-1.27 at vger.kernel.org; Fri, 17 Jul 2015 12:11:30 EDT Authentication-Results: spf=fail (sender IP is 66.35.236.227) smtp.mailfrom=opensource.altera.com; vger.kernel.org; dkim=none (message not signed) header.d=none; Authentication-Results: linuxfoundation.org; dkim=none (message not signed) header.d=none; From: To: , , , , , CC: , , , , , , , , , , , , , , , , , , , , , , , , , , , , , Petr Cvek , , , , Alan Tull Subject: [PATCH v9 3/7] staging: add bindings document for simple fpga bus Date: Fri, 17 Jul 2015 10:51:13 -0500 Message-ID: <1437148277-5405-4-git-send-email-atull@opensource.altera.com> X-Mailer: git-send-email 1.7.9.5 In-Reply-To: <1437148277-5405-1-git-send-email-atull@opensource.altera.com> References: <1437148277-5405-1-git-send-email-atull@opensource.altera.com> MIME-Version: 1.0 Content-Type: text/plain X-Originating-IP: [64.129.157.38] X-ClientProxiedBy: DM2PR21CA0039.namprd21.prod.outlook.com (25.161.137.177) To CY1PR03MB1519.namprd03.prod.outlook.com (25.163.17.25) X-Microsoft-Exchange-Diagnostics-untrusted: 1;CY1PR03MB1519;2:boRAR/FZXtAlZCghqjroPbZczZ93NtuapqAbsibfql5VCdDjlq8uEi7XRnHJ4MvO;3:EGbqBsEgu2JPawov1Jfv6zhr4QjuOZBJakKmkPs94avpAub8f981aHIfsx9QNXDuT/cl9dK9xgmbmTHaKDRmC0UqW6dvovtg3SpcT+qY6Ni3lWB3Yqjvis/DfGbR07NNhY1sjgAIGMZ0gEvs5fgW/Q==;25:lIwEHFh0iqd6dZssYZy8trK6fYpAXcGCfJIx5vI07LNyFrXaQPYBuecOT4uSml8zAO0/gGMfPFP4xuHCxnWcaPlxSC5UaGRz7LbZcRLE4m2BuynPggo4oWTfJGntzRMTGXR8S2jMfO3uRxDO9nifAz2D+UziNNXWojcBVewgRBEqddwDO7O6GoKgySki/ZHPX6RI8lCNq/4a8LwpupQAOTuSHV0QjTDFpTqk0BmZ5Reux92n6Ph4snufGyTFOrIF;20:PKuOAnGX4FlP6kqVNoTFDTdA4smn3G73S2/Py243YMJusdZRqNQrinDclTQAJ7Ey7zsbIrNMap3uQ3MOxej3R7zdn/ao3bzQt/9bIvDiLmDY+oijBMkHFBr+ONkW3jSALtclh138x4ZvFuNFTOqC/Cp3becFFy3Tj5Aa7M3V8hc=;4:FmtPYcJNJShh5rbk9KCofkaTMFmNtRRJyppgyEKR0wo/bhiqTl1YSGCXgs+1H04qv+BuP2+u+lKEuSR9PgvMuU/vHXLIAHERqplw/rTbEhzW47rJ99JhXYnbHeQJ3DUvyfhvXiVHFmovgl0h0dZqo525f2CUcF6/o/jGrvlPHGQ7Z817IMnHEvEzbCYlu+Vd2sDq7dUNbqli1NEsRYzgVaF8wH9LrAGFxOU2yA+OHDaWhppy5UdQBGoo2RFFuDpIl5UoNKkQqX+y//2GFxiV3jvoqRz4QeorIIZwMAS66Ec= X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:CY1PR03MB1519;UriScan:;BCL:0;PCL:0;RULEID:;SRVR:BLUPR03MB232; CY1PR03MB1519: 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:CY1PR03MB1519;BCL:0;PCL:0;RULEID:;SRVR:CY1PR03MB1519;BCL:0;PCL:0;RULEID:(601004)(5005006)(3002001);SRVR:BLUPR03MB232;BCL:0;PCL:0;RULEID:;SRVR:BLUPR03MB232; X-Forefront-PRVS: 06400060E1 X-Forefront-Antispam-Report-Untrusted: SFV:NSPM;SFS:(10009020)(6009001)(42186005)(19580405001)(19580395003)(229853001)(53416004)(46102003)(87976001)(122386002)(2201001)(86362001)(86152002)(33646002)(62966003)(50466002)(77156002)(92566002)(5001960100002)(2950100001)(48376002)(50226001)(107886002)(77096005)(5001770100001)(76176999)(47776003)(50986999)(5001920100001)(5003940100001)(189998001)(7059030)(4001430100001)(2101003);DIR:OUT;SFP:1101;SCL:1;SRVR:CY1PR03MB1519;H:linuxheads99.altera.com;FPR:;SPF:None;MLV:sfv;LANG:en; X-Microsoft-Exchange-Diagnostics-untrusted: 1;CY1PR03MB1519;23:Fwv9LUelzky3Es6VzNlR5eTDSRut2CQ3AJ/PfQ2Z4jBJn5Wct4859BGFbgl9405s7lwdDNe7WZpVlIVzHKOT2ELkui2y0sTEllGhu3GGQMkACFCu7zUH/fca7mJ99XSZeAHXBRH6a0Td2zF1AFyy7MCJ7kkL2Q/EVX5RsYanTiaNfRw3Y4nRAvGkY1zcObNgoDw5+KdoiSjvt6JRJkoEGPmDdgyg0dcICiqofuDd/FzEeKEYi0ZnoXswyj8LOOe4R11CK+Tp6qZSiyvti/riuBpiKriEE7sAF9QWmqpRW6rMcqhFCQ8Sh3eimVcdZwlojrrknvAC3HblYmaMdp7s8RfvHx46SpanwjAeJEk3j6Fnxlyes6T10D2HNcnC8a2kAE3/CTEz1kXKQe6r16f3dnC0rAV3IJA01XeaQImy17fAwBlQo164O5YoqDALFKiHdEmmYAp0PuU0DWHCmyAuH5vtuZvXRczyGUGObklSic7IgI1lwsLCGyVlBuRMONDgQUTincYMdb+UHzu4TGCBzSeZDWyEj/cuq9vbfhwwOyR4tOBF7AjC9WaMyGjkcvKyPrL5RL1gWEtG/F2NpcBVaL/xZRegJT7C/RIWVfyKoaMHrEPYqhpJzifeSfXQk+vd88B/etKWF98vBRqU/kGxuDYmFgKvKV6jwn3qRyfPG98b+lhkFcktIf8DDn+KxJKWAlxeOmHJavPiDsCvcn+BHOAjx6QaitStcEw9/DF597oup05BSEHPmytQ9YwRBUEiQxvlhiioM5LJh5a8HgHuGWWqs0soEoDjb4Huhi39AuL0wsJORyMe7rpnypKrcUKQB93vPqYyoyU+zxzlC5cbCmo0T7ycE3sGrvPqoqaDtJ10m2LTAPkuyta7CV6LreHO8ypBd5RkSdaqPO0Sh1b9Zx36JfuhUCI74V6l9xzZwMU= X-Microsoft-Exchange-Diagnostics-untrusted: 1;CY1PR03MB1519;5:lEKEyO6lOeseyYYtfLRsOpmeAJp3P5W/zE2j6ucz9PjkaHiOTRpvgGuywcfHbEeYYNDyZn9UMLF8ebsgZ1OBf770tJM+64K7/lMZyysZUnB9LLaBZy0L7PAGf+PkZZAQrmZiKoOUv00nsaAS4uqnkg==;24:jQ1zVkbBBNmI62NxBm22oWi+NJW/3kzQDfqNzsn81U7fzWwnWhfQU27cxtuEU04+s8tF2nTb6f4zNYdVJhJRR3CNWQAlPa8YxRb3hN150s8=;20:E3G0q5coiKxL6285rje8wb7kV5dvbEJRryVAGhhhXVEqHcVg6jfVX+AIZQZON1sySYHITxrIYbTvNaTmqCUEwXTveuPsTjWeOHu+3zMoDae4H4KhtPZsk0f0mzWZTVmLxnIAIh6eT3Iyp69zKh1K6CXeWq7/SuTkORVuWW+iwLc= X-MS-Exchange-Transport-CrossTenantHeadersStamped: CY1PR03MB1519 X-EOPAttributedMessage: 0 X-MS-Exchange-Transport-CrossTenantHeadersStripped: BN1AFFO11FD007.protection.gbl X-Microsoft-Exchange-Diagnostics: 1;BN1AFFO11FD007;1:H6ocsTFD8wtohbX0IZ4IqI5p2CaUBZ8zwrF04Ml/LchPZUKQWB8gw5kkGoxVUbTcwqrRXkzU77nqPTGI/SrGisq6BkhB8eLUPpokuayAuNqY7BRYGhjNyePUPlGM1k4Ax1hQ/plDrYLrmKjACJ9xFDtcy4DWKgPFU2Iz0jek8nEQX8xSGgGlJdxgUDh47ycjQTUFh/3SzT7qp1SdowIwSZGilnwDMhV8eZqdLRNWlo+IwcqlKWUEZlwo8ipf+48l8VIDp0uygQi10SQNTCghXZZtcG2zvNQWM//2OkmckMZEVRPZHJlNrvOc7xP3Cwko5v7ge+1QEvqaOa5FImo+OTmf/a0mQo+VO2FprZTMqLtlKDhffDxnI5lBb7rY4ILxDkXJNvSbPE1a8/it/ElW5qu2uNWOYqTkSzpnmWLs94KSooaUwVbwAbgDDl3DL3r4 X-Forefront-Antispam-Report: CIP:66.35.236.227;CTRY:US;IPV:NLI;EFV:NLI;SFV:NSPM;SFS:(10009020)(6009001)(2980300002)(339900001)(199003)(189002)(5001960100002)(107886002)(5003940100001)(92566002)(189998001)(5001770100001)(105606002)(48376002)(106466001)(47776003)(53416004)(50466002)(33646002)(19580395003)(50226001)(50986999)(19580405001)(122386002)(86152002)(2201001)(76176999)(5001920100001)(87936001)(85426001)(86362001)(229853001)(77096005)(6806004)(62966003)(77156002)(2950100001)(16796002)(46102003)(7099028)(7059030)(2101003)(4001430100001);DIR:OUT;SFP:1101;SCL:1;SRVR:BLUPR03MB232;H:sj-itexedge03.altera.priv.altera.com;FPR:;SPF:Fail;MLV:sfv;A:0;MX:1;LANG:en; X-Microsoft-Exchange-Diagnostics: 1;BLUPR03MB232;2:7RrBPeevx5vUPOg11Z8bET3/ZxzzczFTBiw7S2nixKdTJc9VblpZ1tuycha63I4G;3:Y5O2LWzna1bg758qpLp4nLNptJitOij8a1N6DmwiXNC/YZdVCi1n0WuVfnVsNOISyaVMRQRu2kOhe1Yz70y5rJzvpS27vnnANfOa2c0B0pPSAJ3qzKrS5XehxQsNIepo4xaWXu/AWhlbNkNPSyWo7cuit+f8tgM8umMwCunXCUjbYxayCuqYvrfdq7WBChZSUmusuIK9x9rLavM0ouPcrRxc6hf1TiMuGhhB4zC9Ceo=;25:7kfToJnb6tRWGm7KozDGD++XroCpio5z7XXkXaWkol7eQ7tfNBXmUdxYPZdS9YOSmYEFRT5ID84JnvHKOgmu4M1oq8q+eJdqE/l8Q80IbqmxJK239MShBJ6DU6qcObPOfhJGKgCfypnswNkmuIaarq1NAG4obvqOVieR/brLj9ldsnWD8RxIqO1reLZVF3IDMXnSJJ693zRzccuaqPRgD7dwwnr+/QytH0rHN1MSn+pY1IQHXueJAeygpyw9SiK0;20:oaPuBJDEqn3cT7BRuPV+BiKIEeldcRh+jeRzdCLHF8Ci0Nt1EMP5WSz5lvYAh2SsRLZxk5rlL3kEEavXmvzbl5AgQ1UyUc3Lq6/pO/e6IeuWgbdZV4YY5cCJpAZbCvPdMwMk0kt4T9CRM+gfbarxGCqlsfK7GaEuWlQG5zcItVI= BLUPR03MB232: X-MS-Exchange-Organization-RulesExecuted X-Microsoft-Exchange-Diagnostics: 1;BLUPR03MB232;4:y+UXgYayz4C1dyBzhxuoCJ7JaGeiiOqcIL6pIQ+fzgm4L7O9y9NuNR+4DflY++y2kLj+vl5bX8DUrhbBubHVf49VCDC7TIi5sLwSdYkaEC2dnVaQMNz04d28dl8Wrio8PzfGeDbhWNCSsbiOq7X/r37ik+Wdi1UlDF9yokVSPlJJLT2VkPDGsoXSsCy5pQ0izebPU+C1PYbEEG2Z8FMPbvEbl/zOTD4kS5jMuN5C4rMeC/HjpcJwF4QDHc/XWmVPaMFUm5G3blgK1WHJNGf4rBP3fWW4Yvw6d0d/8RuEoNE= X-Forefront-PRVS: 06400060E1 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1;BLUPR03MB232;23:CjH7Jx+7s8inSlkq80x3m9vbbyJBphjTQ9YQS8+hXS?= =?us-ascii?Q?tLec9QCiMxcwtFGwKYeeplZ/U2KLirbsEOWTZMcOD2MHxO0962A/C/vixf7S?= =?us-ascii?Q?aiOukLW1HNJN5Pe0ThrG/hYHk6zG4PsEDFSs3mC/fmo9iR903pkIEqlwXsK0?= =?us-ascii?Q?gDVlRJf3/CSHbQQo3XVt+0wVEnJjbNp+P1wrNUNSo7Z9FRrj7DvwaIz54TUH?= =?us-ascii?Q?TuxlIuN+A0pNkkyCqdzZC+RIwHr4wiJf1SjJluCvN9PvYXEmvG5ouJkwTkBW?= =?us-ascii?Q?x69Q8mF74rnmpys1wBGBotwzxSCW3O+sDWdAJCK1HfuYG77C50nXdOwdrPW7?= =?us-ascii?Q?3X7L5PjGLOgkicpzJF4QSrELoBoWonzjTtGjNhe9FEw+FWlq46ncDxKJgjqm?= =?us-ascii?Q?uVrySf4zgLNvPOPomVlZSdNXiGEliGsX60T42fcq3yw26lWJB4f5BEwqVEAh?= =?us-ascii?Q?TCNh//u1SrR3Pr5fgP4PbaYipRM48z4GhWR9v6MKG2mrFNmbL21fkbiInhZV?= =?us-ascii?Q?bMjyd51eN6OPq2g7MIaNKcuQe/d/KZMqJBSiqSsWhjXTO9vcMqZ80D8w9cBm?= =?us-ascii?Q?UsHtCAkHGyepLfuS15ckfp0diLhz04D1AsYo2Y86uj7cYvSWCm2GjjsRJsps?= =?us-ascii?Q?PKfWcOLib1o7NV6S/d/OTLX/EpkAj/ZG3Lb7lCb3SVKGplVbM1oytRnuyxfk?= =?us-ascii?Q?7mzf5pNGLnVNby1mxSYRMqC4/HP101UcNGISn71UQVUBhEJSDC/mQW4GVA8k?= =?us-ascii?Q?GV1q0raYfTa+RTsvhNfS287vjW2fNVmJAC5YS7/blITVlE/CqtwQnPO3YZxu?= =?us-ascii?Q?sIc51shLZEgNxq20jzcKJdHzE8iymMndCSAOUgN6DG3E2MRuG8wFAQf3eR6d?= =?us-ascii?Q?xIFSeaTh37VkDWz1CWUrR355GY8aNTbZhCUPG6sDGfF1fEgX16OQIaeJZMjz?= =?us-ascii?Q?dK79Zuno3LVgROpRqRun6S6dUqayfFs4ZYZ+dsryXPEyy7BfnQQ2gnOOduwc?= =?us-ascii?Q?/2T/PxRxtcdEpp1ux2F3sT2+RrcTDZSk9ftM+TAA3xPYDOkOvquRJKAMiCCr?= =?us-ascii?Q?4R/iaqmT33Q6HDHUEdD4Yw7LYB6iLn4FjjK88HJF1xT8cI8A=3D=3D?= X-Microsoft-Exchange-Diagnostics: 1;BLUPR03MB232;5:2WPPXU1/puFJp+2WgPkFxdcQT2EIBL2FgbcjjFo+44okr4KOTHVNbpDoWxm2li6v3saBy9TlPVlTWg03FXtj05EcOJJQ1VI0PEajpm/VWh4tlJvYXU6Q8w4OVI35ApC4OTsWDUbqqZkI5UNgpIO1ig==;24:MdN9etGxy9jzD+6FmDuex9JEuXT1gJjPJ4cypitWz8oMJmXvHS/udns1bcSiAF7KkiDeGroqH86SU04OSbWtI/dBO5sINHg04s8CqRkog1o=;20:l53sbs/RlzzInOZflvqi2hoBEda3cX2Dv2XPGriX1eZFUHhignRWUGthneqZT9Vts8ESoFiTJWS+Wxsvy9oosoIj/TyxnZTl6raZ8JiopOY16qBuvLI2xL6LbhnZ0Rsd5WKRn13nUzdG6JD6BESZnX8HklPhD9xBpi/PAEBsh2o= X-OriginatorOrg: opensource.altera.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 17 Jul 2015 15:56:25.1402 (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: BLUPR03MB232 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 2611 Lines: 85 From: Alan Tull New bindings document for simple fpga bus. Signed-off-by: Alan Tull --- .../Documentation/bindings/simple-fpga-bus.txt | 61 ++++++++++++++++++++ 1 file changed, 61 insertions(+) create mode 100644 drivers/staging/fpga/Documentation/bindings/simple-fpga-bus.txt diff --git a/drivers/staging/fpga/Documentation/bindings/simple-fpga-bus.txt b/drivers/staging/fpga/Documentation/bindings/simple-fpga-bus.txt new file mode 100644 index 0000000..221e781 --- /dev/null +++ b/drivers/staging/fpga/Documentation/bindings/simple-fpga-bus.txt @@ -0,0 +1,61 @@ +Simple FPGA Bus +=============== + +A Simple FPGA Bus is a bus that handles configuring an FPGA and its bridges +before populating the devices below its node. + +Required properties: +- compatible : should contain "simple-fpga-bus" +- #address-cells, #size-cells, ranges: must be present to handle address space + mapping for children. + +Optional properties: +- fpga-mgr : should contain a phandle to a fpga manager. +- fpga-firmware : should contain the name of a fpga image file located on the + firmware search path. +- partial-reconfig : boolean property should be defined if partial + reconfiguration is to be done. +- resets : should contain a list of resets that should be released after the + fpga has been programmed i.e. fpga bridges. +- reset-names : should contain a list of the names of the resets. + +Example: + +/dts-v1/; +/plugin/; +/ { + fragment@0 { + target-path="/soc"; + __overlay__ { + #address-cells = <1>; + #size-cells = <1>; + + bridge@0xff200000 { + compatible = "simple-fpga-bus"; + #address-cells = <0x2>; + #size-cells = <0x1>; + ranges = <0x1 0x10040 0xff210040 0x20>; + + clocks = <0x2 0x2>; + clock-names = "h2f_lw_axi_clock", "f2h_sdram0_clock"; + + fpga-mgr = <&hps_0_fpgamgr>; + fpga-firmware = "soc_system.rbf"; + + resets = <&hps_fpgabridge0 0>, <&hps_fpgabridge1 0>, <&hps_fpgabridge2 0>; + reset-names = "hps2fpga", "lwhps2fpga", "fpga2hps"; + + gpio@0x100010040 { + compatible = "altr,pio-14.0", "altr,pio-1.0"; + reg = <0x1 0x10040 0x20>; + clocks = <0x2>; + altr,gpio-bank-width = <0x4>; + resetvalue = <0x0>; + #gpio-cells = <0x2>; + gpio-controller; + }; + }; + }; + }; +}; + -- 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/