From patchwork Wed Oct 16 11:31:16 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Kishon Vijay Abraham I X-Patchwork-Id: 176468 Delivered-To: patch@linaro.org Received: by 2002:a92:7e96:0:0:0:0:0 with SMTP id q22csp7234282ill; Wed, 16 Oct 2019 04:32:31 -0700 (PDT) X-Google-Smtp-Source: APXvYqxk6SZl8qyxB11SHGN6vAheTvKC7+RlBh6nJLUPnkPxju6SWKXb6+jepsJQcpfO667Ay28Y X-Received: by 2002:a17:906:c2c1:: with SMTP id ch1mr37850928ejb.321.1571225551076; Wed, 16 Oct 2019 04:32:31 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1571225551; cv=none; d=google.com; s=arc-20160816; b=UScT1t61Uv6vXwZeoUAQab4y4zlRkY1WZjCAcG9Jrg5ewOetUTbdOIcxh2qcI9fsMa 2DMrF7rHbuPr8ST9EDgeaH+cJ3XNDXa0nYlYi3HvQ44ruIBgRO107r1u7WoUih8XxGze 2FMUx5TlMoeGdFndX95VbvX3pmOmIxWhgOdqYp216bzCnv4xsU2W8DbhF2jrw1yLCe1z 8yl02KlQ/ZGrEtHsGJwWFBhNPB0jvH3AqGpF848N5TMluuFhEP7pgSrXoUw5kFWidI2g gK+40FzZQqYjqYwW5MadBYrY+73lBeukfdLTgo8ghqj9aLYRJAetY3RCj6WWlOdDNZRg ensw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:dkim-signature; bh=lu2aQMjEO+OiMZpRh1hPo2mocSefRsjFC/UXdwkkxKU=; b=Hk+Melx2/dqAde8W+A0RKkTERJFxyj9yN8NINJ68Ry9rTEhof/nfP6+Pe+O6gp2eqx x1iCONsVLmeLB8Ce2ZYB6cJfQuHNEXL3zhmd+5arlTUP9sGkH5Zt3NM5fOG6V3LCl2nn hWwl247Aax28b5Op9fnxHm3JMuQ05oo68s5Qc5Fn736OwZqug98wsiPvOaWkxDNdSdZo xYFWBx8Wvrjab8v8ouJBPpVpksQ9y6T5y9vD+eFNKOCc8so9ytNGfOXNaFBRx8mGGVkn 7bSpOVGgXPtonwrSbE+IFDzMq+CQmUmHQASNXlPlUF6Kt6NLypybHKSf+fZE1+P4piA/ cBnQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@ti.com header.s=ti-com-17Q1 header.b=Oa4uQPWJ; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=QUARANTINE sp=NONE dis=NONE) header.from=ti.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id u27si15646361ejb.172.2019.10.16.04.32.30; Wed, 16 Oct 2019 04:32:31 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; dkim=pass header.i=@ti.com header.s=ti-com-17Q1 header.b=Oa4uQPWJ; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=QUARANTINE sp=NONE dis=NONE) header.from=ti.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S2405117AbfJPLc2 (ORCPT + 26 others); Wed, 16 Oct 2019 07:32:28 -0400 Received: from lelv0143.ext.ti.com ([198.47.23.248]:50402 "EHLO lelv0143.ext.ti.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S2405101AbfJPLcY (ORCPT ); Wed, 16 Oct 2019 07:32:24 -0400 Received: from lelv0266.itg.ti.com ([10.180.67.225]) by lelv0143.ext.ti.com (8.15.2/8.15.2) with ESMTP id x9GBWH6b097221; Wed, 16 Oct 2019 06:32:17 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ti.com; s=ti-com-17Q1; t=1571225537; bh=lu2aQMjEO+OiMZpRh1hPo2mocSefRsjFC/UXdwkkxKU=; h=From:To:CC:Subject:Date:In-Reply-To:References; b=Oa4uQPWJmTFq2ojCyQJEjopnK6B85t0jI6tVV4B5+vf4MoRPRPARPt0G5XMnDLr/u XNjjPQq3kdb0J5IBqRzxBNUP26Oapmg8nBt8YIOD6l5ePR+9jaMWPGSJaEQnl1MzHI lI2ia2i9Nz8vTPu3vhNPKW4dijXK86exuXdpIgu0= Received: from DFLE109.ent.ti.com (dfle109.ent.ti.com [10.64.6.30]) by lelv0266.itg.ti.com (8.15.2/8.15.2) with ESMTPS id x9GBWHM9114223 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=FAIL); Wed, 16 Oct 2019 06:32:17 -0500 Received: from DFLE109.ent.ti.com (10.64.6.30) by DFLE109.ent.ti.com (10.64.6.30) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1713.5; Wed, 16 Oct 2019 06:32:10 -0500 Received: from fllv0039.itg.ti.com (10.64.41.19) by DFLE109.ent.ti.com (10.64.6.30) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1713.5 via Frontend Transport; Wed, 16 Oct 2019 06:32:10 -0500 Received: from a0393678ub.india.ti.com (ileax41-snat.itg.ti.com [10.172.224.153]) by fllv0039.itg.ti.com (8.15.2/8.15.2) with ESMTP id x9GBVkmG097485; Wed, 16 Oct 2019 06:32:14 -0500 From: Kishon Vijay Abraham I To: Kishon Vijay Abraham I , Roger Quadros , Jyri Sarha CC: Anil Varughese , , , Rob Herring Subject: [PATCH 12/13] dt-bindings: phy: Document WIZ (SERDES wrapper) bindings Date: Wed, 16 Oct 2019 17:01:16 +0530 Message-ID: <20191016113117.12370-13-kishon@ti.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20191016113117.12370-1-kishon@ti.com> References: <20191016113117.12370-1-kishon@ti.com> MIME-Version: 1.0 X-EXCLAIMER-MD-CONFIG: e1e8a2fd-e40a-4ac6-ac9b-f7e9cc9ee180 Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Add DT binding documentation for WIZ (SERDES wrapper). WIZ is *NOT* a PHY but a wrapper used to configure some of the input signals to the SERDES. It is used with both Sierra(16G) and Torrent(10G) serdes. Cc: Rob Herring Signed-off-by: Kishon Vijay Abraham I [jsarha@ti.com: Add separate compatible for Sierra(16G) and Torrent(10G) SERDES] Signed-off-by: Jyri Sarha --- .../bindings/phy/ti,phy-j721e-wiz.txt | 95 +++++++++++++++++++ 1 file changed, 95 insertions(+) create mode 100644 Documentation/devicetree/bindings/phy/ti,phy-j721e-wiz.txt -- 2.17.1 diff --git a/Documentation/devicetree/bindings/phy/ti,phy-j721e-wiz.txt b/Documentation/devicetree/bindings/phy/ti,phy-j721e-wiz.txt new file mode 100644 index 000000000000..19b4c3e855d6 --- /dev/null +++ b/Documentation/devicetree/bindings/phy/ti,phy-j721e-wiz.txt @@ -0,0 +1,95 @@ +TI J721E WIZ (SERDES Wrapper) + +Required properties: + - compatible: Should be "ti,j721e-wiz-16g" for Sierra phy wrapper, + or "ti,j721e-wiz-10g" for Torrent phy wrapper. + - #address-cells : should be 2 to indicate the child node should use 2 cell + for address + - #size-cells: should be 2 to indicate the child node should use 2 cell for + size + - power-domains: As documented by the generic PM domain bindings in + Documentation/devicetree/bindings/power/power_domain.txt. + - clocks: clock-specifier to represent input to the WIZ required for WIZ + module to be functional + - num-lanes: Represents thenumber of lanes enabled in the SoC + Should be '2' for Sierra wrapper in J721E + Should be '4' for Torrent wrapper in J721E + - #reset-cells: As documented by the generic reset bindings in + Documentation/devicetree/bindings/reset/reset.txt + Should be '1' + - ranges: Empty ranges property to describe 1:1 translation between parent + address space and child address space + +Optional properties: +assigned-clocks and assigned-clock-parents: As documented in the generic +clock bindings in Documentation/devicetree/bindings/clock/clock-bindings.txt + +Required subnodes: + - Clock Subnode: WIZ node should have '3' subnodes for each of the clock + selects it supports. The clock subnodes should have the following names + 1) pll0_refclk + 2) pll1_refclk + 3) refclk_dig + Each of these subnodes should clocks, clock-output-names, #clock-cells, + assigned-clocks and assigned-clock-parents. All these properties are + documented in the generic clock bindings in + Documentation/devicetree/bindings/clock/clock-bindings.txt + - SERDES Subnode: WIZ node should have '1' subnode for the SERDES + *) Sierra SERDES should follow the bindings specified in + Documentation/devicetree/bindings/phy/phy-cadence-sierra.txt + *) Torrent SERDES should follow the bindings specified in + Documentation/devicetree/bindings/phy/phy-cadence-dp.txt + +Example: Example shows binding for SERDES_16G (Sierra SERDES with WIZ wrapper) +serdes_wiz0: wiz@5000000 { + compatible = "ti,j721e-wiz-16g"; + #address-cells = <2>; + #size-cells = <2>; + power-domains = <&k3_pds 292 TI_SCI_PD_EXCLUSIVE>; + clocks = <&k3_clks 292 5>; + num-lanes = <2>; + #reset-cells = <1>; + ranges; + + pll0_refclk: pll0_refclk { + clocks = <&k3_clks 292 11>, <&cmn_refclk>; + clock-output-names = "pll0_refclk"; + #clock-cells = <0>; + assigned-clocks = <&pll0_refclk>; + assigned-clock-parents = <&k3_clks 292 11>; + }; + + pll1_refclk: pll1_refclk { + clocks = <&k3_clks 292 0>, <&cmn_refclk1>; + clock-output-names = "pll1_refclk"; + #clock-cells = <0>; + assigned-clocks = <&pll1_refclk>; + assigned-clock-parents = <&k3_clks 292 0>; + }; + + refclk_dig: refclk_dig { + clocks = <&k3_clks 292 11>, <&k3_clks 292 0>, + <&cmn_refclk>, <&cmn_refclk1>; + clock-output-names = "refclk_dig"; + #clock-cells = <0>; + assigned-clocks = <&refclk_dig>; + assigned-clock-parents = <&k3_clks 292 11>; + }; + + serdes0: serdes@5000000 { + compatible = "cdns,ti,sierra-phy-t0"; + reg-names = "serdes"; + reg = <0x00 0x5000000 0x00 0x10000>; + #address-cells = <1>; + #size-cells = <0>; + resets = <&serdes_wiz0 0>; + reset-names = "sierra_reset"; + pcie0_phy0: link@0 { + reg = <0>; + cdns,num-lanes = <2>; + #phy-cells = <0>; + cdns,phy-type = ; + resets = <&serdes_wiz0 1>, <&serdes_wiz0 2>; + }; + }; +};