123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353 |
- /* Copyright (c) 2014 mbed.org, MIT License
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy of this software
- * and associated documentation files (the "Software"), to deal in the Software without
- * restriction, including without limitation the rights to use, copy, modify, merge, publish,
- * distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all copies or
- * substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING
- * BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
- * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
- * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
- */
-
- #ifndef USBHOSTMIDI_H
- #define USBHOSTMIDI_H
-
- #include "USBHostConf.h"
-
- #if USBHOST_MIDI
-
- #include "USBHost.h"
-
- /**
- * A class to communicate a USB MIDI device
- */
- class USBHostMIDI : public IUSBEnumerator {
- public:
- /**
- * Constructor
- */
- USBHostMIDI();
-
- /**
- * Check if a USB MIDI device is connected
- *
- * @returns true if a midi device is connected
- */
- bool connected();
-
- /**
- * Try to connect a midi device
- *
- * @return true if connection was successful
- */
- bool connect();
-
- /**
- * Attach a callback called when miscellaneous function code is received
- *
- * @param ptr function pointer
- * prototype: void onMiscellaneousFunctionCode(uint8_t data1, uint8_t data2, uint8_t data3);
- */
- inline void attachMiscellaneousFunctionCode(void (*fn)(uint8_t, uint8_t, uint8_t)) {
- miscellaneousFunctionCode = fn;
- }
-
- /**
- * Attach a callback called when cable event is received
- *
- * @param ptr function pointer
- * prototype: void onCableEvent(uint8_t data1, uint8_t data2, uint8_t data3);
- */
- inline void attachCableEvent(void (*fn)(uint8_t, uint8_t, uint8_t)) {
- cableEvent = fn;
- }
-
- /**
- * Attach a callback called when system exclusive is received
- *
- * @param ptr function pointer
- * prototype: void onSystemCommonTwoBytes(uint8_t data1, uint8_t data2);
- */
- inline void attachSystemCommonTwoBytes(void (*fn)(uint8_t, uint8_t)) {
- systemCommonTwoBytes = fn;
- }
-
- /**
- * Attach a callback called when system exclusive is received
- *
- * @param ptr function pointer
- * prototype: void onSystemCommonThreeBytes(uint8_t data1, uint8_t data2, uint8_t data3);
- */
- inline void attachSystemCommonThreeBytes(void (*fn)(uint8_t, uint8_t, uint8_t)) {
- systemCommonThreeBytes = fn;
- }
-
- /**
- * Attach a callback called when system exclusive is received
- *
- * @param ptr function pointer
- * prototype: void onSystemExclusive(uint8_t *data, uint16_t length, bool hasNextData);
- */
- inline void attachSystemExclusive(void (*fn)(uint8_t *, uint16_t, bool)) {
- systemExclusive = fn;
- }
-
- /**
- * Attach a callback called when note on is received
- *
- * @param ptr function pointer
- * prototype: void onNoteOn(uint8_t channel, uint8_t note, uint8_t velocity);
- */
- inline void attachNoteOn(void (*fn)(uint8_t, uint8_t, uint8_t)) {
- noteOn = fn;
- }
-
- /**
- * Attach a callback called when note off is received
- *
- * @param ptr function pointer
- * prototype: void onNoteOff(uint8_t channel, uint8_t note, uint8_t velocity);
- */
- inline void attachNoteOff(void (*fn)(uint8_t, uint8_t, uint8_t)) {
- noteOff = fn;
- }
-
- /**
- * Attach a callback called when poly keypress is received
- *
- * @param ptr function pointer
- * prototype: void onPolyKeyPress(uint8_t channel, uint8_t note, uint8_t pressure);
- */
- inline void attachPolyKeyPress(void (*fn)(uint8_t, uint8_t, uint8_t)) {
- polyKeyPress = fn;
- }
-
- /**
- * Attach a callback called when control change is received
- *
- * @param ptr function pointer
- * prototype: void onControlChange(uint8_t channel, uint8_t key, uint8_t value);
- */
- inline void attachControlChange(void (*fn)(uint8_t, uint8_t, uint8_t)) {
- controlChange = fn;
- }
-
- /**
- * Attach a callback called when program change is received
- *
- * @param ptr function pointer
- * prototype: void onProgramChange(uint8_t channel, uint8_t program);
- */
- inline void attachProgramChange(void (*fn)(uint8_t, uint8_t)) {
- programChange = fn;
- }
-
- /**
- * Attach a callback called when channel pressure is received
- *
- * @param ptr function pointer
- * prototype: void onChannelPressure(uint8_t channel, uint8_t pressure);
- */
- inline void attachChannelPressure(void (*fn)(uint8_t, uint8_t)) {
- channelPressure = fn;
- }
-
- /**
- * Attach a callback called when pitch bend is received
- *
- * @param ptr function pointer
- * prototype: void onPitchBend(uint8_t channel, uint16_t value);
- */
- inline void attachPitchBend(void (*fn)(uint8_t, uint16_t)) {
- pitchBend = fn;
- }
-
- /**
- * Attach a callback called when single byte is received
- *
- * @param ptr function pointer
- * prototype: void onSingleByte(uint8_t value);
- */
- inline void attachSingleByte(void (*fn)(uint8_t)) {
- singleByte = fn;
- }
-
- /**
- * Send a cable event with 3 bytes event
- *
- * @param data1 0-255
- * @param data2 0-255
- * @param data3 0-255
- * @return true if message sent successfully
- */
- bool sendMiscellaneousFunctionCode(uint8_t data1, uint8_t data2, uint8_t data3);
-
- /**
- * Send a cable event with 3 bytes event
- *
- * @param data1 0-255
- * @param data2 0-255
- * @param data3 0-255
- * @return true if message sent successfully
- */
- bool sendCableEvent(uint8_t data1, uint8_t data2, uint8_t data3);
-
- /**
- * Send a system common message with 2 bytes event
- *
- * @param data1 0-255
- * @param data2 0-255
- * @return true if message sent successfully
- */
- bool sendSystemCommmonTwoBytes(uint8_t data1, uint8_t data2);
-
- /**
- * Send a system common message with 3 bytes event
- *
- * @param data1 0-255
- * @param data2 0-255
- * @param data3 0-255
- * @return true if message sent successfully
- */
- bool sendSystemCommmonThreeBytes(uint8_t data1, uint8_t data2, uint8_t data3);
-
- /**
- * Send a system exclusive event
- *
- * @param buffer, starts with 0xF0, and end with 0xf7
- * @param length
- * @return true if message sent successfully
- */
- bool sendSystemExclusive(uint8_t *buffer, int length);
-
- /**
- * Send a note off event
- *
- * @param channel 0-15
- * @param note 0-127
- * @param velocity 0-127
- * @return true if message sent successfully
- */
- bool sendNoteOff(uint8_t channel, uint8_t note, uint8_t velocity);
-
- /**
- * Send a note on event
- *
- * @param channel 0-15
- * @param note 0-127
- * @param velocity 0-127 (0 means note off)
- * @return true if message sent successfully
- */
- bool sendNoteOn(uint8_t channel, uint8_t note, uint8_t velocity);
-
- /**
- * Send a poly keypress event
- *
- * @param channel 0-15
- * @param note 0-127
- * @param pressure 0-127
- * @return true if message sent successfully
- */
- bool sendPolyKeyPress(uint8_t channel, uint8_t note, uint8_t pressure);
-
- /**
- * Send a control change event
- *
- * @param channel 0-15
- * @param key 0-127
- * @param value 0-127
- * @return true if message sent successfully
- */
- bool sendControlChange(uint8_t channel, uint8_t key, uint8_t value);
-
- /**
- * Send a program change event
- *
- * @param channel 0-15
- * @param program 0-127
- * @return true if message sent successfully
- */
- bool sendProgramChange(uint8_t channel, uint8_t program);
-
- /**
- * Send a channel pressure event
- *
- * @param channel 0-15
- * @param pressure 0-127
- * @return true if message sent successfully
- */
- bool sendChannelPressure(uint8_t channel, uint8_t pressure);
-
- /**
- * Send a control change event
- *
- * @param channel 0-15
- * @param key 0(lower)-8191(center)-16383(higher)
- * @return true if message sent successfully
- */
- bool sendPitchBend(uint8_t channel, uint16_t value);
-
- /**
- * Send a single byte event
- *
- * @param data 0-255
- * @return true if message sent successfully
- */
- bool sendSingleByte(uint8_t data);
-
- protected:
- //From IUSBEnumerator
- virtual void setVidPid(uint16_t vid, uint16_t pid);
- 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
- virtual bool useEndpoint(uint8_t intf_nb, ENDPOINT_TYPE type, ENDPOINT_DIRECTION dir); //Must return true if the endpoint will be used
-
- private:
- USBHost * host;
- USBDeviceConnected * dev;
- USBEndpoint * bulk_in;
- USBEndpoint * bulk_out;
- uint32_t size_bulk_in;
- uint32_t size_bulk_out;
-
- bool dev_connected;
-
- void init();
-
- uint8_t buf[64];
-
- void rxHandler();
-
- uint16_t sysExBufferPos;
- uint8_t sysExBuffer[64];
-
- void (*miscellaneousFunctionCode)(uint8_t, uint8_t, uint8_t);
- void (*cableEvent)(uint8_t, uint8_t, uint8_t);
- void (*systemCommonTwoBytes)(uint8_t, uint8_t);
- void (*systemCommonThreeBytes)(uint8_t, uint8_t, uint8_t);
- void (*systemExclusive)(uint8_t *, uint16_t, bool);
- void (*noteOff)(uint8_t, uint8_t, uint8_t);
- void (*noteOn)(uint8_t, uint8_t, uint8_t);
- void (*polyKeyPress)(uint8_t, uint8_t, uint8_t);
- void (*controlChange)(uint8_t, uint8_t, uint8_t);
- void (*programChange)(uint8_t, uint8_t);
- void (*channelPressure)(uint8_t, uint8_t);
- void (*pitchBend)(uint8_t, uint16_t);
- void (*singleByte)(uint8_t);
-
- bool sendMidiBuffer(uint8_t data0, uint8_t data1, uint8_t data2, uint8_t data3);
-
- int midi_intf;
- bool midi_device_found;
-
- };
-
- #endif /* USBHOST_MIDI */
-
- #endif /* USBHOSTMIDI_H */
|