From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751754AbdCQKBZ (ORCPT ); Fri, 17 Mar 2017 06:01:25 -0400 Received: from mail-sn1nam02on0048.outbound.protection.outlook.com ([104.47.36.48]:10123 "EHLO NAM02-SN1-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1751315AbdCQJ7X (ORCPT ); Fri, 17 Mar 2017 05:59:23 -0400 Authentication-Results: spf=pass (sender IP is 149.199.60.83) smtp.mailfrom=xilinx.com; kernel.org; dkim=none (message not signed) header.d=none;kernel.org; dmarc=bestguesspass action=none header.from=xilinx.com; Subject: Re: [PATCH v2 1/2] doc: Add bindings document for Xilinx LogiCore PR Decoupler To: Moritz Fischer , References: <1489711910-17443-1-git-send-email-mdf@kernel.org> CC: , , , , "Michal Simek" , =?UTF-8?Q?S=c3=b6ren_Brinkmann?= , , From: Michal Simek Message-ID: <9f823c88-ccd5-7534-9999-019c8a9f082a@xilinx.com> Date: Fri, 17 Mar 2017 10:57:18 +0100 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101 Thunderbird/45.7.0 MIME-Version: 1.0 In-Reply-To: <1489711910-17443-1-git-send-email-mdf@kernel.org> Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 8bit X-RCIS-Action: ALLOW X-TM-AS-Product-Ver: IMSS-7.1.0.1224-8.1.0.1062-22946.005 X-TM-AS-User-Approved-Sender: Yes;Yes X-EOPAttributedMessage: 0 X-MS-Office365-Filtering-HT: Tenant X-Forefront-Antispam-Report: CIP:149.199.60.83;IPV:NLI;CTRY:US;EFV:NLI;SFV:NSPM;SFS:(10009020)(6009001)(39840400002)(39450400003)(39860400002)(39410400002)(39850400002)(2980300002)(438002)(189002)(199003)(24454002)(9170700003)(36756003)(6666003)(81166006)(76176999)(8936002)(63266004)(8676002)(4326008)(2950100002)(54356999)(2906002)(47776003)(50986999)(53546008)(31686004)(6246003)(2870700001)(106466001)(36386004)(33646002)(305945005)(83506001)(356003)(9786002)(50466002)(38730400002)(5660300001)(65826007)(189998001)(77096006)(23676002)(31696002)(54906002)(86362001)(4001350100001)(107986001);DIR:OUT;SFP:1101;SCL:1;SRVR:CY1PR02MB1381;H:xsj-pvapsmtpgw01;FPR:;SPF:Pass;MLV:sfv;MX:1;A:1;LANG:en; X-Microsoft-Exchange-Diagnostics: 1;BL2NAM02FT013;1:6XDtPhbGeLdXt2OjY4S42iyNofFGU9H8d1lB3cAWh4y92RQ2T8kZrVPGPBLTgvYLs5BHDB2KmIiEfFCUxWTlW6WLqilqkNq2KpYMwk4Q5ZYpUTdbSwNuZhPVDv2PGBhMqgvoS2eXUj8RzKXdfHQzUFW2cihjGCXhGg+rBM1VtngRGVkc28eAY+qd7+xunXcH1RtI14INJG9gEdU7KeQYdwCp0zJmYAcPny/ZojwNwDg/ttKmgJyuFG+8Et8RfDHnJTqrqYeSyBfL/h8ZfpRtIoajDYj6dTMYIkAIvjTGHcMV+wsLyxQtrvS645PKLneZH0c6Sjgao4bTQ7TwP/8TE7pIZAbvsIOyX3Nay2ZTxDFcP+tCwfwSJWvvMllDPV3wvhLgem4hEJXkzXRsaWB0FfS0l9iU3V6/J+caVbuBLX3UX5wjd9RWFDrw2sk+gR4Xk9r+JQY/2l/GZb0+n6RKjqEo6UxkptTvkCseJY5M3uzIz1RTlNCkR/rDXuA2Qf98dnbjTUqhwxaKunSvSoq5EnIlWDzJygqzp3w90MjhgZOjV9dIaTWCrbpIBkocl0Bu X-MS-Office365-Filtering-Correlation-Id: 6c228dd7-5150-4bf7-3f60-08d46d1c0450 X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:(22001)(8251501002)(2017030254046);SRVR:CY1PR02MB1381; X-Microsoft-Exchange-Diagnostics: 1;CY1PR02MB1381;3:Rqe7gCA7ZVHsrr2AbvOOlvmxmmtFKrsERtkQwhRNN51hciC4SKZd/mfn/w5XTzKMObvNT7elJwhnjCT8AQ0jpA2pfW8k6vNrzbrYLLf0buWIdFjC9unnDe1xtiOotXIWdjHaKZHuYOeI20j+Rj99oIcpY8+RhFTg5KVbpzFw7iDzMxcjsfEx8vc3OdV+fyG717u7qaAeycJSz4Lxwa1H05PacPrRDrz72tRX5e5NI918T2V5eYIQHKGpDG6OW1F3gDyJOco2a9B5kH7ENOGZy0EDfFS04rmu0lGZCsdBNiZwgx6a/mD5QM3U5uYCId+RP4uV5XQDhPqkKK8C5rMpUVmA2qMGo41GRx3o3J5+rcLdaPscmZ9hxPXBdk4oRCUitW+n91+ahJHWKbvjhV2hUrGuBmPdhnUBJRGZLifi1I4=;25:jwmTui7Z8wVWZC03GrgWo9F0Gz8FPYHl4eqVBMlOLXhjAKxMTzlxOJf6qv9iyCDVXlNzNs/A78Aqhs4GuBGEt+9nOjpqkZHPDiro3O/QdG6fGR98c3DOCjNmYhzxtrBZFYhd7brv9PbkGTy016NiaTIE3MqacOAA8iSh+cDcl6haQ17wa8GSOuZz6k3TkA444QmowNX+mfjdoVUMM31KWhVKiPjaJmfAmhiGaVRx0s+ykgYG4LZ+2Qm9ciq5EeYDXyhUnzTcH7ZcawLi7x86pmVJgEEdttl4IKxYkQouY7PpNCqGTMhH9Xn0F3AGYNQx2cKn3BtRIeHzLi5YSTi34SmfvnXJOiIDE2D+aow5eCvxnhWTTJCRhk0Xzch0ctp12aWcDGrs/B7Wi1eAwHXbthBzG6j65JqqyxQBHF9icbZFGNeFbyC0BeyzO3fXxsxXWLGcmIinDJ7PB/+Q18X1Fw== X-Microsoft-Exchange-Diagnostics: 1;CY1PR02MB1381;31:qZctLZJXVv1THMYfjYm1HKG6ZDqxaDIqe3ENUHiMDcE+cvwzOPtb/FHb9bwdZwPaO/Y/KTMwgsLdZML/0IjyWGf5M923NJXiLEVbzYr2kpSwqN9f0df4yw9tCS1Doq21biM2FnmRz9aaWABl6X55CwB5qVo4dlH1bWFzx0qldU7qXV7YsEzDN/i2+rIrEfeU8qwiFAj9aABgM0t1jj1Hmlrljo+f78UYsGlrmVGUe+vz+xQp1D7t9Q3T3KOYYss/C6LdYCJKXhOsR6M7mlzRpA==;20:/GN4gonlB57TExP25oDhynuNMr55Y0rI1sis/eUgy3aHfeSdo3F68+bCG9RGKz8kHrKTfrsS6Qf80wOnce5ep0VnMCZYJLEOl3PQlLAGAUA9S4qslyIEthopseK45nAbJAbk+eiVsgSUYNIHZLGeJ4Cmxfl498nGWkEvJcTnwc3i3KIipqD7MIBMYxX9maQZ+OxnRdKihDHm3qAc9l/kkfCyuxbcNC9N7We0xATqcXpyMYeqaH8uyvitri2+iZPLq40Q9sKkDbIzXUmxUn7seBCe4z49Z4mYku+2lfNm6gwWUY4Y/Aa3jRKn0e61UiaKzxXYsMh9+Eb1NO4agfiNoP5hqDR7VYzPVFq7y8QWwMGB6mmAA8/qKBd+XVOZYhgCBvbVb9Cs/M0oqOkRi1Y/J8oe4umhPHaamV8BxWsUtlZIBSYNQbiSl7JsrX9hdy7B1RPnXGaQ2po2DFmWCO+oQz1u1YVcbN+MnS/xsrFniI6V19wRYt/nHwktLpHElkCX X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(9452136761055)(192813158149592); X-Exchange-Antispam-Report-CFA-Test: BCL:0;PCL:0;RULEID:(6040375)(601004)(2401047)(8121501046)(13015025)(13017025)(5005006)(13024025)(13018025)(13023025)(10201501046)(3002001)(6055026)(6041248)(20161123558025)(20161123562025)(20161123560025)(20161123564025)(20161123555025)(6072148);SRVR:CY1PR02MB1381;BCL:0;PCL:0;RULEID:;SRVR:CY1PR02MB1381; X-Microsoft-Exchange-Diagnostics: 1;CY1PR02MB1381;4:ZyWnxY/WqLfxg170q4RhjkorFgaOjv8iFMoVHrhI2hp46GG7DY9Kl5HTe9ACUQ06XeYiAD1ya6gZvys1/LJc62V+2hedDiA33QzVeIkutva8WDYXyRAw7Vo9VKRpCoEoLdfCIAO7/YXPSqD7QWydNpaZm8cbtGX17GMKr7VHDCxz30D0ImYpGFjJynsickeMvXhUVwvlOERv/MjP0v4UXnF70c6owb0bz2Tg70Vcqe35eiG2u6DyKXEHw4p3oCEIMDCHdiUYPIST731h+Bvx+iX4Wjs8xXdlhrT5pRZGRdrlowut2uQLz6R6nhcbc8SFcXoC1UI3ozBxB13RQ5i2W+BtfZK4bwBNw+uT+8rCYBf70TqT64avn7mIdDZ+AGKfjXImr+rtAVZw8xUqjzT90mv8okVbuWK0hcQcMRDrMRlfktMeAKn3JpysgyznIQV3xmbptS9Puatw9trZYw1S9VKPkZ6zo+oy6BingtasIApsBEfgbD06skmcM0a1EcX3sRfla45YGaBmOGEeGpgjNPPsGnRiAChf3089ZJg3NXU5+k66S5AGT3tRBkbDTOwbC1eOmGYx6X+jmcM8RLi47QkOHupoJ5t9gDBXPGrYpQZ3QsVwiD95CfBMUVLpKr64i7kahT5vxX4AdpB2sIzZ8z1ZTBwd8aDWLobFGKMyrQCERlYLuJdBxe4GdpWc5OiSUfAhcj6g/4T5mU2wnom00spXVcdX4X5Bo2kgL5SdpgmvQS+STgD7mFGMwDMJPUKfvH80XFQLVl46Jcx/w1kN2O3RZONbSBDTGdKG2LaI0Lw= X-Forefront-PRVS: 0249EFCB0B X-Microsoft-Exchange-Diagnostics: =?utf-8?B?MTtDWTFQUjAyTUIxMzgxOzIzOmYybHIwR0k4OUgxQWk5V1pYa3dVa0IrdlNI?= =?utf-8?B?VU1MK3pCZXltVWtzTE1Nd00vNFVjNGtTdTR2MDJWL0g5c1JDM09BZ21jUFNR?= =?utf-8?B?ZytpdFN4SURaU2F2VVh5b25ZTXZXaGM4eCtoYjZHc0xRSzZyNGQyN2RhQng4?= =?utf-8?B?Ymdmd2NIQmtFTXFZaktTeXBMNTliYWl3U2VjZFNGYXY0VEUwN2lLMEtNcC82?= =?utf-8?B?L3R6ZDMyR0xaTEc5YUZtMzRUSEczVTdEWEt0aGY5NmNnUTFGb2dyeUJIUzZm?= =?utf-8?B?NUZZRXpoSk5maHh4dWhTT2JSTkhnQWhtNCtTN2tDTzdsMHZiRHNhMW9rYTdj?= =?utf-8?B?R2QvcldIUkVsVm0zNncrNFQwbGlEZHg4SUJ5MnBCRWRnRXdEVFY2Tm8zY3Vq?= =?utf-8?B?cnFTeXlXWnpWT21tTU5JRThwVzI3TVRmNW9hWERkMXlVd1Zud0tDc0lXbTBv?= =?utf-8?B?S3E1ZTA0K0g3MXN4Kzd5cGdKcE5UU25qZytmZ2QzWnRZc2pGNFIxV1AzR2RO?= =?utf-8?B?Z2ZDdG1aQlhveHZkbE5pejh0YnFYa2Jubk80Sm5ydkNoUHFzNzNNSlBnYXZw?= =?utf-8?B?dEUvanNBWVpBZ0dEN1ZkZ0F1Y3IrcTdoNU9TK0luQVFHa1RpWHVVME9seU1K?= =?utf-8?B?OEgzYUxqb1BvNWFsRld1RlFySUdNOVlScmxjdWcrNFYwNVBPQUpsOWxLcTEy?= =?utf-8?B?R1dEOG9lY3lRRmRseXl4VGhOeFBpUWZLUUR4YWRuSE53MmpIaExiRTZOellB?= =?utf-8?B?d05LTmEwZGw1ZzdLRVg5S0JVS29jSGhERHpwZjlRU0hRNXRsU1ViMzhPbkov?= =?utf-8?B?ajhDVWtwWTFTSXgyWjFVSHIvZXNPeUJBckZGcnZsV2JUTnVDY0NlUFZ2bkNa?= =?utf-8?B?bG1YZHJmamFFY1pzU2ZRdHBjMkhPNm5KQW1PSWc2NEFXbS85bmU1NERTZEg4?= =?utf-8?B?Q05mbVVVeHZGRklUV1ROdXNnZjlkWkFWMHMyOWgrdTFjdHFnWjFRVGVkUnM3?= =?utf-8?B?d3ZFcjlPRGtWdUd6enRFWk5OK3ZTWkRwdVdpL0JRV2tnMklISDJzeXVtM0V2?= =?utf-8?B?RmZER1VaZ3FvY0JVUGFMTFpGNENITjZkTk5DY1ZWTWVkTXFIbXlYV04xbjNo?= =?utf-8?B?RGlGbFlrYU1NU3R5R0hFWjAwMWdkeG5uaHM4RFBrRWJFZmROQ29Ta2s2T1pL?= =?utf-8?B?bGRnYnBsU0pTVWJMNzJQS0VFUGVaNDZoSmlURTdOWXU4R3Q0a3J6UHg5eElQ?= =?utf-8?B?b2ltRXNDTlBEMUxPY0pMK28zblJYUm9sdkhpR3RhK09KNWVva2lrZTlsR0th?= =?utf-8?B?YnZuaks5cDErUk5pRkVwRTU3STg4bFl6SmpqU0N3N2xZa3MxdlRVbnBlZWt1?= =?utf-8?B?TjZPVjlFTjNVTjE0RmxDK0QvYmV6WndHRWxVanFCZ1Z4MkdUc1lPZXBaY1l6?= =?utf-8?B?N0pLVDhWdkJMYjdPS1IzSHNlc01wczdLaDBNc1Z0aXFrb0RwWTkzRHNVZHYz?= =?utf-8?B?clhlRFVwc2JWN292a1BjWHNBTm5KQ0xBV2FIODU4TUNCQ0xzTnloam1VYUJO?= =?utf-8?Q?/+7qHc+L0hmG++kw73FG0vtwDq4SS4FOjIJ5vEbkmSE4=3D?= X-Microsoft-Exchange-Diagnostics: 1;CY1PR02MB1381;6:JUofV3kTRLT7RPhXfPBoWLdnyn15ocuCrN3dsOMlnQtvaNcEghphgUpjMiz+qti2Rjt4+mKkOTaPSFt19yZ5+TDZhSqHsxPINpQ6KwfAoSRGp+LjX3YTwe4lXs6Kf9hDxeRTJhDAHunlICrSwgZWbJu5TFX/YUImGwBpdhhlPpGweQfFZc06cLvTSFBrG4aC5WQCFalFiYAwK7vmCNq6ekj0RFRYQ2xHi+SwL2f1YmftGKo+Mj4LJu6M09HE8o9WYB+7gTG2vqVPCqPONTTJ/rJz1PynzVBGJgHk12TPJVYPWLMa6hWlH3yfSRyKLWqONZuz2gFa2F+guAQlGACaNC+r52RLwLNNdipvsuzNP6pTtSoEcu6BzkcQKuOghn3nKuPECz5ayGahoO+hwUX0FEdvpHsHsCeVuVG1X3xxj+g=;5:XK+UjxbXsdVxjMPgX3Jze0CTX9E2mQIoGNCYuq0hR9TJBWkgCdOPnjI+8v6pqThJkNVz9OCLgeK5VPlDbX/YXR3Sd4b97i/S6OJVkSiqbqAB/qrkiCiNoBLj9pzkHGwhyU6Xd2NkVOG4mbizhuedNg==;24:VV1ZPe+qudcavMiafyN3B0WSYqeIkrYS0Q6W++L3vT04FGqCJ64jkOkEpkpIOsMLot7iOOSBPP4mRFMRAHDEqnXm4FXqRbegDTkYskfBGho= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1;CY1PR02MB1381;7:QSY9EVNlHMIe5HMITG7GNhwas+eSIDZLJ2rmWcU0uMrHTU+BFKWNIPBitB+A4wTxMMzPGHPbzVm+Nc0Mbq61lVQsCSrmGrJq+lL0vUeQMuuO5rWNo1ulba0kFublSYfmmrztVry1opqISqsAv+sKyRY5VlRUJzlPEhY/YFmL9NIVygrvshMzLJOyv5PezK6WS8Uw+io8/9kIHL/l1o6HoDwjWEC6ZkIyo7LtZRA4N6e0O2cZspibZP29zrR4V7RZdTN25CXAzKz0oGVg17QQdZ9O4U3MSqXJe8VxzqDZRVqVL7VAyRgjYc6cfsgpmZrkUuPeDAlO10RekRtpiLpgJg== X-OriginatorOrg: xilinx.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 17 Mar 2017 09:57:26.2462 (UTC) X-MS-Exchange-CrossTenant-Id: 657af505-d5df-48d0-8300-c31994686c5c X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=657af505-d5df-48d0-8300-c31994686c5c;Ip=[149.199.60.83];Helo=[xsj-pvapsmtpgw01] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: CY1PR02MB1381 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On 17.3.2017 01:51, Moritz Fischer wrote: > This adds the binding documentation for the Xilinx LogiCORE PR > Decoupler soft core. > > Signed-off-by: Moritz Fischer > Cc: Michal Simek > Cc: Sören Brinkmann > Cc: linux-kernel@vger.kernel.org > Cc: devicetree@vger.kernel.org > --- > > Changes from v1: > - Added clock names & clock to example > - Merged some of the description from Michal's version > > --- > .../bindings/fpga/xilinx-pr-decoupler.txt | 32 ++++++++++++++++++++++ > 1 file changed, 32 insertions(+) > create mode 100644 Documentation/devicetree/bindings/fpga/xilinx-pr-decoupler.txt > > diff --git a/Documentation/devicetree/bindings/fpga/xilinx-pr-decoupler.txt b/Documentation/devicetree/bindings/fpga/xilinx-pr-decoupler.txt > new file mode 100644 > index 0000000..2080006 > --- /dev/null > +++ b/Documentation/devicetree/bindings/fpga/xilinx-pr-decoupler.txt > @@ -0,0 +1,32 @@ > +Xilinx LogiCORE Partial Reconfig Decoupler Softcore > + > +The Xilinx LogiCORE Partial Reconfig Decoupler manages one or more > +decouplers / fpga bridges. > +The controller can decouple/disable the bridges which prevents signal > +changes from passing through the bridge. The controller can also > +couple / enable the bridges which allows traffic to pass through the > +bridge normally. > + > +The Driver supports only MMIO handling. A PR region can have multiple > +PR Decouples which can bhe handled independently or chaines via decouple/ > +decouple_status signals. > + > +Required properties: > +- compatible : Should contain "xlnx,pr-decoupler-1.00" should I would tend to do this as "xlnx,pr-decoupler-1.00" and/or "xlnx,pr_decoupler" > +- regs : base address and size for decoupler module > +- clocks : input clock to IP > +- clock-names : should contain "aclk" > + > +Optional properties: > +- bridge-enable : 0 if driver should disable bridge at startup > + 1 if driver should enable bridge at startup > + Default is to leave bridge in current state. Interesting that this is not a bool. But anyway this should be link to bridge binding because I expect this is the same for all. > + > +Example: > + fpga-bridge@100000450 { > + compatible = "xlnx,pr-decoupler-1.00"; "xlnx,pr-decoupler-1.00", "xlnx,pr_decoupler"; > + regs = <0x1000 0x10>; > + clocks = <&clkc 15>; > + clock-names = "aclk"; > + bridge-enable = <0>; > + }; > Thanks, Michal