Kaoru Shoji / USBHostMIDI

USBHost+USB MIDI

Dependencies:   FATFileSystem mbed-rtos

Dependents:   USBHostMIDI_example MIDISynthwithSpecAnalyzer

Fork of USBHost by mbed official

USBHost with USB MIDI support

(work in progress...)

Tested functions

Receiving

  • note on
  • note off
  • program change
  • control change
  • pitch bend

Tranmitting

  • not tested yet.

USBHostMIDI/USBHostMIDI.h@20:bd4759650fc0, 2013-12-06 (annotated)

Committer:
kshoji
Date:
Fri Dec 06 03:22:34 2013 +0000
Revision:
20:bd4759650fc0
Parent:
19:bf09452b8f26 
method for sending MIDI messages

Who changed what in which revision?

UserRevisionLine numberNew contents of line
kshoji 19:bf09452b8f26 1 /* mbed USBHost Library
kshoji 19:bf09452b8f26 2 * Copyright (c) 2006-2013 ARM Limited
kshoji 19:bf09452b8f26 3 *
kshoji 19:bf09452b8f26 4 * Licensed under the Apache License, Version 2.0 (the "License");
kshoji 19:bf09452b8f26 5 * you may not use this file except in compliance with the License.
kshoji 19:bf09452b8f26 6 * You may obtain a copy of the License at
kshoji 19:bf09452b8f26 7 *
kshoji 19:bf09452b8f26 8 * http://www.apache.org/licenses/LICENSE-2.0
kshoji 19:bf09452b8f26 9 *
kshoji 19:bf09452b8f26 10 * Unless required by applicable law or agreed to in writing, software
kshoji 19:bf09452b8f26 11 * distributed under the License is distributed on an "AS IS" BASIS,
kshoji 19:bf09452b8f26 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
kshoji 19:bf09452b8f26 13 * See the License for the specific language governing permissions and
kshoji 19:bf09452b8f26 14 * limitations under the License.
kshoji 19:bf09452b8f26 15 */
kshoji 19:bf09452b8f26 16
kshoji 19:bf09452b8f26 17 #ifndef USBHOSTMIDI_H
kshoji 19:bf09452b8f26 18 #define USBHOSTMIDI_H
kshoji 19:bf09452b8f26 19
kshoji 19:bf09452b8f26 20 #include "USBHostConf.h"
kshoji 19:bf09452b8f26 21
kshoji 19:bf09452b8f26 22 #if USBHOST_MIDI
kshoji 19:bf09452b8f26 23
kshoji 19:bf09452b8f26 24 #include "USBHost.h"
kshoji 19:bf09452b8f26 25 #include "MtxCircBuffer.h"
kshoji 19:bf09452b8f26 26
kshoji 19:bf09452b8f26 27 /**
kshoji 19:bf09452b8f26 28 * A class to communicate a USB MIDI device
kshoji 19:bf09452b8f26 29 */
kshoji 19:bf09452b8f26 30 class USBHostMIDI : public IUSBEnumerator {
kshoji 19:bf09452b8f26 31 public:
kshoji 19:bf09452b8f26 32 /**
kshoji 19:bf09452b8f26 33 * Constructor
kshoji 19:bf09452b8f26 34 */
kshoji 19:bf09452b8f26 35 USBHostMIDI();
kshoji 19:bf09452b8f26 36
kshoji 19:bf09452b8f26 37 /**
kshoji 19:bf09452b8f26 38 * Check if a USB MIDI device is connected
kshoji 19:bf09452b8f26 39 *
kshoji 19:bf09452b8f26 40 * @returns true if a midi device is connected
kshoji 19:bf09452b8f26 41 */
kshoji 19:bf09452b8f26 42 bool connected();
kshoji 19:bf09452b8f26 43
kshoji 19:bf09452b8f26 44 /**
kshoji 19:bf09452b8f26 45 * Try to connect a midi device
kshoji 19:bf09452b8f26 46 *
kshoji 19:bf09452b8f26 47 * @return true if connection was successful
kshoji 19:bf09452b8f26 48 */
kshoji 19:bf09452b8f26 49 bool connect();
kshoji 19:bf09452b8f26 50
kshoji 19:bf09452b8f26 51 /**
kshoji 19:bf09452b8f26 52 * Attach a callback called when note on is received
kshoji 19:bf09452b8f26 53 *
kshoji 19:bf09452b8f26 54 * @param ptr function pointer
kshoji 19:bf09452b8f26 55 */
kshoji 19:bf09452b8f26 56 inline void attachNoteOn(void (*fn)(unsigned char, unsigned char, unsigned char)) {
kshoji 19:bf09452b8f26 57 if (fn != NULL) {
kshoji 19:bf09452b8f26 58 noteOn = fn;
kshoji 19:bf09452b8f26 59 }
kshoji 19:bf09452b8f26 60 }
kshoji 19:bf09452b8f26 61
kshoji 19:bf09452b8f26 62 /**
kshoji 19:bf09452b8f26 63 * Attach a callback called when note off is received
kshoji 19:bf09452b8f26 64 *
kshoji 19:bf09452b8f26 65 * @param ptr function pointer
kshoji 19:bf09452b8f26 66 */
kshoji 19:bf09452b8f26 67 inline void attachNoteOff(void (*fn)(unsigned char, unsigned char, unsigned char)) {
kshoji 19:bf09452b8f26 68 if (fn != NULL) {
kshoji 19:bf09452b8f26 69 noteOff = fn;
kshoji 19:bf09452b8f26 70 }
kshoji 19:bf09452b8f26 71 }
kshoji 19:bf09452b8f26 72
kshoji 19:bf09452b8f26 73 /**
kshoji 19:bf09452b8f26 74 * Attach a callback called when control change is received
kshoji 19:bf09452b8f26 75 *
kshoji 19:bf09452b8f26 76 * @param ptr function pointer
kshoji 19:bf09452b8f26 77 */
kshoji 19:bf09452b8f26 78 inline void attachControlChange(void (*fn)(unsigned char, unsigned char, unsigned char)) {
kshoji 19:bf09452b8f26 79 if (fn != NULL) {
kshoji 19:bf09452b8f26 80 controlChange = fn;
kshoji 19:bf09452b8f26 81 }
kshoji 19:bf09452b8f26 82 }
kshoji 19:bf09452b8f26 83
kshoji 19:bf09452b8f26 84 /**
kshoji 19:bf09452b8f26 85 * Attach a callback called when program change is received
kshoji 19:bf09452b8f26 86 *
kshoji 19:bf09452b8f26 87 * @param ptr function pointer
kshoji 19:bf09452b8f26 88 */
kshoji 19:bf09452b8f26 89 inline void attachProgramChange(void (*fn)(unsigned char, unsigned char)) {
kshoji 19:bf09452b8f26 90 if (fn != NULL) {
kshoji 19:bf09452b8f26 91 programChange = fn;
kshoji 19:bf09452b8f26 92 }
kshoji 19:bf09452b8f26 93 }
kshoji 19:bf09452b8f26 94
kshoji 19:bf09452b8f26 95 /**
kshoji 19:bf09452b8f26 96 * Attach a callback called when pitch bend is received
kshoji 19:bf09452b8f26 97 *
kshoji 19:bf09452b8f26 98 * @param ptr function pointer
kshoji 19:bf09452b8f26 99 */
kshoji 19:bf09452b8f26 100 inline void attachPitchBend(void (*fn)(unsigned char, unsigned int)) {
kshoji 19:bf09452b8f26 101 if (fn != NULL) {
kshoji 19:bf09452b8f26 102 pitchBend = fn;
kshoji 19:bf09452b8f26 103 }
kshoji 19:bf09452b8f26 104 }
kshoji 20:bd4759650fc0 105
kshoji 20:bd4759650fc0 106 /**
kshoji 20:bd4759650fc0 107 * Send a note on event
kshoji 20:bd4759650fc0 108 *
kshoji 20:bd4759650fc0 109 * @param channel 0-15
kshoji 20:bd4759650fc0 110 * @param note 0-127
kshoji 20:bd4759650fc0 111 * @param velocity 0-127 (0 means note off)
kshoji 20:bd4759650fc0 112 */
kshoji 19:bf09452b8f26 113 int sendNoteOn(unsigned char channel, unsigned char note, unsigned char velocity);
kshoji 20:bd4759650fc0 114
kshoji 20:bd4759650fc0 115 /**
kshoji 20:bd4759650fc0 116 * Send a note off event
kshoji 20:bd4759650fc0 117 *
kshoji 20:bd4759650fc0 118 * @param channel 0-15
kshoji 20:bd4759650fc0 119 * @param note 0-127
kshoji 20:bd4759650fc0 120 * @param velocity 0-127
kshoji 20:bd4759650fc0 121 */
kshoji 19:bf09452b8f26 122 int sendNoteOff(unsigned char channel, unsigned char note, unsigned char velocity);
kshoji 20:bd4759650fc0 123
kshoji 20:bd4759650fc0 124 /**
kshoji 20:bd4759650fc0 125 * Send a control change event
kshoji 20:bd4759650fc0 126 *
kshoji 20:bd4759650fc0 127 * @param channel 0-15
kshoji 20:bd4759650fc0 128 * @param key 0-127
kshoji 20:bd4759650fc0 129 * @param value 0-127
kshoji 20:bd4759650fc0 130 */
kshoji 19:bf09452b8f26 131 int sendControlChange(unsigned char channel, unsigned char key, unsigned char value);
kshoji 20:bd4759650fc0 132
kshoji 20:bd4759650fc0 133 /**
kshoji 20:bd4759650fc0 134 * Send a program change event
kshoji 20:bd4759650fc0 135 *
kshoji 20:bd4759650fc0 136 * @param channel 0-15
kshoji 20:bd4759650fc0 137 * @param program 0-127
kshoji 20:bd4759650fc0 138 */
kshoji 19:bf09452b8f26 139 int sendProgramChange(unsigned char channel, unsigned char program);
kshoji 20:bd4759650fc0 140
kshoji 20:bd4759650fc0 141 /**
kshoji 20:bd4759650fc0 142 * Send a control change event
kshoji 20:bd4759650fc0 143 *
kshoji 20:bd4759650fc0 144 * @param channel 0-15
kshoji 20:bd4759650fc0 145 * @param key 0(lower)-8191(center)-16383(higher)
kshoji 20:bd4759650fc0 146 */
kshoji 19:bf09452b8f26 147 int sendPitchBend(unsigned char channel, unsigned int value);
kshoji 19:bf09452b8f26 148
kshoji 19:bf09452b8f26 149 protected:
kshoji 19:bf09452b8f26 150 //From IUSBEnumerator
kshoji 19:bf09452b8f26 151 virtual void setVidPid(uint16_t vid, uint16_t pid);
kshoji 19:bf09452b8f26 152 virtual bool parseInterface(uint8_t intf_nb, uint8_t intf_class, uint8_t intf_subclass, uint8_t intf_protocol); //Must return true if the interface should be parsed
kshoji 19:bf09452b8f26 153 virtual bool useEndpoint(uint8_t intf_nb, ENDPOINT_TYPE type, ENDPOINT_DIRECTION dir); //Must return true if the endpoint will be used
kshoji 19:bf09452b8f26 154
kshoji 19:bf09452b8f26 155 private:
kshoji 19:bf09452b8f26 156 USBHost * host;
kshoji 19:bf09452b8f26 157 USBDeviceConnected * dev;
kshoji 19:bf09452b8f26 158 USBEndpoint * bulk_in;
kshoji 19:bf09452b8f26 159 USBEndpoint * bulk_out;
kshoji 19:bf09452b8f26 160 uint32_t size_bulk_in;
kshoji 19:bf09452b8f26 161 uint32_t size_bulk_out;
kshoji 19:bf09452b8f26 162
kshoji 19:bf09452b8f26 163 bool dev_connected;
kshoji 19:bf09452b8f26 164
kshoji 19:bf09452b8f26 165 void init();
kshoji 19:bf09452b8f26 166
kshoji 19:bf09452b8f26 167 MtxCircBuffer<uint8_t, 64> circ_buf;
kshoji 19:bf09452b8f26 168
kshoji 19:bf09452b8f26 169 uint8_t buf[64];
kshoji 19:bf09452b8f26 170
kshoji 19:bf09452b8f26 171 void rxHandler();
kshoji 19:bf09452b8f26 172
kshoji 19:bf09452b8f26 173 void (*noteOn)(unsigned char, unsigned char, unsigned char);
kshoji 19:bf09452b8f26 174 void (*noteOff)(unsigned char, unsigned char, unsigned char);
kshoji 19:bf09452b8f26 175 void (*controlChange)(unsigned char, unsigned char, unsigned char);
kshoji 19:bf09452b8f26 176 void (*programChange)(unsigned char, unsigned char);
kshoji 19:bf09452b8f26 177 void (*pitchBend)(unsigned char, unsigned int);
kshoji 19:bf09452b8f26 178
kshoji 19:bf09452b8f26 179 int midi_intf;
kshoji 19:bf09452b8f26 180 bool midi_device_found;
kshoji 19:bf09452b8f26 181
kshoji 19:bf09452b8f26 182 };
kshoji 19:bf09452b8f26 183
kshoji 19:bf09452b8f26 184 #endif
kshoji 19:bf09452b8f26 185
kshoji 19:bf09452b8f26 186 #endif