--- /dev/null
+// SPDX-License-Identifier: GPL-2.0
+/*
+ * phy-zynqmp.c - PHY driver for Xilinx ZynqMP GT.
+ *
+ * Copyright (C) 2018-2020 Xilinx Inc.
+ *
+ * Author: Anurag Kumar Vulisha <anuragku@xilinx.com>
+ * Author: Subbaraya Sundeep <sundeep.lkml@gmail.com>
+ * Author: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
+ *
+ * This driver is tested for USB, SATA and Display Port currently.
+ * Other controllers PCIe and SGMII should also work but that is
+ * experimental as of now.
+ */
+
+#include <linux/clk.h>
+#include <linux/delay.h>
+#include <linux/io.h>
+#include <linux/kernel.h>
+#include <linux/module.h>
+#include <linux/of.h>
+#include <linux/phy/phy.h>
+#include <linux/platform_device.h>
+#include <linux/slab.h>
+
+#include <dt-bindings/phy/phy.h>
+
+/*
+ * Lane Registers
+ */
+
+/* TX De-emphasis parameters */
+#define L0_TX_ANA_TM_18                        0x0048
+#define L0_TX_ANA_TM_118               0x01d8
+#define L0_TX_ANA_TM_118_FORCE_17_0    BIT(0)
+
+/* DN Resistor calibration code parameters */
+#define L0_TXPMA_ST_3                  0x0b0c
+#define L0_DN_CALIB_CODE               0x3f
+
+/* PMA control parameters */
+#define L0_TXPMD_TM_45                 0x0cb4
+#define L0_TXPMD_TM_48                 0x0cc0
+#define L0_TXPMD_TM_45_OVER_DP_MAIN    BIT(0)
+#define L0_TXPMD_TM_45_ENABLE_DP_MAIN  BIT(1)
+#define L0_TXPMD_TM_45_OVER_DP_POST1   BIT(2)
+#define L0_TXPMD_TM_45_ENABLE_DP_POST1 BIT(3)
+#define L0_TXPMD_TM_45_OVER_DP_POST2   BIT(4)
+#define L0_TXPMD_TM_45_ENABLE_DP_POST2 BIT(5)
+
+/* PCS control parameters */
+#define L0_TM_DIG_6                    0x106c
+#define L0_TM_DIS_DESCRAMBLE_DECODER   0x0f
+#define L0_TX_DIG_61                   0x00f4
+#define L0_TM_DISABLE_SCRAMBLE_ENCODER 0x0f
+
+/* PLL Test Mode register parameters */
+#define L0_TM_PLL_DIG_37               0x2094
+#define L0_TM_COARSE_CODE_LIMIT                0x10
+
+/* PLL SSC step size offsets */
+#define L0_PLL_SS_STEPS_0_LSB          0x2368
+#define L0_PLL_SS_STEPS_1_MSB          0x236c
+#define L0_PLL_SS_STEP_SIZE_0_LSB      0x2370
+#define L0_PLL_SS_STEP_SIZE_1          0x2374
+#define L0_PLL_SS_STEP_SIZE_2          0x2378
+#define L0_PLL_SS_STEP_SIZE_3_MSB      0x237c
+#define L0_PLL_STATUS_READ_1           0x23e4
+
+/* SSC step size parameters */
+#define STEP_SIZE_0_MASK               0xff
+#define STEP_SIZE_1_MASK               0xff
+#define STEP_SIZE_2_MASK               0xff
+#define STEP_SIZE_3_MASK               0x3
+#define STEP_SIZE_SHIFT                        8
+#define FORCE_STEP_SIZE                        0x10
+#define FORCE_STEPS                    0x20
+#define STEPS_0_MASK                   0xff
+#define STEPS_1_MASK                   0x07
+
+/* Reference clock selection parameters */
+#define L0_Ln_REF_CLK_SEL(n)           (0x2860 + (n) * 4)
+#define L0_REF_CLK_SEL_MASK            0x8f
+
+/* Calibration digital logic parameters */
+#define L3_TM_CALIB_DIG19              0xec4c
+#define L3_CALIB_DONE_STATUS           0xef14
+#define L3_TM_CALIB_DIG18              0xec48
+#define L3_TM_CALIB_DIG19_NSW          0x07
+#define L3_TM_CALIB_DIG18_NSW          0xe0
+#define L3_TM_OVERRIDE_NSW_CODE         0x20
+#define L3_CALIB_DONE                  0x02
+#define L3_NSW_SHIFT                   5
+#define L3_NSW_PIPE_SHIFT              4
+#define L3_NSW_CALIB_SHIFT             3
+
+#define PHY_REG_OFFSET                 0x4000
+
+/*
+ * Global Registers
+ */
+
+/* Refclk selection parameters */
+#define PLL_REF_SEL(n)                 (0x10000 + (n) * 4)
+#define PLL_FREQ_MASK                  0x1f
+#define PLL_STATUS_LOCKED              0x10
+
+/* Inter Connect Matrix parameters */
+#define ICM_CFG0                       0x10010
+#define ICM_CFG1                       0x10014
+#define ICM_CFG0_L0_MASK               0x07
+#define ICM_CFG0_L1_MASK               0x70
+#define ICM_CFG1_L2_MASK               0x07
+#define ICM_CFG2_L3_MASK               0x70
+#define ICM_CFG_SHIFT                  4
+
+/* Inter Connect Matrix allowed protocols */
+#define ICM_PROTOCOL_PD                        0x0
+#define ICM_PROTOCOL_PCIE              0x1
+#define ICM_PROTOCOL_SATA              0x2
+#define ICM_PROTOCOL_USB               0x3
+#define ICM_PROTOCOL_DP                        0x4
+#define ICM_PROTOCOL_SGMII             0x5
+
+/* Test Mode common reset control  parameters */
+#define TM_CMN_RST                     0x10018
+#define TM_CMN_RST_EN                  0x1
+#define TM_CMN_RST_SET                 0x2
+#define TM_CMN_RST_MASK                        0x3
+
+/* Bus width parameters */
+#define TX_PROT_BUS_WIDTH              0x10040
+#define RX_PROT_BUS_WIDTH              0x10044
+#define PROT_BUS_WIDTH_10              0x0
+#define PROT_BUS_WIDTH_20              0x1
+#define PROT_BUS_WIDTH_40              0x2
+#define PROT_BUS_WIDTH_SHIFT           2
+
+/* Number of GT lanes */
+#define NUM_LANES                      4
+
+/* SIOU SATA control register */
+#define SATA_CONTROL_OFFSET            0x0100
+
+/* Total number of controllers */
+#define CONTROLLERS_PER_LANE           5
+
+/* Protocol Type parameters */
+#define XPSGTR_TYPE_USB0               0  /* USB controller 0 */
+#define XPSGTR_TYPE_USB1               1  /* USB controller 1 */
+#define XPSGTR_TYPE_SATA_0             2  /* SATA controller lane 0 */
+#define XPSGTR_TYPE_SATA_1             3  /* SATA controller lane 1 */
+#define XPSGTR_TYPE_PCIE_0             4  /* PCIe controller lane 0 */
+#define XPSGTR_TYPE_PCIE_1             5  /* PCIe controller lane 1 */
+#define XPSGTR_TYPE_PCIE_2             6  /* PCIe controller lane 2 */
+#define XPSGTR_TYPE_PCIE_3             7  /* PCIe controller lane 3 */
+#define XPSGTR_TYPE_DP_0               8  /* Display Port controller lane 0 */
+#define XPSGTR_TYPE_DP_1               9  /* Display Port controller lane 1 */
+#define XPSGTR_TYPE_SGMII0             10 /* Ethernet SGMII controller 0 */
+#define XPSGTR_TYPE_SGMII1             11 /* Ethernet SGMII controller 1 */
+#define XPSGTR_TYPE_SGMII2             12 /* Ethernet SGMII controller 2 */
+#define XPSGTR_TYPE_SGMII3             13 /* Ethernet SGMII controller 3 */
+
+/* Timeout values */
+#define TIMEOUT_US                     1000
+
+struct xpsgtr_dev;
+
+/**
+ * struct xpsgtr_ssc - structure to hold SSC settings for a lane
+ * @refclk_rate: PLL reference clock frequency
+ * @pll_ref_clk: value to be written to register for corresponding ref clk rate
+ * @steps: number of steps of SSC (Spread Spectrum Clock)
+ * @step_size: step size of each step
+ */
+struct xpsgtr_ssc {
+       u32 refclk_rate;
+       u8  pll_ref_clk;
+       u32 steps;
+       u32 step_size;
+};
+
+/**
+ * struct xpsgtr_phy - representation of a lane
+ * @phy: pointer to the kernel PHY device
+ * @type: controller which uses this lane
+ * @lane: lane number
+ * @protocol: protocol in which the lane operates
+ * @skip_phy_init: skip phy_init() if true
+ * @dev: pointer to the xpsgtr_dev instance
+ * @refclk: reference clock index
+ */
+struct xpsgtr_phy {
+       struct phy *phy;
+       u8 type;
+       u8 lane;
+       u8 protocol;
+       bool skip_phy_init;
+       struct xpsgtr_dev *dev;
+       unsigned int refclk;
+};
+
+/**
+ * struct xpsgtr_dev - representation of a ZynMP GT device
+ * @dev: pointer to device
+ * @serdes: serdes base address
+ * @siou: siou base address
+ * @gtr_mutex: mutex for locking
+ * @phys: PHY lanes
+ * @refclk_sscs: spread spectrum settings for the reference clocks
+ * @tx_term_fix: fix for GT issue
+ * @saved_icm_cfg0: stored value of ICM CFG0 register
+ * @saved_icm_cfg1: stored value of ICM CFG1 register
+ */
+struct xpsgtr_dev {
+       struct device *dev;
+       void __iomem *serdes;
+       void __iomem *siou;
+       struct mutex gtr_mutex; /* mutex for locking */
+       struct xpsgtr_phy phys[NUM_LANES];
+       const struct xpsgtr_ssc *refclk_sscs[NUM_LANES];
+       bool tx_term_fix;
+       unsigned int saved_icm_cfg0;
+       unsigned int saved_icm_cfg1;
+};
+
+/*
+ * Configuration Data
+ */
+
+/* lookup table to hold all settings needed for a ref clock frequency */
+static const struct xpsgtr_ssc ssc_lookup[] = {
+       {  19200000, 0x05,  608, 264020 },
+       {  20000000, 0x06,  634, 243454 },
+       {  24000000, 0x07,  760, 168973 },
+       {  26000000, 0x08,  824, 143860 },
+       {  27000000, 0x09,  856,  86551 },
+       {  38400000, 0x0a, 1218,  65896 },
+       {  40000000, 0x0b,  634, 243454 },
+       {  52000000, 0x0c,  824, 143860 },
+       { 100000000, 0x0d, 1058,  87533 },
+       { 108000000, 0x0e,  856,  86551 },
+       { 125000000, 0x0f,  992, 119497 },
+       { 135000000, 0x10, 1070,  55393 },
+       { 150000000, 0x11,  792, 187091 }
+};
+
+/*
+ * I/O Accessors
+ */
+
+static inline u32 xpsgtr_read(struct xpsgtr_dev *gtr_dev, u32 reg)
+{
+       return readl(gtr_dev->serdes + reg);
+}
+
+static inline void xpsgtr_write(struct xpsgtr_dev *gtr_dev, u32 reg, u32 value)
+{
+       writel(value, gtr_dev->serdes + reg);
+}
+
+static inline void xpsgtr_clr_set(struct xpsgtr_dev *gtr_dev, u32 reg,
+                                 u32 clr, u32 set)
+{
+       u32 value = xpsgtr_read(gtr_dev, reg);
+
+       value &= ~clr;
+       value |= set;
+       xpsgtr_write(gtr_dev, reg, value);
+}
+
+static inline u32 xpsgtr_read_phy(struct xpsgtr_phy *gtr_phy, u32 reg)
+{
+       void __iomem *addr = gtr_phy->dev->serdes
+                          + gtr_phy->lane * PHY_REG_OFFSET + reg;
+
+       return readl(addr);
+}
+
+static inline void xpsgtr_write_phy(struct xpsgtr_phy *gtr_phy,
+                                   u32 reg, u32 value)
+{
+       void __iomem *addr = gtr_phy->dev->serdes
+                          + gtr_phy->lane * PHY_REG_OFFSET + reg;
+
+       writel(value, addr);
+}
+
+static inline void xpsgtr_clr_set_phy(struct xpsgtr_phy *gtr_phy,
+                                     u32 reg, u32 clr, u32 set)
+{
+       void __iomem *addr = gtr_phy->dev->serdes
+                          + gtr_phy->lane * PHY_REG_OFFSET + reg;
+
+       writel((readl(addr) & ~clr) | set, addr);
+}
+
+/*
+ * Hardware Configuration
+ */
+
+/* Wait for the PLL to lock (with a timeout). */
+static int xpsgtr_wait_pll_lock(struct phy *phy)
+{
+       struct xpsgtr_phy *gtr_phy = phy_get_drvdata(phy);
+       struct xpsgtr_dev *gtr_dev = gtr_phy->dev;
+       unsigned int timeout = TIMEOUT_US;
+       int ret;
+
+       dev_dbg(gtr_dev->dev, "Waiting for PLL lock\n");
+
+       while (1) {
+               u32 reg = xpsgtr_read_phy(gtr_phy, L0_PLL_STATUS_READ_1);
+
+               if ((reg & PLL_STATUS_LOCKED) == PLL_STATUS_LOCKED) {
+                       ret = 0;
+                       break;
+               }
+
+               if (--timeout == 0) {
+                       ret = -ETIMEDOUT;
+                       break;
+               }
+
+               udelay(1);
+       }
+
+       if (ret == -ETIMEDOUT)
+               dev_err(gtr_dev->dev,
+                       "lane %u (type %u, protocol %u): PLL lock timeout\n",
+                       gtr_phy->lane, gtr_phy->type, gtr_phy->protocol);
+
+       return ret;
+}
+
+/* Configure PLL and spread-sprectrum clock. */
+static void xpsgtr_configure_pll(struct xpsgtr_phy *gtr_phy)
+{
+       const struct xpsgtr_ssc *ssc;
+       u32 step_size;
+
+       ssc = gtr_phy->dev->refclk_sscs[gtr_phy->refclk];
+       step_size = ssc->step_size;
+
+       xpsgtr_clr_set(gtr_phy->dev, PLL_REF_SEL(gtr_phy->lane),
+                      PLL_FREQ_MASK, ssc->pll_ref_clk);
+
+       /* Enable lane clock sharing, if required */
+       if (gtr_phy->refclk != gtr_phy->lane) {
+               /* Lane3 Ref Clock Selection Register */
+               xpsgtr_clr_set(gtr_phy->dev, L0_Ln_REF_CLK_SEL(gtr_phy->lane),
+                              L0_REF_CLK_SEL_MASK, 1 << gtr_phy->refclk);
+       }
+
+       /* SSC step size [7:0] */
+       xpsgtr_clr_set_phy(gtr_phy, L0_PLL_SS_STEP_SIZE_0_LSB,
+                          STEP_SIZE_0_MASK, step_size & STEP_SIZE_0_MASK);
+
+       /* SSC step size [15:8] */
+       step_size >>= STEP_SIZE_SHIFT;
+       xpsgtr_clr_set_phy(gtr_phy, L0_PLL_SS_STEP_SIZE_1,
+                          STEP_SIZE_1_MASK, step_size & STEP_SIZE_1_MASK);
+
+       /* SSC step size [23:16] */
+       step_size >>= STEP_SIZE_SHIFT;
+       xpsgtr_clr_set_phy(gtr_phy, L0_PLL_SS_STEP_SIZE_2,
+                          STEP_SIZE_2_MASK, step_size & STEP_SIZE_2_MASK);
+
+       /* SSC steps [7:0] */
+       xpsgtr_clr_set_phy(gtr_phy, L0_PLL_SS_STEPS_0_LSB,
+                          STEPS_0_MASK, ssc->steps & STEPS_0_MASK);
+
+       /* SSC steps [10:8] */
+       xpsgtr_clr_set_phy(gtr_phy, L0_PLL_SS_STEPS_1_MSB,
+                          STEPS_1_MASK,
+                          (ssc->steps >> STEP_SIZE_SHIFT) & STEPS_1_MASK);
+
+       /* SSC step size [24:25] */
+       step_size >>= STEP_SIZE_SHIFT;
+       xpsgtr_clr_set_phy(gtr_phy, L0_PLL_SS_STEP_SIZE_3_MSB,
+                          STEP_SIZE_3_MASK, (step_size & STEP_SIZE_3_MASK) |
+                          FORCE_STEP_SIZE | FORCE_STEPS);
+}
+
+/* Configure the lane protocol. */
+static void xpsgtr_lane_set_protocol(struct xpsgtr_phy *gtr_phy)
+{
+       struct xpsgtr_dev *gtr_dev = gtr_phy->dev;
+       u8 protocol = gtr_phy->protocol;
+
+       switch (gtr_phy->lane) {
+       case 0:
+               xpsgtr_clr_set(gtr_dev, ICM_CFG0, ICM_CFG0_L0_MASK, protocol);
+               break;
+       case 1:
+               xpsgtr_clr_set(gtr_dev, ICM_CFG0, ICM_CFG0_L1_MASK,
+                              protocol << ICM_CFG_SHIFT);
+               break;
+       case 2:
+               xpsgtr_clr_set(gtr_dev, ICM_CFG1, ICM_CFG0_L0_MASK, protocol);
+               break;
+       case 3:
+               xpsgtr_clr_set(gtr_dev, ICM_CFG1, ICM_CFG0_L1_MASK,
+                              protocol << ICM_CFG_SHIFT);
+               break;
+       default:
+               /* We already checked 0 <= lane <= 3 */
+               break;
+       }
+}
+
+/* Bypass (de)scrambler and 8b/10b decoder and encoder. */
+static void xpsgtr_bypass_scrambler_8b10b(struct xpsgtr_phy *gtr_phy)
+{
+       xpsgtr_write_phy(gtr_phy, L0_TM_DIG_6, L0_TM_DIS_DESCRAMBLE_DECODER);
+       xpsgtr_write_phy(gtr_phy, L0_TX_DIG_61, L0_TM_DISABLE_SCRAMBLE_ENCODER);
+}
+
+/* DP-specific initialization. */
+static void xpsgtr_phy_init_dp(struct xpsgtr_phy *gtr_phy)
+{
+       xpsgtr_write_phy(gtr_phy, L0_TXPMD_TM_45,
+                        L0_TXPMD_TM_45_OVER_DP_MAIN |
+                        L0_TXPMD_TM_45_ENABLE_DP_MAIN |
+                        L0_TXPMD_TM_45_OVER_DP_POST1 |
+                        L0_TXPMD_TM_45_OVER_DP_POST2 |
+                        L0_TXPMD_TM_45_ENABLE_DP_POST2);
+       xpsgtr_write_phy(gtr_phy, L0_TX_ANA_TM_118,
+                        L0_TX_ANA_TM_118_FORCE_17_0);
+}
+
+/* SATA-specific initialization. */
+static void xpsgtr_phy_init_sata(struct xpsgtr_phy *gtr_phy)
+{
+       struct xpsgtr_dev *gtr_dev = gtr_phy->dev;
+
+       xpsgtr_bypass_scrambler_8b10b(gtr_phy);
+
+       writel(gtr_phy->lane, gtr_dev->siou + SATA_CONTROL_OFFSET);
+}
+
+/* SGMII-specific initialization. */
+static void xpsgtr_phy_init_sgmii(struct xpsgtr_phy *gtr_phy)
+{
+       struct xpsgtr_dev *gtr_dev = gtr_phy->dev;
+
+       /* Set SGMII protocol TX and RX bus width to 10 bits. */
+       xpsgtr_write(gtr_dev, TX_PROT_BUS_WIDTH,
+                    PROT_BUS_WIDTH_10 << (gtr_phy->lane * PROT_BUS_WIDTH_SHIFT));
+       xpsgtr_write(gtr_dev, RX_PROT_BUS_WIDTH,
+                    PROT_BUS_WIDTH_10 << (gtr_phy->lane * PROT_BUS_WIDTH_SHIFT));
+
+       xpsgtr_bypass_scrambler_8b10b(gtr_phy);
+}
+
+/* Configure TX de-emphasis and margining for DP. */
+static void xpsgtr_phy_configure_dp(struct xpsgtr_phy *gtr_phy, unsigned int pre,
+                                   unsigned int voltage)
+{
+       static const u8 voltage_swing[4][4] = {
+               { 0x2a, 0x27, 0x24, 0x20 },
+               { 0x27, 0x23, 0x20, 0xff },
+               { 0x24, 0x20, 0xff, 0xff },
+               { 0xff, 0xff, 0xff, 0xff }
+       };
+       static const u8 pre_emphasis[4][4] = {
+               { 0x02, 0x02, 0x02, 0x02 },
+               { 0x01, 0x01, 0x01, 0xff },
+               { 0x00, 0x00, 0xff, 0xff },
+               { 0xff, 0xff, 0xff, 0xff }
+       };
+
+       xpsgtr_write_phy(gtr_phy, L0_TXPMD_TM_48, voltage_swing[pre][voltage]);
+       xpsgtr_write_phy(gtr_phy, L0_TX_ANA_TM_18, pre_emphasis[pre][voltage]);
+}
+
+/*
+ * PHY Operations
+ */
+
+static bool xpsgtr_phy_init_required(struct xpsgtr_phy *gtr_phy)
+{
+       /*
+        * As USB may save the snapshot of the states during hibernation, doing
+        * phy_init() will put the USB controller into reset, resulting in the
+        * losing of the saved snapshot. So try to avoid phy_init() for USB
+        * except when gtr_phy->skip_phy_init is false (this happens when FPD is
+        * shutdown during suspend or when gt lane is changed from current one)
+        */
+       if (gtr_phy->protocol == ICM_PROTOCOL_USB && gtr_phy->skip_phy_init)
+               return false;
+       else
+               return true;
+}
+
+/*
+ * There is a functional issue in the GT. The TX termination resistance can be
+ * out of spec due to a issue in the calibration logic. This is the workaround
+ * to fix it, required for XCZU9EG silicon.
+ */
+static int xpsgtr_phy_tx_term_fix(struct xpsgtr_phy *gtr_phy)
+{
+       struct xpsgtr_dev *gtr_dev = gtr_phy->dev;
+       u32 timeout = TIMEOUT_US;
+       u32 nsw;
+
+       /* Enabling Test Mode control for CMN Rest */
+       xpsgtr_clr_set(gtr_dev, TM_CMN_RST, TM_CMN_RST_MASK, TM_CMN_RST_SET);
+
+       /* Set Test Mode reset */
+       xpsgtr_clr_set(gtr_dev, TM_CMN_RST, TM_CMN_RST_MASK, TM_CMN_RST_EN);
+
+       xpsgtr_write(gtr_dev, L3_TM_CALIB_DIG18, 0x00);
+       xpsgtr_write(gtr_dev, L3_TM_CALIB_DIG19, L3_TM_OVERRIDE_NSW_CODE);
+
+       /*
+        * As a part of work around sequence for PMOS calibration fix,
+        * we need to configure any lane ICM_CFG to valid protocol. This
+        * will deassert the CMN_Resetn signal.
+        */
+       xpsgtr_lane_set_protocol(gtr_phy);
+
+       /* Clear Test Mode reset */
+       xpsgtr_clr_set(gtr_dev, TM_CMN_RST, TM_CMN_RST_MASK, TM_CMN_RST_SET);
+
+       dev_dbg(gtr_dev->dev, "calibrating...\n");
+
+       do {
+               u32 reg = xpsgtr_read(gtr_dev, L3_CALIB_DONE_STATUS);
+
+               if ((reg & L3_CALIB_DONE) == L3_CALIB_DONE)
+                       break;
+
+               if (!--timeout) {
+                       dev_err(gtr_dev->dev, "calibration time out\n");
+                       return -ETIMEDOUT;
+               }
+
+               udelay(1);
+       } while (timeout > 0);
+
+       dev_dbg(gtr_dev->dev, "calibration done\n");
+
+       /* Reading NMOS Register Code */
+       nsw = xpsgtr_read(gtr_dev, L0_TXPMA_ST_3) & L0_DN_CALIB_CODE;
+
+       /* Set Test Mode reset */
+       xpsgtr_clr_set(gtr_dev, TM_CMN_RST, TM_CMN_RST_MASK, TM_CMN_RST_EN);
+
+       /* Writing NMOS register values back [5:3] */
+       xpsgtr_write(gtr_dev, L3_TM_CALIB_DIG19, nsw >> L3_NSW_CALIB_SHIFT);
+
+       /* Writing NMOS register value [2:0] */
+       xpsgtr_write(gtr_dev, L3_TM_CALIB_DIG18,
+                    ((nsw & L3_TM_CALIB_DIG19_NSW) << L3_NSW_SHIFT) |
+                    (1 << L3_NSW_PIPE_SHIFT));
+
+       /* Clear Test Mode reset */
+       xpsgtr_clr_set(gtr_dev, TM_CMN_RST, TM_CMN_RST_MASK, TM_CMN_RST_SET);
+
+       return 0;
+}
+
+static int xpsgtr_phy_init(struct phy *phy)
+{
+       struct xpsgtr_phy *gtr_phy = phy_get_drvdata(phy);
+       struct xpsgtr_dev *gtr_dev = gtr_phy->dev;
+       int ret = 0;
+
+       mutex_lock(>r_dev->gtr_mutex);
+
+       /* Skip initialization if not required. */
+       if (!xpsgtr_phy_init_required(gtr_phy))
+               goto out;
+
+       if (gtr_dev->tx_term_fix) {
+               ret = xpsgtr_phy_tx_term_fix(gtr_phy);
+               if (ret < 0)
+                       goto out;
+
+               gtr_dev->tx_term_fix = false;
+       }
+
+       /* Enable coarse code saturation limiting logic. */
+       xpsgtr_write_phy(gtr_phy, L0_TM_PLL_DIG_37, L0_TM_COARSE_CODE_LIMIT);
+
+       /*
+        * Configure the PLL, the lane protocol, and perform protocol-specific
+        * initialization.
+        */
+       xpsgtr_configure_pll(gtr_phy);
+       xpsgtr_lane_set_protocol(gtr_phy);
+
+       switch (gtr_phy->protocol) {
+       case ICM_PROTOCOL_DP:
+               xpsgtr_phy_init_dp(gtr_phy);
+               break;
+
+       case ICM_PROTOCOL_SATA:
+               xpsgtr_phy_init_sata(gtr_phy);
+               break;
+
+       case ICM_PROTOCOL_SGMII:
+               xpsgtr_phy_init_sgmii(gtr_phy);
+               break;
+       }
+
+out:
+       mutex_unlock(>r_dev->gtr_mutex);
+       return ret;
+}
+
+static int xpsgtr_phy_exit(struct phy *phy)
+{
+       struct xpsgtr_phy *gtr_phy = phy_get_drvdata(phy);
+
+       gtr_phy->skip_phy_init = false;
+
+       return 0;
+}
+
+static int xpsgtr_phy_power_on(struct phy *phy)
+{
+       struct xpsgtr_phy *gtr_phy = phy_get_drvdata(phy);
+       int ret = 0;
+
+       /*
+        * Wait for the PLL to lock. For DP, only wait on DP0 to avoid
+        * cumulating waits for both lanes. The user is expected to initialize
+        * lane 0 last.
+        */
+       if (gtr_phy->protocol != ICM_PROTOCOL_DP ||
+           gtr_phy->type == XPSGTR_TYPE_DP_0)
+               ret = xpsgtr_wait_pll_lock(phy);
+
+       return ret;
+}
+
+static int xpsgtr_phy_configure(struct phy *phy, union phy_configure_opts *opts)
+{
+       struct xpsgtr_phy *gtr_phy = phy_get_drvdata(phy);
+
+       if (gtr_phy->protocol != ICM_PROTOCOL_DP)
+               return 0;
+
+       xpsgtr_phy_configure_dp(gtr_phy, opts->dp.pre[0], opts->dp.voltage[0]);
+
+       return 0;
+}
+
+static const struct phy_ops xpsgtr_phyops = {
+       .init           = xpsgtr_phy_init,
+       .exit           = xpsgtr_phy_exit,
+       .power_on       = xpsgtr_phy_power_on,
+       .configure      = xpsgtr_phy_configure,
+       .owner          = THIS_MODULE,
+};
+
+/*
+ * OF Xlate Support
+ */
+
+/* Set the lane type and protocol based on the PHY type and instance number. */
+static int xpsgtr_set_lane_type(struct xpsgtr_phy *gtr_phy, u8 phy_type,
+                               unsigned int phy_instance)
+{
+       unsigned int num_phy_types;
+       const int *phy_types;
+
+       switch (phy_type) {
+       case PHY_TYPE_SATA: {
+               static const int types[] = {
+                       XPSGTR_TYPE_SATA_0,
+                       XPSGTR_TYPE_SATA_1,
+               };
+
+               phy_types = types;
+               num_phy_types = ARRAY_SIZE(types);
+               gtr_phy->protocol = ICM_PROTOCOL_SATA;
+               break;
+       }
+       case PHY_TYPE_USB3: {
+               static const int types[] = {
+                       XPSGTR_TYPE_USB0,
+                       XPSGTR_TYPE_USB1,
+               };
+
+               phy_types = types;
+               num_phy_types = ARRAY_SIZE(types);
+               gtr_phy->protocol = ICM_PROTOCOL_USB;
+               break;
+       }
+       case PHY_TYPE_DP: {
+               static const int types[] = {
+                       XPSGTR_TYPE_DP_0,
+                       XPSGTR_TYPE_DP_1,
+               };
+
+               phy_types = types;
+               num_phy_types = ARRAY_SIZE(types);
+               gtr_phy->protocol = ICM_PROTOCOL_DP;
+               break;
+       }
+       case PHY_TYPE_PCIE: {
+               static const int types[] = {
+                       XPSGTR_TYPE_PCIE_0,
+                       XPSGTR_TYPE_PCIE_1,
+                       XPSGTR_TYPE_PCIE_2,
+                       XPSGTR_TYPE_PCIE_3,
+               };
+
+               phy_types = types;
+               num_phy_types = ARRAY_SIZE(types);
+               gtr_phy->protocol = ICM_PROTOCOL_PCIE;
+               break;
+       }
+       case PHY_TYPE_SGMII: {
+               static const int types[] = {
+                       XPSGTR_TYPE_SGMII0,
+                       XPSGTR_TYPE_SGMII1,
+                       XPSGTR_TYPE_SGMII2,
+                       XPSGTR_TYPE_SGMII3,
+               };
+
+               phy_types = types;
+               num_phy_types = ARRAY_SIZE(types);
+               gtr_phy->protocol = ICM_PROTOCOL_SGMII;
+               break;
+       }
+       default:
+               return -EINVAL;
+       }
+
+       if (phy_instance >= num_phy_types)
+               return -EINVAL;
+
+       gtr_phy->type = phy_types[phy_instance];
+       return 0;
+}
+
+/*
+ * Valid combinations of controllers and lanes (Interconnect Matrix).
+ */
+static const unsigned int icm_matrix[NUM_LANES][CONTROLLERS_PER_LANE] = {
+       { XPSGTR_TYPE_PCIE_0, XPSGTR_TYPE_SATA_0, XPSGTR_TYPE_USB0,
+               XPSGTR_TYPE_DP_1, XPSGTR_TYPE_SGMII0 },
+       { XPSGTR_TYPE_PCIE_1, XPSGTR_TYPE_SATA_1, XPSGTR_TYPE_USB0,
+               XPSGTR_TYPE_DP_0, XPSGTR_TYPE_SGMII1 },
+       { XPSGTR_TYPE_PCIE_2, XPSGTR_TYPE_SATA_0, XPSGTR_TYPE_USB0,
+               XPSGTR_TYPE_DP_1, XPSGTR_TYPE_SGMII2 },
+       { XPSGTR_TYPE_PCIE_3, XPSGTR_TYPE_SATA_1, XPSGTR_TYPE_USB1,
+               XPSGTR_TYPE_DP_0, XPSGTR_TYPE_SGMII3 }
+};
+
+/* Translate OF phandle and args to PHY instance. */
+static struct phy *xpsgtr_xlate(struct device *dev,
+                               struct of_phandle_args *args)
+{
+       struct xpsgtr_dev *gtr_dev = dev_get_drvdata(dev);
+       struct xpsgtr_phy *gtr_phy;
+       unsigned int phy_instance;
+       unsigned int phy_lane;
+       unsigned int phy_type;
+       unsigned int refclk;
+       unsigned int i;
+       int ret;
+
+       if (args->args_count != 4) {
+               dev_err(dev, "Invalid number of cells in 'phy' property\n");
+               return ERR_PTR(-EINVAL);
+       }
+
+       /*
+        * Get the PHY parameters from the OF arguments and derive the lane
+        * type.
+        */
+       phy_lane = args->args[0];
+       if (phy_lane >= ARRAY_SIZE(gtr_dev->phys)) {
+               dev_err(dev, "Invalid lane number %u\n", phy_lane);
+               return ERR_PTR(-ENODEV);
+       }
+
+       gtr_phy = >r_dev->phys[phy_lane];
+       phy_type = args->args[1];
+       phy_instance = args->args[2];
+
+       ret = xpsgtr_set_lane_type(gtr_phy, phy_type, phy_instance);
+       if (ret < 0) {
+               dev_err(gtr_dev->dev, "Invalid PHY type and/or instance\n");
+               return ERR_PTR(ret);
+       }
+
+       refclk = args->args[3];
+       if (refclk >= ARRAY_SIZE(gtr_dev->refclk_sscs) ||
+           !gtr_dev->refclk_sscs[refclk]) {
+               dev_err(dev, "Invalid reference clock number %u\n", refclk);
+               return ERR_PTR(-EINVAL);
+       }
+
+       gtr_phy->refclk = refclk;
+
+       /*
+        * Ensure that the Interconnect Matrix is obeyed, i.e a given lane type
+        * is allowed to operate on the lane.
+        */
+       for (i = 0; i < CONTROLLERS_PER_LANE; i++) {
+               if (icm_matrix[phy_lane][i] == gtr_phy->type)
+                       return gtr_phy->phy;
+       }
+
+       return ERR_PTR(-EINVAL);
+}
+
+/*
+ * Power Management
+ */
+
+#ifdef CONFIG_PM
+static int xpsgtr_suspend(struct device *dev)
+{
+       struct xpsgtr_dev *gtr_dev = dev_get_drvdata(dev);
+
+       /* Save the snapshot ICM_CFG registers. */
+       gtr_dev->saved_icm_cfg0 = xpsgtr_read(gtr_dev, ICM_CFG0);
+       gtr_dev->saved_icm_cfg1 = xpsgtr_read(gtr_dev, ICM_CFG1);
+
+       return 0;
+}
+
+static int xpsgtr_resume(struct device *dev)
+{
+       struct xpsgtr_dev *gtr_dev = dev_get_drvdata(dev);
+       unsigned int icm_cfg0, icm_cfg1;
+       unsigned int i;
+       bool skip_phy_init;
+
+       icm_cfg0 = xpsgtr_read(gtr_dev, ICM_CFG0);
+       icm_cfg1 = xpsgtr_read(gtr_dev, ICM_CFG1);
+
+       /* Return if no GT lanes got configured before suspend. */
+       if (!gtr_dev->saved_icm_cfg0 && !gtr_dev->saved_icm_cfg1)
+               return 0;
+
+       /* Check if the ICM configurations changed after suspend. */
+       if (icm_cfg0 == gtr_dev->saved_icm_cfg0 &&
+           icm_cfg1 == gtr_dev->saved_icm_cfg1)
+               skip_phy_init = true;
+       else
+               skip_phy_init = false;
+
+       /* Update the skip_phy_init for all gtr_phy instances. */
+       for (i = 0; i < ARRAY_SIZE(gtr_dev->phys); i++)
+               gtr_dev->phys[i].skip_phy_init = skip_phy_init;
+
+       return 0;
+}
+#endif /* CONFIG_PM */
+
+static const struct dev_pm_ops xpsgtr_pm_ops = {
+       SET_SYSTEM_SLEEP_PM_OPS(xpsgtr_suspend, xpsgtr_resume)
+};
+
+/*
+ * Probe & Platform Driver
+ */
+
+static int xpsgtr_get_ref_clocks(struct xpsgtr_dev *gtr_dev)
+{
+       unsigned int refclk;
+
+       for (refclk = 0; refclk < ARRAY_SIZE(gtr_dev->refclk_sscs); ++refclk) {
+               unsigned long rate;
+               unsigned int i;
+               struct clk *clk;
+               char name[8];
+
+               snprintf(name, sizeof(name), "ref%u", refclk);
+               clk = devm_clk_get_optional(gtr_dev->dev, name);
+               if (IS_ERR(clk)) {
+                       if (PTR_ERR(clk) != -EPROBE_DEFER)
+                               dev_err(gtr_dev->dev,
+                                       "Failed to get reference clock %u: %ld\n",
+                                       refclk, PTR_ERR(clk));
+                       return PTR_ERR(clk);
+               }
+
+               if (!clk)
+                       continue;
+
+               /*
+                * Get the spread spectrum (SSC) settings for the reference
+                * clock rate.
+                */
+               rate = clk_get_rate(clk);
+
+               for (i = 0 ; i < ARRAY_SIZE(ssc_lookup); i++) {
+                       if (rate == ssc_lookup[i].refclk_rate) {
+                               gtr_dev->refclk_sscs[refclk] = &ssc_lookup[i];
+                               break;
+                       }
+               }
+
+               if (i == ARRAY_SIZE(ssc_lookup)) {
+                       dev_err(gtr_dev->dev,
+                               "Invalid rate %lu for reference clock %u\n",
+                               rate, refclk);
+                       return -EINVAL;
+               }
+       }
+
+       return 0;
+}
+
+static int xpsgtr_probe(struct platform_device *pdev)
+{
+       struct device_node *np = pdev->dev.of_node;
+       struct xpsgtr_dev *gtr_dev;
+       struct phy_provider *provider;
+       unsigned int port;
+       int ret;
+
+       gtr_dev = devm_kzalloc(&pdev->dev, sizeof(*gtr_dev), GFP_KERNEL);
+       if (!gtr_dev)
+               return -ENOMEM;
+
+       gtr_dev->dev = &pdev->dev;
+       platform_set_drvdata(pdev, gtr_dev);
+
+       mutex_init(>r_dev->gtr_mutex);
+
+       if (of_device_is_compatible(np, "xlnx,zynqmp-psgtr"))
+               gtr_dev->tx_term_fix =
+                       of_property_read_bool(np, "xlnx,tx-termination-fix");
+
+       /* Acquire resources. */
+       gtr_dev->serdes = devm_platform_ioremap_resource_byname(pdev, "serdes");
+       if (IS_ERR(gtr_dev->serdes))
+               return PTR_ERR(gtr_dev->serdes);
+
+       gtr_dev->siou = devm_platform_ioremap_resource_byname(pdev, "siou");
+       if (IS_ERR(gtr_dev->siou))
+               return PTR_ERR(gtr_dev->siou);
+
+       ret = xpsgtr_get_ref_clocks(gtr_dev);
+       if (ret)
+               return ret;
+
+       /* Create PHYs. */
+       for (port = 0; port < ARRAY_SIZE(gtr_dev->phys); ++port) {
+               struct xpsgtr_phy *gtr_phy = >r_dev->phys[port];
+               struct phy *phy;
+
+               gtr_phy->lane = port;
+               gtr_phy->dev = gtr_dev;
+
+               phy = devm_phy_create(&pdev->dev, np, &xpsgtr_phyops);
+               if (IS_ERR(phy)) {
+                       dev_err(&pdev->dev, "failed to create PHY\n");
+                       return PTR_ERR(phy);
+               }
+
+               gtr_phy->phy = phy;
+               phy_set_drvdata(phy, gtr_phy);
+       }
+
+       /* Register the PHY provider. */
+       provider = devm_of_phy_provider_register(&pdev->dev, xpsgtr_xlate);
+       if (IS_ERR(provider)) {
+               dev_err(&pdev->dev, "registering provider failed\n");
+               return PTR_ERR(provider);
+       }
+       return 0;
+}
+
+static const struct of_device_id xpsgtr_of_match[] = {
+       { .compatible = "xlnx,zynqmp-psgtr", },
+       { .compatible = "xlnx,zynqmp-psgtr-v1.1", },
+       {},
+};
+MODULE_DEVICE_TABLE(of, xpsgtr_of_match);
+
+static struct platform_driver xpsgtr_driver = {
+       .probe = xpsgtr_probe,
+       .driver = {
+               .name = "xilinx-psgtr",
+               .of_match_table = xpsgtr_of_match,
+               .pm =  &xpsgtr_pm_ops,
+       },
+};
+
+module_platform_driver(xpsgtr_driver);
+
+MODULE_AUTHOR("Xilinx Inc.");
+MODULE_LICENSE("GPL v2");
+MODULE_DESCRIPTION("Xilinx ZynqMP High speed Gigabit Transceiver");