bluezero 0.0.5

A simple Python interface to BlueZ stack

Name and aim

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

Goal

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.

Status

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.

Examples

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

Adapter

adapter_example.py

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

GATT Client (Central role)

read_sensortag_CC2650.py

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

microbit_poll.py

This example uses the micro:bit API that has been written in bluezero. You will need a buzzer attached to pin 0 to get play_beep to work.

blinkt_central.py

This example is the other end of the radio link to blinkt_ble.py example.

Beacon

eddystone-url-beacon.py

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

Scanner

No example currently.

GATT Server (Peripheral role)

fatbeacon.py

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

lightswitch.py

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

blinkt_ble.py

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.

cpu_temperature.py

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.