Notice: MediaWiki has been updated. Report any rough edges to marcan@marcan.st

Difference between revisions of "Getting Started Windows"

From OpenKinect
Jump to: navigation, search
(Building the Instructions: Added mention of unstable)
Line 42: Line 42:
 
* '''Step 1:''' Download CMAKE (Cross-Platform Make) and make sure you have a working C compiler (example Visual Studio 2010 or MinGW)
 
* '''Step 1:''' Download CMAKE (Cross-Platform Make) and make sure you have a working C compiler (example Visual Studio 2010 or MinGW)
  
* '''Step 2:''' Download the the master branch and all the Dependencies
+
* '''Step 2:''' Download the the master branch and all the Dependencies. (NOTE: if you plan on changing libfreenect or writing wrappers, you might want to download the unstable branch instead. Unstable has the latest commits that have not been fully tested yet.)
  
 
* '''Step 3:''' Run CMake-gui and point to the root directory where /src, /examples, etc. are children (where it has the first CMakeLists.txt)
 
* '''Step 3:''' Run CMake-gui and point to the root directory where /src, /examples, etc. are children (where it has the first CMakeLists.txt)

Revision as of 02:47, 25 December 2010

Building Kinect Drivers from Source

Dependencies

Download these and install them somwhere:

http://sourceforge.net/apps/trac/libusb-win32/wiki

ftp://sourceware.org/pub/pthreads-win32/dll-latest

http://www.xmission.com/~nate/glut.html

Driver installation

There are two parts to libfreenect -- the low-level libusb-based device driver and libfreenect itself, the library that talks to the driver. You only need to install the driver once.

General instructions

Plug in your Kinect. The Xbox NUI Motor loads first. Cancel any dialog that searches for drivers and open the Windows Device Manager. Find the Motor device, right click, and press "update device drivers" and manually browse for the location. Select the /platform/windows/inf folder within the libfreenect folders. After the Motor is installed, the Xbox NUI Camera and Xbox NUI Audio will connect and you can repeat the same thing for those drivers.

Windows 7: step-by-step walkthrough

Plug in your Kinect. Windows will warn that no device driver was found for the plugged device (the LED of Kinect will not turn on). If Windows presents a dialog asking to search for drivers, simply cancel it.

Open the Device Manager:

Start >> Control Panel >> System and Security >> System >> Device Manager

A device called "Xbox NUI Motor" should be somewhere there (most probably be under "Other devices") with a small yellow warning symbol "!" on top of its icon. Right click on it, and select "Update Driver Software...", then click on "Browse my computer for driver software".

Then pick "Browse" and select the folder where the "XBox_NUI_Motor.inf" is located. Click "Next" and if warned by Windows that a non-certified driver is about to be installed, just order it to install it anyway.

After that, the Kinect LED should start blinking green. Now there will be two additional devices in the Device Manager list: "Xbox NUI Camera" and "Xbox NUI Audio". Repeat the above instructions for them as well.

You are now ready to build libfreenect and start developing your own software in Windows with Kinect!

Building the Instructions

[1]

In the following, the process in order to create the drivers for Kinect in Windows and to run the example program.

  • Step 1: Download CMAKE (Cross-Platform Make) and make sure you have a working C compiler (example Visual Studio 2010 or MinGW)
  • Step 2: Download the the master branch and all the Dependencies. (NOTE: if you plan on changing libfreenect or writing wrappers, you might want to download the unstable branch instead. Unstable has the latest commits that have not been fully tested yet.)
  • Step 3: Run CMake-gui and point to the root directory where /src, /examples, etc. are children (where it has the first CMakeLists.txt)
  • Step 4: Use the configure option, select your C complier and let it run. It will point out several mistakes that will be presented as red in the CMake Gui. You must correct these problems. For the libfreenect header you must point at c/include, for USB header c/dependencies/include and so on...[NOTE: For now only select the EXAMPLES and C_SYNC build options. The others such as FAKENECT have not been updated for Visual Studio yet.]
  • Step 5: Finally accomplish configure and generate files (CMake-> configure, CMake-> generate). When it has errors then update the missing folders to the folders of the dependencies. The *_LIBRARY variables need to point to actual .lib files not a folder. INCLUDE variables need to point to the appropriate include directories. You might need to check the advanced checkbox to access some variables.
  • Step 6: After you can successfully generate the projects, open libfreenect.sln in Visual Studio and build the project.