Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1755536AbbHYJgg (ORCPT ); Tue, 25 Aug 2015 05:36:36 -0400 Received: from mail-bl2on0094.outbound.protection.outlook.com ([65.55.169.94]:27520 "EHLO na01-bl2-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1755496AbbHYJg2 (ORCPT ); Tue, 25 Aug 2015 05:36:28 -0400 Authentication-Results: spf=softfail (sender IP is 66.35.236.227) smtp.mailfrom=altera.com; vger.kernel.org; dkim=none (message not signed) header.d=none; From: Ley Foon Tan To: Bjorn Helgaas , Russell King , Marc Zyngier CC: Arnd Bergmann , Dinh Nguyen , , , , , , Ley Foon Tan , , Rob Herring , Pawel Moll , Mark Rutland , Ian Campbell , "Kumar Gala" Subject: [PATCH v5 4/5] Documentation: dt-bindings: pci: altera pcie device tree binding Date: Tue, 25 Aug 2015 17:35:47 +0800 Message-ID: <1440495348-2666-5-git-send-email-lftan@altera.com> X-Mailer: git-send-email 1.8.3.2 In-Reply-To: <1440495348-2666-1-git-send-email-lftan@altera.com> References: <1440495348-2666-1-git-send-email-lftan@altera.com> MIME-Version: 1.0 Content-Type: text/plain X-EOPAttributedMessage: 0 X-Microsoft-Exchange-Diagnostics: 1;BN1BFFO11FD008;1:h6RCg5VsnHrjJkvT9tOaXG4+aSjPIya7Pr+kC6A0mR76D39OsTOG6RFMzMIn47Q3n/lrF9rWPFDBNerCtfuEEQ2/LYKXxng7/cAGU8BM0ICcvDQvr8Ld5LswGJMAfJsDAErFRn1uwKx9dponJU7qnhrTvSnOxWV/F5D+vVcW+C1Ww/d+yQE2qHVsS9tCOrRs039yWBBLpo5X4O7n3L4uiSjwzagWDoDHxXeRHi0NbtJGRf2G0bURoxcbZbvO2/LM+9SdWizlucLf9aB9IBOy7xFBy40oIJZ2Np+fK6RSOlme4ogbkJ3l2JCWk0BpjkEfGZbqnHz9J1cgpUMDIkmAb6ST+QUCT7PonFnvgeoaWjdZ4XnUKLyrt3ON4Quz+XVr X-Forefront-Antispam-Report: CIP:66.35.236.227;CTRY:US;IPV:NLI;EFV:NLI;SFV:NSPM;SFS:(10009020)(6009001)(2980300002)(3050300001)(189002)(199003)(5001770100001)(5003940100001)(42186005)(48376002)(68736005)(33646002)(189998001)(36756003)(105596002)(64706001)(106466001)(47776003)(50466002)(2950100001)(50226001)(19580405001)(77156002)(5001860100001)(92566002)(50986999)(4001540100001)(5001920100001)(81156007)(5001960100002)(229853001)(62966003)(76176999)(5001830100001)(5007970100001)(19580395003)(46102003)(6806004)(87936001)(97736004)(86362001)(7099028);DIR:OUT;SFP:1101;SCL:1;SRVR:BN3PR03MB1496;H:sj-itexedge03.altera.priv.altera.com;FPR:;SPF:SoftFail;PTR:InfoDomainNonexistent;MX:1;A:1;LANG:en; X-Microsoft-Exchange-Diagnostics: 1;BN3PR03MB1496;2:eJiAUR8GUju71UhhsYVD250WAeTEfYzQEGqgei+/VT4YS7YSoMV+3j2TbslqeiroNKRaxwAdsj6V/2jw2Dkzej5oFssvnqYcVslhHiPZhTZVQH4JXNWnRJwpyS8zLUErNhHPQaC9/ZYvqld+HKjga6px63tNDl0AQDvrSpNplzI=;3:ZtSr1pQeBji11bmLYHylXHTS/CL/DZviKJee5wpFhrbU5+Yh2//+/VC4Ne1W8q8DGk7WSXYZ0o0VYxws+5KQx8ixvMzRGWmS5PaB5Mxb12dfMmUY24Bc4H7GyFoRgXstnBRdkIz3pfsgzpNeLRZ480ZPZUoY4CjYV7+GowU8/IL3JH0WsneY/kl8Kk5ZAx3RPTnFm+fTzEymzodI/exXHoZ2OIGWsKnRrSm5dnx46FE=;25:7n1TlQ0crf3gFlNewCEmqNznVMbmOZvFtcB3pRzvlVcQ+XaTF1RWzh3MRbaSHcAhUVcizOAtVgKjL4fWX2oGcNAM/tKQLVtDlCfQ5nAZ4UMft9fa9+mwthGULCVBSXGlGxUs+CYD3G9RSVkvTutkdBku4FDkbEoz2ZxIPXnVjtWBAy1HejNTl+zQTP4TVJtv79QVKDWh09NYdyJcvNCJORRhVavHhiHegOczbINC/bUxXdliQDH/K2kzqgaZQD92/17Zm9uXMvOEUllMgN2lrA==;20:VhKB6okSlVrdMA6AK+emCOEPNp09HD/3+Y+sqlGhBOcCE/iBc5baqi9FaMUZhattJEiAKOd9eS6UsT7YA2lRq67mc02pVdxtXHGlRnU4KTWRaQlJhhby8StJWogh6zLuZ79BVBkOqnb7UB8bxlS1fhxcdMIhGTntlT0+UbwskkI= X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:BN3PR03MB1496; X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:; X-Exchange-Antispam-Report-CFA-Test: BCL:0;PCL:0;RULEID:(601004)(8121501046)(5005006)(3002001);SRVR:BN3PR03MB1496;BCL:0;PCL:0;RULEID:;SRVR:BN3PR03MB1496; X-Microsoft-Exchange-Diagnostics: 1;BN3PR03MB1496;4:Q3GdGGZj0eNmSLb/RKyGAKtvOME9w8xkoK6Rjk8wnaQwf6aXa+sewQCGRcg7qAF1BFbSKgeODtW78tpcKnBMEQ/S4KaFpEClf1GSkwuyOja857QpzAlmntjCVGAqd4PcSK8ufRDLae3kHZTRsOn0edJLBauieZiAXExw4mFwejQrPsG+ogyVsi5Yox1DKWMqHZqncttVeURQMSu2ypwPeX4dHXI7a0reSO+GOa73cgENjnZ+7DfQKKQvGImTiiaHiqkDV00juzUg7qy3+xlpioErpAqOrXNpHErl0EDcNw7fH/Kt0OA1+wcRo6MtDU/N X-Forefront-PRVS: 06793E740F X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1;BN3PR03MB1496;23:3JGwg+qIaiPShdjrpaUGBF7JWlSTsixuxk7vHp/tf?= =?us-ascii?Q?LMcwjJ3zZkq8AqMDg+KXjH6KOXH0E+0/Z6KWZc//YcSeM0cSdwnuZj/tGIZ8?= =?us-ascii?Q?eQOp0BEXGCWr+qI3Q/kUFrgeZDXYyCbQr+1vKxugC0w/jEw0TvWjZEBD+h6H?= =?us-ascii?Q?67AZzYsbEUAOVwT53A1NCdTzqhu6hRf3K13pd64hQZGlLuBf9qu+6q/59nqb?= =?us-ascii?Q?DolJHBYVHyj7QrEjPVslR6DqseZvDtwiMAy5a4WrTxp6SMfZrRl6DTlgzwtE?= =?us-ascii?Q?VSXSMd6PVudlCoY+rNGEyY0Zv/Zd3h8vM7W7CQ56ta27FmH+4mnsaLU4KV1r?= =?us-ascii?Q?0Htq6JQktQrEMsJ0ci42c9iXA2ZfYTEpWOkb+CuORWinZ01kq0rEECCivpH5?= =?us-ascii?Q?OQauDSJ4waiMO5hTNUB6qzAPEIuHLYM0fsVA9gv6BE28hnR+xwYSN+t04XYY?= =?us-ascii?Q?rAP72K2W2XU0PuzRjRcBgkZJqK0kR8wrO2RcPMS8mlw82LRxPoG9YRZX2FJO?= =?us-ascii?Q?1Q1LMDWIR+GOJ4PuiMpJVm631VbMO6ZMci42gYIbI2nFNbkO69vYVbRP/akf?= =?us-ascii?Q?mMUOAC361GAKOzWWeuhnalMpUBm4sK9P4FIU2n6ovaCcMOPZbJfjohqHBjWT?= =?us-ascii?Q?9UKE7uR7Z4N7ho6bpGKcqD55ShxbYd0tDB9E3EsIN1IyjteGIdRVxGEy7ZXx?= =?us-ascii?Q?Ed9D8mfnBjZQpDt3EHWhOvNfdPE7z/s99AQ+lVHbxdhBn7Sn/7liR+SMyKT9?= =?us-ascii?Q?1cOqpohA52qJut2Ax246O0/BRfrlFofqQnyCE45M6eIhHOmpe5D2flsDBjrT?= =?us-ascii?Q?3uS5p8BjZctEZYvPvF07XRp+YnWjr7oQ22CUxub0H4lzy3mlSJjVX+DWDspr?= =?us-ascii?Q?/A0RxNbPlTgEzKXvw5TFRFJ4HNqlr1xVWxBHRQYZGNoQlddM4EmZM5Z0aC0w?= =?us-ascii?Q?pnI/kpxHSKcdL9XnJQWL/d/eJ0TteMvPHLBrtvewisAJ5BuBguNTH7gXVkfy?= =?us-ascii?Q?Ku7A0cvoe9Yy73eUrVnvIyK1e4U3VC7/qvzzXfX9Olof23uGkZzzj7o/4rIq?= =?us-ascii?Q?7yNtCQ17aHXnxff+0hugoXHfde8NWMzyRrQ5bSA8QMKsLvI56BpeW5bvxGxv?= =?us-ascii?Q?ixXF9rCN08IoQhDkefIYKP8CEs++v2f?= X-Microsoft-Exchange-Diagnostics: 1;BN3PR03MB1496;5:9WP7qoyhz9K4+OImnnhAci3phdrUmxFvhTtBgoo3wDjbfW0Az+3mlsc1dVTKMn/yGFnjhIyVdMeyRc9VxzifMXRLZxO6V537qMOu9RxmCbhJ12Zuo4r4P7F/Huu6q9Vbno8P7SBOdsAUPtobNE0bSg==;24:pWoAMcQ5xiVS2CzNHQI9Mm8fCSkTr1eFkYXnsBSNjUGM7g08IqsVd9pPu/iD4qvSZnBq9Ok//WeqgXwM3+7Rbw7g72hczn2Qqh0PGnIJo2g=;20:CdOgbRsPuvcU0+Ql3HtMxiUoSWMNu9GIn1TDaqcircOTVzzP7va5VFJpr/F2pCwSqO7niu6YEgHu7dhidTFoluRV8EafQOnpECIcH70dEE2/3QNDZj3vtqqvLzB2StfyjRT7ITFGHt+gLOUQxqUmesK1hzmdaO4KC9BP7jtORMA= SpamDiagnosticOutput: 1:23 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: altera.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 25 Aug 2015 09:36:25.6516 (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: BN3PR03MB1496 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 4035 Lines: 108 This patch adds the bindings for Altera PCIe host controller driver and Altera PCIe MSI driver. Signed-off-by: Ley Foon Tan --- .../devicetree/bindings/pci/altera-pcie-msi.txt | 28 +++++++++++++ .../devicetree/bindings/pci/altera-pcie.txt | 49 ++++++++++++++++++++++ 2 files changed, 77 insertions(+) create mode 100644 Documentation/devicetree/bindings/pci/altera-pcie-msi.txt create mode 100644 Documentation/devicetree/bindings/pci/altera-pcie.txt diff --git a/Documentation/devicetree/bindings/pci/altera-pcie-msi.txt b/Documentation/devicetree/bindings/pci/altera-pcie-msi.txt new file mode 100644 index 0000000..53ad2388 --- /dev/null +++ b/Documentation/devicetree/bindings/pci/altera-pcie-msi.txt @@ -0,0 +1,28 @@ +* Altera PCIe MSI controller + +Required properties: +- compatible: should contain "altr,msi-1.0" +- reg: specifies the physical base address of the controller and + the length of the memory mapped region. +- reg-names: must include the following entries: + "csr": CSR registers + "vector_slave": vectors slave port region +- interrupt-parent: interrupt source phandle. +- interrupts: specifies the interrupt source of the parent interrupt + controller. The format of the interrupt specifier depends on the + parent interrupt controller. +- num-vectors: number of vectors, range 1 to 32. +- msi-controller: indicates that this is MSI controller node + + +Example +msi0: msi@0xFF200000 { + compatible = "altr,msi-1.0"; + reg = <0xFF200000 0x00000010 + 0xFF200010 0x00000080>; + reg-names = "csr", "vector_slave"; + interrupt-parent = <&hps_0_arm_gic_0>; + interrupts = <0 42 4>; + msi-controller = <1>; + num-vectors = <32>; +}; diff --git a/Documentation/devicetree/bindings/pci/altera-pcie.txt b/Documentation/devicetree/bindings/pci/altera-pcie.txt new file mode 100644 index 0000000..4440db1 --- /dev/null +++ b/Documentation/devicetree/bindings/pci/altera-pcie.txt @@ -0,0 +1,49 @@ +* Altera PCIe controller + +Required properties: +- compatible : should contain "altr,pcie-root-port-1.0" +- reg: a list of physical base address and length for TXS and CRA. +- reg-names: must include the following entries: + "Txs" or "txs": TX slave port region + "Cra" or "cra": Control register access region +- interrupt-parent: interrupt source phandle. +- interrupts: specifies the interrupt source of the parent interrupt controller. + The format of the interrupt specifier depends on the parent interrupt + controller. +- device_type: must be "pci" +- #address-cells: set to <3> +- #size-cells: set to <2> +- #interrupt-cells: set to <1> +- ranges: describes the translation of addresses for root ports and standard + PCI regions. +- interrupt-map-mask and interrupt-map: standard PCI properties to define the + mapping of the PCIe interface to interrupt numbers. + +Optional properties: +- msi-parent: Link to the hardware entity that serves as the MSI controller for this PCIe + controller. +- bus-range: PCI bus numbers covered + +Example + pcie_0: pcie@0xc00000000 { + compatible = "altr,pcie-root-port-1.0"; + reg = <0xc0000000 0x20000000>, + <0xff220000 0x00004000>; + reg-names = "Txs", "Cra"; + interrupt-parent = <&hps_0_arm_gic_0>; + interrupts = <0 40 4>; + interrupt-controller; + #interrupt-cells = <1>; + bus-range = <0x0 0xFF>; + device_type = "pci"; + msi-parent = <&msi_to_gic_gen_0>; + #address-cells = <3>; + #size-cells = <2>; + interrupt-map-mask = <0 0 0 7>; + interrupt-map = <0 0 0 1 &pcie_0 1>, + <0 0 0 2 &pcie_0 2>, + <0 0 0 3 &pcie_0 3>, + <0 0 0 4 &pcie_0 4>; + ranges = <0x82000000 0x00000000 0x00000000 0xc0000000 0x00000000 0x10000000 + 0x82000000 0x00000000 0x10000000 0xd0000000 0x00000000 0x10000000>; + }; -- 1.8.2.1 -- 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/