docs(examples/application): minimal Application user

examples/application/Cargo.toml

@@ -0,0 +1,13 @@
+[package]
+name = "application"
+version = "0.1.0"
+authors.workspace = true
+edition.workspace = true
+publish = false
+
+[dependencies]
+riot-rs = { path = "../../src/riot-rs" }
+riot-rs-boards = { path = "../../src/riot-rs-boards" }
+embassy-executor = { workspace = true, default-features = false }
+embassy-time = { workspace = true, default-features = false }
+linkme.workspace = true

examples/application/README.md

@@ -0,0 +1,5 @@
+# application
+
+## About
+
+This folder contains a minimal `Application` example.

examples/application/laze.yml

@@ -0,0 +1,4 @@
+apps:
+  - name: application
+    selects:
+      - ?release

examples/application/src/main.rs

@@ -0,0 +1,34 @@
+#![no_main]
+#![no_std]
+#![feature(type_alias_impl_trait)]
+#![feature(used_with_arg)]
+
+use riot_rs::embassy::{arch, Application, ApplicationInitError, Drivers, InitializationArgs};
+
+use riot_rs::rt::debug::println;
+
+struct MyApplication {
+    state: u32, // some state
+}
+
+impl Application for MyApplication {
+    fn initialize(
+        _peripherals: &mut arch::OptionalPeripherals,
+        _init_args: InitializationArgs,
+    ) -> Result<&dyn Application, ApplicationInitError> {
+        println!("MyApplication::initialize()");
+        Ok(&Self { state: 0 })
+    }
+
+    fn start(&self, _spawner: embassy_executor::Spawner, _drivers: Drivers) {
+        println!("MyApplication::start()");
+        // ...
+    }
+}
+
+riot_rs::embassy::riot_initialize!(MyApplication);
+
+#[no_mangle]
+fn riot_main() {
+    riot_rs::rt::debug::exit(Ok(()))
+}

examples/laze.yml

@@ -4,6 +4,7 @@ defaults:
       - riot-rs
 
 subdirs:
+  - application
   - benchmark
   - bottles
   - core-sizes