tiny USB-MIDI driver for Linux


About it
========

This package contains tiny "usb-midi" driver for Linux.
It can enbale to use your "usb-midi" like device in your system.


Attention
=========

This driver only supports "raw midi device (/dev/midixx)",
doesn't "sequencer device (/dev/sequencer)".
We'll never support it since it's obsolete.


Supported (tested) platform
===========================

  Linux 2.2.17 or later
  Linux 2.4.0 or later


Can work with
=============

 * Generic USB-MIDI devices

 * Some vendor specific USB-MIDI devices:
     RolandED / Edirol:
               SC-8850
               UA-100(G)
               UM-2
               UM-1
               PC-100
               XV-2020
               and other devices can be controlled by this driver

     YAMAHA:
               MU-1000
               UX-16
               and other YAMAHA devices

     MidiMan:
               MidiSport 1x1
               MidiSport 2x2
               (4x4 and 8x8 aren't supported)

     Steinberg:
               USB-2-MIDI

     MOTU:
               Fastlane

   MidiMans' and Steinbergs' requires to download firmware to
   each devices. Check testing/ directory.


Compile
=======

Just type `make`.

After all compilation succeeded, type:
 # cp usb-midi.o /lib/modules/<kernel-version>/usb ; depmod -a

In RedHat, you may use
 # make -f Makefile.RedHat install

If you meet any errors, fix it.


Usage
=====

If your device is supported by this driver, enter:

# modprobe usb-midi


But currently it only supports few USB-MIDI devices.
You may use your "USB-MIDI" like device by specifying parameters by hand:

# modprobe usb-midi uvendor=<vendor_id> uproduct=<product_id> \
                    uinterface=<interface_number> \
                    umin=<midi-in_endpoint_id> umout=<midi-out_endpoint_id> \
                    ucable=<cable_id>

 ex) with UM-1, you can type
   # modprobe usb-midi uvendor=0x582 uproduct=0x0009 uinterface=2 \
              umin=1 umout=0x81 ucable=0

Hotplugging
===========

 Please refer testing/Hotplugging.txt.


How to make your 'USB-MIDI' device to work with this driver
===========================================================

If your device isn't described above, try following:

1. Check "Vendor Id" and "Product Id" and "Interface Number" of
   your device.
   These parameters can be obtained by "lsusb" or "usbview".

2. # modprobe usb-midi uvendor=<Vendor Id> uproduct=<Product Id>
              uinterface=<Interface Number>

3. If it doesn't work, specify 'umout' / 'umin' with appropriate value.
   Available values are also obtained from above programs.

4. If your device have two or more MIDI port, you may use these by
   specifying 'ucable'.

'umin', 'umout' and 'ucable': from 0 up to 15.


If you can use your driver with above method, please inform your
parameter to me.


Availability
============

 Recent version of this driver may be available at
   http://member.nifty.ne.jp/Breeze/softwares/unix/usbmidi-e.html


Thanks to
=========

 Described in ChangeLog.


Author
======

 NAGANO Daisuke <breeze.nagano@nifty.ne.jp>
 Richard Penner <richardpenner@home.com>