New embedded assignment

down-the-stack/README.md

@@ -0,0 +1,22 @@
+# Down the Stack
+
+This folder contains all relevant exercise templates, demo code and solutions for the exercises in the `Down the Stack` session. 
+
+## `apps` package
+* `button.rs` - demo code for the BSC exercise
+* `hello.rs` - for testing as described in the BSC exercise
+* `uarte_print.rs` - demo code for the BSC exercise
+* `uarte_enable.rs` - exercise template for PAC exercise
+
+## `dk_bsc` package
+* `lib.rs` - exercise template for the BSC exercise
+* `lib_solution.rs` - solution code to the BSC exercise
+
+## `dk_pac` package
+* `Cargo.toml` - a `Cargo.toml` file for the to be generated PAC
+* `nrf52.svd` - an SVD file for generating the PAC
+
+You will generate the remaining files during the training
+
+## `solutions` package
+* `uarte_enable.rs` - contains the solution for the PAC exercise

down-the-stack/apps/.cargo/config.toml

@@ -0,0 +1,19 @@
+[target.'cfg(all(target_arch = "arm", target_os = "none"))']
+# (..)
+rustflags = [
+  "-C", "linker=flip-link", # adds stack overflow protection
+  "-C", "link-arg=-Tdefmt.x", # defmt support
+  # (..)
+]
+
+[target.thumbv7em-none-eabihf]
+# set custom cargo runner to flash & run on embedded target when we call `cargo run`
+# for more information, check out https://github.com/knurling-rs/probe-run
+runner = "probe-run --chip nRF52840_xxAA"
+rustflags = [
+  "-C", "link-arg=-Tlink.x",
+]
+
+[build]
+# cross-compile to this target
+target = "thumbv7em-none-eabihf" # = ARM Cortex-M4

down-the-stack/apps/Cargo.toml

@@ -0,0 +1,49 @@
+[package]
+authors = ["Tanks Transfeld <[email protected]>"]
+edition = "2018"
+license = "MIT OR Apache-2.0"
+name = "apps"
+version = "0.0.0"
+
+[dependencies]
+cortex-m = {version = "0.7.6", features = ["critical-section-single-core"]}
+cortex-m-rt = "0.7.2"
+dk_bsc = { path = "../dk_bsc" }
+heapless = "0.7.16"
+panic-probe = { version = "0.3.0", features = ["print-defmt"] }
+defmt = "0.3.2"
+defmt-rtt = "0.3.2"
+
+# optimize code in both profiles
+[profile.dev]
+codegen-units = 1
+debug = 2
+debug-assertions = true # !
+incremental = false
+lto = "fat"
+opt-level = 'z' # !
+overflow-checks = false
+
+[profile.release]
+codegen-units = 1
+debug = 1
+debug-assertions = false
+incremental = false
+lto = "fat"
+opt-level = 3
+overflow-checks = false
+
+[features]
+
+
+default = [
+  "other-feature"
+]
+other-feature = []
+# do NOT modify these features
+defmt-default = []
+defmt-trace = []
+defmt-debug = []
+defmt-info = []
+defmt-warn = []
+defmt-error = []

down-the-stack/apps/src/bin/button.rs

@@ -0,0 +1,31 @@
+#![no_main]
+#![no_std]
+
+
+use cortex_m_rt::entry;
+
+// this imports `down-the-stack/apps/lib.rs` to retrieve our global logger + panicking-behavior
+use apps as _;
+
+// ⚠️ ⚠️ ⚠️ Don't change this file! ⚠️ ⚠️ ⚠️
+
+#[entry]
+fn main() -> ! {
+    // to enable more verbose logs, go to your `Cargo.toml` and set defmt logging levels
+    // to `defmt-trace` by changing the `default = []` entry in `[features]`
+
+    let board = dk_bsc::init().unwrap();
+
+    let mut led = board.leds;
+    let button_1 = board.buttons.b_1;
+
+    loop {
+        if button_1.is_pushed() {
+            led.led_1.on();
+        } else {
+            led.led_1.off();
+        }
+    }
+
+    // this program does not `exit`; use Ctrl+C to terminate it
+}

down-the-stack/apps/src/bin/hello.rs

@@ -0,0 +1,28 @@
+// this program does not use the standard library to avoid heap allocations.
+// only the `core` library functions are available.
+#![no_std]
+// this program uses a custom entry point instead of `fn main()`
+#![no_main]
+
+use cortex_m::asm;
+use cortex_m_rt::entry;
+// this imports `beginner/apps/lib.rs` to retrieve our global logger + panicking-behavior
+use apps as _;
+
+// the custom entry point
+// vvvvv
+#[entry]
+fn main() -> ! {
+    //      ˆˆˆ
+    //       ! is the 'never' type: this function never returns
+
+    // initializes the peripherals
+    dk_bsc::init().unwrap();
+
+    defmt::println!("Hello, world!"); // :wave:
+
+    loop {
+        // breakpoint: halts the program's execution
+        asm::bkpt();
+    }
+}

