This guide assumes Carmine devices and Primesense's API's and drivers (OpenNI2 and NiTE2). Steps to install and configure opeNI2 with Msft's Kinect are being tested. In the meantime, the following link provides an easy to follwo guide (untested) for to use OpenNI2 with Kinect. The freenect driver link appears to be broken so use the direct [link] instead.
OpenNI2 Python
Compile and Install OpenNI2
Installation instructions and samples using the official Python wrappers for OpenNI2 and OpenCV. Adapted from Occipital
-
Tested on the following systems (running Python 2.7.3, OpenNI2.2, and OpenCV.2.4.10)
NOTE: root and ~ are used to represent home//
Dependencies
Windows use wheels from LDF
Linux Ubuntu
- OpenNI
sudo apt-get install libudev-dev libusb-1.0.0-dev
sudo apt-get install gcc-multilib git-core build-essential
sudo apt-get install doxygen graphviz default-jdk freeglut3-dev
- JDK There is a known issue with x86 architectures and jdk. Follow this [link] to add the jdk repo.
sudo apt-get install python-software-properties
sudo add-apt-repository ppa:webupd8team/java
sudo apt-get update
NOTE: the workaround was tested with jdk6 (commands to install other versions are on the site).
sudo apt-get install oracle-java6-installer
Then finally update the flags using the command from this [link]
export LDFLAGS+="-lc"
- Python Environment
sudo apt-get -y install python-dev python-numpy
sudo apt-get -y install python-scipy python-setuptools
sudo apt-get -y install ipython python-pip
sudo apt-get -y install libboost-python-dev
installation details
OpenNI2 Windows 7 x64OpenNI2. Download msi installer from structure io and follow the instructions
Primesense Python Bindings
-
Pip, from terminal:
- pip install primensense
-
Manual, download from python wrapper
- On an administrator terminal (i.e., right click on a terminal and select "run as administrator")
- Go to where the bindings were downloaded (e.g., cd C:\downloads\primensense)
- python setup.py install
Install OpenNI2 in Ubuntu 14.04
mkdir Install/kinect/openni2
cd Install/kinect/openni2
Clone from occipital github
git clone https://github.com/occipital/OpenNI2
cd OpenNI2
make
cd Packing
python ReleaseVersion.py x64 #x86
If no errors, the compressed installer will be created in "Final" folder (i.e., OpenNI-Linux-64-2.2.tar.bz2).
cd Final && cp OpenNI-Linux--2.2.tar.bz2 ~/Install/kinect/openni2
Extract the contents to OpenNI-Linux-x64-2.2 and rename the folder (helps with multiple installations/versions)
mv ~/Install/openni2/OpenNI-Linux-x64-2.2 ~/Install/kinect/openni2/OpenNI2-x64
cd ~/Install/kinect/openni2/OpenNI2-x64
Install
sudo ./install.sh
OpenNI2 in PandaBoard-ES and BeagleBoard-xM
mkdir Install/kinect/openni2
cd Install/kinect/openni2
Clone from occipital github
git clone https://github.com/occipital/OpenNI2
cd OpenNI2
Compile. Remove the floating point operation flag
gedit ThirdParty/PSCommon/BuildSystem/Platform.ARM
Remove/delete "-mfloat-abi=softfp" (save & close)
PLATFORM=Arm make # This steps took about 20 minutes
Create ARM installer
cd Packing/
python ReleaseVersion.py Arm
If no errors, the compressed installer will be created in "Final" folder (i.e., OpenNI-Linux-Arm-2.2.tar.bz2).
cd Final && cp OpenNI-Linux-Arm-2.2.tar.bz2 ~/Install/kinect/openni2
Extract the contents to OpenNI-Linux-Arm-2.2 and rename the folder (helps with multiple installations/versions)
mv ~/Install/kinect/openni2/OpenNI-Linux-Arm-2.2 ~/Install/kinect/openni2/OpenNI2-Arm
cd ~/Install/kinect/openni2/OpenNI2-Arm
Install
sudo ./install.sh
Install Python bindings in Ubuntu (12.04 ARM and 14.04 x64)
- Option 1. via pip -- not preferred
sudo pip install primensense
- Option 2. Manual Installation -- preferred
Download from: primesense python wrapper and save in system Downloads
Copy the tar.gz file to a known location
cd ~/Downloads && mv primesense-2.2.0.30-5.tar.gz ~/Install/kinect/openni2
Extract
tar -xvzf primesense-2.2.0.30-5.tar.gz
cd primesense-2.2.0.30-5
sudo python setup.py install
Direct the system to the location of libOpenNI2.so (Two methods)
- Method 1. Create a symbolic link to OpenNI2/Redist/OpenNI2.so or copy the library to /usr/local/lib/
sudo cp root/Install/kinect/openni2/OpenNI2-Arm/libOpenNI2.so /usr/local/lib # repeat for libNiTE2.so if available
sudo ldconfig
- Method 2. For mulitple OpenNI installations. Direct the code to library location using:
openni2.initialize(root+"/Install/kinect/openni2/OpenNI2-Arm/Redist/")
Test the setup using the initialize and is_initialize methods
python
>>from primesense import openni2
>>openni2.initialize(root+"/Install/kinect/openni2/OpenNI2-Arm/Redist/")
>>if (openni2.is_initialized()):
>> print "OpenNI2 initialized"
>>else:
>> raise ValueError("OpenNI2 failed to initialize!!")