Changeset 357a302 in mainline for uspace/lib/drv/include

Timestamp:

2011-02-20T14:17:40Z (14 years ago)

Author:

Vojtech Horky <vojtechhorky@…>

Branches:

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

Children:

b68b279

Parents:

3ae93a8

Message:

USB interfaces reorganization

The most important change is that getting USB address of a device
is an operation of generic USB interface, not USB-HC interface.
That is needed for proper functionality of a MID driver.

Also added sample implementation of USB interface operations as is
needed by most drivers (sample does not mean unfunctional or partially
implemented here).
They are stored in libusb/ddfiface.h

Updated UHCI, UHCI-RH, hub, VHC drivers to use these sample
implementations.

Updated libusb device recognition routines to route get_address requests
through USB interface.

Location:

uspace/lib/drv/include

Files:

• usb_iface.h (modified) (2 diffs)
• usbhc_iface.h (modified) (2 diffs)

uspace/lib/drv/include/usb_iface.h

@@ -41 +41 @@
 #include <usb/usb.h>
 typedef enum {
+        /** Tell USB address assigned to device.
+         * Parameters:
+         * - devman handle id
+         * Answer:
+         * - EINVAL - unknown handle or handle not managed by this driver
+         * - ENOTSUP - operation not supported (shall not happen)
+         * - arbitrary error code if returned by remote implementation
+         * - EOK - handle found, first parameter contains the USB address
+         */
+        IPC_M_USB_GET_ADDRESS,
+
         /** Tell devman handle of device host controller.
          * Parameters:
@@ -55 +66 @@
 /** USB device communication interface. */
 typedef struct {
+        int (*get_address)(device_t *, devman_handle_t, usb_address_t *);
         int (*get_hc_handle)(device_t *, devman_handle_t *);
 } usb_iface_t;

uspace/lib/drv/include/usbhc_iface.h

@@ -85 +85 @@
  */
 typedef enum {
-        /** Tell USB address assigned to device.
-         * Parameters:
-         * - devman handle id
-         * Answer:
-         * - EINVAL - unknown handle or handle not managed by this driver
-         * - ENOTSUP - operation not supported by HC (shall not happen)
-         * - arbitrary error code if returned by remote implementation
-         * - EOK - handle found, first parameter contains the USB address
-         */
-        IPC_M_USBHC_GET_ADDRESS,
-
-
         /** Reserve usage of default address.
          * This call informs the host controller that the caller will be
@@ -206 +194 @@
 /** USB host controller communication interface. */
 typedef struct {
-        int (*tell_address)(device_t *, devman_handle_t, usb_address_t *);
-
         int (*reserve_default_address)(device_t *, usb_speed_t);
         int (*release_default_address)(device_t *);