down-the-stack/apps/src/bin/uarte_enable.rs

@@ -0,0 +1,28 @@
+#![no_main]
+#![no_std]
+
+use cortex_m::asm;
+use cortex_m_rt::entry;
+
+// ^^^^ import the PAC here
+
+// this imports `down-the-stack/apps/lib.rs` to retrieve our global logger + panicking-behavior
+use apps as _;
+use defmt;
+use defmt_rtt as _; // global logger
+
+#[entry]
+fn main() -> ! {
+    // to enable more verbose logs, go to your `Cargo.toml` and set defmt logging levels
+    // to `defmt-trace` by changing the `default = []` entry in `[features]`
+
+    // Your code goes here...
+
+
+    // this program does not `exit`; use Ctrl+C to terminate it
+    loop {
+        asm::nop();
+    }
+}
+
+// The helper function goes here...

down-the-stack/apps/src/bin/uarte_print.rs

@@ -0,0 +1,28 @@
+#![no_main]
+#![no_std]
+
+use cortex_m::asm;
+use cortex_m_rt::entry;
+use core::fmt::Write;
+
+// this imports `down-the-stack/apps/lib.rs` to retrieve our global logger + panicking-behavior
+use apps as _;
+
+// ⚠️ ⚠️ ⚠️ Don't change this file! ⚠️ ⚠️ ⚠️
+
+#[entry]
+fn main() -> ! {
+    // to enable more verbose logs, go to your `Cargo.toml` and set defmt logging levels
+    // to `defmt-trace` by changing the `default = []` entry in `[features]`
+
+    let board = dk_bsc::init().unwrap();
+    let mut uarte = board.uarte;
+
+    let tx_buffer = "Hello, World!\n";
+    uarte.write_str(tx_buffer).unwrap();
+
+    // this program does not `exit`; use Ctrl+C to terminate it
+    loop {
+        asm::nop();
+    }
+}

down-the-stack/apps/src/lib.rs

@@ -0,0 +1,10 @@
+#![no_std]
+// ⚠️ ⚠️ ⚠️ Don't change this file! ⚠️ ⚠️ ⚠️
+use panic_probe as _;
+
+// same panicking *behavior* as `panic-probe` but doesn't print a panic message
+// this prevents the panic message being printed *twice* when `defmt::panic` is invoked
+#[defmt::panic_handler]
+fn panic() -> ! {
+    cortex_m::asm::udf()
+}

down-the-stack/dk_bsc/Cargo.toml

@@ -0,0 +1,24 @@
+[package]
+authors = ["Jorge Aparicio <[email protected]>", "Tanks Transfeld <[email protected]"]
+edition = "2018"
+license = "MIT OR Apache-2.0"
+name = "dk_bsc"
+version = "0.0.0"
+
+[dependencies]
+cortex-m = {version = "0.7.6", features = ["critical-section-single-core"]}
+cortex-m-rt = "0.7.2"
+embedded-hal = "0.2.7"
+nrf52840-hal = "0.14.0"
+panic-probe = { version = "0.3.0", features = ["print-defmt"] }
+defmt = "0.3.2"
+defmt-rtt = "0.3.2"
+
+[features]
+advanced = []
+beginner = []
+
+default = [
+  "other-feature"
+]
+other-feature = []

down-the-stack/dk_bsc/README.md

@@ -0,0 +1,7 @@
+# `dk`
+
+Board Support Crate for the nRF52840 Development Kit (DK)
+
+## Getting familiar with the hardware
+
+TODO

down-the-stack/dk_bsc/build.rs

@@ -0,0 +1,12 @@
+use std::{env, error::Error, fs, path::PathBuf};
+
+fn main() -> Result<(), Box<dyn Error>> {
+    let out_dir = PathBuf::from(env::var("OUT_DIR")?);
+
+    // put memory layout (linker script) in the linker search path
+    fs::copy("memory.x", out_dir.join("memory.x"))?;
+
+    println!("cargo:rustc-link-search={}", out_dir.display());
+
+    Ok(())
+}

down-the-stack/dk_bsc/memory.x

@@ -0,0 +1,5 @@
+MEMORY
+{
+  FLASH : ORIGIN = 0x00000000, LENGTH = 1024K
+  RAM   : ORIGIN = 0x20000000, LENGTH = 256K
+}