Changeset 3dba1ca in mainline for uspace/drv/usbhub/usbhub.c

Timestamp:

2011-04-05T20:12:26Z (14 years ago)

Author:

Matus Dekanek <smekideki@…>

Branches:

lfn, master, serial, ticket/834-toolchain-update, topic/msim-upgrade, topic/simplify-dev-export

Children:

a209648

Parents:

90d0522

Message:

some more comments

File:

• uspace/drv/usbhub/usbhub.c (modified) (6 diffs)

uspace/drv/usbhub/usbhub.c

@@ -76 +76 @@
                 async_usleep(1000 * 1000 * 10); /// \TODO proper number once
                 errorCode = usb_hub_check_hub_changes(hub_info);
-
         }
         usb_log_error("something in ctrl loop went wrong, errno %d\n",
@@ -85 +84 @@
 
 /// \TODO set_port_feature use
+/// \TODO unmess code
 
 //*********************************************
@@ -766 +766 @@
 }
 
+/**
+ * process hub over current change
+ *
+ * This means either to power off the hub or power it on.
+ * @param hub_info hub instance
+ * @param status hub status bitmask
+ * @return error code
+ */
 static int usb_process_hub_over_current(usb_hub_info_t * hub_info,
         usb_hub_status_t status)
@@ -788 +796 @@
 }
 
+/**
+ * process hub power change
+ *
+ * If the power has been lost, reestablish it.
+ * If it was reestablished, re-power all ports.
+ * @param hub_info hub instance
+ * @param status hub status bitmask
+ * @return error code
+ */
 static int usb_process_hub_power_change(usb_hub_info_t * hub_info,
         usb_hub_status_t status)
@@ -815 +832 @@
 }
 
-
+/**
+ * process hub interrupts
+ *
+ * The change can be either in the over-current condition or
+ * local-power lost condition.
+ * @param hub_info hub instance
+ */
 static void usb_hub_process_global_interrupt(usb_hub_info_t * hub_info){
         usb_log_debug("global interrupt on a hub\n");
@@ -850 +873 @@
 }
 
+/**
+ * this is an attempt to initialize non-removable devices in the hub
+ * 
+ * @param hub_info hub instance
+ * @param port port number, counting from 1
+ * @return error code
+ */
 static int initialize_non_removable(usb_hub_info_t * hub_info,
         unsigned int port) {