Mention branches and keyring.
[releases.git] / host / uhci-pci.c
1 // SPDX-License-Identifier: GPL-2.0
2 /*
3  * UHCI HCD (Host Controller Driver) PCI Bus Glue.
4  *
5  * Extracted from uhci-hcd.c:
6  * Maintainer: Alan Stern <stern@rowland.harvard.edu>
7  *
8  * (C) Copyright 1999 Linus Torvalds
9  * (C) Copyright 1999-2002 Johannes Erdfelt, johannes@erdfelt.com
10  * (C) Copyright 1999 Randy Dunlap
11  * (C) Copyright 1999 Georg Acher, acher@in.tum.de
12  * (C) Copyright 1999 Deti Fliegl, deti@fliegl.de
13  * (C) Copyright 1999 Thomas Sailer, sailer@ife.ee.ethz.ch
14  * (C) Copyright 1999 Roman Weissgaerber, weissg@vienna.at
15  * (C) Copyright 2000 Yggdrasil Computing, Inc. (port of new PCI interface
16  *               support from usb-ohci.c by Adam Richter, adam@yggdrasil.com).
17  * (C) Copyright 1999 Gregory P. Smith (from usb-ohci.c)
18  * (C) Copyright 2004-2007 Alan Stern, stern@rowland.harvard.edu
19  */
20
21 #include "pci-quirks.h"
22
23 /*
24  * Make sure the controller is completely inactive, unable to
25  * generate interrupts or do DMA.
26  */
27 static void uhci_pci_reset_hc(struct uhci_hcd *uhci)
28 {
29         uhci_reset_hc(to_pci_dev(uhci_dev(uhci)), uhci->io_addr);
30 }
31
32 /*
33  * Initialize a controller that was newly discovered or has just been
34  * resumed.  In either case we can't be sure of its previous state.
35  *
36  * Returns: 1 if the controller was reset, 0 otherwise.
37  */
38 static int uhci_pci_check_and_reset_hc(struct uhci_hcd *uhci)
39 {
40         return uhci_check_and_reset_hc(to_pci_dev(uhci_dev(uhci)),
41                                 uhci->io_addr);
42 }
43
44 /*
45  * Store the basic register settings needed by the controller.
46  * This function is called at the end of configure_hc in uhci-hcd.c.
47  */
48 static void uhci_pci_configure_hc(struct uhci_hcd *uhci)
49 {
50         struct pci_dev *pdev = to_pci_dev(uhci_dev(uhci));
51
52         /* Enable PIRQ */
53         pci_write_config_word(pdev, USBLEGSUP, USBLEGSUP_DEFAULT);
54
55         /* Disable platform-specific non-PME# wakeup */
56         if (pdev->vendor == PCI_VENDOR_ID_INTEL)
57                 pci_write_config_byte(pdev, USBRES_INTEL, 0);
58 }
59
60 static int uhci_pci_resume_detect_interrupts_are_broken(struct uhci_hcd *uhci)
61 {
62         int port;
63
64         switch (to_pci_dev(uhci_dev(uhci))->vendor) {
65         default:
66                 break;
67
68         case PCI_VENDOR_ID_GENESYS:
69                 /* Genesys Logic's GL880S controllers don't generate
70                  * resume-detect interrupts.
71                  */
72                 return 1;
73
74         case PCI_VENDOR_ID_INTEL:
75                 /* Some of Intel's USB controllers have a bug that causes
76                  * resume-detect interrupts if any port has an over-current
77                  * condition.  To make matters worse, some motherboards
78                  * hardwire unused USB ports' over-current inputs active!
79                  * To prevent problems, we will not enable resume-detect
80                  * interrupts if any ports are OC.
81                  */
82                 for (port = 0; port < uhci->rh_numports; ++port) {
83                         if (inw(uhci->io_addr + USBPORTSC1 + port * 2) &
84                                         USBPORTSC_OC)
85                                 return 1;
86                 }
87                 break;
88         }
89         return 0;
90 }
91
92 static int uhci_pci_global_suspend_mode_is_broken(struct uhci_hcd *uhci)
93 {
94         int port;
95         const char *sys_info;
96         static const char bad_Asus_board[] = "A7V8X";
97
98         /* One of Asus's motherboards has a bug which causes it to
99          * wake up immediately from suspend-to-RAM if any of the ports
100          * are connected.  In such cases we will not set EGSM.
101          */
102         sys_info = dmi_get_system_info(DMI_BOARD_NAME);
103         if (sys_info && !strcmp(sys_info, bad_Asus_board)) {
104                 for (port = 0; port < uhci->rh_numports; ++port) {
105                         if (inw(uhci->io_addr + USBPORTSC1 + port * 2) &
106                                         USBPORTSC_CCS)
107                                 return 1;
108                 }
109         }
110
111         return 0;
112 }
113
114 static int uhci_pci_init(struct usb_hcd *hcd)
115 {
116         struct uhci_hcd *uhci = hcd_to_uhci(hcd);
117
118         uhci->io_addr = (unsigned long) hcd->rsrc_start;
119
120         uhci->rh_numports = uhci_count_ports(hcd);
121
122         /*
123          * Intel controllers report the OverCurrent bit active on.  VIA
124          * and ZHAOXIN controllers report it active off, so we'll adjust
125          * the bit value.  (It's not standardized in the UHCI spec.)
126          */
127         if (to_pci_dev(uhci_dev(uhci))->vendor == PCI_VENDOR_ID_VIA ||
128                         to_pci_dev(uhci_dev(uhci))->vendor == PCI_VENDOR_ID_ZHAOXIN)
129                 uhci->oc_low = 1;
130
131         /* HP's server management chip requires a longer port reset delay. */
132         if (to_pci_dev(uhci_dev(uhci))->vendor == PCI_VENDOR_ID_HP)
133                 uhci->wait_for_hp = 1;
134
135         /* Intel controllers use non-PME wakeup signalling */
136         if (to_pci_dev(uhci_dev(uhci))->vendor == PCI_VENDOR_ID_INTEL)
137                 device_set_wakeup_capable(uhci_dev(uhci), true);
138
139         /* Set up pointers to PCI-specific functions */
140         uhci->reset_hc = uhci_pci_reset_hc;
141         uhci->check_and_reset_hc = uhci_pci_check_and_reset_hc;
142         uhci->configure_hc = uhci_pci_configure_hc;
143         uhci->resume_detect_interrupts_are_broken =
144                 uhci_pci_resume_detect_interrupts_are_broken;
145         uhci->global_suspend_mode_is_broken =
146                 uhci_pci_global_suspend_mode_is_broken;
147
148
149         /* Kick BIOS off this hardware and reset if the controller
150          * isn't already safely quiescent.
151          */
152         check_and_reset_hc(uhci);
153         return 0;
154 }
155
156 /* Make sure the controller is quiescent and that we're not using it
157  * any more.  This is mainly for the benefit of programs which, like kexec,
158  * expect the hardware to be idle: not doing DMA or generating IRQs.
159  *
160  * This routine may be called in a damaged or failing kernel.  Hence we
161  * do not acquire the spinlock before shutting down the controller.
162  */
163 static void uhci_shutdown(struct pci_dev *pdev)
164 {
165         struct usb_hcd *hcd = pci_get_drvdata(pdev);
166
167         uhci_hc_died(hcd_to_uhci(hcd));
168 }
169
170 #ifdef CONFIG_PM
171
172 static int uhci_pci_resume(struct usb_hcd *hcd, pm_message_t state);
173
174 static int uhci_pci_suspend(struct usb_hcd *hcd, bool do_wakeup)
175 {
176         struct uhci_hcd *uhci = hcd_to_uhci(hcd);
177         struct pci_dev *pdev = to_pci_dev(uhci_dev(uhci));
178         int rc = 0;
179
180         dev_dbg(uhci_dev(uhci), "%s\n", __func__);
181
182         spin_lock_irq(&uhci->lock);
183         if (!HCD_HW_ACCESSIBLE(hcd) || uhci->dead)
184                 goto done_okay;         /* Already suspended or dead */
185
186         /* All PCI host controllers are required to disable IRQ generation
187          * at the source, so we must turn off PIRQ.
188          */
189         pci_write_config_word(pdev, USBLEGSUP, 0);
190         clear_bit(HCD_FLAG_POLL_RH, &hcd->flags);
191
192         /* Enable platform-specific non-PME# wakeup */
193         if (do_wakeup) {
194                 if (pdev->vendor == PCI_VENDOR_ID_INTEL)
195                         pci_write_config_byte(pdev, USBRES_INTEL,
196                                         USBPORT1EN | USBPORT2EN);
197         }
198
199 done_okay:
200         clear_bit(HCD_FLAG_HW_ACCESSIBLE, &hcd->flags);
201         spin_unlock_irq(&uhci->lock);
202
203         synchronize_irq(hcd->irq);
204
205         /* Check for race with a wakeup request */
206         if (do_wakeup && HCD_WAKEUP_PENDING(hcd)) {
207                 uhci_pci_resume(hcd, PMSG_SUSPEND);
208                 rc = -EBUSY;
209         }
210         return rc;
211 }
212
213 static int uhci_pci_resume(struct usb_hcd *hcd, pm_message_t msg)
214 {
215         bool hibernated = (msg.event == PM_EVENT_RESTORE);
216         struct uhci_hcd *uhci = hcd_to_uhci(hcd);
217
218         dev_dbg(uhci_dev(uhci), "%s\n", __func__);
219
220         /* Since we aren't in D3 any more, it's safe to set this flag
221          * even if the controller was dead.
222          */
223         set_bit(HCD_FLAG_HW_ACCESSIBLE, &hcd->flags);
224
225         spin_lock_irq(&uhci->lock);
226
227         /* Make sure resume from hibernation re-enumerates everything */
228         if (hibernated) {
229                 uhci->reset_hc(uhci);
230                 finish_reset(uhci);
231         }
232
233         /* The firmware may have changed the controller settings during
234          * a system wakeup.  Check it and reconfigure to avoid problems.
235          */
236         else {
237                 check_and_reset_hc(uhci);
238         }
239         configure_hc(uhci);
240
241         /* Tell the core if the controller had to be reset */
242         if (uhci->rh_state == UHCI_RH_RESET)
243                 usb_root_hub_lost_power(hcd->self.root_hub);
244
245         spin_unlock_irq(&uhci->lock);
246
247         /* If interrupts don't work and remote wakeup is enabled then
248          * the suspended root hub needs to be polled.
249          */
250         if (!uhci->RD_enable && hcd->self.root_hub->do_remote_wakeup)
251                 set_bit(HCD_FLAG_POLL_RH, &hcd->flags);
252
253         /* Does the root hub have a port wakeup pending? */
254         usb_hcd_poll_rh_status(hcd);
255         return 0;
256 }
257
258 #endif
259
260 static const struct hc_driver uhci_driver = {
261         .description =          hcd_name,
262         .product_desc =         "UHCI Host Controller",
263         .hcd_priv_size =        sizeof(struct uhci_hcd),
264
265         /* Generic hardware linkage */
266         .irq =                  uhci_irq,
267         .flags =                HCD_DMA | HCD_USB11,
268
269         /* Basic lifecycle operations */
270         .reset =                uhci_pci_init,
271         .start =                uhci_start,
272 #ifdef CONFIG_PM
273         .pci_suspend =          uhci_pci_suspend,
274         .pci_resume =           uhci_pci_resume,
275         .bus_suspend =          uhci_rh_suspend,
276         .bus_resume =           uhci_rh_resume,
277 #endif
278         .stop =                 uhci_stop,
279
280         .urb_enqueue =          uhci_urb_enqueue,
281         .urb_dequeue =          uhci_urb_dequeue,
282
283         .endpoint_disable =     uhci_hcd_endpoint_disable,
284         .get_frame_number =     uhci_hcd_get_frame_number,
285
286         .hub_status_data =      uhci_hub_status_data,
287         .hub_control =          uhci_hub_control,
288 };
289
290 static const struct pci_device_id uhci_pci_ids[] = { {
291         /* handle any USB UHCI controller */
292         PCI_DEVICE_CLASS(PCI_CLASS_SERIAL_USB_UHCI, ~0),
293         }, { /* end: all zeroes */ }
294 };
295
296 MODULE_DEVICE_TABLE(pci, uhci_pci_ids);
297
298 static int uhci_pci_probe(struct pci_dev *dev, const struct pci_device_id *id)
299 {
300         return usb_hcd_pci_probe(dev, &uhci_driver);
301 }
302
303 static struct pci_driver uhci_pci_driver = {
304         .name =         hcd_name,
305         .id_table =     uhci_pci_ids,
306
307         .probe =        uhci_pci_probe,
308         .remove =       usb_hcd_pci_remove,
309         .shutdown =     uhci_shutdown,
310
311 #ifdef CONFIG_PM
312         .driver =       {
313                 .pm =   &usb_hcd_pci_pm_ops
314         },
315 #endif
316 };
317
318 MODULE_SOFTDEP("pre: ehci_pci");