HowTo: wiipy - Andreas Böhler

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 simpleosc . . . . . . . . . . .
1.4 Starten des Frontend . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
3
3
3
3
3
3
3
3
4
OS X Leopard
Vorbereitungen . . . . . . . . . . . .
Benötigte Programme und Libraries
Step-by-Step Anleitung . . . . . . . .
2.3.1 Installation von simpleosc . .
2.3.2 Installation von lightblue . .
Starten des Frontend . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
5
5
5
5
5
5
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 Mac
2.1
2.2
2.3
2.4
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
• simpleosc >= 0.2.5.1: OSC-Library für Python; Download: http://www.ixi-software.net/content/
download/simpleosc0.2.5.1.zip
1.3 Step-by-Step Anleitung
1.3.1 Widcomm installieren
Widcomm mittels des Setup-Programms installieren und den Computer neu starten. Eine weitere Konfiguration 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 simpleosc
Die .zip entpacken (z.B. mit WinRAR) und den Ordner ’osc’ nach ’C:\python25\Lib\site-packages’ kopieren.
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
• simpleosc >= 0.2.5.1: OSC-Library für Python; Download: http://www.ixi-software.net/content/
download/simpleosc0.2.5.1.zip
• 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
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 simpleosc
Das zip-Archiv kann graphisch extrahiert werden, dann wird auf ein Terminal in das simpleosc-Verzeichnis
gewechselt:
• cd simpleosc-0.2.5.1
• sudo python setup.py install
2.3.2 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.
5
2.4. Starten des Frontend
Kapitel 2. Mac OS X Leopard
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
• simpleosc >= 0.2.5.1: OSC-Library für Python; Download: http://www.ixi-software.net/content/
download/simpleosc0.2.5.1.zip
3.3 Step-by-Step Anleitung
Zuerst wird über den Paketmanager ein Utility nachinstalliert:
• sudo apt-get install python-bluez
Anschließend wird simpleosc per Hand installiert:
• unzip simpleosc-0.2.5.1
• cd simpleosc-0.2.5.1
• sudo python setup.py install
3.4 Starten des Frontend
• ./wiipy_frontend.py
7