Tomas Cerskus / USBDevice

USB device stack with Nucleo F401RE support. NOTE: the default clock config needs to be changed to in order for USB to work.

Fork of USBDevice by Tomas Cerskus

Slightly modified original USBDevice library to support F401RE.

On F401RE the data pins of your USB connector should be attached to PA12 (D+) and PA11(D-). It is also required to connect the +5V USB line to PA9.

F401RE requires 48MHz clock for USB. Therefore in order for this to work you will need to change the default clock settings:

Clock settings for USB

#include "stm32f4xx_hal.h"

RCC_OscInitTypeDef RCC_OscInitStruct;
RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSI;
RCC_OscInitStruct.HSIState = RCC_HSI_ON;
RCC_OscInitStruct.HSICalibrationValue = 16;
RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON;
RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSI;
RCC_OscInitStruct.PLL.PLLM = 16;
RCC_OscInitStruct.PLL.PLLN = 336;
RCC_OscInitStruct.PLL.PLLP = RCC_PLLP_DIV4;
RCC_OscInitStruct.PLL.PLLQ = 7;
if (HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK) {
    error("RTC error: LSI clock initialization failed."); 
}

NOTE: Changing the clock frequency might affect the behavior of other libraries. I only tested the Serial library.

UPDATE: Clock settings should not to be changed anymore! Looks like the newer mbed library has the required clock enabled.

USBDevice/USBDescriptor.h@24:4ed3e25c3edc, 2014-03-30 (annotated)

Committer:
tolaipner
Date:
Sun Mar 30 07:30:18 2014 +0000
Revision:
24:4ed3e25c3edc
Parent:
1:80ab0d068708 
Added Nucleo F401RE support

Who changed what in which revision?

UserRevisionLine numberNew contents of line
samux 1:80ab0d068708 1 /* Copyright (c) 2010-2011 mbed.org, MIT License
samux 1:80ab0d068708 2 *
samux 1:80ab0d068708 3 * Permission is hereby granted, free of charge, to any person obtaining a copy of this software
samux 1:80ab0d068708 4 * and associated documentation files (the "Software"), to deal in the Software without
samux 1:80ab0d068708 5 * restriction, including without limitation the rights to use, copy, modify, merge, publish,
samux 1:80ab0d068708 6 * distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the
samux 1:80ab0d068708 7 * Software is furnished to do so, subject to the following conditions:
samux 1:80ab0d068708 8 *
samux 1:80ab0d068708 9 * The above copyright notice and this permission notice shall be included in all copies or
samux 1:80ab0d068708 10 * substantial portions of the Software.
samux 1:80ab0d068708 11 *
samux 1:80ab0d068708 12 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING
samux 1:80ab0d068708 13 * BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
samux 1:80ab0d068708 14 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
samux 1:80ab0d068708 15 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
samux 1:80ab0d068708 16 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
samux 1:80ab0d068708 17 */
samux 1:80ab0d068708 18
samux 1:80ab0d068708 19 /* Standard descriptor types */
samux 1:80ab0d068708 20 #define DEVICE_DESCRIPTOR (1)
samux 1:80ab0d068708 21 #define CONFIGURATION_DESCRIPTOR (2)
samux 1:80ab0d068708 22 #define STRING_DESCRIPTOR (3)
samux 1:80ab0d068708 23 #define INTERFACE_DESCRIPTOR (4)
samux 1:80ab0d068708 24 #define ENDPOINT_DESCRIPTOR (5)
samux 1:80ab0d068708 25 #define QUALIFIER_DESCRIPTOR (6)
samux 1:80ab0d068708 26
samux 1:80ab0d068708 27 /* Standard descriptor lengths */
samux 1:80ab0d068708 28 #define DEVICE_DESCRIPTOR_LENGTH (0x12)
samux 1:80ab0d068708 29 #define CONFIGURATION_DESCRIPTOR_LENGTH (0x09)
samux 1:80ab0d068708 30 #define INTERFACE_DESCRIPTOR_LENGTH (0x09)
samux 1:80ab0d068708 31 #define ENDPOINT_DESCRIPTOR_LENGTH (0x07)
samux 1:80ab0d068708 32
samux 1:80ab0d068708 33
samux 1:80ab0d068708 34 /*string offset*/
samux 1:80ab0d068708 35 #define STRING_OFFSET_LANGID (0)
samux 1:80ab0d068708 36 #define STRING_OFFSET_IMANUFACTURER (1)
samux 1:80ab0d068708 37 #define STRING_OFFSET_IPRODUCT (2)
samux 1:80ab0d068708 38 #define STRING_OFFSET_ISERIAL (3)
samux 1:80ab0d068708 39 #define STRING_OFFSET_ICONFIGURATION (4)
samux 1:80ab0d068708 40 #define STRING_OFFSET_IINTERFACE (5)
samux 1:80ab0d068708 41
samux 1:80ab0d068708 42 /* USB Specification Release Number */
samux 1:80ab0d068708 43 #define USB_VERSION_2_0 (0x0200)
samux 1:80ab0d068708 44
samux 1:80ab0d068708 45 /* Least/Most significant byte of short integer */
samux 1:80ab0d068708 46 #define LSB(n) ((n)&0xff)
samux 1:80ab0d068708 47 #define MSB(n) (((n)&0xff00)>>8)
samux 1:80ab0d068708 48
samux 1:80ab0d068708 49 /* Convert physical endpoint number to descriptor endpoint number */
samux 1:80ab0d068708 50 #define PHY_TO_DESC(endpoint) (((endpoint)>>1) | (((endpoint) & 1) ? 0x80:0))
samux 1:80ab0d068708 51
samux 1:80ab0d068708 52 /* bmAttributes in configuration descriptor */
samux 1:80ab0d068708 53 /* C_RESERVED must always be set */
samux 1:80ab0d068708 54 #define C_RESERVED (1U<<7)
samux 1:80ab0d068708 55 #define C_SELF_POWERED (1U<<6)
samux 1:80ab0d068708 56 #define C_REMOTE_WAKEUP (1U<<5)
samux 1:80ab0d068708 57
samux 1:80ab0d068708 58 /* bMaxPower in configuration descriptor */
samux 1:80ab0d068708 59 #define C_POWER(mA) ((mA)/2)
samux 1:80ab0d068708 60
samux 1:80ab0d068708 61 /* bmAttributes in endpoint descriptor */
samux 1:80ab0d068708 62 #define E_CONTROL (0x00)
samux 1:80ab0d068708 63 #define E_ISOCHRONOUS (0x01)
samux 1:80ab0d068708 64 #define E_BULK (0x02)
samux 1:80ab0d068708 65 #define E_INTERRUPT (0x03)
samux 1:80ab0d068708 66
samux 1:80ab0d068708 67 /* For isochronous endpoints only: */
samux 1:80ab0d068708 68 #define E_NO_SYNCHRONIZATION (0x00)
samux 1:80ab0d068708 69 #define E_ASYNCHRONOUS (0x04)
samux 1:80ab0d068708 70 #define E_ADAPTIVE (0x08)
samux 1:80ab0d068708 71 #define E_SYNCHRONOUS (0x0C)
samux 1:80ab0d068708 72 #define E_DATA (0x00)
samux 1:80ab0d068708 73 #define E_FEEDBACK (0x10)
samux 1:80ab0d068708 74 #define E_IMPLICIT_FEEDBACK (0x20)