1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 |
Tiny Bluetooth LE Library / Direct-BTGoalsThis project aims to create clean, modern and easy to use Bluetooth LE API. TinyB exposes the BLE GATT API for C++, Java and other languages. TinyB Version 2Starting with version 2.1.0, the specification has slightly changed and hence its implementation. The TinyB project consist out of two implementations TinyBTinyB exposes the BLE GATT API for C++, Java and other languages, using BlueZ over DBus. TinyB is exposed via the following native libraries
Direct-BTDirect-BT provides direct Bluetooth programming without intermediate layers targeting high-performance reliable Bluetooth support. By having least system and userspace dependencies and no communication overhead, Direct-BT shall be suitable for embedded device configurations besides others. Direct-BT is exposed via the following native libraries
You will find a detailed overview of Direct-BT in the doxygen generated C++ API doc of its direct_bt namespace. TinyB and Direct-BTPre version 2.0.0 D-Bus implementation details of the Java[tm] classes of package tinyb has been moved to tinyb.dbus. The tinyb.jar jar file has been renamed to tinyb2.jar, avoiding conflicts. General interfaces matching the original implementation and following BlueZ API were created in package org.tinyb. org.tinyb.BluetoothFactory provides a factory to instantiate the initial root org.tinyb.BluetoothManager, either using Tiny-B, the original D-Bus implementation, or Direct-BT, the direct implementation. C++ namespace and implementation kept unchanged. Build StatusOutdated information API DocumentationOutdated information Up to date API documentation can be found:
A guide for getting started with TinyB on Java is available here: https://software.intel.com/en-us/java-for-bluetooth-le-apps. Using TinyBTinyB requires CMake 3.1+ for building and requires GLib/GIO 2.40+. It also requires BlueZ with GATT profile activated, which is currently experimental (as of BlueZ 5.37), so you might have to run bluetoothd with the -E flag. For example, on a system with systemd (Fedora, poky, etc.) edit the bluetooth.service file (usually found in /usr/lib/systemd/system/ or /lib/systemd/system) and append -E to ExecStart line, restart the daemon with systemctl restart bluetooth.
The last command will create the include/ and lib/ directories with a copy of the headers and library objects respectively in your build location. Note that doing an out-of-source build may cause issues when rebuilding later on. Our cmake configure has a number of options, cmake-gui or ccmake can show you all the options. The interesting ones are detailed below: Changing install path from /usr/local to /usr
Building debug build:
Using clang instead of gcc:
Cross-compiling on a different system:
To build Java bindings:
To build examples:
To build documentation run:
The hellotinyb example uses a TI Sensor Tag from which it reads the ambient temperature. You have to pass the MAC address of the Sensor Tag as a first parameter to the program. Changes
Common issuesIf you have any issues, please go through the Troubleshooting Guide. If the solution is not there, please create a new issue on Github. Contributing to TinyBYou shall agree to Developer Certificate of Origin and Sign-off your code, using a real name and e-mail address. Please check the Contribution document for more details. |