1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37
use crate::BLOCK_SZ;
use core::any::Any;
/// We should regulate the behavior of this trait on FAILURE
/// e.g. What if buf.len()>BLOCK_SZ for read_block?
/// e.g. Does read_block clean the rest part of the block to be zero for buf.len()!=BLOCK_SZ in write_block() & read_block()
/// e.g. What if buf.len()<BLOCK_SZ for write_block?
pub trait BlockDevice: Send + Sync + Any {
/// Read block from BlockDevice
/// # Argument
/// * `block_id`: the first sector(block) number to be read
/// * `buf`: the buffer to store the coming data
/// # Panic
/// The function panics when the size of `buf` is not a multiple of BLOCK_SZ
fn read_block(&self, block_id: usize, buf: &mut [u8]);
/// Write block into the file system.
/// # Argument
/// * `block_id`: the first sector(block) number to be written to
/// * `buf`: the buffer to store the coming data
/// # Panic
/// The function panics when the size of `buf` is not a multiple of BLOCK_SZ
fn write_block(&self, block_id: usize, buf: &[u8]);
/// # Note
/// *We should rewrite the API for K210 since it supports NATIVE multi-block clearing*
fn clear_block(&self, block_id: usize, num: u8) {
self.write_block(block_id, &[num; BLOCK_SZ]);
}
/// # Note
/// *We should rewrite the API for K210 if it supports NATIVE multi-block clearing*
fn clear_mult_block(&self, block_id: usize, cnt: usize, num: u8) {
for i in block_id..block_id + cnt {
self.write_block(i, &[num; BLOCK_SZ]);
}
}
}