Enum lpc55::secure_binary::command::BootCommandSequenceDescription

pub enum BootCommandSequenceDescription {
    UploadSignedImage,
    CheckDerivedFirmwareVersions,
}

High level commands that lpc55 will convert safely into commands used to define SB2.1 files

Example

[[commands]]
seq = "UploadImage"
image = "Signed"

Variants

UploadSignedImage

Takes the filename specified in image from config.firmware, pads to 512B if necessary, erases flash, then uploads securely (all but first block, only then the first block).

CheckDerivedFirmwareVersions

Takes the version specified in config.firmware.product and checks that it is greater than or equal to both the “Secure” and “Nonsecure” firmware versions in the customer data page on the device.

This uses an interpretation and encoding of the [u16; 3] Version as an incrementing u32 counter. Namely, major version is interpreted as an era (signaling breaking changes) and restricted to below 1024. Minor version is interpreted as days since the twenties (unrestricted for practical purposes). Patch version is restricted to below 64, and would rarely be used.

So, for instance, 1:20210520 would correspond to 1.505.0, since (dt.date(2021, 5, 20) - dt.date(2020, 1, 1)).days = 505, and map to the counter (1 << 22) + (505 << 6) = 4226624.

If the check fails, then the SB2 update stops.

Trait Implementations

impl Clone for BootCommandSequenceDescription

fn clone(&self) -> BootCommandSequenceDescription

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for BootCommandSequenceDescription

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BootCommandSequenceDescription

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
    __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq<BootCommandSequenceDescription> for BootCommandSequenceDescription

fn eq(&self, other: &BootCommandSequenceDescription) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for BootCommandSequenceDescription

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>where
    __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for BootCommandSequenceDescription

impl StructuralEq for BootCommandSequenceDescription

impl StructuralPartialEq for BootCommandSequenceDescription