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.

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

Committer:
tolaipner
Date:
Sun Mar 30 07:30:18 2014 +0000
Revision:
24:4ed3e25c3edc
Parent:
11:eeb3cbbaa996 
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 #ifndef MIDIMESSAGE_H
samux 1:80ab0d068708 20 #define MIDIMESSAGE_H
samux 1:80ab0d068708 21
samux 1:80ab0d068708 22 #include "mbed.h"
samux 1:80ab0d068708 23
samux 1:80ab0d068708 24 // MIDI Message Format
samux 1:80ab0d068708 25 //
samux 1:80ab0d068708 26 // [ msg(4) | channel(4) ] [ 0 | n(7) ] [ 0 | m(7) ]
samux 1:80ab0d068708 27 //
samux 1:80ab0d068708 28 // MIDI Data Messages (Channel Specific)
samux 1:80ab0d068708 29 //
samux 1:80ab0d068708 30 // Message msg n m
samux 1:80ab0d068708 31 // ---------------------------------------------
samux 1:80ab0d068708 32 // Note Off 0x8 Key Velocity
samux 1:80ab0d068708 33 // Note On 0x9 Key Velocity
samux 1:80ab0d068708 34 // Polyphonic Aftertouch 0xA Key Pressure
samux 1:80ab0d068708 35 // Control Change 0xB Controller Value
samux 1:80ab0d068708 36 // Program Change 0xC Program -
samux 1:80ab0d068708 37 // Channel Aftertouch 0xD Pressure -
samux 1:80ab0d068708 38 // Pitch Wheel 0xE LSB MSB
samux 1:80ab0d068708 39
samux 1:80ab0d068708 40 #define CABLE_NUM (0<<4)
samux 1:80ab0d068708 41
samux 1:80ab0d068708 42 /** A MIDI message container */
samux 1:80ab0d068708 43 class MIDIMessage {
samux 1:80ab0d068708 44 public:
samux 1:80ab0d068708 45 MIDIMessage() {}
samux 1:80ab0d068708 46
samux 1:80ab0d068708 47 MIDIMessage(uint8_t *buf) {
bogdanm 11:eeb3cbbaa996 48 for (int i = 0; i < 4; i++)
bogdanm 11:eeb3cbbaa996 49 data[i] = buf[i];
samux 1:80ab0d068708 50 }
samux 1:80ab0d068708 51
samux 1:80ab0d068708 52 // create messages
samux 1:80ab0d068708 53
samux 1:80ab0d068708 54 /** Create a NoteOff message
samux 1:80ab0d068708 55 * @param key Key ID
samux 1:80ab0d068708 56 * @param velocity Key velocity (0-127, default = 127)
samux 1:80ab0d068708 57 * @param channel Key channel (0-15, default 0)
samux 1:80ab0d068708 58 * @returns A MIDIMessage
samux 1:80ab0d068708 59 */
samux 1:80ab0d068708 60 static MIDIMessage NoteOff(int key, int velocity = 127, int channel = 0) {
samux 1:80ab0d068708 61 MIDIMessage msg;
samux 1:80ab0d068708 62 msg.data[0] = CABLE_NUM | 0x08;
samux 1:80ab0d068708 63 msg.data[1] = 0x80 | (channel & 0x0F);
samux 1:80ab0d068708 64 msg.data[2] = key & 0x7F;
samux 1:80ab0d068708 65 msg.data[3] = velocity & 0x7F;
samux 1:80ab0d068708 66 return msg;
samux 1:80ab0d068708 67 }
samux 1:80ab0d068708 68
samux 1:80ab0d068708 69 /** Create a NoteOn message
samux 1:80ab0d068708 70 * @param key Key ID
samux 1:80ab0d068708 71 * @param velocity Key velocity (0-127, default = 127)
samux 1:80ab0d068708 72 * @param channel Key channel (0-15, default 0)
samux 1:80ab0d068708 73 * @returns A MIDIMessage
samux 1:80ab0d068708 74 */
samux 1:80ab0d068708 75 static MIDIMessage NoteOn(int key, int velocity = 127, int channel = 0) {
samux 1:80ab0d068708 76 MIDIMessage msg;
samux 1:80ab0d068708 77 msg.data[0] = CABLE_NUM | 0x09;
samux 1:80ab0d068708 78 msg.data[1] = 0x90 | (channel & 0x0F);
samux 1:80ab0d068708 79 msg.data[2] = key & 0x7F;
samux 1:80ab0d068708 80 msg.data[3] = velocity & 0x7F;
samux 1:80ab0d068708 81 return msg;
samux 1:80ab0d068708 82 }
samux 1:80ab0d068708 83
samux 1:80ab0d068708 84 /** Create a PolyPhonic Aftertouch message
samux 1:80ab0d068708 85 * @param key Key ID
samux 1:80ab0d068708 86 * @param pressure Aftertouch pressure (0-127)
samux 1:80ab0d068708 87 * @param channel Key channel (0-15, default 0)
samux 1:80ab0d068708 88 * @returns A MIDIMessage
samux 1:80ab0d068708 89 */
samux 1:80ab0d068708 90 static MIDIMessage PolyphonicAftertouch(int key, int pressure, int channel = 0) {
samux 1:80ab0d068708 91 MIDIMessage msg;
samux 1:80ab0d068708 92 msg.data[0] = CABLE_NUM | 0x0A;
samux 1:80ab0d068708 93 msg.data[1] = 0xA0 | (channel & 0x0F);
samux 1:80ab0d068708 94 msg.data[2] = key & 0x7F;
samux 1:80ab0d068708 95 msg.data[3] = pressure & 0x7F;
samux 1:80ab0d068708 96 return msg;
samux 1:80ab0d068708 97 }
samux 1:80ab0d068708 98
samux 1:80ab0d068708 99 /** Create a Control Change message
samux 1:80ab0d068708 100 * @param control Controller ID
samux 1:80ab0d068708 101 * @param value Controller value (0-127)
samux 1:80ab0d068708 102 * @param channel Controller channel (0-15, default 0)
samux 1:80ab0d068708 103 * @returns A MIDIMessage
samux 1:80ab0d068708 104 */
samux 1:80ab0d068708 105 static MIDIMessage ControlChange(int control, int value, int channel = 0) {
samux 1:80ab0d068708 106 MIDIMessage msg;
samux 1:80ab0d068708 107 msg.data[0] = CABLE_NUM | 0x0B;
samux 1:80ab0d068708 108 msg.data[1] = 0xB0 | (channel & 0x0F);
samux 1:80ab0d068708 109 msg.data[2] = control & 0x7F;
samux 1:80ab0d068708 110 msg.data[3] = value & 0x7F;
samux 1:80ab0d068708 111 return msg;
samux 1:80ab0d068708 112 }
samux 1:80ab0d068708 113
samux 1:80ab0d068708 114 /** Create a Program Change message
samux 1:80ab0d068708 115 * @param program Program ID
samux 1:80ab0d068708 116 * @param channel Channel (0-15, default 0)
samux 1:80ab0d068708 117 * @returns A MIDIMessage
samux 1:80ab0d068708 118 */
samux 1:80ab0d068708 119 static MIDIMessage ProgramChange(int program, int channel = 0) {
samux 1:80ab0d068708 120 MIDIMessage msg;
samux 1:80ab0d068708 121 msg.data[0] = CABLE_NUM | 0x0C;
samux 1:80ab0d068708 122 msg.data[1] = 0xC0 | (channel & 0x0F);
samux 1:80ab0d068708 123 msg.data[2] = program & 0x7F;
samux 1:80ab0d068708 124 msg.data[3] = 0x00;
samux 1:80ab0d068708 125 return msg;
samux 1:80ab0d068708 126 }
samux 1:80ab0d068708 127
samux 1:80ab0d068708 128 /** Create a Channel Aftertouch message
samux 1:80ab0d068708 129 * @param pressure Pressure
samux 1:80ab0d068708 130 * @param channel Key channel (0-15, default 0)
samux 1:80ab0d068708 131 * @returns A MIDIMessage
samux 1:80ab0d068708 132 */
samux 1:80ab0d068708 133 static MIDIMessage ChannelAftertouch(int pressure, int channel = 0) {
samux 1:80ab0d068708 134 MIDIMessage msg;
samux 1:80ab0d068708 135 msg.data[0] = CABLE_NUM | 0x0D;
samux 1:80ab0d068708 136 msg.data[1] = 0xD0 | (channel & 0x0F);
samux 1:80ab0d068708 137 msg.data[2] = pressure & 0x7F;
samux 1:80ab0d068708 138 msg.data[3] = 0x00;
samux 1:80ab0d068708 139 return msg;
samux 1:80ab0d068708 140 }
samux 1:80ab0d068708 141
samux 1:80ab0d068708 142 /** Create a Pitch Wheel message
samux 1:80ab0d068708 143 * @param pitch Pitch (-8192 - 8191, default = 0)
samux 1:80ab0d068708 144 * @param channel Channel (0-15, default 0)
samux 1:80ab0d068708 145 * @returns A MIDIMessage
samux 1:80ab0d068708 146 */
samux 1:80ab0d068708 147 static MIDIMessage PitchWheel(int pitch = 0, int channel = 0) {
samux 1:80ab0d068708 148 MIDIMessage msg;
samux 1:80ab0d068708 149 int p = pitch + 8192; // 0 - 16383, 8192 is center
samux 1:80ab0d068708 150 msg.data[0] = CABLE_NUM | 0x0E;
samux 1:80ab0d068708 151 msg.data[1] = 0xE0 | (channel & 0x0F);
samux 1:80ab0d068708 152 msg.data[2] = p & 0x7F;
samux 1:80ab0d068708 153 msg.data[3] = (p >> 7) & 0x7F;
samux 1:80ab0d068708 154 return msg;
samux 1:80ab0d068708 155 }
samux 1:80ab0d068708 156
samux 1:80ab0d068708 157 /** Create an All Notes Off message
samux 1:80ab0d068708 158 * @param channel Channel (0-15, default 0)
samux 1:80ab0d068708 159 * @returns A MIDIMessage
samux 1:80ab0d068708 160 */
samux 1:80ab0d068708 161 static MIDIMessage AllNotesOff(int channel = 0) {
samux 1:80ab0d068708 162 return ControlChange(123, 0, channel);
samux 1:80ab0d068708 163 }
samux 1:80ab0d068708 164
samux 1:80ab0d068708 165 // decode messages
samux 1:80ab0d068708 166
samux 1:80ab0d068708 167 /** MIDI Message Types */
samux 1:80ab0d068708 168 enum MIDIMessageType {
samux 1:80ab0d068708 169 ErrorType,
samux 1:80ab0d068708 170 NoteOffType,
samux 1:80ab0d068708 171 NoteOnType,
samux 1:80ab0d068708 172 PolyphonicAftertouchType,
samux 1:80ab0d068708 173 ControlChangeType,
samux 1:80ab0d068708 174 ProgramChangeType,
samux 1:80ab0d068708 175 ChannelAftertouchType,
samux 1:80ab0d068708 176 PitchWheelType,
samux 1:80ab0d068708 177 AllNotesOffType
samux 1:80ab0d068708 178 };
samux 1:80ab0d068708 179
samux 1:80ab0d068708 180 /** Read the message type
samux 1:80ab0d068708 181 * @returns MIDIMessageType
samux 1:80ab0d068708 182 */
samux 1:80ab0d068708 183 MIDIMessageType type() {
samux 1:80ab0d068708 184 switch((data[1] >> 4) & 0xF) {
samux 1:80ab0d068708 185 case 0x8: return NoteOffType;
samux 1:80ab0d068708 186 case 0x9: return NoteOnType;
samux 1:80ab0d068708 187 case 0xA: return PolyphonicAftertouchType;
samux 1:80ab0d068708 188 case 0xB:
samux 1:80ab0d068708 189 if(controller() < 120) { // standard controllers
samux 1:80ab0d068708 190 return ControlChangeType;
samux 1:80ab0d068708 191 } else if(controller() == 123) {
samux 1:80ab0d068708 192 return AllNotesOffType;
samux 1:80ab0d068708 193 } else {
samux 1:80ab0d068708 194 return ErrorType; // unsupported atm
samux 1:80ab0d068708 195 }
samux 1:80ab0d068708 196 case 0xC: return ProgramChangeType;
samux 1:80ab0d068708 197 case 0xD: return ChannelAftertouchType;
samux 1:80ab0d068708 198 case 0xE: return PitchWheelType;
samux 1:80ab0d068708 199 default: return ErrorType;
samux 1:80ab0d068708 200 }
samux 1:80ab0d068708 201 }
samux 1:80ab0d068708 202
samux 1:80ab0d068708 203 /** Read the channel number */
samux 1:80ab0d068708 204 int channel() {
samux 1:80ab0d068708 205 return (data[1] & 0x0F);
samux 1:80ab0d068708 206 }
samux 1:80ab0d068708 207
samux 1:80ab0d068708 208 /** Read the key ID */
samux 1:80ab0d068708 209 int key() {
samux 1:80ab0d068708 210 return (data[2] & 0x7F);
samux 1:80ab0d068708 211 }
samux 1:80ab0d068708 212
samux 1:80ab0d068708 213 /** Read the velocity */
samux 1:80ab0d068708 214 int velocity() {
samux 1:80ab0d068708 215 return (data[3] & 0x7F);
samux 1:80ab0d068708 216 }
samux 1:80ab0d068708 217
samux 1:80ab0d068708 218 /** Read the controller value */
samux 1:80ab0d068708 219 int value() {
samux 1:80ab0d068708 220 return (data[3] & 0x7F);
samux 1:80ab0d068708 221 }
samux 1:80ab0d068708 222
samux 1:80ab0d068708 223 /** Read the aftertouch pressure */
samux 1:80ab0d068708 224 int pressure() {
samux 1:80ab0d068708 225 if(type() == PolyphonicAftertouchType) {
samux 1:80ab0d068708 226 return (data[3] & 0x7F);
samux 1:80ab0d068708 227 } else {
samux 1:80ab0d068708 228 return (data[2] & 0x7F);
samux 1:80ab0d068708 229 }
samux 1:80ab0d068708 230 }
samux 1:80ab0d068708 231
samux 1:80ab0d068708 232 /** Read the controller number */
samux 1:80ab0d068708 233 int controller() {
samux 1:80ab0d068708 234 return (data[2] & 0x7F);
samux 1:80ab0d068708 235 }
samux 1:80ab0d068708 236
samux 1:80ab0d068708 237 /** Read the program number */
samux 1:80ab0d068708 238 int program() {
samux 1:80ab0d068708 239 return (data[2] & 0x7F);
samux 1:80ab0d068708 240 }
samux 1:80ab0d068708 241
samux 1:80ab0d068708 242 /** Read the pitch value */
samux 1:80ab0d068708 243 int pitch() {
samux 1:80ab0d068708 244 int p = ((data[3] & 0x7F) << 7) | (data[2] & 0x7F);
samux 1:80ab0d068708 245 return p - 8192; // 0 - 16383, 8192 is center
samux 1:80ab0d068708 246 }
samux 1:80ab0d068708 247
samux 1:80ab0d068708 248 uint8_t data[4];
bogdanm 11:eeb3cbbaa996 249 };
samux 1:80ab0d068708 250
samux 1:80ab0d068708 251 #endif