From patchwork Thu Dec 7 21:31:15 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Dhaval Shah X-Patchwork-Id: 845869 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=none (mailfrom) smtp.mailfrom=vger.kernel.org (client-ip=209.132.180.67; helo=vger.kernel.org; envelope-from=devicetree-owner@vger.kernel.org; receiver=) Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (1024-bit key; unprotected) header.d=xilinx.onmicrosoft.com header.i=@xilinx.onmicrosoft.com header.b="T6W9YvVx"; dkim-atps=neutral Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 3yt8BR22Ltz9rxm for ; Fri, 8 Dec 2017 08:43:59 +1100 (AEDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752491AbdLGVn5 (ORCPT ); Thu, 7 Dec 2017 16:43:57 -0500 Received: from mail-cys01nam02on0051.outbound.protection.outlook.com ([104.47.37.51]:22592 "EHLO NAM02-CY1-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1750978AbdLGVny (ORCPT ); Thu, 7 Dec 2017 16:43:54 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=xilinx.onmicrosoft.com; s=selector1-xilinx-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=urOnYwpDvrXpV9HS17f3ndIq9ZErggEqEnBUNxTlyJQ=; b=T6W9YvVxF1P5B2lrXRW4u1ZTszDe1VHFtC8i20uG/dWytvgQ3x4zlJytICMEXd7IRPrdYpbeCHWvWBwsLnTgnIABIyMhpUmG30frB/NcbbU18RwHSwBivyzWpSAqG+CmidXX8EJzfZjFc9lIelA7o5Gilwz3DSgd5txqunX1Yk0= Received: from BLUPR0201CA0025.namprd02.prod.outlook.com (10.163.116.35) by CY4PR02MB3381.namprd02.prod.outlook.com (10.165.89.152) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.282.5; Thu, 7 Dec 2017 21:43:52 +0000 Received: from CY1NAM02FT046.eop-nam02.prod.protection.outlook.com (2a01:111:f400:7e45::208) by BLUPR0201CA0025.outlook.office365.com (2a01:111:e400:52e7::35) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.302.9 via Frontend Transport; Thu, 7 Dec 2017 21:43:51 +0000 Authentication-Results: spf=pass (sender IP is 149.199.60.83) smtp.mailfrom=xilinx.com; arndb.de; dkim=none (message not signed) header.d=none;arndb.de; dmarc=bestguesspass action=none header.from=xilinx.com; Received-SPF: Pass (protection.outlook.com: domain of xilinx.com designates 149.199.60.83 as permitted sender) receiver=protection.outlook.com; client-ip=149.199.60.83; helo=xsj-pvapsmtpgw01; Received: from xsj-pvapsmtpgw01 (149.199.60.83) by CY1NAM02FT046.mail.protection.outlook.com (10.152.74.232) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.20.282.5 via Frontend Transport; Thu, 7 Dec 2017 21:43:51 +0000 Received: from unknown-38-66.xilinx.com ([149.199.38.66] helo=xsj-pvapsmtp01) by xsj-pvapsmtpgw01 with esmtp (Exim 4.63) (envelope-from ) id 1eN3xN-0004gx-UC; Thu, 07 Dec 2017 13:43:49 -0800 Received: from [127.0.0.1] (helo=localhost) by xsj-pvapsmtp01 with smtp (Exim 4.63) (envelope-from ) id 1eN3xN-0005wr-SO; Thu, 07 Dec 2017 13:43:49 -0800 Received: from [172.19.2.141] (helo=xsjnirmala50.xilinx.com) by xsj-pvapsmtp01 with esmtp (Exim 4.63) (envelope-from ) id 1eN3xD-0005tq-Q4; Thu, 07 Dec 2017 13:43:39 -0800 From: Dhaval Shah To: , , , , CC: , , , , Dhaval Shah Subject: [PATCH v2 1/2] Documentation: devicetree: Add DT bindings to xlnx_vcu driver Date: Thu, 7 Dec 2017 13:31:15 -0800 Message-ID: <1512682276-6082-2-git-send-email-dshah@xilinx.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1512682276-6082-1-git-send-email-dshah@xilinx.com> References: <20171207104757.GA27343@kroah.com> <1512682276-6082-1-git-send-email-dshah@xilinx.com> X-TM-AS-Product-Ver: IMSS-7.1.0.1224-8.1.0.1062-23514.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.83; IPV:NLI; CTRY:US; EFV:NLI; SFV:NSPM; SFS:(10009020)(346002)(376002)(39860400002)(2980300002)(438002)(199004)(189003)(77096006)(356003)(478600001)(8676002)(50226002)(305945005)(4326008)(81166006)(9786002)(36386004)(8936002)(7696005)(51416003)(107886003)(72206003)(76176011)(36756003)(80792005)(106466001)(110136005)(2906002)(16586007)(54906003)(81156014)(2201001)(47776003)(5660300001)(106002)(50466002)(2950100002)(6666003)(48376002)(33646002)(63266004)(316002)(107986001); DIR:OUT; SFP:1101; SCL:1; SRVR:CY4PR02MB3381; H:xsj-pvapsmtpgw01; FPR:; SPF:Pass; PTR:unknown-60-83.xilinx.com; A:1; MX:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; CY1NAM02FT046; 1:kl/dm8KOjlhP3Qn9Z5LLvXy7oDm00QoTZRXlImyf5HjSFjsCTuNG2EJrC90qe4Ke2kCO6p6K6CCGVtHqfDx4ckK512ygHqR2Se/sK56h2fZiMzrp7xmUfswfbB1WhV7c MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 9621c8d5-9ef8-47ce-eef4-08d53dbb9b49 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(5600026)(4604075)(4608076)(4534020)(4602075)(4627115)(201703031133081)(201702281549075)(2017052603304); SRVR:CY4PR02MB3381; X-Microsoft-Exchange-Diagnostics: 1; CY4PR02MB3381; 3:3k7SM3AEwB2wLaSEtIV9FP/VkmJaHidV74GL7NumWKdP+SmINdovm+UKm8xg9MXxwGCBN/rh72n1xrekN0CcTVBPaDofQlKyNhZw+vR1sC+KttiXbRp6dM7BrCz7i7kVkjkP/ogE3Z0uyIyZG3HLC8gULZ281Pin+AgiywZWDZ3U5jXUuMESntExYIX2ERSCOmCO0UiGZ0KVwAj0ri0g/VFTWA1wNQzGWPrIbE2WE93fLOiCbIHavHWMf37tT35XgF89vXuPF3dG9S5N3VPRMQv3Nbkzn3Refv2G/5ThYcc6q6GORuJ3Ha0kB7dM3bL8R917x2Gy7C7klIayO9kq3bKnhH8AN3nE3GI+I6tNjFM=; 25:QINgYd2NGO481Nd+m+qXw/GDHT58o+JdXg+zJeZeqcLqxAszbQAo1bY2x5mUFGfLizh0dB+dx5QUicFpXiOSeKAq5cqlXVGk4oi47zMKhaKp2sU7IB+kob/RXFjxzqmjDJAznwBh+sH5Vnr8tvdsMMgLkft/i4B1hISMbwBIIKVe4OExu5ujoEta/4gOQ3BguLrSfOCZYjn/mJdp/OcZttuCGxlS9w34Mm6zVqmoZPjpRMEvBaQogw/uD/Sss86pGBifJmpvnZKCNk5ZTSC4V5wuGyrblMVDsUXnoDJd8+kcapzegux73YV1nX6BZ3oTFpwz+7nhcn17K6r1Oh8NgQ== X-MS-TrafficTypeDiagnostic: CY4PR02MB3381: X-Microsoft-Exchange-Diagnostics: 1; CY4PR02MB3381; 31:q7JvGW0N5becehcHwiZVkR4tMALDaAUYWHZuXKUBFDkWHsneo+BFsifxYMmJMAwqSBNzzurngyaTuaN/xnb/U8t/t+fQ65KZ49oPS0tZCBLgAoNYNgE3YfU5D/yq2401/ic2XbPavKqXyHMBT82kLWFTa7oEKWlYXrVhblH9u0jwRzwPqrsff9dPQ6XoyFihShGlb++87vV9yVpQV327iTbJ3xsRfCBf5zamk4ysV80=; 20:VBaD5iWsQLm4JnLzJNy//cpiYuO+eiux6JBR2BxrPsvyjFFL0CfIZdp29I6WIcqKSh31x0HxqmG+sdRNgToLZiaAYMR3zG9DBE0ro5nuSP0MfIDgJvuy27DuRY1I0t/GCr6sGDKWExgQw+lmQrSPymIf/eqlJtt7eTem/HPG2i3yz0R+YsSzO7Gg8+AMTCUHOeJ+d0IDis4NuHHgfHPIMDinxuT2U1vfwQjphea+wWXfGyrNs4UwHwPpiNFrDLlWKXfnKVCveZBVRnAJW7h0fwFx6gV9Jdd0Gr4N8W3cxQXMQISwVL2hIXhtf9z3UkWkSIZf9EYsboDrECnH/ie8zSy+3rJa0xlUy8apYJ9ZKnHQhNxb7srL814NWL4il4kXo5LPx1jv5UoobLOFoXm73TAosdANew99j0Snjr7OUYAg+GEfogrX8sI7bfgy4pRldyD0BCqivxSxFXtFm3+t05xJvzwH+hmMC0PMVhglygGTZ08dmbepCAlceTuEvBsL X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(192813158149592); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040450)(2401047)(5005006)(8121501046)(3231022)(10201501046)(93006095)(93004095)(3002001)(6055026)(6041248)(201703131423075)(201702281528075)(201703061421075)(201703061406153)(20161123558100)(20161123564025)(20161123555025)(20161123560025)(20161123562025)(6072148)(201708071742011); SRVR:CY4PR02MB3381; BCL:0; PCL:0; RULEID:(100000803101)(100110400095); SRVR:CY4PR02MB3381; X-Microsoft-Exchange-Diagnostics: 1; CY4PR02MB3381; 4:6EcL58T8q24MOwK6JgMcrqV1cobIh5KFUJrF3OWQZuQxwjPFlIiB1wgBcanhbcBtK+IR/2Aa+XE9w0T6JHYxFW5bgILodwVHah11uB5RwJqd/atsChJneZ06sl9dX/9e7wziwcRHPC5sWNMIazkvqiDHTTJ0mMye6Qe9yUvxGFDnS5qRmiNFT0diYtv96fIaTd5uKgNbrF58hXBV0ZPyZzxb6fuzCZ4cvfV2BZy5QcFGnO7J2KhJMf6GoriGMCuE//laSJ0xigyKdGi33x/iKIxSJhkqrg4r9egvxAbo6YCv27tZHtjAK460jEyLxFg1 X-Forefront-PRVS: 05143A8241 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; CY4PR02MB3381; 23:Y38keFrXxiOPDNaSNCV5ZiXTbeubUReufanGhBin0?= F0P5VmtqDMVxIDP7RZL1OTTTsUxL9i7Z0BIkZVTlXECYt+Cn+1cSrdw9BfL8Zx4wVFm0kibtwdau8qLX+DGZQzcm481i07rSHXyThQKSuOMuutMmsqyqnEplidQDW1hVRVK7GePi14zi3rvXINMj2TaazESiUP5Ns7Il+t6m7LBct5TQXkl+JNZbOcbrxb6E+G/DobJrn8F2HdscGVyqgzzWg4ZZx7s9IzbNw3P0zBvAQvxGPv3HoABcERTEq88Ah2nTEvumAV9LtCPuKuGTF/WWx1SZfY/MajUpbCI4mqI4kctCmcCxYhBYBkIoMb40i5ClNzpGXsry3NN1Lnd/Z6fwLR36fPUMh2smCrJ/e4baVwdyqWgBMLNr2SdDk1Ob1Co7hQfvKjENlaOe3wTVeMXGaqWB/gbHBrNI/HettrN7IE4MKjrtRw83rVKp4PrHL6CYhg/kY74Vl8IgYmN+Jc7kaTRbMAJW6HGrusUH1B9ZLdqWbvvPDCLxvyWu8ZYYeluQAooIYrBJlOMwAPOJfT8ZHRjuBCwfoYAIxsh8BURzLutWQf0PfmU+0pc3GVC3OC6n/r6rBV7FJ8Lu5Z79Paw0lkjuP1VG48Y5ZG0mbB0xWz1LawB0njrsfnWezAdaYFJosRpck5g0EleGk3xoY1ehXl3E/cSnYzjJ8qKKDbu5B1jkzShnAQZ8Adnk364cBTB1c9V2Pr9XycF8X3EY3NrOKcuUKC9ZUQspFX4ZYV9ddUhQigtQnQJNHNq8tHorGBpxwtFWjoQKr1jbXYRmlp5RV++0QsW50Y/cjvi+8GfnUTIv0c38SCOzkPgToG02S7KD/a149/TssTi7MgI+xMiAJaDvVuH212XDS/8EjBPbyfQCWgjDHKHn1D0fBWJ1pbh2WuI4oIGrat7QM7+kvHnlCIvflJqERe/VkT2YbLxp4OBrTQCEwArPiyHuFnNN4EaZjFoAqS/VsSK0G1qKPok X-Microsoft-Exchange-Diagnostics: 1; CY4PR02MB3381; 6:+F6qk/2W2sxi9CbQWd+AFmEevrx9Sop4uLVqNFu1LH7SC3BIs/wKlwXtz/K0iXvYgXOEorzmtfzwU67v63+99OCTDkzSkSx/nc2EP9GoIngUQeneZo5Oy7OLtSmhP6gSlpsZvSkaF1cBlU/6wlOnlCSlxFf8B3cIXDQZcnVdXK8wTawoo/8ecCXJUQKDfoEezpZsvJUZcbakHzHjBdWcYB+XnIojg/scEYPQqttZjyDpfzlS232u5miA3p00I76fCie8YVPwfciqCjmXZExvbsxy8mUFUlPxwMBeRvWtMbJJZPwqa3Lk9KFhbAGTUfC+2kxh8Omk4F7UY1HYes7M/UaDxClrR7mEMxaFOrBlx70=; 5:DMZ9064ifdjSqQd0We4LYs7PgX+nqiuFrvb4HyP34PIhKSnueNaStWH83bFztEPtWorHHuZbMLhFgs4UKh/yvYyw53oDxNhDaSaXPTS8CuakyLukvNi8Lw1GtVa9Gh4D+QSzBvADoBAkJTBCYsdHEySqxbrSXEfUJe6u1wl/obQ=; 24:peGcvyeasATCvkQACeZhhAhyhcV/OYXC0gPQ9TbHi2PmhCzEWxJWfhUls06MA3G1qiBiexqBY6iCqu961k9CHfSUW6zKRGqiJVdNqmg/r/c=; 7:Pb7vkAKCsZ834VI9oS1R+WCRfJ6zQqvjNP99yj4iQbhkh1YDYT9gpRPf3HjyS18OsTHCWWiPnqcmS4E8M3Ot03RUjUAMnVzwZxoPoA/duGTRJWwfk4v4GcKYprot+BKXru5SUB6f+tYcxlMTl0TIXiSE8ArPTxdHHqyrCGkgW2go0GhM7DtqyBq5E0QX06+zTClF33ig830rKf1W+LcGezm5EswgTaQ9/IkqCyPVxFHql7WjHEZ4gkLYmEYhmlN+ SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: xilinx.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 07 Dec 2017 21:43:51.3004 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 9621c8d5-9ef8-47ce-eef4-08d53dbb9b49 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.83]; Helo=[xsj-pvapsmtpgw01] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: CY4PR02MB3381 Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org Add Device Tree binding document for logicoreIP. This logicoreIP provides the isolation between the processing system and programmable logic. Also provides the clock related information. Signed-off-by: Dhaval Shah Reviewed-by: Rob Herring --- Changes since v2: * Describe the h/w * compatible string is updated to make it more specific based on the logicoreIP version. * Removed that encoder and decoder child nodes and relatd properties as that will be a separate driver and dts nodes. other team is working on that. * Updated to use as a single driver. .../devicetree/bindings/misc/xlnx,vcu.txt | 31 ++++++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 Documentation/devicetree/bindings/misc/xlnx,vcu.txt diff --git a/Documentation/devicetree/bindings/misc/xlnx,vcu.txt b/Documentation/devicetree/bindings/misc/xlnx,vcu.txt new file mode 100644 index 0000000..6786d67 --- /dev/null +++ b/Documentation/devicetree/bindings/misc/xlnx,vcu.txt @@ -0,0 +1,31 @@ +LogicoreIP designed compatible with Xilinx ZYNQ family. +------------------------------------------------------- + +General concept +--------------- + +LogicoreIP design to provide the isolation between processing system +and programmable logic. Also provides the list of register set to configure +the frequency. + +Required properties: +- compatible: shall be one of: + "xlnx,vcu" + "xlnx,vcu-logicoreip-1.0" +- reg, reg-names: There are two sets of registers need to provide. + 1. vcu slcr + 2. Logicore + reg-names should contain name for the each register sequence. +- clocks: phandle for aclk and pll_ref clocksource +- clock-names: The identification string, "aclk", is always required for + the axi clock. "pll_ref" is required for pll. +Example: + + xlnx_vcu: vcu@a0040000 { + compatible = "xlnx,vcu-logicoreip-1.0"; + reg = <0x0 0xa0040000 0x0 0x1000>, + <0x0 0xa0041000 0x0 0x1000>; + reg-names = "vcu_slcr", "logicore"; + clocks = <&si570_1>, <&clkc 71>; + clock-names = "pll_ref", "aclk"; + };