From patchwork Wed Apr 13 21:05:17 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stuart Yoder X-Patchwork-Id: 8828571 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 12C23C0553 for ; Wed, 13 Apr 2016 21:07:34 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id 20BA7202A1 for ; Wed, 13 Apr 2016 21:07:33 +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 21E3F20270 for ; Wed, 13 Apr 2016 21:07:32 +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 1aqRzF-0002oE-9L; Wed, 13 Apr 2016 21:06:09 +0000 Received: from mail-bl2on0064.outbound.protection.outlook.com ([65.55.169.64] helo=na01-bl2-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.80.1 #2 (Red Hat Linux)) id 1aqRz9-0002ez-7Z for linux-arm-kernel@lists.infradead.org; Wed, 13 Apr 2016 21:06:04 +0000 Received: from BN3PR0301CA0076.namprd03.prod.outlook.com (10.160.152.172) by DM2PR0301MB1229.namprd03.prod.outlook.com (10.160.219.18) with Microsoft SMTP Server (TLS) id 15.1.453.26; Wed, 13 Apr 2016 21:05:31 +0000 Received: from BL2FFO11FD034.protection.gbl (2a01:111:f400:7c09::108) by BN3PR0301CA0076.outlook.office365.com (2a01:111:e400:401e::44) with Microsoft SMTP Server (TLS) id 15.1.453.26 via Frontend Transport; Wed, 13 Apr 2016 21:05:25 +0000 Authentication-Results: spf=fail (sender IP is 192.88.158.2) smtp.mailfrom=nxp.com; nxp.com; dkim=none (message not signed) header.d=none;nxp.com; dmarc=none action=none header.from=nxp.com; Received-SPF: Fail (protection.outlook.com: domain of nxp.com does not designate 192.88.158.2 as permitted sender) receiver=protection.outlook.com; client-ip=192.88.158.2; helo=az84smr01.freescale.net; Received: from az84smr01.freescale.net (192.88.158.2) by BL2FFO11FD034.mail.protection.outlook.com (10.173.161.130) with Microsoft SMTP Server (TLS) id 15.1.453.6 via Frontend Transport; Wed, 13 Apr 2016 21:05:24 +0000 Received: from right.am.freescale.net (right.am.freescale.net [10.81.116.70]) by az84smr01.freescale.net (8.14.3/8.14.0) with ESMTP id u3DL5Nwj008153; Wed, 13 Apr 2016 14:05:23 -0700 From: Stuart Yoder To: , Subject: [PATCH 1/2 v2] Documentation: fsl-mc: binding updates for MSIs, ranges, PHYs Date: Wed, 13 Apr 2016 16:05:17 -0500 Message-ID: <1460581517-32107-1-git-send-email-stuart.yoder@nxp.com> X-Mailer: git-send-email 1.9.0 X-EOPAttributedMessage: 0 X-Matching-Connectors: 131050551246482406; (91ab9b29-cfa4-454e-5278-08d120cd25b8); () X-Forefront-Antispam-Report: CIP:192.88.158.2; IPV:NLI; CTRY:US; EFV:NLI; SFV:NSPM; SFS:(10009020)(6009001)(2980300002)(1110001)(1109001)(339900001)(189002)(199003)(2906002)(5003940100001)(50466002)(33646002)(36756003)(85426001)(31430400001)(77096005)(189998001)(50986999)(86362001)(229853001)(575784001)(19580395003)(47776003)(4326007)(105606002)(1096002)(1220700001)(81166005)(6806005)(87936001)(50226001)(104016004)(106466001)(5008740100001)(92566002)(19580405001)(48376002)(5001770100001)(586003)(7059030); DIR:OUT; SFP:1101; SCL:1; SRVR:DM2PR0301MB1229; H:az84smr01.freescale.net; FPR:; SPF:Fail; MLV:sfv; MX:1; A:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BL2FFO11FD034; 1:BfpXX1CTNTfRuNPV8t9sNV8Ol0k1TxDthY4Pd/ax4h9v3j0F+MHJ7vSCzVZu+jaB+p5F0AfPCsXxbjb+JCasREtIvmNTLM1f5/i44efNklCgSJ5eCJg/AxsynFnBOUw5foem3SUEyU83BNMVJZlJRk8InP0c8kyCqrJXMgUkIud7dk2Ke5l+VB2HpjIR0Wam96+nlrLTY2wHkzsfqIzK6IiyxX48LiJO4piQDB65IuxAf+2vpW4ly/uemxWYzzJZToGEONkkdKc0KviDpMEGg5pthwckOmy60S5Bfr6IFFM4z6s3Mt1uYqioczyR+qzCONuDTacSUeIJF01yZR3ns+1pduL6YHqyVaEQaP21+Z+5TGQrB/urhIzWeZ3CJrK41ISe7bjJLrqe+LZJozjagxDIqbnnQSl2bh3GgaOnEV48CWVHbLSqEnPJW41NrAy6mJNSqHkOJ3CNWPSdVmB41+LHVjDCLMjaHe5LjmTEcrP1O93P5mt05dMgqIcVAMSwGSCWPveMSNb/K8LR1xBEJEHerYmSGTEvOGlL2K5EYsX753GrgQV0yQ+NCfme7xo5ObsnLDqVK4DEAuSiE2OV0FRrZ7KZF2GWbm2V7ZT80AbRbkh3woax3m1jNE/i1yCkQZ/h9Ty++OORt5kOm/63xbdNdZh+xlh+z/1wBiqX0ejHxHJD4cEIRJv71PASbRAh2PbahyAb8/DureEdbOT9aUD425TN6Z2bIPmG2rehOSA= MIME-Version: 1.0 X-MS-Office365-Filtering-Correlation-Id: 362c6260-c412-4931-0a85-08d363df551f X-Microsoft-Exchange-Diagnostics: 1; DM2PR0301MB1229; 2:ueOHet/B9dNaKV0+8W2SO5ILIdcKDGF1qR4z/CJgxWdkdmFhgUD3snNfHN2IXAzNAIRkVGusmMY4AGIklpPaA4vzU6GdCHIv5YjjaTfgb9xyLGLNRSHavJApsuE5hUmTq0aARhRIoQbxcPwhpt4+q4nuPbWi/AcvI/5Yf99d6lo5bQKGDXSdRgzen3dauP4X; 3:AjzBvXz95JXhHjl3msMe0PVvX97F1zvJE/KluMvtg4aqKigcOjctuOK7ryqtWqMq/79WKKEB9aJmwkJeFJbm5umC23V+6xMcJtTTPvfAf+9hy0n47owB6MfX+4AJph73Le6N1ZqsoKQ64PJUjOePFEhxJRXwLTbEgCD642JbKaaetC8FzjpnT9GN69BRxiApD8E/ZvKv+NIcWkv37OG5YN1JqBNPdY/Co+JNreacDNg=; 25:LpRYQx2a7rGkYUu6x01cm6r1dPfY9843DpOK8TEcJt3iZhfjZlXFB2DP2lYF9KwLUdkdrgZ4fa8QjjvwyUUgEZ8UahlIjGR/IJ9lH4jbmnsck+IfBMHeE4GVDSLjCRtmZzqo9lib6h7oJHHYMgqycL6vHucAd4Ld3lZlRpu/cdQbSrtZOnsqdpbiqmtc/ehtuctFUDO3eYKt6uPHqq1D1lWmPDY8rad/jO6X0RogVx9eumVp01a0+DbyFTIG2OhfBt2+dcBJ4H5mqLR51hzGX5Upo7LXBFN9qcAlwUvjNUtOW9KeJZ2VtdWFvtZhIPtJ//EGJBOBDFvjku/pnFplLw== X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:DM2PR0301MB1229; X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:; X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(601004)(2401047)(13018025)(13017025)(13015025)(8121501046)(5005006)(13024025)(13023025)(3002001)(10201501046)(6055026); SRVR:DM2PR0301MB1229; BCL:0; PCL:0; RULEID:(400006); SRVR:DM2PR0301MB1229; X-Microsoft-Exchange-Diagnostics: 1; DM2PR0301MB1229; 4:XEhEUp56hGgZKTHpPOjOiH5IN4rI2bEj5JNMTYOwzsmDCDOHoUYId7XrLWOGc9HHaDA5bgVZkwJcfyJzHRAVumcdb+tETA35oF4hQg2Q1feCdwdF8R/Bh8lMtLFFjYZtfjhVThoYffByUCxdvryQYDwgQVX2i72GgDix8nw5yh1D/sZgQx7gov1xT/yQujYI0W5E7msl5mkFza/CvuE9JZjeNlhQHa0INIJJO0Ap83eutZzf7Iz5yD4WhvuJ34K7VN9qgI4NdfOJY+ioIPZ3V2n3wFRKA/upW+MaZtlnUXJjBypEsvpXhbmaP0qfn7rt2LO6dNEczXwxU4S7yrvLgeDpBSj9jrmyqGo6T2Xn1UQdbiQJJSnOQ+MjTcKKhpTZWaZgFLjMA10nYTAHdUhVI+ehH8lZJMmLtF4OJpo+g/ocM12fK+3qWpLzMafsN91fK/YvqS2E3qv127TAV/xY+uEVaOtZFzSOYZgRnL1aoRY= X-Forefront-PRVS: 0911D5CE78 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; DM2PR0301MB1229; 23:BiOJrq38AzEUmzYz//Yi0KlkWWccy6zHadWavK7?= =?us-ascii?Q?vZb7ikDF739CEAju5QaZdgu46d0C3UB0CrBFjZ9G2PW9AreZDZy4PlwHyh0d?= =?us-ascii?Q?xwVMc7sVrWDaK6gzyjlWNhwfBve6OZnEPCHT704vMbA5Wg9eFy5TYFEROsyF?= =?us-ascii?Q?Z2RtM2hIJrPWhUvoLLTXDHpwBtzh1eC8fEITvQkDHQQQwCOpEQlAJMSMpJfY?= =?us-ascii?Q?jFAQ0C4eaoc/rOl3BEiWo4p9TxqBUMTgnrFqugtfFmiAyLM0zgO8708UGTOE?= =?us-ascii?Q?BeppfFMquCNyST90rCsu3C11yVO36VrxrZfFuHwvS1hXHBZ1RNG7RrRIBnuE?= =?us-ascii?Q?ABTquT7WZygySpQY2+r403gAuuYcRkeg1DoR+Wt+hXVkqzmkIwfQ+6jFJBKT?= =?us-ascii?Q?ehpSeMPUwwOE4Bib0xvA3UFvKiXZG0v4TZd3e/HjNjfSFwh2rW7IEW0EXFkR?= =?us-ascii?Q?o2kb5PUD82wCDTJN7ZrvUeOpgF5HKHSc72izIHoWY3zN4kMeLELi2hVk9T9N?= =?us-ascii?Q?LaD9CdqLCpteChR791d2ZnlPxrY/NA5Ch+qYMZCjNRIbpqpRecKKhLFwBvBz?= =?us-ascii?Q?Fg4fJLc/8vDlVoQwMMXBdEcvS0zIl0WGplR0MbPYcqnSgRnMijTpFBhycAiu?= =?us-ascii?Q?SAJFqK+o/jbQtPv46G34Ck2TJo3xfGJDul2WdDk3gHg+7C8ihR5WDnqmHuRt?= =?us-ascii?Q?Ed5tz501UN1wSbSwL09Zgs87kqf+kg9vvP1k6q2zxIrHIlMZDQmOpTnd5a0o?= =?us-ascii?Q?O4ZwFinIwk7LJ3h6mBNTdVriUXqa26bLADAwKrVCd5q76VJvMGZhZ27Elabm?= =?us-ascii?Q?MnG+sdeMCW9FV9EgpDbCzEIASSBTr5BlGTNlDJar5yOZwqsvLBmJ/QB+XiZj?= =?us-ascii?Q?XkdZAmBH6rskSHmxVQckipWl9jZh482CinJ4LoFEnbyt1b2LkJmXWOeU8aWP?= =?us-ascii?Q?53asRxvO4YW6VnqLFDvOfSsBa4RewjyVs/TiL/o6SabxLrmT5CYAp6qvLjDA?= =?us-ascii?Q?JA017YUoEWhOucXnaoW3P3cOuCPk1CMAofDQrSE6ijHHkjg=3D=3D?= X-Microsoft-Exchange-Diagnostics: 1; DM2PR0301MB1229; 5:kNRtSYVxTXpK9eK+GKuOq3H0z/ayFxEv7EI0EldhKaci9qtjgp+CmdeeBYrK19nXuJgR9Hjq6D6Sx3knEGGc3YbkGqCeiKx4xrjrpqciFkjJSDwi8rqXFxAXyMpp5eFhFl8k7ew+judb29xgmQH58dDXz+liA6jPCnCvlGobtEU=; 24:52XGgx+jKe2FI3DStkzIDs7eK+EaUAD4A/vHs72ryXQe42Kts2w4fvwsk2ZX0w6ySjGPX9wmDa8lvAmi/081cn/QnkjXSCx0FUOfZT2FB3s= SpamDiagnosticOutput: 1:23 SpamDiagnosticMetadata: NSPM X-MS-Exchange-CrossTenant-OriginalArrivalTime: 13 Apr 2016 21:05:24.4142 (UTC) X-MS-Exchange-CrossTenant-Id: 5afe0b00-7697-4969-b663-5eab37d5f47e X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=5afe0b00-7697-4969-b663-5eab37d5f47e; Ip=[192.88.158.2]; Helo=[az84smr01.freescale.net] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM2PR0301MB1229 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20160413_140603_773573_63FD5FF6 X-CRM114-Status: GOOD ( 12.50 ) 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: german.rivera@freescale.com, Stuart Yoder , linux-kernel@vger.kernel.org, robh+dt@kernel.org, leoyang.li@nxp.com, shawnguo@kernel.org, Stuart Yoder Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org X-Spam-Status: No, score=-5.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 From: Stuart Yoder -The Freescale Management Complex and all associated objects use message interrupts, and thus an msi-parent is required. -Define a ranges property to specify the mapping between the MC address space and the system address space. -The fsl-mc node may optionally have dpmac sub-nodes that describe the relationship between the Ethernet MACs which belong to the MC and the Ethernet PHYs on the system board. Signed-off-by: Stuart Yoder Acked-by: J. German Rivera Acked-by: Rob Herring --- -v2: added Rob's ack .../devicetree/bindings/misc/fsl,qoriq-mc.txt | 81 +++++++++++++++++++++- 1 file changed, 80 insertions(+), 1 deletion(-) diff --git a/Documentation/devicetree/bindings/misc/fsl,qoriq-mc.txt b/Documentation/devicetree/bindings/misc/fsl,qoriq-mc.txt index c7a26ca..6611a7c 100644 --- a/Documentation/devicetree/bindings/misc/fsl,qoriq-mc.txt +++ b/Documentation/devicetree/bindings/misc/fsl,qoriq-mc.txt @@ -30,11 +30,90 @@ Required properties: region may not be present in some scenarios, such as in the device tree presented to a virtual machine. + - msi-parent + Value type: + Definition: Must be present and point to the MSI controller node + handling message interrupts for the MC. + + - ranges + Value type: + Definition: A standard property. Defines the mapping between the child + MC address space and the parent system address space. + + The MC address space is defined by 3 components: + + + Valid values for region type are + 0x0 - MC portals + 0x1 - QBMAN portals + + - #address-cells + Value type: + Definition: Must be 3. (see definition in 'ranges' property) + + - #size-cells + Value type: + Definition: Must be 1. + +Sub-nodes: + + The fsl-mc node may optionally have dpmac sub-nodes that describe + the relationship between the Ethernet MACs which belong to the MC + and the Ethernet PHYs on the system board. + + The dpmac nodes must be under a node named "dpmacs" which contains + the following properties: + + - #address-cells + Value type: + Definition: Must be present if dpmac sub-nodes are defined and must + have a value of 1. + + - #size-cells + Value type: + Definition: Must be present if dpmac sub-nodes are defined and must + have a value of 0. + + These nodes must have the following properties: + + - compatible + Value type: + Definition: Must be "fsl,qoriq-mc-dpmac". + + - reg + Value type: + Definition: Specifies the id of the dpmac. + + - phy-handle + Value type: + Definition: Specifies the phandle to the PHY device node associated + with the this dpmac. + Example: fsl_mc: fsl-mc@80c000000 { compatible = "fsl,qoriq-mc"; reg = <0x00000008 0x0c000000 0 0x40>, /* MC portal base */ <0x00000000 0x08340000 0 0x40000>; /* MC control reg */ - }; + msi-parent = <&its>; + #address-cells = <3>; + #size-cells = <1>; + + /* + * Region type 0x0 - MC portals + * Region type 0x1 - QBMAN portals + */ + ranges = <0x0 0x0 0x0 0x8 0x0c000000 0x4000000 + 0x1 0x0 0x0 0x8 0x18000000 0x8000000>; + dpmacs { + #address-cells = <1>; + #size-cells = <0>; + + dpmac@1 { + compatible = "fsl,qoriq-mc-dpmac"; + reg = <1>; + phy-handle = <&mdio0_phy0>; + } + } + };