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

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

Choose Sketch -> Include Library -> Manage Libraries...
Type BLEPeripheral into the search box.
Click the row to select the library.
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

Name		Name	Last commit message	Last commit date
Latest commit History 306 Commits
examples		examples
utility		utility
API.md		API.md
BLEAttribute.cpp		BLEAttribute.cpp
BLEAttribute.h		BLEAttribute.h
BLEBondStore.cpp		BLEBondStore.cpp
BLEBondStore.h		BLEBondStore.h
BLECentral.cpp		BLECentral.cpp
BLECentral.h		BLECentral.h
BLECharacteristic.cpp		BLECharacteristic.cpp
BLECharacteristic.h		BLECharacteristic.h
BLEConstantCharacteristic.cpp		BLEConstantCharacteristic.cpp
BLEConstantCharacteristic.h		BLEConstantCharacteristic.h
BLEDescriptor.cpp		BLEDescriptor.cpp
BLEDescriptor.h		BLEDescriptor.h
BLEDevice.cpp		BLEDevice.cpp
BLEDevice.h		BLEDevice.h
BLEDeviceLimits.h		BLEDeviceLimits.h
BLEFixedLengthCharacteristic.cpp		BLEFixedLengthCharacteristic.cpp
BLEFixedLengthCharacteristic.h		BLEFixedLengthCharacteristic.h
BLEHID.cpp		BLEHID.cpp
BLEHID.h		BLEHID.h
BLEHIDPeripheral.cpp		BLEHIDPeripheral.cpp
BLEHIDPeripheral.h		BLEHIDPeripheral.h
BLEHIDReportMapCharacteristic.cpp		BLEHIDReportMapCharacteristic.cpp
BLEHIDReportMapCharacteristic.h		BLEHIDReportMapCharacteristic.h
BLEHIDReportReferenceDescriptor.cpp		BLEHIDReportReferenceDescriptor.cpp
BLEHIDReportReferenceDescriptor.h		BLEHIDReportReferenceDescriptor.h
BLEKeyboard.cpp		BLEKeyboard.cpp
BLEKeyboard.h		BLEKeyboard.h
BLELocalAttribute.cpp		BLELocalAttribute.cpp
BLELocalAttribute.h		BLELocalAttribute.h
BLEMouse.cpp		BLEMouse.cpp
BLEMouse.h		BLEMouse.h
BLEMultimedia.cpp		BLEMultimedia.cpp
BLEMultimedia.h		BLEMultimedia.h
BLEPeripheral.cpp		BLEPeripheral.cpp
BLEPeripheral.h		BLEPeripheral.h
BLEProgmemConstantCharacteristic.cpp		BLEProgmemConstantCharacteristic.cpp
BLEProgmemConstantCharacteristic.h		BLEProgmemConstantCharacteristic.h
BLERemoteAttribute.cpp		BLERemoteAttribute.cpp
BLERemoteAttribute.h		BLERemoteAttribute.h
BLERemoteCharacteristic.cpp		BLERemoteCharacteristic.cpp
BLERemoteCharacteristic.h		BLERemoteCharacteristic.h
BLERemoteService.cpp		BLERemoteService.cpp
BLERemoteService.h		BLERemoteService.h
BLEService.cpp		BLEService.cpp
BLEService.h		BLEService.h
BLESystemControl.cpp		BLESystemControl.cpp
BLESystemControl.h		BLESystemControl.h
BLETypedCharacteristic.h		BLETypedCharacteristic.h
BLETypedCharacteristics.cpp		BLETypedCharacteristics.cpp
BLETypedCharacteristics.h		BLETypedCharacteristics.h
BLEUtil.cpp		BLEUtil.cpp
BLEUtil.h		BLEUtil.h
BLEUuid.cpp		BLEUuid.cpp
BLEUuid.h		BLEUuid.h
EddystoneBeacon.cpp		EddystoneBeacon.cpp
EddystoneBeacon.h		EddystoneBeacon.h
LICENSE		LICENSE
README.md		README.md
iBeacon.cpp		iBeacon.cpp
iBeacon.h		iBeacon.h
keywords.txt		keywords.txt
library.properties		library.properties
nRF51822.cpp		nRF51822.cpp
nRF51822.h		nRF51822.h
nRF8001.cpp		nRF8001.cpp
nRF8001.h		nRF8001.h

License

iot-alex/arduino-BLEPeripheral

Folders and files

Latest commit

History

Repository files navigation

Arduino BLEPeripheral