11# Bless
22
3- Bless is an extension of [ Bleak] ( https://github.com/hbldh/bleak ) .
3+ [ ![ Build, Lint, and
4+ Test] ( https://github.com/kevincar/bless/actions/workflows/build-and-test.yml/badge.svg )
5+ ] ( https://github.com/kevincar/bless/actions/workflows/build-and-test.yml )
6+ [ ![ PyPI version] ( https://badge.fury.io/py/bless.svg )] ( https://badge.fury.io/py/bless )
7+ ![ PyPI - Downloads] ( https://img.shields.io/pypi/dm/bless )
8+ [ ![ Black] ( https://img.shields.io/badge/code%20style-black-000000.svg )] ( https://github.com/psf/black )
49
5- Bless is an acronym for Bluetooth Low Energy Server Supplement since this
6- library intends to supplement the [ Bleak] ( https://github.com/hbldh/bleak )
7- client library
10+ Bless is an acronym for Bluetooth Low Energy (BLE) Server Supplement.
11+
12+ Bless provides an OS-independent python package for creating a BLE Generic
13+ Attribute Profile (GATT) server to broadcast user-defined services and
14+ characteristics. This is particularly useful when prototyping and testing
15+ servers on different devices with the goal of ensuring that expected behavior
16+ matches across all systems.
17+
18+ Bless's code roughly follows a similar style to
19+ [ Bleak] ( https://github.com/hbldh/bleak ) in order to ease development of client
20+ and server programs.
821
922# Installation
1023
@@ -14,13 +27,18 @@ pip install bless
1427
1528# Features
1629
17- | OS| Implemented|
18- | --| ---------|
19- | MacOS| :white_check_mark : |
20- | Windows| :white_check_mark : |
21- | Linux| :white_check_mark : |
30+ Bless enables reading, writing, and notifying of BLE characteristic values.
31+ Developers can provide callback functions to manipulate data that is sent out
32+ for reading or delivered for writing prior to processing the underlying
33+ commands.
2234
2335# Examples
2436
25- See our [ Server
37+ See example code for setting up a BLE server where read and write
38+ characteristic can be be probed by BLE clients (central devices)
39+
40+ [ Basic Server
2641Example] ( https://github.com/kevincar/bless/blob/master/examples/server.py )
42+
43+ [ GATT Tree Server
44+ Example] ( https://github.com/kevincar/bless/blob/master/examples/gattserver.py )
0 commit comments