mass_storage_device.cpp File Reference

Detailed Description

Date

April 9, 2021

Author

Matthew Kennedy, (c) 2021

This file implements a USB mass storage device with multiple LUNs, so multiple drives can be mounted at once.

Definition in file mass_storage_device.cpp.

Functions
static uint32_t	scsi_transport_transmit (const SCSITransport *transport, const uint8_t *data, size_t len)
static uint32_t	scsi_transport_transmit_start (const SCSITransport *transport, const uint8_t *data, size_t len)
static uint32_t	scsi_transport_transmit_wait (const SCSITransport *transport)
static uint32_t	scsi_transport_receive (const SCSITransport *transport, uint8_t *data, size_t len)
bool	msd_request_hook_new (USBDriver *usbp)

Variables
static const scsi_inquiry_response_t	default_scsi_inquiry_response
	Hardcoded default SCSI inquiry response structure.
static const scsi_unit_serial_number_inquiry_response_t	default_scsi_unit_serial_number_inquiry_response
	Hardcoded default SCSI unit serial number inquiry response structure.

Function Documentation

msd_request_hook_new()

bool msd_request_hook_new

(

USBDriver *

usbp

)

Definition at line 211 of file mass_storage_device.cpp.

                                           {
    /* check that the request is for interface 0.*/
    if (MSD_SETUP_INDEX(usbp->setup) != 0) {
        return false;
    }
 
    if (usbp->setup[0] == (USB_RTYPE_TYPE_CLASS | USB_RTYPE_RECIPIENT_INTERFACE | USB_RTYPE_DIR_HOST2DEV)
        && usbp->setup[1] == MSD_REQ_RESET) {
        /* Bulk-Only Mass Storage Reset (class-specific request)
        This request is used to reset the mass storage device and its associated interface.
        This class-specific request shall ready the device for the next CBW from the host. */
        /* Do any special reset code here. */
        /* The device shall NAK the status stage of the device request until
        * the Bulk-Only Mass Storage Reset is complete.
        * NAK EP1 in and out */
        // usbp->otg->ie[1].DIEPCTL = DIEPCTL_SNAK;
        // usbp->otg->oe[1].DOEPCTL = DOEPCTL_SNAK;
        /* response to this request using EP0 */
        usbSetupTransfer(usbp, 0, 0, NULL);
        return true;
    } else if (usbp->setup[0] == (USB_RTYPE_TYPE_CLASS | USB_RTYPE_RECIPIENT_INTERFACE | USB_RTYPE_DIR_DEV2HOST)
        && usbp->setup[1] == MSD_REQ_GET_MAX_LUN) {
        /* Return the maximum supported LUN. */
        static uint8_t zero = USB_MSD_LUN_COUNT - 1;
        usbSetupTransfer(usbp, &zero, 1, NULL);
        return true;
    }
 
    return false;
}

Referenced by hybridRequestHook().

Here is the caller graph for this function:

scsi_transport_receive()

static uint32_t scsi_transport_receive ( const SCSITransport *  transport, uint8_t *  data, size_t  len  )

static

Definition at line 66 of file mass_storage_device.cpp.

                                                                   {
    usb_scsi_transport_handler_t *trp = reinterpret_cast<usb_scsi_transport_handler_t*>(transport->handler);
    msg_t status = usbReceive(trp->usbp, trp->ep, data, len);
    if (MSG_RESET != status)
        return status;
    else
        return 0;
}

Referenced by MassStorageController::MassStorageController().

Here is the caller graph for this function:

scsi_transport_transmit()

static uint32_t scsi_transport_transmit ( const SCSITransport *  transport, const uint8_t *  data, size_t  len  )

static

Definition at line 37 of file mass_storage_device.cpp.

                                                                         {
    usb_scsi_transport_handler_t *trp = reinterpret_cast<usb_scsi_transport_handler_t*>(transport->handler);
    msg_t status = usbTransmit(trp->usbp, trp->ep, data, len);
    if (MSG_OK == status)
        return len;
    else
        return 0;
}

Referenced by MassStorageController::MassStorageController().

Here is the caller graph for this function:

scsi_transport_transmit_start()

static uint32_t scsi_transport_transmit_start ( const SCSITransport *  transport, const uint8_t *  data, size_t  len  )

static

Definition at line 47 of file mass_storage_device.cpp.

                                                                               {
    usb_scsi_transport_handler_t *trp = reinterpret_cast<usb_scsi_transport_handler_t*>(transport->handler);
    msg_t status = usbTransmitStart(trp->usbp, trp->ep, data, len);
    if (MSG_OK == status)
        return len;
    else
        return 0;
}

Referenced by MassStorageController::MassStorageController().

Here is the caller graph for this function:

scsi_transport_transmit_wait()

static uint32_t scsi_transport_transmit_wait ( const SCSITransport *  transport )

static

Definition at line 57 of file mass_storage_device.cpp.

                                                                             {
    usb_scsi_transport_handler_t *trp = reinterpret_cast<usb_scsi_transport_handler_t*>(transport->handler);
    msg_t status = usbTransmitWait(trp->usbp, trp->ep);
    if (MSG_OK == status)
        return 0;
    else
        return 1;
}

Referenced by MassStorageController::MassStorageController().

Here is the caller graph for this function:

Variable Documentation

default_scsi_inquiry_response

const scsi_inquiry_response_t default_scsi_inquiry_response

static

Initial value:

= {
    0x00,           
    0x80,           
    0x04,           
    0x02,           
    0x20,           
    0x00,
    0x00,
    0x00,
    "Chibios",
    "Mass Storage",
    {'v',CH_KERNEL_MAJOR+'0','.',CH_KERNEL_MINOR+'0'}
}

Hardcoded default SCSI inquiry response structure.

Definition at line 156 of file mass_storage_device.cpp.

                                                                     {
    0x00,           /* direct access block device     */
    0x80,           /* removable                      */
    0x04,           /* SPC-2                          */
    0x02,           /* response data format           */
    0x20,           /* response has 0x20 + 4 bytes    */
    0x00,
    0x00,
    0x00,
    "Chibios",
    "Mass Storage",
    {'v',CH_KERNEL_MAJOR+'0','.',CH_KERNEL_MINOR+'0'}
};

Referenced by MassStorageController::attachLun().

default_scsi_unit_serial_number_inquiry_response

const scsi_unit_serial_number_inquiry_response_t default_scsi_unit_serial_number_inquiry_response

static

Initial value:

=
{
    0x00,
    0x80,
    0x00,
    0x08,
    "0000000"
}

Hardcoded default SCSI unit serial number inquiry response structure.

Definition at line 173 of file mass_storage_device.cpp.

{
    0x00,
    0x80,
    0x00,
    0x08,
    "0000000"
};

Referenced by MassStorageController::attachLun().

Go to the source code of this file.