Re: [PATCH RFC v3 5/6] phy: mvebu-cp110-utmi: add support for armada-380 utmi phys

From: Vinod Koul
Date: Thu Jul 25 2024 - 02:44:05 EST


On 20-07-24, 16:19, Josua Mayer wrote:
> Armada 380 has similar USB-2.0 PHYs as CP-110. The differences are:
> - register base addresses
> - gap between port registers
> - number of ports: 388 has three, cp110 two
> - device-mode mux bit refers to different ports
> - syscon register's base address (offsets identical)
> - armada-8k uses syscon for various drivers, a38x not
>
> Differentiation uses of_match_data with distinct compatible strings.
>
> Add support for Armada 380 PHYs by partially restructuting the driver:
> - Port register pointers are moved to the per-port private data.
> - Add armada-38x-specific compatible string and store enum value in
> of_match_data for differentiation.
> - Add support for optional regs usb-cfg and utmi-cfg, to be used instead
> of syscon.
>
> Signed-off-by: Josua Mayer <josua@xxxxxxxxxxxxx>
> ---
> drivers/phy/marvell/phy-mvebu-cp110-utmi.c | 209 +++++++++++++++++++++++------
> 1 file changed, 166 insertions(+), 43 deletions(-)
>
> diff --git a/drivers/phy/marvell/phy-mvebu-cp110-utmi.c b/drivers/phy/marvell/phy-mvebu-cp110-utmi.c
> index 4922a5f3327d..4341923e85bc 100644
> --- a/drivers/phy/marvell/phy-mvebu-cp110-utmi.c
> +++ b/drivers/phy/marvell/phy-mvebu-cp110-utmi.c
> @@ -19,7 +19,7 @@
> #include <linux/usb/of.h>
> #include <linux/usb/otg.h>
>
> -#define UTMI_PHY_PORTS 2
> +#define UTMI_PHY_PORTS 3
>
> /* CP110 UTMI register macro definetions */
> #define SYSCON_USB_CFG_REG 0x420
> @@ -76,32 +76,44 @@
> #define PLL_LOCK_DELAY_US 10000
> #define PLL_LOCK_TIMEOUT_US 1000000
>
> -#define PORT_REGS(p) ((p)->priv->regs + (p)->id * 0x1000)
> +enum mvebu_cp110_utmi_type {
> + /* 0 is reserved to avoid clashing with NULL */
> + A380_UTMI = 1,
> + CP110_UTMI = 2,
> +};
> +
> +struct mvebu_cp110_utmi_port;

why forward declare and not move the structs instead?

