djm-fix.cpp
branchv_0
changeset 10 4d95b089457d
parent 5 ef8f4023e32e
child 11 5b351628a377
equal deleted inserted replaced
9:ee976a1d1f0a 10:4d95b089457d
    30 void interrupt(int signal) {
    30 void interrupt(int signal) {
    31 	run = false;
    31 	run = false;
    32 	std::cerr << "interrupt()" << std::endl; // TODO: do not mess STDIO
    32 	std::cerr << "interrupt()" << std::endl; // TODO: do not mess STDIO
    33 }
    33 }
    34 
    34 
       
    35 /**
       
    36  * The support for Pioneer DJ DJM-250MK2 (an external USB sound card / mixer) was added to the Linux (kernel) by these patches:
       
    37  *
       
    38  *  - https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/sound/usb?id=73d8c94084341e2895169a0462dbc18167f01683 (playback)
       
    39  *  - https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/sound/usb?id=14335d8b9e1a2bf006f9d969a103f9731cabb210 (recording)
       
    40  *  - https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/sound/usb?id=cdc01a1558dedcee3daee7e1802d0349a07edb87 (mixer setup)
       
    41  *
       
    42  * These patches are enough for playback and for recording from post CH faders.
       
    43  *
       
    44  * However this mixer is somehow incapacitated and if we want to record the raw signal from the PHONO or LINE channels,
       
    45  * we only get silence. This feature is important for DVS (Digital Vinyl Systems) setups where
       
    46  * the timecode signal from special control vinyls flows from mixer to the computer
       
    47  * where it is interpreted in a software like MIXXX and used for controlling the playback of files on our computer.
       
    48  * The signal (usually music) from these files flows back to the mixer and then to speakers and headphones.
       
    49  *
       
    50  * To make this work and enjoy all the features of the device we have bought, we need to tell the mixer that we
       
    51  * want the signal instead of silence on given channels. And this is the purpose of the djm-fix utility and
       
    52  * it is done by sending some magic packet to the mixer.
       
    53  *
       
    54  * Implementation of this magic in the AlsaBridge.cpp file is based on publicly available documentation
       
    55  * that can be found at <https://mixb.me/CDJHidProtocol/hid-analysis/handshake.html>.
       
    56  * This page pointed me to the proper hash function (according to the constants, it is bit uncommon but publicly known Fowler–Noll–Vo hash function, FNV)
       
    57  * and some magic bits. I wrote this standalone C++ program that talks with the mixer over MIDI SysEx messages and does the magic.
       
    58  *
       
    59  * When this program is started, it finds the mixer and makes it fully working.
       
    60  * It needs to be running all the time, otherwise we will get silence on the PHONO/LINE channels again.
       
    61  *
       
    62  * Install dependencies:
       
    63  *   apt install mercurial make pkg-config g++ libasound2-dev    # in Debian or Ubuntu (it will be similar in other distributions)
       
    64  *
       
    65  * Download djm-fix:
       
    66  *   hg clone https://hg.frantovo.cz/midi/djm-fix/               # primary source
       
    67  *   hg clone https://hg.globalcode.info/midi/djm-fix/           # or we can use this mirror
       
    68  *
       
    69  * Compile:
       
    70  *   make                                                        # we can skip this step, it will be compiled on the first run
       
    71  *
       
    72  * Run:
       
    73  *   make run
       
    74  *
       
    75  * Stop:
       
    76  *   press Ctrl+C
       
    77  */
       
    78 
    35 int main(int argc, char**argv) {
    79 int main(int argc, char**argv) {
    36 	std::string deviceName = argc == 2 ? argv[1] : "hw:1"; // FIXME: parse CLI options + automatic device search
    80 	std::string deviceName = argc == 2 ? argv[1] : "hw:1"; // FIXME: parse CLI options + automatic device search
    37 	
    81 
    38 	signal(SIGINT, interrupt);
    82 	signal(SIGINT, interrupt);
    39 	std::unique_ptr<djmfix::DJMFix> djmFix(djmfix::create());
    83 	std::unique_ptr<djmfix::DJMFix> djmFix(djmfix::create());
    40 	std::unique_ptr<djmfix::alsa::AlsaBridge> alsaBridge(djmfix::alsa::create(djmFix.get(), deviceName));
    84 	std::unique_ptr<djmfix::alsa::AlsaBridge> alsaBridge(djmfix::alsa::create(djmFix.get(), deviceName));
    41 
    85 
    42 	alsaBridge->start();
    86 	alsaBridge->start();