blob: 45770edebdf8b4b0e3faa274a44698c5bf113aa0 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
|
/**
* @file portmidicontroller.h
* @author Albert Santoni alberts@mixxx.org
* @author Sean M. Pappalardo spappalardo@mixxx.org
* @date Thu 15 Mar 2012
* @brief PortMidi-based MIDI backend
*
* This class is represents a MIDI device, either physical or software.
* It uses the PortMidi API to send and receive MIDI messages to/from the device.
* It's important to note that PortMidi treats input and output on a single
* physical device as two separate half-duplex devices. In this class, we wrap
* those together into a single device, which is why the constructor takes
* both arguments pertaining to both input and output "devices".
*
*/
#ifndef PORTMIDICONTROLLER_H
#define PORTMIDICONTROLLER_H
#include <portmidi.h>
#include <QScopedPointer>
#include "controllers/midi/midicontroller.h"
#include "controllers/midi/portmididevice.h"
// Note:
// A standard Midi device runs at 31.25 kbps, with 10 bits / byte
// 1 byte / 320 microseconds
// a usual Midi message has 3 byte which results to
// 1042.6 messages per second
//
// The MIDI over IEEE-1394:
// http://www.midi.org/techspecs/rp27v10spec%281394%29.pdf
// which is also used for USB defines 3 speeds:
// 1 byte / 320 microseconds
// 2 bytes / 320 microseconds
// 3 bytes / 320 microseconds
// which results in up to 3125 messages per second
// if we assume normal 3 Byte messages.
//
// For instants the SCS.1d, uses the 3 x speed
//
// Due to a bug Mixxx completely stops responding to the controller
// if more than this number of messages queue up. Don't lower this (much.)
// The SCS.1d a 3x Speed device
// accumulated 500 messages in a single poll during stress-testing.
// A midi message contains 1 .. 4 bytes.
// a 1024 messages buffer will buffer ~327 ms Midi-Stream
#define MIXXX_PORTMIDI_BUFFER_LEN 1024
// Length of SysEx buffer in byte
#define MIXXX_SYSEX_BUFFER_LEN 1024
// String to display for no MIDI devices present
#define MIXXX_PORTMIDI_NO_DEVICE_STRING "None"
// A PortMidi-based implementation of MidiController
class PortMidiController : public MidiController {
Q_OBJECT
public:
PortMidiController(const PmDeviceInfo* inputDeviceInfo,
const PmDeviceInfo* outputDeviceInfo,
int inputDeviceIndex,
int outputDeviceIndex);
~PortMidiController() override;
private slots:
int open() override;
int close() override;
bool poll() override;
protected:
// MockPortMidiController needs this to not be private.
void sendShortMsg(unsigned char status, unsigned char byte1,
unsigned char byte2) override;
private:
// The sysex data must already contain the start byte 0xf0 and the end byte
// 0xf7.
void sendBytes(const QByteArray& data) override;
bool isPolling() const override {
return true;
}
// For testing only so that test fixtures can install mock PortMidiDevices.
void setPortMidiInputDevice(PortMidiDevice* device) {
m_pInputDevice.reset(device);
}
void setPortMidiOutputDevice(PortMidiDevice* device) {
m_pOutputDevice.reset(device);
}
QScopedPointer<PortMidiDevice> m_pInputDevice;
QScopedPointer<PortMidiDevice> m_pOutputDevice;
PmEvent m_midiBuffer[MIXXX_PORTMIDI_BUFFER_LEN];
// Storage for SysEx messages
unsigned char m_cReceiveMsg[MIXXX_SYSEX_BUFFER_LEN];
int m_cReceiveMsg_index;
bool m_bInSysex;
friend class PortMidiControllerTest;
};
#endif
|
