Program your Nordic Semiconductor nRF51 or nRF52 board using the Arduino IDE.

Does not require a custom bootloader on the device.

Support us with a monthly donation and help us continue our activities. [Become a backer]

Become a sponsor and get your logo on our README on Github with a link to your site. [Become a sponsor]

• Plain nRF52 MCU
• Nordic Semiconductor nRF52 DK
  • For boards prior to 2016.9 (see sticker), the lastest JLink bootloader is required to upload sketches. To upgrade, press the boot/reset button while powering on the board and copy over the latest bootloader.
  • To see how the silkscreened MCU pin names map to Arduino-compatible pin names, see PCA10040_Schematic_And_PCB.pdf -> GPIO pin mapping from the PCA10040_Schematic.
• Shenzhen Taida Century Technology nRF52 low cost development board
• RedBear Blend 2
• RedBear Nano 2
• Bluey
• hackaBLE
• hackaBLE_v2
• DWM1001-DEV

• Plain nRF51 MCU
• BBC micro:bit
• Calliope mini
• Bluz DK
• Nordic Semiconductor nRF51822 Development Kit + nRF51422 Development Kit
• Nordic SemiconductornRF51x22 Development Kits (PCA1000x)
• Nordic Semiconductor NRF51 Smart Beacon Kit
• Nordic Semiconductor NRF51 Dongle
• OSHChip
• RedBearLab BLE Nano
• RedBearLab nRF51822
• Waveshare BLE400
• ng-beacon
• TinyBLE
• Sino:bit
• SeeedArchLink

1. Download and install the Arduino IDE (At least v1.6.12)
2. Start the Arduino IDE
3. Go into Preferences
4. Add https://sandeepmistry.github.io/arduino-nRF5/package_nRF5_boards_index.json as an "Additional Board Manager URL"
5. Open the Boards Manager from the Tools -> Board menu and install "Nordic Semiconductor nRF5 Boards"
6. Select your nRF5 board from the Tools -> Board menu

NOTE: During installation it takes the Arduino IDE a few minutes to extract the tools after they have been downloaded, please be patient.

No additional setup required.

For 64-bit Linux users, libc6:i386, libstdc++6:i386, libncurses5:i386 and libudev1:i386 need to be installed :

• sudo dpkg --add-architecture i386
• sudo apt-get update
• sudo apt-get -y install libc6:i386 libstdc++6:i386 libncurses5:i386 libudev1:i386

Download mbed Windows Serial driver

1. Download Zadig
2. Plugin Segger J-Link or DK board
3. Start Zadig
4. Select Options -> List All Devices
5. Plug and unplug your device to find what changes, and select the Interface 2 from the device dropdown
6. Click Replace Driver

NOTE: To roll back to the original driver go to: Device Manager -> Right click on device -> Check box for "Delete the driver software for this device" and click Uninstall

1. Download .inf file drivers from blacksphere github
2. Plugin Black Magic Probe
3. Point the installer to the folder containing blackmagic.inf

NOTE: If using Windows 10 or Linux then two UART COM ports will be visible without requiring additional drivers

SoftDevices contain the BLE stack and housekeeping, and must be downloaded once before a sketch using BLE can be loaded. The SD consumes ~5k of Ram + some extra based on actual BLE configuration.

• SoftDevice S110 v8.0.0 supports Revision 2 and 3 of nRF51 in peripheral role. It is 96k in size.
• SoftDevice S130 v2.0.1 supports Revision 3 of nRF51 in peripheral and central role. It is 108k in size.
• SoftDevice S132 v2.0.1 supports nRF52 in peripheral and central role. It is 112k in size.

1. cd <SKETCHBOOK>, where <SKETCHBOOK> is your Arduino Sketch folder:

• OS X: ~/Documents/Arduino
• Linux: ~/Arduino
• Windows: ~/Documents/Arduino

