1 // SPDX-License-Identifier: GPL-2.0
3 * Cadence USBSS DRD Driver.
5 * Copyright (C) 2018-2019 Cadence.
6 * Copyright (C) 2017-2018 NXP
7 * Copyright (C) 2019 Texas Instruments
9 * Author: Peter Chen <peter.chen@nxp.com>
10 * Pawel Laszczak <pawell@cadence.com>
11 * Roger Quadros <rogerq@ti.com>
14 #include <linux/dma-mapping.h>
15 #include <linux/module.h>
16 #include <linux/kernel.h>
17 #include <linux/platform_device.h>
18 #include <linux/interrupt.h>
20 #include <linux/pm_runtime.h>
24 #include "host-export.h"
25 #include "gadget-export.h"
28 static int cdns3_idle_init(struct cdns3
*cdns
);
31 struct cdns3_role_driver
*cdns3_get_current_role_driver(struct cdns3
*cdns
)
33 WARN_ON(!cdns
->roles
[cdns
->role
]);
34 return cdns
->roles
[cdns
->role
];
37 static int cdns3_role_start(struct cdns3
*cdns
, enum usb_role role
)
41 if (WARN_ON(role
> USB_ROLE_DEVICE
))
44 mutex_lock(&cdns
->mutex
);
46 mutex_unlock(&cdns
->mutex
);
48 if (!cdns
->roles
[role
])
51 if (cdns
->roles
[role
]->state
== CDNS3_ROLE_STATE_ACTIVE
)
54 mutex_lock(&cdns
->mutex
);
55 ret
= cdns
->roles
[role
]->start(cdns
);
57 cdns
->roles
[role
]->state
= CDNS3_ROLE_STATE_ACTIVE
;
58 mutex_unlock(&cdns
->mutex
);
63 static void cdns3_role_stop(struct cdns3
*cdns
)
65 enum usb_role role
= cdns
->role
;
67 if (WARN_ON(role
> USB_ROLE_DEVICE
))
70 if (cdns
->roles
[role
]->state
== CDNS3_ROLE_STATE_INACTIVE
)
73 mutex_lock(&cdns
->mutex
);
74 cdns
->roles
[role
]->stop(cdns
);
75 cdns
->roles
[role
]->state
= CDNS3_ROLE_STATE_INACTIVE
;
76 mutex_unlock(&cdns
->mutex
);
79 static void cdns3_exit_roles(struct cdns3
*cdns
)
81 cdns3_role_stop(cdns
);
85 static enum usb_role
cdsn3_hw_role_state_machine(struct cdns3
*cdns
);
88 * cdns3_core_init_role - initialize role of operation
89 * @cdns: Pointer to cdns3 structure
91 * Returns 0 on success otherwise negative errno
93 static int cdns3_core_init_role(struct cdns3
*cdns
)
95 struct device
*dev
= cdns
->dev
;
96 enum usb_dr_mode best_dr_mode
;
97 enum usb_dr_mode dr_mode
;
100 dr_mode
= usb_get_dr_mode(dev
);
101 cdns
->role
= USB_ROLE_NONE
;
104 * If driver can't read mode by means of usb_get_dr_mode function then
105 * chooses mode according with Kernel configuration. This setting
106 * can be restricted later depending on strap pin configuration.
108 if (dr_mode
== USB_DR_MODE_UNKNOWN
) {
109 if (IS_ENABLED(CONFIG_USB_CDNS3_HOST
) &&
110 IS_ENABLED(CONFIG_USB_CDNS3_GADGET
))
111 dr_mode
= USB_DR_MODE_OTG
;
112 else if (IS_ENABLED(CONFIG_USB_CDNS3_HOST
))
113 dr_mode
= USB_DR_MODE_HOST
;
114 else if (IS_ENABLED(CONFIG_USB_CDNS3_GADGET
))
115 dr_mode
= USB_DR_MODE_PERIPHERAL
;
119 * At this point cdns->dr_mode contains strap configuration.
120 * Driver try update this setting considering kernel configuration
122 best_dr_mode
= cdns
->dr_mode
;
124 ret
= cdns3_idle_init(cdns
);
128 if (dr_mode
== USB_DR_MODE_OTG
) {
129 best_dr_mode
= cdns
->dr_mode
;
130 } else if (cdns
->dr_mode
== USB_DR_MODE_OTG
) {
131 best_dr_mode
= dr_mode
;
132 } else if (cdns
->dr_mode
!= dr_mode
) {
133 dev_err(dev
, "Incorrect DRD configuration\n");
137 dr_mode
= best_dr_mode
;
139 if (dr_mode
== USB_DR_MODE_OTG
|| dr_mode
== USB_DR_MODE_HOST
) {
140 ret
= cdns3_host_init(cdns
);
142 dev_err(dev
, "Host initialization failed with %d\n",
148 if (dr_mode
== USB_DR_MODE_OTG
|| dr_mode
== USB_DR_MODE_PERIPHERAL
) {
149 ret
= cdns3_gadget_init(cdns
);
151 dev_err(dev
, "Device initialization failed with %d\n",
157 cdns
->dr_mode
= dr_mode
;
159 ret
= cdns3_drd_update_mode(cdns
);
163 /* Initialize idle role to start with */
164 ret
= cdns3_role_start(cdns
, USB_ROLE_NONE
);
168 switch (cdns
->dr_mode
) {
169 case USB_DR_MODE_OTG
:
170 ret
= cdns3_hw_role_switch(cdns
);
174 case USB_DR_MODE_PERIPHERAL
:
175 ret
= cdns3_role_start(cdns
, USB_ROLE_DEVICE
);
179 case USB_DR_MODE_HOST
:
180 ret
= cdns3_role_start(cdns
, USB_ROLE_HOST
);
191 cdns3_exit_roles(cdns
);
196 * cdsn3_hw_role_state_machine - role switch state machine based on hw events.
197 * @cdns: Pointer to controller structure.
199 * Returns next role to be entered based on hw events.
201 static enum usb_role
cdsn3_hw_role_state_machine(struct cdns3
*cdns
)
206 if (cdns
->dr_mode
!= USB_DR_MODE_OTG
)
209 id
= cdns3_get_id(cdns
);
210 vbus
= cdns3_get_vbus(cdns
);
213 * Role change state machine
215 * Previous state: cdns->role
223 * Driver treats USB_ROLE_NONE synonymous to IDLE state from
224 * controller specification.
227 role
= USB_ROLE_HOST
;
229 role
= USB_ROLE_DEVICE
;
231 case USB_ROLE_HOST
: /* from HOST, we can only change to NONE */
233 role
= USB_ROLE_NONE
;
235 case USB_ROLE_DEVICE
: /* from GADGET, we can only change to NONE*/
237 role
= USB_ROLE_NONE
;
241 dev_dbg(cdns
->dev
, "role %d -> %d\n", cdns
->role
, role
);
246 if (cdns3_is_host(cdns
))
247 role
= USB_ROLE_HOST
;
248 if (cdns3_is_device(cdns
))
249 role
= USB_ROLE_DEVICE
;
254 static int cdns3_idle_role_start(struct cdns3
*cdns
)
259 static void cdns3_idle_role_stop(struct cdns3
*cdns
)
261 /* Program Lane swap and bring PHY out of RESET */
262 phy_reset(cdns
->usb3_phy
);
265 static int cdns3_idle_init(struct cdns3
*cdns
)
267 struct cdns3_role_driver
*rdrv
;
269 rdrv
= devm_kzalloc(cdns
->dev
, sizeof(*rdrv
), GFP_KERNEL
);
273 rdrv
->start
= cdns3_idle_role_start
;
274 rdrv
->stop
= cdns3_idle_role_stop
;
275 rdrv
->state
= CDNS3_ROLE_STATE_INACTIVE
;
276 rdrv
->suspend
= NULL
;
280 cdns
->roles
[USB_ROLE_NONE
] = rdrv
;
286 * cdns3_hw_role_switch - switch roles based on HW state
289 int cdns3_hw_role_switch(struct cdns3
*cdns
)
291 enum usb_role real_role
, current_role
;
294 /* Do nothing if role based on syfs. */
295 if (cdns
->role_override
)
298 pm_runtime_get_sync(cdns
->dev
);
300 current_role
= cdns
->role
;
301 real_role
= cdsn3_hw_role_state_machine(cdns
);
303 /* Do nothing if nothing changed */
304 if (current_role
== real_role
)
307 cdns3_role_stop(cdns
);
309 dev_dbg(cdns
->dev
, "Switching role %d -> %d", current_role
, real_role
);
311 ret
= cdns3_role_start(cdns
, real_role
);
313 /* Back to current role */
314 dev_err(cdns
->dev
, "set %d has failed, back to %d\n",
315 real_role
, current_role
);
316 ret
= cdns3_role_start(cdns
, current_role
);
318 dev_err(cdns
->dev
, "back to %d failed too\n",
322 pm_runtime_put_sync(cdns
->dev
);
327 * cdsn3_role_get - get current role of controller.
329 * @dev: Pointer to device structure
333 static enum usb_role
cdns3_role_get(struct device
*dev
)
335 struct cdns3
*cdns
= dev_get_drvdata(dev
);
341 * cdns3_role_set - set current role of controller.
343 * @dev: pointer to device object
344 * @role - the previous role
345 * Handles below events:
346 * - Role switch for dual-role devices
347 * - USB_ROLE_GADGET <--> USB_ROLE_NONE for peripheral-only devices
349 static int cdns3_role_set(struct device
*dev
, enum usb_role role
)
351 struct cdns3
*cdns
= dev_get_drvdata(dev
);
354 pm_runtime_get_sync(cdns
->dev
);
357 * FIXME: switch role framework should be extended to meet
358 * requirements. Driver assumes that role can be controlled
359 * by SW or HW. Temporary workaround is to use USB_ROLE_NONE to
360 * switch from SW to HW control.
362 * For dr_mode == USB_DR_MODE_OTG:
363 * if user sets USB_ROLE_HOST or USB_ROLE_DEVICE then driver
364 * sets role_override flag and forces that role.
365 * if user sets USB_ROLE_NONE, driver clears role_override and lets
366 * HW state machine take over.
368 * For dr_mode != USB_DR_MODE_OTG:
370 * 1. Restricted user control between NONE and dr_mode.
371 * 2. Driver doesn't need to rely on role_override flag.
372 * 3. Driver needs to ensure that HW state machine is never called
373 * if dr_mode != USB_DR_MODE_OTG.
375 if (role
== USB_ROLE_NONE
)
376 cdns
->role_override
= 0;
378 cdns
->role_override
= 1;
381 * HW state might have changed so driver need to trigger
382 * HW state machine if dr_mode == USB_DR_MODE_OTG.
384 if (!cdns
->role_override
&& cdns
->dr_mode
== USB_DR_MODE_OTG
) {
385 cdns3_hw_role_switch(cdns
);
389 if (cdns
->role
== role
)
392 if (cdns
->dr_mode
== USB_DR_MODE_HOST
) {
403 if (cdns
->dr_mode
== USB_DR_MODE_PERIPHERAL
) {
406 case USB_ROLE_DEVICE
:
414 cdns3_role_stop(cdns
);
415 ret
= cdns3_role_start(cdns
, role
);
417 dev_err(cdns
->dev
, "set role %d has failed\n", role
);
422 pm_runtime_put_sync(cdns
->dev
);
426 static const struct usb_role_switch_desc cdns3_switch_desc
= {
427 .set
= cdns3_role_set
,
428 .get
= cdns3_role_get
,
429 .allow_userspace_control
= true,
433 * cdns3_probe - probe for cdns3 core device
434 * @pdev: Pointer to cdns3 core platform device
436 * Returns 0 on success otherwise negative errno
438 static int cdns3_probe(struct platform_device
*pdev
)
440 struct device
*dev
= &pdev
->dev
;
441 struct resource
*res
;
446 ret
= dma_set_mask_and_coherent(dev
, DMA_BIT_MASK(32));
448 dev_err(dev
, "error setting dma mask: %d\n", ret
);
452 cdns
= devm_kzalloc(dev
, sizeof(*cdns
), GFP_KERNEL
);
458 platform_set_drvdata(pdev
, cdns
);
460 res
= platform_get_resource_byname(pdev
, IORESOURCE_IRQ
, "host");
462 dev_err(dev
, "missing host IRQ\n");
466 cdns
->xhci_res
[0] = *res
;
468 res
= platform_get_resource_byname(pdev
, IORESOURCE_MEM
, "xhci");
470 dev_err(dev
, "couldn't get xhci resource\n");
474 cdns
->xhci_res
[1] = *res
;
476 cdns
->dev_irq
= platform_get_irq_byname(pdev
, "peripheral");
477 if (cdns
->dev_irq
== -EPROBE_DEFER
)
478 return cdns
->dev_irq
;
480 if (cdns
->dev_irq
< 0)
481 dev_err(dev
, "couldn't get peripheral irq\n");
483 res
= platform_get_resource_byname(pdev
, IORESOURCE_MEM
, "dev");
484 regs
= devm_ioremap_resource(dev
, res
);
486 return PTR_ERR(regs
);
487 cdns
->dev_regs
= regs
;
489 cdns
->otg_irq
= platform_get_irq_byname(pdev
, "otg");
490 if (cdns
->otg_irq
== -EPROBE_DEFER
)
491 return cdns
->otg_irq
;
493 if (cdns
->otg_irq
< 0) {
494 dev_err(dev
, "couldn't get otg irq\n");
495 return cdns
->otg_irq
;
498 res
= platform_get_resource_byname(pdev
, IORESOURCE_MEM
, "otg");
500 dev_err(dev
, "couldn't get otg resource\n");
504 cdns
->otg_res
= *res
;
506 mutex_init(&cdns
->mutex
);
508 cdns
->usb2_phy
= devm_phy_optional_get(dev
, "cdns3,usb2-phy");
509 if (IS_ERR(cdns
->usb2_phy
))
510 return PTR_ERR(cdns
->usb2_phy
);
512 ret
= phy_init(cdns
->usb2_phy
);
516 cdns
->usb3_phy
= devm_phy_optional_get(dev
, "cdns3,usb3-phy");
517 if (IS_ERR(cdns
->usb3_phy
))
518 return PTR_ERR(cdns
->usb3_phy
);
520 ret
= phy_init(cdns
->usb3_phy
);
524 ret
= phy_power_on(cdns
->usb2_phy
);
528 ret
= phy_power_on(cdns
->usb3_phy
);
532 cdns
->role_sw
= usb_role_switch_register(dev
, &cdns3_switch_desc
);
533 if (IS_ERR(cdns
->role_sw
)) {
534 ret
= PTR_ERR(cdns
->role_sw
);
535 dev_warn(dev
, "Unable to register Role Switch\n");
539 ret
= cdns3_drd_init(cdns
);
543 ret
= cdns3_core_init_role(cdns
);
547 device_set_wakeup_capable(dev
, true);
548 pm_runtime_set_active(dev
);
549 pm_runtime_enable(dev
);
552 * The controller needs less time between bus and controller suspend,
553 * and we also needs a small delay to avoid frequently entering low
556 pm_runtime_set_autosuspend_delay(dev
, 20);
557 pm_runtime_mark_last_busy(dev
);
558 pm_runtime_use_autosuspend(dev
);
559 dev_dbg(dev
, "Cadence USB3 core: probe succeed\n");
563 cdns3_drd_exit(cdns
);
564 usb_role_switch_unregister(cdns
->role_sw
);
566 phy_power_off(cdns
->usb3_phy
);
569 phy_power_off(cdns
->usb2_phy
);
571 phy_exit(cdns
->usb3_phy
);
573 phy_exit(cdns
->usb2_phy
);
579 * cdns3_remove - unbind drd driver and clean up
580 * @pdev: Pointer to Linux platform device
582 * Returns 0 on success otherwise negative errno
584 static int cdns3_remove(struct platform_device
*pdev
)
586 struct cdns3
*cdns
= platform_get_drvdata(pdev
);
588 pm_runtime_get_sync(&pdev
->dev
);
589 pm_runtime_disable(&pdev
->dev
);
590 pm_runtime_put_noidle(&pdev
->dev
);
591 cdns3_exit_roles(cdns
);
592 usb_role_switch_unregister(cdns
->role_sw
);
593 phy_power_off(cdns
->usb2_phy
);
594 phy_power_off(cdns
->usb3_phy
);
595 phy_exit(cdns
->usb2_phy
);
596 phy_exit(cdns
->usb3_phy
);
600 #ifdef CONFIG_PM_SLEEP
602 static int cdns3_suspend(struct device
*dev
)
604 struct cdns3
*cdns
= dev_get_drvdata(dev
);
607 if (cdns
->role
== USB_ROLE_HOST
)
610 if (pm_runtime_status_suspended(dev
))
611 pm_runtime_resume(dev
);
613 if (cdns
->roles
[cdns
->role
]->suspend
) {
614 spin_lock_irqsave(&cdns
->gadget_dev
->lock
, flags
);
615 cdns
->roles
[cdns
->role
]->suspend(cdns
, false);
616 spin_unlock_irqrestore(&cdns
->gadget_dev
->lock
, flags
);
622 static int cdns3_resume(struct device
*dev
)
624 struct cdns3
*cdns
= dev_get_drvdata(dev
);
627 if (cdns
->role
== USB_ROLE_HOST
)
630 if (cdns
->roles
[cdns
->role
]->resume
) {
631 spin_lock_irqsave(&cdns
->gadget_dev
->lock
, flags
);
632 cdns
->roles
[cdns
->role
]->resume(cdns
, false);
633 spin_unlock_irqrestore(&cdns
->gadget_dev
->lock
, flags
);
636 pm_runtime_disable(dev
);
637 pm_runtime_set_active(dev
);
638 pm_runtime_enable(dev
);
644 static const struct dev_pm_ops cdns3_pm_ops
= {
645 SET_SYSTEM_SLEEP_PM_OPS(cdns3_suspend
, cdns3_resume
)
649 static const struct of_device_id of_cdns3_match
[] = {
650 { .compatible
= "cdns,usb3" },
653 MODULE_DEVICE_TABLE(of
, of_cdns3_match
);
656 static struct platform_driver cdns3_driver
= {
657 .probe
= cdns3_probe
,
658 .remove
= cdns3_remove
,
661 .of_match_table
= of_match_ptr(of_cdns3_match
),
666 module_platform_driver(cdns3_driver
);
668 MODULE_ALIAS("platform:cdns3");
669 MODULE_AUTHOR("Pawel Laszczak <pawell@cadence.com>");
670 MODULE_LICENSE("GPL v2");
671 MODULE_DESCRIPTION("Cadence USB3 DRD Controller Driver");