]> git.ipfire.org Git - thirdparty/kernel/linux.git/commitdiff
usb: dwc3: introduce flatten model driver of i.MX Soc
authorXu Yang <xu.yang_2@nxp.com>
Thu, 12 Feb 2026 09:40:28 +0000 (17:40 +0800)
committerGreg Kroah-Hartman <gregkh@linuxfoundation.org>
Wed, 25 Feb 2026 18:35:58 +0000 (10:35 -0800)
The i.MX USB glue and DWC3 core are closely coupled. Describe the i.MX
USB block in a single block will bring more benefits than a parent-
child relation. To support the flatten model devicetree, DWC3 USB core
driver already support to directly register and initialize the core in
glue layer using one device. And many notification can be received in
glue layer timely and proper actions can be executed accordingly.

To align with mainstream, introduce a new driver to support flatten dwc3
devicetree model for i.MX Soc. Besides this driver disables wakeup irq
when system is active, no other function change in this version compared
to dwc3-imx8mp.c. After this new driver is settled, only maintenance
fixes will be added to dwc3-imx8mp.c, new features will only be added
to this new driver. Once all users switch to this new one, the legacy
driver will be removed at proper time.

Signed-off-by: Xu Yang <xu.yang_2@nxp.com>
Acked-by: Thinh Nguyen <Thinh.Nguyen@synopsys.com>
Link: https://patch.msgid.link/20260212-add-flatten-dts-based-dwc3-imx-driver-v5-3-ff04a75ce221@nxp.com
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
drivers/usb/dwc3/Kconfig
drivers/usb/dwc3/Makefile
drivers/usb/dwc3/dwc3-imx.c [new file with mode: 0644]

index 240b15bc52cbd5d5c9d08d9fddd8c63202de1a3c..18169727a413ee72405a89f477e4da16946e1764 100644 (file)
@@ -150,6 +150,18 @@ config USB_DWC3_IMX8MP
          functionality.
          Say 'Y' or 'M' if you have one such device.
 
+config USB_DWC3_IMX
+       tristate "NXP iMX Platform"
+       depends on OF && COMMON_CLK
+       depends on (ARCH_MXC && ARM64) || COMPILE_TEST
+       default USB_DWC3
+       help
+         NXP iMX SoC use DesignWare Core IP for USB2/3
+         functionality.
+         This driver also handles the wakeup feature outside
+         of DesignWare Core.
+         Say 'Y' or 'M' if you have one such device.
+
 config USB_DWC3_XILINX
        tristate "Xilinx Platforms"
        depends on (ARCH_ZYNQMP || COMPILE_TEST) && OF
index 073bef5309b5b5d381c8c4690221091b4df7904a..f37971197203e1379d554da9d60860360ea9c3fe 100644 (file)
@@ -55,6 +55,7 @@ obj-$(CONFIG_USB_DWC3_ST)             += dwc3-st.o
 obj-$(CONFIG_USB_DWC3_QCOM)            += dwc3-qcom.o
 obj-$(CONFIG_USB_DWC3_QCOM)            += dwc3-qcom-legacy.o
 obj-$(CONFIG_USB_DWC3_IMX8MP)          += dwc3-imx8mp.o
+obj-$(CONFIG_USB_DWC3_IMX)             += dwc3-imx.o
 obj-$(CONFIG_USB_DWC3_XILINX)          += dwc3-xilinx.o
 obj-$(CONFIG_USB_DWC3_OCTEON)          += dwc3-octeon.o
 obj-$(CONFIG_USB_DWC3_RTK)             += dwc3-rtk.o
