From patchwork Tue Apr 19 21:53:08 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stuart Yoder X-Patchwork-Id: 8883491 Return-Path: X-Original-To: patchwork-linux-arm@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork1.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.29.136]) by patchwork1.web.kernel.org (Postfix) with ESMTP id 127509F39A for ; Tue, 19 Apr 2016 21:58:38 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id 11AED202A1 for ; Tue, 19 Apr 2016 21:58:37 +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 D326B20274 for ; Tue, 19 Apr 2016 21:58:35 +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 1asdZX-0000ql-75; Tue, 19 Apr 2016 21:52:39 +0000 Received: from mail-by2on0096.outbound.protection.outlook.com ([207.46.100.96] helo=na01-by2-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.80.1 #2 (Red Hat Linux)) id 1asdZU-0000kw-GR for linux-arm-kernel@lists.infradead.org; Tue, 19 Apr 2016 21:52:37 +0000 Received: from BLUPR03CA007.namprd03.prod.outlook.com (10.255.124.24) by BY1PR0301MB1221.namprd03.prod.outlook.com (10.161.203.17) with Microsoft SMTP Server (TLS) id 15.1.466.19; Tue, 19 Apr 2016 21:52:15 +0000 Received: from BL2FFO11FD034.protection.gbl (10.255.124.4) by BLUPR03CA007.outlook.office365.com (10.255.124.24) with Microsoft SMTP Server (TLS) id 15.1.453.26 via Frontend Transport; Tue, 19 Apr 2016 21:52:14 +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 BL2FFO11FD034.mail.protection.outlook.com (10.173.161.130) with Microsoft SMTP Server (TLS) id 15.1.472.8 via Frontend Transport; Tue, 19 Apr 2016 21:52:14 +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 u3JLqDqk004015; Tue, 19 Apr 2016 14:52:13 -0700 From: Stuart Yoder To: , Subject: [PATCH 1/2 v3] Documentation: fsl-mc: binding updates for MSIs, ranges, PHYs Date: Tue, 19 Apr 2016 16:53:08 -0500 Message-ID: <1461102788-30565-1-git-send-email-stuart.yoder@nxp.com> X-Mailer: git-send-email 1.9.0 X-EOPAttributedMessage: 0 X-Matching-Connectors: 131055763348266188; (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)(199003)(189002)(48376002)(5001770100001)(50466002)(189998001)(36756003)(2906002)(586003)(5003940100001)(1220700001)(81166005)(4326007)(1096002)(15650500001)(31430400001)(5008740100001)(50226001)(6806005)(47776003)(106466001)(33646002)(104016004)(11100500001)(19580395003)(19580405001)(229853001)(575784001)(87936001)(86362001)(50986999)(77096005)(92566002)(7059030); DIR:OUT; SFP:1101; SCL:1; SRVR:BY1PR0301MB1221; H:tx30smr01.am.freescale.net; FPR:; SPF:Fail; MLV:sfv; A:1; MX:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BL2FFO11FD034; 1:MeXdEuUkV7wmjI9cMDEbI8nRjA81roSMNx062JeOVpczXS2B2n7FMslL+VwSX3TxQHZkY1JK1ucelKZAL0Kbk72uCN3pV7yAjq9C8Xy8/tJyboJ5Dq16bcWMjoUwMV5ogOlME/4MtLpcy7BcVWoJVqazwp1egrOvVKY7ZaDaFcwHx6oaQUsl3gonSBRDq8Mgs6Ix2Jfrka2LesCgWvRZ5ji3iV2Mds63ehDvUE5AEcsDeHqrGsWrxr02E91I6qJVfX3tAxP/KRlmM6rEdmP6YWZrBYAE6wguzQCFd9dENjz6/yJFTjaU0Pycp+p0tey6tVeOreve1M4Vh50diifdBdbRx9ZPFevxkLZao+Dywqa+M1nyjxKntqf0VNOksSeAHC2ZqcWJK1ELt7e8gAJCQf25t25m/KGnCuB7YNhw9Y1OMBwEh030NHlz5BYTTiJfQxUINy2ouocrTIJjkfKiev5NQigxPd14Rn/JHdpWYep0u5mN7eljKJEmLcyasqlEkDlitACpSt9mRdEplnWDFqIXO7FeUMFOVfsFOxmkuOID5sPdLi9oMolXgV2maJavBlg+Zbj4QcDZn/p+D853j5DMuSCHpT/C6wZv9DU0cRa4GaxmNFFzhlHw4guRhCuX8sOHn5dYLPlj4LdALNjHhJq2MzqBGtLna7UHKCFmb1dwUXQdgdDG4YgUiOlnNvxE5AjJfMTjq2aJmjLrTWQpxLiAD/guup20TV8UETVAqRc= MIME-Version: 1.0 X-MS-Office365-Filtering-Correlation-Id: 9fd74854-f3d8-46f5-1ccc-08d3689cde9b X-Microsoft-Exchange-Diagnostics: 1; BY1PR0301MB1221; 2:Kv1y75WzMw3DADkTM17y+owv0LrXHhBCP3csQo3SejfGEWDX09YUPkiKvroW8ciTeGFEkgWf7PU5B2GmdlpMLnjG0uex2XTO76AOxj72v9Sh+9e8+Fmn07yk+VZOwsH6bLGVpdWpPVK053f4s5PVt4Y2Z2CwIuYBPIqHFMfPcqdJiEfZXHWVTELGTMju54WQ; 3:yMQLQF8qqGLfhAmxLf01jv5eS9YhNN6H8257XwYNzFhzonwi1TA3b8R7oR9bSKBX1SwG7/kMsDOtiAZsS08s2GLjoLV3h5CIeLpV//ptP5TIiCp79KCJwCd6ahoJmuPaOtYIPEhkrrfiyrBySaavuQAM1ktPBrr+BueC2EEf2nO6DGu1qvjDzTTAhTHjCnvj0CVe35Gs/qRt2ahOdg2Rr1sJjrBqJYltQrUdFmC/UxA= X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:BY1PR0301MB1221; X-Microsoft-Exchange-Diagnostics: 1; BY1PR0301MB1221; 25:Y+gb9fAHbLVStJq1m8TOCe5O79pTeBPTEeEBQVyJwjVFh8ywoDIxutiFtToAXa+gKwwHRqHBZtfRSBoD1zuvURPtwxI3fVt0ZzYLNK4l49CGPpooz7GGO01q9a8GlQblZASuIsI8wSln4f13GlO4DTK78kq5qq6M36691LmzPZxgzRn5ENr2GOn0h+jYKj2vMk17//h0CYTQvTq4fOo3O7VfGnovAHt34xkhU98mrzu53+Ffpa0nQDscuipPc/RL6F2h+UF6u70X6o2CJTuefzBeLh6cPTV3885BOzQR9Ktu/YTjLAa2CRJ9ji0rGK8KAXFuS8rjgC3iGA5hZTZcMBrjiIZzv8BmrRfKsfsi+qlSRXz9YhMiHETSlh/vDfDUA9ce95zbosdHlkIosQM3v8YQylQ2JOnMREc6ydTwUFBuw6506RAfMGWrZkbsv+fgM+QlFBFgeU1X2XclSlZZUZOBI7OFWCwQh+sekYryt1Yxq5sS70MEAXBMAcPPkI3ItO7NKque9b30WQUZ1eyU2zeMcnVwWYhHiPIQWiILz1izV3Ea9rm93BvhTyDbf5Hi4TchEGU2HCRdMSDC4pJplMYy4Z4TWeKUMhRtn8wubrkJzdpb99SRr+sqpJgMSeKAhNtL5QFG9XOnzmrSUkgdToNISLTil1Vw7EIxPbKYtzE= X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:; X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(601004)(2401047)(13018025)(13023025)(13017025)(13024025)(8121501046)(5005006)(13015025)(10201501046)(3002001)(6055026); SRVR:BY1PR0301MB1221; BCL:0; PCL:0; RULEID:(400006); SRVR:BY1PR0301MB1221; X-Microsoft-Exchange-Diagnostics: 1; BY1PR0301MB1221; 4:vUX9MU/7EBrBplxAbkAbOYnRcW07l1q+elgJ4qw+zy5xtYgJKK/BB5vWvIYgrTYGMFpJAYzMSwzNLCNL/jfDMU5kIclyBl4nCaTcgattRJldw0Q2bfMNbJ3loaK9l5CPSZwOwyAlmpRwpB1QOjy/ObDBv4eqw5Jt6cJ32ksCrR479Axyp0IKeKpq6cU+b/aFcyqNrt0l4Og0n6cn194F0LB++7N0lTNNGsQ+cstdk7vxsBrEIp+Pj8zcuAVghYvqbX5rpLHXJJRBh+IYFlwDEikEocW/FGC2dLlFCCMSfJVl1YcgB5v+Oh2jq78SSj1/0vw04Q+F+5IAp9bWw9khtJNKGJSOKUGtOGsv6w8RAT2G2e4BY86clsncTE8juKbrEK3hdnyntDQgvSiDFxcNoTui4+68J8g3i3U5XllTM61SLfII7I6WR/+a4PIlEQ1qy6oI/fWqHU5hxrNaLZ3FLGG4GcaIIxm9gQ66Vv6K5iY= X-Forefront-PRVS: 0917DFAC67 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; BY1PR0301MB1221; 23:VvDGaMeRIcsDuvHS0MNf4Z/lAgBt8eNdmS1TQwV?= =?us-ascii?Q?XL0aiZfqw9p2xxSbjN5wiF5qPBiinbIF6JtN0TiRdFpZwFKyJ2M2SbPkOfyj?= =?us-ascii?Q?x6Cgt4o6vTQtPuMN78BLsxINYqW/lhfAWWGqaoD5G9ycZxgKI1IuxoYOuuR/?= =?us-ascii?Q?44TQfR/n4Xht2sD3yFGbsc8uL4kFd+5RGu3fBtDm0HRcgJhLXfn5nyR5vpin?= =?us-ascii?Q?NmXSIJ8KpYaG5fhjSlAqsZwtfWz8SAZwOg/LBAm+5YLZFgacHNhjFiR7hbkD?= =?us-ascii?Q?ONPLeh9D1xDs7KJAjIHecGmnX2FaOOwOgeFCAuykMDiAkRqc8owwV36hzjtJ?= =?us-ascii?Q?vyYaDMWhPVhLPyESA14GkW0cxbi1a9fB9RGXTjZnmM/6Jjp90cDbG0MTdmIW?= =?us-ascii?Q?6l/dAENROdm3vef47yFfskW+55LnfL3LId4gaIMQkDa6XIcFnIeawTNM6ImE?= =?us-ascii?Q?EPY0HLJi6zcEzIBwpoMx1E+1xtdnDGlFxzJqSvOcMUHMaDUhwAz6NdlUEQ0O?= =?us-ascii?Q?avhamk5QXelyMV3aAVzq2acA9qc2FlHpatNxR2R72nJrijbteMsTQFwL8tck?= =?us-ascii?Q?ygL12MFoQVBjq2ggs7OLTBBrcHG8toKO10DEWlisMMb/h1cHWihlNAt2sp/D?= =?us-ascii?Q?nqQgr5yGIrZB/ujD8Jx5vgxO9hSc1mOcdlnB7741ADFSqabOK2KjYolvDdk9?= =?us-ascii?Q?GlMymLLakGnmntpRE64ZfdKZvfXMe1Y6+kR8U9kIGw5fSVNnORzLiOA5MTc4?= =?us-ascii?Q?g33j2daVX8Okgd0F4jmQCzO60tenHo+4WBK1ezF1siZoQKVl8I8s9Jm4mF/l?= =?us-ascii?Q?9Zpy2t7skrzWaTS6HJS46QQ+JgPGbuyDtT2O6G0/Hn9rYxDxiWDLx300go9v?= =?us-ascii?Q?dwA1d5WbMWs0y5dnQakrb576ZSP3JuCwYSE02qKoSv4uBYmUktrPfGoAI9sx?= =?us-ascii?Q?6nBICwm44K5/b0QGYckMe3bx/a3vac07FALu0CxJbm13mKAt4wK1jD5oEthA?= =?us-ascii?Q?RYEuatxFHxgFPoc0rycZIZL6VbthYHIUXmEwPaKmcdJ8fnReN2ZlFZz453nE?= =?us-ascii?Q?6EKi2eA8=3D?= X-Microsoft-Exchange-Diagnostics: 1; BY1PR0301MB1221; 5:o4UxGRjcOHnB7XYOX6xxTt9QEz7K+keb/ZCQ38jcM07M7Tl7wz9qNVFcSfLsAtsRLasASnEYKgo/0mv1+CbevV+sX5Rg1OOy5AvHpeN2LasURQqQ2rPvG9J7rz0rwTqErGh6dKC23tHZlvYW9z8GeNoXAdwkS/ho5VDTlfQtYEwdi/8mgbjaUr8sB4Cgr7Jls+aqjqVIMqeQHVHfcG9SkQ==; 24:X6aanh6UVOxzQ8XiCIuhV1e9p2SIv5K3ZjpoJKnOfCE6kZIAr/B+RUomqcc9O7pzUDRbMcmv+oHPm0lpsrb0nb+RYp9Ue/F4ZEm7ZlYuFo0=; 7:4dV+qmzobAkM/BjHNY+K79CU5vrhTN0TIaNDEx9L06NpSNm/t1GQZCaZ2gBECV4r/nS+Vo4ky6aajs10dRQtFV9SufQezGb5gjrArlki+zsn9Q4x6TXMo0/9emxseDpRsItXwIkF3a1Z4NwZZ+jkXLfwyGEZ3hITMks/7andMySRLUNew0NRB9gjE3zLlup3Z7MPTyYQoQSboOLDxmokroZSo9tUnF3uXVVqo5wDY6w= SpamDiagnosticOutput: 1:23 SpamDiagnosticMetadata: NSPM X-MS-Exchange-CrossTenant-OriginalArrivalTime: 19 Apr 2016 21:52:14.6550 (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: BY1PR0301MB1221 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20160419_145236_575798_2F38BB21 X-CRM114-Status: GOOD ( 15.88 ) 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 --- -v3 -no changes .../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>; + } + } + };