Add LUFA-111009-BETA tag.
[pub/USBasp.git] / Demos / Device / ClassDriver / VirtualSerialMassStorage / Lib / SCSI.c
index 78783f0..66b58a1 100644 (file)
-/*\r
-             LUFA Library\r
-     Copyright (C) Dean Camera, 2011.\r
-\r
-  dean [at] fourwalledcubicle [dot] com\r
-           www.lufa-lib.org\r
-*/\r
-\r
-/*\r
-  Copyright 2011  Dean Camera (dean [at] fourwalledcubicle [dot] com)\r
-\r
-  Permission to use, copy, modify, distribute, and sell this\r
-  software and its documentation for any purpose is hereby granted\r
-  without fee, provided that the above copyright notice appear in\r
-  all copies and that both that the copyright notice and this\r
-  permission notice and warranty disclaimer appear in supporting\r
-  documentation, and that the name of the author not be used in\r
-  advertising or publicity pertaining to distribution of the\r
-  software without specific, written prior permission.\r
-\r
-  The author disclaim all warranties with regard to this\r
-  software, including all implied warranties of merchantability\r
-  and fitness.  In no event shall the author be liable for any\r
-  special, indirect or consequential damages or any damages\r
-  whatsoever resulting from loss of use, data or profits, whether\r
-  in an action of contract, negligence or other tortious action,\r
-  arising out of or in connection with the use or performance of\r
-  this software.\r
-*/\r
-\r
-/** \file\r
- *\r
- *  SCSI command processing routines, for SCSI commands issued by the host. Mass Storage\r
- *  devices use a thin "Bulk-Only Transport" protocol for issuing commands and status information,\r
- *  which wrap around standard SCSI device commands for controlling the actual storage medium.\r
- */\r
-\r
-#define  INCLUDE_FROM_SCSI_C\r
-#include "SCSI.h"\r
-\r
-/** Structure to hold the SCSI response data to a SCSI INQUIRY command. This gives information about the device's\r
- *  features and capabilities.\r
- */\r
-static const SCSI_Inquiry_Response_t InquiryData =\r
-       {\r
-               .DeviceType          = DEVICE_TYPE_BLOCK,\r
-               .PeripheralQualifier = 0,\r
-\r
-               .Removable           = true,\r
-\r
-               .Version             = 0,\r
-\r
-               .ResponseDataFormat  = 2,\r
-               .NormACA             = false,\r
-               .TrmTsk              = false,\r
-               .AERC                = false,\r
-\r
-               .AdditionalLength    = 0x1F,\r
-\r
-               .SoftReset           = false,\r
-               .CmdQue              = false,\r
-               .Linked              = false,\r
-               .Sync                = false,\r
-               .WideBus16Bit        = false,\r
-               .WideBus32Bit        = false,\r
-               .RelAddr             = false,\r
-\r
-               .VendorID            = "LUFA",\r
-               .ProductID           = "Dataflash Disk",\r
-               .RevisionID          = {'0','.','0','0'},\r
-       };\r
-\r
-/** Structure to hold the sense data for the last issued SCSI command, which is returned to the host after a SCSI REQUEST SENSE\r
- *  command is issued. This gives information on exactly why the last command failed to complete.\r
- */\r
-static SCSI_Request_Sense_Response_t SenseData =\r
-       {\r
-               .ResponseCode        = 0x70,\r
-               .AdditionalLength    = 0x0A,\r
-       };\r
-\r
-\r
-/** Main routine to process the SCSI command located in the Command Block Wrapper read from the host. This dispatches\r
- *  to the appropriate SCSI command handling routine if the issued command is supported by the device, else it returns\r
- *  a command failure due to a ILLEGAL REQUEST.\r
- *\r
- *  \param[in] MSInterfaceInfo  Pointer to the Mass Storage class interface structure that the command is associated with\r
- *\r
- *  \return Boolean true if the command completed successfully, false otherwise\r
- */\r
-bool SCSI_DecodeSCSICommand(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)\r
-{\r
-       bool CommandSuccess = false;\r
-\r
-       /* Run the appropriate SCSI command hander function based on the passed command */\r
-       switch (MSInterfaceInfo->State.CommandBlock.SCSICommandData[0])\r
-       {\r
-               case SCSI_CMD_INQUIRY:\r
-                       CommandSuccess = SCSI_Command_Inquiry(MSInterfaceInfo);\r
-                       break;\r
-               case SCSI_CMD_REQUEST_SENSE:\r
-                       CommandSuccess = SCSI_Command_Request_Sense(MSInterfaceInfo);\r
-                       break;\r
-               case SCSI_CMD_READ_CAPACITY_10:\r
-                       CommandSuccess = SCSI_Command_Read_Capacity_10(MSInterfaceInfo);\r
-                       break;\r
-               case SCSI_CMD_SEND_DIAGNOSTIC:\r
-                       CommandSuccess = SCSI_Command_Send_Diagnostic(MSInterfaceInfo);\r
-                       break;\r
-               case SCSI_CMD_WRITE_10:\r
-                       CommandSuccess = SCSI_Command_ReadWrite_10(MSInterfaceInfo, DATA_WRITE);\r
-                       break;\r
-               case SCSI_CMD_READ_10:\r
-                       CommandSuccess = SCSI_Command_ReadWrite_10(MSInterfaceInfo, DATA_READ);\r
-                       break;\r
-               case SCSI_CMD_MODE_SENSE_6:\r
-                       CommandSuccess = SCSI_Command_ModeSense_6(MSInterfaceInfo);\r
-                       break;\r
-               case SCSI_CMD_TEST_UNIT_READY:\r
-               case SCSI_CMD_PREVENT_ALLOW_MEDIUM_REMOVAL:\r
-               case SCSI_CMD_VERIFY_10:\r
-                       /* These commands should just succeed, no handling required */\r
-                       CommandSuccess = true;\r
-                       MSInterfaceInfo->State.CommandBlock.DataTransferLength = 0;\r
-                       break;\r
-               default:\r
-                       /* Update the SENSE key to reflect the invalid command */\r
-                       SCSI_SET_SENSE(SCSI_SENSE_KEY_ILLEGAL_REQUEST,\r
-                                  SCSI_ASENSE_INVALID_COMMAND,\r
-                                  SCSI_ASENSEQ_NO_QUALIFIER);\r
-                       break;\r
-       }\r
-\r
-       /* Check if command was successfully processed */\r
-       if (CommandSuccess)\r
-       {\r
-               SCSI_SET_SENSE(SCSI_SENSE_KEY_GOOD,\r
-                              SCSI_ASENSE_NO_ADDITIONAL_INFORMATION,\r
-                              SCSI_ASENSEQ_NO_QUALIFIER);\r
-\r
-               return true;\r
-       }\r
-\r
-       return false;\r
-}\r
-\r
-/** Command processing for an issued SCSI INQUIRY command. This command returns information about the device's features\r
- *  and capabilities to the host.\r
- *\r
- *  \param[in] MSInterfaceInfo  Pointer to the Mass Storage class interface structure that the command is associated with\r
- *\r
- *  \return Boolean true if the command completed successfully, false otherwise.\r
- */\r
-static bool SCSI_Command_Inquiry(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)\r
-{\r
-       uint16_t AllocationLength  = SwapEndian_16(*(uint16_t*)&MSInterfaceInfo->State.CommandBlock.SCSICommandData[3]);\r
-       uint16_t BytesTransferred  = (AllocationLength < sizeof(InquiryData))? AllocationLength :\r
-                                                                              sizeof(InquiryData);\r
-\r
-       /* Only the standard INQUIRY data is supported, check if any optional INQUIRY bits set */\r
-       if ((MSInterfaceInfo->State.CommandBlock.SCSICommandData[1] & ((1 << 0) | (1 << 1))) ||\r
-            MSInterfaceInfo->State.CommandBlock.SCSICommandData[2])\r
-       {\r
-               /* Optional but unsupported bits set - update the SENSE key and fail the request */\r
-               SCSI_SET_SENSE(SCSI_SENSE_KEY_ILLEGAL_REQUEST,\r
-                              SCSI_ASENSE_INVALID_FIELD_IN_CDB,\r
-                              SCSI_ASENSEQ_NO_QUALIFIER);\r
-\r
-               return false;\r
-       }\r
-\r
-       Endpoint_Write_Stream_LE(&InquiryData, BytesTransferred, NULL);\r
-\r
-       /* Pad out remaining bytes with 0x00 */\r
-       Endpoint_Null_Stream((AllocationLength - BytesTransferred), NULL);\r
-\r
-       /* Finalize the stream transfer to send the last packet */\r
-       Endpoint_ClearIN();\r
-\r
-       /* Succeed the command and update the bytes transferred counter */\r
-       MSInterfaceInfo->State.CommandBlock.DataTransferLength -= BytesTransferred;\r
-\r
-       return true;\r
-}\r
-\r
-/** Command processing for an issued SCSI REQUEST SENSE command. This command returns information about the last issued command,\r
- *  including the error code and additional error information so that the host can determine why a command failed to complete.\r
- *\r
- *  \param[in] MSInterfaceInfo  Pointer to the Mass Storage class interface structure that the command is associated with\r
- *\r
- *  \return Boolean true if the command completed successfully, false otherwise.\r
- */\r
-static bool SCSI_Command_Request_Sense(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)\r
-{\r
-       uint8_t  AllocationLength = MSInterfaceInfo->State.CommandBlock.SCSICommandData[4];\r
-       uint8_t  BytesTransferred = (AllocationLength < sizeof(SenseData))? AllocationLength : sizeof(SenseData);\r
-\r
-       Endpoint_Write_Stream_LE(&SenseData, BytesTransferred, NULL);\r
-       Endpoint_Null_Stream((AllocationLength - BytesTransferred), NULL);\r
-       Endpoint_ClearIN();\r
-\r
-       /* Succeed the command and update the bytes transferred counter */\r
-       MSInterfaceInfo->State.CommandBlock.DataTransferLength -= BytesTransferred;\r
-\r
-       return true;\r
-}\r
-\r
-/** Command processing for an issued SCSI READ CAPACITY (10) command. This command returns information about the device's capacity\r
- *  on the selected Logical Unit (drive), as a number of OS-sized blocks.\r
- *\r
- *  \param[in] MSInterfaceInfo  Pointer to the Mass Storage class interface structure that the command is associated with\r
- *\r
- *  \return Boolean true if the command completed successfully, false otherwise.\r
- */\r
-static bool SCSI_Command_Read_Capacity_10(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)\r
-{\r
-       uint32_t LastBlockAddressInLUN = (LUN_MEDIA_BLOCKS - 1);\r
-       uint32_t MediaBlockSize        = VIRTUAL_MEMORY_BLOCK_SIZE;\r
-\r
-       Endpoint_Write_Stream_BE(&LastBlockAddressInLUN, sizeof(LastBlockAddressInLUN), NULL);\r
-       Endpoint_Write_Stream_BE(&MediaBlockSize, sizeof(MediaBlockSize), NULL);\r
-       Endpoint_ClearIN();\r
-\r
-       /* Succeed the command and update the bytes transferred counter */\r
-       MSInterfaceInfo->State.CommandBlock.DataTransferLength -= 8;\r
-\r
-       return true;\r
-}\r
-\r
-/** Command processing for an issued SCSI SEND DIAGNOSTIC command. This command performs a quick check of the Dataflash ICs on the\r
- *  board, and indicates if they are present and functioning correctly. Only the Self-Test portion of the diagnostic command is\r
- *  supported.\r
- *\r
- *  \param[in] MSInterfaceInfo  Pointer to the Mass Storage class interface structure that the command is associated with\r
- *\r
- *  \return Boolean true if the command completed successfully, false otherwise.\r
- */\r
-static bool SCSI_Command_Send_Diagnostic(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)\r
-{\r
-       /* Check to see if the SELF TEST bit is not set */\r
-       if (!(MSInterfaceInfo->State.CommandBlock.SCSICommandData[1] & (1 << 2)))\r
-       {\r
-               /* Only self-test supported - update SENSE key and fail the command */\r
-               SCSI_SET_SENSE(SCSI_SENSE_KEY_ILLEGAL_REQUEST,\r
-                              SCSI_ASENSE_INVALID_FIELD_IN_CDB,\r
-                              SCSI_ASENSEQ_NO_QUALIFIER);\r
-\r
-               return false;\r
-       }\r
-\r
-       /* Check to see if all attached Dataflash ICs are functional */\r
-       if (!(DataflashManager_CheckDataflashOperation()))\r
-       {\r
-               /* Update SENSE key with a hardware error condition and return command fail */\r
-               SCSI_SET_SENSE(SCSI_SENSE_KEY_HARDWARE_ERROR,\r
-                              SCSI_ASENSE_NO_ADDITIONAL_INFORMATION,\r
-                              SCSI_ASENSEQ_NO_QUALIFIER);\r
-\r
-               return false;\r
-       }\r
-\r
-       /* Succeed the command and update the bytes transferred counter */\r
-       MSInterfaceInfo->State.CommandBlock.DataTransferLength = 0;\r
-\r
-       return true;\r
-}\r
-\r
-/** Command processing for an issued SCSI READ (10) or WRITE (10) command. This command reads in the block start address\r
- *  and total number of blocks to process, then calls the appropriate low-level Dataflash routine to handle the actual\r
- *  reading and writing of the data.\r
- *\r
- *  \param[in] MSInterfaceInfo  Pointer to the Mass Storage class interface structure that the command is associated with\r
- *  \param[in] IsDataRead  Indicates if the command is a READ (10) command or WRITE (10) command (DATA_READ or DATA_WRITE)\r
- *\r
- *  \return Boolean true if the command completed successfully, false otherwise.\r
- */\r
-static bool SCSI_Command_ReadWrite_10(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo,\r
-                                      const bool IsDataRead)\r
-{\r
-       uint32_t BlockAddress;\r
-       uint16_t TotalBlocks;\r
-\r
-       /* Check if the disk is write protected or not */\r
-       if ((IsDataRead == DATA_WRITE) && DISK_READ_ONLY)\r
-       {\r
-               /* Block address is invalid, update SENSE key and return command fail */\r
-               SCSI_SET_SENSE(SCSI_SENSE_KEY_DATA_PROTECT,\r
-                              SCSI_ASENSE_WRITE_PROTECTED,\r
-                              SCSI_ASENSEQ_NO_QUALIFIER);\r
-\r
-               return false;           \r
-       }\r
-\r
-       /* Load in the 32-bit block address (SCSI uses big-endian, so have to reverse the byte order) */\r
-       BlockAddress = SwapEndian_32(*(uint32_t*)&MSInterfaceInfo->State.CommandBlock.SCSICommandData[2]);\r
-\r
-       /* Load in the 16-bit total blocks (SCSI uses big-endian, so have to reverse the byte order) */\r
-       TotalBlocks  = SwapEndian_16(*(uint16_t*)&MSInterfaceInfo->State.CommandBlock.SCSICommandData[7]);\r
-\r
-       /* Check if the block address is outside the maximum allowable value for the LUN */\r
-       if (BlockAddress >= LUN_MEDIA_BLOCKS)\r
-       {\r
-               /* Block address is invalid, update SENSE key and return command fail */\r
-               SCSI_SET_SENSE(SCSI_SENSE_KEY_ILLEGAL_REQUEST,\r
-                              SCSI_ASENSE_LOGICAL_BLOCK_ADDRESS_OUT_OF_RANGE,\r
-                              SCSI_ASENSEQ_NO_QUALIFIER);\r
-\r
-               return false;\r
-       }\r
-\r
-       #if (TOTAL_LUNS > 1)\r
-       /* Adjust the given block address to the real media address based on the selected LUN */\r
-       BlockAddress += ((uint32_t)MSInterfaceInfo->State.CommandBlock.LUN * LUN_MEDIA_BLOCKS);\r
-       #endif\r
-       \r
-       /* Determine if the packet is a READ (10) or WRITE (10) command, call appropriate function */\r
-       if (IsDataRead == DATA_READ)\r
-         DataflashManager_ReadBlocks(MSInterfaceInfo, BlockAddress, TotalBlocks);\r
-       else\r
-         DataflashManager_WriteBlocks(MSInterfaceInfo, BlockAddress, TotalBlocks);\r
-\r
-       /* Update the bytes transferred counter and succeed the command */\r
-       MSInterfaceInfo->State.CommandBlock.DataTransferLength -= ((uint32_t)TotalBlocks * VIRTUAL_MEMORY_BLOCK_SIZE);\r
-\r
-       return true;\r
-}\r
-\r
-/** Command processing for an issued SCSI MODE SENSE (6) command. This command returns various informational pages about\r
- *  the SCSI device, as well as the device's Write Protect status.\r
- *\r
- *  \param[in] MSInterfaceInfo  Pointer to the Mass Storage class interface structure that the command is associated with\r
- *\r
- *  \return Boolean true if the command completed successfully, false otherwise.\r
- */\r
-static bool SCSI_Command_ModeSense_6(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)\r
-{\r
-       /* Send an empty header response with the Write Protect flag status */\r
-       Endpoint_Write_Byte(0x00);\r
-       Endpoint_Write_Byte(0x00);\r
-       Endpoint_Write_Byte(DISK_READ_ONLY ? 0x80 : 0x00);\r
-       Endpoint_Write_Byte(0x00);\r
-       Endpoint_ClearIN();\r
-\r
-       /* Update the bytes transferred counter and succeed the command */\r
-       MSInterfaceInfo->State.CommandBlock.DataTransferLength -= 4;\r
-\r
-       return true;\r
-}\r
+/*
+             LUFA Library
+     Copyright (C) Dean Camera, 2011.
+
+  dean [at] fourwalledcubicle [dot] com
+           www.lufa-lib.org
+*/
+
+/*
+  Copyright 2011  Dean Camera (dean [at] fourwalledcubicle [dot] com)
+
+  Permission to use, copy, modify, distribute, and sell this
+  software and its documentation for any purpose is hereby granted
+  without fee, provided that the above copyright notice appear in
+  all copies and that both that the copyright notice and this
+  permission notice and warranty disclaimer appear in supporting
+  documentation, and that the name of the author not be used in
+  advertising or publicity pertaining to distribution of the
+  software without specific, written prior permission.
+
+  The author disclaim all warranties with regard to this
+  software, including all implied warranties of merchantability
+  and fitness.  In no event shall the author be liable for any
+  special, indirect or consequential damages or any damages
+  whatsoever resulting from loss of use, data or profits, whether
+  in an action of contract, negligence or other tortious action,
+  arising out of or in connection with the use or performance of
+  this software.
+*/
+
+/** \file
+ *
+ *  SCSI command processing routines, for SCSI commands issued by the host. Mass Storage
+ *  devices use a thin "Bulk-Only Transport" protocol for issuing commands and status information,
+ *  which wrap around standard SCSI device commands for controlling the actual storage medium.
+ */
+
+#define  INCLUDE_FROM_SCSI_C
+#include "SCSI.h"
+
+/** Structure to hold the SCSI response data to a SCSI INQUIRY command. This gives information about the device's
+ *  features and capabilities.
+ */
+static const SCSI_Inquiry_Response_t InquiryData =
+       {
+               .DeviceType          = DEVICE_TYPE_BLOCK,
+               .PeripheralQualifier = 0,
+
+               .Removable           = true,
+
+               .Version             = 0,
+
+               .ResponseDataFormat  = 2,
+               .NormACA             = false,
+               .TrmTsk              = false,
+               .AERC                = false,
+
+               .AdditionalLength    = 0x1F,
+
+               .SoftReset           = false,
+               .CmdQue              = false,
+               .Linked              = false,
+               .Sync                = false,
+               .WideBus16Bit        = false,
+               .WideBus32Bit        = false,
+               .RelAddr             = false,
+
+               .VendorID            = "LUFA",
+               .ProductID           = "Dataflash Disk",
+               .RevisionID          = {'0','.','0','0'},
+       };
+
+/** Structure to hold the sense data for the last issued SCSI command, which is returned to the host after a SCSI REQUEST SENSE
+ *  command is issued. This gives information on exactly why the last command failed to complete.
+ */
+static SCSI_Request_Sense_Response_t SenseData =
+       {
+               .ResponseCode        = 0x70,
+               .AdditionalLength    = 0x0A,
+       };
+
+
+/** Main routine to process the SCSI command located in the Command Block Wrapper read from the host. This dispatches
+ *  to the appropriate SCSI command handling routine if the issued command is supported by the device, else it returns
+ *  a command failure due to a ILLEGAL REQUEST.
+ *
+ *  \param[in] MSInterfaceInfo  Pointer to the Mass Storage class interface structure that the command is associated with
+ *
+ *  \return Boolean true if the command completed successfully, false otherwise
+ */
+bool SCSI_DecodeSCSICommand(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
+{
+       bool CommandSuccess = false;
+
+       /* Run the appropriate SCSI command hander function based on the passed command */
+       switch (MSInterfaceInfo->State.CommandBlock.SCSICommandData[0])
+       {
+               case SCSI_CMD_INQUIRY:
+                       CommandSuccess = SCSI_Command_Inquiry(MSInterfaceInfo);
+                       break;
+               case SCSI_CMD_REQUEST_SENSE:
+                       CommandSuccess = SCSI_Command_Request_Sense(MSInterfaceInfo);
+                       break;
+               case SCSI_CMD_READ_CAPACITY_10:
+                       CommandSuccess = SCSI_Command_Read_Capacity_10(MSInterfaceInfo);
+                       break;
+               case SCSI_CMD_SEND_DIAGNOSTIC:
+                       CommandSuccess = SCSI_Command_Send_Diagnostic(MSInterfaceInfo);
+                       break;
+               case SCSI_CMD_WRITE_10:
+                       CommandSuccess = SCSI_Command_ReadWrite_10(MSInterfaceInfo, DATA_WRITE);
+                       break;
+               case SCSI_CMD_READ_10:
+                       CommandSuccess = SCSI_Command_ReadWrite_10(MSInterfaceInfo, DATA_READ);
+                       break;
+               case SCSI_CMD_MODE_SENSE_6:
+                       CommandSuccess = SCSI_Command_ModeSense_6(MSInterfaceInfo);
+                       break;
+               case SCSI_CMD_TEST_UNIT_READY:
+               case SCSI_CMD_PREVENT_ALLOW_MEDIUM_REMOVAL:
+               case SCSI_CMD_VERIFY_10:
+                       /* These commands should just succeed, no handling required */
+                       CommandSuccess = true;
+                       MSInterfaceInfo->State.CommandBlock.DataTransferLength = 0;
+                       break;
+               default:
+                       /* Update the SENSE key to reflect the invalid command */
+                       SCSI_SET_SENSE(SCSI_SENSE_KEY_ILLEGAL_REQUEST,
+                                  SCSI_ASENSE_INVALID_COMMAND,
+                                  SCSI_ASENSEQ_NO_QUALIFIER);
+                       break;
+       }
+
+       /* Check if command was successfully processed */
+       if (CommandSuccess)
+       {
+               SCSI_SET_SENSE(SCSI_SENSE_KEY_GOOD,
+                              SCSI_ASENSE_NO_ADDITIONAL_INFORMATION,
+                              SCSI_ASENSEQ_NO_QUALIFIER);
+
+               return true;
+       }
+
+       return false;
+}
+
+/** Command processing for an issued SCSI INQUIRY command. This command returns information about the device's features
+ *  and capabilities to the host.
+ *
+ *  \param[in] MSInterfaceInfo  Pointer to the Mass Storage class interface structure that the command is associated with
+ *
+ *  \return Boolean true if the command completed successfully, false otherwise.
+ */
+static bool SCSI_Command_Inquiry(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
+{
+       uint16_t AllocationLength  = SwapEndian_16(*(uint16_t*)&MSInterfaceInfo->State.CommandBlock.SCSICommandData[3]);
+       uint16_t BytesTransferred  = MIN(AllocationLength, sizeof(InquiryData));
+
+       /* Only the standard INQUIRY data is supported, check if any optional INQUIRY bits set */
+       if ((MSInterfaceInfo->State.CommandBlock.SCSICommandData[1] & ((1 << 0) | (1 << 1))) ||
+            MSInterfaceInfo->State.CommandBlock.SCSICommandData[2])
+       {
+               /* Optional but unsupported bits set - update the SENSE key and fail the request */
+               SCSI_SET_SENSE(SCSI_SENSE_KEY_ILLEGAL_REQUEST,
+                              SCSI_ASENSE_INVALID_FIELD_IN_CDB,
+                              SCSI_ASENSEQ_NO_QUALIFIER);
+
+               return false;
+       }
+
+       Endpoint_Write_Stream_LE(&InquiryData, BytesTransferred, NULL);
+
+       /* Pad out remaining bytes with 0x00 */
+       Endpoint_Null_Stream((AllocationLength - BytesTransferred), NULL);
+
+       /* Finalize the stream transfer to send the last packet */
+       Endpoint_ClearIN();
+
+       /* Succeed the command and update the bytes transferred counter */
+       MSInterfaceInfo->State.CommandBlock.DataTransferLength -= BytesTransferred;
+
+       return true;
+}
+
+/** Command processing for an issued SCSI REQUEST SENSE command. This command returns information about the last issued command,
+ *  including the error code and additional error information so that the host can determine why a command failed to complete.
+ *
+ *  \param[in] MSInterfaceInfo  Pointer to the Mass Storage class interface structure that the command is associated with
+ *
+ *  \return Boolean true if the command completed successfully, false otherwise.
+ */
+static bool SCSI_Command_Request_Sense(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
+{
+       uint8_t  AllocationLength = MSInterfaceInfo->State.CommandBlock.SCSICommandData[4];
+       uint8_t  BytesTransferred = MIN(AllocationLength, sizeof(SenseData));
+
+       Endpoint_Write_Stream_LE(&SenseData, BytesTransferred, NULL);
+       Endpoint_Null_Stream((AllocationLength - BytesTransferred), NULL);
+       Endpoint_ClearIN();
+
+       /* Succeed the command and update the bytes transferred counter */
+       MSInterfaceInfo->State.CommandBlock.DataTransferLength -= BytesTransferred;
+
+       return true;
+}
+
+/** Command processing for an issued SCSI READ CAPACITY (10) command. This command returns information about the device's capacity
+ *  on the selected Logical Unit (drive), as a number of OS-sized blocks.
+ *
+ *  \param[in] MSInterfaceInfo  Pointer to the Mass Storage class interface structure that the command is associated with
+ *
+ *  \return Boolean true if the command completed successfully, false otherwise.
+ */
+static bool SCSI_Command_Read_Capacity_10(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
+{
+       uint32_t LastBlockAddressInLUN = (LUN_MEDIA_BLOCKS - 1);
+       uint32_t MediaBlockSize        = VIRTUAL_MEMORY_BLOCK_SIZE;
+
+       Endpoint_Write_Stream_BE(&LastBlockAddressInLUN, sizeof(LastBlockAddressInLUN), NULL);
+       Endpoint_Write_Stream_BE(&MediaBlockSize, sizeof(MediaBlockSize), NULL);
+       Endpoint_ClearIN();
+
+       /* Succeed the command and update the bytes transferred counter */
+       MSInterfaceInfo->State.CommandBlock.DataTransferLength -= 8;
+
+       return true;
+}
+
+/** Command processing for an issued SCSI SEND DIAGNOSTIC command. This command performs a quick check of the Dataflash ICs on the
+ *  board, and indicates if they are present and functioning correctly. Only the Self-Test portion of the diagnostic command is
+ *  supported.
+ *
+ *  \param[in] MSInterfaceInfo  Pointer to the Mass Storage class interface structure that the command is associated with
+ *
+ *  \return Boolean true if the command completed successfully, false otherwise.
+ */
+static bool SCSI_Command_Send_Diagnostic(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
+{
+       /* Check to see if the SELF TEST bit is not set */
+       if (!(MSInterfaceInfo->State.CommandBlock.SCSICommandData[1] & (1 << 2)))
+       {
+               /* Only self-test supported - update SENSE key and fail the command */
+               SCSI_SET_SENSE(SCSI_SENSE_KEY_ILLEGAL_REQUEST,
+                              SCSI_ASENSE_INVALID_FIELD_IN_CDB,
+                              SCSI_ASENSEQ_NO_QUALIFIER);
+
+               return false;
+       }
+
+       /* Check to see if all attached Dataflash ICs are functional */
+       if (!(DataflashManager_CheckDataflashOperation()))
+       {
+               /* Update SENSE key with a hardware error condition and return command fail */
+               SCSI_SET_SENSE(SCSI_SENSE_KEY_HARDWARE_ERROR,
+                              SCSI_ASENSE_NO_ADDITIONAL_INFORMATION,
+                              SCSI_ASENSEQ_NO_QUALIFIER);
+
+               return false;
+       }
+
+       /* Succeed the command and update the bytes transferred counter */
+       MSInterfaceInfo->State.CommandBlock.DataTransferLength = 0;
+
+       return true;
+}
+
+/** Command processing for an issued SCSI READ (10) or WRITE (10) command. This command reads in the block start address
+ *  and total number of blocks to process, then calls the appropriate low-level Dataflash routine to handle the actual
+ *  reading and writing of the data.
+ *
+ *  \param[in] MSInterfaceInfo  Pointer to the Mass Storage class interface structure that the command is associated with
+ *  \param[in] IsDataRead  Indicates if the command is a READ (10) command or WRITE (10) command (DATA_READ or DATA_WRITE)
+ *
+ *  \return Boolean true if the command completed successfully, false otherwise.
+ */
+static bool SCSI_Command_ReadWrite_10(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo,
+                                      const bool IsDataRead)
+{
+       uint32_t BlockAddress;
+       uint16_t TotalBlocks;
+
+       /* Check if the disk is write protected or not */
+       if ((IsDataRead == DATA_WRITE) && DISK_READ_ONLY)
+       {
+               /* Block address is invalid, update SENSE key and return command fail */
+               SCSI_SET_SENSE(SCSI_SENSE_KEY_DATA_PROTECT,
+                              SCSI_ASENSE_WRITE_PROTECTED,
+                              SCSI_ASENSEQ_NO_QUALIFIER);
+
+               return false;           
+       }
+
+       /* Load in the 32-bit block address (SCSI uses big-endian, so have to reverse the byte order) */
+       BlockAddress = SwapEndian_32(*(uint32_t*)&MSInterfaceInfo->State.CommandBlock.SCSICommandData[2]);
+
+       /* Load in the 16-bit total blocks (SCSI uses big-endian, so have to reverse the byte order) */
+       TotalBlocks  = SwapEndian_16(*(uint16_t*)&MSInterfaceInfo->State.CommandBlock.SCSICommandData[7]);
+
+       /* Check if the block address is outside the maximum allowable value for the LUN */
+       if (BlockAddress >= LUN_MEDIA_BLOCKS)
+       {
+               /* Block address is invalid, update SENSE key and return command fail */
+               SCSI_SET_SENSE(SCSI_SENSE_KEY_ILLEGAL_REQUEST,
+                              SCSI_ASENSE_LOGICAL_BLOCK_ADDRESS_OUT_OF_RANGE,
+                              SCSI_ASENSEQ_NO_QUALIFIER);
+
+               return false;
+       }
+
+       #if (TOTAL_LUNS > 1)
+       /* Adjust the given block address to the real media address based on the selected LUN */
+       BlockAddress += ((uint32_t)MSInterfaceInfo->State.CommandBlock.LUN * LUN_MEDIA_BLOCKS);
+       #endif
+       
+       /* Determine if the packet is a READ (10) or WRITE (10) command, call appropriate function */
+       if (IsDataRead == DATA_READ)
+         DataflashManager_ReadBlocks(MSInterfaceInfo, BlockAddress, TotalBlocks);
+       else
+         DataflashManager_WriteBlocks(MSInterfaceInfo, BlockAddress, TotalBlocks);
+
+       /* Update the bytes transferred counter and succeed the command */
+       MSInterfaceInfo->State.CommandBlock.DataTransferLength -= ((uint32_t)TotalBlocks * VIRTUAL_MEMORY_BLOCK_SIZE);
+
+       return true;
+}
+
+/** Command processing for an issued SCSI MODE SENSE (6) command. This command returns various informational pages about
+ *  the SCSI device, as well as the device's Write Protect status.
+ *
+ *  \param[in] MSInterfaceInfo  Pointer to the Mass Storage class interface structure that the command is associated with
+ *
+ *  \return Boolean true if the command completed successfully, false otherwise.
+ */
+static bool SCSI_Command_ModeSense_6(USB_ClassInfo_MS_Device_t* const MSInterfaceInfo)
+{
+       /* Send an empty header response with the Write Protect flag status */
+       Endpoint_Write_8(0x00);
+       Endpoint_Write_8(0x00);
+       Endpoint_Write_8(DISK_READ_ONLY ? 0x80 : 0x00);
+       Endpoint_Write_8(0x00);
+       Endpoint_ClearIN();
+
+       /* Update the bytes transferred counter and succeed the command */
+       MSInterfaceInfo->State.CommandBlock.DataTransferLength -= 4;
+
+       return true;
+}