X-Git-Url: https://git.ao2.it/kinect-audio-setup.git/blobdiff_plain/818710a3e7595fbd09bfd43959c0d14515e1d4d6..54b0fdd2357b27cff1861cbe7d62581147a5fad0:/README diff --git a/README b/README index 8cc103b..46e18cf 100644 --- a/README +++ b/README @@ -1,7 +1,37 @@ +kinect-audio-setup makes audio input from the Microsoft Kinect Sensor +device work on GNU/linux systems. + +When the Kinect is first plugged in the USB port it shows up as a +generic USB device with a bulk endpoint; after uploading a certain +firmware a reenumeration takes place and a USB Audio Class device +becomes available. + +kinect-audio-setup provides tools to download the firmware off the net +at installation time —since it is not redistributable—, and it sets up +udev rules to call the firmware loader when the device is plugged in to +finally get the USB Audio Class device. + +Note that for all the magic to happen automatically pulseaudio >= 1.0 is +needed, as it contains the kinect-audio.conf profile which fixes audio +device detection: + https://bugs.freedesktop.org/show_bug.cgi?id=39664 + +kinect-audio-setup provides: + - kinect_fetch_fw which downloads and extracts the firmware from the + Microsoft Kinect SDK; + - kinect_upload_fw which loads the firmware to the generic USB device + in order to get the USB Audio Class device to show up; + - udev rules to call kinect_upload_fw when the device is plugged in. + + +To install kinect-audio-setup from the source distribution follow the +steps below with superuser rights: + Install kinect_upload_fw first: - $ make install + # make install -Then run the firmware download script: +Then run the firmware fetcher script (remember this is only needed +once): - $ ./kinect_fetch_fw /lib/firmware/kinect + # ./kinect_fetch_fw /lib/firmware/kinect