Instalacja i konfiguracja Kinect, Wiimote i Eyetrackera: Różnice pomiędzy wersjami

Z Brain-wiki
 
(Nie pokazano 13 pośrednich wersji utworzonych przez tego samego użytkownika)
Linia 21: Linia 21:
 
  sudo usermod -G plugdev -a {USER_NAME}
 
  sudo usermod -G plugdev -a {USER_NAME}
  
Alternatywnie zamiast gotowej paczki binarek można użyć OpenNI ze strony http://structure.io/openni.
+
Alternatywnie można zainstalować całość ze źródeł - instrukcja znajduje się na dole tej strony.
  
=== wrapper+obci ===
+
=== Wrapper nite2 do Python + OpenBCI  ===
  
 
Moduł do Pythona (plik <code>nite2.so</code>) należy zbudować z repozytorium https://github.com/BrainTech/nite2-bindings i umieścić w katalogu <code>/usr/lib/python2.7/dist-packages</code>.
 
Moduł do Pythona (plik <code>nite2.so</code>) należy zbudować z repozytorium https://github.com/BrainTech/nite2-bindings i umieścić w katalogu <code>/usr/lib/python2.7/dist-packages</code>.
Linia 76: Linia 76:
 
  sudo ldconfig
 
  sudo ldconfig
  
=== D) Żeby działało bez sudo dla userów lab i newtech ===
+
=== D) Żeby działało bez sudo ===
 +
 
 +
Jeśli chcemy, żeby xwiimote dział bez sudo dla userów lab i newtech należy wykonać polecenia:
  
 
  sudo usermod -a -G input newtech
 
  sudo usermod -a -G input newtech
Linia 107: Linia 109:
 
Do pełnego działania Kinecta na Linuxie potrzebne są: OpenNI2, NiTE2, libfreenect z driverem do OpenNI2 oraz wrapper do Pythona - <code>nite2</code>.
 
Do pełnego działania Kinecta na Linuxie potrzebne są: OpenNI2, NiTE2, libfreenect z driverem do OpenNI2 oraz wrapper do Pythona - <code>nite2</code>.
  
Firma PrimeSense, autor OpenNI, została wykupiona przez Apple'a. Następnie projekt OpenNI został utajniony. Ponieważ jest to opensource, kody źródłowe są nadal dostępne. Najbardziej aktywnym forkiem jest repozytorium prowadzone przez http://occipital.com, dostępne pod adresem https://github.com/occipital/OpenNI2.
+
Firma PrimeSense, autor OpenNI, została wykupiona przez Apple'a. Następnie Apple wstrzymało publiczny rozwój projektu OpenNI - został on utajniony. Ponieważ jest to oprogramowanie opensource, kody źródłowe są nadal dostępne i mogą być używane przez każdego. Najbardziej aktywnym forkiem jest repozytorium prowadzone przez http://occipital.com, dostępne pod adresem https://github.com/occipital/OpenNI2.
  
 
=== OpenNI2 ===
 
=== OpenNI2 ===
Linia 117: Linia 119:
 
Instalacja wymagań
 
Instalacja wymagań
  
  sudo apt-get install git-core g++ cmake libudev-dev libxi-dev libxmu-dev python libusb-1.0-0-dev libudev-dev freeglut3-dev doxygen graphviz
+
  sudo apt-get install git g++ cmake python libudev-dev libxi-dev libxmu-dev libusb-1.0-0-dev libudev-dev freeglut3-dev doxygen graphviz
 +
 
 +
Do kompilacji niezbędna jest Java (dokładniej <code>javac</code>). Należy zainstalować jakiekolwiek JDK, np.:
  
sudo add-apt-repository ppa:webupd8team/java
+
  sudo apt-get install openjdk-7-jdk
sudo apt-get update
 
  sudo apt-get install oracle-java8-installer
 
  
 
Pobranie repozytorum i kompilacja
 
Pobranie repozytorum i kompilacja
Linia 127: Linia 129:
 
  git clone https://github.com/occipital/OpenNI2.git
 
  git clone https://github.com/occipital/OpenNI2.git
 
  cd OpenNI2
 
  cd OpenNI2
  #Save path for further reference
+
  make
  OPENNI_DIR="${PWD}"
+
 
 +
Warto zapisać ścieżkę do OpenNI w zmiennej (i następnie dodać do .profile lub .bashrc):
 +
 
 +
  export OPENNI_DIR=/home/{USER_NAME}/OpenNI2
  
sed -i '/-Werror/ s/^/#/' ${OPENNI_DIR}/ThirdParty/PSCommon/BuildSystem/CommonCppMakefile
+
Instalacja OpenNI:
  