diff --git a/drivers/usb/dwc3/dwc3-imx.c b/drivers/usb/dwc3/dwc3-imx.c
new file mode 100644 (file)
index 0000000..303708f
--- /dev/null
@@ -0,0 +1,442 @@
+// SPDX-License-Identifier: GPL-2.0
+/*
+ * dwc3-imx.c - NXP i.MX Soc USB3 Specific Glue layer
+ *
+ * Copyright 2026 NXP
+ */
+
+#include <linux/clk.h>
+#include <linux/interrupt.h>
+#include <linux/io.h>
+#include <linux/kernel.h>
+#include <linux/module.h>
+#include <linux/of_platform.h>
+#include <linux/platform_device.h>
+#include <linux/pm_runtime.h>
+
+#include "core.h"
+#include "glue.h"
+
+/* USB wakeup registers */
+#define USB_WAKEUP_CTRL                        0x00
+
+/* Global wakeup interrupt enable, also used to clear interrupt */
+#define USB_WAKEUP_EN                  BIT(31)
+/* Wakeup from connect or disconnect, only for superspeed */
+#define USB_WAKEUP_SS_CONN             BIT(5)
+/* 0 select vbus_valid, 1 select sessvld */
+#define USB_WAKEUP_VBUS_SRC_SESS_VAL   BIT(4)
+/* Enable signal for wake up from u3 state */
+#define USB_WAKEUP_U3_EN               BIT(3)
+/* Enable signal for wake up from id change */
+#define USB_WAKEUP_ID_EN               BIT(2)
+/* Enable signal for wake up from vbus change */
+#define        USB_WAKEUP_VBUS_EN              BIT(1)
+/* Enable signal for wake up from dp/dm change */
+#define USB_WAKEUP_DPDM_EN             BIT(0)
+
+#define USB_WAKEUP_EN_MASK             GENMASK(5, 0)
+
+/* USB glue registers */
+#define USB_CTRL0              0x00
+#define USB_CTRL1              0x04
+
+#define USB_CTRL0_PORTPWR_EN   BIT(12) /* 1 - PPC enabled (default) */
+#define USB_CTRL0_USB3_FIXED   BIT(22) /* 1 - USB3 permanent attached */
+#define USB_CTRL0_USB2_FIXED   BIT(23) /* 1 - USB2 permanent attached */
+
+#define USB_CTRL1_OC_POLARITY  BIT(16) /* 0 - HIGH / 1 - LOW */
+#define USB_CTRL1_PWR_POLARITY BIT(17) /* 0 - HIGH / 1 - LOW */
+
+struct dwc3_imx {
+       struct dwc3     dwc;
+       struct device   *dev;
+       void __iomem    *blkctl_base;
+       void __iomem    *glue_base;
+       struct clk      *hsio_clk;
+       struct clk      *suspend_clk;
+       int             irq;
+       bool            pm_suspended;
+       bool            wakeup_pending;
+       unsigned        permanent_attached:1;
+       unsigned        disable_pwr_ctrl:1;
+       unsigned        overcur_active_low:1;
+       unsigned        power_active_low:1;
+};
+
+#define to_dwc3_imx(d) container_of((d), struct dwc3_imx, dwc)
+
+static void dwc3_imx_get_property(struct dwc3_imx *dwc_imx)
+{
+       struct device   *dev = dwc_imx->dev;
+
+       dwc_imx->permanent_attached =
+               device_property_read_bool(dev, "fsl,permanently-attached");
+       dwc_imx->disable_pwr_ctrl =
+               device_property_read_bool(dev, "fsl,disable-port-power-control");
+       dwc_imx->overcur_active_low =
+               device_property_read_bool(dev, "fsl,over-current-active-low");
+       dwc_imx->power_active_low =
+               device_property_read_bool(dev, "fsl,power-active-low");
+}
+
+static void dwc3_imx_configure_glue(struct dwc3_imx *dwc_imx)
+{
+       u32             value;
+
+       if (!dwc_imx->glue_base)
+               return;
+
+       value = readl(dwc_imx->glue_base + USB_CTRL0);
+
+       if (dwc_imx->permanent_attached)
+               value |= USB_CTRL0_USB2_FIXED | USB_CTRL0_USB3_FIXED;
+       else
+               value &= ~(USB_CTRL0_USB2_FIXED | USB_CTRL0_USB3_FIXED);
+
+       if (dwc_imx->disable_pwr_ctrl)
+               value &= ~USB_CTRL0_PORTPWR_EN;
+       else
+               value |= USB_CTRL0_PORTPWR_EN;
+
+       writel(value, dwc_imx->glue_base + USB_CTRL0);
+
+       value = readl(dwc_imx->glue_base + USB_CTRL1);
+       if (dwc_imx->overcur_active_low)
+               value |= USB_CTRL1_OC_POLARITY;
+       else
+               value &= ~USB_CTRL1_OC_POLARITY;
+
+       if (dwc_imx->power_active_low)
+               value |= USB_CTRL1_PWR_POLARITY;
+       else
+               value &= ~USB_CTRL1_PWR_POLARITY;
+
+       writel(value, dwc_imx->glue_base + USB_CTRL1);
+}
+
+static void dwc3_imx_wakeup_enable(struct dwc3_imx *dwc_imx, pm_message_t msg)
+{
+       struct dwc3     *dwc = &dwc_imx->dwc;
+       u32             val;
+
+       val = readl(dwc_imx->blkctl_base + USB_WAKEUP_CTRL);
+
+       if (dwc->current_dr_role == DWC3_GCTL_PRTCAP_HOST && dwc->xhci) {
+               val |= USB_WAKEUP_EN | USB_WAKEUP_DPDM_EN;
+               if (PMSG_IS_AUTO(msg))
+                       val |= USB_WAKEUP_SS_CONN | USB_WAKEUP_U3_EN;
+       } else {
+               val |= USB_WAKEUP_EN | USB_WAKEUP_VBUS_EN |
+                      USB_WAKEUP_VBUS_SRC_SESS_VAL;
+       }
+
+       writel(val, dwc_imx->blkctl_base + USB_WAKEUP_CTRL);
+}
+
+static void dwc3_imx_wakeup_disable(struct dwc3_imx *dwc_imx)
+{
+       u32     val;
+
+       val = readl(dwc_imx->blkctl_base + USB_WAKEUP_CTRL);
+       val &= ~(USB_WAKEUP_EN | USB_WAKEUP_EN_MASK);
+       writel(val, dwc_imx->blkctl_base + USB_WAKEUP_CTRL);
+}
+
+static irqreturn_t dwc3_imx_interrupt(int irq, void *data)
+{
+       struct dwc3_imx *dwc_imx = data;
+       struct dwc3     *dwc = &dwc_imx->dwc;
+
+       if (!dwc_imx->pm_suspended)
+               return IRQ_HANDLED;
+
+       disable_irq_nosync(dwc_imx->irq);
+       dwc_imx->wakeup_pending = true;
+
+       if (dwc->current_dr_role == DWC3_GCTL_PRTCAP_HOST && dwc->xhci)
+               pm_runtime_resume(&dwc->xhci->dev);
+       else if (dwc->current_dr_role == DWC3_GCTL_PRTCAP_DEVICE)
+               pm_runtime_get(dwc->dev);
+
+       return IRQ_HANDLED;
+}
+
+static void dwc3_imx_pre_set_role(struct dwc3 *dwc, enum usb_role role)
+{
+       if (role == USB_ROLE_HOST)
+               /*
+                * For xhci host, we need disable dwc core auto
+                * suspend, because during this auto suspend delay(5s),
+                * xhci host RUN_STOP is cleared and wakeup is not
+                * enabled, if device is inserted, xhci host can't
+                * response the connection.
+                */
+               pm_runtime_dont_use_autosuspend(dwc->dev);
+       else
+               pm_runtime_use_autosuspend(dwc->dev);
+}
+
+static struct dwc3_glue_ops dwc3_imx_glue_ops = {
+       .pre_set_role = dwc3_imx_pre_set_role,
+};
+
+static const struct property_entry dwc3_imx_properties[] = {
+       PROPERTY_ENTRY_BOOL("xhci-missing-cas-quirk"),
+       PROPERTY_ENTRY_BOOL("xhci-skip-phy-init-quirk"),
+       {},
+};
+
+static const struct software_node dwc3_imx_swnode = {
+       .properties = dwc3_imx_properties,
+};
+
+static int dwc3_imx_probe(struct platform_device *pdev)
+{
+       struct device           *dev = &pdev->dev;
+       struct dwc3_imx         *dwc_imx;
+       struct dwc3             *dwc;
+       struct resource         *res;
+       const char              *irq_name;
+       struct dwc3_probe_data  probe_data = {};
+       int                     ret, irq;
+
+       dwc_imx = devm_kzalloc(dev, sizeof(*dwc_imx), GFP_KERNEL);
+       if (!dwc_imx)
+               return -ENOMEM;
+
+       platform_set_drvdata(pdev, dwc_imx);
+       dwc_imx->dev = dev;
+
+       dwc3_imx_get_property(dwc_imx);
+
+       dwc_imx->blkctl_base = devm_platform_ioremap_resource_byname(pdev, "blkctl");
+       if (IS_ERR(dwc_imx->blkctl_base))
+               return PTR_ERR(dwc_imx->blkctl_base);
+
+       res = platform_get_resource_byname(pdev, IORESOURCE_MEM, "glue");
+       if (!res) {
+               dev_warn(dev, "Base address for glue layer missing\n");
+       } else {
+               dwc_imx->glue_base = devm_ioremap_resource(dev, res);
+               if (IS_ERR(dwc_imx->glue_base))
+                       return PTR_ERR(dwc_imx->glue_base);
+       }
+
+       res = platform_get_resource_byname(pdev, IORESOURCE_MEM, "core");
+       if (!res)
+               return dev_err_probe(dev, -ENODEV, "missing core memory resource\n");
+
+       dwc_imx->hsio_clk = devm_clk_get_enabled(dev, "hsio");
+       if (IS_ERR(dwc_imx->hsio_clk))
+               return dev_err_probe(dev, PTR_ERR(dwc_imx->hsio_clk),
+                                    "Failed to get hsio clk\n");
+
+       dwc_imx->suspend_clk = devm_clk_get_enabled(dev, "suspend");
+       if (IS_ERR(dwc_imx->suspend_clk))
+               return dev_err_probe(dev, PTR_ERR(dwc_imx->suspend_clk),
+                                    "Failed to get suspend clk\n");
+
+       irq = platform_get_irq_byname(pdev, "wakeup");
+       if (irq < 0)
+               return irq;
+       dwc_imx->irq = irq;
+
+       irq_name = devm_kasprintf(dev, GFP_KERNEL, "%s:wakeup", dev_name(dev));
+       if (!irq_name)
+               return dev_err_probe(dev, -ENOMEM, "failed to create irq_name\n");
+
+       ret = devm_request_threaded_irq(dev, irq, NULL, dwc3_imx_interrupt,
+                                       IRQF_ONESHOT | IRQF_NO_AUTOEN,
+                                       irq_name, dwc_imx);
+       if (ret)
+               return dev_err_probe(dev, ret, "failed to request IRQ #%d\n", irq);
+
+       ret = device_add_software_node(dev, &dwc3_imx_swnode);
+       if (ret)
+               return dev_err_probe(dev, ret, "failed to add software node\n");
+
+       dwc3_imx_configure_glue(dwc_imx);
+
+       dwc = &dwc_imx->dwc;
+       dwc->dev = dev;
+       dwc->glue_ops = &dwc3_imx_glue_ops;
+
+       probe_data.res = res;
+       probe_data.dwc = dwc;
+       probe_data.properties = DWC3_DEFAULT_PROPERTIES;
+       probe_data.properties.needs_full_reinit = true;
+
+       ret = dwc3_core_probe(&probe_data);
+       if (ret) {
+               device_remove_software_node(dev);
+               return ret;
+       }
+
+       device_set_wakeup_capable(dev, true);
+       return 0;
+}
+
+static void dwc3_imx_remove(struct platform_device *pdev)
+{
+       struct device   *dev = &pdev->dev;
+       struct dwc3     *dwc = dev_get_drvdata(dev);
+
+       dwc3_core_remove(dwc);
+       device_remove_software_node(dev);
+}
+
+static void dwc3_imx_suspend(struct dwc3_imx *dwc_imx, pm_message_t msg)
+{
+       if (PMSG_IS_AUTO(msg) || device_may_wakeup(dwc_imx->dev))
+               dwc3_imx_wakeup_enable(dwc_imx, msg);
+
+       enable_irq(dwc_imx->irq);
+       dwc_imx->pm_suspended = true;
+}
+
+static void dwc3_imx_resume(struct dwc3_imx *dwc_imx, pm_message_t msg)
+{
+       struct dwc3     *dwc = &dwc_imx->dwc;
+
+       dwc_imx->pm_suspended = false;
+       if (!dwc_imx->wakeup_pending)
+               disable_irq_nosync(dwc_imx->irq);
+
+       dwc3_imx_wakeup_disable(dwc_imx);
+
+       /* Upon power loss any previous configuration is lost, restore it */
+       dwc3_imx_configure_glue(dwc_imx);
+
+       if (dwc_imx->wakeup_pending) {
+               dwc_imx->wakeup_pending = false;
+               if (dwc->current_dr_role == DWC3_GCTL_PRTCAP_DEVICE)
+                       pm_runtime_put_autosuspend(dwc->dev);
+               else
+                       /*
+                        * Add wait for xhci switch from suspend
+                        * clock to normal clock to detect connection.
+                        */
+                       usleep_range(9000, 10000);
+       }
+}
+
+static int dwc3_imx_runtime_suspend(struct device *dev)
+{
+       struct dwc3     *dwc = dev_get_drvdata(dev);
+       struct dwc3_imx *dwc_imx = to_dwc3_imx(dwc);
+       int             ret;
+
+       ret = dwc3_runtime_suspend(dwc);
+       if (ret)
+               return ret;
+
+       dwc3_imx_suspend(dwc_imx, PMSG_AUTO_SUSPEND);
+       return 0;
+}
+
+static int dwc3_imx_runtime_resume(struct device *dev)
+{
+       struct dwc3     *dwc = dev_get_drvdata(dev);
+       struct dwc3_imx *dwc_imx = to_dwc3_imx(dwc);
+
+       dwc3_imx_resume(dwc_imx, PMSG_AUTO_RESUME);
+       return dwc3_runtime_resume(dwc);
+}
+
+static int dwc3_imx_runtime_idle(struct device *dev)
+{
+       return dwc3_runtime_idle(dev_get_drvdata(dev));
+}
+
+static int dwc3_imx_pm_suspend(struct device *dev)
+{
+       struct dwc3     *dwc = dev_get_drvdata(dev);
+       struct dwc3_imx *dwc_imx = to_dwc3_imx(dwc);
+       int             ret;
+
+       ret = dwc3_pm_suspend(dwc);
+       if (ret)
+               return ret;
+
+       dwc3_imx_suspend(dwc_imx, PMSG_SUSPEND);
+
+       if (device_may_wakeup(dev)) {
+               enable_irq_wake(dwc_imx->irq);
+               device_set_out_band_wakeup(dev);
+       } else {
+               clk_disable_unprepare(dwc_imx->suspend_clk);
+       }
+
+       clk_disable_unprepare(dwc_imx->hsio_clk);
+
+       return 0;
+}
+
+static int dwc3_imx_pm_resume(struct device *dev)
+{
+       struct dwc3     *dwc = dev_get_drvdata(dev);
+       struct dwc3_imx *dwc_imx = to_dwc3_imx(dwc);
+       int             ret;
+
+       if (device_may_wakeup(dwc_imx->dev)) {
+               disable_irq_wake(dwc_imx->irq);
+       } else {
+               ret = clk_prepare_enable(dwc_imx->suspend_clk);
+               if (ret)
+                       return ret;
+       }
+
+       ret = clk_prepare_enable(dwc_imx->hsio_clk);
+       if (ret) {
+               clk_disable_unprepare(dwc_imx->suspend_clk);
+               return ret;
+       }
+
+       dwc3_imx_resume(dwc_imx, PMSG_RESUME);
+
+       ret = dwc3_pm_resume(dwc);
+       if (ret)
+               return ret;
+
+       return 0;
+}
+
+static void dwc3_imx_complete(struct device *dev)
+{
+       dwc3_pm_complete(dev_get_drvdata(dev));
+}
+
+static int dwc3_imx_prepare(struct device *dev)
+{
+       return dwc3_pm_prepare(dev_get_drvdata(dev));
+}
+
+static const struct dev_pm_ops dwc3_imx_dev_pm_ops = {
+       SYSTEM_SLEEP_PM_OPS(dwc3_imx_pm_suspend, dwc3_imx_pm_resume)
+       RUNTIME_PM_OPS(dwc3_imx_runtime_suspend, dwc3_imx_runtime_resume,
+                      dwc3_imx_runtime_idle)
+       .complete = pm_sleep_ptr(dwc3_imx_complete),
+       .prepare = pm_sleep_ptr(dwc3_imx_prepare),
+};
+
+static const struct of_device_id dwc3_imx_of_match[] = {
+       { .compatible = "nxp,imx8mp-dwc3", },
+       {},
+};
+MODULE_DEVICE_TABLE(of, dwc3_imx_of_match);
+
+static struct platform_driver dwc3_imx_driver = {
+       .probe          = dwc3_imx_probe,
+       .remove         = dwc3_imx_remove,
+       .driver         = {
+               .name   = "imx-dwc3",
+               .pm     = pm_ptr(&dwc3_imx_dev_pm_ops),
+               .of_match_table = dwc3_imx_of_match,
+       },
+};
+
+module_platform_driver(dwc3_imx_driver);
+
+MODULE_LICENSE("GPL");
+MODULE_DESCRIPTION("DesignWare USB3 i.MX Glue Layer");