Expand description
High speed digital logic simulation
§Example
use gsim::*;
use std::num::NonZeroU8;
let mut builder = SimulatorBuilder::default();
// Add wires and components to the simulation
let wire_width = NonZeroU8::new(1).unwrap();
let input_a = builder.add_wire(wire_width).unwrap();
let input_b = builder.add_wire(wire_width).unwrap();
let output = builder.add_wire(wire_width).unwrap();
// The gate ID is not usefull to us because we don't intend on reading its data
let _gate = builder.add_and_gate(&[input_a, input_b], output).unwrap();
// Create the simulation
let mut sim = builder.build();
// Manually drive the input wires
sim.set_wire_drive(input_a, &LogicState::from_bool(true)).unwrap();
sim.set_wire_drive(input_b, &LogicState::from_bool(false)).unwrap();
// Run the simulation
const MAX_STEPS: u64 = 2;
match sim.run_sim(MAX_STEPS) {
SimulationRunResult::Ok => {}
SimulationRunResult::MaxStepsReached => panic!("simulation did not settle within allowed steps"),
SimulationRunResult::Err(err) => panic!("simulation error: {err:?}"),
}
// Make sure we got the expected result
let output_state = sim.get_wire_state(output).unwrap();
assert!(output_state.eq(&LogicState::from_bool(false), wire_width));
Modules§
- Import circuits from various formats
Macros§
- Constructs a logic state from a list of bits (most significant bit first)
Structs§
- The size of a memory allocation
- A unique identifier for a component inside a simulation
- A specified component ID was not part of the simulation
- A specified wire ID was not part of the simulation
- A logic state of arbitrary bit width
- Contains data of all errors that occurred in a simulation
- Memory usage statistics of a simulation
- A digital circuit simulator
- Builds a simulator
- The timescale in a VCD file
- A unique identifier for a wire inside a simulation
Enums§
- Errors that can occur when adding a component to a simulator
- Defines the polarity of a clock signal
- Contains mutable data of a component
- The logic state of a single bit
- The result of running a simulation
Traits§
- An ID type
Type Aliases§
- The result of adding a component to a simulator