Struct AfuConfig 

pub struct AfuConfig {

    pub name: &'static str,
    pub uuid: u128,
    pub build: u64,
    pub line: LocalMemoryLine,
    pub user_clock_mhz: u32,
    pub compute_divide: u32,
    pub max_burst: u32,
    pub read_fifo_log2: u32,
    pub write_fifo_log2: u32,
    pub channel_model: ChannelModel,
    pub engine: Option<EngineParams>,
    pub floorplan: Option<String>,
    pub flat: bool,
}

The accelerator a build makes.

Fields

name: &'static str

The accelerator’s name in the AFU JSON.

uuid: u128

The accelerator-type-uuid a driver opens it by, and the AFU ID its feature header carries.

build: u64

A build identity the BUILD register reads back.

line: LocalMemoryLine

user_clock_mhz: u32

The user clock the AFU JSON asks for, MHz: the fitter’s target, the clock set from the timing it closes. A divided build asks for exactly this clock.

compute_divide: u32

The compute clock the shell runs on: the user clock divided by this, an even number, or the user clock itself at

1. A divided build closes timing at the divided period.

max_burst: u32

Lines a burst, on every port.

read_fifo_log2: u32

log2 of the lines a read-data FIFO holds, and a write-data FIFO.

write_fifo_log2: u32

channel_model: ChannelModel

The co-simulation’s memory channels.

engine: Option<EngineParams>

The decode engine the core runs steps on (rtl::engine::engine_verilog, its memory on the channels through the card port, physical::card_port_verilog), or none for the bring-up build.

floorplan: Option<String>

Placement assignments for Quartus, as Tcl: the tree’s hw/rtl/logos_floorplan.tcl, named in sources.txt as QI: so the build sources it; none when no floorplan is given.

flat: bool

Whether the accelerator is compiled into the FIM itself (a flat image, scripts/d5005/build-afu.sh --flat) rather than as a persona. The FIM’s static region instantiates its exercisers (he_lb_top, PF0 VF0) whatever the port holds, but the Stratix 10 release’s afu_main.tcl loads their sources only when no PIM-wrapped AFU is configured, so a flat build’s sources.txt names them: FIM_STATIC_EXERCISERS, from the FIM that builds it.

Implementations

impl AfuConfig

pub fn engine(engine: EngineParams, line: LocalMemoryLine) -> AfuConfig

The engine build for engine at line (data64 or SECDED lines): the bring-up build’s core and channels with the engine and its card port behind them, its compute clock ENGINE_USER_CLOCK_MHZ divided by ENGINE_COMPUTE_DIVIDE.

pub fn d5005() -> AfuConfig

The bring-up build: the ECC lanes as data, the user clock at the engine plan’s 450 MHz, 64-line bursts, 512 lines of read FIFO a channel (a run of eight bursts in flight) and 64 of write FIFO.

pub fn hybrid(&self) -> bool

Whether the build’s engine is a hybrid one: its matvec jobs on a streaming unit in the user clock.

pub fn pe_pairs(&self) -> bool

Whether the engine’s streaming unit pairs its cores on processing elements in a clock of twice theirs (super::rtl::column::ColumnSet::pe_pairs): the user side in the PIM’s uClk_usrDiv2, the pairs in uClk_usr.

pub fn token_pairs(&self) -> bool

Whether the engine’s array issues its held beat against two token-rows a clock (super::rtl::column::ColumnSet::with_token_pairs).

pub fn fp_hard(&self) -> bool

Whether the engine’s f32 products are the card’s floating-point DSP blocks’ (super::numerics::FpUnit::Hard): its programs are written at the card’s products.

pub fn contexts(&self) -> usize

The engine’s sequencer contexts (super::rtl::engine::Streaming::contexts): 1 for one sequencer or none.

pub fn uuid_text(&self) -> String

The UUID as the AFU JSON writes it.

Trait Implementations

impl Clone for AfuConfig

fn clone(&self) -> AfuConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AfuConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for AfuConfig

fn eq(&self, other: &AfuConfig) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for AfuConfig