Struct Icache 

pub struct Icache<'d> { /* private fields */ }

Instruction cache driver.

Implementations

impl<'d> Icache<'d>

pub fn enable_remap_region( &mut self, region: u8, config: RegionConfig, ) -> Result<(), RegionError>

Configure and enable a memory-remap region.

region must be less than REGION_COUNT (this panics otherwise). The cache must be disabled, and the region must not already be enabled.

pub fn disable_remap_region(&mut self, region: u8) -> Result<(), RegionError>

Disable a memory-remap region.

region must be less than REGION_COUNT (this panics otherwise). The cache must be disabled.

impl<'d> Icache<'d>

pub fn new(_peri: Peri<'d, ICACHE>) -> Self

Create a new instruction cache driver. The cache is left disabled; call Self::enable() to turn it on.

pub fn enable(&mut self)

Enable the cache.

This always succeeds even if a cache maintenance operation is ongoing: the cache is bypassed until it completes.

pub fn disable(&mut self)

Disable the cache.

Disabling automatically triggers a full cache invalidation; this waits for EN to read back as cleared, but not for that invalidation to finish (call Self::invalidate() afterwards if you need that guarantee).

pub fn is_enabled(&self) -> bool

Returns whether the cache is currently enabled.

pub fn set_associativity(&mut self, assoc: Associativity) -> bool

Set the cache set-associativity.

Only possible while the cache is disabled. Returns false (and does nothing) if the cache is currently enabled.

pub fn invalidate(&mut self)

Invalidate the entire cache content, blocking until the operation completes.

Can be called whether the cache is enabled or disabled.

pub fn start_monitors(&mut self, monitor: Monitor)

Start the given performance counter(s). Use Self::reset_monitors() first if you want them to start counting from zero.

pub fn stop_monitors(&mut self, monitor: Monitor)

Stop the given performance counter(s). Their counts are retained.

pub fn reset_monitors(&mut self, monitor: Monitor)

Reset the given performance counter(s) to zero.

pub fn hit_count(&self) -> u32

Current cache hit count. Saturates (does not wrap) at 0xFFFF_FFFF.

pub fn miss_count(&self) -> u16

Current cache miss count. Saturates (does not wrap) at 0xFFFF.

pub fn take_error(&mut self) -> bool

Returns true and clears the flag if a cache error (invalid maintenance operation) has occurred since the last call.