Skip to main content

SetupPayload

Struct SetupPayload 

Source
pub struct SetupPayload {
    pub version: u8,
    pub vendor_id: Option<u16>,
    pub product_id: Option<u16>,
    pub commissioning_flow: CommissioningFlow,
    pub discovery_capabilities: DiscoveryCapabilities,
    pub discriminator: Discriminator,
    pub passcode: Passcode,
}
Expand description

The decoded contents of a Matter onboarding payload (QR code or manual pairing code), as defined in Matter Core Spec §5.1.3.

Roundtrip identities:

// For every valid `p` produced by M6.1:
assert_eq!(parse_qr(&encode_qr(&p)?)?, p);
assert_eq!(parse_manual_code(&encode_manual_code(&p)), p);  // see caveat below

The manual-code roundtrip preserves the upper four bits of the discriminator (the short discriminator) and zero-extends the rest. A SetupPayload decoded from a manual code therefore has a discriminator whose lower 8 bits are zero, regardless of what the physical device’s long discriminator actually is. Callers matching against mDNS records should compare on the short discriminator in that case.

Fields§

§version: u8

Onboarding payload version. Currently always 0 (Matter Core Spec §5.1.3.1 Table 39). Reserved for future use.

§vendor_id: Option<u16>

Vendor ID. None if the source was an 11-digit manual code, which does not carry VID/PID.

§product_id: Option<u16>

Product ID. Pair with vendor_id — both are Some or both None.

§commissioning_flow: CommissioningFlow

Commissioning flow indicator.

§discovery_capabilities: DiscoveryCapabilities

Bitmask of discovery transports the device supports while commissionable. Always present in QR codes; manual codes do not carry this field and decode it as the empty set.

§discriminator: Discriminator

12-bit Long Discriminator. See the type-level rustdoc for the manual-code caveat.

§passcode: Passcode

27-bit passcode.

Trait Implementations§

Source§

impl Clone for SetupPayload

Source§

fn clone(&self) -> SetupPayload

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for SetupPayload

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Eq for SetupPayload

Source§

impl PartialEq for SetupPayload

Source§

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

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more
Source§

impl StructuralPartialEq for SetupPayload

Auto Trait Implementations§

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<'a, T, E> AsTaggedExplicit<'a, E> for T
where T: 'a,

Source§

fn explicit(self, class: Class, tag: u32) -> TaggedParser<'a, Explicit, Self, E>

Source§

impl<'a, T, E> AsTaggedImplicit<'a, E> for T
where T: 'a,

Source§

fn implicit( self, class: Class, constructed: bool, tag: u32, ) -> TaggedParser<'a, Implicit, Self, E>

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> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. 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> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
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.