From patchwork Thu Mar 6 17:54:56 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Loc Ho X-Patchwork-Id: 327537 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id F20552C00AA for ; Fri, 7 Mar 2014 04:55:26 +1100 (EST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753384AbaCFRzW (ORCPT ); Thu, 6 Mar 2014 12:55:22 -0500 Received: from exprod5og119.obsmtp.com ([64.18.0.189]:38794 "HELO exprod5og119.obsmtp.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with SMTP id S1753238AbaCFRzU (ORCPT ); Thu, 6 Mar 2014 12:55:20 -0500 Received: from mail-pa0-f42.google.com ([209.85.220.42]) (using TLSv1) by exprod5ob119.postini.com ([64.18.4.12]) with SMTP ID DSNKUxi2h2touJnartYGd1Qi/ew+Vll2eq/q@postini.com; Thu, 06 Mar 2014 09:55:19 PST Received: by mail-pa0-f42.google.com with SMTP id fb1so3001016pad.1 for ; Thu, 06 Mar 2014 09:55:18 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=im6XGOePwfAcafdNbGTEXoaSzK/f8D+T+5aArKVFE5Y=; b=Jyz+tiEw99kXKadPQdAyTFzRW8pKK0qzTTDT4/5r9oBWdTNj7upunb/nko8BAKZGht h9+TWNLCCs0ODe2MiD21QyvWpLpLVtVzXfLDeGRAu8ewfcdk/+x+cgrWfV18ids9Zcqf aiVUjMDaJzN+Df8/0v7tsqxX9Jdl/6HJ2neXgIGdSsrRpIfIWPq/bJT/9NU4jW0trLJ2 iQiSAf7UbJoUJkGN2gI4+1+U7o77adwDy3Dcs4E9Xf/xBW6uoobQYcTNQqII0TvaHdL1 zhW3oVCEIcJvqx4u7RTykdrkCUhzWYlHBLr+CtQTptBLzyJUM03GjIKXKJHH4PGm3t7/ G39Q== X-Received: by 10.68.132.233 with SMTP id ox9mr16218928pbb.138.1394128518815; Thu, 06 Mar 2014 09:55:18 -0800 (PST) X-Gm-Message-State: ALoCoQkchBZPG3EzqiY0hBIzvmoT1qcusU2P3iTq/oCwaALUCh08xOsMVxVDkEcJvzArCS7Vy2pWzQwbpKS1Wx1tIFwsbeJkYpYUNNy3j9nl/dtp8rCP/SiPQGgFtZRLYjMgQXwWlYRxooFCeLKF5BjiW7POHLMv/VyNouvZKQVOgm+uFm7U03E= X-Received: by 10.68.132.233 with SMTP id ox9mr16218388pbb.138.1394128514168; Thu, 06 Mar 2014 09:55:14 -0800 (PST) Received: from localhost ([198.137.200.11]) by mx.google.com with ESMTPSA id ha2sm22024508pbb.8.2014.03.06.09.55.12 for (version=TLSv1 cipher=RC4-SHA bits=128/128); Thu, 06 Mar 2014 09:55:13 -0800 (PST) From: Loc Ho To: kishon@ti.com, tj@kernel.org Cc: olof@lixom.net, arnd@arndb.de, linux-kernel@vger.kernel.org, linux-scsi@vger.kernel.org, linux-ide@vger.kernel.org, devicetree@vger.kernel.org, linux-arm-kernel@lists.infradead.org, ddutile@redhat.com, jcm@redhat.com, patches@apm.com, Loc Ho , Tuan Phan , Suman Tripathi Subject: [PATCH v14 1/3] Documentation: Add APM X-Gene SoC 15Gbps Multi-purpose PHY driver binding documentation Date: Thu, 6 Mar 2014 10:54:56 -0700 Message-Id: <1394128498-28420-2-git-send-email-lho@apm.com> X-Mailer: git-send-email 1.5.5 In-Reply-To: <1394128498-28420-1-git-send-email-lho@apm.com> References: <1394128498-28420-1-git-send-email-lho@apm.com> Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org This patch adds the APM X-Gene SoC 15Gbps Multi-purpose PHY driver binding documentation. Signed-off-by: Loc Ho Signed-off-by: Tuan Phan Signed-off-by: Suman Tripathi --- .../devicetree/bindings/phy/apm-xgene-phy.txt | 79 ++++++++++++++++++++ 1 files changed, 79 insertions(+), 0 deletions(-) create mode 100644 Documentation/devicetree/bindings/phy/apm-xgene-phy.txt diff --git a/Documentation/devicetree/bindings/phy/apm-xgene-phy.txt b/Documentation/devicetree/bindings/phy/apm-xgene-phy.txt new file mode 100644 index 0000000..5f3a65a --- /dev/null +++ b/Documentation/devicetree/bindings/phy/apm-xgene-phy.txt @@ -0,0 +1,79 @@ +* APM X-Gene 15Gbps Multi-purpose PHY nodes + +PHY nodes are defined to describe on-chip 15Gbps Multi-purpose PHY. Each +PHY (pair of lanes) has its own node. + +Required properties: +- compatible : Shall be "apm,xgene-phy". +- reg : PHY memory resource is the SDS PHY access resource. +- #phy-cells : Shall be 1 as it expects one argument for setting + the mode of the PHY. Possible values are 0 (SATA), + 1 (SGMII), 2 (PCIe), 3 (USB), and 4 (XFI). + +Optional properties: +- status : Shall be "ok" if enabled or "disabled" if disabled. + Default is "ok". +- clocks : Reference to the clock entry. +- apm,tx-eye-tuning : Manual control to fine tune the capture of the serial + bit lines from the automatic calibrated position. + Two set of 3-tuple setting for each (up to 3) + supported link speed on the host. Range from 0 to + 127 in unit of one bit period. Default is 10. +- apm,tx-eye-direction : Eye tuning manual control direction. 0 means sample + data earlier than the nominal sampling point. 1 means + sample data later than the nominal sampling point. + Two set of 3-tuple setting for each (up to 3) + supported link speed on the host. Default is 0. +- apm,tx-boost-gain : Frequency boost AC (LSB 3-bit) and DC (2-bit) + gain control. Two set of 3-tuple setting for each + (up to 3) supported link speed on the host. Range is + between 0 to 31 in unit of dB. Default is 3. +- apm,tx-amplitude : Amplitude control. Two set of 3-tuple setting for + each (up to 3) supported link speed on the host. + Range is between 0 to 199500 in unit of uV. + Default is 199500 uV. +- apm,tx-pre-cursor1 : 1st pre-cursor emphasis taps control. Two set of + 3-tuple setting for each (up to 3) supported link + speed on the host. Range is 0 to 273000 in unit of + uV. Default is 0. +- apm,tx-pre-cursor2 : 2st pre-cursor emphasis taps control. Two set of + 3-tuple setting for each (up to 3) supported link + speed on the host. Range is 0 to 127400 in unit uV. + Default is 0x0. +- apm,tx-post-cursor : Post-cursor emphasis taps control. Two set of + 3-tuple setting for Gen1, Gen2, and Gen3. Range is + between 0 to 0x1f in unit of 18.2mV. Default is 0xf. +- apm,tx-speed : Tx operating speed. One set of 3-tuple for each + supported link speed on the host. + 0 = 1-2Gbps + 1 = 2-4Gbps (1st tuple default) + 2 = 4-8Gbps + 3 = 8-15Gbps (2nd tuple default) + 4 = 2.5-4Gbps + 5 = 4-5Gbps + 6 = 5-6Gbps + 7 = 6-16Gbps (3rd tuple default) + +NOTE: PHY override parameters are board specific setting. + +Example: + phy1: phy@1f21a000 { + compatible = "apm,xgene-phy"; + reg = <0x0 0x1f21a000 0x0 0x100>; + #phy-cells = <1>; + status = "disabled"; + }; + + phy2: phy@1f22a000 { + compatible = "apm,xgene-phy"; + reg = <0x0 0x1f22a000 0x0 0x100>; + #phy-cells = <1>; + status = "ok"; + }; + + phy3: phy@1f23a000 { + compatible = "apm,xgene-phy"; + reg = <0x0 0x1f23a000 0x0 0x100>; + #phy-cells = <1>; + status = "ok"; + };