Struct FileFlash 

pub struct FileFlash { /* private fields */ }

Implementations

impl FileFlash

pub fn new( file: File, capacity: u32, page_size: usize, block_size: usize, durability: Durability, ) -> Result<Self, Error>

Examples found in repository

examples/slate_flash_calib.rs (line 58)

fn time_flash_programs(dir: &std::path::Path, label: &str, dur: Durability) {
    let path = dir.join(format!("calib_{label}.bin"));
    let file = OpenOptions::new()
        .read(true)
        .write(true)
        .create(true)
        .truncate(false)
        .open(&path)
        .unwrap();
    let mut flash = FileFlash::new(file, CAPACITY, PAGE, BLOCK, dur).unwrap();
    let buf = [0xA5u8; PAGE];
    let mut ns = Vec::with_capacity(N);
    // Each page may be programmed once, so every iteration targets a fresh
    // page rather than re-erasing (an erase is a different cost).
    for i in 0..N {
        let addr = (i * PAGE) as u32;
        let t0 = Instant::now();
        flash.program(addr, &buf).unwrap();
        ns.push(t0.elapsed().as_nanos() as u64);
    }
    summarize(&format!("FileFlash::program,{label}"), ns);
    drop(flash);
    let _ = std::fs::remove_file(&path);
}

pub fn counters(&self) -> FlashCounters

Device I/O tallies accumulated since this handle was created.

Trait Implementations

impl Flash for FileFlash

type Error = FileFlashError

Flash error type.

fn page_size(&self) -> usize

Program granularity.

fn block_size(&self) -> usize

Erase granularity, multiple of page_size.

fn capacity(&self) -> u32

Capacity in bytes, C_flash.

fn read(&mut self, addr: u32, buf: &mut [u8]) -> Result<(), Self::Error>

Reads from flash.

fn program(&mut self, addr: u32, buf: &[u8]) -> Result<(), Self::Error>

May only program pages that are in erased state. addr and buf.len() must be page-aligned/page-sized multiples. Completion = durable.

fn erase(&mut self, block_addr: u32) -> Result<(), Self::Error>

Erases a block resetting it to all 1s.