[net-next-2.6.git] / drivers / usb / host / whci / pzl.c

/*
 * Wireless Host Controller (WHC) periodic schedule management.
 *
 * Copyright (C) 2007 Cambridge Silicon Radio Ltd.
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License version
 * 2 as published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
#include <linux/kernel.h>
#include <linux/gfp.h>
#include <linux/dma-mapping.h>
#include <linux/uwb/umc.h>
#include <linux/usb.h>

#include "../../wusbcore/wusbhc.h"

#include "whcd.h"

static void update_pzl_pointers(struct whc *whc, int period, u64 addr)
{
	switch (period) {
	case 0:
		whc_qset_set_link_ptr(&whc->pz_list[0], addr);
		whc_qset_set_link_ptr(&whc->pz_list[2], addr);
		whc_qset_set_link_ptr(&whc->pz_list[4], addr);
		whc_qset_set_link_ptr(&whc->pz_list[6], addr);
		whc_qset_set_link_ptr(&whc->pz_list[8], addr);
		whc_qset_set_link_ptr(&whc->pz_list[10], addr);
		whc_qset_set_link_ptr(&whc->pz_list[12], addr);
		whc_qset_set_link_ptr(&whc->pz_list[14], addr);
		break;
	case 1:
		whc_qset_set_link_ptr(&whc->pz_list[1], addr);
		whc_qset_set_link_ptr(&whc->pz_list[5], addr);
		whc_qset_set_link_ptr(&whc->pz_list[9], addr);
		whc_qset_set_link_ptr(&whc->pz_list[13], addr);
		break;
	case 2:
		whc_qset_set_link_ptr(&whc->pz_list[3], addr);
		whc_qset_set_link_ptr(&whc->pz_list[11], addr);
		break;
	case 3:
		whc_qset_set_link_ptr(&whc->pz_list[7], addr);
		break;
	case 4:
		whc_qset_set_link_ptr(&whc->pz_list[15], addr);
		break;
	}
}

/*
 * Return the 'period' to use for this qset.  The minimum interval for
 * the endpoint is used so whatever urbs are submitted the device is
 * polled often enough.
 */
static int qset_get_period(struct whc *whc, struct whc_qset *qset)
{
	uint8_t bInterval = qset->ep->desc.bInterval;

	if (bInterval < 6)
		bInterval = 6;
	if (bInterval > 10)
		bInterval = 10;
	return bInterval - 6;
}

static void qset_insert_in_sw_list(struct whc *whc, struct whc_qset *qset)
{
	int period;

	period = qset_get_period(whc, qset);

	qset_clear(whc, qset);
	list_move(&qset->list_node, &whc->periodic_list[period]);
	qset->in_sw_list = true;
}

static void pzl_qset_remove(struct whc *whc, struct whc_qset *qset)
{
	list_move(&qset->list_node, &whc->periodic_removed_list);
	qset->in_hw_list = false;
	qset->in_sw_list = false;
}

/**
 * pzl_process_qset - process any recently inactivated or halted qTDs
 * in a qset.
 *
 * After inactive qTDs are removed, new qTDs can be added if the
 * urb queue still contains URBs.
 *
 * Returns the schedule updates required.
 */
static enum whc_update pzl_process_qset(struct whc *whc, struct whc_qset *qset)
{
	enum whc_update update = 0;
	uint32_t status = 0;

	while (qset->ntds) {
		struct whc_qtd *td;
		int t;

		t = qset->td_start;
		td = &qset->qtd[qset->td_start];
		status = le32_to_cpu(td->status);

		/*
		 * Nothing to do with a still active qTD.
		 */
		if (status & QTD_STS_ACTIVE)
			break;

		if (status & QTD_STS_HALTED) {
			/* Ug, an error. */
			process_halted_qtd(whc, qset, td);
			/* A halted qTD always triggers an update
			   because the qset was either removed or
			   reactivated. */
			update |= WHC_UPDATE_UPDATED;
			goto done;
		}

		/* Mmm, a completed qTD. */
		process_inactive_qtd(whc, qset, td);
	}

	if (!qset->remove)
		update |= qset_add_qtds(whc, qset);

done:
	/*
	 * If there are no qTDs in this qset, remove it from the PZL.
	 */
	if (qset->remove && qset->ntds == 0) {
		pzl_qset_remove(whc, qset);
		update |= WHC_UPDATE_REMOVED;
	}

