Changeset 17ceb72 in mainline for uspace/drv/uhci-hcd/uhci.c

Timestamp:

2011-03-14T01:39:44Z (14 years ago)

Author:

Jan Vesely <jano.vesely@…>

Branches:

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

Children:

6298d80

Parents:

3bd96bb

Message:

Doxygen

File:

• uspace/drv/uhci-hcd/uhci.c (modified) (3 diffs)

uspace/drv/uhci-hcd/uhci.c

@@ -60 +60 @@
 }
 /*----------------------------------------------------------------------------*/
+/** Get address of the device identified by handle.
+ *
+ * @param[in] dev DDF instance of the device to use.
+ * @param[in] iid (Unused).
+ * @param[in] call Pointer to the call that represents interrupt.
+ */
 static int usb_iface_get_address(
     ddf_fun_t *fun, devman_handle_t handle, usb_address_t *address)
@@ -106 +112 @@
 };
 /*----------------------------------------------------------------------------*/
-/** Gets root hub hw resources.
+/** Get root hub hw resources (I/O registers).
  *
  * @param[in] fun Root hub function.
@@ -127 +133 @@
 };
 /*----------------------------------------------------------------------------*/
+/** Initialize hc and rh ddf structures and their respective drivers.
+ *
+ * @param[in] instance UHCI structure to use.
+ * @param[in] device DDF instance of the device to use.
+ *
+ * This function does all the preparatory work for hc and rh drivers:
+ *  - gets device hw resources
+ *  - disables UHCI legacy support
+ *  - asks for interrupt
+ *  - registers interrupt handler
+ */
 int uhci_init(uhci_t *instance, ddf_dev_t *device)
 {