mirror of
https://github.com/torvalds/linux.git
synced 2024-12-08 03:52:16 +00:00
31c66bfa95
Fix the format and add description for ops to fix the below warnings: drivers/phy/marvell/phy-mvebu-cp110-utmi.c:94: warning: Function parameter or member 'syscon' not described in 'mvebu_cp110_utmi' drivers/phy/marvell/phy-mvebu-cp110-utmi.c:94: warning: Function parameter or member 'ops' not described in 'mvebu_cp110_utmi' Signed-off-by: Vinod Koul <vkoul@kernel.org> Link: https://lore.kernel.org/r/20211116103951.34482-1-vkoul@kernel.org Signed-off-by: Vinod Koul <vkoul@kernel.org>
385 lines
11 KiB
C
385 lines
11 KiB
C
// SPDX-License-Identifier: GPL-2.0
|
|
/*
|
|
* Copyright (C) 2021 Marvell
|
|
*
|
|
* Authors:
|
|
* Konstantin Porotchkin <kostap@marvell.com>
|
|
*
|
|
* Marvell CP110 UTMI PHY driver
|
|
*/
|
|
|
|
#include <linux/io.h>
|
|
#include <linux/iopoll.h>
|
|
#include <linux/mfd/syscon.h>
|
|
#include <linux/module.h>
|
|
#include <linux/of_device.h>
|
|
#include <linux/phy/phy.h>
|
|
#include <linux/platform_device.h>
|
|
#include <linux/regmap.h>
|
|
#include <linux/usb/of.h>
|
|
#include <linux/usb/otg.h>
|
|
|
|
#define UTMI_PHY_PORTS 2
|
|
|
|
/* CP110 UTMI register macro definetions */
|
|
#define SYSCON_USB_CFG_REG 0x420
|
|
#define USB_CFG_DEVICE_EN_MASK BIT(0)
|
|
#define USB_CFG_DEVICE_MUX_OFFSET 1
|
|
#define USB_CFG_DEVICE_MUX_MASK BIT(1)
|
|
#define USB_CFG_PLL_MASK BIT(25)
|
|
|
|
#define SYSCON_UTMI_CFG_REG(id) (0x440 + (id) * 4)
|
|
#define UTMI_PHY_CFG_PU_MASK BIT(5)
|
|
|
|
#define UTMI_PLL_CTRL_REG 0x0
|
|
#define PLL_REFDIV_OFFSET 0
|
|
#define PLL_REFDIV_MASK GENMASK(6, 0)
|
|
#define PLL_REFDIV_VAL 0x5
|
|
#define PLL_FBDIV_OFFSET 16
|
|
#define PLL_FBDIV_MASK GENMASK(24, 16)
|
|
#define PLL_FBDIV_VAL 0x60
|
|
#define PLL_SEL_LPFR_MASK GENMASK(29, 28)
|
|
#define PLL_RDY BIT(31)
|
|
#define UTMI_CAL_CTRL_REG 0x8
|
|
#define IMPCAL_VTH_OFFSET 8
|
|
#define IMPCAL_VTH_MASK GENMASK(10, 8)
|
|
#define IMPCAL_VTH_VAL 0x7
|
|
#define IMPCAL_DONE BIT(23)
|
|
#define PLLCAL_DONE BIT(31)
|
|
#define UTMI_TX_CH_CTRL_REG 0xC
|
|
#define DRV_EN_LS_OFFSET 12
|
|
#define DRV_EN_LS_MASK GENMASK(15, 12)
|
|
#define IMP_SEL_LS_OFFSET 16
|
|
#define IMP_SEL_LS_MASK GENMASK(19, 16)
|
|
#define TX_AMP_OFFSET 20
|
|
#define TX_AMP_MASK GENMASK(22, 20)
|
|
#define TX_AMP_VAL 0x4
|
|
#define UTMI_RX_CH_CTRL0_REG 0x14
|
|
#define SQ_DET_EN BIT(15)
|
|
#define SQ_ANA_DTC_SEL BIT(28)
|
|
#define UTMI_RX_CH_CTRL1_REG 0x18
|
|
#define SQ_AMP_CAL_OFFSET 0
|
|
#define SQ_AMP_CAL_MASK GENMASK(2, 0)
|
|
#define SQ_AMP_CAL_VAL 1
|
|
#define SQ_AMP_CAL_EN BIT(3)
|
|
#define UTMI_CTRL_STATUS0_REG 0x24
|
|
#define SUSPENDM BIT(22)
|
|
#define TEST_SEL BIT(25)
|
|
#define UTMI_CHGDTC_CTRL_REG 0x38
|
|
#define VDAT_OFFSET 8
|
|
#define VDAT_MASK GENMASK(9, 8)
|
|
#define VDAT_VAL 1
|
|
#define VSRC_OFFSET 10
|
|
#define VSRC_MASK GENMASK(11, 10)
|
|
#define VSRC_VAL 1
|
|
|
|
#define PLL_LOCK_DELAY_US 10000
|
|
#define PLL_LOCK_TIMEOUT_US 1000000
|
|
|
|
#define PORT_REGS(p) ((p)->priv->regs + (p)->id * 0x1000)
|
|
|
|
/**
|
|
* struct mvebu_cp110_utmi - PHY driver data
|
|
*
|
|
* @regs: PHY registers
|
|
* @syscon: Regmap with system controller registers
|
|
* @dev: device driver handle
|
|
* @ops: phy ops
|
|
*/
|
|
struct mvebu_cp110_utmi {
|
|
void __iomem *regs;
|
|
struct regmap *syscon;
|
|
struct device *dev;
|
|
const struct phy_ops *ops;
|
|
};
|
|
|
|
/**
|
|
* struct mvebu_cp110_utmi_port - PHY port data
|
|
*
|
|
* @priv: PHY driver data
|
|
* @id: PHY port ID
|
|
* @dr_mode: PHY connection: USB_DR_MODE_HOST or USB_DR_MODE_PERIPHERAL
|
|
*/
|
|
struct mvebu_cp110_utmi_port {
|
|
struct mvebu_cp110_utmi *priv;
|
|
u32 id;
|
|
enum usb_dr_mode dr_mode;
|
|
};
|
|
|
|
static void mvebu_cp110_utmi_port_setup(struct mvebu_cp110_utmi_port *port)
|
|
{
|
|
u32 reg;
|
|
|
|
/*
|
|
* Setup PLL.
|
|
* The reference clock is the frequency of quartz resonator
|
|
* connected to pins REFCLK_XIN and REFCLK_XOUT of the SoC.
|
|
* Register init values are matching the 40MHz default clock.
|
|
* The crystal used for all platform boards is now 25MHz.
|
|
* See the functional specification for details.
|
|
*/
|
|
reg = readl(PORT_REGS(port) + UTMI_PLL_CTRL_REG);
|
|
reg &= ~(PLL_REFDIV_MASK | PLL_FBDIV_MASK | PLL_SEL_LPFR_MASK);
|
|
reg |= (PLL_REFDIV_VAL << PLL_REFDIV_OFFSET) |
|
|
(PLL_FBDIV_VAL << PLL_FBDIV_OFFSET);
|
|
writel(reg, PORT_REGS(port) + UTMI_PLL_CTRL_REG);
|
|
|
|
/* Impedance Calibration Threshold Setting */
|
|
reg = readl(PORT_REGS(port) + UTMI_CAL_CTRL_REG);
|
|
reg &= ~IMPCAL_VTH_MASK;
|
|
reg |= IMPCAL_VTH_VAL << IMPCAL_VTH_OFFSET;
|
|
writel(reg, PORT_REGS(port) + UTMI_CAL_CTRL_REG);
|
|
|
|
/* Set LS TX driver strength coarse control */
|
|
reg = readl(PORT_REGS(port) + UTMI_TX_CH_CTRL_REG);
|
|
reg &= ~TX_AMP_MASK;
|
|
reg |= TX_AMP_VAL << TX_AMP_OFFSET;
|
|
writel(reg, PORT_REGS(port) + UTMI_TX_CH_CTRL_REG);
|
|
|
|
/* Disable SQ and enable analog squelch detect */
|
|
reg = readl(PORT_REGS(port) + UTMI_RX_CH_CTRL0_REG);
|
|
reg &= ~SQ_DET_EN;
|
|
reg |= SQ_ANA_DTC_SEL;
|
|
writel(reg, PORT_REGS(port) + UTMI_RX_CH_CTRL0_REG);
|
|
|
|
/*
|
|
* Set External squelch calibration number and
|
|
* enable the External squelch calibration
|
|
*/
|
|
reg = readl(PORT_REGS(port) + UTMI_RX_CH_CTRL1_REG);
|
|
reg &= ~SQ_AMP_CAL_MASK;
|
|
reg |= (SQ_AMP_CAL_VAL << SQ_AMP_CAL_OFFSET) | SQ_AMP_CAL_EN;
|
|
writel(reg, PORT_REGS(port) + UTMI_RX_CH_CTRL1_REG);
|
|
|
|
/*
|
|
* Set Control VDAT Reference Voltage - 0.325V and
|
|
* Control VSRC Reference Voltage - 0.6V
|
|
*/
|
|
reg = readl(PORT_REGS(port) + UTMI_CHGDTC_CTRL_REG);
|
|
reg &= ~(VDAT_MASK | VSRC_MASK);
|
|
reg |= (VDAT_VAL << VDAT_OFFSET) | (VSRC_VAL << VSRC_OFFSET);
|
|
writel(reg, PORT_REGS(port) + UTMI_CHGDTC_CTRL_REG);
|
|
}
|
|
|
|
static int mvebu_cp110_utmi_phy_power_off(struct phy *phy)
|
|
{
|
|
struct mvebu_cp110_utmi_port *port = phy_get_drvdata(phy);
|
|
struct mvebu_cp110_utmi *utmi = port->priv;
|
|
int i;
|
|
|
|
/* Power down UTMI PHY port */
|
|
regmap_clear_bits(utmi->syscon, SYSCON_UTMI_CFG_REG(port->id),
|
|
UTMI_PHY_CFG_PU_MASK);
|
|
|
|
for (i = 0; i < UTMI_PHY_PORTS; i++) {
|
|
int test = regmap_test_bits(utmi->syscon,
|
|
SYSCON_UTMI_CFG_REG(i),
|
|
UTMI_PHY_CFG_PU_MASK);
|
|
/* skip PLL shutdown if there are active UTMI PHY ports */
|
|
if (test != 0)
|
|
return 0;
|
|
}
|
|
|
|
/* PLL Power down if all UTMI PHYs are down */
|
|
regmap_clear_bits(utmi->syscon, SYSCON_USB_CFG_REG, USB_CFG_PLL_MASK);
|
|
|
|
return 0;
|
|
}
|
|
|
|
static int mvebu_cp110_utmi_phy_power_on(struct phy *phy)
|
|
{
|
|
struct mvebu_cp110_utmi_port *port = phy_get_drvdata(phy);
|
|
struct mvebu_cp110_utmi *utmi = port->priv;
|
|
struct device *dev = &phy->dev;
|
|
int ret;
|
|
u32 reg;
|
|
|
|
/* It is necessary to power off UTMI before configuration */
|
|
ret = mvebu_cp110_utmi_phy_power_off(phy);
|
|
if (ret) {
|
|
dev_err(dev, "UTMI power OFF before power ON failed\n");
|
|
return ret;
|
|
}
|
|
|
|
/*
|
|
* If UTMI port is connected to USB Device controller,
|
|
* configure the USB MUX prior to UTMI PHY initialization.
|
|
* The single USB device controller can be connected
|
|
* to UTMI0 or to UTMI1 PHY port, but not to both.
|
|
*/
|
|
if (port->dr_mode == USB_DR_MODE_PERIPHERAL) {
|
|
regmap_update_bits(utmi->syscon, SYSCON_USB_CFG_REG,
|
|
USB_CFG_DEVICE_EN_MASK | USB_CFG_DEVICE_MUX_MASK,
|
|
USB_CFG_DEVICE_EN_MASK |
|
|
(port->id << USB_CFG_DEVICE_MUX_OFFSET));
|
|
}
|
|
|
|
/* Set Test suspendm mode and enable Test UTMI select */
|
|
reg = readl(PORT_REGS(port) + UTMI_CTRL_STATUS0_REG);
|
|
reg |= SUSPENDM | TEST_SEL;
|
|
writel(reg, PORT_REGS(port) + UTMI_CTRL_STATUS0_REG);
|
|
|
|
/* Wait for UTMI power down */
|
|
mdelay(1);
|
|
|
|
/* PHY port setup first */
|
|
mvebu_cp110_utmi_port_setup(port);
|
|
|
|
/* Power UP UTMI PHY */
|
|
regmap_set_bits(utmi->syscon, SYSCON_UTMI_CFG_REG(port->id),
|
|
UTMI_PHY_CFG_PU_MASK);
|
|
|
|
/* Disable Test UTMI select */
|
|
reg = readl(PORT_REGS(port) + UTMI_CTRL_STATUS0_REG);
|
|
reg &= ~TEST_SEL;
|
|
writel(reg, PORT_REGS(port) + UTMI_CTRL_STATUS0_REG);
|
|
|
|
/* Wait for impedance calibration */
|
|
ret = readl_poll_timeout(PORT_REGS(port) + UTMI_CAL_CTRL_REG, reg,
|
|
reg & IMPCAL_DONE,
|
|
PLL_LOCK_DELAY_US, PLL_LOCK_TIMEOUT_US);
|
|
if (ret) {
|
|
dev_err(dev, "Failed to end UTMI impedance calibration\n");
|
|
return ret;
|
|
}
|
|
|
|
/* Wait for PLL calibration */
|
|
ret = readl_poll_timeout(PORT_REGS(port) + UTMI_CAL_CTRL_REG, reg,
|
|
reg & PLLCAL_DONE,
|
|
PLL_LOCK_DELAY_US, PLL_LOCK_TIMEOUT_US);
|
|
if (ret) {
|
|
dev_err(dev, "Failed to end UTMI PLL calibration\n");
|
|
return ret;
|
|
}
|
|
|
|
/* Wait for PLL ready */
|
|
ret = readl_poll_timeout(PORT_REGS(port) + UTMI_PLL_CTRL_REG, reg,
|
|
reg & PLL_RDY,
|
|
PLL_LOCK_DELAY_US, PLL_LOCK_TIMEOUT_US);
|
|
if (ret) {
|
|
dev_err(dev, "PLL is not ready\n");
|
|
return ret;
|
|
}
|
|
|
|
/* PLL Power up */
|
|
regmap_set_bits(utmi->syscon, SYSCON_USB_CFG_REG, USB_CFG_PLL_MASK);
|
|
|
|
return 0;
|
|
}
|
|
|
|
static const struct phy_ops mvebu_cp110_utmi_phy_ops = {
|
|
.power_on = mvebu_cp110_utmi_phy_power_on,
|
|
.power_off = mvebu_cp110_utmi_phy_power_off,
|
|
.owner = THIS_MODULE,
|
|
};
|
|
|
|
static const struct of_device_id mvebu_cp110_utmi_of_match[] = {
|
|
{ .compatible = "marvell,cp110-utmi-phy" },
|
|
{},
|
|
};
|
|
MODULE_DEVICE_TABLE(of, mvebu_cp110_utmi_of_match);
|
|
|
|
static int mvebu_cp110_utmi_phy_probe(struct platform_device *pdev)
|
|
{
|
|
struct device *dev = &pdev->dev;
|
|
struct mvebu_cp110_utmi *utmi;
|
|
struct phy_provider *provider;
|
|
struct device_node *child;
|
|
u32 usb_devices = 0;
|
|
|
|
utmi = devm_kzalloc(dev, sizeof(*utmi), GFP_KERNEL);
|
|
if (!utmi)
|
|
return -ENOMEM;
|
|
|
|
utmi->dev = dev;
|
|
|
|
/* Get system controller region */
|
|
utmi->syscon = syscon_regmap_lookup_by_phandle(dev->of_node,
|
|
"marvell,system-controller");
|
|
if (IS_ERR(utmi->syscon)) {
|
|
dev_err(dev, "Missing UTMI system controller\n");
|
|
return PTR_ERR(utmi->syscon);
|
|
}
|
|
|
|
/* Get UTMI memory region */
|
|
utmi->regs = devm_platform_ioremap_resource(pdev, 0);
|
|
if (IS_ERR(utmi->regs))
|
|
return PTR_ERR(utmi->regs);
|
|
|
|
for_each_available_child_of_node(dev->of_node, child) {
|
|
struct mvebu_cp110_utmi_port *port;
|
|
struct phy *phy;
|
|
int ret;
|
|
u32 port_id;
|
|
|
|
ret = of_property_read_u32(child, "reg", &port_id);
|
|
if ((ret < 0) || (port_id >= UTMI_PHY_PORTS)) {
|
|
dev_err(dev,
|
|
"invalid 'reg' property on child %pOF\n",
|
|
child);
|
|
continue;
|
|
}
|
|
|
|
port = devm_kzalloc(dev, sizeof(*port), GFP_KERNEL);
|
|
if (!port) {
|
|
of_node_put(child);
|
|
return -ENOMEM;
|
|
}
|
|
|
|
port->dr_mode = of_usb_get_dr_mode_by_phy(child, -1);
|
|
if ((port->dr_mode != USB_DR_MODE_HOST) &&
|
|
(port->dr_mode != USB_DR_MODE_PERIPHERAL)) {
|
|
dev_err(&pdev->dev,
|
|
"Missing dual role setting of the port%d, will use HOST mode\n",
|
|
port_id);
|
|
port->dr_mode = USB_DR_MODE_HOST;
|
|
}
|
|
|
|
if (port->dr_mode == USB_DR_MODE_PERIPHERAL) {
|
|
usb_devices++;
|
|
if (usb_devices > 1) {
|
|
dev_err(dev,
|
|
"Single USB device allowed! Port%d will use HOST mode\n",
|
|
port_id);
|
|
port->dr_mode = USB_DR_MODE_HOST;
|
|
}
|
|
}
|
|
|
|
/* Retrieve PHY capabilities */
|
|
utmi->ops = &mvebu_cp110_utmi_phy_ops;
|
|
|
|
/* Instantiate the PHY */
|
|
phy = devm_phy_create(dev, child, utmi->ops);
|
|
if (IS_ERR(phy)) {
|
|
dev_err(dev, "Failed to create the UTMI PHY\n");
|
|
of_node_put(child);
|
|
return PTR_ERR(phy);
|
|
}
|
|
|
|
port->priv = utmi;
|
|
port->id = port_id;
|
|
phy_set_drvdata(phy, port);
|
|
|
|
/* Ensure the PHY is powered off */
|
|
mvebu_cp110_utmi_phy_power_off(phy);
|
|
}
|
|
|
|
dev_set_drvdata(dev, utmi);
|
|
provider = devm_of_phy_provider_register(dev, of_phy_simple_xlate);
|
|
|
|
return PTR_ERR_OR_ZERO(provider);
|
|
}
|
|
|
|
static struct platform_driver mvebu_cp110_utmi_driver = {
|
|
.probe = mvebu_cp110_utmi_phy_probe,
|
|
.driver = {
|
|
.name = "mvebu-cp110-utmi-phy",
|
|
.of_match_table = mvebu_cp110_utmi_of_match,
|
|
},
|
|
};
|
|
module_platform_driver(mvebu_cp110_utmi_driver);
|
|
|
|
MODULE_AUTHOR("Konstatin Porotchkin <kostap@marvell.com>");
|
|
MODULE_DESCRIPTION("Marvell Armada CP110 UTMI PHY driver");
|
|
MODULE_LICENSE("GPL v2");
|