Warble

Warble, besides being the chirping/singing of birds, is a wrapper around various Bluetooth LE libraries, providing a common C API for Linux and Windows 10.

Developers can use this library to connect to Bluetooth LE devices, read and write GATT characteristic values, and enable chatacteristic notifications.

Build

Because this library is designed to work across two OSes, there will be different dependencies and build steps depending on the target OS.

Regardless of the platform, the build relies on Git tag information, so you must clone the code instead of doing a source download.

Linux

On Linux, Warble wraps around the libblepp library, which is included as a submodule. You will need to have BlueZ, Boost headers, and GNU Make installed along with a C++ compiler that support C++14.

• Kernel version 3.6 or above
• libbluetooth-dev
• Run the following command to grant node the necessary privileges to read BLE data: sudo setcap cap_net_raw+eip $(eval readlink -f $(which node)) (Explanation)

Ubuntu, Debian, Raspbian

sudo apt-get install bluetooth bluez libbluetooth-dev libudev-dev libboost-all-dev build-essential

Fedora and other RPM-based distributions

sudo yum install bluez bluez-libs bluez-libs-devel boost-devel

Build

git submodule update --init
make

Windows 10

Install Visual Studio 2017 along with the FCU Windows 10 SDK (10.0.17134.0). You can build the solution in VS2017 or with MSBuild.

cd vs2017
MSBuild.exe warble.sln

Examples

Example scripts showcasing how to use the library are in the example folder.