summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorSven Gothel <[email protected]>2020-09-16 06:45:35 +0200
committerSven Gothel <[email protected]>2020-09-16 06:45:35 +0200
commit2c35d265fb03cf7aa3b5d1afd93a06dc4d50a3b0 (patch)
tree794293c526324aac135d1348c1d6227c536ebf20
parent4a3a4f1c1e42331f18f1113552fa4371eb91c2b9 (diff)
README.md Add Bluetooth Spec link and enhance Direct-BT description.
-rw-r--r--README.md24
-rw-r--r--TROUBLESHOOTING.md7
2 files changed, 16 insertions, 15 deletions
diff --git a/README.md b/README.md
index 12305d64..62b1ca08 100644
--- a/README.md
+++ b/README.md
@@ -7,28 +7,25 @@ This project's canonical repository is hosted on [Zafena ICT](https://ict.zafena
Goals
============
-This project aims to create a clean, modern and easy to use Bluetooth LE and BREDR API
+This project aims to create a clean, modern and easy to use API for [Bluetooth LE and BREDR](https://www.bluetooth.com/specifications/bluetooth-core-specification/),
fully accessible through C++, Java and other languages.
Version 2
==========
-Starting with version 2.1.0, the *TinyB* Java API has slightly changed
-to support new features provided by the new *Direct-BT* implementation.
+Starting with version 2.1.0, the *TinyB* Java API has been refactored
+to support all new features of its new *Direct-BT* implementation.
As of today, the *TinyB* Java API comprises two implementations, *Direct-BT* and *TinyB*.
Direct-BT
----------
-*Direct-BT* provides direct Bluetooth LE and BREDR programming without intermediate layers,
-offering robust high-performance Bluetooth support.
+*Direct-BT* provides direct [Bluetooth LE and BREDR](https://www.bluetooth.com/specifications/bluetooth-core-specification/) programming,
+offering robust high-performance support for embedded & desktop with zero overhead via C++ and Java.
-By having least system and userspace dependencies and zero overhead,
-Direct-BT is suitable for embedded device configurations and desktop.
-
-*Direct-BT* supports a fully event driven workflow from discovery to GATT programming,
-implementing & using the platform agnostic HCI and GATT/L2CAP Bluetooth layer.
+*Direct-BT* supports a fully event driven workflow from device discovery to GATT programming,
+using its platform agnostic HCI and GATT/L2CAP implementation.
[AdapterStatusListener](https://ict.zafena.se/direct_bt/build/documentation/cpp/html/classdirect__bt_1_1AdapterStatusListener.html)
allows listening to adapter changes and device discovery and
@@ -47,9 +44,10 @@ or via the refactored TinyB [Java API](https://ict.zafena.se/direct_bt/build/doc
You will find a detailed overview of *Direct-BT* in the doxygen generated
[C++ API doc of its *direct_bt* namespace](https://ict.zafena.se/direct_bt/build/documentation/cpp/html/namespacedirect__bt.html#details).
-To use *Direct-BT* in the most efficient way,
-the BlueZ userspace daemon *bluetoothd* should be disabled.
-Using systemd this should be:
+Since *Direct-BT* is not using a 3rd party Bluetooth library but using its own implementation,
+they should be disabled to allow operation without any interference.
+To disable the BlueZ D-Bus userspace daemon *bluetoothd* via systemd,
+you may use the following commands.
```
systemctl stop bluetooth
diff --git a/TROUBLESHOOTING.md b/TROUBLESHOOTING.md
index fe143c56..b5852083 100644
--- a/TROUBLESHOOTING.md
+++ b/TROUBLESHOOTING.md
@@ -1,5 +1,8 @@
-Solving common issues with TinyB {#troubleshooting}
-======================
+Solving common issues with Direct-BT and TinyB {#troubleshooting}
+==============================================
+
+TinyB
+=====
If you are having issues with TinyB, please follow these steps to resolve common issues: