/BLEPeripheralObserver

An Arduino library for creating custom BLE peripherals and observers with Nordic Semiconductor's nR51822.

Primary LanguageCMIT LicenseMIT

Arduino BLEPeripheralObserver

Build Status Gitter

An Arduino library for creating custom BLE peripherals and observers with Nordic Semiconductor's nR51822.

This is heavily based on @sandeepmistry's arduino-BLEPeripheral library. This fork adds support for the observer role (i.e. receiving Bluetooth advertisements), but consequently can't support the nRF8001 anymore.

Compatible Hardware

WARNING: Adafruit nRF51 boards are NOT compatible with this library, this includes the Bluefruit LE UART Friend, Bluefruit LE SPI Friend, Bluefruit LE Shield, Flora Wearable Bluefruit LE Module, Feather 32u4 Bluefruit LE, and Feather M0 Bluefruit LE.

Nordic Semiconductor nRF51 or nRF52 based boards

Usage

Download Library

Arduino

Using the Arduino IDE Library Manager

  1. Choose Sketch -> Include Library -> Manage Libraries...
  2. Type BLEPeripheralObserver into the search box.
  3. Click the row to select the library.
  4. Click the Install button to install the library.

Using Git

cd ~/Documents/Arduino/libraries/
git clone https://github.com/floe/BLEPeripheralObserver BLEPeripheralObserver

MPIDE

cd ~/Documents/mpide/libraries/
git clone https://github.com/floe/BLEPeripheralObserver BLEPeripheralObserver

The arduino-nRF5x core REQUIRES a SoftDevice in order to successfully use this library. Please see Flashing a SoftDevice.

Further, the error fatal error: ble_gatts.h: No such file or directory in indicitive of no SoftDevice being selected.

Starter sketch

Load starter.ino

API

See API.md.

Examples

See examples folder.

License

This libary is licensed under the MIT Licence.