Received: by 2002:a05:7208:31d3:b0:81:e143:7c29 with SMTP id v19csp373401rbd; Fri, 5 Apr 2024 07:08:15 -0700 (PDT) X-Forwarded-Encrypted: i=3; AJvYcCWea/+Zt8J4SQX8UN8hjgtni8ARYEXAzyW0UWpLe1gm47SDj7iS/C4gDWMJKZIiPQmgnTCAC2OAmvYXJLjxXX1aLqFkDCBJr3+76DQxDQ== X-Google-Smtp-Source: AGHT+IFnY1wXtsPd6chZzJX5M0yrzdLDK8sKpg2rkUfluJ6AqasfPZc3CRO9H9XZcEEEFomY5L2b X-Received: by 2002:a17:90a:4298:b0:2a2:71c7:7e26 with SMTP id p24-20020a17090a429800b002a271c77e26mr1297894pjg.28.1712326095554; Fri, 05 Apr 2024 07:08:15 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1712326095; cv=pass; d=google.com; s=arc-20160816; b=OWDrU0DU+j4WYsaTXnS+OcJ84FnNrWcbyuYjIR58iixMd2E0qKZP+4+8y9VPSX6uJ9 BSHb3FqruES8514fSnV+rQbUucQRy29mk0ITwjuamRfoGCAVhIQWD9b0J5I05O86MO1I 8ZEMMYhZ9+vDk6tGTYJaS0PEltWr9UVt7W/wtAGa81QUk4qil2OwVR9v7Sawp0k4CukW a5ZNcs8NPEKT90Wu5HxP4jVPYPzRGAcbGUuly9ipqWSepJB4X6I6zSe+8Rlz6vJ6/mFa xE6RH+Ni4RHdS1FGtE0XxwBHbwaROcvjhIcUKMrvXQZa+rwzmyWaL2ezmLbQHLgnNvU4 nNsg== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=in-reply-to:content-disposition:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:references:message-id:subject:cc :to:from:date:dkim-signature; bh=FmeKqGjfgQeTQ1g4EZmlShTmHTH+/R/i6ctEOZxOAuA=; fh=lLLkhin/fCL11d4xnQBhzRXHOkfNY3tcfW6Xv3pAJYU=; b=w+yRrdoUhhghx7yjzMu+RcY6QdA16kLk2hYNnRga/IF7AUNEhESPpmU6m4PNaP7ftW NmjlRUX09IOjHUQ9jg6eUGdwvbp0wyGflgk5pVmt6lEwOcsx2hLnoNpAphE+z/eghdEL Qigd7uwTsX2scN5uAtQq3gTZNOyZPydYoqyQngsKq4gCvg8ES8koUAiiQucNhBPkekjY NlRKf6jmhwkagvIAC+Rw1fraU/qGzQjS7XCuS3NMvQ4z7tZEJCWLHFRcnhKbC/WwJziV 2G+LkpMbSvdLnJvcfZptDfqVBx1dwawv9oJvCJiILPaUIrT6HrzmXDs6c7SXL/1+U2Tb iIcQ==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b="TItTa8U/"; arc=pass (i=1 dkim=pass dkdomain=kernel.org); spf=pass (google.com: domain of linux-kernel+bounces-133108-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:40f1:3f00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-133108-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from sy.mirrors.kernel.org (sy.mirrors.kernel.org. [2604:1380:40f1:3f00::1]) by mx.google.com with ESMTPS id oa18-20020a17090b1bd200b002a2497adab9si3725592pjb.74.2024.04.05.07.08.15 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 05 Apr 2024 07:08:15 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel+bounces-133108-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:40f1:3f00::1 as permitted sender) client-ip=2604:1380:40f1:3f00::1; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b="TItTa8U/"; arc=pass (i=1 dkim=pass dkdomain=kernel.org); spf=pass (google.com: domain of linux-kernel+bounces-133108-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:40f1:3f00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-133108-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by sy.mirrors.kernel.org (Postfix) with ESMTPS id E6603B21D40 for ; Fri, 5 Apr 2024 14:06:55 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id A31BB16EBF8; Fri, 5 Apr 2024 14:06:35 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="TItTa8U/" Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id A601A16E89B; Fri, 5 Apr 2024 14:06:33 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1712325993; cv=none; b=q2hS5mWjQ6WwczevemPGncBZ1VqH8yZ8ZHjc8TZKNuhk4U54yH4sJXwPHfXFnbgEcQtY4G1OSliRUIhiP9CHwdcI/zr8NQLvRJM8dPY8476IOrHsKEII6AwU0JiTSx2UnVBt3Qe4Wis5xeetb6vThGoz9PW/Ij07y+iHbPwOvZE= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1712325993; c=relaxed/simple; bh=pSH7srtjrHzD34XWhY0xVHNO53tixigFATCb9kvfhWI=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=dO/wkrBcrCZcHT0vS3V9GD/zG2SjCdCwoKdZP6B6xJGKOKNtI6SpM3xhWhkFeWDh9EkljdEhBbkM1LIiMMMwA7HnD4LSvjLoV5nGXHzkjffbICZbGrAF3+maHlzziIja0NBDNP/iPHtWZ38ZaH1S6aTgMggn2Dr5+/fXSPVz8U4= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=TItTa8U/; arc=none smtp.client-ip=10.30.226.201 Received: by smtp.kernel.org (Postfix) with ESMTPSA id 4DB27C43394; Fri, 5 Apr 2024 14:06:31 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1712325993; bh=pSH7srtjrHzD34XWhY0xVHNO53tixigFATCb9kvfhWI=; h=Date:From:To:Cc:Subject:References:In-Reply-To:From; b=TItTa8U/BhcQQ07xcfNuJrptuQ4Mpp02mXKdPD0ROQ/hdJ4E1PSrkvj/EjwYgNy0z ZQbrWYGyzmdC+KeJ7RNFa08TiFB4/Ml7wYcYw4jFGUUTJ+g7jGIl3jMV+0lFVuSq2T QG4VxfQgvfY/M6wSiOqa1XtpVSTX0uLHbAG8uV3kFKLSUBKLDHfGmI/CE3X3PXpLy1 CKq3AWR7Uq920GOkUTbitWQksaIsw4xt1ha8TxbKi0KzUwZ5cs8Pwve5iATn4G1O/q HaFtq1q0Q9pI9+4lGAjr7uxeXegAvEsEy+Y0idRsQ1gMiZfvSGmKJv/tPBeNn/MTmz b0zwQuxjDsfKg== Date: Fri, 5 Apr 2024 19:36:27 +0530 From: Vinod Koul To: Daniel Golle Cc: Bc-bocun Chen , Steven Liu , John Crispin , Chunfeng Yun , Kishon Vijay Abraham I , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Matthias Brugger , AngeloGioacchino Del Regno , Qingfang Deng , SkyLake Huang , Philipp Zabel , linux-arm-kernel@lists.infradead.org, linux-mediatek@lists.infradead.org, linux-phy@lists.infradead.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, netdev@vger.kernel.org Subject: Re: [PATCH v3 2/2] phy: add driver for MediaTek XFI T-PHY Message-ID: References: <745f8b46f676e94c1a396df8c46aefe0e8b4771c.1707530671.git.daniel@makrotopia.org> <3bb95f1d795eede63284dbcb224e06ea6886b421.1707530671.git.daniel@makrotopia.org> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: On 28-03-24, 20:12, Daniel Golle wrote: > Hi Vinod, > > thank you for taking your time to review my submission! > > On Fri, Mar 29, 2024 at 12:22:47AM +0530, Vinod Koul wrote: > > On 10-02-24, 02:10, Daniel Golle wrote: > > > Add driver for MediaTek's XFI T-PHY which can be found in the MT7988 > > > > What does XFI mean? > > https://en.wikipedia.org/wiki/XFP_transceiver#XFI > > I chose this name because names of functions dealing with the phy in > the vendor driver are prefixed "xfi_pextp_". > The register space used by the phy is called "pextp", which could be > read as "_P_CI _ex_press _T_-_P_hy", and that is quite misleading as > this phy isn't used for anything related to PCIe, so I wanted to find > a better name. > > XFI is still somehow related (as in: you would find the relevant > places using grep in the vendor driver when looking for that) and > seemed to at least somehow be aligned with the function of that phy: > Dealing with (up to) 10 Gbit/s Ethernet SerDes signals. > > MediaTek calls phys with more than one potential use T-PHY or X-PHY: > The capital letter 'T' graphically connects 3 points, two of them > being on the upper side representing the internal components and one > on the lower side representing the single external interface. > > Other vendors (like Marvell) call such things "combo phys". > > Anyway, if anyone has better ideas regarding the naming, now is the > moment to speak up ;) This is fine. Combo phys are more common for ones dealing with multiple components. I am fine either way. But it is good to document why this was named as such > > > > > > > SoC. The XFI T-PHY is a 10 Gigabit/s Ethernet SerDes PHY with muxes on > > > the internal side to be used with either USXGMII PCS or LynxI PCS, > > > depending on the selected PHY interface mode. > > > > > > The PHY can operates only in PHY_MODE_ETHERNET, the submode is one of > > > PHY_INTERFACE_MODE_* corresponding to the supported modes: > > > > > > * USXGMII \ > > > * 10GBase-R }- USXGMII PCS - XGDM \ > > > * 5GBase-R / \ > > > }- Ethernet MAC > > > * 2500Base-X \ / > > > * 1000Base-X }- LynxI PCS - GDM / > > > * Cisco SGMII (MAC side) / > > > > > > In order to work-around a performance issue present on the first of > > > two XFI T-PHYs present in MT7988, special tuning is applied which can be > > > selected by adding the 'mediatek,usxgmii-performance-errata' property to > > > the device tree node. > > > > > > There is no documentation for most registers used for the > > > analog/tuning part, however, most of the registers have been partially > > > reverse-engineered from MediaTek's SDK implementation (an opaque > > > sequence of 32-bit register writes) and descriptions for all relevant > > > digital registers and bits such as resets and muxes have been supplied > > > by MediaTek. > > > > > > Signed-off-by: Daniel Golle > > > Reviewed-by: AngeloGioacchino Del Regno > > > --- > > > v3: no changes > > > v2: > > > * use IO helpers from mtk-io.h instead of rolling my own > > > * use devm_clk_bulk_get() > > > * yse devm_platform_ioremap_resource() > > > * unify name and description everywhere > > > * invert bool is_xgmii into bool use_lynxi_pcs and add comments > > > describing the meaning of each of the stack variables > > > * not much we can do about remaining magic values unless MTK provides > > > definitions for them > > > > > > > > > MAINTAINERS | 1 + > > > drivers/phy/mediatek/Kconfig | 12 + > > > drivers/phy/mediatek/Makefile | 1 + > > > drivers/phy/mediatek/phy-mtk-xfi-tphy.c | 360 ++++++++++++++++++++++++ > > > 4 files changed, 374 insertions(+) > > > create mode 100644 drivers/phy/mediatek/phy-mtk-xfi-tphy.c > > > > > > diff --git a/MAINTAINERS b/MAINTAINERS > > > index 4be2fd097f261..616b86e3e62fd 100644 > > > --- a/MAINTAINERS > > > +++ b/MAINTAINERS > > > @@ -13776,6 +13776,7 @@ L: netdev@vger.kernel.org > > > S: Maintained > > > F: drivers/net/phy/mediatek-ge-soc.c > > > F: drivers/net/phy/mediatek-ge.c > > > +F: drivers/phy/mediatek/phy-mtk-xfi-tphy.c > > > > > > MEDIATEK I2C CONTROLLER DRIVER > > > M: Qii Wang > > > diff --git a/drivers/phy/mediatek/Kconfig b/drivers/phy/mediatek/Kconfig > > > index 3849b7c87d287..117d0e84c7360 100644 > > > --- a/drivers/phy/mediatek/Kconfig > > > +++ b/drivers/phy/mediatek/Kconfig > > > @@ -13,6 +13,18 @@ config PHY_MTK_PCIE > > > callback for PCIe GEN3 port, it supports software efuse > > > initialization. > > > > > > +config PHY_MTK_XFI_TPHY > > > + tristate "MediaTek 10GE SerDes XFI T-PHY driver" > > > + depends on ARCH_MEDIATEK || COMPILE_TEST > > > + depends on OF && OF_ADDRESS > > > > why both, is OF not enough? > > As we are already also depending on HAS_IOMEM what is left there is > basically just a !SPARC dependency. > And that is probably a historic left-over and (according to commit > 5ab5fc7e35705c from 2010...) should be re-evaluated. I'm happy to drop > OF_ADDRESS and keep only HAS_IOMEM, and we shall see if any of the > COMPILE_TESTs actually fails, given that everyone is fine with that. Yeah HAS_IOMEM would be required for it to get compiled on diff archs. I think OF should suffice... wdyt? > > > > > > + depends on HAS_IOMEM > > > + select GENERIC_PHY > > > + help > > > + Say 'Y' here to add support for MediaTek XFI T-PHY driver. > > > + The driver provides access to the Ethernet SerDes T-PHY supporting > > > + 1GE and 2.5GE modes via the LynxI PCS, and 5GE and 10GE modes > > > + via the USXGMII PCS found in MediaTek SoCs with 10G Ethernet. > > > + > > > config PHY_MTK_TPHY > > > tristate "MediaTek T-PHY Driver" > > > depends on ARCH_MEDIATEK || COMPILE_TEST > > > diff --git a/drivers/phy/mediatek/Makefile b/drivers/phy/mediatek/Makefile > > > index f6e24a47e0815..1b8088df71e84 100644 > > > --- a/drivers/phy/mediatek/Makefile > > > +++ b/drivers/phy/mediatek/Makefile > > > @@ -8,6 +8,7 @@ obj-$(CONFIG_PHY_MTK_PCIE) += phy-mtk-pcie.o > > > obj-$(CONFIG_PHY_MTK_TPHY) += phy-mtk-tphy.o > > > obj-$(CONFIG_PHY_MTK_UFS) += phy-mtk-ufs.o > > > obj-$(CONFIG_PHY_MTK_XSPHY) += phy-mtk-xsphy.o > > > +obj-$(CONFIG_PHY_MTK_XFI_TPHY) += phy-mtk-xfi-tphy.o > > > > > > phy-mtk-hdmi-drv-y := phy-mtk-hdmi.o > > > phy-mtk-hdmi-drv-y += phy-mtk-hdmi-mt2701.o > > > diff --git a/drivers/phy/mediatek/phy-mtk-xfi-tphy.c b/drivers/phy/mediatek/phy-mtk-xfi-tphy.c > > > new file mode 100644 > > > index 0000000000000..551d6cee33f94 > > > --- /dev/null > > > +++ b/drivers/phy/mediatek/phy-mtk-xfi-tphy.c > > > @@ -0,0 +1,360 @@ > > > +// SPDX-License-Identifier: GPL-2.0-or-later > > > +/* MediaTek 10GE SerDes XFI T-PHY driver > > > + * > > > + * Copyright (c) 2024 Daniel Golle > > > + * Bc-bocun Chen > > > + * based on mtk_usxgmii.c and mtk_sgmii.c found in MediaTek's SDK (GPL-2.0) > > > + * Copyright (c) 2022 MediaTek Inc. > > > + * Author: Henry Yen > > > + */ > > > + > > > +#include > > > +#include > > > +#include > > > +#include > > > +#include > > > +#include > > > +#include > > > +#include > > > +#include > > > + > > > +#include "phy-mtk-io.h" > > > + > > > +#define MTK_XFI_TPHY_NUM_CLOCKS 2 > > > + > > > +#define REG_DIG_GLB_70 0x0070 > > > +#define XTP_PCS_RX_EQ_IN_PROGRESS(x) FIELD_PREP(GENMASK(25, 24), (x)) > > > +#define XTP_PCS_MODE_MASK GENMASK(17, 16) > > > +#define XTP_PCS_MODE(x) FIELD_PREP(GENMASK(17, 16), (x)) > > > +#define XTP_PCS_RST_B BIT(15) > > > +#define XTP_FRC_PCS_RST_B BIT(14) > > > +#define XTP_PCS_PWD_SYNC_MASK GENMASK(13, 12) > > > +#define XTP_PCS_PWD_SYNC(x) FIELD_PREP(XTP_PCS_PWD_SYNC_MASK, (x)) > > > +#define XTP_PCS_PWD_ASYNC_MASK GENMASK(11, 10) > > > +#define XTP_PCS_PWD_ASYNC(x) FIELD_PREP(XTP_PCS_PWD_ASYNC_MASK, (x)) > > > +#define XTP_FRC_PCS_PWD_ASYNC BIT(8) > > > +#define XTP_PCS_UPDT BIT(4) > > > +#define XTP_PCS_IN_FR_RG BIT(0) > > > + > > > +#define REG_DIG_GLB_F4 0x00f4 > > > +#define XFI_DPHY_PCS_SEL BIT(0) > > > +#define XFI_DPHY_PCS_SEL_SGMII FIELD_PREP(XFI_DPHY_PCS_SEL, 1) > > > +#define XFI_DPHY_PCS_SEL_USXGMII FIELD_PREP(XFI_DPHY_PCS_SEL, 0) > > > +#define XFI_DPHY_AD_SGDT_FRC_EN BIT(5) > > > + > > > +#define REG_DIG_LN_TRX_40 0x3040 > > > +#define XTP_LN_FRC_TX_DATA_EN BIT(29) > > > +#define XTP_LN_TX_DATA_EN BIT(28) > > > + > > > +#define REG_DIG_LN_TRX_B0 0x30b0 > > > +#define XTP_LN_FRC_TX_MACCK_EN BIT(5) > > > +#define XTP_LN_TX_MACCK_EN BIT(4) > > > + > > > +#define REG_ANA_GLB_D0 0x90d0 > > > +#define XTP_GLB_USXGMII_SEL_MASK GENMASK(3, 1) > > > +#define XTP_GLB_USXGMII_SEL(x) FIELD_PREP(GENMASK(3, 1), (x)) > > > +#define XTP_GLB_USXGMII_EN BIT(0) > > > + > > > +struct mtk_xfi_tphy { > > > + void __iomem *base; > > > + struct device *dev; > > > + struct reset_control *reset; > > > + struct clk_bulk_data clocks[MTK_XFI_TPHY_NUM_CLOCKS]; > > > + bool da_war; > > > +}; > > > + > > > +static void mtk_xfi_tphy_setup(struct mtk_xfi_tphy *xfi_tphy, > > > + phy_interface_t interface) > > > +{ > > > + /* Override 10GBase-R tuning value if work-around is selected */ > > > + bool da_war = (xfi_tphy->da_war && (interface == PHY_INTERFACE_MODE_10GBASER)); > > > > why do you need braces around this? > > Just for readability. They can safely be removed. > > > > > > + /* Bools to make setting up values for specific PHY speeds easier */ > > > + bool is_2p5g = (interface == PHY_INTERFACE_MODE_2500BASEX); > > > + bool is_1g = (interface == PHY_INTERFACE_MODE_1000BASEX || > > > + interface == PHY_INTERFACE_MODE_SGMII); > > > + bool is_10g = (interface == PHY_INTERFACE_MODE_10GBASER || > > > + interface == PHY_INTERFACE_MODE_USXGMII); > > > + bool is_5g = (interface == PHY_INTERFACE_MODE_5GBASER); > > > + /* Bool to configure input mux to either > > > + * - USXGMII PCS (64b/66b coding) for 5G/10G > > > + * - LynxI PCS (8b/10b coding) for 1G/2.5G > > > + */ > > > + bool use_lynxi_pcs = (is_1g || is_2p5g); > > > > This is quite terrible to read, how about declaring variables first and > > then doing the initialization? > > Ack. > > > > > > + > > > + dev_dbg(xfi_tphy->dev, "setting up for mode %s\n", phy_modes(interface)); > > > + > > > + /* Setup PLL setting */ > > > + mtk_phy_update_bits(xfi_tphy->base + 0x9024, 0x100000, is_10g ? 0x0 : 0x100000); > > > + mtk_phy_update_bits(xfi_tphy->base + 0x2020, 0x202000, is_5g ? 0x202000 : 0x0); > > > + mtk_phy_update_bits(xfi_tphy->base + 0x2030, 0x500, is_1g ? 0x0 : 0x500); > > > + mtk_phy_update_bits(xfi_tphy->base + 0x2034, 0xa00, is_1g ? 0x0 : 0xa00); > > > + mtk_phy_update_bits(xfi_tphy->base + 0x2040, 0x340000, is_1g ? 0x200000 : 0x140000); > > > > magic numbers? > > Yes, and not much we can do about them. According to MTK engineers (in > Cc) they also don't know what those numbers really mean in detail and > have only been given sequences of magic register writes for each > interface mode ([1], [2], [3], [4], [5]) by the upstream IP supplier > of the PHY. I then compared those write sequences with each others, > and observed the behavior of each register (as in: read their value > before and after the write operation; all of them read back the value > written to them) and rewrote the initialization as one function only > changing the bits actually needed (instead of always writing the complete > 32-bit value). I've made sure that everything still works and Bc-bocun > Chen of MediaTek (also in Cc) then helped to label at least some of > the registers and bits there in as far as they are understood by > MediaTek. > > [1]: https://git01.mediatek.com/plugins/gitiles/openwrt/feeds/mtk-openwrt-feeds/+/refs/heads/master/21.02/files/target/linux/mediatek/files-5.4/drivers/net/ethernet/mediatek/mtk_sgmii.c#172 > [2]: https://git01.mediatek.com/plugins/gitiles/openwrt/feeds/mtk-openwrt-feeds/+/refs/heads/master/21.02/files/target/linux/mediatek/files-5.4/drivers/net/ethernet/mediatek/mtk_sgmii.c#284 > [3]: https://git01.mediatek.com/plugins/gitiles/openwrt/feeds/mtk-openwrt-feeds/+/refs/heads/master/21.02/files/target/linux/mediatek/files-5.4/drivers/net/ethernet/mediatek/mtk_usxgmii.c#132 > [4]: https://git01.mediatek.com/plugins/gitiles/openwrt/feeds/mtk-openwrt-feeds/+/refs/heads/master/21.02/files/target/linux/mediatek/files-5.4/drivers/net/ethernet/mediatek/mtk_usxgmii.c#246 > [5]: https://git01.mediatek.com/plugins/gitiles/openwrt/feeds/mtk-openwrt-feeds/+/refs/heads/master/21.02/files/target/linux/mediatek/files-5.4/drivers/net/ethernet/mediatek/mtk_usxgmii.c#360 Okay lets document the source of magic values so that people may refer to these > > > > > > + > > > + /* Setup RXFE BW setting */ > > > + mtk_phy_update_bits(xfi_tphy->base + 0x50f0, 0xc10, is_1g ? 0x410 : is_5g ? 0x800 : 0x400); > > > + mtk_phy_update_bits(xfi_tphy->base + 0x50e0, 0x4000, is_5g ? 0x0 : 0x4000); > > > + > > > + /* Setup RX CDR setting */ > > > + mtk_phy_update_bits(xfi_tphy->base + 0x506c, 0x30000, is_5g ? 0x0 : 0x30000); > > > + mtk_phy_update_bits(xfi_tphy->base + 0x5070, 0x670000, is_5g ? 0x620000 : 0x50000); > > > + mtk_phy_update_bits(xfi_tphy->base + 0x5074, 0x180000, is_5g ? 0x180000 : 0x0); > > > + mtk_phy_update_bits(xfi_tphy->base + 0x5078, 0xf000400, is_5g ? 0x8000000 : > > > + 0x7000400); > > > + mtk_phy_update_bits(xfi_tphy->base + 0x507c, 0x5000500, is_5g ? 0x4000400 : > > > + 0x1000100); > > > + mtk_phy_update_bits(xfi_tphy->base + 0x5080, 0x1410, is_1g ? 0x400 : is_5g ? 0x1010 : 0x0); > > > + mtk_phy_update_bits(xfi_tphy->base + 0x5084, 0x30300, is_1g ? 0x30300 : > > > + is_5g ? 0x30100 : > > > + 0x100); > > > + mtk_phy_update_bits(xfi_tphy->base + 0x5088, 0x60200, is_1g ? 0x20200 : > > > + is_5g ? 0x40000 : > > > + 0x20000); > > > + > > > + /* Setting RXFE adaptation range setting */ > > > + mtk_phy_update_bits(xfi_tphy->base + 0x50e4, 0xc0000, is_5g ? 0x0 : 0xc0000); > > > + mtk_phy_update_bits(xfi_tphy->base + 0x50e8, 0x40000, is_5g ? 0x0 : 0x40000); > > > + mtk_phy_update_bits(xfi_tphy->base + 0x50ec, 0xa00, is_1g ? 0x200 : 0x800); > > > + mtk_phy_update_bits(xfi_tphy->base + 0x50a8, 0xee0000, is_5g ? 0x800000 : > > > + 0x6e0000); > > > + mtk_phy_update_bits(xfi_tphy->base + 0x6004, 0x190000, is_5g ? 0x0 : 0x190000); > > > + > > > + if (is_10g) > > > + writel(0x01423342, xfi_tphy->base + 0x00f8); > > > + else if (is_5g) > > > + writel(0x00a132a1, xfi_tphy->base + 0x00f8); > > > + else if (is_2p5g) > > > + writel(0x009c329c, xfi_tphy->base + 0x00f8); > > > + else > > > + writel(0x00fa32fa, xfi_tphy->base + 0x00f8); > > > + > > > + /* Force SGDT_OUT off and select PCS */ > > > + mtk_phy_update_bits(xfi_tphy->base + REG_DIG_GLB_F4, > > > + XFI_DPHY_AD_SGDT_FRC_EN | XFI_DPHY_PCS_SEL, > > > + XFI_DPHY_AD_SGDT_FRC_EN | > > > + (use_lynxi_pcs ? XFI_DPHY_PCS_SEL_SGMII : > > > + XFI_DPHY_PCS_SEL_USXGMII)); > > > + > > > + /* Force GLB_CKDET_OUT */ > > > + mtk_phy_set_bits(xfi_tphy->base + 0x0030, 0xc00); > > > + > > > + /* Force AEQ on */ > > > + writel(XTP_PCS_RX_EQ_IN_PROGRESS(2) | XTP_PCS_PWD_SYNC(2) | XTP_PCS_PWD_ASYNC(2), > > > + xfi_tphy->base + REG_DIG_GLB_70); > > > + > > > + usleep_range(1, 5); > > > + > > > + /* Setup TX DA default value */ > > > + mtk_phy_update_bits(xfi_tphy->base + 0x30b0, 0x30, 0x20); > > > + writel(0x00008a01, xfi_tphy->base + 0x3028); > > > + writel(0x0000a884, xfi_tphy->base + 0x302c); > > > + writel(0x00083002, xfi_tphy->base + 0x3024); > > > + > > > + /* Setup RG default value */ > > > + if (use_lynxi_pcs) { > > > + writel(0x00011110, xfi_tphy->base + 0x3010); > > > + writel(0x40704000, xfi_tphy->base + 0x3048); > > > + } else { > > > + writel(0x00022220, xfi_tphy->base + 0x3010); > > > + writel(0x0f020a01, xfi_tphy->base + 0x5064); > > > + writel(0x06100600, xfi_tphy->base + 0x50b4); > > > + if (interface == PHY_INTERFACE_MODE_USXGMII) > > > + writel(0x40704000, xfi_tphy->base + 0x3048); > > > + else > > > + writel(0x47684100, xfi_tphy->base + 0x3048); > > > + } > > > + > > > + if (is_1g) > > > + writel(0x0000c000, xfi_tphy->base + 0x3064); > > > + > > > + /* Setup RX EQ initial value */ > > > + mtk_phy_update_bits(xfi_tphy->base + 0x3050, 0xa8000000, > > > + (interface != PHY_INTERFACE_MODE_10GBASER) ? 0xa8000000 : 0x0); > > > + mtk_phy_update_bits(xfi_tphy->base + 0x3054, 0xaa, > > > + (interface != PHY_INTERFACE_MODE_10GBASER) ? 0xaa : 0x0); > > > + > > > + if (!use_lynxi_pcs) > > > + writel(0x00000f00, xfi_tphy->base + 0x306c); > > > + else if (is_2p5g) > > > + writel(0x22000f00, xfi_tphy->base + 0x306c); > > > + else > > > + writel(0x20200f00, xfi_tphy->base + 0x306c); > > > + > > > + mtk_phy_update_bits(xfi_tphy->base + 0xa008, 0x10000, da_war ? 0x10000 : 0x0); > > > + > > > + mtk_phy_update_bits(xfi_tphy->base + 0xa060, 0x50000, use_lynxi_pcs ? 0x50000 : 0x40000); > > > + > > > + /* Setup PHYA speed */ > > > + mtk_phy_update_bits(xfi_tphy->base + REG_ANA_GLB_D0, > > > + XTP_GLB_USXGMII_SEL_MASK | XTP_GLB_USXGMII_EN, > > > + is_10g ? XTP_GLB_USXGMII_SEL(0) : > > > + is_5g ? XTP_GLB_USXGMII_SEL(1) : > > > + is_2p5g ? XTP_GLB_USXGMII_SEL(2) : > > > + XTP_GLB_USXGMII_SEL(3)); > > > + mtk_phy_set_bits(xfi_tphy->base + REG_ANA_GLB_D0, XTP_GLB_USXGMII_EN); > > > + > > > + /* Release reset */ > > > + mtk_phy_set_bits(xfi_tphy->base + REG_DIG_GLB_70, > > > + XTP_PCS_RST_B | XTP_FRC_PCS_RST_B); > > > + usleep_range(150, 500); > > > + > > > + /* Switch to P0 */ > > > + mtk_phy_update_bits(xfi_tphy->base + REG_DIG_GLB_70, > > > + XTP_PCS_IN_FR_RG | > > > + XTP_FRC_PCS_PWD_ASYNC | > > > + XTP_PCS_PWD_ASYNC_MASK | > > > + XTP_PCS_PWD_SYNC_MASK | > > > + XTP_PCS_UPDT, > > > + XTP_PCS_IN_FR_RG | > > > + XTP_FRC_PCS_PWD_ASYNC | > > > + XTP_PCS_UPDT); > > > + usleep_range(1, 5); > > > + > > > + mtk_phy_clear_bits(xfi_tphy->base + REG_DIG_GLB_70, XTP_PCS_UPDT); > > > + usleep_range(15, 50); > > > + > > > + if (use_lynxi_pcs) { > > > + /* Switch to Gen2 */ > > > + mtk_phy_update_bits(xfi_tphy->base + REG_DIG_GLB_70, > > > + XTP_PCS_MODE_MASK | XTP_PCS_UPDT, > > > + XTP_PCS_MODE(1) | XTP_PCS_UPDT); > > > + } else { > > > + /* Switch to Gen3 */ > > > + mtk_phy_update_bits(xfi_tphy->base + REG_DIG_GLB_70, > > > + XTP_PCS_MODE_MASK | XTP_PCS_UPDT, > > > + XTP_PCS_MODE(2) | XTP_PCS_UPDT); > > > + } > > > + usleep_range(1, 5); > > > + > > > + mtk_phy_clear_bits(xfi_tphy->base + REG_DIG_GLB_70, XTP_PCS_UPDT); > > > + > > > + usleep_range(100, 500); > > > + > > > + /* Enable MAC CK */ > > > + mtk_phy_set_bits(xfi_tphy->base + REG_DIG_LN_TRX_B0, XTP_LN_TX_MACCK_EN); > > > + mtk_phy_clear_bits(xfi_tphy->base + REG_DIG_GLB_F4, XFI_DPHY_AD_SGDT_FRC_EN); > > > + > > > + /* Enable TX data */ > > > + mtk_phy_set_bits(xfi_tphy->base + REG_DIG_LN_TRX_40, > > > + XTP_LN_FRC_TX_DATA_EN | XTP_LN_TX_DATA_EN); > > > + usleep_range(400, 1000); > > > +} > > > + > > > +static int mtk_xfi_tphy_set_mode(struct phy *phy, enum phy_mode mode, int > > > + submode) > > > +{ > > > + struct mtk_xfi_tphy *xfi_tphy = phy_get_drvdata(phy); > > > + > > > + if (mode != PHY_MODE_ETHERNET) > > > + return -EINVAL; > > > + > > > + switch (submode) { > > > + case PHY_INTERFACE_MODE_1000BASEX: > > > + case PHY_INTERFACE_MODE_2500BASEX: > > > + case PHY_INTERFACE_MODE_SGMII: > > > + case PHY_INTERFACE_MODE_5GBASER: > > > + case PHY_INTERFACE_MODE_10GBASER: > > > + case PHY_INTERFACE_MODE_USXGMII: > > > + mtk_xfi_tphy_setup(xfi_tphy, submode); > > > + return 0; > > > + default: > > > + return -EINVAL; > > > + } > > > +} > > > + > > > +static int mtk_xfi_tphy_reset(struct phy *phy) > > > +{ > > > + struct mtk_xfi_tphy *xfi_tphy = phy_get_drvdata(phy); > > > + > > > + reset_control_assert(xfi_tphy->reset); > > > + usleep_range(100, 500); > > > + reset_control_deassert(xfi_tphy->reset); > > > + usleep_range(1, 10); > > > + > > > + return 0; > > > +} > > > + > > > +static int mtk_xfi_tphy_power_on(struct phy *phy) > > > +{ > > > + struct mtk_xfi_tphy *xfi_tphy = phy_get_drvdata(phy); > > > + > > > + return clk_bulk_prepare_enable(MTK_XFI_TPHY_NUM_CLOCKS, xfi_tphy->clocks); > > > +} > > > + > > > +static int mtk_xfi_tphy_power_off(struct phy *phy) > > > +{ > > > + struct mtk_xfi_tphy *xfi_tphy = phy_get_drvdata(phy); > > > + > > > + clk_bulk_disable_unprepare(MTK_XFI_TPHY_NUM_CLOCKS, xfi_tphy->clocks); > > > + > > > + return 0; > > > +} > > > + > > > +static const struct phy_ops mtk_xfi_tphy_ops = { > > > + .power_on = mtk_xfi_tphy_power_on, > > > + .power_off = mtk_xfi_tphy_power_off, > > > + .set_mode = mtk_xfi_tphy_set_mode, > > > + .reset = mtk_xfi_tphy_reset, > > > + .owner = THIS_MODULE, > > > +}; > > > + > > > +static int mtk_xfi_tphy_probe(struct platform_device *pdev) > > > +{ > > > + struct device_node *np = pdev->dev.of_node; > > > + struct phy_provider *phy_provider; > > > + struct mtk_xfi_tphy *xfi_tphy; > > > + struct phy *phy; > > > + int ret; > > > + > > > + if (!np) > > > + return -ENODEV; > > > + > > > + xfi_tphy = devm_kzalloc(&pdev->dev, sizeof(*xfi_tphy), GFP_KERNEL); > > > + if (!xfi_tphy) > > > + return -ENOMEM; > > > + > > > + xfi_tphy->base = devm_platform_ioremap_resource(pdev, 0); > > > + if (IS_ERR(xfi_tphy->base)) > > > + return PTR_ERR(xfi_tphy->base); > > > + > > > + xfi_tphy->dev = &pdev->dev; > > > + xfi_tphy->clocks[0].id = "topxtal"; > > > + xfi_tphy->clocks[1].id = "xfipll"; > > > + ret = devm_clk_bulk_get(&pdev->dev, MTK_XFI_TPHY_NUM_CLOCKS, xfi_tphy->clocks); > > > + if (ret) > > > + return ret; > > > + > > > + xfi_tphy->reset = devm_reset_control_get_exclusive(&pdev->dev, NULL); > > > + if (IS_ERR(xfi_tphy->reset)) > > > + return PTR_ERR(xfi_tphy->reset); > > > + > > > + xfi_tphy->da_war = of_property_read_bool(np, "mediatek,usxgmii-performance-errata"); > > > + > > > + phy = devm_phy_create(&pdev->dev, NULL, &mtk_xfi_tphy_ops); > > > + if (IS_ERR(phy)) > > > + return PTR_ERR(phy); > > > + > > > + phy_set_drvdata(phy, xfi_tphy); > > > + phy_provider = devm_of_phy_provider_register(&pdev->dev, of_phy_simple_xlate); > > > + > > > + return PTR_ERR_OR_ZERO(phy_provider); > > > +} > > > + > > > +static const struct of_device_id mtk_xfi_tphy_match[] = { > > > + { .compatible = "mediatek,mt7988-xfi-tphy", }, > > > + { /* sentinel */ } > > > +}; > > > +MODULE_DEVICE_TABLE(of, mtk_xfi_tphy_match); > > > + > > > +static struct platform_driver mtk_xfi_tphy_driver = { > > > + .probe = mtk_xfi_tphy_probe, > > > + .driver = { > > > + .name = "mtk-xfi-tphy", > > > + .of_match_table = mtk_xfi_tphy_match, > > > + }, > > > +}; > > > +module_platform_driver(mtk_xfi_tphy_driver); > > > + > > > +MODULE_DESCRIPTION("MediaTek 10GE SerDes XFI T-PHY driver"); > > > +MODULE_AUTHOR("Daniel Golle "); > > > +MODULE_AUTHOR("Bc-bocun Chen "); > > > +MODULE_LICENSE("GPL"); > > > -- > > > 2.43.0 > > > > -- > > ~Vinod -- ~Vinod