An Arduino library for creating custom BLE peripherals with Nordic Semiconductor's nRF8001 or nR51822.
Enables you to create more customized BLE Peripheral's compared to the basic UART most other Arduino BLE libraries provide.
nRFgo Studio (and Windows) is not required when using the nRF8001.
Note: Does not require use of nRFgo Studio! However, uses more code space.
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.
Chip | Shield/Board | REQ Pin | RDY Pin | RST Pin |
---|---|---|---|---|
nRF8001 | ||||
Bluefruit LE | 10 | 2 | 9 | |
BLE Shield 1.x | 9 | 8 | UNUSED | |
BLE Shield 2.x | 9 | 8 | UNUSED or 4/7 via jumper | |
Blend | 9 | 8 | UNUSED or 4/5 via jumper | |
Blend Micro | 6 | 7 | UNUSED or 4 | |
IMUduino BTLE | 10 | 7 | 9 | |
TinyShield Bluetooth Low Energy | 10 | 2 | 9 | |
nRF51822 | ||||
RedBearLab nRF51822 | -1 (UNUSED) | -1 (UNUSED) | -1 (UNUSED) | |
BLE Nano | -1 (UNUSED) | -1 (UNUSED) | -1 (UNUSED) | |
RFduino | -1 (UNUSED) | -1 (UNUSED) | -1 (UNUSED) |
Warning: For more advanced sketches an MCU with more than 2kB of RAM and 32kB of flash space is recommended. Advance sketches include:
Sketch
-> Include Library
-> Manage Libraries...
BLEPeripheral
into the search box.Install
button to install the library.cd ~/Documents/Arduino/libraries/
git clone https://github.com/sandeepmistry/arduino-BLEPeripheral BLEPeripheral
cd ~/Documents/mpide/libraries/
git clone https://github.com/sandeepmistry/arduino-BLEPeripheral BLEPeripheral
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.
Load starter.ino
See API.md.
See examples folder.
This libary is licensed under the MIT Licence.