Changeset 1916d1f in mainline for uspace/drv/bus/usb/usbmast/mast.c

Timestamp:

2011-07-12T13:41:26Z (13 years ago)

Author:

Petr Koupy <petr.koupy@…>

Branches:

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

Children:

50fc490

Parents:

11809eab (diff), 6817eba (diff)
Note: this is a merge changeset, the changes displayed below correspond to the merge itself.
Use the (diff) links above to see all the changes relative to each parent.

Message:

Merge libposix changes.

File:

• uspace/drv/bus/usb/usbmast/mast.c (modified) (7 diffs)

uspace/drv/bus/usb/usbmast/mast.c

@@ -42 +42 @@
 #include <usb/dev/request.h>
 
-bool usb_mast_verbose = true;
+bool usb_mast_verbose = false;
 
 #define MASTLOG(format, ...) \
         do { \
                 if (usb_mast_verbose) { \
-                        usb_log_debug("USB cl08: " format, ##__VA_ARGS__); \
+                        usb_log_debug2("USB cl08: " format, ##__VA_ARGS__); \
                 } \
         } while (false)
 
-/** Request data from mass storage device.
- *
- * @param bulk_in_pipe Bulk in pipe to the device.
- * @param bulk_out_pipe Bulk out pipe to the device.
- * @param tag Command block wrapper tag (automatically compared with answer).
- * @param lun LUN index.
- * @param cmd SCSI command buffer (in SCSI endianness).
- * @param cmd_size Length of SCSI command @p cmd in bytes.
- * @param in_buffer Buffer where to store the answer (CSW is not returned).
- * @param in_buffer_size Size of the buffer (size of the request to the device).
- * @param received_size Number of actually received bytes.
- * @return Error code.
- */
-int usb_massstor_data_in(usb_device_t *dev,
-    size_t bulk_in_pipe_index, size_t bulk_out_pipe_index,
-    uint32_t tag, uint8_t lun, void *cmd, size_t cmd_size,
-    void *in_buffer, size_t in_buffer_size, size_t *received_size)
+/** Send command via bulk-only transport.
+ *
+ * @param tag           Command block wrapper tag (automatically compared
+ *                      with answer)
+ * @param lun           LUN
+ * @param cmd           Command block
+ * @param cmd_size      Command block size in bytes
+ * @param ddir          Direction in which data will be transferred
+ * @param dbuf          Data send/receive buffer
+ * @param dbuf_size     Size of the data buffer
+ * @param xferred_size  Number of bytes actually transferred
+ *
+ * @return              Error code
+ */
+static int usb_massstor_cmd(usb_device_t *dev, uint32_t tag, uint8_t lun,
+    const void *cmd, size_t cmd_size, usb_direction_t ddir, void *dbuf,
+    size_t dbuf_size, size_t *xferred_size)
 {
         int rc;
         size_t act_size;
-        usb_pipe_t *bulk_in_pipe = dev->pipes[bulk_in_pipe_index].pipe;
-        usb_pipe_t *bulk_out_pipe = dev->pipes[bulk_out_pipe_index].pipe;
+        usb_pipe_t *bulk_in_pipe = dev->pipes[BULK_IN_EP].pipe;
+        usb_pipe_t *bulk_out_pipe = dev->pipes[BULK_OUT_EP].pipe;
 
         /* Prepare CBW - command block wrapper */
         usb_massstor_cbw_t cbw;
-        usb_massstor_cbw_prepare(&cbw, tag, in_buffer_size,
-            USB_DIRECTION_IN, lun, cmd_size, cmd);
-
-        /* First, send the CBW. */
+        usb_massstor_cbw_prepare(&cbw, tag, dbuf_size, ddir, lun, cmd_size,
+            cmd);
+
+        /* Send the CBW. */
         rc = usb_pipe_write(bulk_out_pipe, &cbw, sizeof(cbw));
         MASTLOG("CBW '%s' sent: %s.\n",
@@ -88 +88 @@
         }
 
-        /* Try to retrieve the data from the device. */
-        act_size = 0;
-        rc = usb_pipe_read(bulk_in_pipe, in_buffer, in_buffer_size, &act_size);
-        MASTLOG("Received %zuB (%s): %s.\n", act_size,
-            usb_debug_str_buffer((uint8_t *) in_buffer, act_size, 0),
-            str_error(rc));
-        if (rc != EOK) {
+        if (ddir == USB_DIRECTION_IN) {
+                /* Recieve data from the device. */
+                rc = usb_pipe_read(bulk_in_pipe, dbuf, dbuf_size, &act_size);
+                MASTLOG("Received %zu bytes (%s): %s.\n", act_size,
+                    usb_debug_str_buffer((uint8_t *) dbuf, act_size, 0),
+                    str_error(rc));
+        } else {
+                /* Send data to the device. */
+                rc = usb_pipe_write(bulk_out_pipe, dbuf, dbuf_size);
+                MASTLOG("Sent %zu bytes (%s): %s.\n", act_size,
+                    usb_debug_str_buffer((uint8_t *) dbuf, act_size, 0),
+                    str_error(rc));
+        }
+
+        if (rc != EOK) {
+                /*
+                 * XXX If the pipe is stalled, we should clear it
+                 * and read CSW.
+                 */
                 return rc;
         }
@@ -102 +114 @@
         size_t csw_size;
         rc = usb_pipe_read(bulk_in_pipe, &csw, sizeof(csw), &csw_size);
-        MASTLOG("CSW '%s' received (%zuB): %s.\n",
+        MASTLOG("CSW '%s' received (%zu bytes): %s.\n",
             usb_debug_str_buffer((uint8_t *) &csw, csw_size, 0), csw_size,
             str_error(rc));
         if (rc != EOK) {
-                return rc;
-        }
+                MASTLOG("rc != EOK\n");
+                return rc;
+        }
+
         if (csw_size != sizeof(csw)) {
+                MASTLOG("csw_size != sizeof(csw)\n");
                 return ERANGE;
         }
 
         if (csw.dCSWTag != tag) {
+                MASTLOG("csw.dCSWTag != tag\n");
                 return EBADCHECKSUM;
         }
@@ -120 +136 @@
          */
         if (csw.dCSWStatus != 0) {
+                MASTLOG("csw.dCSWStatus != 0\n");
                 // FIXME: better error code
                 // FIXME: distinguish 0x01 and 0x02
@@ -126 +143 @@
 
         size_t residue = (size_t) uint32_usb2host(csw.dCSWDataResidue);
-        if (residue > in_buffer_size) {
+        if (residue > dbuf_size) {
+                MASTLOG("residue > dbuf_size\n");
                 return ERANGE;
         }
-        if (act_size != in_buffer_size - residue) {
-                return ERANGE;
-        }
-        if (received_size != NULL) {
-                *received_size = in_buffer_size - residue;
-        }
+
+        /*
+         * When the device has less data to send than requested (or cannot
+         * receive moredata), it can either stall the pipe or send garbage
+         * (ignore data) and indicate that via the residue field in CSW.
+         * That means dbuf_size - residue is the authoritative size of data
+         * received (sent).
+         */
+
+        if (xferred_size != NULL)
+                *xferred_size = dbuf_size - residue;
 
         return EOK;
+}
+
+/** Perform data-in command.
+ *
+ * @param tag           Command block wrapper tag (automatically compared with
+ *                      answer)
+ * @param lun           LUN
+ * @param cmd           CDB (Command Descriptor)
+ * @param cmd_size      CDB length in bytes
+ * @param dbuf          Data receive buffer
+ * @param dbuf_size     Data receive buffer size in bytes
+ * @param proc_size     Number of bytes actually processed by device
+ *
+ * @return Error code
+ */
+int usb_massstor_data_in(usb_device_t *dev, uint32_t tag, uint8_t lun,
+    const void *cmd, size_t cmd_size, void *dbuf, size_t dbuf_size, size_t *proc_size)
+{
+        return usb_massstor_cmd(dev, tag, lun, cmd, cmd_size, USB_DIRECTION_IN,
+            dbuf, dbuf_size, proc_size);
+}
+
+/** Perform data-out command.
+ *
+ * @param tag           Command block wrapper tag (automatically compared with
+ *                      answer)
+ * @param lun           LUN
+ * @param cmd           CDB (Command Descriptor)
+ * @param cmd_size      CDB length in bytes
+ * @param data          Command data
+ * @param data_size     Size of @a data in bytes
+ * @param proc_size     Number of bytes actually processed by device
+ *
+ * @return Error code
+ */
+int usb_massstor_data_out(usb_device_t *dev, uint32_t tag, uint8_t lun,
+    const void *cmd, size_t cmd_size, const void *data, size_t data_size,
+    size_t *proc_size)
+{
+        return usb_massstor_cmd(dev, tag, lun, cmd, cmd_size, USB_DIRECTION_OUT,
+            (void *) data, data_size, proc_size);
 }
 
@@ -157 +221 @@
  *
  * @param dev Device to be reseted.
- * @param bulk_in_idx Index of bulk in pipe.
- * @param bulk_out_idx Index of bulk out pipe.
- */
-void usb_massstor_reset_recovery(usb_device_t *dev,
-    size_t bulk_in_idx, size_t bulk_out_idx)
+ */
+void usb_massstor_reset_recovery(usb_device_t *dev)
 {
         /* We would ignore errors here because if this fails
@@ -167 +228 @@
          */
         usb_massstor_reset(dev);
-        usb_pipe_clear_halt(&dev->ctrl_pipe, dev->pipes[bulk_in_idx].pipe);
-        usb_pipe_clear_halt(&dev->ctrl_pipe, dev->pipes[bulk_out_idx].pipe);
+        usb_pipe_clear_halt(&dev->ctrl_pipe, dev->pipes[BULK_IN_EP].pipe);
+        usb_pipe_clear_halt(&dev->ctrl_pipe, dev->pipes[BULK_OUT_EP].pipe);
 }