Skip to content

A Linux Alsa MIDI device driver for the Mixman dm2(TM) virtual turntable device.

License

Notifications You must be signed in to change notification settings

kingcody/dm2linux

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Linux Alsa driver for the Mixman DM2

What it is

This driver converts the mixman DM2 into a ALSA MIDI device which can be connected to other MIDI devices with the aconnect command or with specialized GUIs such as qjackctl.

The driver was originally written to work well with Mixxx, an Open Source DJ mixing program, but it can just as well be used as a generic MIDI control surface.

Preliminaries

This driver requires Linux 2.6.22 or newer. On Linux 2.6.22, you need to apply the included patch first to enable LED output and recompile your kernel.

ONLY ON 2.6.22 KERNELS:

In order to get the LEDs on the dm2 device working, you need to
apply the kernel patch by changing into the Linux source tree and
issuing the following command:

   patch -p1 < /your/path/to/dm2/linux-lowspeedbulk.patch

Then recompile your kernel in the easiest way your distribution
allows. I use Debian/Ubuntu with make-kpkg. Read "man make-kpkg"
for full instructions.

This is unnecessary for all newer kernels.

Compiling / Installing

  1. The Debian / Ubuntu Way
Get the newest dm2-source_<version>_all.deb from sourceforge. Use
the following command sequence as root to build and install the
driver.

  # dpkg -i dm2-source_<version>_all.deb
  # apt-get install module-assistant
  # module-assistant prepare
  # module-assistant auto-install dm2
  1. The Old-Fashioned Way
Provided you have a recent kernel with header files, you can just
type "make" in the source directory. You should get a dm2.ko
kernel module shortly afterwards.

  make

This module can be insmod'ded (as root) or installed directly. To
install, you also need root privileges.

  sudo make install

This deposits the module in the "kernel/sound/drivers" section of
your kernel and scans it for USB autodetection.

Mixxx Configuration

For using the dm2 with mixxx, copy the MIDI mapping files into the mixxx midi directory:

# sudo cp mixxx/Mixman DM2* /usr/share/mixxx/midi/

For your convenience, there's a PNG there, which shows what functions are where in the default mapping.

Testing

Plug the DM2 into a free USB socket, and its LEDs should flash for a short time. This is meant as a self-test and it also signals the first step in the auto-calibration procedure, so please make sure the fader and joystick of the DM2 are centered when you plug the device in.

If you have seen the flashing LEDs, your driver is operational. For additional info, you can read "/var/log/messages" or the "dmesg" output.

Files

dm2.c driver source file dm2.h driver header file mixxx/* MIDI mapping for mixxx.org LICENSE.txt GNU General Public License linux-lowspeedbulk.patch kernel patch to allow bulk transfers on non-standard lowspeed USB devices Makefile makefile to build and install README this file

Authors

Andre Roth [email protected] Jan Jockusch [email protected]

About

A Linux Alsa MIDI device driver for the Mixman dm2(TM) virtual turntable device.

Resources

License

Stars

Watchers

Forks

Packages

No packages published