2 * Wireless Host Controller (WHC) asynchronous schedule management.
4 * Copyright (C) 2007 Cambridge Silicon Radio Ltd.
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License version
8 * 2 as published by the Free Software Foundation.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License
16 * along with this program. If not, see <http://www.gnu.org/licenses/>.
18 #include <linux/kernel.h>
19 #include <linux/gfp.h>
20 #include <linux/dma-mapping.h>
21 #include <linux/uwb/umc.h>
22 #include <linux/usb.h>
24 #include "../../wusbcore/wusbhc.h"
28 static void qset_get_next_prev(struct whc
*whc
, struct whc_qset
*qset
,
29 struct whc_qset
**next
, struct whc_qset
**prev
)
31 struct list_head
*n
, *p
;
33 BUG_ON(list_empty(&whc
->async_list
));
35 n
= qset
->list_node
.next
;
36 if (n
== &whc
->async_list
)
38 p
= qset
->list_node
.prev
;
39 if (p
== &whc
->async_list
)
42 *next
= container_of(n
, struct whc_qset
, list_node
);
43 *prev
= container_of(p
, struct whc_qset
, list_node
);
47 static void asl_qset_insert_begin(struct whc
*whc
, struct whc_qset
*qset
)
49 list_move(&qset
->list_node
, &whc
->async_list
);
50 qset
->in_sw_list
= true;
53 static void asl_qset_insert(struct whc
*whc
, struct whc_qset
*qset
)
55 struct whc_qset
*next
, *prev
;
57 qset_clear(whc
, qset
);
60 qset_get_next_prev(whc
, qset
, &next
, &prev
);
61 whc_qset_set_link_ptr(&qset
->qh
.link
, next
->qset_dma
);
62 whc_qset_set_link_ptr(&prev
->qh
.link
, qset
->qset_dma
);
63 qset
->in_hw_list
= true;
66 static void asl_qset_remove(struct whc
*whc
, struct whc_qset
*qset
)
68 struct whc_qset
*prev
, *next
;
70 qset_get_next_prev(whc
, qset
, &next
, &prev
);
72 list_move(&qset
->list_node
, &whc
->async_removed_list
);
73 qset
->in_sw_list
= false;
76 * No more qsets in the ASL? The caller must stop the ASL as
77 * it's no longer valid.
79 if (list_empty(&whc
->async_list
))
82 /* Remove from ASL. */
83 whc_qset_set_link_ptr(&prev
->qh
.link
, next
->qset_dma
);
84 qset
->in_hw_list
= false;
88 * process_qset - process any recently inactivated or halted qTDs in a
91 * After inactive qTDs are removed, new qTDs can be added if the
92 * urb queue still contains URBs.
94 * Returns any additional WUSBCMD bits for the ASL sync command (i.e.,
95 * WUSBCMD_ASYNC_QSET_RM if a halted qset was removed).
97 static uint32_t process_qset(struct whc
*whc
, struct whc_qset
*qset
)
99 enum whc_update update
= 0;
107 td
= &qset
->qtd
[qset
->td_start
];
108 status
= le32_to_cpu(td
->status
);
111 * Nothing to do with a still active qTD.
113 if (status
& QTD_STS_ACTIVE
)
116 if (status
& QTD_STS_HALTED
) {
118 process_halted_qtd(whc
, qset
, td
);
119 /* A halted qTD always triggers an update
120 because the qset was either removed or
122 update
|= WHC_UPDATE_UPDATED
;
126 /* Mmm, a completed qTD. */
127 process_inactive_qtd(whc
, qset
, td
);
131 update
|= qset_add_qtds(whc
, qset
);
135 * Remove this qset from the ASL if requested, but only if has
138 if (qset
->remove
&& qset
->ntds
== 0) {
139 asl_qset_remove(whc
, qset
);
140 update
|= WHC_UPDATE_REMOVED
;
145 void asl_start(struct whc
*whc
)
147 struct whc_qset
*qset
;
149 qset
= list_first_entry(&whc
->async_list
, struct whc_qset
, list_node
);
151 le_writeq(qset
->qset_dma
| QH_LINK_NTDS(8), whc
->base
+ WUSBASYNCLISTADDR
);
153 whc_write_wusbcmd(whc
, WUSBCMD_ASYNC_EN
, WUSBCMD_ASYNC_EN
);
154 whci_wait_for(&whc
->umc
->dev
, whc
->base
+ WUSBSTS
,
155 WUSBSTS_ASYNC_SCHED
, WUSBSTS_ASYNC_SCHED
,
159 void asl_stop(struct whc
*whc
)
161 whc_write_wusbcmd(whc
, WUSBCMD_ASYNC_EN
, 0);
162 whci_wait_for(&whc
->umc
->dev
, whc
->base
+ WUSBSTS
,
163 WUSBSTS_ASYNC_SCHED
, 0,
168 * asl_update - request an ASL update and wait for the hardware to be synced
170 * @wusbcmd: WUSBCMD value to start the update.
172 * If the WUSB HC is inactive (i.e., the ASL is stopped) then the
173 * update must be skipped as the hardware may not respond to update
176 void asl_update(struct whc
*whc
, uint32_t wusbcmd
)
178 struct wusbhc
*wusbhc
= &whc
->wusbhc
;
181 mutex_lock(&wusbhc
->mutex
);
182 if (wusbhc
->active
) {
183 whc_write_wusbcmd(whc
, wusbcmd
, wusbcmd
);
184 t
= wait_event_timeout(
186 (le_readl(whc
->base
+ WUSBCMD
) & WUSBCMD_ASYNC_UPDATED
) == 0,
187 msecs_to_jiffies(1000));
189 whc_hw_error(whc
, "ASL update timeout");
191 mutex_unlock(&wusbhc
->mutex
);
195 * scan_async_work - scan the ASL for qsets to process.
197 * Process each qset in the ASL in turn and then signal the WHC that
198 * the ASL has been updated.
200 * Then start, stop or update the asynchronous schedule as required.
202 void scan_async_work(struct work_struct
*work
)
204 struct whc
*whc
= container_of(work
, struct whc
, async_work
);
205 struct whc_qset
*qset
, *t
;
206 enum whc_update update
= 0;
208 spin_lock_irq(&whc
->lock
);
211 * Transerve the software list backwards so new qsets can be
212 * safely inserted into the ASL without making it non-circular.
214 list_for_each_entry_safe_reverse(qset
, t
, &whc
->async_list
, list_node
) {
215 if (!qset
->in_hw_list
) {
216 asl_qset_insert(whc
, qset
);
217 update
|= WHC_UPDATE_ADDED
;
220 update
|= process_qset(whc
, qset
);
223 spin_unlock_irq(&whc
->lock
);
226 uint32_t wusbcmd
= WUSBCMD_ASYNC_UPDATED
| WUSBCMD_ASYNC_SYNCED_DB
;
227 if (update
& WHC_UPDATE_REMOVED
)
228 wusbcmd
|= WUSBCMD_ASYNC_QSET_RM
;
229 asl_update(whc
, wusbcmd
);
233 * Now that the ASL is updated, complete the removal of any
236 * If the qset was to be reset, do so and reinsert it into the
237 * ASL if it has pending transfers.
239 spin_lock_irq(&whc
->lock
);
241 list_for_each_entry_safe(qset
, t
, &whc
->async_removed_list
, list_node
) {
242 qset_remove_complete(whc
, qset
);
244 qset_reset(whc
, qset
);
245 if (!list_empty(&qset
->stds
)) {
246 asl_qset_insert_begin(whc
, qset
);
247 queue_work(whc
->workqueue
, &whc
->async_work
);
252 spin_unlock_irq(&whc
->lock
);
256 * asl_urb_enqueue - queue an URB onto the asynchronous list (ASL).
257 * @whc: the WHCI host controller
258 * @urb: the URB to enqueue
259 * @mem_flags: flags for any memory allocations
261 * The qset for the endpoint is obtained and the urb queued on to it.
263 * Work is scheduled to update the hardware's view of the ASL.
265 int asl_urb_enqueue(struct whc
*whc
, struct urb
*urb
, gfp_t mem_flags
)
267 struct whc_qset
*qset
;
271 spin_lock_irqsave(&whc
->lock
, flags
);
273 err
= usb_hcd_link_urb_to_ep(&whc
->wusbhc
.usb_hcd
, urb
);
275 spin_unlock_irqrestore(&whc
->lock
, flags
);
279 qset
= get_qset(whc
, urb
, GFP_ATOMIC
);
283 err
= qset_add_urb(whc
, qset
, urb
, GFP_ATOMIC
);
285 if (!qset
->in_sw_list
&& !qset
->remove
)
286 asl_qset_insert_begin(whc
, qset
);
288 usb_hcd_unlink_urb_from_ep(&whc
->wusbhc
.usb_hcd
, urb
);
290 spin_unlock_irqrestore(&whc
->lock
, flags
);
293 queue_work(whc
->workqueue
, &whc
->async_work
);
299 * asl_urb_dequeue - remove an URB (qset) from the async list.
300 * @whc: the WHCI host controller
301 * @urb: the URB to dequeue
302 * @status: the current status of the URB
304 * URBs that do yet have qTDs can simply be removed from the software
305 * queue, otherwise the qset must be removed from the ASL so the qTDs
308 int asl_urb_dequeue(struct whc
*whc
, struct urb
*urb
, int status
)
310 struct whc_urb
*wurb
= urb
->hcpriv
;
311 struct whc_qset
*qset
= wurb
->qset
;
312 struct whc_std
*std
, *t
;
313 bool has_qtd
= false;
317 spin_lock_irqsave(&whc
->lock
, flags
);
319 ret
= usb_hcd_check_unlink_urb(&whc
->wusbhc
.usb_hcd
, urb
, status
);
323 list_for_each_entry_safe(std
, t
, &qset
->stds
, list_node
) {
324 if (std
->urb
== urb
) {
327 qset_free_std(whc
, std
);
329 std
->qtd
= NULL
; /* so this std is re-added when the qset is */
333 asl_qset_remove(whc
, qset
);
334 wurb
->status
= status
;
335 wurb
->is_async
= true;
336 queue_work(whc
->workqueue
, &wurb
->dequeue_work
);
338 qset_remove_urb(whc
, qset
, urb
, status
);
340 spin_unlock_irqrestore(&whc
->lock
, flags
);
346 * asl_qset_delete - delete a qset from the ASL
348 void asl_qset_delete(struct whc
*whc
, struct whc_qset
*qset
)
351 queue_work(whc
->workqueue
, &whc
->async_work
);
352 qset_delete(whc
, qset
);
356 * asl_init - initialize the asynchronous schedule list
358 * A dummy qset with no qTDs is added to the ASL to simplify removing
359 * qsets (no need to stop the ASL when the last qset is removed).
361 int asl_init(struct whc
*whc
)
363 struct whc_qset
*qset
;
365 qset
= qset_alloc(whc
, GFP_KERNEL
);
369 asl_qset_insert_begin(whc
, qset
);
370 asl_qset_insert(whc
, qset
);
376 * asl_clean_up - free ASL resources
378 * The ASL is stopped and empty except for the dummy qset.
380 void asl_clean_up(struct whc
*whc
)
382 struct whc_qset
*qset
;
384 if (!list_empty(&whc
->async_list
)) {
385 qset
= list_first_entry(&whc
->async_list
, struct whc_qset
, list_node
);
386 list_del(&qset
->list_node
);
387 qset_free(whc
, qset
);