forked from 0-1-0/lightblue-0.4
-
Notifications
You must be signed in to change notification settings - Fork 2
/
README.txt
70 lines (44 loc) · 3.5 KB
/
README.txt
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
LightBlue
LightBlue is a cross-platform Bluetooth API for Python which provides simple access to Bluetooth operations. It is available for Mac OS X, GNU/Linux and Nokia's Python for Series 60 platform for mobile phones.
LightBlue provides simple access to:
* Device and service discovery (with and without end-user GUIs)
* Standard socket interface for RFCOMM and L2CAP sockets (currently L2CAP client sockets only, and not on PyS60)
* Sending and receiving files over OBEX
* Advertising of RFCOMM and OBEX services
* Local device information
LightBlue is released under the GPL License.
See the home page at http://lightblue.sourceforge.net for more information.
Requirements
============
Mac OS X:
Python 2.3 or later
PyObjC (http://pyobjc.sourceforge.net)
Xcode 2.1 or later to build LightAquaBlue framework (but you could build from a separate .xcode project for older versions)
(Mac OS X 10.4 or later is required to do device discovery without a GUI)
GNU/Linux:
Python 2.3 or later (with Tkinter if using selectdevice() or selectservice())
PyBluez 0.9 or later (http://org.csail.mit.edu/pybluez)
OpenOBEX 1.0.1 or later (http://openobex.sourceforge.net)
Python for Series 60:
Python for Series 60 1.3.1 or later (http://sourceforge.net/projects/pys60)
Installation
============
Mac OS X and GNU/Linux:
Just open up a shell/terminal and run the command:
python setup.py install
Or you might need to run with root access, i.e.
sudo python setup.py install
On Mac OS X, the setup.py script also installs the LightAquaBlue framework into /Library/Frameworks.
Python for Series 60:
Download the appropriate SIS file for your phone from the LightBlue home page (http://lightblue.sourceforge.net). Send the file to your phone, and open and install. Or, use the Nokia PC Suite to install the SIS file.
Installation for Xcode 1.5 / Mac OS X 10.3
------------------------------------------
The LightAquaBlue framework for the Mac OS X installation is in a .xcodeproj package which can only be opened by Xcode 2.1 and later, and Xcode 2.1 does not run on Mac OS X 10.3. So to build LightBlue on Mac OS X 10.3, just create a .xcode package yourself:
- Open Xcode and choose File -> New Project. Choose "Cocoa Framework" (under the "Frameworks" drop-down list) and save the project as "LightAquaBlue". Save the project anywhere as long as it's not replacing the existing LightBlue src/mac/LightAquaBlue directory.
- Go to Project -> Add files... and add all the .h and .m files from LightBlue's src/mac/LightAquaBlue folder. Also add the OBEXFileTransferDictionary.plist, OBEXObjectPushDictionary.plist and SerialPortDictionary.plist files.
- Go to Project -> Add framework... and add IOBluetooth.framework (found at /System/Library/Frameworks/IOBluetooth.framework).
- Click on the "Targets" item in the left-hand column of the Xcode window. This should show all the .h and .m files you've added as well as a few other files. In the "Role" column, all the .h files currently have "project" roles. Click on each drop-down menu item to change all of them to "public".
- Now go to the Finder and locate the xcode project you've just created. Copy the LightAquaBlue.xcode file for the project and paste it in LightBlue's src/mac/LightAquaBlue directory.
Now go to LightBlue's root directory and run the command
sudo python setup.py install
You should see the output of the build of the xcode project.