Changeset ca97cad in mainline for uspace/lib/libdrv/generic/remote_char.c

Timestamp:

2010-05-06T11:42:55Z (14 years ago)

Author:

Lenka Trochtova <trochtova.lenka@…>

Branches:

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

Children:

ab1aa871

Parents:

ba95e8f

Message:

writing to serial port using character interface

File:

• uspace/lib/libdrv/generic/remote_char.c (modified) (6 diffs)

uspace/lib/libdrv/generic/remote_char.c

@@ -45 +45 @@
 static void remote_char_write(device_t *dev, void *iface, ipc_callid_t callid, ipc_call_t *call);
 
+/** Remote character interface operations. 
+ */
 static remote_iface_func_ptr_t remote_char_iface_ops [] = {
         &remote_char_read,
@@ -50 +52 @@
 }; 
  
+/** Remote character interface structure. 
+ * Interface for processing request from remote clients addressed to the character interface.
+ */
 remote_iface_t remote_char_iface = {
         .method_count = sizeof(remote_char_iface_ops) / sizeof(remote_iface_func_ptr_t),
@@ -55 +60 @@
 };
 
+/** Process the read request from the remote client.
+ * 
+ * Receive the read request's parameters from the remote client and pass them to the local interface.
+ * Return the result of the operation processed by the local interface to the remote client.
+ * 
+ * @param dev the device from which the data are read.
+ * @param iface the local interface structure. 
+ */
 static void remote_char_read(device_t *dev, void *iface, ipc_callid_t callid, ipc_call_t *call)
 {       
@@ -86 +99 @@
         }
         
+        // the operation was successful, return the number of data read
         async_data_read_finalize(cid, buf, ret);
         ipc_answer_1(callid, EOK, ret); 
 }
 
+/** Process the write request from the remote client.
+ * 
+ * Receive the write request's parameters from the remote client and pass them to the local interface.
+ * Return the result of the operation processed by the local interface to the remote client.
+ * 
+ * @param dev the device to which the data are written.
+ * @param iface the local interface structure. 
+ */
 static void remote_char_write(device_t *dev, void *iface, ipc_callid_t callid, ipc_call_t *call)
 {
         char_iface_t *char_iface = (char_iface_t *)iface;
+        ipc_callid_t cid;
+        size_t len;
+        
+        if (!async_data_write_receive(&cid, &len)) {
+                // TODO handle protocol error
+                ipc_answer_0(callid, EINVAL);
+                return;
+    }
+        
         if (!char_iface->write) {
+                async_data_write_finalize(cid, NULL, 0);
                 ipc_answer_0(callid, ENOTSUP);
                 return;
         }       
-        
-        size_t len;
-        if (!async_data_write_receive(&callid, &len)) {
-                // TODO handle protocol error
-                return;
-    }
         
         if (len > MAX_CHAR_RW_COUNT) {
@@ -110 +136 @@
         char buf[MAX_CHAR_RW_COUNT];
         
-        async_data_write_finalize(callid, buf, len);
+        async_data_write_finalize(cid, buf, len);
         
         int ret = (*char_iface->write)(dev, buf, len);
@@ -116 +142 @@
                 ipc_answer_0(callid, ret);
         } else {
+                // the operation was successful, return the number of data written
                 ipc_answer_1(callid, EOK, ret);
         }