forked from ros-pkg-git/Sensor
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME
141 lines (121 loc) · 6.7 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
PrimeSensor Modules for OpenNI (Unstable branch)
------------------------------------------------
Website: www.primesense.com
Forum: http://groups.google.com/group/openni-dev
Wiki: Coming soon!
Unstable branch new features:
* Audio streams are now supported.
* Sensor Server now supports multiple sensors.
* Added MacOSX platform support.
* Improved README! (much more detailed instructions...)
Unstable branch fixes:
* Server: a potential dead lock was solved.
* GetStringProperty would always return XN_STATUS_ERROR.
* Bug fix: infinite loop in server when a client tries to disconnect and streams can't be closed (usb timeout for example).
Binaries are available at:
Windows:
Coming soon... (switching to new web site...)
Ubuntu 10.10 x86:
Coming soon... (switching to new web site...)
Ubuntu 10.10 x64:
Coming soon... (switching to new web site...)
MacOSX 10.6 (i386 & x86_64 universal):
Coming soon... (switching to new web site...)
Please use this with the OpenNI unstable branch located at:
https://github.com/OpenNI/OpenNI/tree/unstable
(Please check www.openni.org for the latest links of the latest binaries)
Release Notes:
--------------
* At the moment, the default is to compile the code with SSE3 support (this is also true for the supplied binaries).
If you have a CPU without such support, please remove the sse compiler flags from the make files.
(A good hint for this error is that you encounter an "illegal instructions" messages)
* By default, the linux kernel mounts unknown USB devices with write permissions to root only, and read-only permissions to other users.
When not running as root, this prevents communicating with the device. To fix this issue:
- Navigate to Platform/Linux-x86/Build
- run 'make install-usb-rules'
- if the device was connected, unplug and reconnect it.
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.
* 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.
* MacOSX: Only OSX 10.6 (Snow Leopard) with a 64-bit Intel based CPU is currently supported.
Client/Server is not supported yet so do not attempt to access the sensor with more then one application.
Build Notes:
------------
Windows:
Requirements:
1) Microsoft Visual Studio 2008/2010
From: http://msdn.microsoft.com/en-us/vstudio/bb984878.aspx
2) Python 2.6+/3.x
From: http://www.python.org/download/
3) PyWin32
From: http://sourceforge.net/projects/pywin32/files/pywin32/
Please make sure you download the version that matches your exact python version.
4) NSIS 2.46
From: http://sourceforge.net/projects/nsis/files/NSIS%202/2.46/
5) NSIS-2.46-strlen_8192.zip patch
From: http://sourceforge.net/projects/nsis/files/NSIS%202/2.46/
This is a required patch to fix a critical bug in NSIS with long environment variables.
Simply unpack it into the directory where NSIS is installed and overwrite all files.
6) OpenNI v1.x
From: http://www.openni.org/?q=node/2
Optional Requirements (To build the documentation):
1) Doxygen
From: http://www.stack.nl/~dimitri/doxygen/download.html#latestsrc
2) GraphViz
From: http://www.graphviz.org/Download_windows.php
Building Sensor:
1) Go to the directory: "Platform\Win32\CreateRedist".
Run the script: "Redist.py".
This will compile and prepare the redist exe files that includes everything.
2) Install the exe you've just made which is located in Platform\Win32\CreateRedist\Final\Output\Sensor-Win32-5.x.x.x.exe
The installer will also automatically register all the modules into OpenNI via the NiReg utility.
The visual studio solution is located in: Platform\Win32\Build\EngineWin32.sln.
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).
Linux:
Requirements:
1) GCC 4.x
From: http://gcc.gnu.org/releases.html
Or via apt:
sudo apt-get install g++
2) Python 2.6+/3.x
From: http://www.python.org/download/
Or via apt:
sudo apt-get install python
3) OpenNI v1.x
From: http://www.openni.org/?q=node/2
Building Sensor:
1) Go into the directory: "Platform/Linux-x86/CreateRedist".
Run the script: "./RedistMaker".
This will compile everything and create a redist package in the "Platform/Linux-x86/Redist" directory.
It will also create a distribution in the "Platform/Linux-x86/CreateRedist/Final" directory.
2) Go into the directory: "Platform/Linux-x86/Redist".
Run the script: "sudo ./install.sh" (needs to run as root)
The install script copies key files to the following location:
Libs into: /usr/lib
Bins into: /usr/bin
Config files into: /usr/etc/primesense
USB rules into: /etc/udev/rules.d
Logs will be created in: /var/log/primesense
To build the package manually, you can run "make" in the "Platform\Linux-x86\Build" directory.
Important: Please note that even though the directory is called Linux-x86, you can also use it to compile it for 64-bit targets and pretty much any other linux based environment.
MacOSX:
Requirements:
1) Xcode 3.2.5
From: http://developer.apple.com/devcenter/mac/index.action
https://developer.apple.com/ios/download.action?path=/ios/ios_sdk_4.2__final/xcode_3.2.5_and_ios_sdk_4.2_final.dmg
Please note that you need to register as a mac developer (It's free!).
2) OpenNI v1.x
From: http://www.openni.org/?q=node/2
Building Sensor:
1) Go into the directory: "Platform/Linux-x86/CreateRedist".
Run the script: "./RedistMaker".
This will compile everything and create a redist package in the "Platform/Linux-x86/Redist" directory.
It will also create a distribution in the "Platform/Linux-x86/CreateRedist/Final" directory.
2) Go into the directory: "Platform/Linux-x86/Redist".
Run the script: "sudo ./install.sh" (needs to run as root)
The install script copies key files to the following location:
Libs into: /usr/lib
Bins into: /usr/bin
Config files into: /usr/etc/primesense
USB rules into: /etc/udev/rules.d
Logs will be created in: /var/log/primesense
To build the package manually, you can run "make" in the "Platform\Linux-x86\Build" directory.