Merge branch 'release/v9.1.0'

Author: valeros

builder/frameworks/arduino

@@ -53,9 +53,6 @@ def BeforeUpload(target, source, env):  # pylint: disable=W0613,W0621
 board = env.BoardConfig()
 variant = board.get("build.variant", "")
 
-use_adafruit = board.get(
-    "build.bsp.name", "nrf5") == "adafruit" and "arduino" in env.get("PIOFRAMEWORK", [])
-
 env.Replace(
     AR="arm-none-eabi-ar",
     AS="arm-none-eabi-as",
@@ -125,7 +122,12 @@ def BeforeUpload(target, source, env):  # pylint: disable=W0613,W0621
     )
 )
 
-if use_adafruit:
+upload_protocol = env.subst("$UPLOAD_PROTOCOL")
+
+if "nrfutil" == upload_protocol or (
+    board.get("build.bsp.name", "nrf5") == "adafruit"
+    and "arduino" in env.get("PIOFRAMEWORK", [])
+):
     env.Append(
         BUILDERS=dict(
             PackageDfu=Builder(
@@ -186,7 +188,6 @@ def BeforeUpload(target, source, env):  # pylint: disable=W0613,W0621
         exports={"env": env}
     )
 
-upload_protocol = env.subst("$UPLOAD_PROTOCOL")
 target_elf = None
 if "nobuild" in COMMAND_LINE_TARGETS:
     target_elf = join("$BUILD_DIR", "${PROGNAME}.elf")
@@ -198,7 +199,7 @@ def BeforeUpload(target, source, env):  # pylint: disable=W0613,W0621
         target_firm = env.MergeHex(
             join("$BUILD_DIR", "${PROGNAME}"),
             env.ElfToHex(join("$BUILD_DIR", "userfirmware"), target_elf))
-    elif "nrfutil" == upload_protocol and use_adafruit:
+    elif "nrfutil" == upload_protocol:
         target_firm = env.PackageDfu(
             join("$BUILD_DIR", "${PROGNAME}"),
             env.ElfToHex(join("$BUILD_DIR", "${PROGNAME}"), target_elf))

builder/main.py

@@ -0,0 +1,21 @@
+How to build PlatformIO based project
+=====================================
+
+1. [Install PlatformIO Core](http://docs.platformio.org/page/core.html)
+2. Download [development platform with examples](https://github.com/platformio/platform-nordicnrf52/archive/develop.zip)
+3. Extract ZIP archive
+4. Run these commands:
+
+```shell
+# Change directory to example
+$ cd platform-nordicnrf52/examples/arduino-ble-led
+
+# Build project
+$ pio run
+
+# Upload firmware
+$ pio run --target upload
+
+# Clean build files
+$ pio run --target clean
+```

examples/arduino-ble-led/README.md

@@ -0,0 +1,21 @@
+How to build PlatformIO based project
+=====================================
+
+1. [Install PlatformIO Core](http://docs.platformio.org/page/core.html)
+2. Download [development platform with examples](https://github.com/platformio/platform-nordicnrf52/archive/develop.zip)
+3. Extract ZIP archive
+4. Run these commands:
+
+```shell
+# Change directory to example
+$ cd platform-nordicnrf52/examples/arduino-blink
+
+# Build project
+$ pio run
+
+# Upload firmware
+$ pio run --target upload
+
+# Clean build files
+$ pio run --target clean
+```

examples/arduino-ble-led/README.rst

@@ -0,0 +1,21 @@
+How to build PlatformIO based project
+=====================================
+
+1. [Install PlatformIO Core](http://docs.platformio.org/page/core.html)
+2. Download [development platform with examples](https://github.com/platformio/platform-nordicnrf52/archive/develop.zip)
+3. Extract ZIP archive
+4. Run these commands:
+
+```shell
+# Change directory to example
+$ cd platform-nordicnrf52/examples/arduino-serial-plotter
+
+# Build project
+$ pio run
+
+# Upload firmware
+$ pio run --target upload
+
+# Clean build files
+$ pio run --target clean
+```

examples/arduino-blink/README.md

@@ -0,0 +1,27 @@
+How to build PlatformIO based project
+=====================================
+
+1. [Install PlatformIO Core](http://docs.platformio.org/page/core.html)
+2. Download [development platform with examples](https://github.com/platformio/platform-nordicnrf52/archive/develop.zip)
+3. Extract ZIP archive
+4. Run these commands:
+
+```shell
+# Change directory to example
+$ cd platform-nordicnrf52/examples/mbed-legacy-examples/mbed-ble-thermometer
+
+# Build project
+$ pio run
+
+# Upload firmware
+$ pio run --target upload
+
+# Build specific environment
+$ pio run -e nrf52_dk
+
+# Upload firmware for the specific environment
+$ pio run -e nrf52_dk --target upload
+
+# Clean build files
+$ pio run --target clean
+```