Changeset 15d3b54 in mainline for uspace/drv/uhci-hcd/uhci_hc.h

Timestamp:

2011-03-14T21:24:02Z (14 years ago)

Author:

Jan Vesely <jano.vesely@…>

Branches:

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

Children:

fcf07e6

Parents:

c69209d (diff), 9370884 (diff)
Note: this is a merge changeset, the changes displayed below correspond to the merge itself.
Use the (diff) links above to see all the changes relative to each parent.

Message:

Doxygen comments, enable hw interrupts if possible

File:

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

uspace/drv/uhci-hcd/uhci_hc.h

@@ -27 +27 @@
  */
 
-/** @addtogroup drvusbuhci
+/** @addtogroup drvusbuhcihc
  * @{
  */
 /** @file
- * @brief UHCI driver
+ * @brief UHCI host controller driver structure
  */
 #ifndef DRV_UHCI_UHCI_HC_H
@@ -99 +99 @@
         fid_t cleaner;
         fid_t debug_checker;
+        bool hw_interrupts;
 
         ddf_fun_t *ddf_instance;
 } uhci_hc_t;
 
-/* init uhci specifics in device.driver_data */
-int uhci_hc_init(uhci_hc_t *instance, ddf_fun_t *fun, void *regs, size_t reg_size);
-
-static inline void uhci_hc_fini(uhci_hc_t *instance) { /* TODO: implement*/ };
+int uhci_hc_init(uhci_hc_t *instance, ddf_fun_t *fun,
+    void *regs, size_t reg_size, bool interupts);
 
 int uhci_hc_schedule(uhci_hc_t *instance, batch_t *batch);
@@ -112 +111 @@
 void uhci_hc_interrupt(uhci_hc_t *instance, uint16_t status);
 
+/** Safely dispose host controller internal structures
+ *
+ * @param[in] instance Host controller structure to use.
+ */
+static inline void uhci_hc_fini(uhci_hc_t *instance) { /* TODO: implement*/ };
+
+/** Get and cast pointer to the driver data
+ *
+ * @param[in] fun DDF function pointer
+ * @return cast pointer to driver_data
+ */
 static inline uhci_hc_t * fun_to_uhci_hc(ddf_fun_t *fun)
         { return (uhci_hc_t*)fun->driver_data; }