HID: Prodikeys PC-MIDI HID Driver

A specialised HID driver for the Creative Prodikeys PC-MIDI USB Keyboard.

The Prodikeys PC-MIDI is a multifunction keyboard comprising a qwerty keyboard,
multimedia keys and a touch sensitive musical keyboard.

The specialised HID driver adds full support for the musical keyboard and extra
multimedia keys which are not currently handled by the default HID driver.

The specialised HID driver interfaces with ALSA, and presents the midi keyboard
as a rawmidi device. Sustain duration, octave shifting and the midi output
channel can be read/written form userspace via sysfs.

Signed-off-by: Don Prince <dhprince-devel@yahoo.co.uk>
ALSA parts:
Acked-by: Clemens Ladisch <clemens@ladisch.de>
Signed-off-by: Jiri Kosina <jkosina@suse.cz>

1 files changed, 29 insertions, 0 deletions

diff --git a/Documentation/ABI/testing/sysfs-driver-hid-prodikeys b/Documentation/ABI/testing/sysfs-driver-hid-prodikeys
new file mode 100644
index 000000000000..05d988c29a83
--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-driver-hid-prodikeys
@@ -0,0 +1,29 @@
+What:           /sys/bus/hid/drivers/prodikeys/.../channel
+Date:           April 2010
+KernelVersion:  2.6.34
+Contact:        Don Prince <dhprince.devel@yahoo.co.uk>
+Description:
+                Allows control (via software) the midi channel to which
+                that the pc-midi keyboard will output.midi data.
+                Range: 0..15
+                Type:  Read/write
+What:           /sys/bus/hid/drivers/prodikeys/.../sustain
+Date:           April 2010
+KernelVersion:  2.6.34
+Contact:        Don Prince <dhprince.devel@yahoo.co.uk>
+Description:
+                Allows control (via software) the sustain duration of a
+                note held by the pc-midi driver.
+                0 means sustain mode is disabled.
+                Range: 0..5000 (milliseconds)
+                Type:  Read/write
+What:           /sys/bus/hid/drivers/prodikeys/.../octave
+Date:           April 2010
+KernelVersion:  2.6.34
+Contact:        Don Prince <dhprince.devel@yahoo.co.uk>
+Description:
+                Controls the octave shift modifier in the pc-midi driver.
+                The octave can be shifted via software up/down 2 octaves.
+                0 means the no ocatve shift.
+                Range: -2..2 (minus 2 to plus 2)
+                Type: Read/Write