	return update;
}

/**
 * pzl_start - start the periodic schedule
 * @whc: the WHCI host controller
 *
 * The PZL must be valid (e.g., all entries in the list should have
 * the T bit set).
 */
void pzl_start(struct whc *whc)
{
	le_writeq(whc->pz_list_dma, whc->base + WUSBPERIODICLISTBASE);

	whc_write_wusbcmd(whc, WUSBCMD_PERIODIC_EN, WUSBCMD_PERIODIC_EN);
	whci_wait_for(&whc->umc->dev, whc->base + WUSBSTS,
		      WUSBSTS_PERIODIC_SCHED, WUSBSTS_PERIODIC_SCHED,
		      1000, "start PZL");
}

/**
 * pzl_stop - stop the periodic schedule
 * @whc: the WHCI host controller
 */
void pzl_stop(struct whc *whc)
{
	whc_write_wusbcmd(whc, WUSBCMD_PERIODIC_EN, 0);
	whci_wait_for(&whc->umc->dev, whc->base + WUSBSTS,
		      WUSBSTS_PERIODIC_SCHED, 0,
		      1000, "stop PZL");
}

/**
 * pzl_update - request a PZL update and wait for the hardware to be synced
 * @whc: the WHCI HC
 * @wusbcmd: WUSBCMD value to start the update.
 *
 * If the WUSB HC is inactive (i.e., the PZL is stopped) then the
 * update must be skipped as the hardware may not respond to update
 * requests.
 */
void pzl_update(struct whc *whc, uint32_t wusbcmd)
{
	struct wusbhc *wusbhc = &whc->wusbhc;
	long t;

	mutex_lock(&wusbhc->mutex);
	if (wusbhc->active) {
		whc_write_wusbcmd(whc, wusbcmd, wusbcmd);
		t = wait_event_timeout(
			whc->periodic_list_wq,
			(le_readl(whc->base + WUSBCMD) & WUSBCMD_PERIODIC_UPDATED) == 0,
			msecs_to_jiffies(1000));
		if (t == 0)
			whc_hw_error(whc, "PZL update timeout");
	}
	mutex_unlock(&wusbhc->mutex);
}

static void update_pzl_hw_view(struct whc *whc)
{
	struct whc_qset *qset, *t;
	int period;
	u64 tmp_qh = 0;

	for (period = 0; period < 5; period++) {
		list_for_each_entry_safe(qset, t, &whc->periodic_list[period], list_node) {
			whc_qset_set_link_ptr(&qset->qh.link, tmp_qh);
			tmp_qh = qset->qset_dma;
			qset->in_hw_list = true;
		}
		update_pzl_pointers(whc, period, tmp_qh);
	}
}

/**
 * scan_periodic_work - scan the PZL for qsets to process.
 *
 * Process each qset in the PZL in turn and then signal the WHC that
 * the PZL has been updated.
 *
 * Then start, stop or update the periodic schedule as required.
 */
void scan_periodic_work(struct work_struct *work)
{
	struct whc *whc = container_of(work, struct whc, periodic_work);
	struct whc_qset *qset, *t;
	enum whc_update update = 0;
	int period;

	spin_lock_irq(&whc->lock);

	for (period = 4; period >= 0; period--) {
		list_for_each_entry_safe(qset, t, &whc->periodic_list[period], list_node) {
			if (!qset->in_hw_list)
				update |= WHC_UPDATE_ADDED;
			update |= pzl_process_qset(whc, qset);
		}
	}

	if (update & (WHC_UPDATE_ADDED | WHC_UPDATE_REMOVED))
		update_pzl_hw_view(whc);

	spin_unlock_irq(&whc->lock);

	if (update) {
		uint32_t wusbcmd = WUSBCMD_PERIODIC_UPDATED | WUSBCMD_PERIODIC_SYNCED_DB;
		if (update & WHC_UPDATE_REMOVED)
			wusbcmd |= WUSBCMD_PERIODIC_QSET_RM;
		pzl_update(whc, wusbcmd);
	}

	/*
	 * Now that the PZL is updated, complete the removal of any
	 * removed qsets.
	 *
	 * If the qset was to be reset, do so and reinsert it into the
	 * PZL if it has pending transfers.
	 */
	spin_lock_irq(&whc->lock);

	list_for_each_entry_safe(qset, t, &whc->periodic_removed_list, list_node) {
		qset_remove_complete(whc, qset);
		if (qset->reset) {
			qset_reset(whc, qset);
			if (!list_empty(&qset->stds)) {
				qset_insert_in_sw_list(whc, qset);
				queue_work(whc->workqueue, &whc->periodic_work);
			}
		}
	}

	spin_unlock_irq(&whc->lock);
}

