Changes in uspace/lib/drv/include/usbhc_iface.h [46e078a:b7d8fd9] in mainline

File:

• uspace/lib/drv/include/usbhc_iface.h (modified) (7 diffs)

uspace/lib/drv/include/usbhc_iface.h

@@ -66 +66 @@
  *   - argument #1 is target address
  *   - argument #2 is target endpoint
+ *   - argument #3 is max packet size of the endpoint
  * - this call is immediately followed by IPC data read (async version)
  * - the call is not answered until the device returns some data (or until
@@ -84 +85 @@
  */
 typedef enum {
+        /** Reserve usage of default address.
+         * This call informs the host controller that the caller will be
+         * using default USB address. It is duty of the HC driver to ensure
+         * that only single entity will have it reserved.
+         * The address is returned via IPC_M_USBHC_RELEASE_DEFAULT_ADDRESS.
+         * The caller can start using the address after receiving EOK
+         * answer.
+         */
+        IPC_M_USBHC_RESERVE_DEFAULT_ADDRESS,
+
+        /** Release usage of default address.
+         * @see IPC_M_USBHC_RESERVE_DEFAULT_ADDRESS
+         */
+        IPC_M_USBHC_RELEASE_DEFAULT_ADDRESS,
+
         /** Asks for address assignment by host controller.
          * Answer:
@@ -153 +169 @@
         /** Register endpoint attributes at host controller.
          * This is used to reserve portion of USB bandwidth.
-         * When speed is invalid, speed of the device is used.
          * Parameters:
-         * - USB address + endpoint number
-         *   - packed as ADDR << 16 + EP
-         * - speed + transfer type + direction
-         *   - packed as ( SPEED << 8 + TYPE ) << 8 + DIR
-         * - maximum packet size + interval (in milliseconds)
-         *   - packed as MPS << 16 + INT
+         * - USB address + endpoint number (ADDR * 256 + EP)
+         * - transfer type + direction (TYPE * 256 + DIR)
+         * - maximum packet size
+         * - interval (in milliseconds)
          * Answer:
          * - EOK - reservation successful
@@ -189 +202 @@
 
 /** Out transfer processing function prototype. */
-typedef int (*usbhc_iface_transfer_out_t)(ddf_fun_t *, usb_target_t,
+typedef int (*usbhc_iface_transfer_out_t)(ddf_fun_t *, usb_target_t, size_t,
     void *, size_t,
     usbhc_iface_transfer_out_callback_t, void *);
@@ -197 +210 @@
 
 /** In transfer processing function prototype. */
-typedef int (*usbhc_iface_transfer_in_t)(ddf_fun_t *, usb_target_t,
+typedef int (*usbhc_iface_transfer_in_t)(ddf_fun_t *, usb_target_t, size_t,
     void *, size_t,
     usbhc_iface_transfer_in_callback_t, void *);
@@ -209 +222 @@
         int (*release_address)(ddf_fun_t *, usb_address_t);
 
-        int (*register_endpoint)(ddf_fun_t *,
-            usb_address_t, usb_speed_t, usb_endpoint_t,
+        int (*register_endpoint)(ddf_fun_t *, usb_address_t, usb_endpoint_t,
             usb_transfer_type_t, usb_direction_t, size_t, unsigned int);
         int (*unregister_endpoint)(ddf_fun_t *, usb_address_t, usb_endpoint_t,
@@ -222 +234 @@
 
         int (*control_write)(ddf_fun_t *, usb_target_t,
+            size_t,
             void *, size_t, void *, size_t,
             usbhc_iface_transfer_out_callback_t, void *);
 
         int (*control_read)(ddf_fun_t *, usb_target_t,
+            size_t,
             void *, size_t, void *, size_t,
             usbhc_iface_transfer_in_callback_t, void *);