From patchwork Tue Sep 1 10:30:07 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: 7104641 X-Patchwork-Delegate: bhelgaas@google.com Return-Path: X-Original-To: patchwork-linux-pci@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 AF80DBEEC1 for ; Tue, 1 Sep 2015 10:31:57 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id BBCEE204D6 for ; Tue, 1 Sep 2015 10:31:56 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 8E140205B5 for ; Tue, 1 Sep 2015 10:31:55 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1755731AbbIAKbj (ORCPT ); Tue, 1 Sep 2015 06:31:39 -0400 Received: from mail-by2on0069.outbound.protection.outlook.com ([207.46.100.69]:60192 "EHLO na01-by2-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1755661AbbIAKbC (ORCPT ); Tue, 1 Sep 2015 06:31:02 -0400 Received: from BLUPR0301CA0019.namprd03.prod.outlook.com (10.162.113.157) by BY2PR03MB044.namprd03.prod.outlook.com (10.255.241.148) with Microsoft SMTP Server (TLS) id 15.1.256.15; Tue, 1 Sep 2015 10:31:00 +0000 Received: from BY2FFO11FD020.protection.gbl (2a01:111:f400:7c0c::172) by BLUPR0301CA0019.outlook.office365.com (2a01:111:e400:5259::29) with Microsoft SMTP Server (TLS) id 15.1.256.15 via Frontend Transport; Tue, 1 Sep 2015 10:30:59 +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 BY2FFO11FD020.mail.protection.outlook.com (10.1.14.137) with Microsoft SMTP Server (TLS) id 15.1.256.10 via Frontend Transport; Tue, 1 Sep 2015 10:30:58 +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; Tue, 1 Sep 2015 03:30:03 -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 t81AUoan012535; Tue, 1 Sep 2015 03:30:52 -0700 (PDT) Received: by leyfoon-vm (sSMTP sendmail emulation); Tue, 01 Sep 2015 18:30:50 +0800 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 v6 5/6] Documentation: dt-bindings: pci: altera pcie device tree binding Date: Tue, 1 Sep 2015 18:30:07 +0800 Message-ID: <1441103408-8433-6-git-send-email-lftan@altera.com> X-Mailer: git-send-email 1.8.3.2 In-Reply-To: <1441103408-8433-1-git-send-email-lftan@altera.com> References: <1441103408-8433-1-git-send-email-lftan@altera.com> MIME-Version: 1.0 X-EOPAttributedMessage: 0 X-Microsoft-Exchange-Diagnostics: 1; BY2FFO11FD020; 1:0TeNXR2Q0weKFkQZg+gpXJqyxcbdT4Os7i/PWiGFlSjv7JgzkTjw+N6Z4MOmdFQCOLJ5229ftuCCEAwUudzTnENRggsD7etWgx7c28piUpispSThclSOzJfPMJcldtbsD/X+3aOuZE/rhvFCw5JqTR/cfsMw9vqaGLfaWVtSoBWVMmWcEKvCLNQz5sroicC8j+YXr/xz6dKl+fw66KrWKkt0Bhq9u22TSEsFDUUAn3YMJLwpFbQSB3tLRDefLlQrYPN1Orbz/Nto80ieyeUgxq0I5F0uzK7gGFFr3iDxOvy6JOLkaYGOfaTTgS+Z56yFw+uAVLnTHAJ3atYE/wBlEs5GQb0YktYKAI3h4gNaR0BbQ3X7DYJAPdJKWxJzx1JJ X-Forefront-Antispam-Report: CIP:66.35.236.227; CTRY:US; IPV:NLI; EFV:NLI; SFV:NSPM; SFS:(10009020)(6009001)(2980300002)(3050300001)(199003)(189002)(2950100001)(33646002)(229853001)(105596002)(81156007)(46102003)(92566002)(50226001)(106466001)(42186005)(5003940100001)(19580405001)(36756003)(19580395003)(6806004)(4001540100001)(50466002)(5001830100001)(5001860100001)(50986999)(64706001)(5007970100001)(5001770100001)(48376002)(97736004)(68736005)(87936001)(77156002)(86362001)(189998001)(5001960100002)(76176999)(47776003)(62966003)(7099028); DIR:OUT; SFP:1101; SCL:1; SRVR:BY2PR03MB044; H:sj-itexedge03.altera.priv.altera.com; FPR:; SPF:SoftFail; PTR:InfoDomainNonexistent; A:1; MX:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BY2PR03MB044; 2:dSmS1PSwJQtM4NTemVnUSxuxJEnuk0rIclcDrNC4ggHx2Ne9uXUfoyVNbx6Okc3YhBQrTVqcSKpMVGqqe4G9pCYjD6QSsDHo77whn2sVf6bRWejGIsuS/YgxwAN13N9u4DjAyd3svLNuOjHdZBVv7edsjxobfnok058DPmZfvYQ=; 3:ufjg+mwhWlYr+jDwsVGq0XS26NyYKi5AUTlLCmmtZL6jbAUsb32+UDEOx+6bpNpgkrINbtBM1ZORjGeKUFkbNC4N/h867Og2mHKqaCJlOv0OcXTPDtOmViCsgW6E4/a5TCdkJhSFZ1EQ3+rCSVnpCVTOuAJwA3ylnP6wYJrUXKIu8f0ZV161IM9kr6nsGes9gZH32zKZbBYP8MVt1uqi89+5K3SElKTUT/BDUCxqpQg=; 25:2DZlXmtQZz+t9sNJrVALa3wUV+r1vVJPDDYmCTYxHw4R/qU25iGpSUmcOLLm/gItTyjCBM9Qdcco8PcJE5gXQw5BWBTy/mtItSxrOYAeOn5kgXrtC/6N2j0MOD8f0lEN1grbVwDiFn0Jw1LoGngk+WNtsjRSOblee8eKbvkQE0fFOERSRniwXNA1peWgn95G5HGpb1WXQBQDb078NAbtNV7AOwVsFxWeRXOdEjey0XYBJIBwgXqTyBG/cpbSSftryEVUo4rMYJNDS7/GhoNDwg==; 20:h2uTqinHQR4q4WRSh15O8Vbw/YB0ay9IGtmMwb4vYatiT38wd2BEAX8u4jH1xxkcqd4vVRWPFp88S4A4QAO0+IpBgkBJNoCT3zm6C54OgpcNQDO6zFmKlmd/7TsobPsRtqt0a4PrYBsOQibAqYWboilki7yMTHzlwwS0sT/x4hw= X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:BY2PR03MB044; X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:; X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(601004)(5005006)(8121501046)(3002001); SRVR:BY2PR03MB044; BCL:0; PCL:0; RULEID:; SRVR:BY2PR03MB044; X-Microsoft-Exchange-Diagnostics: 1; BY2PR03MB044; 4:wP6aMh9vywvuTP7+uUi0Ny3FSvHao4HKovOVm9D8RNvNgR6udZC5n8lS9p1/DprtZsPEFecSgf9YYR8vtIjHu8ZJlMFo2RBLSnhgexkQ/3Zs0gZWOsG8EnDWVXWiGt2eYCtiJPUopFc3RfuE93vVq6bD/5Fl1eVono4agTr213egujyMOxhU76XMzs1swEArIxWxJhoXvaXOSoLTGz3OHG+EVpdCaZKkQ5UfvmMuWAQwwuId73YRTuI7zNqQGucaZu7HI9jK/MTaOCsOSfDHZw8Deif45YWeQlCimOSDz5rIXwQ9jGE48dpS9eOYwvVbfjkYZKtirWHhQsYDihnnXQ== X-Forefront-PRVS: 06860EDC7B X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; BY2PR03MB044; 23:GHuwSOUp9TlFyq10Fq9U5gKEBS0vLQ/nxzj0foIrVH?= =?us-ascii?Q?nBbDqeZ9p2ArKvNQCCtZPyQx2ToKJyse4b665BZAMmXFth2wuzIGyFSLvzkY?= =?us-ascii?Q?pMmixGUN6qVKYzQ2Kzr67EqySAAmzJKTtBQPmR+vyf70/JJJkOimOH5lKekU?= =?us-ascii?Q?3W9YZa0QMT+ykvIfwhNZhhNAhV9U8yfL4+B1sYkvGYJt3cYT6UtVqG2opEMB?= =?us-ascii?Q?7Y7YrqSh2OXB/cX7Wa7e0xH+ugDCbSydcTCJCbl8511ZXxY29VhuElpPfy7j?= =?us-ascii?Q?ZUPyN9TlwuS+LnBhdEqX+KS6e4+FrwZTjXzCzKweS5SWHB2Uaow0CU2LSn96?= =?us-ascii?Q?A5Entt8pAY5mdiHqISauAuFxsaLmKnfjWINPAdNtE7VxANTK1gSzfQaDWNjr?= =?us-ascii?Q?EH60fdI7qVhuYkx7zirtNiqFSlXxJnQLAY9fbdY/so+92CD/y9ZjJDfo6wjS?= =?us-ascii?Q?RHnIaZXrdTEbrMm3NI10nTtPIsWVOHxxfxwSb78cB1wcOMNjk2Zwxb2E9pFo?= =?us-ascii?Q?MEFd7F/OMJsCf76qwz2uYlWMuYjokfLVzvysRv005RK0F6gYlj3F9ctQN/Gi?= =?us-ascii?Q?wuSTOyvFcnRs/eP4Y7E1EmLn2y8GdNPca7T5tWfchyTxiLYmfhY8tZcQBw2U?= =?us-ascii?Q?ysKW8nGHHTFHI2N7PmmhOyWpWEp6jBnfdNGxABZNeGqgRxmRq9LCVWd74O7X?= =?us-ascii?Q?k0X88Uj8rKkJcZHeV2QM1C5nQv4so1jqOSC9zMEW411bQNHDnWezzi8+Fjai?= =?us-ascii?Q?vU8MyxCoOKEW3y1PPlVqNwBoKHDNxQJl6SNGWMgDc5ROke1wtvJPMMuSZtZf?= =?us-ascii?Q?00ZXzX2Wb6jtxmlXK54pE4jvB7yBydTSsjMheVdXrs5irtDT7GUGgbtCJ0FF?= =?us-ascii?Q?15sPTfWM1ilgYwhQInCLcutn1B5tB/HwjwcuGmWa3tBo1q1g9UUAHBDrUSqu?= =?us-ascii?Q?7tEZnngmKqDhCFcj+ya+rV0smRg1CE5ghcPD72ZI3cNfJ32DkIrXmVSm/lQL?= =?us-ascii?Q?yEQrqG9A3Tq6H6HooeiqNWYamF/zh6/XjjcDv+8r+AmDDhBo0mxFkRuhyEEm?= =?us-ascii?Q?lbV4l3ZbkPVP/Vseax/q4sfrU1QkyHo/8I2oo44BT6XgB3f0hjvyvePN8ynd?= =?us-ascii?Q?lmmFtLV5k=3D?= X-Microsoft-Exchange-Diagnostics: 1; BY2PR03MB044; 5:A7NZzoGTj503JIhhDNjyzYKSRPKcC/+MHVcQnzn6BRszHSeTKBt4DHy1uJOb9N2irF9O8sE6MdKqokynh6N2McomJ5P3MHDb5rF6EquhNUE2Q/22npE9Z9kRjJj8gw6IZQFL26LEtFgxNQS+LpdQtA==; 24:G8PphftQZeEzVkvwmp5t7DVraN4Fus8PG/LrVgNsAv6h97pKliXNXajdXBrYgEq8bc5/2C0EEgUUYv/CQ15+E5i+Uucl9LhqF2bLXx9+Gns=; 20:49TJDqBG2YDJW2EScZi8SxHU9TY5HtqHdWxMBc1z2PMc6hijVaJBVq3kzvjBhXeVqwttkN7eohN4LNFJOiDVYqfPucS0N1jUY5sAW4iW20auId0OFboGE13WjX8hAAj6il5pCOw2py6++zc/iM2rsmubaGQXlbeS49iSD97SSuM= SpamDiagnosticOutput: 1:23 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: altera.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 01 Sep 2015 10:30:58.8238 (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: BY2PR03MB044 Sender: linux-pci-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-pci@vger.kernel.org X-Spam-Status: No, score=-6.9 required=5.0 tests=BAYES_00, RCVD_IN_DNSWL_HI, T_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 --- .../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>; + };