/**
 * pzl_urb_enqueue - queue an URB onto the periodic list (PZL)
 * @whc: the WHCI host controller
 * @urb: the URB to enqueue
 * @mem_flags: flags for any memory allocations
 *
 * The qset for the endpoint is obtained and the urb queued on to it.
 *
 * Work is scheduled to update the hardware's view of the PZL.
 */
int pzl_urb_enqueue(struct whc *whc, struct urb *urb, gfp_t mem_flags)
{
	struct whc_qset *qset;
	int err;
	unsigned long flags;

	spin_lock_irqsave(&whc->lock, flags);

	err = usb_hcd_link_urb_to_ep(&whc->wusbhc.usb_hcd, urb);
	if (err < 0) {
		spin_unlock_irqrestore(&whc->lock, flags);
		return err;
	}

	qset = get_qset(whc, urb, GFP_ATOMIC);
	if (qset == NULL)
		err = -ENOMEM;
	else
		err = qset_add_urb(whc, qset, urb, GFP_ATOMIC);
	if (!err) {
		if (!qset->in_sw_list && !qset->remove)
			qset_insert_in_sw_list(whc, qset);
	} else
		usb_hcd_unlink_urb_from_ep(&whc->wusbhc.usb_hcd, urb);

	spin_unlock_irqrestore(&whc->lock, flags);

	if (!err)
		queue_work(whc->workqueue, &whc->periodic_work);

	return err;
}

/**
 * pzl_urb_dequeue - remove an URB (qset) from the periodic list
 * @whc: the WHCI host controller
 * @urb: the URB to dequeue
 * @status: the current status of the URB
 *
 * URBs that do yet have qTDs can simply be removed from the software
 * queue, otherwise the qset must be removed so the qTDs can be safely
 * removed.
 */
int pzl_urb_dequeue(struct whc *whc, struct urb *urb, int status)
{
	struct whc_urb *wurb = urb->hcpriv;
	struct whc_qset *qset = wurb->qset;
	struct whc_std *std, *t;
	bool has_qtd = false;
	int ret;
	unsigned long flags;

	spin_lock_irqsave(&whc->lock, flags);

	ret = usb_hcd_check_unlink_urb(&whc->wusbhc.usb_hcd, urb, status);
	if (ret < 0)
		goto out;

	list_for_each_entry_safe(std, t, &qset->stds, list_node) {
		if (std->urb == urb) {
			if (std->qtd)
				has_qtd = true;
			qset_free_std(whc, std);
		} else
			std->qtd = NULL; /* so this std is re-added when the qset is */
	}

	if (has_qtd) {
		pzl_qset_remove(whc, qset);
		update_pzl_hw_view(whc);
		wurb->status = status;
		wurb->is_async = false;
		queue_work(whc->workqueue, &wurb->dequeue_work);
	} else
		qset_remove_urb(whc, qset, urb, status);
out:
	spin_unlock_irqrestore(&whc->lock, flags);

	return ret;
}

/**
 * pzl_qset_delete - delete a qset from the PZL
 */
void pzl_qset_delete(struct whc *whc, struct whc_qset *qset)
{
	qset->remove = 1;
	queue_work(whc->workqueue, &whc->periodic_work);
	qset_delete(whc, qset);
}

/**
 * pzl_init - initialize the periodic zone list
 * @whc: the WHCI host controller
 */
int pzl_init(struct whc *whc)
{
	int i;

	whc->pz_list = dma_alloc_coherent(&whc->umc->dev, sizeof(u64) * 16,
					  &whc->pz_list_dma, GFP_KERNEL);
	if (whc->pz_list == NULL)
		return -ENOMEM;

	/* Set T bit on all elements in PZL. */
	for (i = 0; i < 16; i++)
		whc->pz_list[i] = cpu_to_le64(QH_LINK_NTDS(8) | QH_LINK_T);

	le_writeq(whc->pz_list_dma, whc->base + WUSBPERIODICLISTBASE);

	return 0;
}

