pamoja-sim 0.1.8

Hardware-free device simulators for pamoja: fake sensors with configurable noise and drift, and a recording actuator, behind the core Sensor and Actuator traits.
Documentation

Hardware-free device simulators for the pamoja SDK.

The SDK is meant to be built and tested with no hardware at all, and that promise only holds if there are convincing stand-ins for the parts a device would have. This crate provides those stand-ins as ordinary implementations of the core Sensor and Actuator traits, so they drop into a Node, a profile, or a test exactly where a real driver will go once the hardware-I/O layer lands:

  • [SimSensor] - a fake sensor that generates a lifelike signal from a baseline, a drift, and bounded, seedable noise, so a control loop meets the kind of messy input it will see in the field.
  • [Replay] - a fake sensor that plays back an exact sequence of readings, for deterministic tests and scripted demos.
  • [RecordingActuator] - a fake actuator that logs every command instead of driving hardware, so a test can assert what a control loop decided to do.
  • [DegradedLink] - a Transport decorator that simulates a lossy and intermittent radio link, so offline-first store-and- forward can be proven against a realistic bad network rather than assumed.

Examples

Drive a recording relay from a scripted probe, with no hardware:

use pamoja_core::{Actuator, Sensor};
use pamoja_sim::{RecordingActuator, Replay};

# async fn demo() -> pamoja_core::Result<()> {
let mut probe = Replay::new(vec![3.0, 7.0]);
let mut relay = RecordingActuator::new();
let log = relay.log();

// Switch the relay on whenever the probe reads warm.
while let Ok(reading) = probe.read().await {
    relay.apply(reading > 5.0).await?;
}

assert_eq!(log.commands(), vec![false, true]);
# Ok(())
# }