A simple Python interface to BlueZ stack

The aim of this library is to provide an API to access to Bluez with zero boilerplate code.

To provide a simplified API to people that want to use Bluetooth functionality in their code. The library will use calls to the Bluez D-Bus API and use 'sensible' defaults to help with that simplification. It aims to support the ability to create interesting STEM activities without needing to explain the Bluez API or write an event loop.

In addition to the API it will contain examples of how to connect to common Bluetooth Smart (BLE) objects around them (or at least easily accessible to them). These examples will need to be written without the need to sign (or break) non-disclosure agreements.

This is an early-stage experiment that we are developing in the open. This currently should only be of interest to developers looking to provide feedback and to contribute.

If you are coming here for the first time then looking at the examples is probably the place to start

This will check that it can find the Bluetooth adapter on the computer running the code. It will print to screen various information and check it is powered before scanning for nearby devices

This is a simple example of how to read the Ti Sensortag CC2650

This example simply reads the button values from the micro:bit and displays them on LEDs attached to the hardware

Simple Eddystone URL beacon. Can be read with any Physical Web application

No example currently.

Experiment with Eddystone FatBeacon. Contains service for beacon to connect to that sends html page.

A simple light switch example using an LED and a switch. Write a value to the switch characteristic to change the state of the light

This can be controlled from web page via web bluetooth. This example advertises the URL via Eddystone URL. Once you attached you can change the colours of the LEDs on the Pimoroni Blinkt.

This example transmits the temperature of the CPU over the single characteristic. If your hardware does not support the vcgencmd then change the get_cpu_temperature() function to use the randomly generated temperature. Values are only updated when notification are switched on.