MIDI-CTRL -> Developer Manual

Building on Ubuntu Linux (10.04)

We assume that we are building this with openjdk-6, however you can use other jdks by adjusting the CLASSPATH appropriately.

Prerequisites

  • 1. Install libasound2-dev, openjdk-6, gcc-avr
$ sudo apt-get install libasound2-dev openjdk-6 gcc-avr
...
$
  • 2. setup the classpath for openjdk6-dev: add "/usr/lib/jvm/java-6-openjdk/lib/tools.jar" to your $CLASSPATH environment variable.
$ echo 'export CLASSPATH="/usr/lib/jvm/java-6-openjdk/lib/tools.jar:$CLASSPATH"' >> ~/.profile
$
  • 3. Create a new directory that will contain the sourcecode and the binary tools contained in the framework.
$ mkdir midi-ctrl
$ cd midi-ctrl
$
  • 4. Download the source from github

Use git to clone the git repository at github.com/wesen/mididuino . For more information about the git source control system, visit git-scm.com .

$ git clone git://github.com/wesen/mididuino.git
Initialized empty Git repository in /private/tmp/midi-ctrl/mididuino/.git/
remote: Counting objects: 11179, done.
remote: Compressing objects: 100% (3823/3823), done.
remote: Total 11179 (delta 7498), reused 9968 (delta 6680)
Receiving objects: 100% (11179/11179), 12.79 MiB | 206 KiB/s, done.
Resolving deltas: 100% (7498/7498), done.
$
  • 5. Getting the distribution package

The MIDI-CTRL frameworks needs a working avr-gcc toolchain to compile binaries. On Linux, this toolchain is available from the host distribution (in the case of Ubuntu, we used apt-get to get the gcc-avr toolchain). Further shared files are available from a smaller dist-tar.gz :

$ wget http://ruinwesen.com/support-files/mididuino-dist-shared.tar.gz
$ tar zxvf mididuino-dist-shared.tar.gz
x mididuino-dist/
x mididuino-dist/shared/
...
$

Building the environment

  • 6. Build the MIDI-CTRL environment (Linux)

Now that all the files are there, build the MIDI-CTRL environment:

$ cd mididuino/build/linux/
$ ./clean.sh
$ ./dist.sh
Setting up directories to build under Linux
make: Nothing to be done for `all'.
Copying shared and core files...
Copying examples...
Building processing.core...
...
$

The environment is now available in the file midi-ctrl-XXX.tgz . Enter the directory, and run ./midi-ctrl to start the environment.

Also available in: HTML TXT