echo "LDFLAGS += -lpthread" >> ${OPENNI_DIR}/Source/Tools/NiViewer/Makefile
 
make
 
 
  sudo ${OPENNI_DIR}/Packaging/Linux/install.sh
 
  sudo ${OPENNI_DIR}/Packaging/Linux/install.sh
 
  sudo gpasswd -a ${USER} video
 
  sudo gpasswd -a ${USER} video
Linia 150: Linia 153:
 
  git clone https://github.com/OpenKinect/libfreenect.git
 
  git clone https://github.com/OpenKinect/libfreenect.git
 
  cd libfreenect
 
  cd libfreenect
  mkdir build; cd build
+
  mkdir build
 +
cd build
 
  cmake .. -DBUILD_OPENNI2_DRIVER=ON
 
  cmake .. -DBUILD_OPENNI2_DRIVER=ON
 
  make -j4
 
  make -j4
 
  cp -L lib/OpenNI2-FreenectDriver/libFreenectDriver.so ${OPENNI_DIR}/Bin/x64-Release/OpenNI2/Drivers/
 
  cp -L lib/OpenNI2-FreenectDriver/libFreenectDriver.so ${OPENNI_DIR}/Bin/x64-Release/OpenNI2/Drivers/
  
Test
+
Testowanie
  
 
  cd ${OPENNI_DIR}/Bin/x64-Release/
 
  cd ${OPENNI_DIR}/Bin/x64-Release/
Linia 168: Linia 172:
  
 
  cp -L /usr/local/lib/OpenNI2-FreenectDriver/libFreenectDriver.so NiTE-Linux-x64-2.2/Samples/Bin/OpenNI2/Drivers/
 
  cp -L /usr/local/lib/OpenNI2-FreenectDriver/libFreenectDriver.so NiTE-Linux-x64-2.2/Samples/Bin/OpenNI2/Drivers/
 +
 +
=== Kompilacja Pythonowego modułu 'nite2' (wrappera do OpenNI2 + NiTE2) ===
 +
 +
$ sudo apt-get install python-dev libboost-all-dev
 +
$ git clone https://github.com/BrainTech/nite2-bindings
 +
$ cd nite2-bindings
 +
$ make

Aktualna wersja na dzień 12:08, 23 mar 2016

Kinect + OpenNI2 + NiTE2 + freenect

Należy pamiętać, żeby wszsstkie wystąpienia {USER_NAME} w poniższym kodzie zamienić na właściwą nazwę użytkownika.

Instalacja OpenNI 2 + NiTE 2 z prekonfigurowanych binarek dla Ubuntu 15.10:

sudo apt-get install freeglut3 python-opencv libboost-all-dev
cd ~
wget http://static.mroja.net/kinect/kinect.7z
7z x kinect.7z
cd ~/kinect
sudo cp primesense-and-kinect-usb.rules /etc/udev/rules.d/557-primesense-usb.rules
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/{USER_NAME}/kinect/Redist
cd Redist
./NiViewer

Linijkę export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/{USER_NAME}/kinect/Redist najlepiej wrzucić do pliku .profile lub .bashrc, żeby uruchamiana była przy każdym logowaniu.

Należy prawdzić czy użytkownik, na koncie którego będzie używany Kinect należy do grupy plugdev -- jeśli nie, dodać:

sudo usermod -G plugdev -a {USER_NAME}

Alternatywnie można zainstalować całość ze źródeł - instrukcja znajduje się na dole tej strony.

Wrapper nite2 do Python + OpenBCI

Moduł do Pythona (plik nite2.so) należy zbudować z repozytorium https://github.com/BrainTech/nite2-bindings i umieścić w katalogu /usr/lib/python2.7/dist-packages.

Żeby NiTE2 działo poprawnie wewnątrz OpenBCI należy skopiować katalog NiTE2 (~/kinect/Redist/NiTE2) do katalogu ~/.obci/sandbox.

na koncie lab

cd ~/kinect/Redist
cp /path_to_file/nite2.so nite2.so
cp -r /home/lab/kinect/Redist/NiTE2/ ~/.obci/sandbox/

na koncie newtech

cd ~/kinect/Redist
cp /path_to_file/nite2.so nite2.so
mkdir /home/newtech/.obci/  # jeśli katalog istnieje to pominąć
mkdir /home/newtech/.obci/sandbox  # j.w.
cp -r /home/newtech/kinect/Redist/NiTE2/ ~/.obci/sandbox/

Instalacja xwiimote

UWAGA!!! NIE NALEŻY instalować pakietu xwiimote z repozytoriów Debiana i Ubuntu - są one przestarzałe.

