Add on-target tests to CI

Author: newAM

.cargo/config

@@ -1,2 +1,5 @@
+[target.'cfg(all(target_arch = "arm", target_os = "none"))']
+rustflags = ["-C", "link-arg=-Tlink.x"]
+
 [alias]
 xtask = "run --package xtask --bin xtask --"

.github/workflows/on-target.yml

@@ -0,0 +1,26 @@
+on:
+  push:
+    branches: [ staging, trying, master ]
+  pull_request:
+
+name: On target tests
+
+jobs:
+  on-target:
+    runs-on: self-hosted
+    steps:
+      - name: Display rustup version
+        run: rustup --version
+      - name: Display probe-run version
+        run: probe-run --version
+      - name: List probes
+        run: probe-run --list-probes
+      - uses: actions/checkout@v2
+        with:
+          submodules: true
+      - name: Setup toolchain
+        run: rustup default stable && rustup target install thumbv6m-none-eabi
+      - name: Build on-target tests
+        run: cargo build -p testsuite --target thumbv6m-none-eabi
+      - name: Run on-target tests
+        run: probe-run --chip STM32F070RBTx --connect-under-reset target/thumbv6m-none-eabi/debug/testsuite

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "cortex-m-rt"]
+	path = cortex-m-rt
+	url = [email protected]:newAM/cortex-m-rt.git

Cargo.toml

@@ -28,7 +28,16 @@ inline-asm = []
 linker-plugin-lto = []
 
 [workspace]
-members = ["xtask", "cortex-m-semihosting", "panic-semihosting", "panic-itm"]
+members = [
+    "cortex-m-rt",
+    "cortex-m-semihosting",
+    "panic-itm",
+    "panic-semihosting",
+    "testsuite",
+    "testsuite/minitest",
+    "testsuite/minitest/macros",
+    "xtask",
+]
 
 [package.metadata.docs.rs]
 targets = [

cortex-m-rt

@@ -0,0 +1,6 @@
+/* Memory layout for the STM32F070RBTx used for on-target testing */
+MEMORY
+{
+  FLASH : ORIGIN = 0x8000000, LENGTH = 128K
+  RAM : ORIGIN = 0x20000000, LENGTH = 16K
+}

memory.x

@@ -0,0 +1,12 @@
+[package]
+authors = ["The Cortex-M Team <[email protected]>"]
+name = "testsuite"
+publish = false
+edition = "2018"
+version = "0.1.0"
+
+[dependencies]
+cortex-m-rt.path = "../cortex-m-rt"
+cortex-m.path = ".."
+minitest.path = "minitest"
+rtt-target = "0.3.1"

testsuite/Cargo.toml

@@ -0,0 +1,58 @@
+# Testsuite
+
+This workspace contains on-target tests.
+
+## Building
+
+Assuming you are at the root of the repository you can build like this:
+
+```console
+$ cargo build -p testsuite --target thumbv6m-none-eabi
+   Compiling testsuite v0.1.0 (cortex-m/testsuite)
+    Finished dev [unoptimized + debuginfo] target(s) in 0.08
+```
+
+## Running
+
+No implementation-specific features are tested right now; any `thumbv6m-none-eabi` target should work.
+
+Tests are executed with [probe-run](https://github.com/knurling-rs/probe-run):
+
+```console
+$ probe-run --chip STM32F070RBTx --connect-under-reset target/thumbv6m-none-eabi/debug/testsuite
+(HOST) INFO  flashing program (12.80 KiB)
+(HOST) INFO  success!
+────────────────────────────────────────────────────────────────────────────────
+(1/2) running `assert_true`...
+(2/2) running `assert_flag`...
+all tests passed!
+────────────────────────────────────────────────────────────────────────────────
+stack backtrace:
+   0: lib::inline::__bkpt
+        at ./asm/inline.rs:13:5
+   1: __bkpt
+        at ./asm/lib.rs:49:17
+   2: minitest::export::exit
+        at testsuite/minitest/src/export.rs:6:9
+   3: main
+        at testsuite/src/main.rs:23:1
+   4: Reset
+(HOST) WARN  call stack was corrupted; unwinding could not be completed
+(HOST) INFO  device halted without error
+```
+
+## CI
+
+These tests are run automatically in continuous integration.  A self-hosted github actions runner with a NUCLEO-F070RB board is hosted by [newAM](https://github.com/newAM).
+
+The runner is equiped with a limited selection of packages:
+* [Unix Commands](https://en.wikipedia.org/wiki/List_of_Unix_commands)
+* clang
+* gcc-arm-embedded
+* git
+* probe-run
+* rustup
+
+The complete host configuration can be found here [here](https://github.com/newAM/nixfiles/blob/main/t430s/configuration.nix).
+
+⚠️ Hosting a github actions runner in a public repository goes directly against [github's advice](https://docs.github.com/en/actions/hosting-your-own-runners/about-self-hosted-runners#self-hosted-runner-security-with-public-repositories), do not do this yourself unless you are prepared to accept the risks.

testsuite/README.md

@@ -0,0 +1,12 @@
+[package]
+authors = ["The Cortex-M Team <[email protected]>"]
+name = "minitest"
+publish = false
+edition = "2018"
+version = "0.1.0"
+
+[dependencies]
+cortex-m.path = "../.."
+cortex-m-rt.path = "../../cortex-m-rt"
+minitest-macros = { version = "=0.1.0", path = "macros" }
+rtt-target = "0.3.1"

testsuite/minitest/Cargo.toml

@@ -0,0 +1,7 @@
+# rtt-test
+
+This is an embedded test framework forked from knurling's excellent [`defmt-test`] crate.
+
+This even more minimal than [`defmt-test`] to allow for for testing of this crate without dependency cycles.
+
+[`defmt-test`]: https://crates.io/crates/defmt-test/