392 lines
16 KiB
C++
392 lines
16 KiB
C++
/* Teensyduino Core Library
|
|
* http://www.pjrc.com/teensy/
|
|
* Copyright (c) 2017 PJRC.COM, LLC.
|
|
*
|
|
* 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:
|
|
*
|
|
* 1. The above copyright notice and this permission notice shall be
|
|
* included in all copies or substantial portions of the Software.
|
|
*
|
|
* 2. If the Software is incorporated into a build system that allows
|
|
* selection among a list of target devices, then similar target
|
|
* devices manufactured by PJRC.COM must be included in the list of
|
|
* target devices and selectable in the same manner.
|
|
*
|
|
* 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 USBmidi_h_
|
|
#define USBmidi_h_
|
|
|
|
#include "usb_desc.h"
|
|
|
|
#if defined(MIDI_INTERFACE)
|
|
|
|
#include <inttypes.h>
|
|
|
|
// maximum sysex length we can receive
|
|
#if defined(__MKL26Z64__) || defined(__MK20DX128__)
|
|
#define USB_MIDI_SYSEX_MAX 60
|
|
#else
|
|
#define USB_MIDI_SYSEX_MAX 290
|
|
#endif
|
|
|
|
// C language implementation
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
void usb_midi_write_packed(uint32_t n);
|
|
void usb_midi_send_sysex_buffer_has_term(const uint8_t *data, uint32_t length, uint8_t cable);
|
|
void usb_midi_send_sysex_add_term_bytes(const uint8_t *data, uint32_t length, uint8_t cable);
|
|
void usb_midi_flush_output(void);
|
|
int usb_midi_read(uint32_t channel);
|
|
uint32_t usb_midi_available(void);
|
|
uint32_t usb_midi_read_message(void);
|
|
extern uint8_t usb_midi_msg_cable;
|
|
extern uint8_t usb_midi_msg_channel;
|
|
extern uint8_t usb_midi_msg_type;
|
|
extern uint8_t usb_midi_msg_data1;
|
|
extern uint8_t usb_midi_msg_data2;
|
|
extern uint8_t usb_midi_msg_sysex[USB_MIDI_SYSEX_MAX];
|
|
extern uint16_t usb_midi_msg_sysex_len;
|
|
extern void (*usb_midi_handleNoteOff)(uint8_t ch, uint8_t note, uint8_t vel);
|
|
extern void (*usb_midi_handleNoteOn)(uint8_t ch, uint8_t note, uint8_t vel);
|
|
extern void (*usb_midi_handleVelocityChange)(uint8_t ch, uint8_t note, uint8_t vel);
|
|
extern void (*usb_midi_handleControlChange)(uint8_t ch, uint8_t control, uint8_t value);
|
|
extern void (*usb_midi_handleProgramChange)(uint8_t ch, uint8_t program);
|
|
extern void (*usb_midi_handleAfterTouch)(uint8_t ch, uint8_t pressure);
|
|
extern void (*usb_midi_handlePitchChange)(uint8_t ch, int pitch);
|
|
extern void (*usb_midi_handleSysExPartial)(const uint8_t *data, uint16_t length, uint8_t complete);
|
|
extern void (*usb_midi_handleSysExComplete)(uint8_t *data, unsigned int size);
|
|
extern void (*usb_midi_handleTimeCodeQuarterFrame)(uint8_t data);
|
|
extern void (*usb_midi_handleSongPosition)(uint16_t beats);
|
|
extern void (*usb_midi_handleSongSelect)(uint8_t songnumber);
|
|
extern void (*usb_midi_handleTuneRequest)(void);
|
|
extern void (*usb_midi_handleClock)(void);
|
|
extern void (*usb_midi_handleStart)(void);
|
|
extern void (*usb_midi_handleContinue)(void);
|
|
extern void (*usb_midi_handleStop)(void);
|
|
extern void (*usb_midi_handleActiveSensing)(void);
|
|
extern void (*usb_midi_handleSystemReset)(void);
|
|
extern void (*usb_midi_handleRealTimeSystem)(uint8_t rtb);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
// To test receiving on Linux, run "aseqdump -l" to list sequencer devices.
|
|
//
|
|
// Port Client name Port name
|
|
// 0:0 System Timer
|
|
// 0:1 System Announce
|
|
// 14:0 Midi Through Midi Through Port-0
|
|
// 24:0 Teensy MIDI Teensy MIDI MIDI 1
|
|
// 28:0 AKM320 AKM320 MIDI 1
|
|
//
|
|
// Then run "aseqdump -p 24:0" to view the MIDI messages.
|
|
//
|
|
// Waiting for data. Press Ctrl+C to end.
|
|
// Source Event Ch Data
|
|
// 24:0 Note on 0, note 61, velocity 99
|
|
// 24:0 Note off 0, note 61, velocity 0
|
|
// 24:0 Note on 0, note 62, velocity 99
|
|
// 24:0 Note off 0, note 62, velocity 0
|
|
// 24:0 Note on 0, note 64, velocity 99
|
|
// 24:0 Note off 0, note 64, velocity 0
|
|
//
|
|
// Quick-dirty way to transmit MIDI sysex:
|
|
// echo -n -e '\xF0abcd\xF7' > /dev/midi2
|
|
|
|
// C++ interface
|
|
#ifdef __cplusplus
|
|
class usb_midi_class
|
|
{
|
|
public:
|
|
// Message type names for compatibility with Arduino MIDI library 4.3.1
|
|
enum MidiType {
|
|
InvalidType = 0x00, // For notifying errors
|
|
NoteOff = 0x80, // Note Off
|
|
NoteOn = 0x90, // Note On
|
|
AfterTouchPoly = 0xA0, // Polyphonic AfterTouch
|
|
ControlChange = 0xB0, // Control Change / Channel Mode
|
|
ProgramChange = 0xC0, // Program Change
|
|
AfterTouchChannel = 0xD0, // Channel (monophonic) AfterTouch
|
|
PitchBend = 0xE0, // Pitch Bend
|
|
SystemExclusive = 0xF0, // System Exclusive
|
|
TimeCodeQuarterFrame = 0xF1, // System Common - MIDI Time Code Quarter Frame
|
|
SongPosition = 0xF2, // System Common - Song Position Pointer
|
|
SongSelect = 0xF3, // System Common - Song Select
|
|
TuneRequest = 0xF6, // System Common - Tune Request
|
|
Clock = 0xF8, // System Real Time - Timing Clock
|
|
Start = 0xFA, // System Real Time - Start
|
|
Continue = 0xFB, // System Real Time - Continue
|
|
Stop = 0xFC, // System Real Time - Stop
|
|
ActiveSensing = 0xFE, // System Real Time - Active Sensing
|
|
SystemReset = 0xFF, // System Real Time - System Reset
|
|
};
|
|
void begin(void) { }
|
|
void end(void) { }
|
|
void sendNoteOff(uint8_t note, uint8_t velocity, uint8_t channel, uint8_t cable=0) __attribute__((always_inline)) {
|
|
send(0x80, note, velocity, channel, cable);
|
|
}
|
|
void sendNoteOn(uint8_t note, uint8_t velocity, uint8_t channel, uint8_t cable=0) __attribute__((always_inline)) {
|
|
send(0x90, note, velocity, channel, cable);
|
|
}
|
|
void sendPolyPressure(uint8_t note, uint8_t pressure, uint8_t channel, uint8_t cable=0) __attribute__((always_inline)) {
|
|
send(0xA0, note, pressure, channel, cable);
|
|
}
|
|
void sendAfterTouchPoly(uint8_t note, uint8_t pressure, uint8_t channel, uint8_t cable=0) __attribute__((always_inline)) {
|
|
send(0xA0, note, pressure, channel, cable);
|
|
}
|
|
void sendControlChange(uint8_t control, uint8_t value, uint8_t channel, uint8_t cable=0) __attribute__((always_inline)) {
|
|
send(0xB0, control, value, channel, cable);
|
|
}
|
|
void sendProgramChange(uint8_t program, uint8_t channel, uint8_t cable=0) __attribute__((always_inline)) {
|
|
send(0xC0, program, 0, channel, cable);
|
|
}
|
|
void sendAfterTouch(uint8_t pressure, uint8_t channel, uint8_t cable=0) __attribute__((always_inline)) {
|
|
send(0xD0, pressure, 0, channel, cable);
|
|
}
|
|
void sendPitchBend(int value, uint8_t channel, uint8_t cable=0) __attribute__((always_inline)) {
|
|
if (value < -8192) {
|
|
value = -8192;
|
|
} else if (value > 8191) {
|
|
value = 8191;
|
|
}
|
|
value += 8192;
|
|
send(0xE0, value, value >> 7, channel, cable);
|
|
}
|
|
void sendSysEx(uint32_t length, const uint8_t *data, bool hasTerm=false, uint8_t cable=0) __attribute__((always_inline)) {
|
|
if (cable >= MIDI_NUM_CABLES) return;
|
|
if (hasTerm) {
|
|
usb_midi_send_sysex_buffer_has_term(data, length, cable);
|
|
} else {
|
|
usb_midi_send_sysex_add_term_bytes(data, length, cable);
|
|
}
|
|
}
|
|
void sendRealTime(uint8_t type, uint8_t cable=0) __attribute__((always_inline)) __attribute__((always_inline)) {
|
|
switch (type) {
|
|
case 0xF8: // Clock
|
|
case 0xFA: // Start
|
|
case 0xFB: // Continue
|
|
case 0xFC: // Stop
|
|
case 0xFE: // ActiveSensing
|
|
case 0xFF: // SystemReset
|
|
send(type, 0, 0, 0, cable);
|
|
break;
|
|
default: // Invalid Real Time marker
|
|
break;
|
|
}
|
|
}
|
|
void sendTimeCodeQuarterFrame(uint8_t type, uint8_t value, uint8_t cable=0) __attribute__((always_inline)) __attribute__((always_inline)) {
|
|
send(0xF1, ((type & 0x07) << 4) | (value & 0x0F), 0, 0, cable);
|
|
}
|
|
void sendSongPosition(uint16_t beats, uint8_t cable=0) __attribute__((always_inline)) {
|
|
send(0xF2, beats, beats >> 7, 0, cable);
|
|
}
|
|
void sendSongSelect(uint8_t song, uint8_t cable=0) __attribute__((always_inline)) {
|
|
send(0xF3, song, 0, 0, cable);
|
|
}
|
|
void sendTuneRequest(uint8_t cable=0) __attribute__((always_inline)) {
|
|
send(0xF6, 0, 0, 0, cable);
|
|
}
|
|
void beginRpn(uint16_t number, uint8_t channel, uint8_t cable=0) __attribute__((always_inline)) {
|
|
sendControlChange(101, number >> 7, channel, cable);
|
|
sendControlChange(100, number, channel, cable);
|
|
}
|
|
void sendRpnValue(uint16_t value, uint8_t channel, uint8_t cable=0) __attribute__((always_inline)) {
|
|
sendControlChange(6, value >> 7, channel, cable);
|
|
sendControlChange(38, value, channel, cable);
|
|
}
|
|
void sendRpnIncrement(uint8_t amount, uint8_t channel, uint8_t cable=0) __attribute__((always_inline)) {
|
|
sendControlChange(96, amount, channel, cable);
|
|
}
|
|
void sendRpnDecrement(uint8_t amount, uint8_t channel, uint8_t cable=0) __attribute__((always_inline)) {
|
|
sendControlChange(97, amount, channel, cable);
|
|
}
|
|
void endRpn(uint8_t channel, uint8_t cable=0) __attribute__((always_inline)) {
|
|
sendControlChange(101, 0x7F, channel, cable);
|
|
sendControlChange(100, 0x7F, channel, cable);
|
|
}
|
|
void beginNrpn(uint16_t number, uint8_t channel, uint8_t cable=0) __attribute__((always_inline)) {
|
|
sendControlChange(99, number >> 7, channel, cable);
|
|
sendControlChange(98, number, channel, cable);
|
|
}
|
|
void sendNrpnValue(uint16_t value, uint8_t channel, uint8_t cable=0) __attribute__((always_inline)) {
|
|
sendControlChange(6, value >> 7, channel, cable);
|
|
sendControlChange(38, value, channel, cable);
|
|
}
|
|
void sendNrpnIncrement(uint8_t amount, uint8_t channel, uint8_t cable=0) __attribute__((always_inline)) {
|
|
sendControlChange(96, amount, channel, cable);
|
|
}
|
|
void sendNrpnDecrement(uint8_t amount, uint8_t channel, uint8_t cable=0) __attribute__((always_inline)) {
|
|
sendControlChange(97, amount, channel, cable);
|
|
}
|
|
void endNrpn(uint8_t channel, uint8_t cable=0) __attribute__((always_inline)) {
|
|
sendControlChange(99, 0x7F, channel, cable);
|
|
sendControlChange(98, 0x7F, channel, cable);
|
|
}
|
|
void send(uint8_t type, uint8_t data1, uint8_t data2, uint8_t channel, uint8_t cable) __attribute__((always_inline)) {
|
|
if (cable >= MIDI_NUM_CABLES) return;
|
|
if (type < 0xF0) {
|
|
if (type < 0x80) return;
|
|
type &= 0xF0;
|
|
usb_midi_write_packed((type << 8) | (type >> 4) | ((cable & 0x0F) << 4)
|
|
| (((channel - 1) & 0x0F) << 8) | ((data1 & 0x7F) << 16)
|
|
| ((data2 & 0x7F) << 24));
|
|
} else if (type >= 0xF8 || type == 0xF6) {
|
|
usb_midi_write_packed((type << 8) | 0x0F | ((cable & 0x0F) << 4));
|
|
} else if (type == 0xF1 || type == 0xF3) {
|
|
usb_midi_write_packed((type << 8) | 0x02 | ((cable & 0x0F) << 4)
|
|
| ((data1 & 0x7F) << 16));
|
|
} else if (type == 0xF2) {
|
|
usb_midi_write_packed((type << 8) | 0x03 | ((cable & 0x0F) << 4)
|
|
| ((data1 & 0x7F) << 16) | ((data2 & 0x7F) << 24));
|
|
}
|
|
}
|
|
void send_now(void) __attribute__((always_inline)) {
|
|
usb_midi_flush_output();
|
|
}
|
|
uint8_t analog2velocity(uint16_t val, uint8_t range);
|
|
bool read(uint8_t channel=0) __attribute__((always_inline)) {
|
|
return usb_midi_read(channel);
|
|
}
|
|
uint8_t getType(void) __attribute__((always_inline)) {
|
|
return usb_midi_msg_type;
|
|
}
|
|
uint8_t getCable(void) __attribute__((always_inline)) {
|
|
return usb_midi_msg_cable;
|
|
}
|
|
uint8_t getChannel(void) __attribute__((always_inline)) {
|
|
return usb_midi_msg_channel;
|
|
}
|
|
uint8_t getData1(void) __attribute__((always_inline)) {
|
|
return usb_midi_msg_data1;
|
|
}
|
|
uint8_t getData2(void) __attribute__((always_inline)) {
|
|
return usb_midi_msg_data2;
|
|
}
|
|
uint8_t * getSysExArray(void) __attribute__((always_inline)) {
|
|
return usb_midi_msg_sysex;
|
|
}
|
|
uint16_t getSysExArrayLength(void) __attribute__((always_inline)) {
|
|
return usb_midi_msg_data2 << 8 | usb_midi_msg_data1;
|
|
}
|
|
|
|
void setHandleNoteOff(void (*fptr)(uint8_t channel, uint8_t note, uint8_t velocity)) {
|
|
// type: 0x80 NoteOff
|
|
usb_midi_handleNoteOff = fptr;
|
|
}
|
|
void setHandleNoteOn(void (*fptr)(uint8_t channel, uint8_t note, uint8_t velocity)) {
|
|
// type: 0x90 NoteOn
|
|
usb_midi_handleNoteOn = fptr;
|
|
}
|
|
void setHandleVelocityChange(void (*fptr)(uint8_t channel, uint8_t note, uint8_t velocity)) {
|
|
// type: 0xA0 AfterTouchPoly
|
|
usb_midi_handleVelocityChange = fptr;
|
|
}
|
|
void setHandleAfterTouchPoly(void (*fptr)(uint8_t channel, uint8_t note, uint8_t pressure)) {
|
|
// type: 0xA0 AfterTouchPoly
|
|
usb_midi_handleVelocityChange = fptr;
|
|
}
|
|
void setHandleControlChange(void (*fptr)(uint8_t channel, uint8_t control, uint8_t value)) {
|
|
// type: 0xB0 ControlChange
|
|
usb_midi_handleControlChange = fptr;
|
|
}
|
|
void setHandleProgramChange(void (*fptr)(uint8_t channel, uint8_t program)) {
|
|
// type: 0xC0 ProgramChange
|
|
usb_midi_handleProgramChange = fptr;
|
|
}
|
|
void setHandleAfterTouch(void (*fptr)(uint8_t channel, uint8_t pressure)) {
|
|
// type: 0xD0 AfterTouchChannel
|
|
usb_midi_handleAfterTouch = fptr;
|
|
}
|
|
void setHandleAfterTouchChannel(void (*fptr)(uint8_t channel, uint8_t pressure)) {
|
|
// type: 0xD0 AfterTouchChannel
|
|
usb_midi_handleAfterTouch = fptr;
|
|
}
|
|
void setHandlePitchChange(void (*fptr)(uint8_t channel, int pitch)) {
|
|
// type: 0xE0 PitchBend
|
|
usb_midi_handlePitchChange = fptr;
|
|
}
|
|
void setHandleSysEx(void (*fptr)(const uint8_t *data, uint16_t length, bool complete)) {
|
|
// type: 0xF0 SystemExclusive - multiple calls for message bigger than buffer
|
|
usb_midi_handleSysExPartial = (void (*)(const uint8_t *, uint16_t, uint8_t))fptr;
|
|
}
|
|
void setHandleSystemExclusive(void (*fptr)(const uint8_t *data, uint16_t length, bool complete)) {
|
|
// type: 0xF0 SystemExclusive - multiple calls for message bigger than buffer
|
|
usb_midi_handleSysExPartial = (void (*)(const uint8_t *, uint16_t, uint8_t))fptr;
|
|
}
|
|
void setHandleSystemExclusive(void (*fptr)(uint8_t *data, unsigned int size)) {
|
|
// type: 0xF0 SystemExclusive - single call, message larger than buffer is truncated
|
|
usb_midi_handleSysExComplete = fptr;
|
|
}
|
|
void setHandleTimeCodeQuarterFrame(void (*fptr)(uint8_t data)) {
|
|
// type: 0xF1 TimeCodeQuarterFrame
|
|
usb_midi_handleTimeCodeQuarterFrame = fptr;
|
|
}
|
|
void setHandleSongPosition(void (*fptr)(uint16_t beats)) {
|
|
// type: 0xF2 SongPosition
|
|
usb_midi_handleSongPosition = fptr;
|
|
}
|
|
void setHandleSongSelect(void (*fptr)(uint8_t songnumber)) {
|
|
// type: 0xF3 SongSelect
|
|
usb_midi_handleSongSelect = fptr;
|
|
}
|
|
void setHandleTuneRequest(void (*fptr)(void)) {
|
|
// type: 0xF6 TuneRequest
|
|
usb_midi_handleTuneRequest = fptr;
|
|
}
|
|
void setHandleClock(void (*fptr)(void)) {
|
|
// type: 0xF8 Clock
|
|
usb_midi_handleClock = fptr;
|
|
}
|
|
void setHandleStart(void (*fptr)(void)) {
|
|
// type: 0xFA Start
|
|
usb_midi_handleStart = fptr;
|
|
}
|
|
void setHandleContinue(void (*fptr)(void)) {
|
|
// type: 0xFB Continue
|
|
usb_midi_handleContinue = fptr;
|
|
}
|
|
void setHandleStop(void (*fptr)(void)) {
|
|
// type: 0xFC Stop
|
|
usb_midi_handleStop = fptr;
|
|
}
|
|
void setHandleActiveSensing(void (*fptr)(void)) {
|
|
// type: 0xFE ActiveSensing
|
|
usb_midi_handleActiveSensing = fptr;
|
|
}
|
|
void setHandleSystemReset(void (*fptr)(void)) {
|
|
// type: 0xFF SystemReset
|
|
usb_midi_handleSystemReset = fptr;
|
|
}
|
|
void setHandleRealTimeSystem(void (*fptr)(uint8_t realtimebyte)) {
|
|
// type: 0xF8-0xFF - if more specific handler not configured
|
|
usb_midi_handleRealTimeSystem = fptr;
|
|
};
|
|
};
|
|
|
|
extern usb_midi_class usbMIDI;
|
|
|
|
|
|
#endif // __cplusplus
|
|
|
|
#endif // MIDI_INTERFACE
|
|
|
|
#endif // USBmidi_h_
|
|
|