random: Make available as riot_rs::random; rename laze feature to match

examples/random/Cargo.toml

@@ -1,15 +1,14 @@
 [package]
-name = "random"
+name = "example-random"
 version = "0.1.0"
 authors.workspace = true
 edition.workspace = true
 publish = false
 
 [dependencies]
-# not enabling riot-rs/hwrng even though it's currently needed -- laze takes
-# care of that.
-riot-rs = { path = "../../src/riot-rs", features = ["threading"] }
+# Enabling the feature "random" is somewhat redundant with laze.yml's selects:
+# random, but helps with interactive tools.
+riot-rs = { path = "../../src/riot-rs", features = ["threading", "random"] }
 riot-rs-boards = { path = "../../src/riot-rs-boards" }
 
-riot-rs-random = { version = "0.1.0", path = "../../src/riot-rs-random" }
 rand = { version = "0.8.5", default-features = false }

examples/random/laze.yml

@@ -1,5 +1,5 @@
 apps:
-  - name: random
+  - name: example-random
     selects:
       - ?release
-      - rng
+      - random

examples/random/src/main.rs

@@ -8,7 +8,7 @@ use riot_rs::debug::println;
 #[riot_rs::thread(autostart)]
 fn main() {
     use rand::Rng as _;
-    let mut rng = riot_rs_random::get_rng();
+    let mut rng = riot_rs::random::get_rng();
 
     let value = rng.gen_range(1..=6);
 

laze-project.yml

@@ -514,11 +514,18 @@ modules:
         FEATURES:
           - riot-rs/hwrng
 
-  - name: rng
-    help: A system-wide RNG is available
+  - name: random
+    help: A system-wide RNG is available (through the riot_rs::random module).
+
+      As the riot_rs::random module will refuse operation at run time if not
+      properly initialized, this depends on sources of original entropy.
     depends:
       # could later alternatively depend on mutable config storage
       - hwrng
+    env:
+      global:
+        FEATURES:
+          - riot-rs/random
 
   - name: sw/benchmark
     help: provided if a target supports `benchmark()`

src/riot-rs/Cargo.toml

@@ -16,6 +16,7 @@ riot-rs-buildinfo = { path = "../riot-rs-buildinfo" }
 riot-rs-debug = { workspace = true }
 riot-rs-embassy = { path = "../riot-rs-embassy" }
 riot-rs-macros = { path = "../riot-rs-macros" }
+riot-rs-random = { path = "../riot-rs-random", optional = true }
 riot-rs-rt = { path = "../riot-rs-rt" }
 riot-rs-threads = { path = "../riot-rs-threads", optional = true }
 static_cell = { workspace = true }
@@ -44,6 +45,8 @@ threading = [
 ## Enables support for timeouts in the internal executor---required to use
 ## `embassy_time::Timer`.
 time = ["riot-rs-embassy/time"]
+## Enables the [`riot-rs::random`] module.
+random = ["riot-rs-random"]
 ## Enables seeding the random number generator from hardware.
 hwrng = ["riot-rs-embassy/hwrng"]
 

src/riot-rs/src/lib.rs

@@ -17,6 +17,9 @@ pub use riot_rs_debug as debug;
 #[doc(inline)]
 pub use riot_rs_embassy as embassy;
 pub use riot_rs_embassy::{define_peripherals, group_peripherals};
+#[cfg(feature = "random")]
+#[doc(inline)]
+pub use riot_rs_random as random;
 #[doc(inline)]
 pub use riot_rs_rt as rt;
 #[cfg(feature = "threading")]