Merge branch 'master' into master

Author: hathach

.github/issue_template.md

@@ -0,0 +1,17 @@
+Thank you for using Adafruit project and libraries, 
+please review the following guidelines before creating an issue :
+
+- **Do not use GitHub issues for question or troubleshooting projects.**  Instead use
+  the forums at http://forums.adafruit.com. Only create issue if it is a bug, feature 
+  or discussion that requires **code changes to resolve**.
+
+- **Check our tutorial and examples** There is chance that our 
+[learn tutorial](https://learn.adafruit.com/bluefruit-nrf52-feather-learning-guide/introduction) 
+and examples has useful information for you.
+
+- Please provide details that help us to reproduce your issue
+
+  - Your Board and BSP version
+  - Your OS (mac/windows/linux) and its version
+  - Steps to reproduce, or better your (simplified) sketch if possible
+  - Serial debug log (enable IDE's Debug Mode Level to 1 or 2)  

.gitmodules

@@ -0,0 +1,72 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>Adafruit_nRF52_Arduino</name>
+	<comment></comment>
+	<projects>
+	</projects>
+	<buildSpec>
+		<buildCommand>
+			<name>org.eclipse.cdt.managedbuilder.core.genmakebuilder</name>
+			<triggers>clean,full,incremental,</triggers>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>org.eclipse.cdt.managedbuilder.core.ScannerConfigBuilder</name>
+			<triggers>full,incremental,</triggers>
+			<arguments>
+			</arguments>
+		</buildCommand>
+	</buildSpec>
+	<natures>
+		<nature>org.eclipse.cdt.core.cnature</nature>
+		<nature>org.eclipse.cdt.core.ccnature</nature>
+		<nature>org.eclipse.cdt.managedbuilder.core.managedBuildNature</nature>
+		<nature>org.eclipse.cdt.managedbuilder.core.ScannerConfigNature</nature>
+	</natures>
+	<linkedResources>
+		<link>
+			<name>arduino-libraries</name>
+			<type>2</type>
+			<location>/home/hathach/Arduino/libraries</location>
+		</link>
+	</linkedResources>
+	<filteredResources>
+		<filter>
+			<id>1498710934502</id>
+			<name></name>
+			<type>22</type>
+			<matcher>
+				<id>org.eclipse.ui.ide.multiFilter</id>
+				<arguments>1.0-name-matches-false-false-*.o</arguments>
+			</matcher>
+		</filter>
+		<filter>
+			<id>1498710934507</id>
+			<name></name>
+			<type>22</type>
+			<matcher>
+				<id>org.eclipse.ui.ide.multiFilter</id>
+				<arguments>1.0-name-matches-false-false-*.d</arguments>
+			</matcher>
+		</filter>
+		<filter>
+			<id>1498710934515</id>
+			<name></name>
+			<type>6</type>
+			<matcher>
+				<id>org.eclipse.ui.ide.multiFilter</id>
+				<arguments>1.0-name-matches-false-false-*.pyc</arguments>
+			</matcher>
+		</filter>
+		<filter>
+			<id>1498710934520</id>
+			<name></name>
+			<type>22</type>
+			<matcher>
+				<id>org.eclipse.ui.ide.multiFilter</id>
+				<arguments>1.0-name-matches-false-false-*.so</arguments>
+			</matcher>
+		</filter>
+	</filteredResources>
+</projectDescription>

.project

@@ -3,6 +3,8 @@
 This repository contains the Arduino BSP for Adafruit nRF52 series:
 
 - [Bluefruit Feather nRF52832](https://www.adafruit.com/product/3406)
+- [Bluefruit Feather nRF52840](https://www.adafruit.com/product/4062)
+- [Noric nRF52840DK PCA10056](https://www.nordicsemi.com/eng/Products/nRF52840-DK)
 
 ## BSP Installation
 
@@ -22,11 +24,11 @@ There are two methods that you can use to install this BSP. We highly recommend
 
  1. Install BSP via Board Manager as above to install compiler & tools.
  2. Delete the core folder `nrf52` installed by Board Manager in Adruino15, depending on your OS. It could be
-  * OS X   : `~/Library/Arduino15/packages/adafruit/hardware/nrf52`
+  * macOS  : `~/Library/Arduino15/packages/adafruit/hardware/nrf52`
   * Linux  : `~/.arduino15/packages/adafruit/hardware/nrf52`
   * Windows: `%APPDATA%\Local\Arduino15\packages\adafruit\hardware\nrf52`
  3. `cd <SKETCHBOOK>`, where `<SKETCHBOOK>` is your Arduino Sketch folder:
-  * OS X   : `~/Documents/Arduino`
+  * macOS  : `~/Documents/Arduino`
   * Linux  : `~/Arduino`
   * Windows: `~/Documents/Arduino`
  4. Create a folder named `hardware/Adafruit`, if it does not exist, and change directories to it
@@ -63,7 +65,7 @@ examples sketched for the selected board.
 
 ## Bootloader Support
 
-### Upgrade existiting Bootloader
+### Upgrade existing Bootloader
 
 Bluefruit's Bootloader is self-upgradable, you could upgrade to the latest Bootloader + Softdevice using the serial port within Arduino IDE.
 
@@ -74,7 +76,7 @@ Bluefruit's Bootloader is self-upgradable, you could upgrade to the latest Bootl
 
 Note: close the Serial Monitor before you click "Burn Bootloader". Afterwards, you shouldn't close the Arduino IDE, unplug the Feather, launch Serial Monitor etc ... to abort the process. There is a high chance it will brick your device! Do this with care and caution.
 
-### Burnning new Bootloader
+### Burning new Bootloader
 
 To burn the bootloader from within the Arduino IDE, you will need the following tools installed
 on your system and available in the system path:
@@ -84,7 +86,7 @@ on your system and available in the system path:
 
 Check to make sure you can run `nrfjprog` from your terminal/command prompt
 
-**OS X Note** At present, you will need to create a symlink in `/usr/local/bin` to the
+**macOS Note** At present, you will need to create a symlink in `/usr/local/bin` to the
 `nrfjprog` tool wherever you have added it. You can run the following command, for example:
 
 ```
@@ -97,6 +99,8 @@ Once the tools above have been installed and added to your system path, from the
 - Select `Tools > Programmer > J-Link for Feather52`
 - Select `Tools > Burn Bootloader` with the board and J-Link connected
 
+If you wish to modify bootloader to your own need, check out its repo here [Adafruit_nRF52_Bootloader](https://github.com/adafruit/Adafruit_nRF52_Bootloader)
+
 #### Manually Burning the Bootloader via nrfjprog
 
 The bootloader hex file can be found at `bin/bootloader` run the command as follows:
@@ -109,9 +113,9 @@ $ nrfjprog --reset -f nrf52
 
 ## Misc Notes
 
-#### nRF52DK Jlink Issue on OS X
+#### nRF52DK Jlink Issue on macOS
 
-If developping with the nRF52DK on OS X, there is a bug where only 64 bytes can be sent
+If developing with the nRF52DK on macOS, there is a bug where only 64 bytes can be sent
 over the USB CDC interface, which will prevent you from using the serial bootloader from
 the Arduino IDE with an error like this:
 
@@ -131,7 +135,7 @@ Possible causes:
 
 To resolve this and enable 512 byte packets over USB serial, you must disable the
 Mass Storage Device interface on the JLink-OB, which will free up two of the 512 byte
-USB end points. (For details see [this article](https://wiki.segger.com/index.php?title=J-Link-OB_SAM3U).) 
+USB end points. (For details see [this article](https://wiki.segger.com/index.php?title=J-Link-OB_SAM3U).)
 
 You can do so by running `JLinkExe` from the command line, and then entering the
 `MSDDisable` command, and power cycling your nRF52DK. To re-enable MSD support, do the same
@@ -142,7 +146,12 @@ but enter the `MSDEnable` command.
 This core is based on [Arduino-nRF5](https://github.com/sandeepmistry/arduino-nRF5) by Sandeep Mistry,
 which in turn is based on the [Arduino SAMD Core](https://github.com/arduino/ArduinoCore-samd).
 
-The following tools are used:
+The following libraries are used:
 
- * [GCC ARM Embedded](https://launchpad.net/gcc-arm-embedded) as the compiler
- * adafruit-nrfutil is based on Nordic Semiconductor ASA's [pc-nrfutil](https://github.com/NordicSemiconductor/pc-nrfutil)
+- adafruit-nrfutil is based on Nordic Semiconductor ASA's [pc-nrfutil](https://github.com/NordicSemiconductor/pc-nrfutil)
+- freeRTOS as operating system
+- [tinyusb](https://github.com/hathach/tinyusb) as usb stack
+- [nrfx](https://github.com/NordicSemiconductor/nrfx) for peripherals driver
+- [littlefs](https://github.com/ARMmbed/littlefs) for internal file system
+- [fatfs by elm-chan](http://elm-chan.org/fsw/ff/00index_e.html) for external file system
+- Segger Sysview for debugging.