STM32F4 HAL Composite USB Device Example : CDC + MSC

STM32F4 USB Composite CDC + MSC

I'm in the process of building a USB composite CDC + MSC device on the STM32F4 Discovery board but am having trouble getting windows to recognise it.

Using USBlyzer all the descriptor info seems ok but windows will only recognise the CDC (virtual com port). The port gets enumerated and I can open and close it but data goes to the wrong endpoint no matter how I swap them around. Also, windows completely ignores the MSC unless I disable the CDC and then it works fine.

Is there some trick to the descriptors to get both drivers to load (virtual com port + mass storage) or do I need a custom driver or .inf file. I've tried disabling the devices using USBDeview and reinstalling as well as different PIDs but no luck.

I've posted my descriptors below but am happy to post code or the whole project if it will help.

Thanks.

#define USBD_VID                     0x0483
#define USBD_PID                     0x5000
#define USBD_LANGID_STRING            0x409
#define USBD_MANUFACTURER_STRING      "STMicroelectronics"
#define USBD_PRODUCT_HS_STRING          "Composite Device HS Mode"
#define USBD_SERIALNUMBER_HS_STRING     "000000000001"
#define USBD_PRODUCT_FS_STRING          "Composite Device FS Mode"
#define USBD_SERIALNUMBER_FS_STRING     "000000000001"
#define USBD_CONFIGURATION_HS_STRING    "CDC/MSC Config"
#define USBD_INTERFACE_HS_STRING        "CDC/MSC Interface"
#define USBD_CONFIGURATION_FS_STRING    "CDC/MSC Config"
#define USBD_INTERFACE_FS_STRING        "CDC/MSC Interface"

__ALIGN_BEGIN uint8_t USBD_DeviceDesc[USB_SIZ_DEVICE_DESC] __ALIGN_END =
  {
    0x12,                       /*bLength */
    USB_DEVICE_DESCRIPTOR_TYPE, /*bDescriptorType*/
    0x00,                       /*bcdUSB */
    0x02,
    0xEF,                       /*bDeviceClass*/
    0x02,                       /*bDeviceSubClass*/
    0x01,                       /*bDeviceProtocol*/
    USB_OTG_MAX_EP0_SIZE,      /*bMaxPacketSize*/
    LOBYTE(USBD_VID),           /*idVendor*/
    HIBYTE(USBD_VID),           /*idVendor*/
    LOBYTE(USBD_PID),           /*idVendor*/
    HIBYTE(USBD_PID),           /*idVendor*/
    0x00,                       /*bcdDevice rel. 2.00*/
    0x02,
    USBD_IDX_MFC_STR,           /*Index of manufacturer  string*/
    USBD_IDX_PRODUCT_STR,       /*Index of product string*/
    USBD_IDX_SERIAL_STR,        /*Index of serial number string*/
    USBD_CFG_MAX_NUM            /*bNumConfigurations*/
  } ; /* USB_DeviceDescriptor */

