Struct Flash

pub struct Flash {
    pub regs: FLASH,
}

Fields

regs: FLASH

Implementations

impl Flash

pub fn unlock(&mut self) -> Result<()>

Unlock the flash memory, allowing writes. See L4 Reference manual, section 3.3.5. (G4 RM section 5.3.5) “After reset, write is not allowed in the Flash control register (FLASH_CR) to protect the Flash memory against possible unwanted operations due, for example, to electric disturbances.”

pub fn lock(&mut self) -> Result<()>

pub fn erase_page(&mut self, bank: Bank, page: usize) -> Result<()>

Erase an entire page. See L4 Reference manual, section 3.3.5. For why this is required, reference L4 RM, section 3.3.7: “Programming in a previously programmed address is not allowed except if the data to write is full zero, and any attempt will set PROGERR flag in the Flash status register (FLASH_SR).”

pub fn erase_bank(&mut self, bank: Bank) -> Result<()>

Erase one or both banks. Called “Mass erase” on single-bank variants like G4.

pub fn write_page(&mut self, bank: Bank, page: usize, data: &[u8]) -> Result<()>

Write the contents of a page. Must be erased first. See L4 RM, section 3.3.7. Make sure the page is one your MCU has, and isn’t being used for the program itself.

pub fn erase_write_page( &mut self, bank: Bank, page: usize, data: &[u8], ) -> Result<()>

Erase a page, then write to it.

impl Flash

Contains code common to both modules.

pub fn new(regs: FLASH) -> Self

Create a struct used to perform operations on Flash.

pub fn read(&self, bank: Bank, page: usize, offset: usize, buf: &mut [u8])

Read flash memory at a given page and offset into an 8-bit-dword buffer.