Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

LightBlue python module that compiles successful on OS X 10.8 (Mountain Lion)

This branch is 0 commits ahead and 0 commits behind master

Fetching latest commit…

Cannot retrieve the latest commit at this time

README.txt
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.

Something went wrong with that request. Please try again.