Changeset 8300c72 in mainline for uspace/drv/bus

Timestamp:

2025-03-03T22:58:05Z (8 months ago)

Author:

Jiri Svoboda <jiri@…>

Branches:

master

Children:

77a0119

Parents:

f35749e

Message:

Quiesce devices before proceeding with shutdown.

Only implemented for e1k, uhci and xhci.

Location:

uspace/drv/bus/usb

Files:

• uhci/hc.c (modified) (2 diffs)
• uhci/hc.h (modified) (2 diffs)
• uhci/main.c (modified) (2 diffs)
• xhci/hc.c (modified) (2 diffs)
• xhci/hc.h (modified) (2 diffs)
• xhci/main.c (modified) (3 diffs)

uspace/drv/bus/usb/uhci/hc.c

@@ -1 +1 @@
 /*
+ * Copyright (c) 2025 Jiri Svoboda
  * Copyright (c) 2011 Jan Vesely
  * Copyright (c) 2018 Ondrej Hlavaty, Petr Manek
@@ -267 +268 @@
 }
 
+/** Quiesce host controller.
+ *
+ * @param[in] instance Host controller structure to use.
+ */
+int hc_quiesce(hc_device_t *hcd)
+{
+        hc_t *instance = hcd_to_hc(hcd);
+        uhci_regs_t *registers = instance->registers;
+
+        /* Reset everything, who knows what touched it before us */
+        pio_write_16(&registers->usbcmd, UHCI_CMD_GLOBAL_RESET);
+        fibril_usleep(50000); /* 50ms according to USB spec(root hub reset) */
+        pio_write_16(&registers->usbcmd, 0);
+
+        /* Reset hc, all states and counters. Hope that hw is not broken */
+        pio_write_16(&registers->usbcmd, UHCI_CMD_HCRESET);
+        do {
+                fibril_usleep(10);
+        } while ((pio_read_16(&registers->usbcmd) & UHCI_CMD_HCRESET) != 0);
+
+        return EOK;
+}
+
 /** Initialize UHCI hc hw resources.
  *

uspace/drv/bus/usb/uhci/hc.h

@@ -1 +1 @@
 /*
+ * Copyright (c) 2025 Jiri Svoboda
  * Copyright (c) 2011 Jan Vesely
  * Copyright (c) 2018 Ondrej Hlavaty
@@ -164 +165 @@
 extern errno_t hc_setup_roothub(hc_device_t *);
 extern errno_t hc_gone(hc_device_t *);
+extern errno_t hc_quiesce(hc_device_t *);
 
 #endif

uspace/drv/bus/usb/uhci/main.c

@@ -1 +1 @@
 /*
+ * Copyright (c) 2025 Jiri Svoboda
  * Copyright (c) 2011 Vojtech Horky, Jan Vesely
  * Copyright (c) 2018 Ondrej Hlavaty, Petr Manek
@@ -61 +62 @@
         .setup_root_hub = hc_setup_roothub,
         .hc_gone = hc_gone,
+        .hc_quiesce = hc_quiesce
 };
 

uspace/drv/bus/usb/xhci/hc.c

@@ -1 +1 @@
 /*
+ * Copyright (c) 2025 Jiri Svoboda
  * Copyright (c) 2018 Ondrej Hlavaty, Petr Manek, Jaroslav Jindrak, Jan Hrach, Michal Staruch
  * All rights reserved.
@@ -746 +747 @@
 }
 
+/**
+ * Quiesce host controller.
+ */
+errno_t hc_quiesce(xhci_hc_t *hc)
+{
+        hc_stop(hc);
+        usb_log_info("HC quiesced.");
+        return EOK;
+}
+
 unsigned hc_speed_to_psiv(usb_speed_t speed)
 {

uspace/drv/bus/usb/xhci/hc.h

@@ -1 +1 @@
 /*
+ * Copyright (c) 2025 Jiri Svoboda
  * Copyright (c) 2018 Ondrej Hlavaty, Jan Hrach, Jaroslav Jindrak, Petr Manek
  * All rights reserved.
@@ -119 +120 @@
 extern errno_t hc_start(xhci_hc_t *);
 extern void hc_fini(xhci_hc_t *);
+extern errno_t hc_quiesce(xhci_hc_t *);
 
 extern void hc_ring_doorbell(xhci_hc_t *, unsigned, unsigned);

uspace/drv/bus/usb/xhci/main.c

@@ -1 +1 @@
 /*
+ * Copyright (c) 2025 Jiri Svoboda
  * Copyright (c) 2018 Ondrej Hlavaty, Petr Manek
  * All rights reserved.
@@ -94 +95 @@
 }
 
+static errno_t hcd_hc_quiesce(hc_device_t *hcd)
+{
+        xhci_hc_t *hc = hcd_to_hc(hcd);
+        hc_quiesce(hc);
+        return EOK;
+}
+
 static const hc_driver_t xhci_driver = {
         .name = NAME,
@@ -103 +111 @@
         .start = hcd_start,
         .hc_gone = hcd_hc_gone,
+        .hc_quiesce = hcd_hc_quiesce
 };