Add FlashRegion trait and implement embedded_storage traits for each region

This commit is contained in:
Rasmus Melchior Jacobsen 2023-03-25 05:58:40 +01:00
parent cccceb88f2
commit 6b44027eab

View File

@ -1,10 +1,10 @@
use embassy_hal_common::{into_ref, PeripheralRef}; use embassy_hal_common::{into_ref, PeripheralRef};
use embedded_storage::nor_flash::{ErrorType, NorFlash, NorFlashError, NorFlashErrorKind, ReadNorFlash}; use embedded_storage::nor_flash::{ErrorType, NorFlash, NorFlashError, NorFlashErrorKind, ReadNorFlash};
pub use crate::pac::{ERASE_SIZE, ERASE_VALUE, FLASH_BASE, FLASH_SIZE, WRITE_SIZE}; pub use crate::_generated::flash_regions::*;
pub use crate::pac::{FLASH_BASE, FLASH_SIZE};
use crate::peripherals::FLASH; use crate::peripherals::FLASH;
use crate::Peripheral; use crate::Peripheral;
const FLASH_END: usize = FLASH_BASE + FLASH_SIZE;
#[cfg_attr(any(flash_wl, flash_wb, flash_l0, flash_l1, flash_l4), path = "l.rs")] #[cfg_attr(any(flash_wl, flash_wb, flash_l0, flash_l1, flash_l4), path = "l.rs")]
#[cfg_attr(flash_f3, path = "f3.rs")] #[cfg_attr(flash_f3, path = "f3.rs")]
@ -23,60 +23,63 @@ impl<'d> Flash<'d> {
Self { _inner: p } Self { _inner: p }
} }
pub fn into_regions(self) -> FlashRegions {
FlashRegions::take()
}
pub fn blocking_read(&mut self, offset: u32, bytes: &mut [u8]) -> Result<(), Error> { pub fn blocking_read(&mut self, offset: u32, bytes: &mut [u8]) -> Result<(), Error> {
let offset = FLASH_BASE as u32 + offset; if offset as usize + bytes.len() > FLASH_SIZE {
if offset as usize >= FLASH_END || offset as usize + bytes.len() > FLASH_END {
return Err(Error::Size); return Err(Error::Size);
} }
let flash_data = unsafe { core::slice::from_raw_parts(offset as *const u8, bytes.len()) }; let first_address = FLASH_BASE as u32 + offset;
let flash_data = unsafe { core::slice::from_raw_parts(first_address as *const u8, bytes.len()) };
bytes.copy_from_slice(flash_data); bytes.copy_from_slice(flash_data);
Ok(()) Ok(())
} }
pub fn blocking_write(&mut self, offset: u32, buf: &[u8]) -> Result<(), Error> { pub fn blocking_write(&mut self, offset: u32, buf: &[u8]) -> Result<(), Error> {
let offset = FLASH_BASE as u32 + offset; if offset as usize + buf.len() > FLASH_SIZE {
if offset as usize + buf.len() > FLASH_END {
return Err(Error::Size); return Err(Error::Size);
} }
if offset as usize % WRITE_SIZE != 0 || buf.len() as usize % WRITE_SIZE != 0 { if offset as usize % family::MAX_WRITE_SIZE != 0 || buf.len() as usize % family::MAX_WRITE_SIZE != 0 {
return Err(Error::Unaligned); return Err(Error::Unaligned);
} }
trace!("Writing {} bytes at 0x{:x}", buf.len(), offset);
self.clear_all_err(); let first_address = FLASH_BASE as u32 + offset;
trace!("Writing {} bytes at 0x{:x}", buf.len(), first_address);
unsafe { unsafe {
family::clear_all_err();
family::unlock(); family::unlock();
let res = family::blocking_write(offset, buf); let res = family::blocking_write(first_address, buf);
family::lock(); family::lock();
res res
} }
} }
pub fn blocking_erase(&mut self, from: u32, to: u32) -> Result<(), Error> { pub fn blocking_erase(&mut self, from: u32, to: u32) -> Result<(), Error> {
let from = FLASH_BASE as u32 + from; if to < from || to as usize > FLASH_SIZE {
let to = FLASH_BASE as u32 + to;
if to < from || to as usize > FLASH_END {
return Err(Error::Size); return Err(Error::Size);
} }
if (from as usize % ERASE_SIZE) != 0 || (to as usize % ERASE_SIZE) != 0 { if (from as usize % family::MAX_ERASE_SIZE) != 0 || (to as usize % family::MAX_ERASE_SIZE) != 0 {
return Err(Error::Unaligned); return Err(Error::Unaligned);
} }
self.clear_all_err(); let from_address = FLASH_BASE as u32 + from;
let to_address = FLASH_BASE as u32 + to;
unsafe { unsafe {
family::clear_all_err();
family::unlock(); family::unlock();
let res = family::blocking_erase(from, to); let res = family::blocking_erase(from_address, to_address);
family::lock(); family::lock();
res res
} }
} }
fn clear_all_err(&mut self) {
unsafe { family::clear_all_err() };
}
} }
impl Drop for Flash<'_> { impl Drop for Flash<'_> {
@ -85,6 +88,69 @@ impl Drop for Flash<'_> {
} }
} }
pub trait FlashRegion {
const BASE: usize;
const SIZE: usize;
const ERASE_SIZE: usize;
const WRITE_SIZE: usize;
const ERASE_VALUE: u8;
fn blocking_read(&mut self, offset: u32, bytes: &mut [u8]) -> Result<(), Error> {
if offset as usize + bytes.len() > Self::SIZE {
return Err(Error::Size);
}
let first_address = Self::BASE as u32 + offset;
let flash_data = unsafe { core::slice::from_raw_parts(first_address as *const u8, bytes.len()) };
bytes.copy_from_slice(flash_data);
Ok(())
}
fn blocking_write(&mut self, offset: u32, buf: &[u8]) -> Result<(), Error> {
if offset as usize + buf.len() > Self::SIZE {
return Err(Error::Size);
}
if offset as usize % Self::WRITE_SIZE != 0 || buf.len() as usize % Self::WRITE_SIZE != 0 {
return Err(Error::Unaligned);
}
let first_address = Self::BASE as u32 + offset;
trace!("Writing {} bytes from 0x{:x}", buf.len(), first_address);
critical_section::with(|_| unsafe {
family::clear_all_err();
family::unlock();
let res = family::blocking_write(first_address, buf);
family::lock();
res
})
}
fn blocking_erase(&mut self, from: u32, to: u32) -> Result<(), Error> {
if to < from || to as usize > Self::SIZE {
return Err(Error::Size);
}
if (from as usize % Self::ERASE_SIZE) != 0 || (to as usize % Self::ERASE_SIZE) != 0 {
return Err(Error::Unaligned);
}
let from_address = Self::BASE as u32 + from;
let to_address = Self::BASE as u32 + to;
trace!("Erasing from 0x{:x} to 0x{:x}", from_address, to_address);
critical_section::with(|_| unsafe {
family::clear_all_err();
family::unlock();
let res = family::blocking_erase(from_address, to_address);
family::lock();
res
})
}
}
#[derive(Debug, Copy, Clone, PartialEq, Eq)] #[derive(Debug, Copy, Clone, PartialEq, Eq)]
#[cfg_attr(feature = "defmt", derive(defmt::Format))] #[cfg_attr(feature = "defmt", derive(defmt::Format))]
pub enum Error { pub enum Error {
@ -97,10 +163,6 @@ pub enum Error {
Parallelism, Parallelism,
} }
impl<'d> ErrorType for Flash<'d> {
type Error = Error;
}
impl NorFlashError for Error { impl NorFlashError for Error {
fn kind(&self) -> NorFlashErrorKind { fn kind(&self) -> NorFlashErrorKind {
match self { match self {
@ -111,21 +173,27 @@ impl NorFlashError for Error {
} }
} }
impl<'d> ReadNorFlash for Flash<'d> { foreach_flash_region! {
const READ_SIZE: usize = WRITE_SIZE; ($name:ident) => {
impl ErrorType for crate::_generated::flash_regions::$name {
type Error = Error;
}
impl ReadNorFlash for crate::_generated::flash_regions::$name {
const READ_SIZE: usize = <crate::_generated::flash_regions::$name as FlashRegion>::WRITE_SIZE;
fn read(&mut self, offset: u32, bytes: &mut [u8]) -> Result<(), Self::Error> { fn read(&mut self, offset: u32, bytes: &mut [u8]) -> Result<(), Self::Error> {
self.blocking_read(offset, bytes) self.blocking_read(offset, bytes)
} }
fn capacity(&self) -> usize { fn capacity(&self) -> usize {
FLASH_SIZE <crate::_generated::flash_regions::$name as FlashRegion>::SIZE
}
} }
}
impl<'d> NorFlash for Flash<'d> { impl NorFlash for crate::_generated::flash_regions::$name {
const WRITE_SIZE: usize = WRITE_SIZE; const WRITE_SIZE: usize = <crate::_generated::flash_regions::$name as FlashRegion>::WRITE_SIZE;
const ERASE_SIZE: usize = ERASE_SIZE; const ERASE_SIZE: usize = <crate::_generated::flash_regions::$name as FlashRegion>::ERASE_SIZE;
fn erase(&mut self, from: u32, to: u32) -> Result<(), Self::Error> { fn erase(&mut self, from: u32, to: u32) -> Result<(), Self::Error> {
self.blocking_erase(from, to) self.blocking_erase(from, to)
@ -134,4 +202,6 @@ impl<'d> NorFlash for Flash<'d> {
fn write(&mut self, offset: u32, bytes: &[u8]) -> Result<(), Self::Error> { fn write(&mut self, offset: u32, bytes: &[u8]) -> Result<(), Self::Error> {
self.blocking_write(offset, bytes) self.blocking_write(offset, bytes)
} }
}
};
} }