1 // SPDX-License-Identifier: GPL-1.0+
3 * OHCI HCD (Host Controller Driver) for USB.
5 * (C) Copyright 1999 Roman Weissgaerber <weissg@vienna.at>
6 * (C) Copyright 2000-2002 David Brownell <dbrownell@users.sourceforge.net>
8 * This file is licenced under the GPL.
11 /*-------------------------------------------------------------------------*/
14 * OHCI deals with three types of memory:
15 * - data used only by the HCD ... kmalloc is fine
16 * - async and periodic schedules, shared by HC and HCD ... these
17 * need to use dma_pool or dma_alloc_coherent
18 * - driver buffers, read/written by HC ... the hcd glue or the
19 * device driver provides us with dma addresses
21 * There's also "register" data, which is memory mapped.
22 * No memory seen by this driver (or any HCD) may be paged out.
25 /*-------------------------------------------------------------------------*/
27 static void ohci_hcd_init (struct ohci_hcd *ohci)
29 ohci->next_statechange = jiffies;
30 spin_lock_init (&ohci->lock);
31 INIT_LIST_HEAD (&ohci->pending);
32 INIT_LIST_HEAD(&ohci->eds_in_use);
35 /*-------------------------------------------------------------------------*/
37 static int ohci_mem_init (struct ohci_hcd *ohci)
40 * HCs with local memory allocate from localmem_pool so there's
41 * no need to create the below dma pools.
43 if (ohci_to_hcd(ohci)->localmem_pool)
46 ohci->td_cache = dma_pool_create ("ohci_td",
47 ohci_to_hcd(ohci)->self.controller,
49 32 /* byte alignment */,
50 0 /* no page-crossing issues */);
53 ohci->ed_cache = dma_pool_create ("ohci_ed",
54 ohci_to_hcd(ohci)->self.controller,
56 16 /* byte alignment */,
57 0 /* no page-crossing issues */);
58 if (!ohci->ed_cache) {
59 dma_pool_destroy (ohci->td_cache);
65 static void ohci_mem_cleanup (struct ohci_hcd *ohci)
67 dma_pool_destroy(ohci->td_cache);
68 ohci->td_cache = NULL;
69 dma_pool_destroy(ohci->ed_cache);
70 ohci->ed_cache = NULL;
73 /*-------------------------------------------------------------------------*/
75 /* ohci "done list" processing needs this mapping */
76 static inline struct td *
77 dma_to_td (struct ohci_hcd *hc, dma_addr_t td_dma)
82 td = hc->td_hash [TD_HASH_FUNC(td_dma)];
83 while (td && td->td_dma != td_dma)
90 td_alloc (struct ohci_hcd *hc, gfp_t mem_flags)
94 struct usb_hcd *hcd = ohci_to_hcd(hc);
96 if (hcd->localmem_pool)
97 td = gen_pool_dma_zalloc(hcd->localmem_pool, sizeof(*td), &dma);
99 td = dma_pool_zalloc(hc->td_cache, mem_flags, &dma);
101 /* in case hc fetches it, make it look dead */
102 td->hwNextTD = cpu_to_hc32 (hc, dma);
104 /* hashed in td_fill */
110 td_free (struct ohci_hcd *hc, struct td *td)
112 struct td **prev = &hc->td_hash [TD_HASH_FUNC (td->td_dma)];
113 struct usb_hcd *hcd = ohci_to_hcd(hc);
115 while (*prev && *prev != td)
116 prev = &(*prev)->td_hash;
119 else if ((td->hwINFO & cpu_to_hc32(hc, TD_DONE)) != 0)
120 ohci_dbg (hc, "no hash for td %p\n", td);
122 if (hcd->localmem_pool)
123 gen_pool_free(hcd->localmem_pool, (unsigned long)td,
126 dma_pool_free(hc->td_cache, td, td->td_dma);
129 /*-------------------------------------------------------------------------*/
133 ed_alloc (struct ohci_hcd *hc, gfp_t mem_flags)
137 struct usb_hcd *hcd = ohci_to_hcd(hc);
139 if (hcd->localmem_pool)
140 ed = gen_pool_dma_zalloc(hcd->localmem_pool, sizeof(*ed), &dma);
142 ed = dma_pool_zalloc(hc->ed_cache, mem_flags, &dma);
144 INIT_LIST_HEAD (&ed->td_list);
151 ed_free (struct ohci_hcd *hc, struct ed *ed)
153 struct usb_hcd *hcd = ohci_to_hcd(hc);
155 if (hcd->localmem_pool)
156 gen_pool_free(hcd->localmem_pool, (unsigned long)ed,
159 dma_pool_free(hc->ed_cache, ed, ed->dma);