summaryrefslogtreecommitdiffstats
path: root/TROUBLESHOOTING.md
diff options
context:
space:
mode:
authorSven Gothel <[email protected]>2021-08-31 04:41:54 +0200
committerSven Gothel <[email protected]>2021-08-31 04:41:54 +0200
commitaef10f3cdec0fd698cfa7d913725b40d1513ce30 (patch)
treee36d6b2796e40c5d4f40e66d9cbb6b7259bd42f6 /TROUBLESHOOTING.md
parent99ddbcee148144b3593adf4440d3fa3d06f229ab (diff)
Direct-BT: Remove TinyB and Cleanup Java API (1)
Starting with version 2.3, the previously refactored *TinyB* has been removed completely. Motivation was lack of detailed Bluetooth support, inclusive increasing diversion with *Direct-BT*. Furthermore, work is underway for `BLE slave periphal and GATT server` support and its mapping to *BlueZ D-Bus* is questionable and would be resource intensive. Java API changed as follows: - Objects no more Clonable - Removed dead unsupported code - Removed deprecated code - Added 'GattCharPropertySet', representing property bit mask for BTGattChar, replacing the string array.
Diffstat (limited to 'TROUBLESHOOTING.md')
-rw-r--r--TROUBLESHOOTING.md31
1 files changed, 14 insertions, 17 deletions
diff --git a/TROUBLESHOOTING.md b/TROUBLESHOOTING.md
index b5852083..12e1e42e 100644
--- a/TROUBLESHOOTING.md
+++ b/TROUBLESHOOTING.md
@@ -1,27 +1,24 @@
-Solving common issues with Direct-BT and TinyB {#troubleshooting}
+Solving common issues with Direct-BT {#troubleshooting}
==============================================
-TinyB
-=====
+Direct-BT
+=========
-If you are having issues with TinyB, please follow these steps to resolve common issues:
+If you are having issues with *Direct-BT*, please follow these steps to resolve common issues:
1. Make sure bluetooth is not blocked. On most systems you can do this with ``` rfkill unblock bluetooth ```.
-2. Make sure blueoothd daemon is started: ``` ps -eF | grep bluetoothd ``` or ``` ps | grep bluetoothd ``` if your ps command does not support parameters (such as BusyBox based systems). This command should a line containing bluetoothd.
+2. Make sure blueoothd daemon is **not** started:
+```
+systemctl stop bluetooth
+systemctl disable bluetooth
+systemctl mask bluetooth
+```
- If the bluetooth daemon is not started, you should run ```systemctl start bluetooth.service``` on systems using systemd, or the equivalent for your distro.
-
-3. Make sure you are running bluetoothd with the -E flag. It should be visible when running the commands in 1. If it is not present, you need to add it in ``` /lib/systemd/system/bluetooth.service ``` or the equivalent on your system.
-
-3. Make sure that your DBus policy permits users to access BlueZ GATT interfaces. The following lines should be present in ``` /etc/dbus-1/system.d/bluetooth.conf ``` under ``` <policy context="default"> ```:
- ```
- <allow send_interface="org.bluez.GattService1"/>
- <allow send_interface="org.bluez.GattCharacteristic1"/>
- <allow send_interface="org.bluez.GattDescriptor1"/>
- ```
-
-4. Make sure your kernel supports Bluetooth. This is sometimes hard to verify, here are some ways on how to do this:
+3. Make sure your kernel supports Bluetooth. This is sometimes hard to verify, here are some ways on how to do this:
* ``` lsmod | grep bluetooth ``` should return a line containing bluetooth, if not, try ``` modprobe bluetooth ``` or ``` insmod bluetooth ```
* ``` /proc/config ``` or ``` /proc/config.gz ``` or ``` /boot/config ``` should contain ``` CONFIG_BT=y ``` or ``` CONFIG_BT=m ``` and ``` CONFIG_BT_LE=y ```. If ``` CONFIG_BT=m ``` is enabled, make sure to load your module using ``` modprobe bluetooth ``` or ``` insmod bluetooth ```
* ``` rfkill list ``` should show at least a line containing bluetooth, and it should not be blocked, if it is, see step 1.
+
+4. If all fails, contact please contact [Gothel Software](https://jausoft.com/) for support.
+ Support contracts for your project may also be available.