2 * platform.c - DesignWare HS OTG Controller platform driver
4 * Copyright (C) Matthijs Kooijman <matthijs@stdin.nl>
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
9 * 1. Redistributions of source code must retain the above copyright
10 * notice, this list of conditions, and the following disclaimer,
11 * without modification.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
15 * 3. The names of the above-listed copyright holders may not be used
16 * to endorse or promote products derived from this software without
17 * specific prior written permission.
19 * ALTERNATIVELY, this software may be distributed under the terms of the
20 * GNU General Public License ("GPL") as published by the Free Software
21 * Foundation; either version 2 of the License, or (at your option) any
24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
25 * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
26 * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
27 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
28 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
29 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
30 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
31 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
32 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
33 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
34 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
37 #include <linux/kernel.h>
38 #include <linux/module.h>
39 #include <linux/slab.h>
40 #include <linux/clk.h>
41 #include <linux/device.h>
42 #include <linux/dma-mapping.h>
43 #include <linux/of_device.h>
44 #include <linux/mutex.h>
45 #include <linux/platform_device.h>
46 #include <linux/phy/phy.h>
47 #include <linux/platform_data/s3c-hsotg.h>
49 #include <linux/usb/of.h>
55 static const char dwc2_driver_name
[] = "dwc2";
57 static const struct dwc2_core_params params_hi6220
= {
58 .otg_cap
= 2, /* No HNP/SRP capable */
59 .otg_ver
= 0, /* 1.3 */
62 .dma_desc_fs_enable
= 0,
63 .speed
= 0, /* High Speed */
64 .enable_dynamic_fifo
= 1,
65 .en_multiple_tx_fifo
= 1,
66 .host_rx_fifo_size
= 512,
67 .host_nperio_tx_fifo_size
= 512,
68 .host_perio_tx_fifo_size
= 512,
69 .max_transfer_size
= 65535,
70 .max_packet_count
= 511,
72 .phy_type
= 1, /* UTMI */
74 .phy_ulpi_ddr
= 0, /* Single */
75 .phy_ulpi_ext_vbus
= 0,
78 .host_support_fs_ls_low_power
= 0,
79 .host_ls_low_power_phy_clk
= 0, /* 48 MHz */
82 .ahbcfg
= GAHBCFG_HBSTLEN_INCR16
<<
83 GAHBCFG_HBSTLEN_SHIFT
,
85 .external_id_pin_ctl
= -1,
89 static const struct dwc2_core_params params_bcm2835
= {
90 .otg_cap
= 0, /* HNP/SRP capable */
91 .otg_ver
= 0, /* 1.3 */
94 .dma_desc_fs_enable
= 0,
95 .speed
= 0, /* High Speed */
96 .enable_dynamic_fifo
= 1,
97 .en_multiple_tx_fifo
= 1,
98 .host_rx_fifo_size
= 774, /* 774 DWORDs */
99 .host_nperio_tx_fifo_size
= 256, /* 256 DWORDs */
100 .host_perio_tx_fifo_size
= 512, /* 512 DWORDs */
101 .max_transfer_size
= 65535,
102 .max_packet_count
= 511,
104 .phy_type
= 1, /* UTMI */
105 .phy_utmi_width
= 8, /* 8 bits */
106 .phy_ulpi_ddr
= 0, /* Single */
107 .phy_ulpi_ext_vbus
= 0,
110 .host_support_fs_ls_low_power
= 0,
111 .host_ls_low_power_phy_clk
= 0, /* 48 MHz */
116 .external_id_pin_ctl
= -1,
120 static const struct dwc2_core_params params_rk3066
= {
121 .otg_cap
= 2, /* non-HNP/non-SRP */
124 .dma_desc_enable
= 0,
125 .dma_desc_fs_enable
= 0,
127 .enable_dynamic_fifo
= 1,
128 .en_multiple_tx_fifo
= -1,
129 .host_rx_fifo_size
= 525, /* 525 DWORDs */
130 .host_nperio_tx_fifo_size
= 128, /* 128 DWORDs */
131 .host_perio_tx_fifo_size
= 256, /* 256 DWORDs */
132 .max_transfer_size
= -1,
133 .max_packet_count
= -1,
136 .phy_utmi_width
= -1,
138 .phy_ulpi_ext_vbus
= -1,
141 .host_support_fs_ls_low_power
= -1,
142 .host_ls_low_power_phy_clk
= -1,
145 .ahbcfg
= GAHBCFG_HBSTLEN_INCR16
<<
146 GAHBCFG_HBSTLEN_SHIFT
,
148 .external_id_pin_ctl
= -1,
152 static const struct dwc2_core_params params_ltq
= {
153 .otg_cap
= 2, /* non-HNP/non-SRP */
156 .dma_desc_enable
= -1,
157 .dma_desc_fs_enable
= -1,
159 .enable_dynamic_fifo
= -1,
160 .en_multiple_tx_fifo
= -1,
161 .host_rx_fifo_size
= 288, /* 288 DWORDs */
162 .host_nperio_tx_fifo_size
= 128, /* 128 DWORDs */
163 .host_perio_tx_fifo_size
= 96, /* 96 DWORDs */
164 .max_transfer_size
= 65535,
165 .max_packet_count
= 511,
168 .phy_utmi_width
= -1,
170 .phy_ulpi_ext_vbus
= -1,
173 .host_support_fs_ls_low_power
= -1,
174 .host_ls_low_power_phy_clk
= -1,
177 .ahbcfg
= GAHBCFG_HBSTLEN_INCR16
<<
178 GAHBCFG_HBSTLEN_SHIFT
,
180 .external_id_pin_ctl
= -1,
185 * Check the dr_mode against the module configuration and hardware
188 * The hardware, module, and dr_mode, can each be set to host, device,
189 * or otg. Check that all these values are compatible and adjust the
190 * value of dr_mode if possible.
193 * HW MOD dr_mode dr_mode
194 * ------------------------------
205 * OTG OTG any : dr_mode
207 static int dwc2_get_dr_mode(struct dwc2_hsotg
*hsotg
)
209 enum usb_dr_mode mode
;
211 hsotg
->dr_mode
= usb_get_dr_mode(hsotg
->dev
);
212 if (hsotg
->dr_mode
== USB_DR_MODE_UNKNOWN
)
213 hsotg
->dr_mode
= USB_DR_MODE_OTG
;
215 mode
= hsotg
->dr_mode
;
217 if (dwc2_hw_is_device(hsotg
)) {
218 if (IS_ENABLED(CONFIG_USB_DWC2_HOST
)) {
220 "Controller does not support host mode.\n");
223 mode
= USB_DR_MODE_PERIPHERAL
;
224 } else if (dwc2_hw_is_host(hsotg
)) {
225 if (IS_ENABLED(CONFIG_USB_DWC2_PERIPHERAL
)) {
227 "Controller does not support device mode.\n");
230 mode
= USB_DR_MODE_HOST
;
232 if (IS_ENABLED(CONFIG_USB_DWC2_HOST
))
233 mode
= USB_DR_MODE_HOST
;
234 else if (IS_ENABLED(CONFIG_USB_DWC2_PERIPHERAL
))
235 mode
= USB_DR_MODE_PERIPHERAL
;
238 if (mode
!= hsotg
->dr_mode
) {
240 "Configuration mismatch. dr_mode forced to %s\n",
241 mode
== USB_DR_MODE_HOST
? "host" : "device");
243 hsotg
->dr_mode
= mode
;
249 static int __dwc2_lowlevel_hw_enable(struct dwc2_hsotg
*hsotg
)
251 struct platform_device
*pdev
= to_platform_device(hsotg
->dev
);
254 ret
= regulator_bulk_enable(ARRAY_SIZE(hsotg
->supplies
),
260 ret
= clk_prepare_enable(hsotg
->clk
);
266 ret
= usb_phy_init(hsotg
->uphy
);
267 else if (hsotg
->plat
&& hsotg
->plat
->phy_init
)
268 ret
= hsotg
->plat
->phy_init(pdev
, hsotg
->plat
->phy_type
);
270 ret
= phy_power_on(hsotg
->phy
);
272 ret
= phy_init(hsotg
->phy
);
279 * dwc2_lowlevel_hw_enable - enable platform lowlevel hw resources
280 * @hsotg: The driver state
282 * A wrapper for platform code responsible for controlling
283 * low-level USB platform resources (phy, clock, regulators)
285 int dwc2_lowlevel_hw_enable(struct dwc2_hsotg
*hsotg
)
287 int ret
= __dwc2_lowlevel_hw_enable(hsotg
);
290 hsotg
->ll_hw_enabled
= true;
294 static int __dwc2_lowlevel_hw_disable(struct dwc2_hsotg
*hsotg
)
296 struct platform_device
*pdev
= to_platform_device(hsotg
->dev
);
300 usb_phy_shutdown(hsotg
->uphy
);
301 else if (hsotg
->plat
&& hsotg
->plat
->phy_exit
)
302 ret
= hsotg
->plat
->phy_exit(pdev
, hsotg
->plat
->phy_type
);
304 ret
= phy_exit(hsotg
->phy
);
306 ret
= phy_power_off(hsotg
->phy
);
312 clk_disable_unprepare(hsotg
->clk
);
314 ret
= regulator_bulk_disable(ARRAY_SIZE(hsotg
->supplies
),
321 * dwc2_lowlevel_hw_disable - disable platform lowlevel hw resources
322 * @hsotg: The driver state
324 * A wrapper for platform code responsible for controlling
325 * low-level USB platform resources (phy, clock, regulators)
327 int dwc2_lowlevel_hw_disable(struct dwc2_hsotg
*hsotg
)
329 int ret
= __dwc2_lowlevel_hw_disable(hsotg
);
332 hsotg
->ll_hw_enabled
= false;
336 static int dwc2_lowlevel_hw_init(struct dwc2_hsotg
*hsotg
)
340 /* Set default UTMI width */
341 hsotg
->phyif
= GUSBCFG_PHYIF16
;
344 * Attempt to find a generic PHY, then look for an old style
345 * USB PHY and then fall back to pdata
347 hsotg
->phy
= devm_phy_get(hsotg
->dev
, "usb2-phy");
348 if (IS_ERR(hsotg
->phy
)) {
349 ret
= PTR_ERR(hsotg
->phy
);
358 dev_err(hsotg
->dev
, "error getting phy %d\n", ret
);
364 hsotg
->uphy
= devm_usb_get_phy(hsotg
->dev
, USB_PHY_TYPE_USB2
);
365 if (IS_ERR(hsotg
->uphy
)) {
366 ret
= PTR_ERR(hsotg
->uphy
);
375 dev_err(hsotg
->dev
, "error getting usb phy %d\n",
382 hsotg
->plat
= dev_get_platdata(hsotg
->dev
);
386 * If using the generic PHY framework, check if the PHY bus
387 * width is 8-bit and set the phyif appropriately.
389 if (phy_get_bus_width(hsotg
->phy
) == 8)
390 hsotg
->phyif
= GUSBCFG_PHYIF8
;
394 hsotg
->clk
= devm_clk_get(hsotg
->dev
, "otg");
395 if (IS_ERR(hsotg
->clk
)) {
397 dev_dbg(hsotg
->dev
, "cannot get otg clock\n");
401 for (i
= 0; i
< ARRAY_SIZE(hsotg
->supplies
); i
++)
402 hsotg
->supplies
[i
].supply
= dwc2_hsotg_supply_names
[i
];
404 ret
= devm_regulator_bulk_get(hsotg
->dev
, ARRAY_SIZE(hsotg
->supplies
),
407 dev_err(hsotg
->dev
, "failed to request supplies: %d\n", ret
);
414 * dwc2_driver_remove() - Called when the DWC_otg core is unregistered with the
417 * @dev: Platform device
419 * This routine is called, for example, when the rmmod command is executed. The
420 * device may or may not be electrically present. If it is present, the driver
421 * stops device processing. Any resources used on behalf of this device are
424 static int dwc2_driver_remove(struct platform_device
*dev
)
426 struct dwc2_hsotg
*hsotg
= platform_get_drvdata(dev
);
428 dwc2_debugfs_exit(hsotg
);
429 if (hsotg
->hcd_enabled
)
430 dwc2_hcd_remove(hsotg
);
431 if (hsotg
->gadget_enabled
)
432 dwc2_hsotg_remove(hsotg
);
434 if (hsotg
->ll_hw_enabled
)
435 dwc2_lowlevel_hw_disable(hsotg
);
441 * dwc2_driver_shutdown() - Called on device shutdown
443 * @dev: Platform device
445 * In specific conditions (involving usb hubs) dwc2 devices can create a
446 * lot of interrupts, even to the point of overwhelming devices running
447 * at low frequencies. Some devices need to do special clock handling
448 * at shutdown-time which may bring the system clock below the threshold
449 * of being able to handle the dwc2 interrupts. Disabling dwc2-irqs
450 * prevents reboots/poweroffs from getting stuck in such cases.
452 static void dwc2_driver_shutdown(struct platform_device
*dev
)
454 struct dwc2_hsotg
*hsotg
= platform_get_drvdata(dev
);
456 disable_irq(hsotg
->irq
);
459 static const struct of_device_id dwc2_of_match_table
[] = {
460 { .compatible
= "brcm,bcm2835-usb", .data
= ¶ms_bcm2835
},
461 { .compatible
= "hisilicon,hi6220-usb", .data
= ¶ms_hi6220
},
462 { .compatible
= "rockchip,rk3066-usb", .data
= ¶ms_rk3066
},
463 { .compatible
= "lantiq,arx100-usb", .data
= ¶ms_ltq
},
464 { .compatible
= "lantiq,xrx200-usb", .data
= ¶ms_ltq
},
465 { .compatible
= "snps,dwc2", .data
= NULL
},
466 { .compatible
= "samsung,s3c6400-hsotg", .data
= NULL
},
469 MODULE_DEVICE_TABLE(of
, dwc2_of_match_table
);
472 * dwc2_driver_probe() - Called when the DWC_otg core is bound to the DWC_otg
475 * @dev: Platform device
477 * This routine creates the driver components required to control the device
478 * (core, HCD, and PCD) and initializes the device. The driver components are
479 * stored in a dwc2_hsotg structure. A reference to the dwc2_hsotg is saved
480 * in the device private data. This allows the driver to access the dwc2_hsotg
481 * structure on subsequent calls to driver methods for this device.
483 static int dwc2_driver_probe(struct platform_device
*dev
)
485 const struct of_device_id
*match
;
486 const struct dwc2_core_params
*params
;
487 struct dwc2_core_params defparams
;
488 struct dwc2_hsotg
*hsotg
;
489 struct resource
*res
;
492 match
= of_match_device(dwc2_of_match_table
, &dev
->dev
);
493 if (match
&& match
->data
) {
494 params
= match
->data
;
496 /* Default all params to autodetect */
497 dwc2_set_all_params(&defparams
, -1);
501 * Disable descriptor dma mode by default as the HW can support
502 * it, but does not support it for SPLIT transactions.
503 * Disable it for FS devices as well.
505 defparams
.dma_desc_enable
= 0;
506 defparams
.dma_desc_fs_enable
= 0;
509 hsotg
= devm_kzalloc(&dev
->dev
, sizeof(*hsotg
), GFP_KERNEL
);
513 hsotg
->dev
= &dev
->dev
;
516 * Use reasonable defaults so platforms don't have to provide these.
518 if (!dev
->dev
.dma_mask
)
519 dev
->dev
.dma_mask
= &dev
->dev
.coherent_dma_mask
;
520 retval
= dma_set_coherent_mask(&dev
->dev
, DMA_BIT_MASK(32));
524 res
= platform_get_resource(dev
, IORESOURCE_MEM
, 0);
525 hsotg
->regs
= devm_ioremap_resource(&dev
->dev
, res
);
526 if (IS_ERR(hsotg
->regs
))
527 return PTR_ERR(hsotg
->regs
);
529 dev_dbg(&dev
->dev
, "mapped PA %08lx to VA %p\n",
530 (unsigned long)res
->start
, hsotg
->regs
);
532 retval
= dwc2_lowlevel_hw_init(hsotg
);
536 spin_lock_init(&hsotg
->lock
);
538 hsotg
->core_params
= devm_kzalloc(&dev
->dev
,
539 sizeof(*hsotg
->core_params
), GFP_KERNEL
);
540 if (!hsotg
->core_params
)
543 dwc2_set_all_params(hsotg
->core_params
, -1);
545 hsotg
->irq
= platform_get_irq(dev
, 0);
546 if (hsotg
->irq
< 0) {
547 dev_err(&dev
->dev
, "missing IRQ resource\n");
551 dev_dbg(hsotg
->dev
, "registering common handler for irq%d\n",
553 retval
= devm_request_irq(hsotg
->dev
, hsotg
->irq
,
554 dwc2_handle_common_intr
, IRQF_SHARED
,
555 dev_name(hsotg
->dev
), hsotg
);
559 retval
= dwc2_lowlevel_hw_enable(hsotg
);
563 retval
= dwc2_get_dr_mode(hsotg
);
568 * Reset before dwc2_get_hwparams() then it could get power-on real
569 * reset value form registers.
571 dwc2_core_reset_and_force_dr_mode(hsotg
);
573 /* Detect config values from hardware */
574 retval
= dwc2_get_hwparams(hsotg
);
578 /* Validate parameter values */
579 dwc2_set_parameters(hsotg
, params
);
581 dwc2_force_dr_mode(hsotg
);
583 if (hsotg
->dr_mode
!= USB_DR_MODE_HOST
) {
584 retval
= dwc2_gadget_init(hsotg
, hsotg
->irq
);
587 hsotg
->gadget_enabled
= 1;
590 if (hsotg
->dr_mode
!= USB_DR_MODE_PERIPHERAL
) {
591 retval
= dwc2_hcd_init(hsotg
, hsotg
->irq
);
593 if (hsotg
->gadget_enabled
)
594 dwc2_hsotg_remove(hsotg
);
597 hsotg
->hcd_enabled
= 1;
600 platform_set_drvdata(dev
, hsotg
);
602 dwc2_debugfs_init(hsotg
);
604 /* Gadget code manages lowlevel hw on its own */
605 if (hsotg
->dr_mode
== USB_DR_MODE_PERIPHERAL
)
606 dwc2_lowlevel_hw_disable(hsotg
);
611 dwc2_lowlevel_hw_disable(hsotg
);
615 static int __maybe_unused
dwc2_suspend(struct device
*dev
)
617 struct dwc2_hsotg
*dwc2
= dev_get_drvdata(dev
);
620 if (dwc2_is_device_mode(dwc2
))
621 dwc2_hsotg_suspend(dwc2
);
623 if (dwc2
->ll_hw_enabled
)
624 ret
= __dwc2_lowlevel_hw_disable(dwc2
);
629 static int __maybe_unused
dwc2_resume(struct device
*dev
)
631 struct dwc2_hsotg
*dwc2
= dev_get_drvdata(dev
);
634 if (dwc2
->ll_hw_enabled
) {
635 ret
= __dwc2_lowlevel_hw_enable(dwc2
);
640 if (dwc2_is_device_mode(dwc2
))
641 ret
= dwc2_hsotg_resume(dwc2
);
646 static const struct dev_pm_ops dwc2_dev_pm_ops
= {
647 SET_SYSTEM_SLEEP_PM_OPS(dwc2_suspend
, dwc2_resume
)
650 static struct platform_driver dwc2_platform_driver
= {
652 .name
= dwc2_driver_name
,
653 .of_match_table
= dwc2_of_match_table
,
654 .pm
= &dwc2_dev_pm_ops
,
656 .probe
= dwc2_driver_probe
,
657 .remove
= dwc2_driver_remove
,
658 .shutdown
= dwc2_driver_shutdown
,
661 module_platform_driver(dwc2_platform_driver
);
663 MODULE_DESCRIPTION("DESIGNWARE HS OTG Platform Glue");
664 MODULE_AUTHOR("Matthijs Kooijman <matthijs@stdin.nl>");
665 MODULE_LICENSE("Dual BSD/GPL");