Struct Binding 

pub struct Binding {
    pub local_endpoint: u16,
    pub fab_idx: NonZero<u8>,
    pub node: Option<u64>,
    pub group: Option<u16>,
    pub endpoint: Option<u16>,
    pub cluster: Option<u32>,
}

One binding entry: the local endpoint it is attached to, the fabric it belongs to, and the destination it points at.

This is the single entry type used for storage, persistence, and the application-facing read API (Bindings::get). Application code that acts on the device’s bindings (e.g. a switch reading its binding list to decide which node(s) to send a command to) receives it cloned, so the registry lock is never held across the await of the subsequent remote invoke. It is small but not trivially Copy, hence Clone.

local_endpoint is this device’s endpoint that hosts the binding — not to be confused with the remote target’s endpoint. A unicast target has both node and endpoint set (cluster optional); a groupcast target has group set instead. The destination fields mirror the spec’s TargetStruct.

Wire layout follows the standard derive(FromTLV, ToTLV) shape — a TLV struct with positional context-tagged fields. Option<T> fields are omit-if-None. The encoding is decoupled from the wire-level TargetStruct (which puts FabricIndex at ctx 254): we own the persisted layout and only need it to be self-consistent.

Fields

local_endpoint: u16

The local endpoint this binding is attached to.

fab_idx: NonZero<u8>

The fabric this binding belongs to.

node: Option<u64>

The remote node id (set for a unicast target).

group: Option<u16>

The group id (set for a groupcast target).

endpoint: Option<u16>

The remote endpoint (set for a unicast target).

cluster: Option<u32>

The cluster to address (optional).

Trait Implementations

impl Clone for Binding

fn clone(&self) -> Binding

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Binding

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

Formats the value using the given formatter.

impl<'__from_tlv> FromTLV<'__from_tlv> for Binding

fn from_tlv(element: &TLVElement<'__from_tlv>) -> Result<Binding, Error>

Deserialize the type from a TLV-encoded element.

fn init_from_tlv(element: TLVElement<'__from_tlv>) -> impl Init<Binding, Error>

Generate an in-place initializer for the type that initializes the type from a TLV-encoded element.

fn nullable_from_tlv(element: &TLVElement<'a>) -> Result<Self, Error>

Deserialize the type from a TLV-encoded element.

fn init_nullable_from_tlv(element: TLVElement<'a>) -> impl Init<Self, Error>

Generate an in-place initializer for the type that initializes the type from a TLV-encoded element.

impl ToTLV for Binding

fn to_tlv<W>(&self, tag: &TLVTag, tw: W) -> Result<(), Error>

where W: TLVWrite,

Serialize the type to a TLV-encoded stream.

fn tlv_iter(&self, tag: TLVTag) -> impl Iterator<Item = Result<TLV<'_>, Error>>

Serialize the type as an iterator of TLV instances by potentially borrowing data from the type.

fn nullable_to_tlv<W>(&self, tag: &TLVTag, tw: W) -> Result<(), Error>

where W: TLVWrite,

Serialize the type to a TLV-encoded stream.

fn nullable_tlv_iter( &self, tag: TLVTag, ) -> impl Iterator<Item = Result<TLV<'_>, Error>>

Serialize the type as an iterator of TLV instances by potentially borrowing data from the type.

impl<'__from_tlv> TryFrom<&TLVElement<'__from_tlv>> for Binding

type Error = Error

The type returned in the event of a conversion error.

fn try_from( element: &TLVElement<'__from_tlv>, ) -> Result<Binding, <Binding as TryFrom<&TLVElement<'__from_tlv>>>::Error>

Performs the conversion.