iot-alex / arduino-bleperipheral

An Arduino library for creating custom BLE peripherals with Nordic Semiconductor's nRF8001 or nR51822.

Arduino BLEPeripheral

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.

Compatible Hardware

Nordic Semiconductor nRF8001

• Adafruit
  • Bluefruit LE - nRF8001 Breakout
• RedBearLab
  • BLE Shield
  • Blend Micro
  • Blend
• Femtoduino
  • IMUduino BTLE
• Olimex
  • MOD-nRF8001
  • OLIMEXINO-NANO-BLE
• Jaycon Systems
  • nRF8001 Bluetooth Breakout Board
• TinyCircuits
• TinyShield Bluetooth Low Energy - Nordic

Note: Does not require use of nRFgo Studio! However, uses more code space.

Nordic Semiconductor nRF51822

• RedBearLab with Arduino Add-on
  • nRF51822
  • BLE Nano
• RFduino with Arduino Add-on

Pinouts

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	UNUSED	UNUSED	UNUSED
	BLE Nano	UNUSED	UNUSED	UNUSED
	RFduino	UNUSED	UNUSED	UNUSED

Compatible IDE's and MCU's

• Arduino IDE
  • AVR (Uno, Lenoardo, Mega, etc.)
  • SAM3X8E (Due)
  • SAMD21G18A (Zero)
• Teensy (via Teensyduino)
  • 2.0
  • 3.0
  • 3.1
  • LC
• MPIDE (ChipKit)
  • PIC32MX

Warning: For more advanced sketches an MCU with more than 2kB of RAM and 32kB of flash space is recommended. Advance sketches include:

• Multiple services and characteristics
• HID API usage

Usage

Download Library

Arduino

Using the Arduino IDE Library Manager

1. Choose Sketch -> Include Library -> Manage Libraries...
2. Type BLEPeripheral 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/sandeepmistry/arduino-BLEPeripheral BLEPeripheral

MPIDE

cd ~/Documents/mpide/libraries/
git clone https://github.com/sandeepmistry/arduino-BLEPeripheral BLEPeripheral

Starter sketch

Load starter.ino

API

See API.md.

Examples

See examples folder.

License

This libary is licensed under the MIT Licence.

Useful Links

• @lizardo's nRF8001 Experiments
  • used as a starting point to reverse engineer the proprietary setup message format for the chips
• @NordicSemiconductor's ble-sdk-arduino
  • Original Arduino SDK for nRF8001
• @guanix's arduino-nrf8001
  • nRF8001 support for Arduino