2. Create the following directories: tools/nRF5FlashSoftDevice/tool/
3. Download nRF5FlashSoftDevice.jar to <SKETCHBOOK>/tools/nRF5FlashSoftDevice/tool/
4. Restart the Arduino IDE
5. Select your nRF board from the Tools -> Board menu
6. Select a SoftDevice from the Tools -> "SoftDevice: " menu
7. Select a Programmer (J-Link, ST-Link V2, or CMSIS-DAP) from the Tools -> "Programmer: " menu
8. Select Tools -> nRF5 Flash SoftDevice
9. Read license agreement
10. Click "Accept" to accept license and continue, or "Decline" to decline and abort
11. If accepted, SoftDevice binary will be flashed to the board

1. Follow steps from Board Manager section above
2. cd <SKETCHBOOK>, where <SKETCHBOOK> is your Arduino Sketch folder:

• OS X: ~/Documents/Arduino
• Linux: ~/Arduino
• Windows: ~/Documents/Arduino

3. Create a folder named hardware, if it does not exist, and change directories to it
4. Clone this repo: git clone https://github.com/sandeepmistry/arduino-nRF5.git sandeepmistry/nRF5
5. Restart the Arduino IDE

This Arduino Core does not contain any Arduino style API's for BLE functionality. All the relevant Nordic SoftDevice (S110, S130, S132) header files are included build path when a SoftDevice is selected via the Tools menu.

• BLEPeripheral
  • v0.3.0 and greater, available via the Arduino IDE's library manager.
  • Supports peripheral mode only.

If the selected board has an external 32 kHz crystal connected, it will be used as the source for the low frequency clock. Otherwise the internal 32 kHz RC oscillator will be used. The low frequency clock is used by the delay(ms) and millis() Arduino API's.

The Generic nRF51 and nRF52 board options have an additional menu item under Tools -> Low Frequency Clock that allows you to select the low frequency clock source. However, Nordic does not recommend the Synthesized clock, which also has a significant power impact.

This core is based on the Arduino SAMD Core and licensed under the same LGPL License

The following tools are used:

• GCC ARM Embedded as the compiler
• A forked version of OpenOCD to flash sketches

The NFC functionality was ported from arduino-org/arduino-core-nrf52.

The code comes with the Nordic SDK that is licensed differently:

Copyright (c) 2010 - 2017, Nordic Semiconductor ASA All rights reserved.
 
  Redistribution and use in source and binary forms, with or without
  modification, are permitted provided that the following conditions are met:
 
  1. Redistributions of source code must retain the above copyright notice, this
     list of conditions and the following disclaimer.
 
  2. Redistributions in binary form must reproduce the above copyright
     notice, this list of conditions and the following disclaimer in the
     documentation and/or other materials provided with the distribution.
 
  3. Neither the name of Nordic Semiconductor ASA nor the names of its
     contributors may be used to endorse or promote products derived from this
     software without specific prior written permission.
 
  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  IMPLIED WARRANTIES OF MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE
  ARE DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  POSSIBILITY OF SUCH DAMAGE.

For NFC library and softdevice inside Nordic SDK a specific license is used

Copyright (c) 2010 - 2017, Nordic Semiconductor ASA

All rights reserved.

Redistribution and use in source and binary forms, with or without modification, 
are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this
   list of conditions and the following disclaimer.

2. Redistributions in binary form, except as embedded into a Nordic 
   Semiconductor ASA integrated circuit in a product or a software update for 
   such product, must reproduce the above copyright notice, this list of 
   conditions and the following disclaimer in the documentation and/or other 
   materials provided with the distribution.

3. Neither the name of Nordic Semiconductor ASA nor the names of its 
   contributors may be used to endorse or promote products derived from this 
   software without specific prior written permission.

4. This software, with or without modification, must only be used with a 
   Nordic Semiconductor ASA integrated circuit.

5. Any software provided in binary form under this license must not be reverse
   engineered, decompiled, modified and/or disassembled.

THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS 
OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 
OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE 
DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE 
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR  
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE 
GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT 
OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.