diff mbox series

[v12,04/41] usb: host: xhci-mem: Cleanup pending secondary event ring events

Message ID 20240102214549.22498-5-quic_wcheng@quicinc.com
State New
Headers show
Series Introduce QC USB SND audio offloading support | expand

Commit Message

Wesley Cheng Jan. 2, 2024, 9:45 p.m. UTC
As part of xHCI bus suspend, the XHCI is halted.  However, if there are
pending events in the secondary event ring, it is observed that the xHCI
controller stops responding to further commands upon host or device
initiated bus resume.  Iterate through all pending events and update the
dequeue pointer to the beginning of the event ring.

Signed-off-by: Wesley Cheng <quic_wcheng@quicinc.com>
---
 drivers/usb/host/xhci-mem.c  | 11 +++++----
 drivers/usb/host/xhci-ring.c | 46 +++++++++++++++++++++++++++++++++++-
 drivers/usb/host/xhci.c      |  2 +-
 drivers/usb/host/xhci.h      |  7 ++++++
 4 files changed, 59 insertions(+), 7 deletions(-)

Comments

Mathias Nyman Jan. 4, 2024, 2:48 p.m. UTC | #1
On 2.1.2024 23.45, Wesley Cheng wrote:
> As part of xHCI bus suspend, the XHCI is halted.  However, if there are
> pending events in the secondary event ring, it is observed that the xHCI
> controller stops responding to further commands upon host or device
> initiated bus resume.  Iterate through all pending events and update the
> dequeue pointer to the beginning of the event ring.
> 
> Signed-off-by: Wesley Cheng <quic_wcheng@quicinc.com>
...
> +/*
> + * Move the event ring dequeue pointer to skip events kept in the secondary
> + * event ring.  This is used to ensure that pending events in the ring are
> + * acknowledged, so the XHCI HCD can properly enter suspend/resume.  The
> + * secondary ring is typically maintained by an external component.
> + */
> +void xhci_skip_sec_intr_events(struct xhci_hcd *xhci,
> +	struct xhci_ring *ring,	struct xhci_interrupter *ir)
> +{
> +	union xhci_trb *erdp_trb, *current_trb;
> +	u64 erdp_reg;
> +	u32 iman_reg;
> +	dma_addr_t deq;
> +
> +	/* disable irq, ack pending interrupt and ack all pending events */
> +	xhci_disable_interrupter(ir);
> +	iman_reg = readl_relaxed(&ir->ir_set->irq_pending);
> +	if (iman_reg & IMAN_IP)
> +		writel_relaxed(iman_reg, &ir->ir_set->irq_pending);
> +
> +	/* last acked event trb is in erdp reg  */
> +	erdp_reg = xhci_read_64(xhci, &ir->ir_set->erst_dequeue);
> +	deq = (dma_addr_t)(erdp_reg & ERST_PTR_MASK);
> +	if (!deq) {
> +		xhci_err(xhci, "event ring handling not required\n");
> +		return;
> +	}
> +
> +	erdp_trb = current_trb = ir->event_ring->dequeue;
> +	/* read cycle state of the last acked trb to find out CCS */
> +	ring->cycle_state = le32_to_cpu(current_trb->event_cmd.flags) & TRB_CYCLE;
> +
> +	while (1) {
> +		inc_deq(xhci, ir->event_ring);
> +		erdp_trb = ir->event_ring->dequeue;
> +		/* cycle state transition */
> +		if ((le32_to_cpu(erdp_trb->event_cmd.flags) & TRB_CYCLE) !=
> +		    ring->cycle_state)
> +			break;
> +	}
> +
> +	xhci_update_erst_dequeue(xhci, ir, current_trb, true);
> +}

Code above is very similar to the existing event ring processing parts of xhci_irq()
and xhci_handle_event()

I'll see if I can refactor the existing event ring processing, decouple it from
event handling so that it could be used by primary and secondary interrupters with
handlers, and this case where we just want to clear the event ring.

Thanks
Mathias
Wesley Cheng Jan. 8, 2024, 8:51 p.m. UTC | #2
Hi Mathias,

On 1/4/2024 6:48 AM, Mathias Nyman wrote:
> On 2.1.2024 23.45, Wesley Cheng wrote:
>> As part of xHCI bus suspend, the XHCI is halted.  However, if there are
>> pending events in the secondary event ring, it is observed that the xHCI
>> controller stops responding to further commands upon host or device
>> initiated bus resume.  Iterate through all pending events and update the
>> dequeue pointer to the beginning of the event ring.
>>
>> Signed-off-by: Wesley Cheng <quic_wcheng@quicinc.com>
> ...
>> +/*
>> + * Move the event ring dequeue pointer to skip events kept in the 
>> secondary
>> + * event ring.  This is used to ensure that pending events in the 
>> ring are
>> + * acknowledged, so the XHCI HCD can properly enter suspend/resume.  The
>> + * secondary ring is typically maintained by an external component.
>> + */
>> +void xhci_skip_sec_intr_events(struct xhci_hcd *xhci,
>> +    struct xhci_ring *ring,    struct xhci_interrupter *ir)
>> +{
>> +    union xhci_trb *erdp_trb, *current_trb;
>> +    u64 erdp_reg;
>> +    u32 iman_reg;
>> +    dma_addr_t deq;
>> +
>> +    /* disable irq, ack pending interrupt and ack all pending events */
>> +    xhci_disable_interrupter(ir);
>> +    iman_reg = readl_relaxed(&ir->ir_set->irq_pending);
>> +    if (iman_reg & IMAN_IP)
>> +        writel_relaxed(iman_reg, &ir->ir_set->irq_pending);
>> +
>> +    /* last acked event trb is in erdp reg  */
>> +    erdp_reg = xhci_read_64(xhci, &ir->ir_set->erst_dequeue);
>> +    deq = (dma_addr_t)(erdp_reg & ERST_PTR_MASK);
>> +    if (!deq) {
>> +        xhci_err(xhci, "event ring handling not required\n");
>> +        return;
>> +    }
>> +
>> +    erdp_trb = current_trb = ir->event_ring->dequeue;
>> +    /* read cycle state of the last acked trb to find out CCS */
>> +    ring->cycle_state = le32_to_cpu(current_trb->event_cmd.flags) & 
>> TRB_CYCLE;
>> +
>> +    while (1) {
>> +        inc_deq(xhci, ir->event_ring);
>> +        erdp_trb = ir->event_ring->dequeue;
>> +        /* cycle state transition */
>> +        if ((le32_to_cpu(erdp_trb->event_cmd.flags) & TRB_CYCLE) !=
>> +            ring->cycle_state)
>> +            break;
>> +    }
>> +
>> +    xhci_update_erst_dequeue(xhci, ir, current_trb, true);
>> +}
> 
> Code above is very similar to the existing event ring processing parts 
> of xhci_irq()
> and xhci_handle_event()
> 
> I'll see if I can refactor the existing event ring processing, decouple 
> it from
> event handling so that it could be used by primary and secondary 
> interrupters with
> handlers, and this case where we just want to clear the event ring.
> 

