New embedded assignment

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,48 @@
+[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_template = { path = "../dk_template" }
+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,32 @@
+#![no_main]
+#![no_std]
+
+use cortex_m::asm;
+use cortex_m_rt::entry;
+use core::fmt::Write;
+// this imports `beginner/apps/lib.rs` to retrieve our global logger + panicking-behavior
+use apps as _;
+
+#[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_template::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
+    loop {
+        asm::nop();
+    }
+}

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::init().unwrap();
+
+    defmt::println!("Hello, world!"); // :wave:
+
+    loop {
+        // breakpoint: halts the program's execution
+        asm::bkpt();
+    }
+}

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

@@ -0,0 +1,29 @@
+#![no_main]
+#![no_std]
+
+use cortex_m::asm;
+use cortex_m_rt::entry;
+use core::fmt::Write;
+// this imports `beginner/apps/lib.rs` to retrieve our global logger + panicking-behavior
+use apps as _;
+
+#[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_template::init().unwrap();
+
+    let button_1 = board.buttons.b_1;
+    let mut uarte = board.uarte;
+
+
+    let tx_buffer = "Hello\n";
+
+
+    loop {
+        if button_1.is_pushed() {
+            uarte.write_str(tx_buffer).unwrap();
+        }
+    }
+}

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

@@ -0,0 +1,10 @@
+#![no_std]
+
+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_template/Cargo.toml

@@ -0,0 +1,32 @@
+[package]
+authors = ["Jorge Aparicio <[email protected]>", "Tanks Transfeld <[email protected]"]
+edition = "2018"
+license = "MIT OR Apache-2.0"
+name = "dk_template"
+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"
+hal = { package = "nrf52840-hal", version = "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 = []
+
+# do NOT modify these features
+defmt-default = []
+defmt-trace = []
+defmt-debug = []
+defmt-info = []
+defmt-warn = []
+defmt-error = []

down-the-stack/dk_template/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_template/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_template/memory.x

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

down-the-stack/dk_template/src/errata.rs

@@ -0,0 +1,13 @@
+/// USBD cannot be enabled
+pub unsafe fn e187a() {
+    (0x4006_EC00 as *mut u32).write_volatile(0x9375);
+    (0x4006_ED14 as *mut u32).write_volatile(3);
+    (0x4006_EC00 as *mut u32).write_volatile(0x9375);
+}
+
+/// USBD cannot be enabled
+pub unsafe fn e187b() {
+    (0x4006_EC00 as *mut u32).write_volatile(0x9375);
+    (0x4006_ED14 as *mut u32).write_volatile(0);
+    (0x4006_EC00 as *mut u32).write_volatile(0x9375);
+}