>
> /**
> * struct mvebu_cp110_utmi - PHY driver data
> *
> - * @regs: PHY registers
> + * @regs_usb: USB configuration register
> * @syscon: Regmap with system controller registers
> * @dev: device driver handle
> * @ops: phy ops
> + * @ports: phy object for each port
> */
> struct mvebu_cp110_utmi {
> - void __iomem *regs;
> + void __iomem *regs_usb;
> struct regmap *syscon;
> struct device *dev;
> const struct phy_ops *ops;
> + struct mvebu_cp110_utmi_port *ports[UTMI_PHY_PORTS];
> };
>
> /**
> * struct mvebu_cp110_utmi_port - PHY port data
> *
> + * @regs: PHY registers
> + * @regs_cfg: PHY config register
> * @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;
> + void __iomem *regs;
> + void __iomem *regs_cfg;
> u32 id;
> enum usb_dr_mode dr_mode;
> };
> @@ -118,47 +130,47 @@ static void mvebu_cp110_utmi_port_setup(struct mvebu_cp110_utmi_port *port)
> * 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 = readl(port->regs + UTMI_PLL_CTRL_REG);

why not handle this as a preparatory patch for this? Helps in review

> 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);
> + writel(reg, port->regs + UTMI_PLL_CTRL_REG);
>
> /* Impedance Calibration Threshold Setting */
> - reg = readl(PORT_REGS(port) + UTMI_CAL_CTRL_REG);
> + reg = readl(port->regs + UTMI_CAL_CTRL_REG);
> reg &= ~IMPCAL_VTH_MASK;
> reg |= IMPCAL_VTH_VAL << IMPCAL_VTH_OFFSET;
> - writel(reg, PORT_REGS(port) + UTMI_CAL_CTRL_REG);
> + writel(reg, port->regs + UTMI_CAL_CTRL_REG);
>
> /* Set LS TX driver strength coarse control */
> - reg = readl(PORT_REGS(port) + UTMI_TX_CH_CTRL_REG);
> + reg = readl(port->regs + 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);
> + writel(reg, port->regs + UTMI_TX_CH_CTRL_REG);
>
> /* Disable SQ and enable analog squelch detect */
> - reg = readl(PORT_REGS(port) + UTMI_RX_CH_CTRL0_REG);
> + reg = readl(port->regs + UTMI_RX_CH_CTRL0_REG);
> reg &= ~SQ_DET_EN;
> reg |= SQ_ANA_DTC_SEL;
> - writel(reg, PORT_REGS(port) + UTMI_RX_CH_CTRL0_REG);
> + writel(reg, port->regs + 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 = readl(port->regs + 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);
> + writel(reg, port->regs + 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 = readl(port->regs + 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);
> + writel(reg, port->regs + UTMI_CHGDTC_CTRL_REG);
> }
>
> static int mvebu_cp110_utmi_phy_power_off(struct phy *phy)
> @@ -166,22 +178,38 @@ 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;
> + int reg;
>
> /* Power down UTMI PHY port */
> - regmap_clear_bits(utmi->syscon, SYSCON_UTMI_CFG_REG(port->id),
> - UTMI_PHY_CFG_PU_MASK);
> + if (!IS_ERR(port->regs_cfg)) {
> + reg = readl(port->regs_cfg);
> + reg &= ~(UTMI_PHY_CFG_PU_MASK);
> + writel(reg, port->regs_cfg);
> + } else
> + regmap_clear_bits(utmi->syscon, SYSCON_UTMI_CFG_REG(port->id),
> + UTMI_PHY_CFG_PU_MASK);

why are we doing both raw register read/write and regmap ops... that
does not sound correct to me

>
> 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);
> + if (!utmi->ports[i])
> + continue;
> +
> + if (!IS_ERR(utmi->ports[i]->regs_cfg))
> + reg = readl(utmi->ports[i]->regs_cfg);
> + else
> + regmap_read(utmi->syscon, SYSCON_UTMI_CFG_REG(i), &reg);
> + int test = reg & 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);
> + if (!IS_ERR(utmi->regs_usb)) {
> + reg = readl(utmi->regs_usb);
> + reg &= ~(USB_CFG_PLL_MASK);
> + writel(reg, utmi->regs_usb);
> + } else
> + regmap_clear_bits(utmi->syscon, SYSCON_USB_CFG_REG, USB_CFG_PLL_MASK);
>
> return 0;
> }
> @@ -191,8 +219,15 @@ 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;
> + const void *match;
> + enum mvebu_cp110_utmi_type type;
> int ret;
> u32 reg;
> + u32 sel;
> +
> + match = device_get_match_data(utmi->dev);
> + if (match)
> + type = (enum mvebu_cp110_utmi_type)(uintptr_t)match;
>
> /* It is necessary to power off UTMI before configuration */
> ret = mvebu_cp110_utmi_phy_power_off(phy);
> @@ -208,16 +243,45 @@ static int mvebu_cp110_utmi_phy_power_on(struct phy *phy)
> * 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));
> + switch (type) {
> + case A380_UTMI:
> + /*
> + * A380 muxes between ports 0/2:
> + * - 0: Device mode on Port 2
> + * - 1: Device mode on Port 0
> + */
> + if (port->id == 1)
> + return -EINVAL;
> + sel = !!(port->id == 0);
> + break;
> + case CP110_UTMI:
> + /*
> + * CP110 muxes between ports 0/1:
> + * - 0: Device mode on Port 0
> + * - 1: Device mode on Port 1
> + */
> + sel = port->id;
> + break;
> + default:
> + return -EINVAL;
> + }
> + if (!IS_ERR(utmi->regs_usb)) {
> + reg = readl(utmi->regs_usb);
> + reg &= ~(USB_CFG_DEVICE_EN_MASK | USB_CFG_DEVICE_MUX_MASK);
> + reg |= USB_CFG_DEVICE_EN_MASK;
> + reg |= (sel << USB_CFG_DEVICE_MUX_OFFSET);
> + writel(reg, utmi->regs_usb);
> + } else
> + regmap_update_bits(utmi->syscon, SYSCON_USB_CFG_REG,
> + USB_CFG_DEVICE_EN_MASK | USB_CFG_DEVICE_MUX_MASK,
> + USB_CFG_DEVICE_EN_MASK |
> + (sel << USB_CFG_DEVICE_MUX_OFFSET));
> }
>
> /* Set Test suspendm mode and enable Test UTMI select */
> - reg = readl(PORT_REGS(port) + UTMI_CTRL_STATUS0_REG);
> + reg = readl(port->regs + UTMI_CTRL_STATUS0_REG);
> reg |= SUSPENDM | TEST_SEL;
> - writel(reg, PORT_REGS(port) + UTMI_CTRL_STATUS0_REG);
> + writel(reg, port->regs + UTMI_CTRL_STATUS0_REG);
>
> /* Wait for UTMI power down */
> mdelay(1);
> @@ -226,16 +290,21 @@ static int mvebu_cp110_utmi_phy_power_on(struct phy *phy)
> 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);
> + if (!IS_ERR(port->regs_cfg)) {
> + reg = readl(port->regs_cfg);
> + reg |= UTMI_PHY_CFG_PU_MASK;
> + writel(reg, port->regs_cfg);
> + } else
> + 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 = readl(port->regs + UTMI_CTRL_STATUS0_REG);
> reg &= ~TEST_SEL;
> - writel(reg, PORT_REGS(port) + UTMI_CTRL_STATUS0_REG);
> + writel(reg, port->regs + UTMI_CTRL_STATUS0_REG);
>
> /* Wait for impedance calibration */
> - ret = readl_poll_timeout(PORT_REGS(port) + UTMI_CAL_CTRL_REG, reg,
> + ret = readl_poll_timeout(port->regs + UTMI_CAL_CTRL_REG, reg,
> reg & IMPCAL_DONE,
> PLL_LOCK_DELAY_US, PLL_LOCK_TIMEOUT_US);
> if (ret) {
> @@ -244,7 +313,7 @@ static int mvebu_cp110_utmi_phy_power_on(struct phy *phy)
> }
>
> /* Wait for PLL calibration */
> - ret = readl_poll_timeout(PORT_REGS(port) + UTMI_CAL_CTRL_REG, reg,
> + ret = readl_poll_timeout(port->regs + UTMI_CAL_CTRL_REG, reg,
> reg & PLLCAL_DONE,
> PLL_LOCK_DELAY_US, PLL_LOCK_TIMEOUT_US);
> if (ret) {
> @@ -253,7 +322,7 @@ static int mvebu_cp110_utmi_phy_power_on(struct phy *phy)
> }
>
> /* Wait for PLL ready */
> - ret = readl_poll_timeout(PORT_REGS(port) + UTMI_PLL_CTRL_REG, reg,
> + ret = readl_poll_timeout(port->regs + UTMI_PLL_CTRL_REG, reg,
> reg & PLL_RDY,
> PLL_LOCK_DELAY_US, PLL_LOCK_TIMEOUT_US);
> if (ret) {
> @@ -262,7 +331,12 @@ static int mvebu_cp110_utmi_phy_power_on(struct phy *phy)
> }
>
> /* PLL Power up */
> - regmap_set_bits(utmi->syscon, SYSCON_USB_CFG_REG, USB_CFG_PLL_MASK);
> + if (!IS_ERR(utmi->regs_usb)) {
> + reg = readl(utmi->regs_usb);
> + reg |= USB_CFG_PLL_MASK;
> + writel(reg, utmi->regs_usb);
> + } else
> + regmap_set_bits(utmi->syscon, SYSCON_USB_CFG_REG, USB_CFG_PLL_MASK);
>
> return 0;
> }
> @@ -274,7 +348,8 @@ static const struct phy_ops mvebu_cp110_utmi_phy_ops = {
> };
>
> static const struct of_device_id mvebu_cp110_utmi_of_match[] = {
> - { .compatible = "marvell,cp110-utmi-phy" },
> + { .compatible = "marvell,a38x-utmi-phy", .data = (void *)A380_UTMI },
> + { .compatible = "marvell,cp110-utmi-phy", .data = (void *)CP110_UTMI },

Cast to void * are not required to be done

> {},
> };
> MODULE_DEVICE_TABLE(of, mvebu_cp110_utmi_of_match);
> @@ -285,6 +360,10 @@ static int mvebu_cp110_utmi_phy_probe(struct platform_device *pdev)
> struct mvebu_cp110_utmi *utmi;
> struct phy_provider *provider;
> struct device_node *child;
> + void __iomem *regs_utmi;
> + void __iomem *regs_utmi_cfg;
> + const void *match;
> + enum mvebu_cp110_utmi_type type;
> u32 usb_devices = 0;
>
> utmi = devm_kzalloc(dev, sizeof(*utmi), GFP_KERNEL);
> @@ -293,18 +372,44 @@ static int mvebu_cp110_utmi_phy_probe(struct platform_device *pdev)
>
> utmi->dev = dev;
>
> + match = device_get_match_data(dev);
> + if (match)
> + type = (enum mvebu_cp110_utmi_type)(uintptr_t)match;
> +
> + /* Get UTMI memory region */
> + regs_utmi = devm_platform_ioremap_resource(pdev, 0);
> + if (IS_ERR(regs_utmi)) {
> + dev_err(dev, "Failed to map utmi regs\n");
> + return PTR_ERR(regs_utmi);
> + }
> +
> + /* Get usb config region */
> + utmi->regs_usb = devm_platform_ioremap_resource_byname(pdev, "usb-cfg");
> + if (IS_ERR(utmi->regs_usb) && PTR_ERR(utmi->regs_usb) != -EINVAL) {
> + dev_err(dev, "Failed to map usb config regs\n");
> + return PTR_ERR(utmi->regs_usb);
> + }
> +
> + /* Get utmi config region */
> + regs_utmi_cfg = devm_platform_ioremap_resource_byname(pdev, "utmi-cfg");
> + if (IS_ERR(regs_utmi_cfg) && PTR_ERR(regs_utmi_cfg) != -EINVAL) {
> + dev_err(dev, "Failed to map usb config regs\n");
> + return PTR_ERR(regs_utmi_cfg);
> + }
> +
> /* 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");
> + if (IS_ERR(utmi->syscon) && PTR_ERR(utmi->syscon) != -ENODEV) {
> + dev_err(dev, "Failed to get 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);
> + if (IS_ERR(utmi->syscon) &&
> + (IS_ERR(utmi->regs_usb) || IS_ERR(regs_utmi_cfg))) {
> + dev_err(dev, "Missing utmi system controller or config regs");
> + return -EINVAL;
> + }
>
> for_each_available_child_of_node(dev->of_node, child) {
> struct mvebu_cp110_utmi_port *port;
> @@ -326,6 +431,24 @@ static int mvebu_cp110_utmi_phy_probe(struct platform_device *pdev)
> return -ENOMEM;
> }
>
> + utmi->ports[port_id] = port;
> +
> + /* Get port memory region */
> + switch (type) {
> + case A380_UTMI:
> + port->regs = regs_utmi + port_id * 0x1000;
> + break;
> + case CP110_UTMI:
> + port->regs = regs_utmi + port_id * 0x2000;
> + break;
> + default:
> + return -EINVAL;
> + }
> +
> + /* assign utmi cfg reg */
> + if (!IS_ERR(regs_utmi_cfg))
> + port->regs_cfg = regs_utmi_cfg + port_id * 4;
> +
> 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)) {
>
> --
> 2.43.0

--
~Vinod