hc
2024-12-19 9370bb92b2d16684ee45cf24e879c93c509162da
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
/* SPDX-License-Identifier: GPL-2.0 */
/*
 * Cadence USBSS DRD Header File.
 *
 * Copyright (C) 2017-2018 NXP
 * Copyright (C) 2018-2019 Cadence.
 *
 * Authors: Peter Chen <peter.chen@nxp.com>
 *          Pawel Laszczak <pawell@cadence.com>
 */
#include <linux/usb/otg.h>
#include <linux/usb/role.h>
 
#ifndef __LINUX_CDNS3_CORE_H
#define __LINUX_CDNS3_CORE_H
 
struct cdns3;
 
/**
 * struct cdns3_role_driver - host/gadget role driver
 * @start: start this role
 * @stop: stop this role
 * @suspend: suspend callback for this role
 * @resume: resume callback for this role
 * @irq: irq handler for this role
 * @name: role name string (host/gadget)
 * @state: current state
 */
struct cdns3_role_driver {
   int (*start)(struct cdns3 *cdns);
   void (*stop)(struct cdns3 *cdns);
   int (*suspend)(struct cdns3 *cdns, bool do_wakeup);
   int (*resume)(struct cdns3 *cdns, bool hibernated);
   const char *name;
#define CDNS3_ROLE_STATE_INACTIVE    0
#define CDNS3_ROLE_STATE_ACTIVE        1
   int state;
};
 
#define CDNS3_XHCI_RESOURCES_NUM    2
 
struct cdns3_platform_data {
   int (*platform_suspend)(struct device *dev,
           bool suspend, bool wakeup);
   unsigned long quirks;
#define CDNS3_DEFAULT_PM_RUNTIME_ALLOW    BIT(0)
};
 
/**
 * struct cdns3 - Representation of Cadence USB3 DRD controller.
 * @dev: pointer to Cadence device struct
 * @xhci_regs: pointer to base of xhci registers
 * @xhci_res: the resource for xhci
 * @dev_regs: pointer to base of dev registers
 * @otg_res: the resource for otg
 * @otg_v0_regs: pointer to base of v0 otg registers
 * @otg_v1_regs: pointer to base of v1 otg registers
 * @otg_cdnsp_regs: pointer to base of CDNSP otg registers
 * @otg_regs: pointer to base of otg registers
 * @otg_irq_regs: pointer to interrupt registers
 * @otg_irq: irq number for otg controller
 * @dev_irq: irq number for device controller
 * @wakeup_irq: irq number for wakeup event, it is optional
 * @roles: array of supported roles for this controller
 * @role: current role
 * @host_dev: the child host device pointer for cdns3 core
 * @gadget_dev: the child gadget device pointer for cdns3 core
 * @usb2_phy: pointer to USB2 PHY
 * @usb3_phy: pointer to USB3 PHY
 * @mutex: the mutex for concurrent code at driver
 * @dr_mode: supported mode of operation it can be only Host, only Device
 *           or OTG mode that allow to switch between Device and Host mode.
 *           This field based on firmware setting, kernel configuration
 *           and hardware configuration.
 * @role_sw: pointer to role switch object.
 * @in_lpm: indicate the controller is in low power mode
 * @wakeup_pending: wakeup interrupt pending
 * @pdata: platform data from glue layer
 * @lock: spinlock structure
 * @xhci_plat_data: xhci private data structure pointer
 */
struct cdns3 {
   struct device            *dev;
   void __iomem            *xhci_regs;
   struct resource            xhci_res[CDNS3_XHCI_RESOURCES_NUM];
   struct cdns3_usb_regs __iomem    *dev_regs;
 
   struct resource            otg_res;
   struct cdns3_otg_legacy_regs    *otg_v0_regs;
   struct cdns3_otg_regs        *otg_v1_regs;
   struct cdnsp_otg_regs        *otg_cdnsp_regs;
   struct cdns3_otg_common_regs    *otg_regs;
   struct cdns3_otg_irq_regs    *otg_irq_regs;
#define CDNS3_CONTROLLER_V0    0
#define CDNS3_CONTROLLER_V1    1
#define CDNSP_CONTROLLER_V2    2
   u32                version;
   bool                phyrst_a_enable;
 
   int                otg_irq;
   int                dev_irq;
   int                wakeup_irq;
   struct cdns3_role_driver    *roles[USB_ROLE_DEVICE + 1];
   enum usb_role            role;
   struct platform_device        *host_dev;
   struct cdns3_device        *gadget_dev;
   struct phy            *usb2_phy;
   struct phy            *usb3_phy;
   /* mutext used in workqueue*/
   struct mutex            mutex;
   enum usb_dr_mode        dr_mode;
   struct usb_role_switch        *role_sw;
   bool                in_lpm;
   bool                wakeup_pending;
   struct cdns3_platform_data    *pdata;
   spinlock_t            lock;
   struct xhci_plat_priv        *xhci_plat_data;
};
 
int cdns3_hw_role_switch(struct cdns3 *cdns);
 
#endif /* __LINUX_CDNS3_CORE_H */