mirror of
https://github.com/OpenBluetoothToolbox/SimpleBLE
synced 2025-05-08 21:47:10 +08:00
69f1714042
* Rust POC * Finally able to fetch the identifier * Renamed folder again (I liked it better this way) * Basic adapter functions ready, attempting Peripheral now * Basic implementation of the Peripheral * First very basic example * Better Cargo.toml * Updated dependency versions * Another pass to publish * More correct Cargo.toml * Bumped version * Documentation now looks better * Typo * Checkpoint * Feedback loop works * Migrated adapter to Pinned version * Use proper pinning of the Adapter object * Callback model works! * Added scan stop callback * Peripheral objects are now pinned as well * Linux compilation works, added link and unlink methods for Peripheral * Added callbacks providing peripheral objects * Bump version * Add proper examples * Adapter can now query for paired peripherals * Added address type and rssi to peripheral * Improved examples * Added more functions * Added Services, Characteristics and Descriptors. Basic connect example. * Completed the characteristic API * Added manufacturer data to Peripherals * Created stubs of Peripheral functions * Implemented remaining functions * Created notify example
80 lines
2.9 KiB
ReStructuredText
80 lines
2.9 KiB
ReStructuredText
SimpleBLE
|
|
==========
|
|
|
|
The ultimate fully-fledged cross-platform library and bindings for Bluetooth Low Energy (BLE).
|
|
|
|
|Latest Documentation Status|
|
|
|
|
Overview
|
|
--------
|
|
|
|
The SimpleBLE project aims to provide fully cross-platform BLE libraries and bindings
|
|
for Python, Rust and C++, designed for simplicity and ease of use with a licencing scheme
|
|
chosen to be friendly towards commercial use. All specific operating system quirks
|
|
are handled internally to provide a consistent behavior across all platforms. The
|
|
libraries also provide first-class support for vendorization of all third-party
|
|
dependencies, allowing for easy integration into existing projects.
|
|
|
|
This repository offers the source code for the following related libraries:
|
|
|
|
* **SimpleBLE:** C++ cross-platform BLE library.
|
|
* **SimplePyBLE:** Python bindings for SimpleBLE. See the `SimplePyBLE`_ PyPI page for more details.
|
|
* **SimpleRsBLE:** Rust bindings for SimpleBLE. See the `SimpleRsBLE`_ Crates.io page for more details.
|
|
* **SimpleBluez:** C++ abstraction layer for BlueZ over DBus. (Linux only)
|
|
* **SimpleDBus:** C++ wrapper for libdbus-1 with convenience classes to handle DBus object hierarchies effectively. (Linux only)
|
|
|
|
If you want to use SimpleBLE and need help. **Please do not hesitate to reach out!**
|
|
|
|
* Visit our `ReadTheDocs`_ page.
|
|
* Join our `Discord`_ server.
|
|
* Contact me: ``kevin at dewald dot me`` (Dedicated consulting services available)
|
|
|
|
Are you using SimpleBLE on your own project and would like to see it featured here?
|
|
Reach out and I'll add a link to it below!
|
|
|
|
Supported platforms
|
|
-------------------
|
|
=========== ============= =================================== =====
|
|
Windows Linux MacOS iOS
|
|
=========== ============= =================================== =====
|
|
Windows 10+ Ubuntu 20.04+ 10.15+ (except 12.0, 12.1 and 12.2) 15.0+
|
|
=========== ============= =================================== =====
|
|
|
|
Projects using SimpleBLE
|
|
------------------------
|
|
Don't forget to check out the following projects using SimpleBLE:
|
|
|
|
* `GDSimpleBLE`_
|
|
* `BrainFlow`_
|
|
|
|
Contributing
|
|
------------
|
|
Pull requests are welcome. For major changes, please open an issue first to discuss
|
|
what you would like to change.
|
|
|
|
License
|
|
-------
|
|
|
|
All components within this project that have not been bundled from
|
|
external creators, are licensed under the terms of the `MIT Licence`_.
|
|
|
|
.. Links
|
|
|
|
.. _SimplePyBLE: https://pypi.org/project/simplepyble/
|
|
|
|
.. _SimpleRsBLE: https://crates.io/crates/simplersble
|
|
|
|
.. _MIT Licence: https://github.com/OpenBluetoothToolbox/SimpleBLE/blob/main/LICENCE.md
|
|
|
|
.. _Discord: https://discord.gg/N9HqNEcvP3
|
|
|
|
.. _ReadTheDocs: https://simpleble.readthedocs.io/en/latest/
|
|
|
|
.. |Latest Documentation Status| image:: https://readthedocs.org/projects/simpleble/badge?version=latest
|
|
:target: http://simpleble.readthedocs.org/en/latest
|
|
|
|
.. Other projects using SimpleBLE
|
|
|
|
.. _GDSimpleBLE: https://github.com/jferdelyi/GDSimpleBLE
|
|
.. _BrainFlow: https://github.com/brainflow-dev/brainflow
|