kinect_fetch_fw: add a mechanism to check the integrity of the downloaded file
[kinect-audio-setup.git] / README
1 kinect-audio-setup makes audio input from the Microsoft Kinect Sensor
2 device work on GNU/linux systems.
3
4 When the Kinect is first plugged in the USB port it shows up as a
5 generic USB device with a bulk endpoint; after uploading a certain
6 firmware a reenumeration takes place and a USB Audio Class device
7 becomes available.
8
9 kinect-audio-setup provides tools to download the firmware off the net
10 at installation time â€”since it is not redistributable—, and it sets up
11 udev rules to call the firmware loader when the device is plugged in to
12 finally get the USB Audio Class device.
13
14 Note that for all the magic to happen automatically pulseaudio >= 1.0 is
15 needed, as it contains the kinect-audio.conf profile which fixes audio
16 device detection:
17   https://bugs.freedesktop.org/show_bug.cgi?id=39664
18
19 kinect-audio-setup provides:
20   - kinect_fetch_fw which downloads and extracts the firmware from the
21     Microsoft Kinect SDK;
22   - kinect_upload_fw which loads the firmware to the generic USB device
23     in order to get the USB Audio Class device to show up;
24   - udev rules to call kinect_upload_fw when the device is plugged in.
25
26
27 To install kinect-audio-setup from the source distribution follow the
28 steps below with superuser rights:
29
30 Install kinect_upload_fw first:
31
32   # make install
33
34 Then run the firmware fetcher script (remember this is only needed
35 once):
36
37   # ./kinect_fetch_fw /lib/firmware/kinect