This USB CDC ACM implementation was written out of frustration with the example USB CDC class to UART bridge implementation provided by ST Micro.
This code re-writes the USB CDC implementation to hopefully overcome these limitations, but tries to not otherwise 'reinvent the wheel' where ST's existing code (V1.2.1) is serviceable as-is.
Improvements over the ST-provided example code are:
- Data loss and lockup issues in ST's example code are hopefully all addressed
- Both receive and transmit UART data transfers are DMA-accelerated.
- Fixed-value variables are declared as const wherever possible to reduce RAM usage.
- USB descriptors are written as more-maintainable structs.
Testing was done with a Linux host.
Rowley Crossworks for ARM is needed to compile this code. The source code is gcc-friendly, but you must adapt the code yourself if you wish to adopt a different tool chain.
The STM32F072B Discovery Kit precludes the use of UART2, as the available pins for this are mapped to incompatible devices.
The only available pins in the device used in STM32F072B Discovery Kit for UART4 share de-bouncing circuitry that artificially restricts the maximum data rate.
USBD_MAX_NUM_INTERFACES in usbd_conf.h must conform to the NUM_OF_CDC_UARTS value in usbd_cdc.h (nominally 2x NUM_OF_CDC_UARTS since each CDC has a Command and Data interface).
The Command and Data Interface numbers in the USB descriptor in usbd_desc.c must be continguous and start from zero.
An understanding of USB descriptors is important when modifying usb_desc.c. This data conveys the configuration of the device (including endpoint, etc.) to the host PC.
The UARTconfig array in stm32f0xx_hal_msp.c must be customized to suit the pin-mapping used in your application. The values provided were used on the STM32F072BDISCOVERY PCB.
The parameters array values in usbd_cdc.c must be consistent with both the UARTconfig array in stm32f0xx_hal_msp.c and the Command and Data Interface numbers in the USB descriptor in usbd_desc.c.
The DMA IRQ handlers in usbd_cdc.c must be consistent with the UARTconfig array in stm32f0xx_hal_msp.c.
USB transfers are handled via a distinct section of memory called "PMA". Read the ST documentation on this. At most, there is 1kBytes that must be shared across all endpoints. Consider the usage of this PMA memory when scaling up the number of UARTs and buffer sizes.