Struct lpc55::protected_flash::FactorySettings

pub struct FactorySettings<CustomerData = RawCustomerData, VendorUsage = RawVendorUsage>where
    CustomerData: FactorySettingsCustomerData,
    VendorUsage: FactorySettingsVendorUsage,{
    pub boot_configuration: BootConfiguration,
    pub usb_id: UsbId,
    pub debug_access: DebugAccess,
    pub vendor_usage: VendorUsage,
    pub secure_boot_configuration: SecureBootConfiguration,
    pub prince_configuration: PrinceConfiguration,
    pub prince_subregions: [PrinceSubregion; 3],
    pub rot_fingerprint: Sha256Hash,
    pub customer_data: CustomerData,
    pub seal: bool,
    /* private fields */
}

Fields

boot_configuration: BootConfiguration

usb_id: UsbId

debug_access: DebugAccess

vendor_usage: VendorUsage

secure_boot_configuration: SecureBootConfiguration

prince_configuration: PrinceConfiguration

prince_subregions: [PrinceSubregion; 3]

rot_fingerprint: Sha256Hash

Fingerprint of allowed root certificates for signed firmware update process.

Called “ROTKH” for “root of trust key table hash” in vendor documentation.

There can be up to four root certificate authorities; each have a “fingerprint” (cf. elsewhere), the fingerprint here is the SHA256 hash of the concatenation of these fingerprints. Due to this construction, each SB2.1 firmware container needs to contain all the root certificates (plus possibly a certificate chain to the authority actually signing the firmware).

customer_data: CustomerData

224 bytes that the customer can use.

seal: bool

Setting this to true will calculate the SHA256 automatically for sha256_hash.

Implementations

impl<CustomerData, VendorUsage> FactorySettings<CustomerData, VendorUsage>where
    CustomerData: FactorySettingsCustomerData,
    VendorUsage: FactorySettingsVendorUsage,

pub fn to_bytes(&mut self) -> Result<[u8; 512]>

Trait Implementations

impl<CustomerData: Clone, VendorUsage: Clone> Clone for FactorySettings<CustomerData, VendorUsage>where
    CustomerData: FactorySettingsCustomerData,
    VendorUsage: FactorySettingsVendorUsage,

fn clone(&self) -> FactorySettings<CustomerData, VendorUsage>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<CustomerData: Debug, VendorUsage: Debug> Debug for FactorySettings<CustomerData, VendorUsage>where
    CustomerData: FactorySettingsCustomerData,
    VendorUsage: FactorySettingsVendorUsage,

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

Formats the value using the given formatter.

impl<CustomerData: Default, VendorUsage: Default> Default for FactorySettings<CustomerData, VendorUsage>where
    CustomerData: FactorySettingsCustomerData,
    VendorUsage: FactorySettingsVendorUsage,

fn default() -> FactorySettings<CustomerData, VendorUsage>

Returns the “default value” for a type.

impl<'de, CustomerData, VendorUsage> Deserialize<'de> for FactorySettings<CustomerData, VendorUsage>where
    CustomerData: FactorySettingsCustomerData,
    VendorUsage: FactorySettingsVendorUsage,
    CustomerData: Deserialize<'de>,
    VendorUsage: Deserialize<'de>,
    CustomerData: Default,
    VendorUsage: Default,

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

Deserialize this value from the given Serde deserializer.

impl<CustomerData: Hash, VendorUsage: Hash> Hash for FactorySettings<CustomerData, VendorUsage>where
    CustomerData: FactorySettingsCustomerData,
    VendorUsage: FactorySettingsVendorUsage,

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where
    H: Hasher,
    Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<CustomerData: Ord, VendorUsage: Ord> Ord for FactorySettings<CustomerData, VendorUsage>where
    CustomerData: FactorySettingsCustomerData,
    VendorUsage: FactorySettingsVendorUsage,

fn cmp(&self, other: &FactorySettings<CustomerData, VendorUsage>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Selfwhere
    Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Selfwhere
    Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Selfwhere
    Self: Sized + PartialOrd<Self>,

Restrict a value to a certain interval.

impl<CustomerData: PartialEq, VendorUsage: PartialEq> PartialEq<FactorySettings<CustomerData, VendorUsage>> for FactorySettings<CustomerData, VendorUsage>where
    CustomerData: FactorySettingsCustomerData,
    VendorUsage: FactorySettingsVendorUsage,

fn eq(&self, other: &FactorySettings<CustomerData, VendorUsage>) -> 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<CustomerData: PartialOrd, VendorUsage: PartialOrd> PartialOrd<FactorySettings<CustomerData, VendorUsage>> for FactorySettings<CustomerData, VendorUsage>where
    CustomerData: FactorySettingsCustomerData,
    VendorUsage: FactorySettingsVendorUsage,

fn partial_cmp(
    &self,
    other: &FactorySettings<CustomerData, VendorUsage>
) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

This method tests less than (for self and other) and is used by the < operator.

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

This method tests less than or equal to (for self and other) and is used by the <= operator.

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

This method tests greater than (for self and other) and is used by the > operator.

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

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<CustomerData, VendorUsage> Serialize for FactorySettings<CustomerData, VendorUsage>where
    CustomerData: FactorySettingsCustomerData,
    VendorUsage: FactorySettingsVendorUsage,
    CustomerData: Serialize,
    VendorUsage: Serialize,

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

Serialize this value into the given Serde serializer.

impl<CustomerData, VendorUsage> TryFrom<&[u8]> for FactorySettings<CustomerData, VendorUsage>where
    CustomerData: FactorySettingsCustomerData,
    VendorUsage: FactorySettingsVendorUsage,

type Error = ()

The type returned in the event of a conversion error.

fn try_from(input: &[u8]) -> Result<Self, Self::Error>

Performs the conversion.

impl<CustomerData: Copy, VendorUsage: Copy> Copy for FactorySettings<CustomerData, VendorUsage>where
    CustomerData: FactorySettingsCustomerData,
    VendorUsage: FactorySettingsVendorUsage,

impl<CustomerData: Eq, VendorUsage: Eq> Eq for FactorySettings<CustomerData, VendorUsage>where
    CustomerData: FactorySettingsCustomerData,
    VendorUsage: FactorySettingsVendorUsage,

impl<CustomerData, VendorUsage> StructuralEq for FactorySettings<CustomerData, VendorUsage>where
    CustomerData: FactorySettingsCustomerData,
    VendorUsage: FactorySettingsVendorUsage,

impl<CustomerData, VendorUsage> StructuralPartialEq for FactorySettings<CustomerData, VendorUsage>where
    CustomerData: FactorySettingsCustomerData,
    VendorUsage: FactorySettingsVendorUsage,