release: prepare 1.0.9 upload safeguards

Author: lolren

docs/RELEASE_1.0.9.md

@@ -0,0 +1,51 @@
+# nRF54 Arduino Core 1.0.9
+
+`1.0.9` adds Arduino IDE 1.x upload compatibility and tightens the native
+upload path following [issue #102](https://github.com/lolren/nrf54-arduino-core/issues/102)
+and [discussion #103](https://github.com/lolren/nrf54-arduino-core/discussions/103).
+
+## Arduino IDE 1.x compatibility
+
+- Define the upload and programmer `params.verbose` and `params.quiet`
+  properties required by Arduino IDE 1.8.x.
+- Keep those properties empty, so Arduino IDE 2.x and Arduino CLI expand the
+  same upload commands in quiet and verbose modes.
+- Cover the default uploader and Upload Using Programmer recipes.
+
+## LM20A upload safeguards
+
+- Bundle [nRF OCD 0.3.8](https://github.com/lolren/open-nrf-ocd/releases/tag/v0.3.8).
+- Reject a selected nRF54L15 target when the onboard LM20A CMSIS-DAP probe is
+  connected, and reject the crossed case, before sending any CMSIS-DAP command.
+- Leave external CMSIS-DAP probes available because their USB identity cannot
+  determine which target is attached.
+- On Windows, stop after the successful resetting upload instead of opening a
+  second probe session to write DHCSR. This preserves the command-free
+  post-reset boundary introduced in 1.0.8 on every native upload path.
+
+## SAMD11 BOOTPROT boundary
+
+The onboard SAMD11 exposes CMSIS-DAP access to the downstream nRF54 target, not
+to its own NVM user row. The native uploader therefore cannot set SAMD11
+BOOTPROT or repair a SAMD11 that no longer enumerates. Version 1.0.9 does not
+guess a fuse value: the discussion does not provide Seeed's factory firmware
+layout, a supported protection size, or a redistributable recovery image.
+
+## Validation
+
+- nRF OCD unit tests cover both matching onboard probe/target pairs, both
+  crossed pairs, external probes, and command-free post-reset teardown.
+- Release binaries build for Linux x86-64, ARM64, and ARMHF and Windows x86-64
+  and x86. Their published checksum manifest and corresponding source verify.
+- Arduino CLI expands the default upload recipe in quiet and verbose modes,
+  and the focused upload and release-version suites pass.
+- No new hardware upload was performed for this release.
+
+## Install or upgrade
+
+```bash
+arduino-cli core update-index
+arduino-cli core install "nrf54l15clean:nrf54l15clean@1.0.9"
+```
+
+[Full changes since v1.0.8](https://github.com/lolren/nrf54-arduino-core/compare/v1.0.8...v1.0.9)

hardware/nrf54l15clean/nrf54l15clean/cores/nrf54l15/CoreVersionGenerated.h

@@ -3,7 +3,7 @@
 
 #define ARDUINO_NRF54L15_CLEAN_VERSION_MAJOR 1
 #define ARDUINO_NRF54L15_CLEAN_VERSION_MINOR 0
-#define ARDUINO_NRF54L15_CLEAN_VERSION_PATCH 8
+#define ARDUINO_NRF54L15_CLEAN_VERSION_PATCH 9
 #define ARDUINO_NRF54L15_CLEAN_VERSION_PRERELEASE ""
 #define ARDUINO_NRF54L15_CLEAN_VERSION_IS_PRERELEASE 0
 
@@ -16,6 +16,6 @@
         ARDUINO_NRF54L15_CLEAN_VERSION_MINOR, \
         ARDUINO_NRF54L15_CLEAN_VERSION_PATCH)
 
-#define ARDUINO_NRF54L15_CLEAN_VERSION_STRING "1.0.8"
+#define ARDUINO_NRF54L15_CLEAN_VERSION_STRING "1.0.9"
 
 #endif  // NRF54L15_CLEAN_CORE_VERSION_GENERATED_H

hardware/nrf54l15clean/nrf54l15clean/cores/nrf54lm20b/CoreVersionGenerated.h

@@ -3,7 +3,7 @@
 
 #define ARDUINO_NRF54L15_CLEAN_VERSION_MAJOR 1
 #define ARDUINO_NRF54L15_CLEAN_VERSION_MINOR 0
-#define ARDUINO_NRF54L15_CLEAN_VERSION_PATCH 8
+#define ARDUINO_NRF54L15_CLEAN_VERSION_PATCH 9
 #define ARDUINO_NRF54L15_CLEAN_VERSION_PRERELEASE ""
 #define ARDUINO_NRF54L15_CLEAN_VERSION_IS_PRERELEASE 0
 
@@ -16,6 +16,6 @@
         ARDUINO_NRF54L15_CLEAN_VERSION_MINOR, \
         ARDUINO_NRF54L15_CLEAN_VERSION_PATCH)
 
-#define ARDUINO_NRF54L15_CLEAN_VERSION_STRING "1.0.8"
+#define ARDUINO_NRF54L15_CLEAN_VERSION_STRING "1.0.9"
 
 #endif  // NRF54L15_CLEAN_CORE_VERSION_GENERATED_H

hardware/nrf54l15clean/nrf54l15clean/platform.txt

@@ -1,5 +1,5 @@
 name=nRF54L15 Boards
-version=1.0.8
+version=1.0.9
 category=Arduino
 
 # Python launcher for upload helper.
@@ -88,12 +88,16 @@ tools.nrf54upload.cmd.path={tools.nrf54upload.path}/upload.py
 # transport failures can fall back to pyOCD recovery automatically.
 tools.nrf54ocd.path={runtime.platform.path}/tools
 tools.nrf54ocd.cmd.path={tools.nrf54ocd.path}/nrf_ocd
+tools.nrf54ocd.upload.params.verbose=
+tools.nrf54ocd.upload.params.quiet=
 tools.nrf54ocd.upload.pattern="{tools.python3.cmd}" {tools.python3.args} "{tools.nrf54upload.cmd.path}" --hex "{build.path}/{build.project_name}.hex" --uf2 "{build.path}/{build.project_name}.uf2" --port "{serial.port}" --runner "nrf_ocd" --target "{upload.target}" --uid "{upload.uid}" --openocd-script "{upload.openocd_script}" --openocd-speed "{upload.openocd_speed}" --openocd-bin "{upload.openocd_bin}" --host-tools-path "{runtime.tools.nrf54l15hosttools.path}" --uf2-drive "{upload.uf2_drive}" --uf2-labels "{upload.uf2_labels}" --uf2-timeout "{upload.uf2_timeout}" --pyocd-safe "{upload.pyocd_safe}"
 tools.nrf54ocd.upload.pattern.windows=powershell -NoProfile -NonInteractive -ExecutionPolicy Bypass -File "{runtime.platform.path}/tools/upload_windows.ps1" -HexPath "{build.path}/{build.project_name}.hex" -Port "{serial.port}" -Target "{upload.target}"
 # macOS does not have a bundled nrf_ocd binary yet, so keep the recovery uploader there.
 tools.nrf54ocd.upload.pattern.macosx="{tools.python3.cmd}" {tools.python3.args} "{tools.nrf54upload.cmd.path}" --hex "{build.path}/{build.project_name}.hex" --uf2 "{build.path}/{build.project_name}.uf2" --port "{serial.port}" --runner "pyocd" --target "{upload.target}" --uid "{upload.uid}" --openocd-script "{upload.openocd_script}" --openocd-speed "{upload.openocd_speed}" --openocd-bin "{upload.openocd_bin}" --host-tools-path "{runtime.tools.nrf54l15hosttools.path}" --uf2-drive "{upload.uf2_drive}" --uf2-labels "{upload.uf2_labels}" --uf2-timeout "{upload.uf2_timeout}" --pyocd-safe "{upload.pyocd_safe}"
 
 # Explicit recovery uploader. This intentionally stays Python-based on every OS.
+tools.nrf54upload.upload.params.verbose=
+tools.nrf54upload.upload.params.quiet=
 tools.nrf54upload.upload.pattern="{tools.python3.cmd}" {tools.python3.args} "{tools.nrf54upload.cmd.path}" --hex "{build.path}/{build.project_name}.hex" --uf2 "{build.path}/{build.project_name}.uf2" --port "{serial.port}" --runner "{upload.runner}" --target "{upload.target}" --uid "{upload.uid}" --openocd-script "{upload.openocd_script}" --openocd-speed "{upload.openocd_speed}" --openocd-bin "{upload.openocd_bin}" --host-tools-path "{runtime.tools.nrf54l15hosttools.path}" --uf2-drive "{upload.uf2_drive}" --uf2-labels "{upload.uf2_labels}" --uf2-timeout "{upload.uf2_timeout}" --pyocd-safe "{upload.pyocd_safe}"
 
 tools.nrf54uf2.path={runtime.platform.path}/tools/uf2
@@ -104,6 +108,8 @@ tools.nrf54uf2.uf2conv.path={tools.nrf54uf2.path}/uf2conv.py
 # uploads, with the selected programmer supplying the runner explicitly.
 tools.nrf54program.path={runtime.platform.path}/tools
 tools.nrf54program.cmd.path={tools.nrf54program.path}/upload.py
+tools.nrf54program.program.params.verbose=
+tools.nrf54program.program.params.quiet=
 tools.nrf54program.program.pattern="{tools.python3.cmd}" {tools.python3.args} "{tools.nrf54program.cmd.path}" --hex "{build.path}/{build.project_name}.hex" --uf2 "{build.path}/{build.project_name}.uf2" --port "{serial.port}" --runner "pyocd" --target "{upload.target}" --uid "{upload.uid}" --openocd-script "{upload.openocd_script}" --openocd-speed "{upload.openocd_speed}" --openocd-bin "{upload.openocd_bin}" --host-tools-path "{runtime.tools.nrf54l15hosttools.path}" --uf2-drive "{upload.uf2_drive}" --uf2-labels "{upload.uf2_labels}" --uf2-timeout "{upload.uf2_timeout}" --pyocd-safe "{upload.pyocd_safe}"
 
 # LM20A pyOCD target support is registered at upload time via

hardware/nrf54l15clean/nrf54l15clean/tools/nrf_ocd

@@ -1,6 +1,6 @@
 # nRF OCD Corresponding Source
 
-The platform's Linux `tools/nrf_ocd` executable is nRF OCD `v0.3.7`. It was
+The platform's Linux `tools/nrf_ocd` executable is nRF OCD `v0.3.8`. It was
 built from nRF OCD source and statically linked with libusb `1.0.27`. Most nRF
 OCD code is project-owned MIT work; the target, flash-algorithm, and USB
 transport portions identified in
@@ -10,14 +10,15 @@ recipients can inspect, modify, and relink the complete work.
 
 | File | Role | SHA-256 |
 |---|---|---|
-| `../nrf_ocd` | Distributed Linux x86-64 executable | `9013a6ad6a1bae2788750470502c863b3dfd4ff321f442e2f36c846deacfb31c` |
-| `open-nrf-ocd-v0.3.7-source.tar.gz` | Exact application source from the annotated `v0.3.7` release tag | `b1130ef1b05df1b2cd656189d2f5c7333e86b86055c03ed86ab380b00e405b95` |
+| `../nrf_ocd` | Distributed Linux x86-64 executable | `b05cc011852292f71119eab836bde413dec9dbf1e70428dce1020037f2d547a0` |
+| `open-nrf-ocd-v0.3.8-source.tar.gz` | Exact application source from the annotated `v0.3.8` release tag | `962c788d860b968d27917d3cdc35c7b4df28cf4bdae6000fef853c7b9743c27c` |
 | `libusb-1.0.27.tar.bz2` | Corresponding libusb source | `ffaa41d741a8a3bee244ac8e54a72ea05bf2879663c098c82fc5757853441575` |
 
 The application archive records commit
-`90c1845462050a6ab68ed73eba4ea0a8a8330872` and contains the exact source used
-for the published `v0.3.7` binaries, including command-free post-reset
-teardown, bounded SWD transfer recovery, and their regression tests.
+`2de1a130753e1980178fd796f7c68fe446da249b` and contains the exact source used
+for the published `v0.3.8` binaries, including the onboard probe/target guard,
+command-free post-reset teardown, bounded SWD transfer recovery, and their
+regression tests.
 
 Project-owned nRF OCD portions are provided under the adjacent
 [MIT license](nrf_ocd-MIT.txt). The identified pyOCD-derived portions use the

hardware/nrf54l15clean/nrf54l15clean/tools/nrf_ocd-compliance/README.md

@@ -6,7 +6,7 @@ terms below.
 
 ## pyOCD
 
-The following nRF OCD `v0.3.7` source paths contain material adapted from or
+The following nRF OCD `v0.3.8` source paths contain material adapted from or
 behavior directly derived from pyOCD `0.44.1`:
 
 - `src/flash_algo_nrf54l.c`

hardware/nrf54l15clean/nrf54l15clean/tools/nrf_ocd-compliance/nrf_ocd-THIRD_PARTY_NOTICES.md

@@ -11,7 +11,7 @@ BUILD="$WORK/libusb-build"
 
 rm -rf "$APP" "$LIBUSB" "$PREFIX" "$BUILD"
 mkdir -p "$APP" "$BUILD"
-tar -xzf "$ROOT/open-nrf-ocd-v0.3.7-source.tar.gz" -C "$APP" --strip-components=1
+tar -xzf "$ROOT/open-nrf-ocd-v0.3.8-source.tar.gz" -C "$APP" --strip-components=1
 tar -xjf "$ROOT/libusb-1.0.27.tar.bz2" -C "$WORK"
 
 read -r -a CC_COMMAND <<< "${NRF_OCD_CC:-cc}"