From patchwork Thu Oct 22 09:27:30 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ley Foon Tan X-Patchwork-Id: 7463931 Return-Path: X-Original-To: patchwork-linux-arm@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork2.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.29.136]) by patchwork2.web.kernel.org (Postfix) with ESMTP id 491FDBEEA4 for ; Thu, 22 Oct 2015 09:35:08 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id 91147209A9 for ; Thu, 22 Oct 2015 09:35:06 +0000 (UTC) Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.9]) (using TLSv1.2 with cipher AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id E80F12097A for ; Thu, 22 Oct 2015 09:35:00 +0000 (UTC) Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.80.1 #2 (Red Hat Linux)) id 1ZpCCU-00064x-1C; Thu, 22 Oct 2015 09:30:22 +0000 Received: from mail-bl2on0054.outbound.protection.outlook.com ([65.55.169.54] helo=na01-bl2-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.80.1 #2 (Red Hat Linux)) id 1ZpCBO-0004Tw-NA for linux-arm-kernel@lists.infradead.org; Thu, 22 Oct 2015 09:29:16 +0000 Received: from BY2PR03CA065.namprd03.prod.outlook.com (10.141.249.38) by BY1PR03MB1497.namprd03.prod.outlook.com (10.162.210.143) with Microsoft SMTP Server (TLS) id 15.1.300.14; Thu, 22 Oct 2015 09:28:50 +0000 Received: from BY2FFO11OLC004.protection.gbl (2a01:111:f400:7c0c::127) by BY2PR03CA065.outlook.office365.com (2a01:111:e400:2c5d::38) with Microsoft SMTP Server (TLS) id 15.1.300.14 via Frontend Transport; Thu, 22 Oct 2015 09:28:50 +0000 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; vger.kernel.org; dmarc=none action=none header.from=altera.com; Received-SPF: SoftFail (protection.outlook.com: domain of transitioning altera.com discourages use of 66.35.236.227 as permitted sender) Received: from sj-itexedge03.altera.priv.altera.com (66.35.236.227) by BY2FFO11OLC004.mail.protection.outlook.com (10.1.15.184) with Microsoft SMTP Server (TLS) id 15.1.306.13 via Frontend Transport; Thu, 22 Oct 2015 09:28:50 +0000 Received: from sj-mail01.altera.com (137.57.1.6) by webmail.altera.com (66.35.236.227) with Microsoft SMTP Server (TLS) id 14.3.174.1; Thu, 22 Oct 2015 02:28:14 -0700 Received: from leyfoon-vm (pg-lftan-l.altera.com [137.57.103.123]) by sj-mail01.altera.com (8.13.7+Sun/8.13.7) with SMTP id t9M9ShRU016836; Thu, 22 Oct 2015 02:28:43 -0700 (PDT) Received: by leyfoon-vm (sSMTP sendmail emulation); Thu, 22 Oct 2015 17:28:58 +0800 From: Ley Foon Tan To: Bjorn Helgaas , Russell King , Marc Zyngier Subject: [PATCH v11 5/6] Documentation: dt-bindings: pci: altera pcie device tree binding Date: Thu, 22 Oct 2015 17:27:30 +0800 Message-ID: <1445506051-21688-6-git-send-email-lftan@altera.com> X-Mailer: git-send-email 1.8.3.2 In-Reply-To: <1445506051-21688-1-git-send-email-lftan@altera.com> References: <1445506051-21688-1-git-send-email-lftan@altera.com> MIME-Version: 1.0 X-EOPAttributedMessage: 0 X-Microsoft-Exchange-Diagnostics: 1; BY2FFO11OLC004; 1:0T6Iu/xNt3uoXsNLUUe0lbknYd0rvrxI0Vsvr0EGrB+tvZqU0QSpAgffIKdJFBhdagootxWpipOl8bfSB+DSLjs7QIqzqXoFxbfRSbNHNDTh4v3uwMq/dvS2+1ArsZJtulhmW0qu2StlF76USIh3w1upUuqBOuEy+chfOWyLdf156daTVRTxQNOKVUBPRwpap7If+GNqh47/dRYoyGfpq8F9T6fSLGYXvRmYep7ln0NpvPmGqNWPEYhWx7j8Bh//W1tqxEi9vaZ7o76q/xx418yV4bCgf0krXCuiscMyJ8kfjO7AUTJc0vcTpiog0xvz2fvWbYFIDxtXbShrF4kTbg1UIDT6nZi8cDoT3rFTOMiv+zOL3uNh1vxOZjL0JnYq X-Forefront-Antispam-Report: CIP:66.35.236.227; CTRY:US; IPV:NLI; EFV:NLI; SFV:NSPM; SFS:(10009020)(6009001)(2980300002)(199003)(189002)(50986999)(64706001)(97736004)(5001770100001)(81156007)(86362001)(47776003)(76176999)(19580395003)(92566002)(50466002)(48376002)(229853001)(36756003)(19580405001)(42186005)(50226001)(46102003)(33646002)(106466001)(189998001)(2950100001)(5003940100001)(6806005)(5001960100002)(105596002)(5008740100001)(87936001)(5007970100001)(11100500001)(7099028); DIR:OUT; SFP:1101; SCL:1; SRVR:BY1PR03MB1497; H:sj-itexedge03.altera.priv.altera.com; FPR:; SPF:SoftFail; PTR:InfoDomainNonexistent; A:1; MX:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BY1PR03MB1497; 2:3hQq7Z6d86hupOzkVqrTGusE4lUkVxWW+VrKSDrwhY3yEFpVqG2hqkReudn41mFW6RRp6PF24gXX5LbSEVd1dCdxCICc/nDFp9kjzV3may4/ZfFp7LXZJVptQUbRs0I+4F0gQhfK6XgkfRyfySG+hFz3nt4ca5bMqtMNPDXYzcI=; 3:7qyfX2WRm34B1YCVxHaa4jF28vKAiMjasl4eyn8NzRkITEkePA7K8WgBmSjw/789J8KoNAqG/rvOZQbWh53w/1gN1PyTKSwzb8+LiyP7jwwc9AiJXeOTzav3URCy0c6yG1xVJFUbVPmn+YWhweJrwbQPnhes3H1qN/1xuKYwXMiOkj9ptJFmy7WFP8FFYTw7TxiLPYzZF+PqEds2UrlAfkc84tFPKlAcYjRA4RI89mQ=; 25:B2vPQ6obfOkBauZvgkbAHON+XKRtQaOhIi0I28mUz3Mv2ire75EMjs9Y03dCkh/blfy9rG2/ZoMINfGdQPRbgI7PwptzDSraciEhy68UcOCiP2vDXuE9QABWop0tuRmdmpTgElaU98jjNzH1awwC03i2zIUEGxLkp4BIvHGxypRTso524gLZrbyKqnN0+2t/XEeWcd/1lBO/rfJL3NfmFZsxa5/yKLmvNLeh86sy0iXOFjlG7rWwqsx8ZajCShNyO9FXdmUFE7k74zJL0/buSA==; 20:9O7ESNVDg1l6c+dzt3zQug0GoE1IX1+erc7g2v07tYiVrUMyqHzbwNkTRyzDnHXaIZ3fVtdajD+DWCmrorgbFEe8uKdsPDLG2uv099UOWM2ya3NIdpFVcjCl1ONHALi6c7R+Bu6q/NcCQWH6fqJlw2kxplZNTwjBEcv+q2e7vxI= X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:BY1PR03MB1497; X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(80048183373757); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(601004)(2401047)(5005006)(520078)(8121501046)(3002001)(102215026); SRVR:BY1PR03MB1497; BCL:0; PCL:0; RULEID:; SRVR:BY1PR03MB1497; X-Microsoft-Exchange-Diagnostics: 1; BY1PR03MB1497; 4:T/qHRXtcJMH4zXNj2jQ/jkZwqu0SgKsqdB5/eghDb5YjIntQBriFvJ0wQDHSpRYNrK9TY9F+FSs2gAime5vUNucvQ45NA2/HYJqsQAhBTvCHwfxJ6l92MooaZgQn5vx38nMEupr84Mv4f5BYoEhwB56WQRU2uXRD7jEbD3rMUtmbjKtYAom1Ss2T2Z2wr9SSTGMdJOdiT5DjFSWs5T4iHlqyjvKTe9gtVzMm0+CbxFm4vlz3yaZgHlDwOj12uWLaOZQ2YySBmg9sXEzJkmgswfKeaAVx9oMWoI53asQynO/4p8JhvGeBlnWQLiTjsj1Ol2Eh2J+Z0irgJinwL9aGTGgiFtOMDD9GOw3G6heL9B8nUas7Uhl2aj+Laa81LBT1 X-Forefront-PRVS: 0737B96801 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; BY1PR03MB1497; 23:01T50fTwfOY6W6oSuL3PEEEiynp623MCr5YR9M0TQ?= =?us-ascii?Q?ZkWkNLg3yZoQVdFTjzS/0qjRY+hdMKsANXFfSwOtnCcIRfmm9gd0LAwnqXeg?= =?us-ascii?Q?v6EOeWr+9k2aTOH4g3aRMjWvRT+95sSLGCmQSrSy3JOqssXUJFHLYNgeRCEE?= =?us-ascii?Q?n+5Hsi5QjRcZDm+jmH1+3huKY1vsD0bXEBVm2s+ykoNOwMaw5p/E2oGS61wG?= =?us-ascii?Q?xX/LpmRyx6z/lIjRvuB31+ZAwuAr3BTRu0gkktCA8aseeFKR6lRsbs0qesJw?= =?us-ascii?Q?9T83MIcnJjgndUZeL6N3FlrarXleGurppY30BtrANB7lrApA3RccOtcp2QJx?= =?us-ascii?Q?YQ4A5iWAwaEMOkf6N9IKvO3C3MYtyDdxmB83obhmWTYDJiY8Dbt92sAUbIT0?= =?us-ascii?Q?YFjc8BUjPgVCw8zS0SplV0Ji1Txvcl4BYYDF2hg4lIsGYytWD4RuWVRoZFWG?= =?us-ascii?Q?1WtDcNAmaxTbYiY3E+fH3HsVpglo5lTt4r2hjlq6Kn7rrYiKjRFnF8h9P3pN?= =?us-ascii?Q?uhLVYGebtybwnxxhFRw91PXA0MAdo/+JF9PBh4o1Dz0Pf2lNVXRIzjNdz79B?= =?us-ascii?Q?whcyLo/36KoYDhwnzmZBxEbUPY9CkbbEgFY28s3+mEOBqg+2GOqCdEb3i678?= =?us-ascii?Q?knKYzgp2jqrndYxXwHRObzEuFj1rK+ZaWtCAwQlufBAir1LbHFLroso2rP1F?= =?us-ascii?Q?9My5EVWF1wZpoRfE1Oh7QN7qruz5MpSmEDMz5r8UHuJdNlgkMrJq9pKy26fK?= =?us-ascii?Q?+KUb58vSR0NNbGAsT1bhV2jLPAPwKBsTvitGE25rV1Z6cCvYy6qVkGXqDHS/?= =?us-ascii?Q?nOvx37loAY+DUqmh4X3DRQsgSN9BH501Kt+nJ2bMipF0RlEcOMo3cSCred49?= =?us-ascii?Q?x0/Cxv24IvC2oqi2ks4whmEuqEU3vxKIXCfw1BUG0xDC5duMAryPLvMHsN1k?= =?us-ascii?Q?+9t8xkVoNuVjcoF+fDL2nyzsV712jCu4BThHBau/gMAu0+qvGxeTjNkkt0ng?= =?us-ascii?Q?dU=3D?= X-Microsoft-Exchange-Diagnostics: 1; BY1PR03MB1497; 5:5KP1fvnBQIZbha2cvct2nI+bzRaOgFymgqVbOOnNFgG8J5N5PuzsSljPKUzSaxGB1FrPPMm1ds++f6D+nFhhu5zStrDkJB6P66wSy2yCpt9D+QzQop2O9SjTXTNcMKFY5d1DHUIhu77/k1SAeSmgJw==; 24:G0ecVSKAoEDhie42HxyyOirXJHHsbGYkdcYF2sFXY6jUqNyhvUp3pLrhzAU69H3/BNxhgCtee9Qi2NIR3FFm0sVl9ZKHDsrf0/jU3sgFeok=; 20:AKOnGLWMaPycUek+2jpDjXTNSOlW23GJdkxM0r1kC0f1YRDtkwHwWGiYz+K8LpKEIxBJ6Fyp3adzJizbLsWMJvZ9QBeR7AluKNWxd6kWsEmNzF+W4GQp3SdZHaV9pbKB14D0ZVx7TJ0nfPAbMUJLGusjwzH8X19mW5VPXlATUzM= SpamDiagnosticOutput: 1:23 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: altera.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 22 Oct 2015 09:28:50.2211 (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: BY1PR03MB1497 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20151022_022915_206267_2B504C22 X-CRM114-Status: GOOD ( 13.90 ) X-Spam-Score: -1.9 (-) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Mark Rutland , devicetree@vger.kernel.org, Lorenzo Pieralisi , lftan.linux@gmail.com, Arnd Bergmann , linux-doc@vger.kernel.org, linux-pci@vger.kernel.org, Ian Campbell , linux-kernel@vger.kernel.org, Rob Herring , Pawel Moll , Kumar Gala , Ley Foon Tan , Dinh Nguyen , linux-arm-kernel@lists.infradead.org Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org X-Spam-Status: No, score=-4.2 required=5.0 tests=BAD_ENC_HEADER,BAYES_00, RCVD_IN_DNSWL_MED, RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on mail.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP This patch adds the bindings for Altera PCIe host controller driver and Altera PCIe MSI driver. Signed-off-by: Ley Foon Tan Acked-by: Rob Herring --- .../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..09cd3bc --- /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; + 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..2951a6a --- /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": TX slave port region + "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>; + };