Read Me

USB Headset Buttons
===================

Author: Philipp Kolmann
	philipp@kolmann.at

The purpose if this program is to enable the Volume up and Down Buttons on my
Logitech USB 30 Headset. USB Headsets are very useful for VoIP applications
like SIP Networks or Skype. On my headset I have volume buttons which need
extra care to be taken of. This Application does it.

Requirements:
  * Linux 2.6
    Enabled CONFIG_INPUT_EVDEV in Kernel
  * ALSA libasound2 header files

  
Just compile it using the Makefile. You should have the libasound2 header files
installed (under Debian: apt-get install libasound2-dev)


To run it, you can tell it on the command-line which devices to use:

-e: Input Event Device:
    usually /dev/input/event?

    To find the event node which corresponds to your headset go to
    /sys/class/input/

    In the input? directories are name files which have the name of the
    device. The number is the same as the number for your /dev/input/event?
    node.

-s: ALSA Hardware
    usually hw:0 for first Soundcard, hw:1 for second...

-n: Alsa Subdevice to use. Should be something like 
    'Speaker Playback Volume'.

-a: Set alsa-steps for the change in the mixer

-p: Specify PID File, where child PID should be written to

-d: set Debug (more -d, more Debug)


For Release 0.9 I added some checking for the proper devices. If it doesn't
work, send me the output of the files:
  * /proc/asound/cards
  * /sys/class/input/*/name
and I will check for a more general decision process.

usb-headset-button is now much easier to configure. No more need to tweak in
the source.