/**
 * pzl_clean_up - free PZL resources
 * @whc: the WHCI host controller
 *
 * The PZL is stopped and empty.
 */
void pzl_clean_up(struct whc *whc)
{
	if (whc->pz_list)
		dma_free_coherent(&whc->umc->dev,  sizeof(u64) * 16, whc->pz_list,
				  whc->pz_list_dma);
}
Commit	Line	Data
7e6133aa DV	1	/*
	2	* Wireless Host Controller (WHC) periodic schedule management.
	3	*
	4	* Copyright (C) 2007 Cambridge Silicon Radio Ltd.
	5	*
	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.
	9	*
	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.
	14	*
	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/>.
	17	*/
	18	#include <linux/kernel.h>
5a0e3ad6	19	#include <linux/gfp.h>
7e6133aa DV	20	#include <linux/dma-mapping.h>
	21	#include <linux/uwb/umc.h>
	22	#include <linux/usb.h>
7e6133aa DV	23
	24	#include "../../wusbcore/wusbhc.h"
	25
	26	#include "whcd.h"
	27
7e6133aa DV	28	static void update_pzl_pointers(struct whc *whc, int period, u64 addr)
	29	{
	30	switch (period) {
	31	case 0:
	32	whc_qset_set_link_ptr(&whc->pz_list[0], addr);
	33	whc_qset_set_link_ptr(&whc->pz_list[2], addr);
	34	whc_qset_set_link_ptr(&whc->pz_list[4], addr);
	35	whc_qset_set_link_ptr(&whc->pz_list[6], addr);
	36	whc_qset_set_link_ptr(&whc->pz_list[8], addr);
	37	whc_qset_set_link_ptr(&whc->pz_list[10], addr);
	38	whc_qset_set_link_ptr(&whc->pz_list[12], addr);
	39	whc_qset_set_link_ptr(&whc->pz_list[14], addr);
	40	break;
	41	case 1:
	42	whc_qset_set_link_ptr(&whc->pz_list[1], addr);
	43	whc_qset_set_link_ptr(&whc->pz_list[5], addr);
	44	whc_qset_set_link_ptr(&whc->pz_list[9], addr);
	45	whc_qset_set_link_ptr(&whc->pz_list[13], addr);
	46	break;
	47	case 2:
	48	whc_qset_set_link_ptr(&whc->pz_list[3], addr);
	49	whc_qset_set_link_ptr(&whc->pz_list[11], addr);
	50	break;
	51	case 3:
	52	whc_qset_set_link_ptr(&whc->pz_list[7], addr);
	53	break;
	54	case 4:
	55	whc_qset_set_link_ptr(&whc->pz_list[15], addr);
	56	break;
	57	}
	58	}
	59
	60	/*
	61	* Return the 'period' to use for this qset. The minimum interval for
	62	* the endpoint is used so whatever urbs are submitted the device is
	63	* polled often enough.
	64	*/
	65	static int qset_get_period(struct whc whc, struct whc_qset qset)
	66	{
	67	uint8_t bInterval = qset->ep->desc.bInterval;
	68
	69	if (bInterval < 6)
	70	bInterval = 6;
	71	if (bInterval > 10)
	72	bInterval = 10;
	73	return bInterval - 6;
	74	}
	75
	76	static void qset_insert_in_sw_list(struct whc whc, struct whc_qset qset)
	77	{
	78	int period;
	79
	80	period = qset_get_period(whc, qset);
	81
	82	qset_clear(whc, qset);
	83	list_move(&qset->list_node, &whc->periodic_list[period]);
	84	qset->in_sw_list = true;
	85	}
	86
	87	static void pzl_qset_remove(struct whc whc, struct whc_qset qset)
	88	{
	89	list_move(&qset->list_node, &whc->periodic_removed_list);
	90	qset->in_hw_list = false;
	91	qset->in_sw_list = false;
92	}
93
94	/**
95	* pzl_process_qset - process any recently inactivated or halted qTDs
96	* in a qset.
97	*
98	* After inactive qTDs are removed, new qTDs can be added if the
99	* urb queue still contains URBs.
100	*
101	* Returns the schedule updates required.
102	*/
103	static enum whc_update pzl_process_qset(struct whc whc, struct whc_qset qset)
104	{
105	enum whc_update update = 0;
106	uint32_t status = 0;
107
108	while (qset->ntds) {
109	struct whc_qtd *td;
110	int t;
111
112	t = qset->td_start;
113	td = &qset->qtd[qset->td_start];
114	status = le32_to_cpu(td->status);
115
116	/*
117	* Nothing to do with a still active qTD.
118	*/
119	if (status & QTD_STS_ACTIVE)
120	break;
121
122	if (status & QTD_STS_HALTED) {
123	/* Ug, an error. */
124	process_halted_qtd(whc, qset, td);
1f01ca4e DV	125	/* A halted qTD always triggers an update
	126	because the qset was either removed or
	127	reactivated. */
	128	update \|= WHC_UPDATE_UPDATED;
7e6133aa DV	129	goto done;
	130	}
	131
	132	/* Mmm, a completed qTD. */
	133	process_inactive_qtd(whc, qset, td);
	134	}
	135
7f0406db DV	136	if (!qset->remove)
7f0406db DV	137	update \|= qset_add_qtds(whc, qset);
7e6133aa DV	138
	139	done:
	140	/*
	141	* If there are no qTDs in this qset, remove it from the PZL.
	142	*/
	143	if (qset->remove && qset->ntds == 0) {
	144	pzl_qset_remove(whc, qset);
	145	update \|= WHC_UPDATE_REMOVED;
	146	}
	147
	148	return update;
	149	}
	150
	151	/**
	152	* pzl_start - start the periodic schedule
	153	* @whc: the WHCI host controller
	154	*
	155	* The PZL must be valid (e.g., all entries in the list should have
	156	* the T bit set).
	157	*/
	158	void pzl_start(struct whc *whc)
	159	{
	160	le_writeq(whc->pz_list_dma, whc->base + WUSBPERIODICLISTBASE);
	161
	162	whc_write_wusbcmd(whc, WUSBCMD_PERIODIC_EN, WUSBCMD_PERIODIC_EN);
	163	whci_wait_for(&whc->umc->dev, whc->base + WUSBSTS,
	164	WUSBSTS_PERIODIC_SCHED, WUSBSTS_PERIODIC_SCHED,
	165	1000, "start PZL");
	166	}
	167
	168	/**
	169	* pzl_stop - stop the periodic schedule
	170	* @whc: the WHCI host controller
	171	*/
	172	void pzl_stop(struct whc *whc)
	173	{
	174	whc_write_wusbcmd(whc, WUSBCMD_PERIODIC_EN, 0);
	175	whci_wait_for(&whc->umc->dev, whc->base + WUSBSTS,
	176	WUSBSTS_PERIODIC_SCHED, 0,
	177	1000, "stop PZL");
	178	}
	179