Thanks, that makes sense.  Will take a look as well.

Thanks
Wesley Cheng
Wesley Cheng Jan. 9, 2024, 11:42 p.m. UTC | #3
Hi Mathias,

On 1/8/2024 12:51 PM, Wesley Cheng wrote:
> Hi Mathias,
> 
> On 1/4/2024 6:48 AM, Mathias Nyman wrote:
>> On 2.1.2024 23.45, Wesley Cheng wrote:
>>> As part of xHCI bus suspend, the XHCI is halted.  However, if there are
>>> pending events in the secondary event ring, it is observed that the xHCI
>>> controller stops responding to further commands upon host or device
>>> initiated bus resume.  Iterate through all pending events and update the
>>> dequeue pointer to the beginning of the event ring.
>>>
>>> Signed-off-by: Wesley Cheng <quic_wcheng@quicinc.com>
>> ...
>>> +/*
>>> + * Move the event ring dequeue pointer to skip events kept in the 
>>> secondary
>>> + * event ring.  This is used to ensure that pending events in the 
>>> ring are
>>> + * acknowledged, so the XHCI HCD can properly enter suspend/resume.  
>>> The
>>> + * secondary ring is typically maintained by an external component.
>>> + */
>>> +void xhci_skip_sec_intr_events(struct xhci_hcd *xhci,
>>> +    struct xhci_ring *ring,    struct xhci_interrupter *ir)
>>> +{
>>> +    union xhci_trb *erdp_trb, *current_trb;
>>> +    u64 erdp_reg;
>>> +    u32 iman_reg;
>>> +    dma_addr_t deq;
>>> +
>>> +    /* disable irq, ack pending interrupt and ack all pending events */
>>> +    xhci_disable_interrupter(ir);
>>> +    iman_reg = readl_relaxed(&ir->ir_set->irq_pending);
>>> +    if (iman_reg & IMAN_IP)
>>> +        writel_relaxed(iman_reg, &ir->ir_set->irq_pending);
>>> +
>>> +    /* last acked event trb is in erdp reg  */
>>> +    erdp_reg = xhci_read_64(xhci, &ir->ir_set->erst_dequeue);
>>> +    deq = (dma_addr_t)(erdp_reg & ERST_PTR_MASK);
>>> +    if (!deq) {
>>> +        xhci_err(xhci, "event ring handling not required\n");
>>> +        return;
>>> +    }
>>> +
>>> +    erdp_trb = current_trb = ir->event_ring->dequeue;
>>> +    /* read cycle state of the last acked trb to find out CCS */
>>> +    ring->cycle_state = le32_to_cpu(current_trb->event_cmd.flags) & 
>>> TRB_CYCLE;
>>> +
>>> +    while (1) {
>>> +        inc_deq(xhci, ir->event_ring);
>>> +        erdp_trb = ir->event_ring->dequeue;
>>> +        /* cycle state transition */
>>> +        if ((le32_to_cpu(erdp_trb->event_cmd.flags) & TRB_CYCLE) !=
>>> +            ring->cycle_state)
>>> +            break;
>>> +    }
>>> +
>>> +    xhci_update_erst_dequeue(xhci, ir, current_trb, true);
>>> +}
>>
>> Code above is very similar to the existing event ring processing parts 
>> of xhci_irq()
>> and xhci_handle_event()
>>
>> I'll see if I can refactor the existing event ring processing, 
>> decouple it from
>> event handling so that it could be used by primary and secondary 
>> interrupters with
>> handlers, and this case where we just want to clear the event ring.
>>
> 
> Thanks, that makes sense.  Will take a look as well.
> 

How about something like the below?  Tested this on my set up and 
everything looks to be working fine.  Had to add another param to struct 
xhci_interrupters to tell the XHCI interrupt handler to say if that 
particular interrupter wants to skip_events (handling).  This way, its 
something that the class driver utilizing the interrupter will have to 
tell XHCI sideband.  It would allow the user to determine if they want 
to use the interrupter to actually handle events or not on the proc 
running Linux.

Thanks
Wesley Cheng

---------------------------------------------------------------------


