1 // SPDX-License-Identifier: (GPL-2.0+ OR BSD-3-Clause)
3 * platform.c - DesignWare HS OTG Controller platform driver
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions, and the following disclaimer,
12 * without modification.
13 * 2. Redistributions in binary form must reproduce the above copyright
14 * notice, this list of conditions and the following disclaimer in the
15 * documentation and/or other materials provided with the distribution.
16 * 3. The names of the above-listed copyright holders may not be used
17 * to endorse or promote products derived from this software without
18 * specific prior written permission.
20 * ALTERNATIVELY, this software may be distributed under the terms of the
21 * GNU General Public License ("GPL") as published by the Free Software
22 * Foundation; either version 2 of the License, or (at your option) any
25 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
26 * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
27 * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
28 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
29 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
30 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
31 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
32 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
33 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
34 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
35 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
38 #include <linux/kernel.h>
39 #include <linux/module.h>
40 #include <linux/slab.h>
41 #include <linux/clk.h>
42 #include <linux/device.h>
43 #include <linux/dma-mapping.h>
44 #include <linux/of_device.h>
45 #include <linux/mutex.h>
46 #include <linux/platform_device.h>
47 #include <linux/phy/phy.h>
48 #include <linux/platform_data/s3c-hsotg.h>
49 #include <linux/reset.h>
51 #include <linux/usb/of.h>
57 static const char dwc2_driver_name[] = "dwc2";
60 * Check the dr_mode against the module configuration and hardware
63 * The hardware, module, and dr_mode, can each be set to host, device,
64 * or otg. Check that all these values are compatible and adjust the
65 * value of dr_mode if possible.
68 * HW MOD dr_mode dr_mode
69 * ------------------------------
80 * OTG OTG any : dr_mode
82 static int dwc2_get_dr_mode(struct dwc2_hsotg *hsotg)
84 enum usb_dr_mode mode;
86 hsotg->dr_mode = usb_get_dr_mode(hsotg->dev);
87 if (hsotg->dr_mode == USB_DR_MODE_UNKNOWN)
88 hsotg->dr_mode = USB_DR_MODE_OTG;
90 mode = hsotg->dr_mode;
92 if (dwc2_hw_is_device(hsotg)) {
93 if (IS_ENABLED(CONFIG_USB_DWC2_HOST)) {
95 "Controller does not support host mode.\n");
98 mode = USB_DR_MODE_PERIPHERAL;
99 } else if (dwc2_hw_is_host(hsotg)) {
100 if (IS_ENABLED(CONFIG_USB_DWC2_PERIPHERAL)) {
102 "Controller does not support device mode.\n");
105 mode = USB_DR_MODE_HOST;
107 if (IS_ENABLED(CONFIG_USB_DWC2_HOST))
108 mode = USB_DR_MODE_HOST;
109 else if (IS_ENABLED(CONFIG_USB_DWC2_PERIPHERAL))
110 mode = USB_DR_MODE_PERIPHERAL;
113 if (mode != hsotg->dr_mode) {
115 "Configuration mismatch. dr_mode forced to %s\n",
116 mode == USB_DR_MODE_HOST ? "host" : "device");
118 hsotg->dr_mode = mode;
124 static void __dwc2_disable_regulators(void *data)
126 struct dwc2_hsotg *hsotg = data;
128 regulator_bulk_disable(ARRAY_SIZE(hsotg->supplies), hsotg->supplies);
131 static int __dwc2_lowlevel_hw_enable(struct dwc2_hsotg *hsotg)
133 struct platform_device *pdev = to_platform_device(hsotg->dev);
136 ret = regulator_bulk_enable(ARRAY_SIZE(hsotg->supplies),
141 ret = devm_add_action_or_reset(&pdev->dev,
142 __dwc2_disable_regulators, hsotg);
147 ret = clk_prepare_enable(hsotg->clk);
153 ret = usb_phy_init(hsotg->uphy);
154 } else if (hsotg->plat && hsotg->plat->phy_init) {
155 ret = hsotg->plat->phy_init(pdev, hsotg->plat->phy_type);
157 ret = phy_power_on(hsotg->phy);
159 ret = phy_init(hsotg->phy);
166 * dwc2_lowlevel_hw_enable - enable platform lowlevel hw resources
167 * @hsotg: The driver state
169 * A wrapper for platform code responsible for controlling
170 * low-level USB platform resources (phy, clock, regulators)
172 int dwc2_lowlevel_hw_enable(struct dwc2_hsotg *hsotg)
174 int ret = __dwc2_lowlevel_hw_enable(hsotg);
177 hsotg->ll_hw_enabled = true;
181 static int __dwc2_lowlevel_hw_disable(struct dwc2_hsotg *hsotg)
183 struct platform_device *pdev = to_platform_device(hsotg->dev);
187 usb_phy_shutdown(hsotg->uphy);
188 } else if (hsotg->plat && hsotg->plat->phy_exit) {
189 ret = hsotg->plat->phy_exit(pdev, hsotg->plat->phy_type);
191 ret = phy_exit(hsotg->phy);
193 ret = phy_power_off(hsotg->phy);
199 clk_disable_unprepare(hsotg->clk);
205 * dwc2_lowlevel_hw_disable - disable platform lowlevel hw resources
206 * @hsotg: The driver state
208 * A wrapper for platform code responsible for controlling
209 * low-level USB platform resources (phy, clock, regulators)
211 int dwc2_lowlevel_hw_disable(struct dwc2_hsotg *hsotg)
213 int ret = __dwc2_lowlevel_hw_disable(hsotg);
216 hsotg->ll_hw_enabled = false;
220 static int dwc2_lowlevel_hw_init(struct dwc2_hsotg *hsotg)
224 hsotg->reset = devm_reset_control_get_optional(hsotg->dev, "dwc2");
225 if (IS_ERR(hsotg->reset)) {
226 ret = PTR_ERR(hsotg->reset);
227 dev_err(hsotg->dev, "error getting reset control %d\n", ret);
231 reset_control_deassert(hsotg->reset);
233 hsotg->reset_ecc = devm_reset_control_get_optional(hsotg->dev, "dwc2-ecc");
234 if (IS_ERR(hsotg->reset_ecc)) {
235 ret = PTR_ERR(hsotg->reset_ecc);
236 dev_err(hsotg->dev, "error getting reset control for ecc %d\n", ret);
240 reset_control_deassert(hsotg->reset_ecc);
243 * Attempt to find a generic PHY, then look for an old style
244 * USB PHY and then fall back to pdata
246 hsotg->phy = devm_phy_get(hsotg->dev, "usb2-phy");
247 if (IS_ERR(hsotg->phy)) {
248 ret = PTR_ERR(hsotg->phy);
257 dev_err(hsotg->dev, "error getting phy %d\n", ret);
263 hsotg->uphy = devm_usb_get_phy(hsotg->dev, USB_PHY_TYPE_USB2);
264 if (IS_ERR(hsotg->uphy)) {
265 ret = PTR_ERR(hsotg->uphy);
274 dev_err(hsotg->dev, "error getting usb phy %d\n",
281 hsotg->plat = dev_get_platdata(hsotg->dev);
284 hsotg->clk = devm_clk_get_optional(hsotg->dev, "otg");
285 if (IS_ERR(hsotg->clk)) {
286 dev_err(hsotg->dev, "cannot get otg clock\n");
287 return PTR_ERR(hsotg->clk);
291 for (i = 0; i < ARRAY_SIZE(hsotg->supplies); i++)
292 hsotg->supplies[i].supply = dwc2_hsotg_supply_names[i];
294 ret = devm_regulator_bulk_get(hsotg->dev, ARRAY_SIZE(hsotg->supplies),
297 if (ret != -EPROBE_DEFER)
298 dev_err(hsotg->dev, "failed to request supplies: %d\n",
306 * dwc2_driver_remove() - Called when the DWC_otg core is unregistered with the
309 * @dev: Platform device
311 * This routine is called, for example, when the rmmod command is executed. The
312 * device may or may not be electrically present. If it is present, the driver
313 * stops device processing. Any resources used on behalf of this device are
316 static int dwc2_driver_remove(struct platform_device *dev)
318 struct dwc2_hsotg *hsotg = platform_get_drvdata(dev);
319 struct dwc2_gregs_backup *gr;
322 gr = &hsotg->gr_backup;
324 /* Exit Hibernation when driver is removed. */
325 if (hsotg->hibernated) {
326 if (gr->gotgctl & GOTGCTL_CURMODE_HOST)
327 ret = dwc2_exit_hibernation(hsotg, 0, 0, 1);
329 ret = dwc2_exit_hibernation(hsotg, 0, 0, 0);
333 "exit hibernation failed.\n");
336 /* Exit Partial Power Down when driver is removed. */
338 ret = dwc2_exit_partial_power_down(hsotg, 0, true);
341 "exit partial_power_down failed\n");
344 /* Exit clock gating when driver is removed. */
345 if (hsotg->params.power_down == DWC2_POWER_DOWN_PARAM_NONE &&
346 hsotg->bus_suspended) {
347 if (dwc2_is_device_mode(hsotg))
348 dwc2_gadget_exit_clock_gating(hsotg, 0);
350 dwc2_host_exit_clock_gating(hsotg, 0);
353 dwc2_debugfs_exit(hsotg);
354 if (hsotg->hcd_enabled)
355 dwc2_hcd_remove(hsotg);
356 if (hsotg->gadget_enabled)
357 dwc2_hsotg_remove(hsotg);
359 dwc2_drd_exit(hsotg);
361 if (hsotg->params.activate_stm_id_vb_detection)
362 regulator_disable(hsotg->usb33d);
364 if (hsotg->ll_hw_enabled)
365 dwc2_lowlevel_hw_disable(hsotg);
367 reset_control_assert(hsotg->reset);
368 reset_control_assert(hsotg->reset_ecc);
374 * dwc2_driver_shutdown() - Called on device shutdown
376 * @dev: Platform device
378 * In specific conditions (involving usb hubs) dwc2 devices can create a
379 * lot of interrupts, even to the point of overwhelming devices running
380 * at low frequencies. Some devices need to do special clock handling
381 * at shutdown-time which may bring the system clock below the threshold
382 * of being able to handle the dwc2 interrupts. Disabling dwc2-irqs
383 * prevents reboots/poweroffs from getting stuck in such cases.
385 static void dwc2_driver_shutdown(struct platform_device *dev)
387 struct dwc2_hsotg *hsotg = platform_get_drvdata(dev);
389 dwc2_disable_global_interrupts(hsotg);
390 synchronize_irq(hsotg->irq);
394 * dwc2_check_core_endianness() - Returns true if core and AHB have
395 * opposite endianness.
396 * @hsotg: Programming view of the DWC_otg controller.
398 static bool dwc2_check_core_endianness(struct dwc2_hsotg *hsotg)
402 snpsid = ioread32(hsotg->regs + GSNPSID);
403 if ((snpsid & GSNPSID_ID_MASK) == DWC2_OTG_ID ||
404 (snpsid & GSNPSID_ID_MASK) == DWC2_FS_IOT_ID ||
405 (snpsid & GSNPSID_ID_MASK) == DWC2_HS_IOT_ID)
411 * dwc2_check_core_version() - Check core version
413 * @hsotg: Programming view of the DWC_otg controller
416 int dwc2_check_core_version(struct dwc2_hsotg *hsotg)
418 struct dwc2_hw_params *hw = &hsotg->hw_params;
421 * Attempt to ensure this device is really a DWC_otg Controller.
422 * Read and verify the GSNPSID register contents. The value should be
423 * 0x45f4xxxx, 0x5531xxxx or 0x5532xxxx
426 hw->snpsid = dwc2_readl(hsotg, GSNPSID);
427 if ((hw->snpsid & GSNPSID_ID_MASK) != DWC2_OTG_ID &&
428 (hw->snpsid & GSNPSID_ID_MASK) != DWC2_FS_IOT_ID &&
429 (hw->snpsid & GSNPSID_ID_MASK) != DWC2_HS_IOT_ID) {
430 dev_err(hsotg->dev, "Bad value for GSNPSID: 0x%08x\n",
435 dev_dbg(hsotg->dev, "Core Release: %1x.%1x%1x%1x (snpsid=%x)\n",
436 hw->snpsid >> 12 & 0xf, hw->snpsid >> 8 & 0xf,
437 hw->snpsid >> 4 & 0xf, hw->snpsid & 0xf, hw->snpsid);
442 * dwc2_driver_probe() - Called when the DWC_otg core is bound to the DWC_otg
445 * @dev: Platform device
447 * This routine creates the driver components required to control the device
448 * (core, HCD, and PCD) and initializes the device. The driver components are
449 * stored in a dwc2_hsotg structure. A reference to the dwc2_hsotg is saved
450 * in the device private data. This allows the driver to access the dwc2_hsotg
451 * structure on subsequent calls to driver methods for this device.
453 static int dwc2_driver_probe(struct platform_device *dev)
455 struct dwc2_hsotg *hsotg;
456 struct resource *res;
459 hsotg = devm_kzalloc(&dev->dev, sizeof(*hsotg), GFP_KERNEL);
463 hsotg->dev = &dev->dev;
466 * Use reasonable defaults so platforms don't have to provide these.
468 if (!dev->dev.dma_mask)
469 dev->dev.dma_mask = &dev->dev.coherent_dma_mask;
470 retval = dma_set_coherent_mask(&dev->dev, DMA_BIT_MASK(32));
472 dev_err(&dev->dev, "can't set coherent DMA mask: %d\n", retval);
476 hsotg->regs = devm_platform_get_and_ioremap_resource(dev, 0, &res);
477 if (IS_ERR(hsotg->regs))
478 return PTR_ERR(hsotg->regs);
480 dev_dbg(&dev->dev, "mapped PA %08lx to VA %p\n",
481 (unsigned long)res->start, hsotg->regs);
483 retval = dwc2_lowlevel_hw_init(hsotg);
487 spin_lock_init(&hsotg->lock);
489 hsotg->irq = platform_get_irq(dev, 0);
493 dev_dbg(hsotg->dev, "registering common handler for irq%d\n",
495 retval = devm_request_irq(hsotg->dev, hsotg->irq,
496 dwc2_handle_common_intr, IRQF_SHARED,
497 dev_name(hsotg->dev), hsotg);
501 hsotg->vbus_supply = devm_regulator_get_optional(hsotg->dev, "vbus");
502 if (IS_ERR(hsotg->vbus_supply)) {
503 retval = PTR_ERR(hsotg->vbus_supply);
504 hsotg->vbus_supply = NULL;
505 if (retval != -ENODEV)
509 retval = dwc2_lowlevel_hw_enable(hsotg);
513 hsotg->needs_byte_swap = dwc2_check_core_endianness(hsotg);
515 retval = dwc2_get_dr_mode(hsotg);
519 hsotg->need_phy_for_wake =
520 of_property_read_bool(dev->dev.of_node,
521 "snps,need-phy-for-wake");
524 * Before performing any core related operations
525 * check core version.
527 retval = dwc2_check_core_version(hsotg);
532 * Reset before dwc2_get_hwparams() then it could get power-on real
533 * reset value form registers.
535 retval = dwc2_core_reset(hsotg, false);
539 /* Detect config values from hardware */
540 retval = dwc2_get_hwparams(hsotg);
545 * For OTG cores, set the force mode bits to reflect the value
546 * of dr_mode. Force mode bits should not be touched at any
547 * other time after this.
549 dwc2_force_dr_mode(hsotg);
551 retval = dwc2_init_params(hsotg);
555 if (hsotg->params.activate_stm_id_vb_detection) {
558 hsotg->usb33d = devm_regulator_get(hsotg->dev, "usb33d");
559 if (IS_ERR(hsotg->usb33d)) {
560 retval = PTR_ERR(hsotg->usb33d);
561 if (retval != -EPROBE_DEFER)
563 "failed to request usb33d supply: %d\n",
567 retval = regulator_enable(hsotg->usb33d);
570 "failed to enable usb33d supply: %d\n", retval);
574 ggpio = dwc2_readl(hsotg, GGPIO);
575 ggpio |= GGPIO_STM32_OTG_GCCFG_IDEN;
576 ggpio |= GGPIO_STM32_OTG_GCCFG_VBDEN;
577 dwc2_writel(hsotg, ggpio, GGPIO);
580 retval = dwc2_drd_init(hsotg);
582 if (retval != -EPROBE_DEFER)
583 dev_err(hsotg->dev, "failed to initialize dual-role\n");
587 if (hsotg->dr_mode != USB_DR_MODE_HOST) {
588 retval = dwc2_gadget_init(hsotg);
591 hsotg->gadget_enabled = 1;
595 * If we need PHY for wakeup we must be wakeup capable.
596 * When we have a device that can wake without the PHY we
597 * can adjust this condition.
599 if (hsotg->need_phy_for_wake)
600 device_set_wakeup_capable(&dev->dev, true);
602 hsotg->reset_phy_on_wake =
603 of_property_read_bool(dev->dev.of_node,
604 "snps,reset-phy-on-wake");
605 if (hsotg->reset_phy_on_wake && !hsotg->phy) {
607 "Quirk reset-phy-on-wake only supports generic PHYs\n");
608 hsotg->reset_phy_on_wake = false;
611 if (hsotg->dr_mode != USB_DR_MODE_PERIPHERAL) {
612 retval = dwc2_hcd_init(hsotg);
614 if (hsotg->gadget_enabled)
615 dwc2_hsotg_remove(hsotg);
618 hsotg->hcd_enabled = 1;
621 platform_set_drvdata(dev, hsotg);
622 hsotg->hibernated = 0;
624 dwc2_debugfs_init(hsotg);
626 /* Gadget code manages lowlevel hw on its own */
627 if (hsotg->dr_mode == USB_DR_MODE_PERIPHERAL)
628 dwc2_lowlevel_hw_disable(hsotg);
630 #if IS_ENABLED(CONFIG_USB_DWC2_PERIPHERAL) || \
631 IS_ENABLED(CONFIG_USB_DWC2_DUAL_ROLE)
632 /* Postponed adding a new gadget to the udc class driver list */
633 if (hsotg->gadget_enabled) {
634 retval = usb_add_gadget_udc(hsotg->dev, &hsotg->gadget);
636 hsotg->gadget.udc = NULL;
637 dwc2_hsotg_remove(hsotg);
641 #endif /* CONFIG_USB_DWC2_PERIPHERAL || CONFIG_USB_DWC2_DUAL_ROLE */
644 #if IS_ENABLED(CONFIG_USB_DWC2_PERIPHERAL) || \
645 IS_ENABLED(CONFIG_USB_DWC2_DUAL_ROLE)
647 dwc2_debugfs_exit(hsotg);
648 if (hsotg->hcd_enabled)
649 dwc2_hcd_remove(hsotg);
652 dwc2_drd_exit(hsotg);
655 if (hsotg->params.activate_stm_id_vb_detection)
656 regulator_disable(hsotg->usb33d);
658 if (hsotg->dr_mode != USB_DR_MODE_PERIPHERAL)
659 dwc2_lowlevel_hw_disable(hsotg);
663 static int __maybe_unused dwc2_suspend(struct device *dev)
665 struct dwc2_hsotg *dwc2 = dev_get_drvdata(dev);
666 bool is_device_mode = dwc2_is_device_mode(dwc2);
670 dwc2_hsotg_suspend(dwc2);
672 dwc2_drd_suspend(dwc2);
674 if (dwc2->params.activate_stm_id_vb_detection) {
679 * Need to force the mode to the current mode to avoid Mode
680 * Mismatch Interrupt when ID detection will be disabled.
682 dwc2_force_mode(dwc2, !is_device_mode);
684 spin_lock_irqsave(&dwc2->lock, flags);
685 gotgctl = dwc2_readl(dwc2, GOTGCTL);
686 /* bypass debounce filter, enable overrides */
687 gotgctl |= GOTGCTL_DBNCE_FLTR_BYPASS;
688 gotgctl |= GOTGCTL_BVALOEN | GOTGCTL_AVALOEN;
689 /* Force A / B session if needed */
690 if (gotgctl & GOTGCTL_ASESVLD)
691 gotgctl |= GOTGCTL_AVALOVAL;
692 if (gotgctl & GOTGCTL_BSESVLD)
693 gotgctl |= GOTGCTL_BVALOVAL;
694 dwc2_writel(dwc2, gotgctl, GOTGCTL);
695 spin_unlock_irqrestore(&dwc2->lock, flags);
697 ggpio = dwc2_readl(dwc2, GGPIO);
698 ggpio &= ~GGPIO_STM32_OTG_GCCFG_IDEN;
699 ggpio &= ~GGPIO_STM32_OTG_GCCFG_VBDEN;
700 dwc2_writel(dwc2, ggpio, GGPIO);
702 regulator_disable(dwc2->usb33d);
705 if (dwc2->ll_hw_enabled &&
706 (is_device_mode || dwc2_host_can_poweroff_phy(dwc2))) {
707 ret = __dwc2_lowlevel_hw_disable(dwc2);
708 dwc2->phy_off_for_suspend = true;
714 static int __maybe_unused dwc2_resume(struct device *dev)
716 struct dwc2_hsotg *dwc2 = dev_get_drvdata(dev);
719 if (dwc2->phy_off_for_suspend && dwc2->ll_hw_enabled) {
720 ret = __dwc2_lowlevel_hw_enable(dwc2);
724 dwc2->phy_off_for_suspend = false;
726 if (dwc2->params.activate_stm_id_vb_detection) {
730 ret = regulator_enable(dwc2->usb33d);
734 ggpio = dwc2_readl(dwc2, GGPIO);
735 ggpio |= GGPIO_STM32_OTG_GCCFG_IDEN;
736 ggpio |= GGPIO_STM32_OTG_GCCFG_VBDEN;
737 dwc2_writel(dwc2, ggpio, GGPIO);
739 /* ID/VBUS detection startup time */
740 usleep_range(5000, 7000);
742 spin_lock_irqsave(&dwc2->lock, flags);
743 gotgctl = dwc2_readl(dwc2, GOTGCTL);
744 gotgctl &= ~GOTGCTL_DBNCE_FLTR_BYPASS;
745 gotgctl &= ~(GOTGCTL_BVALOEN | GOTGCTL_AVALOEN |
746 GOTGCTL_BVALOVAL | GOTGCTL_AVALOVAL);
747 dwc2_writel(dwc2, gotgctl, GOTGCTL);
748 spin_unlock_irqrestore(&dwc2->lock, flags);
751 /* Need to restore FORCEDEVMODE/FORCEHOSTMODE */
752 dwc2_force_dr_mode(dwc2);
754 dwc2_drd_resume(dwc2);
756 if (dwc2_is_device_mode(dwc2))
757 ret = dwc2_hsotg_resume(dwc2);
762 static const struct dev_pm_ops dwc2_dev_pm_ops = {
763 SET_SYSTEM_SLEEP_PM_OPS(dwc2_suspend, dwc2_resume)
766 static struct platform_driver dwc2_platform_driver = {
768 .name = dwc2_driver_name,
769 .of_match_table = dwc2_of_match_table,
770 .acpi_match_table = ACPI_PTR(dwc2_acpi_match),
771 .pm = &dwc2_dev_pm_ops,
773 .probe = dwc2_driver_probe,
774 .remove = dwc2_driver_remove,
775 .shutdown = dwc2_driver_shutdown,
778 module_platform_driver(dwc2_platform_driver);