Wymagane wersje:

  • kernel >= 3.5+
  • bluez >= 5.11+

A) Instalacja wymaganych pakietów

sudo apt-get install autoconf autogen automake gcc bluetooth ncurses-dev libudev-dev libtool git blueman python-dev dh-autoreconf pkg-config swig

B) xwiimote driver & utils

git clone https://github.com/BrainTech/xwiimote
cd xwiimote
./autogen.sh
make
sudo make install
sudo ldconfig

C) Python bindings

git clone https://github.com/BrainTech/xwiimote-bindings
cd xwiimote-bindings
./autogen.sh
make
sudo make install
sudo ldconfig

D) Żeby działało bez sudo

Jeśli chcemy, żeby xwiimote dział bez sudo dla userów lab i newtech należy wykonać polecenia:

sudo usermod -a -G input newtech
sudo usermod -a -G input lab

E) Sparować urządzenie z użyciem wbudowanego do Ubuntu panelu Bluetooth

F) Demo

git clone https://github.com/BrainTech/wiiscale.git
cd wiiscale

Należy odkomentować linijki 134 i 135:

134: #        for m in measurements(iface):
135: #            print_bboard_measurements(*m)

Demo można uruchomić poleceniem:

python ./scale.py

Tobii REX eyetracker

Oprogramowanie do Kinecta ze źródeł

Do pełnego działania Kinecta na Linuxie potrzebne są: OpenNI2, NiTE2, libfreenect z driverem do OpenNI2 oraz wrapper do Pythona - nite2.

Firma PrimeSense, autor OpenNI, została wykupiona przez Apple'a. Następnie Apple wstrzymało publiczny rozwój projektu OpenNI - został on utajniony. Ponieważ jest to oprogramowanie opensource, kody źródłowe są nadal dostępne i mogą być używane przez każdego. Najbardziej aktywnym forkiem jest repozytorium prowadzone przez http://occipital.com, dostępne pod adresem https://github.com/occipital/OpenNI2.

OpenNI2

OpenNI2 można zdobyć na dwa sposoby - zbudować ze źródeł lub pobrać binarki.

Kompilacja OpenNI2

Instalacja wymagań

sudo apt-get install git g++ cmake python libudev-dev libxi-dev libxmu-dev libusb-1.0-0-dev libudev-dev freeglut3-dev doxygen graphviz

Do kompilacji niezbędna jest Java (dokładniej javac). Należy zainstalować jakiekolwiek JDK, np.:

sudo apt-get install openjdk-7-jdk

Pobranie repozytorum i kompilacja

git clone https://github.com/occipital/OpenNI2.git
cd OpenNI2
make

Warto zapisać ścieżkę do OpenNI w zmiennej (i następnie dodać do .profile lub .bashrc):

export OPENNI_DIR=/home/{USER_NAME}/OpenNI2

Instalacja OpenNI:

sudo ${OPENNI_DIR}/Packaging/Linux/install.sh
sudo gpasswd -a ${USER} video

Instalacja z binarek

Należy pobrać binarny pakiet ze strony http://structure.io/openni i wypakować do katalogu np. OpenNI-Linux-x64-2.2

$ cd OpenNI-Linux-x64-2.2
$ sudo ./install.sh

w aktualnym katalogu utworzy się skrypt OpenNIDevEnvironment, który ustawia środowisko dev

Kompilacja libfreenect

git clone https://github.com/OpenKinect/libfreenect.git
cd libfreenect
mkdir build
cd build
cmake .. -DBUILD_OPENNI2_DRIVER=ON
make -j4
cp -L lib/OpenNI2-FreenectDriver/libFreenectDriver.so ${OPENNI_DIR}/Bin/x64-Release/OpenNI2/Drivers/

Testowanie

cd ${OPENNI_DIR}/Bin/x64-Release/
./NiViewer

Instalacja biblioteki NiTE2

NiTE od zawsze było oprogramowaniem bez dostępnych kodów źródłowych. Binarki można znaleźć tutaj: http://ilab.usc.edu/packages/forall/ubuntu-13.10/NiTE-Linux-x64-2.2.tar.bz2

cd NiTE-Linux-x64-2.2
sudo ./install.sh
cp -L /usr/local/lib/OpenNI2-FreenectDriver/libFreenectDriver.so NiTE-Linux-x64-2.2/Samples/Bin/OpenNI2/Drivers/

Kompilacja Pythonowego modułu 'nite2' (wrappera do OpenNI2 + NiTE2)

$ sudo apt-get install python-dev libboost-all-dev
$ git clone https://github.com/BrainTech/nite2-bindings
$ cd nite2-bindings
$ make