/* USB device Configuration Descriptor */
__ALIGN_BEGIN static uint8_t USBD_CDC_MSC_CfgDesc[DESCRIPTOR_TOTAL_LENGTH] __ALIGN_END =
{
  /* Generic part */
  // CONFIGURATION DESCRIPTOR (9 bytes)
  0x09,                                              // bLength
  USB_CONFIGURATION_DESCRIPTOR_TYPE,                 // bDescriptorType
  DESCRIPTOR_TOTAL_LENGTH, 0x00,                     // wTotalLength
  0x03,                                  // bNumInterfaces
  0x01,                                  // bConfigurationvalue
  0x00,                               // iConfiguration Description offset
  0xC0,                   // bmAttributes, self powered
  0x32,                                      // Max. Power Consumption

    // IAD
    0x08,   // bLength: Interface Descriptor size
    0x0B,   // bDescriptorType: IAD
    0x00,   // bFirstInterface
    0x03,   // bInterfaceCount
    0x02,   // bFunctionClass: CDC
    0x02,   // bFunctionSubClass
    0x01,   // bFunctionProtocol
    0x02,   // iFunction

    /*Interface Descriptor*/
    0x09,   /* bLength: Interface Descriptor size */
    USB_INTERFACE_DESCRIPTOR_TYPE,  /* bDescriptorType: Interface */
    /* Interface descriptor type */
    0x00,   /* bInterfaceNumber: Number of Interface */
    0x00,   /* bAlternateSetting: Alternate setting */
    0x01,   /* bNumEndpoints: One endpoints used */
    0x02,   /* bInterfaceClass: Communication Interface Class */
    0x02,   /* bInterfaceSubClass: Abstract Control Model */
    0x01,   /* bInterfaceProtocol: Common AT commands */
    0x00,   /* iInterface: */

    /*Header Functional Descriptor*/
    0x05,   /* bLength: Endpoint Descriptor size */
    0x24,   /* bDescriptorType: CS_INTERFACE */
    0x00,   /* bDescriptorSubtype: Header Func Desc */
    0x10,   /* bcdCDC: spec release number */
    0x01,

    /*Call Managment Functional Descriptor*/
    0x05,   /* bFunctionLength */
    0x24,   /* bDescriptorType: CS_INTERFACE */
    0x01,   /* bDescriptorSubtype: Call Management Func Desc */
    0x00,   /* bmCapabilities: D0+D1 */
    0x01,   /* bDataInterface: 1 */

    /*ACM Functional Descriptor*/
    0x04,   /* bFunctionLength */
    0x24,   /* bDescriptorType: CS_INTERFACE */
    0x02,   /* bDescriptorSubtype: Abstract Control Management desc */
    0x02,   /* bmCapabilities */

    /*Union Functional Descriptor*/
    0x05,   /* bFunctionLength */
    0x24,   /* bDescriptorType: CS_INTERFACE */
    0x06,   /* bDescriptorSubtype: Union func desc */
    0x00,   /* bMasterInterface: Communication class interface */
    0x01,   /* bSlaveInterface0: Data Class Interface */

    /*Endpoint 2 Descriptor*/
    0x07,   /* bLength: Endpoint Descriptor size */
    USB_ENDPOINT_DESCRIPTOR_TYPE,   /* bDescriptorType: Endpoint */
    CDC_CMD_EP,   /* bEndpointAddress: (IN2) */
    0x03,   /* bmAttributes: Interrupt */
    0x08, 0x00,     /* wMaxPacketSize: */
    0xFF,   /* bInterval: */

    /*Data class interface descriptor*/
    0x09,   /* bLength: Endpoint Descriptor size */
    USB_INTERFACE_DESCRIPTOR_TYPE,  /* bDescriptorType: */
    0x01,   /* bInterfaceNumber: Number of Interface */
    0x00,   /* bAlternateSetting: Alternate setting */
    0x02,   /* bNumEndpoints: Two endpoints used */
    0x0A,   /* bInterfaceClass: CDC */
    0x00,   /* bInterfaceSubClass: */
    0x00,   /* bInterfaceProtocol: */
    0x00,   /* iInterface: */

    /*Endpoint 3 Descriptor*/
    0x07,   /* bLength: Endpoint Descriptor size */
    USB_ENDPOINT_DESCRIPTOR_TYPE,   /* bDescriptorType: Endpoint */
    CDC_OUT_EP,   /* bEndpointAddress: (OUT3) */
    0x02,   /* bmAttributes: Bulk */
    0x40, 0x00,              /* wMaxPacketSize: */
    0x00,   /* bInterval: ignore for Bulk transfer */

    /*Endpoint 1 Descriptor*/
    0x07,   /* bLength: Endpoint Descriptor size */
    USB_ENDPOINT_DESCRIPTOR_TYPE,   /* bDescriptorType: Endpoint */
    CDC_IN_EP,   /* bEndpointAddress: (IN1) */
    0x02,   /* bmAttributes: Bulk */
    0x40, 0x00,              /* wMaxPacketSize: */
    0x00,    /* bInterval */

    // -------- Descriptor for MSC class device ------------------------
  // INTERFACE DESCRIPTOR (9 bytes)
  0x09,                                       // bLength
  USB_INTERFACE_DESCRIPTOR_TYPE,              // bDescriptorType: 4
  0x02,                        // bInterfaceNumber
  0x00,                                       // bAlternateSetting
  0x02,                                       // bNumEndpoints
  0x08,                                  // bInterfaceClass: 8 = MSC Device
  0x06,                                       // bInterfaceSubClass:
  0x50,                                       // bInterfaceProtocol:
  0x01,                                  // iInterface:1

  0x07,                                       // bLength
  USB_ENDPOINT_DESCRIPTOR_TYPE,               // bDescriptorType
  MSC_IN_EP,                             // bEndpointAddress; bit7=1 for IN, bits 3-0=1 for ep1
  0x02,                               // *** bmAttributes, bulk
  0x40, 0x00,                                 // wMaxPacketSize, 64 bytes
  0X00,                                       // bInterval, ms

  0x07,                                       // bLength
  USB_ENDPOINT_DESCRIPTOR_TYPE,               // bDescriptorType
  MSC_OUT_EP,                            // bEndpointAddress; bit7=1 for IN, bits 3-0=1 for ep1
  0x02,                              // *** bmAttributes, bulk
  0x40, 0x00,                                 // wMaxPacketSize, 64 bytes
  0x00                                        // bInterval, ms
};

STM32F4 HAL Composite USB Device Example

Hi,

The STM32Cube FW package includes examples based on elementary USB classes (MSC, HID, CDC,...). 
Multi-interface applications (composite) are not yet developed. We’ll notify our development team about this subject.

Regards,
Heisenberg.

Thank you.

Could you please tell me if it is currently possible to achieve a composite USB device using the current version of STM32CubeF4 HAL library (so it is just lacking an example demonstration) or the libraries should be changed first (hopefully in the near future) to do that?

And, thank you for the STM32Cube initiative, it's still not as mature as the StdPeriph libraries, but I'm sure it will be, soon enough.

Hi,

It is possible to achieve your own composite USB Device, by combining the desired classes' drivers into one class, under your own folder within: Middlewares\ST\STM32_USB Device Library\Class

Regards,
Heisenberg.