A python package to connect to the Bluetooth LE GATT services of paired bbc micro:bit devices
Project description
Kasper's microbit
So you finished Python for kids? Wouldn't it be awesome to use your bbc micro:bit as a wireless game controller for your own DIY games? You can do this with this python package! Pair your micro:bit to your computer with bluetooth and use buttons A and B or the accelerometer to control your game. Like it? Give us a :star: on github!
Kasper's microbit is a python package to make a connection to a bbc microbit by means of the Bluetooth LE GATT services exposed by the microbit.
Installation
$ pip install kaspersmicrobit
Example
import time
from kaspersmicrobit import KaspersMicrobit
CHANGE_THIS_TO_YOUR_MICROBIT_BLUETOOTH_ADDRESS = 'E3:7E:99:0D:C1:BA'
def pressed(button):
print(f"button {button} pressed")
with KaspersMicrobit(CHANGE_THIS_TO_YOUR_MICROBIT_BLUETOOTH_ADDRESS) as microbit:
microbit.buttons.on_button_a(press=pressed)
time.sleep(10)
Connecting
To connect to your microbit you'll have to enable the bluetooth services you want to use, and pair your microbit to your computer.
To enable the services you can use MakeCode or copy this hex file to your microbit.
For detailed instructions take a look in Getting started - Enable Bluetooth
Documentation
On https://kaspersmicrobit.readthedocs.io you can find:
- Simple examples, showing how to use the functions of each service offered by the microbit
- Full Api documentation
- Examples that show kaspersmicrobit in combination with tkinter
The same examples can also be found in the examples directory.
Troubleshooting
Bluetooth connection
Problems related to connecting to the microbit over bluetooth are often solved by pairing your computer again to your microbit
See also: https://support.microbit.org/helpdesk/attachments/19075694226
Also, if you are not using the "with"-block, but calling .connect() yourself, always make sure that in any case you call .disconnect() when you don't need the connection anymore (for instance when you exit your application)
Microbit V1 and Microsoft Windows
To use kaspersmicrobit, your microbit should be paired with your computer, but not "connected". We noticed that our microbit V1 always connects to Windows when it is paired. This prevents kaspersmicrobit to connect to it. On linux it behaves correctly. The microbit V2 worked on both Windows and linux.
tkinter "main thread is not in main loop"
When combining kaspersmicrobit with tkinter (the window library used in Python for kids) you could bump into the TK error "main thread is not in main loop". This is probably because you call TK code from within a callback function that you registered to be called when a button press occurs or new accelerometer data is present (or some other notification). The callback is executed on a different thread and tkinter does not like this. There are at least 2 solutions for this:
- don't call tkinter code in a callback
- wrap the callback with
kaspersmicrobit.tkinter.do_in_tkinter(tk, your_callback)
this makes sure that your callback will be executed on the tk thread, avoiding the error
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for kaspersmicrobit-0.2.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 536150711a079d0a5e50bd571593270a7a5d4ecfb844ed0dab0b521aa037df80 |
|
MD5 | b385bac85d5402177187f4126556ec75 |
|
BLAKE2b-256 | 046ff2fe68a592b5e5c8d0f37bc78c727dde61303b3185e1e3357cda7b572dc3 |