Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 233 lines (193 sloc) 11.593 kb
d13b15b @avin2 Updated to code base 5.1.0.25 + applied kinect patch.
authored
1 PrimeSense Sensor Module for OpenNI (Version 5.1.0.25 version - Dec 18th 2011)
2 ------------------------------------------------------------------------------
75d38d7 @avin2 Initial kinect compatability
authored
3
4 Kinect Mod:
5 -----------
6
8f199ca @avin2 Updated codebase to the latest OpenNI / Sensor version (1.1.0.39 / 5.…
authored
7 ***** Important notice: *****
608308f @avin2 Updated codebase to the latest OpenNI / Sensor version (1.3.2.1 / 5.0…
authored
8 You must use this kinect mod version with the unstable OpenNI release which is available at:
d13b15b @avin2 Updated to code base 5.1.0.25 + applied kinect patch.
authored
9 http://www.openni.org/Downloads/OpenNIModules.aspx
8f199ca @avin2 Updated codebase to the latest OpenNI / Sensor version (1.1.0.39 / 5.…
authored
10
75d38d7 @avin2 Initial kinect compatability
authored
11 Changes:
d13b15b @avin2 Updated to code base 5.1.0.25 + applied kinect patch.
authored
12 v0.91:
13 1) Removed an unnecessary USB set interface command that caused timeout problems on Linux & Mac.
14
15 v0.9:
16 1) Updated codebase to the latest OpenNI / Sensor version (1.5.2.7 / 5.1.0.25)
17 2) Changed the Bayer-to-RGB function to use the ROS (www.ros.org) code as requested by many community members.
18 (Thanks to Suat Gedikli from Willow Garage for writing the code and to Raphael Dumusc for the OpenNI adaptation!)
19
20 v0.8:
21 1) Updated codebase to the latest OpenNI / Sensor version (1.4.0.2 / 5.0.5.1)
22
23 v0.7:
24 1) Updated codebase to the latest OpenNI / Sensor version (1.3.2.3 / 5.0.3.34)
25 2) Added a 64-bit binary installer for Windows.
26
608308f @avin2 Updated codebase to the latest OpenNI / Sensor version (1.3.2.1 / 5.0…
authored
27 v0.6:
28 1) Updated codebase to the latest OpenNI / Sensor version (1.3.2.1 / 5.0.3.33)
29
8f199ca @avin2 Updated codebase to the latest OpenNI / Sensor version (1.1.0.39 / 5.…
authored
30 v0.5:
31 1) Updated codebase to the latest OpenNI / Sensor version (1.1.0.39 / 5.0.1.32)
d13b15b @avin2 Updated to code base 5.1.0.25 + applied kinect patch.
authored
32 2) Changed to install directory from Sensor to SensorKinect to co-exist with the original PrimeSense Sensor module.
8f199ca @avin2 Updated codebase to the latest OpenNI / Sensor version (1.1.0.39 / 5.…
authored
33
34 v0.4:
35 1) Merged code with the new unstable sensor driver from PrimeSense that adds MacOSX and multiple sensor support.
36 2) Added precompiled binaries for Linux & MacOSX.
37
cc3dd7c @avin2 Added support for high-res 1280x1024 IR and Image (at ~10 FPS)
authored
38 v0.3:
39 1) Added support for high-res 1280x1024 IR and Image (at ~10 FPS)
40 Checkout the file OPENNI\Data\SamplesConfig.xml for usage example.
41 (Copy it to your OpenNI\Data dir and use NiViewer to test the different resolutions)
42
1699b44 @avin2 v0.2:
authored
43 v0.2:
44 1) VS2010 redist will now be installed automatically.
45 2) The driver will now also be installed automatically on both x86 and x64 machines.
46 3) Turned off the IR projector anti-cover thingy. It is off on the Xbox360 so it must be safe and it was very annoying...
47
48 v0.1:
75d38d7 @avin2 Initial kinect compatability
authored
49 1) Added the kinect USB VID/PID to the PSDrv3 driver and to the code.
50 2) Changed the packet sequence field from 16-bit to 8-bit (don't know why it's different...)
51 3) Changed the image format from YUV to 8-bit uncompressed bayer in the GlobalDefaults.ini file.
52 4) Fixed the software depth-to-RGB registration. (Thanks ROS.org for that!)
53
8f199ca @avin2 Updated codebase to the latest OpenNI / Sensor version (1.1.0.39 / 5.…
authored
54 Install notes:
d13b15b @avin2 Updated to code base 5.1.0.25 + applied kinect patch.
authored
55 1) Install unstable OpenNI (http://www.openni.org/Downloads/OpenNIModules.aspx)
8f199ca @avin2 Updated codebase to the latest OpenNI / Sensor version (1.1.0.39 / 5.…
authored
56 On Linux/Mac please do: ./sudo install.sh
75d38d7 @avin2 Initial kinect compatability
authored
57 2) Install Sensor (this version...)
8f199ca @avin2 Updated codebase to the latest OpenNI / Sensor version (1.1.0.39 / 5.…
authored
58 On Linux/Mac please do: ./sudo install.sh
608308f @avin2 Updated codebase to the latest OpenNI / Sensor version (1.3.2.1 / 5.0…
authored
59 3) Install unstable NITE (http://www.openni.org/downloadfiles/opennimodules/openni-compliant-middleware-binaries/33-latest-unstable)
8f199ca @avin2 Updated codebase to the latest OpenNI / Sensor version (1.1.0.39 / 5.…
authored
60 On Linux/Mac please do: ./sudo install.sh
61 4) Test #1: Run the NiViewer sample to make sure depth & image streams are working.
d13b15b @avin2 Updated to code base 5.1.0.25 + applied kinect patch.
authored
62 5) Test #2: Run the OpenNI/NiUserTracker sample play with the skeleton.
8f199ca @avin2 Updated codebase to the latest OpenNI / Sensor version (1.1.0.39 / 5.…
authored
63 6) Test #3: Try the NITE/Sample-PointViewer sample for the hand tracking demo.
1699b44 @avin2 v0.2:
authored
64
8f199ca @avin2 Updated codebase to the latest OpenNI / Sensor version (1.1.0.39 / 5.…
authored
65 For Mac/Linux, you will need to install the latest LibUSB.
66 Linux:
67 1) Run: sudo apt-get install libusb-1.0-0-dev
68 2) Run: sudo apt-get install freeglut3-dev
69 MaxOSX:
d13b15b @avin2 Updated to code base 5.1.0.25 + applied kinect patch.
authored
70 1) Install MacPorts from: http://distfiles.macports.org/MacPorts/MacPorts-1.9.2-10.6-SnowLeopard.dmg
8f199ca @avin2 Updated codebase to the latest OpenNI / Sensor version (1.1.0.39 / 5.…
authored
71 2) Run: sudo port install libtool
72 3) Run: sudo port install libusb-devel +universal
73 Note: Do not forget the +universal, it's very important!!
74 If you're previously already installed libusb-devel then use "sudo port uninstall libusb-devel" and reinstall it again with the +universal flag.
1699b44 @avin2 v0.2:
authored
75 TIPs:
8f199ca @avin2 Updated codebase to the latest OpenNI / Sensor version (1.1.0.39 / 5.…
authored
76 1) If the driver is installed correctly you should see "Kinect Camera" and "Kinect Motor" under the "PrimeSensor" category in the device manager.
77 If not, try to install the driver manually by running the dp-inst files from the Driver directory.
78
79 Todo:
80 1) Add motor & led control.
81 2) Add audio.
82
83 The source code for this version is available at:
84 https://github.com/avin2/SensorKinect
85
86 -------------------------- ORIGINAL README BELOW --------------------------
87
d13b15b @avin2 Updated to code base 5.1.0.25 + applied kinect patch.
authored
88 Website: http://www.primesense.com
8f199ca @avin2 Updated codebase to the latest OpenNI / Sensor version (1.1.0.39 / 5.…
authored
89 Forum: http://groups.google.com/group/openni-dev
d13b15b @avin2 Updated to code base 5.1.0.25 + applied kinect patch.
authored
90 Wiki: http://wiki.openni.org
8f199ca @avin2 Updated codebase to the latest OpenNI / Sensor version (1.1.0.39 / 5.…
authored
91
92 Binaries are available at:
d13b15b @avin2 Updated to code base 5.1.0.25 + applied kinect patch.
authored
93 http://www.openni.org/Downloads/OpenNIModules.aspx
94 (The "OpenNI Compliant Hardware Binaries" section)
8f199ca @avin2 Updated codebase to the latest OpenNI / Sensor version (1.1.0.39 / 5.…
authored
95
d13b15b @avin2 Updated to code base 5.1.0.25 + applied kinect patch.
authored
96 Sources are available at:
97 https://github.com/PrimeSense/Sensor
98 or
99 https://github.com/PrimeSense/Sensor/tree/unstable
100 for the unstable branch
c0e70ea @OpenNI first version
OpenNI authored
101
102 Release Notes:
103 --------------
104 * At the moment, the default is to compile the code with SSE3 support (this is also true for the supplied binaries).
105 If you have a CPU without such support, please remove the sse compiler flags from the make files.
106 (A good hint for this error is that you encounter an "illegal instructions" messages)
107 * By default, the linux kernel mounts unknown USB devices with write permissions to root only, and read-only permissions to other users.
108 When not running as root, this prevents communicating with the device. To fix this issue:
d13b15b @avin2 Updated to code base 5.1.0.25 + applied kinect patch.
authored
109 - Navigate to Platform/Linux/Build
c0e70ea @OpenNI first version
OpenNI authored
110 - run 'make install-usb-rules'
111 - if the device was connected, unplug and reconnect it.
112 This part is done automatically by the install script, but you will need to do it manually if you choose not to use the automated install.
d13b15b @avin2 Updated to code base 5.1.0.25 + applied kinect patch.
authored
113 * Linux: The device driver contains a thread for reading from the USB device. This thread should have high priority in order to function correctly. Each process using the device driver should have the CAP_SYS_NICE capability in order to raise thread priority. Failing to have that capability, will cause a failure in setting priority, consequently causing loss of data.
114 * MacOSX: Only OSX 10.6 (Snow Leopard) and above with a 64-bit Intel based CPU is currently supported.
8f199ca @avin2 Updated codebase to the latest OpenNI / Sensor version (1.1.0.39 / 5.…
authored
115 Client/Server is not supported yet so do not attempt to access the sensor with more then one application.
116
c0e70ea @OpenNI first version
OpenNI authored
117
118 Build Notes:
119 ------------
120 Windows:
121 Requirements:
122 1) Microsoft Visual Studio 2008/2010
8f199ca @avin2 Updated codebase to the latest OpenNI / Sensor version (1.1.0.39 / 5.…
authored
123 From: http://msdn.microsoft.com/en-us/vstudio/bb984878.aspx
124 2) Python 2.6+/3.x
125 From: http://www.python.org/download/
126 3) PyWin32
127 From: http://sourceforge.net/projects/pywin32/files/pywin32/
128 Please make sure you download the version that matches your exact python version.
129 4) WIX 3.5
130 From: http://wix.codeplex.com/releases/view/60102
d13b15b @avin2 Updated to code base 5.1.0.25 + applied kinect patch.
authored
131 5) OpenNI 1.3.x.x
132 From: http://www.openni.org/Downloads/OpenNIModules.aspx
8f199ca @avin2 Updated codebase to the latest OpenNI / Sensor version (1.1.0.39 / 5.…
authored
133
134 Optional Requirements (To build the documentation):
135 1) Doxygen
136 From: http://www.stack.nl/~dimitri/doxygen/download.html#latestsrc
137 2) GraphViz
138 From: http://www.graphviz.org/Download_windows.php
139
c0e70ea @OpenNI first version
OpenNI authored
140 Building Sensor:
8f199ca @avin2 Updated codebase to the latest OpenNI / Sensor version (1.1.0.39 / 5.…
authored
141 1) Go to the directory: "Platform\Win32\CreateRedist".
142 Run the script: "Redist.py".
143 This will compile and prepare the redist exe files that includes everything.
d13b15b @avin2 Updated to code base 5.1.0.25 + applied kinect patch.
authored
144 2) Install the exe you've just made which is located in Platform\Win32\CreateRedist\FinalXX\Sensor-Win32-5.x.x.x.exe
145 (XX being the number of bits: 32 or 64)
c0e70ea @OpenNI first version
OpenNI authored
146 The installer will also automatically register all the modules into OpenNI via the NiReg utility.
147
148 The visual studio solution is located in: Platform\Win32\Build\EngineWin32.sln.
149
8f199ca @avin2 Updated codebase to the latest OpenNI / Sensor version (1.1.0.39 / 5.…
authored
150 Important: Please note that even though the directory is called Win32, you can also use it to compile it for 64-bit targets (AMD64/x64).
151
c0e70ea @OpenNI first version
OpenNI authored
152 Linux:
153 Requirements:
154 1) GCC 4.x
8f199ca @avin2 Updated codebase to the latest OpenNI / Sensor version (1.1.0.39 / 5.…
authored
155 From: http://gcc.gnu.org/releases.html
156 Or via apt:
157 sudo apt-get install g++
158 2) Python 2.6+/3.x
159 From: http://www.python.org/download/
160 Or via apt:
161 sudo apt-get install python
d13b15b @avin2 Updated to code base 5.1.0.25 + applied kinect patch.
authored
162 3) OpenNI 1.3.x.x
163 From: http://www.openni.org/Downloads/OpenNIModules.aspx
8f199ca @avin2 Updated codebase to the latest OpenNI / Sensor version (1.1.0.39 / 5.…
authored
164
c0e70ea @OpenNI first version
OpenNI authored
165 Building Sensor:
d13b15b @avin2 Updated to code base 5.1.0.25 + applied kinect patch.
authored
166 1) Go into the directory: "Platform/Linux/CreateRedist".
8f199ca @avin2 Updated codebase to the latest OpenNI / Sensor version (1.1.0.39 / 5.…
authored
167 Run the script: "./RedistMaker".
d13b15b @avin2 Updated to code base 5.1.0.25 + applied kinect patch.
authored
168 This will compile everything and create a redist package in the "Platform/Linux/Redist" directory.
169 It will also create a distribution in the "Platform/Linux/CreateRedist/Final" directory.
170 2) Go into the directory: "Platform/Linux/Redist".
8f199ca @avin2 Updated codebase to the latest OpenNI / Sensor version (1.1.0.39 / 5.…
authored
171 Run the script: "sudo ./install.sh" (needs to run as root)
172
173 The install script copies key files to the following location:
174 Libs into: /usr/lib
175 Bins into: /usr/bin
176 Config files into: /usr/etc/primesense
177 USB rules into: /etc/udev/rules.d
178 Logs will be created in: /var/log/primesense
c0e70ea @OpenNI first version
OpenNI authored
179
d13b15b @avin2 Updated to code base 5.1.0.25 + applied kinect patch.
authored
180 To build the package manually, you can run "make" in the "Platform\Linux\Build" directory.
c0e70ea @OpenNI first version
OpenNI authored
181
d13b15b @avin2 Updated to code base 5.1.0.25 + applied kinect patch.
authored
182 Important: Please note that even though the directory is called Linux, you can also use it to compile it for 64-bit targets and pretty much any other linux based environment.
183
184 Building Sensor using a cross-compiler:
185 1) Make sure to define two environment variables:
186 - <platform>_CXX - the name of the cross g++ for platform <platform>
187 - <platform>_STAGING - a path to the staging dir (a directory which simulates the target root filesystem).
188 Note that <platform> should be upper cased.
189 For example, if wanting to compile for ARM from a x86 machine, ARM_CXX and ARM_STAGING should be defined.
190 2) Go into the directory: "Platform/Linux/CreateRedist".
191 Run: "./RedistMaker <platform>" (for example: "./RedistMake Arm").
192 This will compile everything and create a redist package in the "Platform/Linux/Redist" directory.
193 It will also create a distribution in the "Platform/Linux/CreateRedist/Final" directory.
194 3) To install OpenNI files on the target file system:
195 Go into the directory: "Platform/Linux/Redist".
196 Run the script: "./install.sh -c $<platform>_STAGING" (for example: "./install.sh -c $ARM_STAGING").
8f199ca @avin2 Updated codebase to the latest OpenNI / Sensor version (1.1.0.39 / 5.…
authored
197
d13b15b @avin2 Updated to code base 5.1.0.25 + applied kinect patch.
authored
198 The install script copies key files to the following location:
199 Libs into: STAGING/usr/lib
200 Bins into: STAGING/usr/bin
201 Config files into: STAGING/usr/etc/primesense
202 USB rules into: STAGING/etc/udev/rules.d
203 Logs will be created in: STAGING/var/log/primesense
204
205 To build the package manually, you can run "make PLATFORM=<platform>" in the "Platform\Linux\Build" directory.
206 If you wish to build the Mono wrappers, also run "make PLATFORM=<platform> mono_wrapper" and "make PLATFORM=<platform> mono_samples".
207
8f199ca @avin2 Updated codebase to the latest OpenNI / Sensor version (1.1.0.39 / 5.…
authored
208 MacOSX:
209 Requirements:
210 1) Xcode 3.2.6
211 From: http://developer.apple.com/devcenter/mac/index.action
212 http://developer.apple.com/devcenter/download.action?path=/Developer_Tools/xcode_3.2.6_and_ios_sdk_4.3__final/xcode_3.2.6_and_ios_sdk_4.3.dmg
213 Please note that you need to register as a mac developer (It's free!).
d13b15b @avin2 Updated to code base 5.1.0.25 + applied kinect patch.
authored
214 2) OpenNI 1.3.x.x
215 From: http://www.openni.org/Downloads/OpenNIModules.aspx
8f199ca @avin2 Updated codebase to the latest OpenNI / Sensor version (1.1.0.39 / 5.…
authored
216
217 Building Sensor:
d13b15b @avin2 Updated to code base 5.1.0.25 + applied kinect patch.
authored
218 1) Go into the directory: "Platform/Linux/CreateRedist".
8f199ca @avin2 Updated codebase to the latest OpenNI / Sensor version (1.1.0.39 / 5.…
authored
219 Run the script: "./RedistMaker".
d13b15b @avin2 Updated to code base 5.1.0.25 + applied kinect patch.
authored
220 This will compile everything and create a redist package in the "Platform/Linux/Redist" directory.
221 It will also create a distribution in the "Platform/Linux/CreateRedist/Final" directory.
222 2) Go into the directory: "Platform/Linux/Redist".
8f199ca @avin2 Updated codebase to the latest OpenNI / Sensor version (1.1.0.39 / 5.…
authored
223 Run the script: "sudo ./install.sh" (needs to run as root)
224
225 The install script copies key files to the following location:
226 Libs into: /usr/lib
227 Bins into: /usr/bin
228 Config files into: /usr/etc/primesense
229 USB rules into: /etc/udev/rules.d
230 Logs will be created in: /var/log/primesense
231
d13b15b @avin2 Updated to code base 5.1.0.25 + applied kinect patch.
authored
232 To build the package manually, you can run "make" in the "Platform\Linux\Build" directory.
Something went wrong with that request. Please try again.