Skip to content

mbientlab/Warble

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

96 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

About

MetaWear Python SDK - Linux / Windows - C wrapper around BluetoothLE

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published