56968d0c DV	180	/**
	181	* pzl_update - request a PZL update and wait for the hardware to be synced
	182	* @whc: the WHCI HC
	183	* @wusbcmd: WUSBCMD value to start the update.
	184	*
	185	* If the WUSB HC is inactive (i.e., the PZL is stopped) then the
	186	* update must be skipped as the hardware may not respond to update
	187	* requests.
	188	*/
7e6133aa DV	189	void pzl_update(struct whc *whc, uint32_t wusbcmd)
7e6133aa DV	190	{
56968d0c	191	struct wusbhc *wusbhc = &whc->wusbhc;
a5e6ced5	192	long t;
56968d0c DV	193
	194	mutex_lock(&wusbhc->mutex);
	195	if (wusbhc->active) {
	196	whc_write_wusbcmd(whc, wusbcmd, wusbcmd);
a5e6ced5 DV	197	t = wait_event_timeout(
	198	whc->periodic_list_wq,
	199	(le_readl(whc->base + WUSBCMD) & WUSBCMD_PERIODIC_UPDATED) == 0,
	200	msecs_to_jiffies(1000));
	201	if (t == 0)
	202	whc_hw_error(whc, "PZL update timeout");
56968d0c DV	203	}
56968d0c DV	204	mutex_unlock(&wusbhc->mutex);
7e6133aa DV	205	}
	206
	207	static void update_pzl_hw_view(struct whc *whc)
	208	{
	209	struct whc_qset qset, t;
	210	int period;
	211	u64 tmp_qh = 0;
	212
	213	for (period = 0; period < 5; period++) {
	214	list_for_each_entry_safe(qset, t, &whc->periodic_list[period], list_node) {
	215	whc_qset_set_link_ptr(&qset->qh.link, tmp_qh);
	216	tmp_qh = qset->qset_dma;
	217	qset->in_hw_list = true;
	218	}
	219	update_pzl_pointers(whc, period, tmp_qh);
	220	}
	221	}
	222
	223	/**
	224	* scan_periodic_work - scan the PZL for qsets to process.
	225	*
	226	* Process each qset in the PZL in turn and then signal the WHC that
	227	* the PZL has been updated.
	228	*
	229	* Then start, stop or update the periodic schedule as required.
	230	*/
	231	void scan_periodic_work(struct work_struct *work)
	232	{
	233	struct whc *whc = container_of(work, struct whc, periodic_work);
	234	struct whc_qset qset, t;
	235	enum whc_update update = 0;
	236	int period;
	237
	238	spin_lock_irq(&whc->lock);
	239
7e6133aa DV	240	for (period = 4; period >= 0; period--) {
	241	list_for_each_entry_safe(qset, t, &whc->periodic_list[period], list_node) {
	242	if (!qset->in_hw_list)
	243	update \|= WHC_UPDATE_ADDED;
	244	update \|= pzl_process_qset(whc, qset);
	245	}
	246	}
	247
	248	if (update & (WHC_UPDATE_ADDED \| WHC_UPDATE_REMOVED))
	249	update_pzl_hw_view(whc);
	250
7e6133aa DV	251	spin_unlock_irq(&whc->lock);
	252
	253	if (update) {
	254	uint32_t wusbcmd = WUSBCMD_PERIODIC_UPDATED \| WUSBCMD_PERIODIC_SYNCED_DB;
	255	if (update & WHC_UPDATE_REMOVED)
	256	wusbcmd \|= WUSBCMD_PERIODIC_QSET_RM;
	257	pzl_update(whc, wusbcmd);
	258	}
	259
	260	/*
	261	* Now that the PZL is updated, complete the removal of any
	262	* removed qsets.
831baa49 DV	263	*
	264	* If the qset was to be reset, do so and reinsert it into the
	265	* PZL if it has pending transfers.
7e6133aa	266	*/
a3c1239e	267	spin_lock_irq(&whc->lock);
7e6133aa DV	268
	269	list_for_each_entry_safe(qset, t, &whc->periodic_removed_list, list_node) {
	270	qset_remove_complete(whc, qset);
831baa49 DV	271	if (qset->reset) {
	272	qset_reset(whc, qset);
	273	if (!list_empty(&qset->stds)) {
	274	qset_insert_in_sw_list(whc, qset);
	275	queue_work(whc->workqueue, &whc->periodic_work);
	276	}
	277	}
7e6133aa DV	278	}
7e6133aa DV	279
a3c1239e	280	spin_unlock_irq(&whc->lock);
7e6133aa DV	281	}
	282
	283	/**
	284	* pzl_urb_enqueue - queue an URB onto the periodic list (PZL)
	285	* @whc: the WHCI host controller
	286	* @urb: the URB to enqueue
	287	* @mem_flags: flags for any memory allocations
	288	*
	289	* The qset for the endpoint is obtained and the urb queued on to it.
	290	*
	291	* Work is scheduled to update the hardware's view of the PZL.
	292	*/
	293	int pzl_urb_enqueue(struct whc whc, struct urb urb, gfp_t mem_flags)
	294	{
	295	struct whc_qset *qset;
	296	int err;
	297	unsigned long flags;
	298
	299	spin_lock_irqsave(&whc->lock, flags);
	300
f720af91 DV	301	err = usb_hcd_link_urb_to_ep(&whc->wusbhc.usb_hcd, urb);
	302	if (err < 0) {
	303	spin_unlock_irqrestore(&whc->lock, flags);
	304	return err;
	305	}
	306
7e6133aa DV	307	qset = get_qset(whc, urb, GFP_ATOMIC);
	308	if (qset == NULL)
	309	err = -ENOMEM;
	310	else
	311	err = qset_add_urb(whc, qset, urb, GFP_ATOMIC);
	312	if (!err) {
831baa49	313	if (!qset->in_sw_list && !qset->remove)
7e6133aa	314	qset_insert_in_sw_list(whc, qset);
f720af91 DV	315	} else
f720af91 DV	316	usb_hcd_unlink_urb_from_ep(&whc->wusbhc.usb_hcd, urb);
7e6133aa DV	317
	318	spin_unlock_irqrestore(&whc->lock, flags);
	319
	320	if (!err)
	321	queue_work(whc->workqueue, &whc->periodic_work);
	322
f720af91	323	return err;
7e6133aa DV	324	}
	325
	326	/**
	327	* pzl_urb_dequeue - remove an URB (qset) from the periodic list
	328	* @whc: the WHCI host controller
	329	* @urb: the URB to dequeue
	330	* @status: the current status of the URB
	331	*
	332	* URBs that do yet have qTDs can simply be removed from the software
	333	* queue, otherwise the qset must be removed so the qTDs can be safely
	334	* removed.
	335	*/
	336	int pzl_urb_dequeue(struct whc whc, struct urb urb, int status)
	337	{
	338	struct whc_urb *wurb = urb->hcpriv;
	339	struct whc_qset *qset = wurb->qset;
	340	struct whc_std std, t;
171b37ee	341	bool has_qtd = false;
7e6133aa DV	342	int ret;
	343	unsigned long flags;
	344
	345	spin_lock_irqsave(&whc->lock, flags);
	346
	347	ret = usb_hcd_check_unlink_urb(&whc->wusbhc.usb_hcd, urb, status);
	348	if (ret < 0)
	349	goto out;
	350
	351	list_for_each_entry_safe(std, t, &qset->stds, list_node) {
171b37ee DV	352	if (std->urb == urb) {
	353	if (std->qtd)
	354	has_qtd = true;
7e6133aa	355	qset_free_std(whc, std);
171b37ee	356	} else
7e6133aa DV	357	std->qtd = NULL; /* so this std is re-added when the qset is */
	358	}
	359
171b37ee DV	360	if (has_qtd) {
	361	pzl_qset_remove(whc, qset);
	362	update_pzl_hw_view(whc);
	363	wurb->status = status;
	364	wurb->is_async = false;
	365	queue_work(whc->workqueue, &wurb->dequeue_work);
	366	} else
	367	qset_remove_urb(whc, qset, urb, status);
7e6133aa DV	368	out:
	369	spin_unlock_irqrestore(&whc->lock, flags);
	370
	371	return ret;
	372	}
	373
	374	/**
	375	* pzl_qset_delete - delete a qset from the PZL
	376	*/
	377	void pzl_qset_delete(struct whc whc, struct whc_qset qset)
	378	{
	379	qset->remove = 1;
	380	queue_work(whc->workqueue, &whc->periodic_work);
	381	qset_delete(whc, qset);
	382	}
	383
