From patchwork Fri Apr 1 20:54:29 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stuart Yoder X-Patchwork-Id: 8727711 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 E4004C0553 for ; Fri, 1 Apr 2016 20:56:24 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id E1336202B8 for ; Fri, 1 Apr 2016 20:56:23 +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 E0F18203A4 for ; Fri, 1 Apr 2016 20:56:22 +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 1am65U-0001IH-9p; Fri, 01 Apr 2016 20:54:36 +0000 Received: from mail-bn1bon0693.outbound.protection.outlook.com ([2a01:111:f400:fc10::1:693] helo=na01-bn1-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.80.1 #2 (Red Hat Linux)) id 1am65R-0001FP-2i for linux-arm-kernel@lists.infradead.org; Fri, 01 Apr 2016 20:54:34 +0000 Received: from BY2PR03CA007.namprd03.prod.outlook.com (10.255.93.24) by BN1PR0301MB0705.namprd03.prod.outlook.com (10.160.78.12) with Microsoft SMTP Server (TLS) id 15.1.443.12; Fri, 1 Apr 2016 20:54:10 +0000 Received: from BN1AFFO11FD054.protection.gbl (10.255.93.4) by BY2PR03CA007.outlook.office365.com (10.255.93.24) with Microsoft SMTP Server (TLS) id 15.1.447.15 via Frontend Transport; Fri, 1 Apr 2016 20:54:09 +0000 Authentication-Results: spf=fail (sender IP is 192.88.168.50) 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.168.50 as permitted sender) receiver=protection.outlook.com; client-ip=192.88.168.50; helo=tx30smr01.am.freescale.net; Received: from tx30smr01.am.freescale.net (192.88.168.50) by BN1AFFO11FD054.mail.protection.outlook.com (10.58.53.69) with Microsoft SMTP Server (TLS) id 15.1.453.6 via Frontend Transport; Fri, 1 Apr 2016 20:54:09 +0000 Received: from right.am.freescale.net (right.am.freescale.net [10.81.116.70]) by tx30smr01.am.freescale.net (8.14.3/8.14.0) with ESMTP id u31Ks8Wc015371; Fri, 1 Apr 2016 13:54:08 -0700 From: Stuart Yoder To: , Subject: [PATCH 1/2] Documentation: fsl-mc: binding updates for MSIs, ranges, PHYs Date: Fri, 1 Apr 2016 15:54:29 -0500 Message-ID: <1459544069-12852-1-git-send-email-stuart.yoder@nxp.com> X-Mailer: git-send-email 1.7.9.5 X-EOPAttributedMessage: 0 X-Matching-Connectors: 131040176499161319; (91ab9b29-cfa4-454e-5278-08d120cd25b8); () X-Forefront-Antispam-Report: CIP:192.88.168.50; IPV:NLI; CTRY:US; EFV:NLI; SFV:NSPM; SFS:(10009020)(6009001)(2980300002)(1110001)(1109001)(339900001)(189002)(199003)(19580395003)(19580405001)(1096002)(36756003)(77096005)(1220700001)(4326007)(586003)(85426001)(2906002)(47776003)(48376002)(81166005)(31430400001)(50466002)(5001770100001)(104016004)(229853001)(15650500001)(6806005)(50986999)(5003940100001)(5008740100001)(50226001)(189998001)(11100500001)(86362001)(92566002)(106466001)(87936001)(33646002)(575784001)(105606002)(7059030)(4720700001); DIR:OUT; SFP:1101; SCL:1; SRVR:BN1PR0301MB0705; H:tx30smr01.am.freescale.net; FPR:; SPF:Fail; MLV:sfv; MX:1; A:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BN1AFFO11FD054; 1:075kGavhT3idPV26TLDARjL7BXxCggLS0jX+uQ8VIaRyF3bLOCdKc3OIZVUncanICxiyV7ETzpuzBtsZln7yre3GLdmMCbtINRnt3Qt08Ppm8F+vyTSeSGpsmUJZWugHCmhV1jOL51aZyyvzm2wW9UeyKLlyfOug0fak56OQfWIRiiLEEakgx3Q5SXKBkIqlbjxjh8Lq3LX1RKHv02oWQ53UYTfu6phE+XlA9YBOBJ0bKgQDEyvE/VBl1NeaKc/2x41S1p2G+z6N+yVKE4rmy3t0aiFgCknfN7q7TsgWgNJPBS+45piYbd2sdkJXXdbzMvz+12Y8+wV1DL0VdF1kO87Woq+1mQhDBM7B2+LPxCkcdzw/d2xhPPNm0C85UYjJ2zXBWjZkOZ/8gsdQDjhCyYDSLq8McwWcuq7YjmI3y1LumDsrqjij1zwUyYxC8FoMjvlkkj8Ip5v4p6RDRD7e3Em0gF1xz5t4jiYgogiKhp4xWFLEK7+CRWMJfy2kOhzjwhDjSdX8WE+anDq71aNHxBZWEHj0diBJEW3tYNauQXtp9gc6BYp93JoYXaWFH6OW3ZLBQm0JhJ2Prz5aWI92iApdQS0K0Q2TzphqMJ+iI0EEvAOFofiMZZ852ZYG1HuoHVEpbyRGWHdHU29qKt/X7xMpjJmmHIz3Vz+/MYFapg0qVuUYUtQ72PYP2y8iXv0FUZN4wS/KQNZDckBqidWQWw== MIME-Version: 1.0 X-MS-Office365-Filtering-Correlation-Id: aa4d9038-f57b-42ab-78e7-08d35a6fc600 X-Microsoft-Exchange-Diagnostics: 1; BN1PR0301MB0705; 2:dBj6szE4r4piilFx7oTL7Ui9QnDCIUE/wuDkq5UVaqucN5afcAlEij3HbJ+3clpAePypAW3TRB2dojt3R90PhU02h6pm3jv4niruETn/mknQIB0zXN+TNescTkaJLNkxPClUJs8mkHcfh/D3xgzznZiF73Y3Vh+EDvijVMN6S9GdYGyzXdn/+/cYBY2B2v1s; 3:3B5YUCV6vCUDSfr8tc+iHsXZ5kPUWvqqsQAude3XimgGKGppy98mynZqCQn0z1+ILLZWFc93fLV2jJSq1Nz7F+4qpCXR8E3CAQpeWzdwlG28dPrwgQWGF3VH64AcBFB7LmAfypgfWbyVeS5+iyoWX9LxNJqd/17hmTc5oDNgkIni3ujkbnB4yu7zk47WH5W099dCQt0uCQRXJsLlhux4yoizhptKD9FnIMotbeFEa0E=; 25:69OTYoEwAhU8kQ55pPiJZHDYVPekhwBTbVmqZ5qkvCEGsGjuSbqoWzVoaMOvaGaMn0GE2/V6D/QG4fdEkrnngXiXI68EJXkvfkypaF2rmZgPZFfk8NATtnY/wrch7+Ot986HoApayyBVNgl5OHYvdUgFLc2ED0PmD5UXZe10dnmN1XWW3j14ryn40kLCNkouJjj/XT5paPMROzUPB+QhG5s0xzMLo3vA45chtPX4Ll4r2i40gZ9ZoxLi9E/f0+JEB/hfon4iDmuM3sPRlqiPCSIih0C1aBnxBE5+Rz7BMg9SNajSkYCStgPOJmeKXNYbzNZLk84Nm2l17SEcpNiUgRN5Q9bhpNPS9OApRZOBLz8= X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:BN1PR0301MB0705; X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:; X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(601004)(2401047)(13017025)(8121501046)(13018025)(13024025)(13023025)(5005006)(13015025)(10201501046)(3002001); SRVR:BN1PR0301MB0705; BCL:0; PCL:0; RULEID:(400006); SRVR:BN1PR0301MB0705; X-Microsoft-Exchange-Diagnostics: 1; BN1PR0301MB0705; 4:UxuAVTMga5PS14JbaNrTNJg/WYWcN4+lH2WGyu4SCl+xzi2b4dvlFGE0jXaCEvWS5w0l4dNj5+mYwyuKPQFi+QHDneMCcptCiXNjKAkGijutcrjUxoVbSktqgFujpixC1mV4OrQI+06mLIode6Af8tbtFPEKfTXczGumettI8GmPMzeQibGM6T8iAMyv2+Qns3vEOdztuS5Vce+8O4sVg/kxFMKppsW//YULCCxMqtLOaIuqcXPpy6PIIX7VyImyyNxrtQ93eIJCbCoWYN+clRWxNM4q5PGtWUls7fKNpCzMraPxIOPA5xaWELJx68hBTBafnvZp8YL0s9IJpPjePQv1oZupRMxVGGlrX12idzcArn8wj4zJI+pV7389z1N8L1P/oY7itmqBh5gxoXpquF6EwBfTQnTevjY6ewaoRq0kyCutJ2GdHg3xk4EfeYsXWyvm+AIc7NSCLGmA/CGgYQ== X-Forefront-PRVS: 0899B47777 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; BN1PR0301MB0705; 23:oNWajvyBJv+mlnanJ0D8wLFaWBRVaJ+Ymvw5g3R?= =?us-ascii?Q?X8DGqNnrE2h/VxfI3U2kPWR86DnkQ9FzPTd6LJojMe+575pONOl3es1qpqNc?= =?us-ascii?Q?oM2TfXfic4ruvF2kIi4l2NdyU2tq/y5uPV0kVHVDc6EnU1bdkLfNHQYBALTL?= =?us-ascii?Q?KccewQpcjDSnfx2LGmX4qqhZsNPc7Tkmc9DBpaSecNWA9nyFqNORt4MxJD3O?= =?us-ascii?Q?bN+iB7qsUvMRzkslHHBHQQ0CK7xxsGGIM2BgTcZ6fTyHzxyBN+fowF0ix8Mr?= =?us-ascii?Q?q59Utxkfllsby1Lka67vLU3bUghB2Oq5bhY7nWhNwfbH0a1lKUMUJxNIdvBL?= =?us-ascii?Q?+foXzLGB6/nyo8AuSszu3KOXbcrTXVfayWCoVGjcgpCykcdjIvyuXMY/8pJJ?= =?us-ascii?Q?K1JcdAzckc+JWwQeMyG5PXakqKvUqYCYJJKZQjeGwGGGWVECwVonqkiWP92M?= =?us-ascii?Q?C0nisDez5XV0nNfBEofYXk2dOIW1KaSZeTFU6s7g/fYZiurvZTDvoliJOlA7?= =?us-ascii?Q?iXD0VRCvnk9DZoYyOVPxvk+s3Z6BPFVu/bL43P3e7PbhTWdyp5WcyDyMMM4a?= =?us-ascii?Q?e7/wSuf4jOxKeX6pH2RE2JerpbkhcYZfxTFnak4h43s32KWllzBTrPl7Jyf8?= =?us-ascii?Q?2tuAK1+TFJqK4v2HuBrXgowC0MjMPWb30Xb2Kn71M3K8jDIKEZm2eOts+0G4?= =?us-ascii?Q?HAwHrR8osnaCry72J6Jm3+VL9Pz1ZaDjQwF2AEDrmqx0aYoj2ccsTUjUz7Ql?= =?us-ascii?Q?8/7RM4xtgih0Anuv62fnjZitDMxlBdJqLLN19hFuITK2KulVvT2+ayACvTqE?= =?us-ascii?Q?R1Xm4CmKq5VD+7cSaDxG5qvfVcEtmU2sLQLTWC6LKnUXjb8M2Vvow0SO6Ypv?= =?us-ascii?Q?TFU+TUqAJnU08QqxFlMbPRPr8obN0cIpuHJ8qRFTm0j8rdT4fKH0Uti//JRZ?= =?us-ascii?Q?rdNE44J0cce4LKlFlyHzdeu0gLwjaa9NaiF0v8iHYr/qt7Mcx510gYMT37rr?= =?us-ascii?Q?olntWbV/zKkOYcVoRJpKs9OH17FKZSLLGCXDJ1GzXWtSHSRRln8lMMp5qRR8?= =?us-ascii?Q?3ws8T6G0JbXrWU+Zkp14En/kHs9J5/ggs/gPWWZtjltv2VMGXRjlB3lI8e8s?= =?us-ascii?Q?tV9taz5yvZqo=3D?= X-Microsoft-Exchange-Diagnostics: 1; BN1PR0301MB0705; 5:GhApsZPk39BD5DC9BYj4nlsy20If6UHsRbpiWaUXWELPPceyIUpOp8kbx8W4yq0b3I1O7sgvkUA+rW0qLRJKKQRFcnWTtZ7+3wgctYx1zzb/y6yWA0sDCik0Cx8AWk/Lw2gESj5k1dKu6+I3GMP1ILYXx8LD74dST54FZWxp5UI=; 24:KUuq0xZG+QNWFWhlF1Vv54eJ/1os86e7/JN+mAFaDzNodvDQqlB6R+z6JBdxlMtfYiH7hlZZad5S5e7WB7J+89tqTje0pItxhf0jEdGa/8I= SpamDiagnosticOutput: 1:23 SpamDiagnosticMetadata: NSPM X-MS-Exchange-CrossTenant-OriginalArrivalTime: 01 Apr 2016 20:54:09.7289 (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.168.50]; Helo=[tx30smr01.am.freescale.net] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: BN1PR0301MB0705 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20160401_135433_425128_31AE35B9 X-CRM114-Status: GOOD ( 15.05 ) 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@arm.com, german.rivera@freescale.com, Stuart Yoder , linux-kernel@vger.kernel.org, robh+dt@kernel.org, leoyang.li@nxp.com, 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 --- .../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>; + } + } + };