diff --git a/drivers/usb/host/xhci-mem.c b/drivers/usb/host/xhci-mem.c
index 4460fa7e9fab..5bf74c37cbf6 100644
--- a/drivers/usb/host/xhci-mem.c
+++ b/drivers/usb/host/xhci-mem.c
@@ -1827,7 +1827,7 @@ xhci_remove_interrupter(struct xhci_hcd *xhci, 
struct xhci_interrupter *ir)
  		tmp &= ERST_SIZE_MASK;
  		writel(tmp, &ir->ir_set->erst_size);

-		xhci_write_64(xhci, ERST_EHB, &ir->ir_set->erst_dequeue);
+		xhci_update_erst_dequeue(xhci, ir, ir->event_ring->first_seg->trbs, 
true);
  	}
  }

@@ -1865,11 +1865,12 @@ void xhci_remove_secondary_interrupter(struct 
usb_hcd *hcd, struct xhci_interrup
  	if (!ir || !ir->intr_num || ir->intr_num >= xhci->max_interrupters)
  		xhci_dbg(xhci, "Invalid secondary interrupter, can't remove\n");

-	/* fixme, should we check xhci->interrupter[intr_num] == ir */
-	/* fixme locking */
-
  	spin_lock_irq(&xhci->lock);
-
+	/*
+	 * Cleanup secondary interrupter to ensure there are no pending events.
+	 * This also updates event ring dequeue pointer back to the start.
+	 */
+	xhci_skip_sec_intr_events(xhci, ir->event_ring, ir);
  	intr_num = ir->intr_num;

  	xhci_remove_interrupter(xhci, ir);
diff --git a/drivers/usb/host/xhci-ring.c b/drivers/usb/host/xhci-ring.c
index 33806ae966f9..1d69da07ffdd 100644
--- a/drivers/usb/host/xhci-ring.c
+++ b/drivers/usb/host/xhci-ring.c
@@ -2905,6 +2905,46 @@ static int handle_tx_event(struct xhci_hcd *xhci,
  	return -ENODEV;
  }

+static void xhci_clear_interrupt_pending(struct xhci_hcd *xhci, struct 
xhci_interrupter *ir)
+{
+	struct usb_hcd *hcd = xhci_to_hcd(xhci);
+
+	if (!hcd->msi_enabled) {
+		u32 irq_pending;
+		irq_pending = readl(&ir->ir_set->irq_pending);
+		irq_pending |= IMAN_IP;
+		writel(irq_pending, &ir->ir_set->irq_pending);
+	}
+}
+
+static void xhci_handle_event_trb(struct xhci_hcd *xhci,
+				   struct xhci_interrupter *ir, union xhci_trb *event)
+{
+	u32 trb_type;
+
+	trb_type = TRB_FIELD_TO_TYPE(le32_to_cpu(event->event_cmd.flags));
+
+	switch (trb_type) {
+	case TRB_COMPLETION:
+		handle_cmd_completion(xhci, &event->event_cmd);
+		break;
+	case TRB_PORT_STATUS:
+		handle_port_status(xhci, ir, event);
+		break;
+	case TRB_TRANSFER:
+		handle_tx_event(xhci, ir, &event->trans_event);
+		break;
+	case TRB_DEV_NOTE:
+		handle_device_notification(xhci, event);
+		break;
+	default:
+		if (trb_type >= TRB_VENDOR_DEFINED_LOW)
+			handle_vendor_event(xhci, event, trb_type);
+		else
+			xhci_warn(xhci, "ERROR unknown event type %d\n", trb_type);
+	}
+}
+
  /*
   * This function handles all OS-owned events on the event ring.  It 
may drop
   * xhci->lock between event processing (e.g. to pass up port status 
changes).
@@ -2914,7 +2954,6 @@ static int handle_tx_event(struct xhci_hcd *xhci,
  static int xhci_handle_event(struct xhci_hcd *xhci, struct 
xhci_interrupter *ir)
  {
  	union xhci_trb *event;
-	u32 trb_type;

  	/* Event ring hasn't been allocated yet. */
  	if (!ir || !ir->event_ring || !ir->event_ring->dequeue) {
@@ -2935,28 +2974,9 @@ static int xhci_handle_event(struct xhci_hcd 
*xhci, struct xhci_interrupter *ir)
  	 * speculative reads of the event's flags/data below.
  	 */
  	rmb();
-	trb_type = TRB_FIELD_TO_TYPE(le32_to_cpu(event->event_cmd.flags));
-	/* FIXME: Handle more event types. */
+	if (!ir->skip_events)
+		xhci_handle_event_trb(xhci, ir, event);

-	switch (trb_type) {
-	case TRB_COMPLETION:
-		handle_cmd_completion(xhci, &event->event_cmd);
-		break;
-	case TRB_PORT_STATUS:
-		handle_port_status(xhci, ir, event);
-		break;
-	case TRB_TRANSFER:
-		handle_tx_event(xhci, ir, &event->trans_event);
-		break;
-	case TRB_DEV_NOTE:
-		handle_device_notification(xhci, event);
-		break;
-	default:
-		if (trb_type >= TRB_VENDOR_DEFINED_LOW)
-			handle_vendor_event(xhci, event, trb_type);
-		else
-			xhci_warn(xhci, "ERROR unknown event type %d\n", trb_type);
-	}
  	/* Any of the above functions may drop and re-acquire the lock, so check
  	 * to make sure a watchdog timer didn't mark the host as non-responsive.
  	 */
@@ -2980,7 +3000,7 @@ static int xhci_handle_event(struct xhci_hcd 
*xhci, struct xhci_interrupter *ir)
   * - When all events have finished
   * - To avoid "Event Ring Full Error" condition
   */
-static void xhci_update_erst_dequeue(struct xhci_hcd *xhci,
+void xhci_update_erst_dequeue(struct xhci_hcd *xhci,
  				     struct xhci_interrupter *ir,
  				     union xhci_trb *event_ring_deq,
  				     bool clear_ehb)
@@ -3013,6 +3033,75 @@ static void xhci_update_erst_dequeue(struct 
xhci_hcd *xhci,
  	xhci_write_64(xhci, temp_64, &ir->ir_set->erst_dequeue);
  }

+static irqreturn_t xhci_handle_events(struct xhci_hcd *xhci, struct 
xhci_interrupter *ir)
+{
+	union xhci_trb *event_ring_deq;
+	irqreturn_t ret = IRQ_NONE;
+	int event_loop = 0;
+	u64 temp_64;
+
+	xhci_clear_interrupt_pending(xhci, ir);
+
+	if (xhci->xhc_state & XHCI_STATE_DYING ||
+	    xhci->xhc_state & XHCI_STATE_HALTED) {
+		xhci_dbg(xhci, "xHCI dying, ignoring interrupt. "
+				"Shouldn't IRQs be disabled?\n");
+		/* Clear the event handler busy flag (RW1C);
+		 * the event ring should be empty.
+		 */
+		temp_64 = xhci_read_64(xhci, &ir->ir_set->erst_dequeue);
+		xhci_write_64(xhci, temp_64 | ERST_EHB,
+				&ir->ir_set->erst_dequeue);
+		ret = IRQ_HANDLED;
+		goto out;
+	}
+
+	event_ring_deq = ir->event_ring->dequeue;
+	/* FIXME this should be a delayed service routine
+	 * that clears the EHB.
+	 */
+	while (xhci_handle_event(xhci, ir) > 0) {
+		if (event_loop++ < TRBS_PER_SEGMENT / 2)
+			continue;
+		xhci_update_erst_dequeue(xhci, ir, event_ring_deq, false);
+		event_ring_deq = ir->event_ring->dequeue;
+
+		/* ring is half-full, force isoc trbs to interrupt more often */
+		if (xhci->isoc_bei_interval > AVOID_BEI_INTERVAL_MIN)
+			xhci->isoc_bei_interval = xhci->isoc_bei_interval / 2;
+
+		event_loop = 0;
+	}
+
+	xhci_update_erst_dequeue(xhci, ir, event_ring_deq, true);
+	ret = IRQ_HANDLED;
+
+out:
+	return ret;
+
+}
+
+/*
+ * Move the event ring dequeue pointer to skip events kept in the secondary
+ * event ring.  This is used to ensure that pending events in the ring are
+ * acknowledged, so the XHCI HCD can properly enter suspend/resume.  The
+ * secondary ring is typically maintained by an external component.
+ */
+void xhci_skip_sec_intr_events(struct xhci_hcd *xhci,
+	struct xhci_ring *ring,	struct xhci_interrupter *ir)
+{
+	union xhci_trb *current_trb;
+
+	/* disable irq, ack pending interrupt and ack all pending events */
+	xhci_disable_interrupter(ir);
+
+	current_trb = ir->event_ring->dequeue;
+	/* read cycle state of the last acked trb to find out CCS */
+	ring->cycle_state = le32_to_cpu(current_trb->event_cmd.flags) & TRB_CYCLE;
+
+	xhci_handle_events(xhci, ir);
+}
+
  /*
   * xHCI spec says we can get an interrupt, and if the HC has an error 
condition,
   * we might get bad data out of the event ring.  Section 4.10.2.7 has 
a list of
@@ -3021,12 +3110,8 @@ static void xhci_update_erst_dequeue(struct 
xhci_hcd *xhci,
  irqreturn_t xhci_irq(struct usb_hcd *hcd)
  {
  	struct xhci_hcd *xhci = hcd_to_xhci(hcd);
-	union xhci_trb *event_ring_deq;
-	struct xhci_interrupter *ir;
  	irqreturn_t ret = IRQ_NONE;
-	u64 temp_64;
  	u32 status;
-	int event_loop = 0;

  	spin_lock(&xhci->lock);
  	/* Check if the xHC generated the interrupt, or the irq is shared */
@@ -3060,48 +3145,7 @@ irqreturn_t xhci_irq(struct usb_hcd *hcd)
  	status |= STS_EINT;
  	writel(status, &xhci->op_regs->status);

-	/* This is the handler of the primary interrupter */
-	ir = xhci->interrupters[0];
-	if (!hcd->msi_enabled) {
-		u32 irq_pending;
-		irq_pending = readl(&ir->ir_set->irq_pending);
-		irq_pending |= IMAN_IP;
-		writel(irq_pending, &ir->ir_set->irq_pending);
-	}
-
-	if (xhci->xhc_state & XHCI_STATE_DYING ||
-	    xhci->xhc_state & XHCI_STATE_HALTED) {
-		xhci_dbg(xhci, "xHCI dying, ignoring interrupt. "
-				"Shouldn't IRQs be disabled?\n");
-		/* Clear the event handler busy flag (RW1C);
-		 * the event ring should be empty.
-		 */
-		temp_64 = xhci_read_64(xhci, &ir->ir_set->erst_dequeue);
-		xhci_write_64(xhci, temp_64 | ERST_EHB,
-				&ir->ir_set->erst_dequeue);
-		ret = IRQ_HANDLED;
-		goto out;
-	}
-
-	event_ring_deq = ir->event_ring->dequeue;
-	/* FIXME this should be a delayed service routine
-	 * that clears the EHB.
-	 */
-	while (xhci_handle_event(xhci, ir) > 0) {
-		if (event_loop++ < TRBS_PER_SEGMENT / 2)
-			continue;
-		xhci_update_erst_dequeue(xhci, ir, event_ring_deq, false);
-		event_ring_deq = ir->event_ring->dequeue;
-
-		/* ring is half-full, force isoc trbs to interrupt more often */
-		if (xhci->isoc_bei_interval > AVOID_BEI_INTERVAL_MIN)
-			xhci->isoc_bei_interval = xhci->isoc_bei_interval / 2;
-
-		event_loop = 0;
-	}
-
-	xhci_update_erst_dequeue(xhci, ir, event_ring_deq, true);
-	ret = IRQ_HANDLED;
+	ret = xhci_handle_events(xhci, xhci->interrupters[0]);

  out:
  	spin_unlock(&xhci->lock);
diff --git a/drivers/usb/host/xhci.c b/drivers/usb/host/xhci.c
index 573ca5c4f31a..eb15c63e6775 100644
--- a/drivers/usb/host/xhci.c
+++ b/drivers/usb/host/xhci.c
@@ -333,7 +333,7 @@ static int xhci_enable_interrupter(struct 
xhci_interrupter *ir)
  	return 0;
  }

-static int xhci_disable_interrupter(struct xhci_interrupter *ir)
+int xhci_disable_interrupter(struct xhci_interrupter *ir)
  {
  	u32 iman;

diff --git a/drivers/usb/host/xhci.h b/drivers/usb/host/xhci.h
index e98099b960e4..a4126dfbd77a 100644
--- a/drivers/usb/host/xhci.h
+++ b/drivers/usb/host/xhci.h
@@ -1691,6 +1691,7 @@ struct xhci_interrupter {
  	struct xhci_erst	erst;
  	struct xhci_intr_reg __iomem *ir_set;
  	unsigned int		intr_num;
+	bool			skip_events;
  	/* For interrupter registers save and restore over suspend/resume */
  	u32	s3_irq_pending;
  	u32	s3_irq_control;
@@ -2093,6 +2094,9 @@ struct xhci_interrupter *
  xhci_create_secondary_interrupter(struct usb_hcd *hcd, int num_seg);
  void xhci_remove_secondary_interrupter(struct usb_hcd
  				       *hcd, struct xhci_interrupter *ir);
+void xhci_skip_sec_intr_events(struct xhci_hcd *xhci,
+	struct xhci_ring *ring,	struct xhci_interrupter *ir);
+int xhci_disable_interrupter(struct xhci_interrupter *ir);

  /* xHCI host controller glue */
  typedef void (*xhci_get_quirks_t)(struct device *, struct xhci_hcd *);
@@ -2180,6 +2184,10 @@ void inc_deq(struct xhci_hcd *xhci, struct 
xhci_ring *ring);
  unsigned int count_trbs(u64 addr, u64 len);
  int xhci_stop_endpoint_sync(struct xhci_hcd *xhci, struct xhci_virt_ep 
*ep,
  			    int suspend, gfp_t gfp_flags);
+void xhci_update_erst_dequeue(struct xhci_hcd *xhci,
+				     struct xhci_interrupter *ir,
+				     union xhci_trb *event_ring_deq,
+				     bool clear_ehb);

  /* xHCI roothub code */
  void xhci_set_link_state(struct xhci_hcd *xhci, struct xhci_port *port,
Wesley Cheng Jan. 26, 2024, 9:13 p.m. UTC | #4
Hi Mathias,

On 1/16/2024 12:24 PM, Wesley Cheng wrote:
> Hi Mathias,
> 
> On 1/15/2024 6:01 AM, Mathias Nyman wrote:
>> On 10.1.2024 1.42, Wesley Cheng wrote:
>>> Hi Mathias,
>>>
>>> On 1/8/2024 12:51 PM, Wesley Cheng wrote:
>>>> Hi Mathias,
>>>>
>>>> On 1/4/2024 6:48 AM, Mathias Nyman wrote:
>>>>> On 2.1.2024 23.45, Wesley Cheng wrote:
>>>>>> As part of xHCI bus suspend, the XHCI is halted.  However, if 
>>>>>> there are
>>>>>> pending events in the secondary event ring, it is observed that 
>>>>>> the xHCI
>>>>>> controller stops responding to further commands upon host or device
>>>>>> initiated bus resume.  Iterate through all pending events and 
>>>>>> update the
>>>>>> dequeue pointer to the beginning of the event ring.
>>>>>>
>>>>>> Signed-off-by: Wesley Cheng <quic_wcheng@quicinc.com>
>>>>> ...
>>>>>> +/*
>>>>>> + * Move the event ring dequeue pointer to skip events kept in the 
>>>>>> secondary
>>>>>> + * event ring.  This is used to ensure that pending events in the 
>>>>>> ring are
>>>>>> + * acknowledged, so the XHCI HCD can properly enter 
>>>>>> suspend/resume. The
>>>>>> + * secondary ring is typically maintained by an external component.
>>>>>> + */
>>>>>> +void xhci_skip_sec_intr_events(struct xhci_hcd *xhci,
>>>>>> +    struct xhci_ring *ring,    struct xhci_interrupter *ir)
>>>>>> +{
>>>>>> +    union xhci_trb *erdp_trb, *current_trb;
>>>>>> +    u64 erdp_reg;
>>>>>> +    u32 iman_reg;
>>>>>> +    dma_addr_t deq;
>>>>>> +
>>>>>> +    /* disable irq, ack pending interrupt and ack all pending 
>>>>>> events */
>>>>>> +    xhci_disable_interrupter(ir);
>>>>>> +    iman_reg = readl_relaxed(&ir->ir_set->irq_pending);
>>>>>> +    if (iman_reg & IMAN_IP)
>>>>>> +        writel_relaxed(iman_reg, &ir->ir_set->irq_pending);
>>>>>> +
>>>>>> +    /* last acked event trb is in erdp reg  */
>>>>>> +    erdp_reg = xhci_read_64(xhci, &ir->ir_set->erst_dequeue);
>>>>>> +    deq = (dma_addr_t)(erdp_reg & ERST_PTR_MASK);
>>>>>> +    if (!deq) {
>>>>>> +        xhci_err(xhci, "event ring handling not required\n");
>>>>>> +        return;
>>>>>> +    }
>>>>>> +
>>>>>> +    erdp_trb = current_trb = ir->event_ring->dequeue;
>>>>>> +    /* read cycle state of the last acked trb to find out CCS */
>>>>>> +    ring->cycle_state = le32_to_cpu(current_trb->event_cmd.flags) 
>>>>>> & TRB_CYCLE;
>>>>>> +
>>>>>> +    while (1) {
>>>>>> +        inc_deq(xhci, ir->event_ring);
>>>>>> +        erdp_trb = ir->event_ring->dequeue;
>>>>>> +        /* cycle state transition */
>>>>>> +        if ((le32_to_cpu(erdp_trb->event_cmd.flags) & TRB_CYCLE) !=
>>>>>> +            ring->cycle_state)
>>>>>> +            break;
>>>>>> +    }
>>>>>> +
>>>>>> +    xhci_update_erst_dequeue(xhci, ir, current_trb, true);
>>>>>> +}
>>>>>
>>>>> Code above is very similar to the existing event ring processing 
>>>>> parts of xhci_irq()
>>>>> and xhci_handle_event()
>>>>>
>>>>> I'll see if I can refactor the existing event ring processing, 
>>>>> decouple it from
>>>>> event handling so that it could be used by primary and secondary 
>>>>> interrupters with
>>>>> handlers, and this case where we just want to clear the event ring.
>>>>>
>>>>
>>>> Thanks, that makes sense.  Will take a look as well.
>>>>
>>>
>>> How about something like the below?  Tested this on my set up and 
>>> everything looks to be working fine.  Had to add another param to 
>>> struct xhci_interrupters to tell the XHCI interrupt handler to say if 
>>> that particular interrupter wants to skip_events (handling).  This 
>>> way, its something that the class driver utilizing the interrupter 
>>> will have to tell XHCI sideband.  It would allow the user to 
>>> determine if they want to use the interrupter to actually handle 
>>> events or not on the proc running Linux.
>>>
>>
>> Yes, I have something similar.
>> I'll share it soon, just need to
>> clean it up a bit fist.
>>
> 
> Sure, no worries.  Will test it when its available.  Thanks!
> 

Was just wondering if you had the time to clean up the changes?  If not, 
maybe you can provide a patch with whatever you have, and I can try my 
best to clean it up to your liking?  Thanks!

Thanks
Wesley Cheng
Wesley Cheng Feb. 1, 2024, 2:11 a.m. UTC | #5
Hi Mathias,

On 1/29/2024 7:44 AM, Mathias Nyman wrote:
> On 26.1.2024 23.13, Wesley Cheng wrote:
>> Hi Mathias,
>>
>> On 1/16/2024 12:24 PM, Wesley Cheng wrote:
>>> Hi Mathias,
>>>
>>> On 1/15/2024 6:01 AM, Mathias Nyman wrote:
>>>> On 10.1.2024 1.42, Wesley Cheng wrote:
>>>>> Hi Mathias,
>>>>>
>>>>> On 1/8/2024 12:51 PM, Wesley Cheng wrote:
>>>>>> Hi Mathias,
>>>>>>
>>>>>> On 1/4/2024 6:48 AM, Mathias Nyman wrote:
>>>>>>> On 2.1.2024 23.45, Wesley Cheng wrote:
>>>>>>>> As part of xHCI bus suspend, the XHCI is halted.  However, if 
>>>>>>>> there are
>>>>>>>> pending events in the secondary event ring, it is observed that 
>>>>>>>> the xHCI
>>>>>>>> controller stops responding to further commands upon host or device
>>>>>>>> initiated bus resume.  Iterate through all pending events and 
>>>>>>>> update the
>>>>>>>> dequeue pointer to the beginning of the event ring.
>>>>>>>>
>>>>>>>> Signed-off-by: Wesley Cheng <quic_wcheng@quicinc.com>
>>>>>>> ...
>>>>>>>> +/*
>>>>>>>> + * Move the event ring dequeue pointer to skip events kept in 
>>>>>>>> the secondary
>>>>>>>> + * event ring.  This is used to ensure that pending events in 
>>>>>>>> the ring are
>>>>>>>> + * acknowledged, so the XHCI HCD can properly enter 
>>>>>>>> suspend/resume. The
>>>>>>>> + * secondary ring is typically maintained by an external 
>>>>>>>> component.
>>>>>>>> + */
>>>>>>>> +void xhci_skip_sec_intr_events(struct xhci_hcd *xhci,
>>>>>>>> +    struct xhci_ring *ring,    struct xhci_interrupter *ir)
>>>>>>>> +{
>>>>>>>> +    union xhci_trb *erdp_trb, *current_trb;
>>>>>>>> +    u64 erdp_reg;
>>>>>>>> +    u32 iman_reg;
>>>>>>>> +    dma_addr_t deq;
>>>>>>>> +
>>>>>>>> +    /* disable irq, ack pending interrupt and ack all pending 
>>>>>>>> events */
>>>>>>>> +    xhci_disable_interrupter(ir);
>>>>>>>> +    iman_reg = readl_relaxed(&ir->ir_set->irq_pending);
>>>>>>>> +    if (iman_reg & IMAN_IP)
>>>>>>>> +        writel_relaxed(iman_reg, &ir->ir_set->irq_pending);
>>>>>>>> +
>>>>>>>> +    /* last acked event trb is in erdp reg  */
>>>>>>>> +    erdp_reg = xhci_read_64(xhci, &ir->ir_set->erst_dequeue);
>>>>>>>> +    deq = (dma_addr_t)(erdp_reg & ERST_PTR_MASK);
>>>>>>>> +    if (!deq) {
>>>>>>>> +        xhci_err(xhci, "event ring handling not required\n");
>>>>>>>> +        return;
>>>>>>>> +    }
>>>>>>>> +
>>>>>>>> +    erdp_trb = current_trb = ir->event_ring->dequeue;
>>>>>>>> +    /* read cycle state of the last acked trb to find out CCS */
>>>>>>>> +    ring->cycle_state = 
>>>>>>>> le32_to_cpu(current_trb->event_cmd.flags) & TRB_CYCLE;
>>>>>>>> +
>>>>>>>> +    while (1) {
>>>>>>>> +        inc_deq(xhci, ir->event_ring);
>>>>>>>> +        erdp_trb = ir->event_ring->dequeue;
>>>>>>>> +        /* cycle state transition */
>>>>>>>> +        if ((le32_to_cpu(erdp_trb->event_cmd.flags) & 
>>>>>>>> TRB_CYCLE) !=
>>>>>>>> +            ring->cycle_state)
>>>>>>>> +            break;
>>>>>>>> +    }
>>>>>>>> +
>>>>>>>> +    xhci_update_erst_dequeue(xhci, ir, current_trb, true);
>>>>>>>> +}
>>>>>>>
>>>>>>> Code above is very similar to the existing event ring processing 
>>>>>>> parts of xhci_irq()
>>>>>>> and xhci_handle_event()
>>>>>>>
>>>>>>> I'll see if I can refactor the existing event ring processing, 
>>>>>>> decouple it from
>>>>>>> event handling so that it could be used by primary and secondary 
>>>>>>> interrupters with
>>>>>>> handlers, and this case where we just want to clear the event ring.
>>>>>>>
>>>>>>
>>>>>> Thanks, that makes sense.  Will take a look as well.
>>>>>>
>>>>>
>>>>> How about something like the below?  Tested this on my set up and 
>>>>> everything looks to be working fine.  Had to add another param to 
>>>>> struct xhci_interrupters to tell the XHCI interrupt handler to say 
>>>>> if that particular interrupter wants to skip_events (handling).  
>>>>> This way, its something that the class driver utilizing the 
>>>>> interrupter will have to tell XHCI sideband.  It would allow the 
>>>>> user to determine if they want to use the interrupter to actually 
>>>>> handle events or not on the proc running Linux.
>>>>>
>>>>
>>>> Yes, I have something similar.
>>>> I'll share it soon, just need to
>>>> clean it up a bit fist.
>>>>
>>>
>>> Sure, no worries.  Will test it when its available.  Thanks!
>>>
>>
>> Was just wondering if you had the time to clean up the changes?  If 
>> not, maybe you can provide a patch with whatever you have, and I can 
>> try my best to clean it up to your liking?  Thanks!
> 
> Sure, got stuck fixing other issues.
>

No worries, tested the code briefly as is and it is working, with some 
minor modifications.

> Code is not yet cleaned up, commit messages are not ready etc, but 
> current work is in
> a fix_eventhandling branch:
> 
> git://git.kernel.org/pub/scm/linux/kernel/git/mnyman/xhci.git  
> fix_eventhandling
> https://git.kernel.org/pub/scm/linux/kernel/git/mnyman/xhci.git/log/?h=fix_eventhandling 
> 
> 
> I was in the middle of figuring out when and where the ip_autoclear and 
> interrupt
> moderation values should be set for secondary interrupters
> 

I set these currently when the client driver requests for the 
interrupter, ie xhci_sideband_create_interrupter().  If the client 
driver wants to actually have the secondary interrupter events handled 
by the OS then I added a path to call xhci_enable_interrupter() to 
enable that IRQ line.  Likewise, based on XHCI spec Figure 4-22, the 
IMAN interrupt enable (IE) bit controls basically when IMOD and IP 
autoclear mechanisms would come into the picture, so I placed these 
configurations before we set the IE bit.

For the most part, if we offload event ring handling to another 
processor, then IMOD and IE settings would be irrelevant IMO.

The only pitfall with this is that it gets a bit cumbersome (although 
flexible) for the client driver to know what these arguments actually do 
within the XHCI layer.  Working through your changes and will push 
something soon.  Thanks again for sharing the changes!

Thanks
Wesley Cheng
diff mbox series

Patch

diff --git a/drivers/usb/host/xhci-mem.c b/drivers/usb/host/xhci-mem.c
index 4460fa7e9fab..5bf74c37cbf6 100644
--- a/drivers/usb/host/xhci-mem.c
+++ b/drivers/usb/host/xhci-mem.c
@@ -1827,7 +1827,7 @@  xhci_remove_interrupter(struct xhci_hcd *xhci, struct xhci_interrupter *ir)
 		tmp &= ERST_SIZE_MASK;
 		writel(tmp, &ir->ir_set->erst_size);
 
-		xhci_write_64(xhci, ERST_EHB, &ir->ir_set->erst_dequeue);
+		xhci_update_erst_dequeue(xhci, ir, ir->event_ring->first_seg->trbs, true);
 	}
 }
 
@@ -1865,11 +1865,12 @@  void xhci_remove_secondary_interrupter(struct usb_hcd *hcd, struct xhci_interrup
 	if (!ir || !ir->intr_num || ir->intr_num >= xhci->max_interrupters)
 		xhci_dbg(xhci, "Invalid secondary interrupter, can't remove\n");
 
-	/* fixme, should we check xhci->interrupter[intr_num] == ir */
-	/* fixme locking */
-
 	spin_lock_irq(&xhci->lock);
-
+	/*
+	 * Cleanup secondary interrupter to ensure there are no pending events.
+	 * This also updates event ring dequeue pointer back to the start.
+	 */
+	xhci_skip_sec_intr_events(xhci, ir->event_ring, ir);
 	intr_num = ir->intr_num;
 
 	xhci_remove_interrupter(xhci, ir);
diff --git a/drivers/usb/host/xhci-ring.c b/drivers/usb/host/xhci-ring.c
index 33806ae966f9..448417c5d5b1 100644
--- a/drivers/usb/host/xhci-ring.c
+++ b/drivers/usb/host/xhci-ring.c
@@ -2980,7 +2980,7 @@  static int xhci_handle_event(struct xhci_hcd *xhci, struct xhci_interrupter *ir)
  * - When all events have finished
  * - To avoid "Event Ring Full Error" condition
  */
-static void xhci_update_erst_dequeue(struct xhci_hcd *xhci,
+void xhci_update_erst_dequeue(struct xhci_hcd *xhci,
 				     struct xhci_interrupter *ir,
 				     union xhci_trb *event_ring_deq,
 				     bool clear_ehb)
@@ -3013,6 +3013,50 @@  static void xhci_update_erst_dequeue(struct xhci_hcd *xhci,
 	xhci_write_64(xhci, temp_64, &ir->ir_set->erst_dequeue);
 }
 
+/*
+ * Move the event ring dequeue pointer to skip events kept in the secondary
+ * event ring.  This is used to ensure that pending events in the ring are
+ * acknowledged, so the XHCI HCD can properly enter suspend/resume.  The
+ * secondary ring is typically maintained by an external component.
+ */
+void xhci_skip_sec_intr_events(struct xhci_hcd *xhci,
+	struct xhci_ring *ring,	struct xhci_interrupter *ir)
+{
+	union xhci_trb *erdp_trb, *current_trb;
+	u64 erdp_reg;
+	u32 iman_reg;
+	dma_addr_t deq;
+
+	/* disable irq, ack pending interrupt and ack all pending events */
+	xhci_disable_interrupter(ir);
+	iman_reg = readl_relaxed(&ir->ir_set->irq_pending);
+	if (iman_reg & IMAN_IP)
+		writel_relaxed(iman_reg, &ir->ir_set->irq_pending);
+
+	/* last acked event trb is in erdp reg  */
+	erdp_reg = xhci_read_64(xhci, &ir->ir_set->erst_dequeue);
+	deq = (dma_addr_t)(erdp_reg & ERST_PTR_MASK);
+	if (!deq) {
+		xhci_err(xhci, "event ring handling not required\n");
+		return;
+	}
+
+	erdp_trb = current_trb = ir->event_ring->dequeue;
+	/* read cycle state of the last acked trb to find out CCS */
+	ring->cycle_state = le32_to_cpu(current_trb->event_cmd.flags) & TRB_CYCLE;
+
+	while (1) {
+		inc_deq(xhci, ir->event_ring);
+		erdp_trb = ir->event_ring->dequeue;
+		/* cycle state transition */
+		if ((le32_to_cpu(erdp_trb->event_cmd.flags) & TRB_CYCLE) !=
+		    ring->cycle_state)
+			break;
+	}
+
+	xhci_update_erst_dequeue(xhci, ir, current_trb, true);
+}
+
 /*
  * xHCI spec says we can get an interrupt, and if the HC has an error condition,
  * we might get bad data out of the event ring.  Section 4.10.2.7 has a list of
diff --git a/drivers/usb/host/xhci.c b/drivers/usb/host/xhci.c
index 573ca5c4f31a..eb15c63e6775 100644
--- a/drivers/usb/host/xhci.c
+++ b/drivers/usb/host/xhci.c
@@ -333,7 +333,7 @@  static int xhci_enable_interrupter(struct xhci_interrupter *ir)
 	return 0;
 }
 
-static int xhci_disable_interrupter(struct xhci_interrupter *ir)
+int xhci_disable_interrupter(struct xhci_interrupter *ir)
 {
 	u32 iman;
 
diff --git a/drivers/usb/host/xhci.h b/drivers/usb/host/xhci.h
index e98099b960e4..37887c2f0653 100644
--- a/drivers/usb/host/xhci.h
+++ b/drivers/usb/host/xhci.h
@@ -2093,6 +2093,9 @@  struct xhci_interrupter *
 xhci_create_secondary_interrupter(struct usb_hcd *hcd, int num_seg);
 void xhci_remove_secondary_interrupter(struct usb_hcd
 				       *hcd, struct xhci_interrupter *ir);
+void xhci_skip_sec_intr_events(struct xhci_hcd *xhci,
+	struct xhci_ring *ring,	struct xhci_interrupter *ir);
+int xhci_disable_interrupter(struct xhci_interrupter *ir);
 
 /* xHCI host controller glue */
 typedef void (*xhci_get_quirks_t)(struct device *, struct xhci_hcd *);
@@ -2180,6 +2183,10 @@  void inc_deq(struct xhci_hcd *xhci, struct xhci_ring *ring);
 unsigned int count_trbs(u64 addr, u64 len);
 int xhci_stop_endpoint_sync(struct xhci_hcd *xhci, struct xhci_virt_ep *ep,
 			    int suspend, gfp_t gfp_flags);
+void xhci_update_erst_dequeue(struct xhci_hcd *xhci,
+				     struct xhci_interrupter *ir,
+				     union xhci_trb *event_ring_deq,
+				     bool clear_ehb);
 
 /* xHCI roothub code */
 void xhci_set_link_state(struct xhci_hcd *xhci, struct xhci_port *port,