7e6133aa DV	384	/**
	385	* pzl_init - initialize the periodic zone list
	386	* @whc: the WHCI host controller
	387	*/
	388	int pzl_init(struct whc *whc)
	389	{
	390	int i;
	391
	392	whc->pz_list = dma_alloc_coherent(&whc->umc->dev, sizeof(u64) * 16,
	393	&whc->pz_list_dma, GFP_KERNEL);
	394	if (whc->pz_list == NULL)
	395	return -ENOMEM;
	396
	397	/* Set T bit on all elements in PZL. */
	398	for (i = 0; i < 16; i++)
	399	whc->pz_list[i] = cpu_to_le64(QH_LINK_NTDS(8) \| QH_LINK_T);
	400
	401	le_writeq(whc->pz_list_dma, whc->base + WUSBPERIODICLISTBASE);
	402
	403	return 0;
	404	}
	405
	406	/**
	407	* pzl_clean_up - free PZL resources
	408	* @whc: the WHCI host controller
	409	*
	410	* The PZL is stopped and empty.
	411	*/
	412	void pzl_clean_up(struct whc *whc)
	413	{
	414	if (whc->pz_list)
	415	dma_free_coherent(&whc->umc->dev, sizeof(u64) * 16, whc->pz_list,
	416	whc->pz_list_dma);
	417	}