HowTo: wiipy

Projektstudium, SS09
HowTo: wiipy
Andreas Böhler
23.04.2009
FH-Linz
Studiengang Medizintechnik
Inhaltsverzeichnis
1 Windows XP Professional
1.1 Vorbereitungen . . . . . . . . . . . .
1.2 Benötigte Programme und Libraries
1.3 Step-by-Step Anleitung . . . . . . . .
1.3.1 Widcomm installieren . . . .
1.3.2 Python installieren . . . . . .
1.3.3 pybluez installieren . . . . . .
1.3.4 pyliblo . . . . . . . . . . . . .
1.4 Starten des Frontend . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
3
3
3
3
3
3
3
3
4
2 Mac OS X Leopard
2.1 Vorbereitungen . . . . . . . . . . . . .
2.2 Benötigte Programme und Libraries .
2.3 Step-by-Step Anleitung . . . . . . . . .
2.3.1 Installation von liblo . . . . . .
2.3.2 Installation von pyliblo . . . . .
2.3.3 Installation von lightblue . . .
2.3.4 Installieren des WiiMote Patch
2.4 Starten des Frontend . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
5
5
5
5
5
5
6
6
6
3 Ubuntu GNU/Linux Jaunty Jackalope
3.1 Vorbereitungen . . . . . . . . . . . .
3.2 Benötigte Programme und Libraries
3.3 Step-by-Step Anleitung . . . . . . . .
3.4 Starten des Frontend . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
7
7
7
7
7
.
.
.
.
2
1 Windows XP Professional
Unter Windows Vista funktioniert unser Projekt leider nicht (einige benötigte Libraries unterstützen
Windows Vista nicht!).
1.1 Vorbereitungen
Unter Windows XP muss der Widcomm Bluetooth Stack installiert werden, mit dem Microsoft-Stack
oder einem anderen Drittanbieter-Stack funktioniert die Python-Bluetooth Implementierung leider
nicht. Einen Stick mit Widcomm-Software gibt es z.B. von Digitus.
1.2 Benötigte Programme und Libraries
• Widcomm Bluetooth Stack: Getestet 4.1 und 5.1.1100
• Python >= 2.5 < 2.6: Laufzeitumgebung für das Interface; Download: http://www.python.org/
ftp/python/2.5.4/python-2.5.4.msi
• pybluez >= 0.15: Bluetooth-Library für Python; Download: http://pybluez.googlecode.com/
files/PyBluez-0.16.win32-py2.5.exe
• pyliblo >= 0.7.2: OSC-Library für Python; Download: http://code.google.com/p/touchpy/
downloads/detail?name=pyliblo.rar&can=2&q=
1.3 Step-by-Step Anleitung
1.3.1 Widcomm installieren
Widcomm mittels des Setup-Programms installieren und den Computer neu starten. Eine weitere
Konguration ist nicht mehr erforderlich. Eventuell muss nach dem Anstecken des Stick in der Systemsteuerung im Geräte-Manager der Treiber vom Microsoft-Treiber auf den Widcomm-Treiber geändert
werden!
1.3.2 Python installieren
Python nach dem Setup-Programm in C:\Python25 (wichtig!) mit den Standardoptionen installieren.
1.3.3 pybluez installieren
Mit Hilfe des Setup-Programms pybluez in den Standard-Ordner installieren.
1.3.4 pyliblo
Die .rar entpacken (z.B. mit WinRAR) und die Datei 'liblo.pyd' nach 'C:\Python25\Lib\site-packages'
kpieren.
3
1.4. Starten des Frontend
Kapitel 1. Windows XP Professional
1.4 Starten des Frontend
wiipy_frontend.py durch simplen Doppelklick starten, eine kurze Initialisierungsmeldung sollte erscheinen.
(c) 2009 Andreas Böhler
4
v1.0, 2009/04/24
2 Mac OS X Leopard
2.1 Vorbereitungen
Python ist bereits in MacOS X integriert, es müssen also nur noch die benötigten Bibliotheken hinzugefügt werden.
2.2 Benötigte Programme und Libraries
• liblo >= 0.26: OSC Library in C; Download: http://downloads.sourceforge.net/liblo/liblo-0.
26.tar.gz
• pyliblo >= 0.7.2: OSC-Library für Python; Download: http://das.nasophon.de/download/
pyliblo-0.7.2.tar.gz
• lightblue >= 0.4: Python-Bluetooth Library für OS X und S60; Download: http://prdownloads.
sourceforge.net/lightblue/lightblue-0.4.tar.gz?download
• XCode Tools zum Installieren von lightblue. Auf der OS X Install DVD enthalten oder bei Apple
zum Download
• OSCulator; Enthält einen Patch, der die Verbindung mit der Wii ermöglicht; Download: http:
//www.osculator.net
2.3 Step-by-Step Anleitung
Mac untypisch, müssen hier einige Befehle von Hand im Terminal ausgeführt werden. Als erstes kann
XCode mittels des Installers installiert werden. Anschlieÿend werden lightblue und simpleosc per Hand
installiert:
2.3.1 Installation von liblo
Das .tar.gz-Archiv kann graphisch extrahiert werden, anschlieÿend muss auf dem Terminal liblo kompiliert werden:
• cd liblo-0.26
• ./congure
• make
• sudo make install
2.3.2 Installation von pyliblo
Auch pyliblo kann graphisch entpackt werden, aber die Installation muss ebenfalls im Terminal erfolgen:
• cd pyliblo-0.7.2
• C_INCLUDE_PATH=/usr/local/include LIBRARY_PATH=/usr/local/lib sudo python setup.py
install
5
2.4. Starten des Frontend
Kapitel 2. Mac OS X Leopard
2.3.3 Installation von lightblue
Auch dieses Archiv kann graphisch extrahiert werden, weiter geht es wieder im Terminal:
• cd lightblue-0.4
• sudo python setup.py install
Hier kann das Kompilieren einige Zeit in Anspruch nehmen.
2.3.4 Installieren des WiiMote Patch
OSCulator nach Anwendungen installieren und einmal starten. Beim ersten Start wird nach der Installation des Patch gefragt, diesen bestätigen und OSCulator beenden.
2.4 Starten des Frontend
wiipy_frontend.py am Besten im Terminal starten:
• ./wiipy_frontend.py
(c) 2009 Andreas Böhler
6
v1.0, 2009/04/24
3 Ubuntu GNU/Linux Jaunty Jackalope
Getestet und entwickelt wurde der gesamte Python-Code auf Ubuntu Intrepid Ibex bzw. Ubuntu Jaunty
Jackalope.
3.1 Vorbereitungen
Unter Linux müssen nur eine Library per Hand installiert werden, der Rest verläuft über den Paketmanager.
3.2 Benötigte Programme und Libraries
• pyliblo >= 0.7.2: OSC-Library für Python
3.3 Step-by-Step Anleitung
Zuerst wird über den Paketmanager ein Utility nachinstalliert:
• sudo apt-get install python-bluez
• sudo apt-get install python-liblo
3.4 Starten des Frontend
• ./wiipy_frontend.py
7