Changeset 79ae36dd in mainline for uspace/lib/usbdev/include/usb/dev/pipes.h

Timestamp:

2011-06-08T19:01:55Z (13 years ago)

Author:

Martin Decky <martin@…>

Branches:

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

Children:

0eff68e

Parents:

764d71e

Message:

new async framework with integrated exchange tracking

• strict isolation between low-level IPC and high-level async framework with integrated exchange tracking
  • each IPC connection is represented by an async_sess_t structure
  • each IPC exchange is represented by an async_exch_t structure
  • exchange management is either based on atomic messages (EXCHANGE_ATOMIC), locking (EXCHANGE_SERIALIZE) or connection cloning (EXCHANGE_CLONE)
• async_obsolete: temporary compatibility layer to keep old async clients working (several pieces of code are currently broken, but only non-essential functionality)
• IPC_M_PHONE_HANGUP is now method no. 0 (for elegant boolean evaluation)
• IPC_M_DEBUG_ALL has been renamed to IPC_M_DEBUG
• IPC_M_PING has been removed (VFS protocol now has VFS_IN_PING)
• console routines in libc have been rewritten for better abstraction
• additional use for libc-private header files (FILE structure opaque to the client)
• various cstyle changes (typos, indentation, missing externs in header files, improved comments, etc.)

File:

• uspace/lib/usbdev/include/usb/dev/pipes.h (modified) (3 diffs)

uspace/lib/usbdev/include/usb/dev/pipes.h

@@ -43 +43 @@
 #include <ddf/driver.h>
 #include <fibril_synch.h>
+#include <async.h>
 
 /** Abstraction of a physical connection to the device.
@@ -62 +63 @@
  *
  * Locking order: if you want to lock both mutexes
- * (@c guard and @c hc_phone_mutex), lock @c guard first.
- * It is not necessary to lock @c guard if you want to lock @c hc_phone_mutex
+ * (@c guard and @c hc_sess_mutex), lock @c guard first.
+ * It is not necessary to lock @c guard if you want to lock @c hc_sess_mutex
  * only.
  */
@@ -85 +86 @@
         size_t max_packet_size;
 
-        /** Phone to the host controller.
-         * Negative when no session is active.
-         * It is an error to access this member without @c hc_phone_mutex
+        /** Session to the host controller.
+         * NULL when no session is active.
+         * It is an error to access this member without @c hc_sess_mutex
          * being locked.
          * If call over the phone is to be made, it must be preceeded by
          * call to pipe_add_ref() [internal libusb function].
          */
-        int hc_phone;
+        async_sess_t *hc_sess;
 
-        /** Guard for serialization of requests over the phone. */
-        fibril_mutex_t hc_phone_mutex;
+        /** Guard for serialization of requests over the session. */
+        fibril_mutex_t hc_sess_mutex;
 
         /** Number of active transfers over the pipe. */