Changeset e9ce696 in mainline

Timestamp:

2011-04-09T15:37:36Z (13 years ago)

Author:

Vojtech Horky <vojtechhorky@…>

Branches:

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

Children:

4ede178

Parents:

d48fcc0

Message:

Add functions for explicit long transfers

Location:

uspace/lib/usb

Files:

• include/usb/pipes.h (modified) (1 diff)
• src/pipes.c (modified) (5 diffs)

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

@@ -160 +160 @@
 bool usb_pipe_is_session_started(usb_pipe_t *);
 
+int usb_pipe_start_long_transfer(usb_pipe_t *);
+void usb_pipe_end_long_transfer(usb_pipe_t *);
+
 int usb_pipe_read(usb_pipe_t *, void *, size_t, size_t *);
 int usb_pipe_write(usb_pipe_t *, void *, size_t);

uspace/lib/usb/src/pipes.c

@@ -242 +242 @@
  * necessary.
  *
+ * @deprecated
+ * Obsoleted with introduction of usb_pipe_start_long_transfer
+ *
  * @param pipe Endpoint pipe to start the session on.
  * @return Error code.
@@ -247 +250 @@
 int usb_pipe_start_session(usb_pipe_t *pipe)
 {
-        return pipe_add_ref(pipe);
+        usb_log_warning("usb_pipe_start_session() was deprecated.\n");
+        return EOK;
 }
 
@@ -253 +257 @@
 /** Ends a session on the endpoint pipe.
  *
+ * @deprecated
+ * Obsoleted with introduction of usb_pipe_end_long_transfer
+ *
  * @see usb_pipe_start_session
  *
@@ -260 +267 @@
 int usb_pipe_end_session(usb_pipe_t *pipe)
 {
-        pipe_drop_ref(pipe);
+        usb_log_warning("usb_pipe_end_session() was deprecated.\n");
         return EOK;
 }
@@ -280 +287 @@
 }
 
+/** Prepare pipe for a long transfer.
+ *
+ * By a long transfer is mean transfer consisting of several
+ * requests to the HC.
+ * Calling such function is optional and it has positive effect of
+ * improved performance because IPC session is initiated only once.
+ *
+ * @param pipe Pipe over which the transfer will happen.
+ * @return Error code.
+ */
+int usb_pipe_start_long_transfer(usb_pipe_t *pipe)
+{
+        return pipe_add_ref(pipe);
+}
+
+/** Terminate a long transfer on a pipe.
+ *
+ * @see usb_pipe_start_long_transfer
+ *
+ * @param pipe Pipe where to end the long transfer.
+ */
+void usb_pipe_end_long_transfer(usb_pipe_t *pipe)
+{
+        pipe_drop_ref(pipe);
+}
+
 /**
  * @}