Changeset 79ae36dd in mainline for uspace/lib/usbvirt/include

Timestamp:

2011-06-08T19:01:55Z (14 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.)

Location:

uspace/lib/usbvirt/include/usbvirt

Files:

• device.h (modified) (4 diffs)
• ipc.h (modified) (3 diffs)

uspace/lib/usbvirt/include/usbvirt/device.h

@@ -33 +33 @@
  * Virtual USB device.
  */
+
 #ifndef LIBUSBVIRT_DEVICE_H_
 #define LIBUSBVIRT_DEVICE_H_
@@ -38 +39 @@
 #include <usb/usb.h>
 #include <usb/dev/request.h>
+#include <async.h>
 
 /** Maximum number of endpoints supported by virtual USB. */
@@ -194 +196 @@
          */
         usbvirt_device_state_t state;
-        /** Phone to the host controller.
+        /** Session to the host controller.
          * You shall treat this field as read only in your code.
          */
-        int vhc_phone;
+        async_sess_t *vhc_sess;
 };
 
@@ -213 +215 @@
     void *, size_t, size_t *);
 
-
 #endif
+
 /**
  * @}

uspace/lib/usbvirt/include/usbvirt/ipc.h

@@ -33 +33 @@
  * IPC wrappers for virtual USB.
  */
+
 #ifndef LIBUSBVIRT_IPC_H_
 #define LIBUSBVIRT_IPC_H_
@@ -40 +41 @@
 #include <bool.h>
 #include <usbvirt/device.h>
+#include <async.h>
 
 /** IPC methods communication between host controller and virtual device. */
@@ -52 +54 @@
 } usbvirt_hc_to_device_method_t;
 
-int usbvirt_ipc_send_control_read(int, void *, size_t,
+extern int usbvirt_ipc_send_control_read(async_sess_t *, void *, size_t,
     void *, size_t, size_t *);
-int usbvirt_ipc_send_control_write(int, void *, size_t,
+extern int usbvirt_ipc_send_control_write(async_sess_t *, void *, size_t,
     void *, size_t);
-int usbvirt_ipc_send_data_in(int, usb_endpoint_t, usb_transfer_type_t,
-    void *, size_t, size_t *);
-int usbvirt_ipc_send_data_out(int, usb_endpoint_t, usb_transfer_type_t,
-    void *, size_t);
+extern int usbvirt_ipc_send_data_in(async_sess_t *, usb_endpoint_t,
+    usb_transfer_type_t, void *, size_t, size_t *);
+extern int usbvirt_ipc_send_data_out(async_sess_t *, usb_endpoint_t,
+    usb_transfer_type_t, void *, size_t);
 
-bool usbvirt_is_usbvirt_method(sysarg_t);
-bool usbvirt_ipc_handle_call(usbvirt_device_t *, ipc_callid_t, ipc_call_t *);
+extern bool usbvirt_is_usbvirt_method(sysarg_t);
+extern bool usbvirt_ipc_handle_call(usbvirt_device_t *, ipc_callid_t,
+    ipc_call_t *);
 
 #endif
+
 /**
  * @}