X-Git-Url: https://git.ao2.it/kinect-audio-setup.git/blobdiff_plain/b82c5cba4f9caf266f315a6464b66265038fb01c..HEAD:/README?ds=sidebyside diff --git a/README b/README index 46e18cf..3943a7d 100644 --- a/README +++ b/README @@ -1,15 +1,15 @@ kinect-audio-setup makes audio input from the Microsoft Kinect Sensor -device work on GNU/linux systems. +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 +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 (UAC) 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. +at installation time —since the firmware 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 @@ -31,7 +31,28 @@ Install kinect_upload_fw first: # make install +it will be copied to /usr/local/sbin by default, assign the PREFIX +variable on the command line to install it to another location. + +Then install the udev rules to automate the firmware loading: + + # make install_udev_rules \ + FIRMWARE_PATH=/lib/firmware/kinect/UACFirmware \ + LOADER_PATH=/usr/local/sbin/kinect_upload_fw + Then run the firmware fetcher script (remember this is only needed once): # ./kinect_fetch_fw /lib/firmware/kinect + # udevadm control --reload-rules + + +The UAC firmware is downloaded from the Microsoft Kinect SDK at +http://www.kinectforwindows.org, the license of the SDK can be found at +http://research.microsoft.com/en-us/um/legal/kinectsdk-tou_noncommercial.htm + +=== Acknowledgements + +A special thanks goes to Steven Toth from http://kernellabs.com, who +kindly sponsored a Kinect to Antonio Ospite and made kinect-audio-setup +possible in its current form.