embassy-boot

Crates

git

Versions

default

Flavors

embassy_boot

Struct BlockingFirmwareUpdater

source
pub struct BlockingFirmwareUpdater<'d, DFU: NorFlash, STATE: NorFlash> { /* private fields */ }
Expand description

Blocking FirmwareUpdater is an application API for interacting with the BootLoader without the ability to ‘mess up’ the internal bootloader state

Implementations§

source§

impl<'d, DFU: NorFlash, STATE: NorFlash> BlockingFirmwareUpdater<'d, DFU, STATE>

source

pub fn new( config: FirmwareUpdaterConfig<DFU, STATE>, aligned: &'d mut [u8], ) -> Self

Create a firmware updater instance with partition ranges for the update and state partitions.

§Safety

The aligned buffer must have a size of STATE::WRITE_SIZE, and follow the alignment rules for the flash being read from and written to.

source

pub fn get_state(&mut self) -> Result<State, FirmwareUpdaterError>

Obtain the current state.

This is useful to check if the bootloader has just done a swap, in order to do verifications and self-tests of the new image before calling mark_booted.

source

pub fn hash<D: Digest>( &mut self, update_len: u32, chunk_buf: &mut [u8], output: &mut [u8], ) -> Result<(), FirmwareUpdaterError>

Verify the update in DFU with any digest.

source

pub fn mark_updated(&mut self) -> Result<(), FirmwareUpdaterError>

Mark to trigger firmware swap on next boot.

source

pub fn mark_dfu(&mut self) -> Result<(), FirmwareUpdaterError>

Mark to trigger USB DFU device on next boot.

source

pub fn mark_booted(&mut self) -> Result<(), FirmwareUpdaterError>

Mark firmware boot successful and stop rollback on reset.

source

pub fn write_firmware( &mut self, offset: usize, data: &[u8], ) -> Result<(), FirmwareUpdaterError>

Writes firmware data to the device.

This function writes the given data to the firmware area starting at the specified offset. It handles sector erasures and data writes while verifying the device is in a proper state for firmware updates. The function ensures that only unerased sectors are erased before writing and efficiently handles the writing process across sector boundaries and in various configurations (data size, sector size, etc.).

§Arguments
  • offset - The starting offset within the firmware area where data writing should begin.
  • data - A slice of bytes representing the firmware data to be written. It must be a multiple of NorFlash WRITE_SIZE.
§Returns

A Result<(), FirmwareUpdaterError> indicating the success or failure of the write operation.

§Errors

This function will return an error if:

  • The device is not in a proper state to receive firmware updates (e.g., not booted).
  • There is a failure erasing a sector before writing.
  • There is a failure writing data to the device.
source

pub fn prepare_update(&mut self) -> Result<&mut DFU, FirmwareUpdaterError>

Prepare for an incoming DFU update by erasing the entire DFU area and returning its Partition.

Using this instead of write_firmware allows for an optimized API in exchange for added complexity.

Auto Trait Implementations§

§

impl<'d, DFU, STATE> Freeze for BlockingFirmwareUpdater<'d, DFU, STATE>
where DFU: Freeze, STATE: Freeze,

§

impl<'d, DFU, STATE> RefUnwindSafe for BlockingFirmwareUpdater<'d, DFU, STATE>
where DFU: RefUnwindSafe, STATE: RefUnwindSafe,

§

impl<'d, DFU, STATE> Send for BlockingFirmwareUpdater<'d, DFU, STATE>
where DFU: Send, STATE: Send,

§

impl<'d, DFU, STATE> Sync for BlockingFirmwareUpdater<'d, DFU, STATE>
where DFU: Sync, STATE: Sync,

§

impl<'d, DFU, STATE> Unpin for BlockingFirmwareUpdater<'d, DFU, STATE>
where DFU: Unpin, STATE: Unpin,

§

impl<'d, DFU, STATE> !UnwindSafe for BlockingFirmwareUpdater<'d, DFU, STATE>

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> Same for T

source§

type Output = T

Should always be Self
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

source§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.