From patchwork Tue Aug 9 09:34:42 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Appana Durga Kedareswara rao X-Patchwork-Id: 9270739 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 6BBF260754 for ; Tue, 9 Aug 2016 09:37:23 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 5BE9620265 for ; Tue, 9 Aug 2016 09:37:23 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 50E5A28308; Tue, 9 Aug 2016 09:37:23 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-4.2 required=2.0 tests=BAD_ENC_HEADER,BAYES_00, RCVD_IN_DNSWL_MED autolearn=unavailable version=3.3.1 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.wl.linuxfoundation.org (Postfix) with ESMTPS id 2E4DA20265 for ; Tue, 9 Aug 2016 09:37:22 +0000 (UTC) Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.85_2 #1 (Red Hat Linux)) id 1bX3Ry-0002hz-Ts; Tue, 09 Aug 2016 09:35:54 +0000 Received: from mail-bl2nam02on0045.outbound.protection.outlook.com ([104.47.38.45] helo=NAM02-BL2-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.85_2 #1 (Red Hat Linux)) id 1bX3RP-0001A2-G9 for linux-arm-kernel@lists.infradead.org; Tue, 09 Aug 2016 09:35:21 +0000 Received: from SN1NAM02FT033.eop-nam02.prod.protection.outlook.com (10.152.72.53) by SN1NAM02HT253.eop-nam02.prod.protection.outlook.com (10.152.73.84) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA_P384) id 15.1.567.7; Tue, 9 Aug 2016 09:34:56 +0000 Authentication-Results: spf=pass (sender IP is 149.199.60.100) smtp.mailfrom=xilinx.com; vger.kernel.org; dkim=none (message not signed) header.d=none;vger.kernel.org; dmarc=bestguesspass action=none header.from=xilinx.com; Received-SPF: Pass (protection.outlook.com: domain of xilinx.com designates 149.199.60.100 as permitted sender) receiver=protection.outlook.com; client-ip=149.199.60.100; helo=xsj-pvapsmtpgw02; Received: from xsj-pvapsmtpgw02 (149.199.60.100) by SN1NAM02FT033.mail.protection.outlook.com (10.152.72.133) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.1.567.7 via Frontend Transport; Tue, 9 Aug 2016 09:34:53 +0000 Received: from unknown-38-66.xilinx.com ([149.199.38.66]:50779 helo=xsj-pvapsmtp01) by xsj-pvapsmtpgw02 with esmtp (Exim 4.63) (envelope-from ) id 1bX3Qz-0005fi-57; Tue, 09 Aug 2016 02:34:53 -0700 Received: from [127.0.0.1] (helo=localhost) by xsj-pvapsmtp01 with smtp (Exim 4.63) (envelope-from ) id 1bX3Qy-0001id-G0; Tue, 09 Aug 2016 02:34:52 -0700 Received: from xsj-pvapsmtp01 (smtp3.xilinx.com [149.199.38.66]) by xsj-smtp-dlp2.xlnx.xilinx.com (8.13.8/8.13.1) with ESMTP id u799YlKq018935; Tue, 9 Aug 2016 02:34:47 -0700 Received: from [172.23.64.208] (helo=xhdrdevl6.xilinx.com) by xsj-pvapsmtp01 with esmtp (Exim 4.63) (envelope-from ) id 1bX3Qt-0001eX-AA; Tue, 09 Aug 2016 02:34:47 -0700 Received: by xhdrdevl6.xilinx.com (Postfix, from userid 13614) id 13E1CF2000F; Tue, 9 Aug 2016 15:04:46 +0530 (IST) From: Kedareswara rao Appana To: , , , , , , , Subject: [RFC PATCH v5 2/3] Documentation: DT: net: Add Xilinx gmiitorgmii converter device tree binding documentation Date: Tue, 9 Aug 2016 15:04:42 +0530 Message-ID: <1470735283-23611-3-git-send-email-appanad@xilinx.com> X-Mailer: git-send-email 2.1.1 In-Reply-To: <1470735283-23611-1-git-send-email-appanad@xilinx.com> References: <1470735283-23611-1-git-send-email-appanad@xilinx.com> X-RCIS-Action: ALLOW X-TM-AS-Product-Ver: IMSS-7.1.0.1224-8.0.0.1202-22502.005 X-TM-AS-User-Approved-Sender: Yes;Yes X-EOPAttributedMessage: 0 X-MS-Office365-Filtering-HT: Tenant X-Forefront-Antispam-Report: CIP:149.199.60.100; IPV:NLI; CTRY:US; EFV:NLI; SFV:NSPM; SFS:(10009020)(6009001)(7916002)(2980300002)(438002)(199003)(189002)(76176999)(36386004)(2950100001)(189998001)(92566002)(87936001)(48376002)(50466002)(4001450100002)(46386002)(305945005)(5001770100001)(45336002)(36756003)(2201001)(81156014)(81166006)(8676002)(7846002)(8936002)(586003)(5003940100001)(50986999)(229853001)(50226002)(4326007)(106466001)(19580405001)(356003)(63266004)(19580395003)(103686003)(90966002)(33646002)(52956003)(86362001)(47776003)(42186005)(2906002)(107986001)(2101003)(5001870100001)(217873001); DIR:OUT; SFP:1101; SCL:1; SRVR:SN1NAM02HT253; H:xsj-pvapsmtpgw02; FPR:; SPF:Pass; PTR:xapps1.xilinx.com,unknown-60-100.xilinx.com; A:1; MX:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; SN1NAM02FT033; 1:IXNJSu5zhPGg6d7Mc9mywJwJaD4ZXknXZtJaVFvo/fo1QemYXjMLUBJi1AQ4wPKE7TkNIre3LYPhi8EGdrBNVMBEC3wdMXLFgB/05LaZqZ10GYlhHJuChzGia64h3vrwUuI0grs4K/cevlLKkmX+H/FRvINiQb5KKAmwtassqAM65UPgDoQFBu9fSbMq3OlrGSDjj+oJpl7g9LOnz3JdTWHv4O5J4xB595l6XOgOsFluBF/1zzxGRfxgae5eotorj9AhgZAqUTgjVTntlJ3JlbmsEWOU3Gf6rCzof2XwWJj/qe7PVF9mEnw/lHsgzGQtjxMtDtnxtUGFVKZ80Rb6v0hCF2EqxuHPIgWX7loTLEz/JxTI/DeyH21JQtvRA73G8UUQ4YceDJlZ+4CtMS+tFyDDDmoJsum7OL0JbqWHCXvTZcE9fAkJ3+I2f51qeauqWd0mN8m/tLCDD43qFbv4JI8YhpBZXy6z18SzksehKN5l9aAnBvqLIjwGUlh7XhhN4tNlSu55CGDHrFh8WmAcUiRUVWKnT+2JLWG60IbLPk60l/576nNFQ04XBl67ppsX8hls9zF6QNTZ0+PuW41istXVHsJo4/ZUo4Qo9Q6ZhdEAwmb2HBlUxxIr9Xid/JGB MIME-Version: 1.0 X-MS-Office365-Filtering-Correlation-Id: 93187243-11ff-48eb-c505-08d3c0386cdb X-Microsoft-Exchange-Diagnostics: 1; SN1NAM02HT253; 2:fNyN4wzcxMdnegU1fOqHpa0pNigDtQkXrRO1QAkP2qSWsig2S9yRVOCALuGkY/8abpNJuOskKAtS4rdKxu7kSCuxMm/OfZSSOWCAOT4OqiQ7WjbZeBGH2ZtUwLm92NPGDEJhu/y6yq2pjDhs+McdEIx4DUxB1oybF98qNnoAien1u2Y07+aLvxPAD92Fy2yk; 3:bc0kAbMdZnC61exSJjRFNaLOFqIJZ7D6XUeI9Fn94rwN1lAEEUi83wMMhw8zGYEIB6sWbdZ9spgBV6EuwlfEcdLeqqAS5+oX2uOZWq36w9iIC5LUISIMAYip9ub1kvOmeLZjxvNvzgq/99U1qWxfxjKOehsjVgGAlw6x1C03DG1m08lhxiBY2lJZbcmnz1Aw/5IRI7Gmmulk0zgTlI/XfQGVDxTh9be6uIsgLtRUG8HUU3fPJKMEflWoPypA53bvw4RZ/Yuo4esRf/H56bgMcQ==; 25:nOmuSIBlSd7p5asneG5ZkOxXODX/IjPNo4byf09888N/tZRdEPJzaMJmM3TDmeea7SfYvHKvOmrvuV3spFLv94f4CbR5mY48Uyxlxt7ww56q+L0SG9/xwRGsSC+3sQ8FVgSjX/EIvP4t6nWtqIgBy4hOyOxLFNZAfe3/9uipH3Bs4MKphtRGyszPnrRl0or7KuYDUMz5lzVWNfIAISYMuEHsvzLSZpyxv9tZFsC8VRTNeLUlSXYJbC9KFRptjOnfA6aQXaclCK/B0fnVZjenq3iyKCW3bigYGy/9M43jmF7NPucgfzF9sRTZ6wL6ItNLC5h2V/+sY1A5o2DWvd29RrmWgkMFnlxGg3swUoYqzBffIDq7+vmHdTX8PABHmNh/1VUnvJn0XZWIT+xuOvNOL/qWURCVp4rwlx+ChNp0AXs= X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(8251501002); SRVR:SN1NAM02HT253; X-Microsoft-Exchange-Diagnostics: 1; SN1NAM02HT253; 31:lsLymKl85/e1dGlLq+4ZrE9DuptFWI5GOwO1SiIGTV3tiDwYqjNBHM2faUVAtRVqC0yQX57W7h6V7axYC840vkmpDfaNb2N2yY9K9YVLoyD1dSck4dGcM6lvncrBZ76ilMsLNK23Fp8u70vYFOrBIt82ad2NswCEwjbXE5V+GHMWfeRD0vITaSYLUhQ8ytYHK5/2mYAGj7sXRhPM/b8W7SEJRK1Pv0yXM5LagdKcFNM=; 20:CxJxBGolQ1uKiVrqTGywN6yprMTMa25kR3FlrS2WKAvoDmWKt+sAsIpGsMx1noB0Nk94WUHNOjUOULvHZ9P4PwiWkz3yq6R8aOTlwKH+Qw/ljeN7Z/b/HOkFk6v6CJWVyvAmJC4Krt+J+JoqJrZH0OoTd9xrOB3p38m3MONzG4uupV/CPa+0Qi0v7Ir3BMi+8HIxa45JrZGBclnJ0JzWdY79OzrSUttdSHAZ6h4l14MHS0uTH24FzIoEHlerHw92SigHVZpKa9gziHGZmewMoZTv2WBABIxUYWiBjO2tB3TH5kLrRyrTvjs+Twy04etPiLj5iSiFQ+yDRwlLBh85dSDRVGOeaLVp4pT2Om+iNJLKdLO+rXrVryVt/lZsc28pB5iJPVYFvj6SF9kxGZ6fP3p+OKHmAm3y05Uji9lOjQCn0aVRjtjSFEEpbezxhqvIymRapEnwybYU1m7mcgC2WWFI0mQFdjiSd3LmW4wTyKWYpumyW45ykg75dUTlNoTw X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(192813158149592); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040161)(601004)(2401047)(8121501046)(5005006)(13018025)(13023025)(13017025)(13024025)(13015025)(3002001)(10201501046)(6055026); SRVR:SN1NAM02HT253; BCL:0; PCL:0; RULEID:; SRVR:SN1NAM02HT253; X-Microsoft-Exchange-Diagnostics: 1; SN1NAM02HT253; 4:M7flASVoVi5rxb1sk+uW0lyDSIuZSTJvc4gv+x9n1IHMLjwGL2olJyG/qHyqqdbqsoUOjd/tlPnw+jHaNV1FgAl9HQIQJaZtQ0O/F0TCoLA9EtYav4wY3NikGUZRbqU7PEwMadDrNF3Hbd1QTukxLW2dvzqGsqUDSh2f1Vup5hJiRp3K9mHZ578Zh5uhYVP+AYh0ISb0MirOxbVyRa0QGinW4XUh7ZU5C3oci8okVWhmfTVfPqeqVzfh0HA0qYl8zLJSYHz8xusO9fHtWWK83AqiZTjUWkxghUSHK+vpgGMq21rvQEFZfHq+duWimWA8VP4Oaj7bZFl4Bry2Gz9Rxcagiu09/+6xQRiQI0gSKdcn5ZnILWj6lo2KRhqKWJTDC+FFt8rWhUyQMzHrngX+sDDKxqkKoFQx0wV8pieB7qQlRCE2wNh1OQTHA/hDCF6MT5u33SOcpxBAoENm1ITPdr+rbYoDs7C87y81Aje2+hq0Qx7Kd1qqXC9Ek8J5MZjtD+hQAxrzz92jhZFiX0jxu1eUk+WOleb3k1aEWwLC7QM= X-Forefront-PRVS: 0029F17A3F X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; SN1NAM02HT253; 23:7Ie0/xaedqiyuFt4GlnbrEHGLSYUhDBjJJMJJh61P?= =?us-ascii?Q?REdpNEiIbEvm7lNufTL+RnT2i4tjD/lzFVhV+3bLjyvK3xAk53tp1OV3qQmU?= =?us-ascii?Q?wc0d0lsKNmYpLQ4Yli4YncoPsk3GHUWf7wYR/uKe2xc4XsIWfeJg0FcsviNT?= =?us-ascii?Q?DHldiIrpwva0d9LXtKrZ9mvVBAurXR/VLS5z9rbtw05JVUodGjIYGDslx55u?= =?us-ascii?Q?UKQmuKmcXw3luNzu8U3sbaMkACjjzidoPAoyCtpOksN15//Fdr7ZxxEMeY9u?= =?us-ascii?Q?Jsn6ZzqeZ5TR0vM7dwSdQCEVxZtlbMqVHox8Ipg5+tq5H3Fv4W1r4qjVClCF?= =?us-ascii?Q?bnmC53bw3H7ZHn5TqgK5mCJlCvrPABW1TfOvw5NDDDnHbmsn8qkl5eUQEnoj?= =?us-ascii?Q?TvIAVf3zOCE9KjwFeiI4D4wCU1DBmQuN+2jAOFXx/l1mXWFlEmP5yqt5ZyHs?= =?us-ascii?Q?f1blxutoMiL4gi2kRCiBVbwU2EIaRLohmcLbm0x8C3jiCuf2gmQxUTzMQRQo?= =?us-ascii?Q?IJyDHRTLcVfzc70FYIQ5PiNR44ndt0rUUn0VRBGNV+Zkgk71ye86cLb9XNt9?= =?us-ascii?Q?ikO7N6ZRC+v4BXI6PM2KVbWTWZxHonorbhmst7ZIN5dyjoF0i+Dpbue2DJcY?= =?us-ascii?Q?MwNqstRCgTdBbjOf/LLWAs+1qjYBdMWHz3oeagE47o6Mu2I5eNHp9T8g4Bpc?= =?us-ascii?Q?dBByKbH5D9IfhHDu6Y68ObREsaoAtp7SbtVNkfurxBEauwu/KvuYpxeJo0ML?= =?us-ascii?Q?/WHtXK6W/SnWX7ePOKXmLEHbwMVYVBB5kVOdj4URLnYs91ELuE/gjcNgGWcZ?= =?us-ascii?Q?4hxpeP6xQy2o8sSLwEBUoy6I8/QzE2MD8yly4xlHv6dJ8uGBzk9UXhxuDo1Y?= =?us-ascii?Q?7eJ50fTiKOb37olXgle5oW6md7iyCnZqMKr6BOnSIRmfuvZ1pbTLaBX02pLh?= =?us-ascii?Q?cZwHFf/ya6jFITUF3E6wZNF0wDF6djNxS/uWkpDoQzXfWk7e9sVc03X8e/Kg?= =?us-ascii?Q?j6op90lN5drBvCxaB/WuySLjN17w9BwMuQGzxVR2klp0QJDhcFS/9gUfE7vt?= =?us-ascii?Q?EgMsth2CdcpuGXK7NzR2wxIECHNqytlMMJXXBVzdCRl5EqIDlWBQKhgsmGhD?= =?us-ascii?Q?rSfPNX0cD39TxOvw62B92za7BKaMMZSoSQTN931UxlnDV+h/RG8PK+DS/yVk?= =?us-ascii?Q?zQOsLNfzNyTdVSRqM61U1ew0uM8POAthd6SQ2izDCQyU7dZBQOOCqMMI+vXl?= =?us-ascii?Q?25Rv0UuxwNdYWv1ucE=3D?= X-Microsoft-Exchange-Diagnostics: 1; SN1NAM02HT253; 6:NgnGfkUElChePhpoUayBExl4WliZzgqnpISUFG2AVOIxhh9X0O0P4nMLqxAq1de0ZdKz5afV8Lgcy2vB82SXGxYcGaFFr/jbBCQ6A9RWY1qLTDBMIXxaWrVO0gtXeEATEdq45bQ5h6bcl4NGK+oIsVUbi29465xOgqVhNG0Jt/aze/aV3tcuWZGqDbQSoFR11ayRxQlbFqKIBv+tLy+tCHwHYSd0e/WhKS85DPDcn0J6HH0phmqq0I98NgUqS728uV2Dto+Z1s7G4eL+DC/j546Mi6bSNqf9p2CIAmrsRQtNtJtR/8bhfR1dAp46uA7FyJYoEhRBzodRFy5aEsGcNQ==; 5:LihPBoNtH1ZloqQPqRlrJuIzA//pdZi/E2y/eGOd2WUA/BeBmP1rFsURuD82+QwPb4tO+tTGeGc0knV/LmJrV0j1KcAaoFAOeZA0f/df7rWoyuOGBM9m+Qm9VMiMcC+MZqfaJrGXEUd65hje1NHujg==; 24:ro4UcR4VQ/JOBtzdBJ/nSOPZ9EtBMA79BPpLN3smIEUwsORSoqOu1NIwOYvrpAGXRYvEFYBqzEkOJy7MusvXny7qE4olUs6J027d78k53OI=; 7:JD0n/JPFzHQBVd2q+W4k8vMA0EokQlSEU64qAiYrE8AbxVWvpM+6mtlYgYbLBQHI6UFwCjQntmnLCIUgv9WZM0mG4nfxMKAnCYv82IMMU6vo3lTVIYvwAUnfpCzGMjMizE09CxJ1MRVe7Ps+rpsmqohhhFg6KxfJ7fet0KS+VPP7XhdIP6eT+7qMTkDv6c/mAUUqqQwwt3jl7O/FwFIgzy/UOJqk3TIxBykhsBF9zvQl73b0bkXCb4lVviU/6Xe2 SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: xilinx.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 09 Aug 2016 09:34:53.6571 (UTC) X-MS-Exchange-CrossTenant-Id: 657af505-d5df-48d0-8300-c31994686c5c X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=657af505-d5df-48d0-8300-c31994686c5c; Ip=[149.199.60.100]; Helo=[xsj-pvapsmtpgw02] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: SN1NAM02HT253 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20160809_023519_906815_E7DDCE83 X-CRM114-Status: GOOD ( 11.94 ) 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: devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, netdev@vger.kernel.org Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org X-Virus-Scanned: ClamAV using ClamSMTP Device-tree binding documentation for xilinx gmiitorgmii converter. Signed-off-by: Kedareswara rao Appana --- Changes for v5: ---> Fixed Indentation in the example as suggested by Michal. Changes for v4: --> Modified compatible as suggested by Rob. --> Removed underscores from the converter node name as suggested by Rob. Changes for v3: --> None. Changes for v2: --> New patch. .../devicetree/bindings/net/xilinx_gmii2rgmii.txt | 38 ++++++++++++++++++++++ 1 file changed, 38 insertions(+) create mode 100644 Documentation/devicetree/bindings/net/xilinx_gmii2rgmii.txt diff --git a/Documentation/devicetree/bindings/net/xilinx_gmii2rgmii.txt b/Documentation/devicetree/bindings/net/xilinx_gmii2rgmii.txt new file mode 100644 index 0000000..5f48793 --- /dev/null +++ b/Documentation/devicetree/bindings/net/xilinx_gmii2rgmii.txt @@ -0,0 +1,38 @@ +XILINX GMIITORGMII Converter Driver Device Tree Bindings +-------------------------------------------------------- + +The Gigabit Media Independent Interface (GMII) to Reduced Gigabit Media +Independent Interface (RGMII) core provides the RGMII between RGMII-compliant +Ethernet physical media devices (PHY) and the Gigabit Ethernet controller. +This core can be used in all three modes of operation(10/100/1000 Mb/s). +The Management Data Input/Output (MDIO) interface is used to configure the +Speed of operation. This core can switch dynamically between the three +Different speed modes by configuring the conveter register through mdio write. + +The MDIO is a bus to which the PHY devices are connected. For each +device that exists on this bus, a child node should be created. See +the definition of the PHY node in booting-without-of.txt for an example +of how to define a PHY. + +This converter sits between the ethernet MAC and the external phy. +MAC <==> GMII2RGMII <==> RGMII_PHY + +Required properties: +- compatible : Should be "xlnx,gmii-to-rgmii-1.0" +- reg : The ID number for the phy, usually a small integer +- phy-handle : Should point to the external phy device. + See ethernet.txt file in the same directory. + +Example: + mdio { + #address-cells = <1>; + #size-cells = <0>; + phy: ethernet-phy@0 { + ...... + }; + gmiitorgmii: gmiitorgmii@8 { + compatible = "xlnx,gmii-to-rgmii-1.0"; + reg = <8>; + phy-handle = <&phy>; + }; + };