Skip to main content

intermittent_jamming/
intermittent_jamming.rs

1//! Demonstrates degradation, recovery, and an intermittent in-flight radio drop.
2
3use c3mesh::{
4    ChannelConfig, ChannelState, DeviceConfig, DeviceKind, FrequencyBand, InterferenceResponse,
5    NetworkConfig, NetworkEvent, RadioChannel, ReceiverInterference, SimTime, Simulator,
6};
7
8const RADIO_BAND: FrequencyBand = FrequencyBand::new(2_400_000_000, 2_420_000_000);
9
10fn interference(band: FrequencyBand, jammed: f64) -> ReceiverInterference {
11    ReceiverInterference { band, jammed }
12}
13
14fn main() -> Result<(), Box<dyn std::error::Error>> {
15    let network = NetworkConfig {
16        devices: vec![
17            DeviceConfig {
18                id: "vehicle".into(),
19                kind: DeviceKind::Source {
20                    egress: "radio".into(),
21                },
22                mobility: Default::default(),
23                interference: vec![],
24            },
25            DeviceConfig {
26                id: "operator".into(),
27                kind: DeviceKind::Sink,
28                mobility: Default::default(),
29                interference: vec![],
30            },
31        ],
32        channels: vec![ChannelConfig {
33            id: "radio".into(),
34            endpoints: ["vehicle".into(), "operator".into()],
35            bit_rate_bps: 1_000_000,
36            propagation_delay_ns: 100_000,
37            state: ChannelState::Operational,
38            distance: None,
39            radio: Some(RadioChannel {
40                band: RADIO_BAND,
41                interference_response: InterferenceResponse::default(),
42            }),
43        }],
44    };
45
46    let mut simulator = Simulator::new(network)?;
47
48    // A continuous, full-band jammer degrades the second packet to half rate.
49    simulator.schedule_receiver_interference(
50        SimTime::from_nanos(2_000_000),
51        "operator",
52        vec![interference(RADIO_BAND, 0.5)],
53    )?;
54    simulator.schedule_receiver_interference(SimTime::from_nanos(4_000_000), "operator", vec![])?;
55
56    // A short pulse begins after the third packet starts and corrupts it.
57    simulator.schedule_receiver_interference(
58        SimTime::from_nanos(5_200_000),
59        "operator",
60        vec![interference(RADIO_BAND, 0.5)],
61    )?;
62    simulator.schedule_receiver_interference(SimTime::from_nanos(5_300_000), "operator", vec![])?;
63
64    // An accidental emitter covering half the radio band contributes 0.3.
65    simulator.schedule_receiver_interference(
66        SimTime::from_nanos(8_000_000),
67        "operator",
68        vec![interference(
69            FrequencyBand::new(2_400_000_000, 2_410_000_000),
70            0.6,
71        )],
72    )?;
73
74    for at in [0, 2_000_000, 5_000_000, 8_000_000] {
75        simulator.schedule_send(SimTime::from_nanos(at), "vehicle", "operator", vec![0; 100])?;
76    }
77
78    simulator.run_with(|event| match event {
79        NetworkEvent::TransmissionStarted {
80            at,
81            packet,
82            effective_bit_rate_bps,
83            ..
84        } => println!(
85            "{at}: packet {} started at {effective_bit_rate_bps} bit/s",
86            packet.id()
87        ),
88        NetworkEvent::PacketDelivered { at, packet, .. } => {
89            println!("{at}: packet {} delivered", packet.id());
90        }
91        NetworkEvent::PacketDropped {
92            at, packet, reason, ..
93        } => println!("{at}: packet {} dropped: {reason:?}", packet.id()),
94        _ => {}
95    })?;
96    Ok(())
97}