Enum WirelessNetCtl 

pub enum WirelessNetCtl<'a, Q> {
    Commissioning(NetworkType),
    Operational(&'a Q),
}

A composite wireless network controller that is the SAME concrete type during both the (BLE) commissioning phase and the operational (Thread/Wifi) phase.

This exists purely to avoid building two structurally-different Matter handler chains per device. InteractionModel::handle and every generated cluster handler adaptor are monomorphized over the whole handler-chain tuple type; if the net-ctl slot has a different type per phase, the entire dispatch tree is compiled twice (~tens of KiB of duplicated .text on embedded targets).

By using WirelessNetCtl<Q> in both phases — Commissioning before the operational controller exists, Operational(&Q) afterwards — the chain type is identical across phases and the dispatch tree monomorphizes once.

The Commissioning variant reproduces the behavior of the former NoopWirelessNetCtl: scan errors with InvalidAction, connect only checks the creds match the network type, and every diag returns its default. The Operational variant delegates to the real controller Q.

Q is named identically at every phase via the wireless driver’s associated net-ctl type (see the Thread/Gatt driver traits), so even the commissioning phase — which has no controller value — can still name the type.

Variants

Commissioning(NetworkType)

Commissioning phase: no operational controller yet (BLE only).

Operational(&'a Q)

Operational phase: delegate to the real controller.

Trait Implementations

impl<Q> DynBase for WirelessNetCtl<'_, Q>

Available on non-crate feature sync-mutex only.

impl<Q> NetChangeNotif for WirelessNetCtl<'_, Q>

where Q: NetChangeNotif,

async fn wait_changed(&self)

Wait until a change occurs.

impl<Q> NetCtl for WirelessNetCtl<'_, Q>

where Q: NetCtl,

fn net_type(&self) -> NetworkType

Return the network type of the implementation

fn connect_max_time_seconds(&self) -> u8

Return the maximum time in seconds for connecting to a network

fn scan_max_time_seconds(&self) -> u8

Return the maximum time in seconds for scanning for networks

fn supported_wifi_bands<F>(&self, f: F) -> Result<(), Error>

where F: FnMut(WiFiBandEnum) -> Result<(), Error>,

Return the supported WiFi bands for the implementation in the provided closure

fn supported_thread_features(&self) -> ThreadCapabilitiesBitmap

Return the supported Thread features for the implementation

fn thread_version(&self) -> u16

Return the Thread version for the implementation

async fn scan<F>(&self, network: Option<&[u8]>, f: F) -> Result<(), NetCtlError>

where F: FnMut(&NetworkScanInfo<'_>) -> Result<(), Error>,

Scan for networks and call the provided function for each network found

async fn connect(&self, creds: &WirelessCreds<'_>) -> Result<(), NetCtlError>

Connect to the network with the given credentials

impl<Q> ThreadDiag for WirelessNetCtl<'_, Q>

where Q: ThreadDiag,

fn channel(&self) -> Result<Option<u16>, Error>

fn routing_role(&self) -> Result<Option<RoutingRoleEnum>, Error>

fn network_name( &self, f: &mut dyn FnMut(Option<&str>) -> Result<(), Error>, ) -> Result<(), Error>

fn pan_id(&self) -> Result<Option<u16>, Error>

fn extended_pan_id(&self) -> Result<Option<u64>, Error>

fn mesh_local_prefix( &self, f: &mut dyn FnMut(Option<&[u8]>) -> Result<(), Error>, ) -> Result<(), Error>

fn neighbor_table( &self, f: &mut dyn FnMut(&NeighborTable) -> Result<(), Error>, ) -> Result<(), Error>

fn route_table( &self, f: &mut dyn FnMut(&RouteTable) -> Result<(), Error>, ) -> Result<(), Error>

fn partition_id(&self) -> Result<Option<u32>, Error>

fn weighting(&self) -> Result<Option<u16>, Error>

fn data_version(&self) -> Result<Option<u16>, Error>

fn stable_data_version(&self) -> Result<Option<u16>, Error>

fn leader_router_id(&self) -> Result<Option<u8>, Error>

fn ext_address(&self) -> Result<Option<u64>, Error>

fn rloc_16(&self) -> Result<Option<u16>, Error>

fn security_policy(&self) -> Result<Option<SecurityPolicy>, Error>

fn channel_page0_mask( &self, f: &mut dyn FnMut(Option<&[u8]>) -> Result<(), Error>, ) -> Result<(), Error>

fn operational_dataset_components( &self, f: &mut dyn FnMut(Option<&OperationalDatasetComponents>) -> Result<(), Error>, ) -> Result<(), Error>

fn active_network_faults_list( &self, f: &mut dyn FnMut(NetworkFaultEnum) -> Result<(), Error>, ) -> Result<(), Error>

fn mac_counters( &self, f: &mut dyn FnMut(Option<&MacCounters>) -> Result<(), Error>, ) -> Result<(), Error>

Lend a snapshot of the IEEE 802.15.4 MAC counters (the cluster’s MACCounts feature set) to the provided closure, or call it with None if the backend does not track them - in which case the corresponding attributes read as unsupported.

impl<Q> WifiDiag for WirelessNetCtl<'_, Q>

where Q: WifiDiag,

fn bssid( &self, f: &mut dyn FnMut(Option<&[u8]>) -> Result<(), Error>, ) -> Result<(), Error>

fn security_type(&self) -> Result<Nullable<SecurityTypeEnum>, Error>

fn wi_fi_version(&self) -> Result<Nullable<WiFiVersionEnum>, Error>

fn channel_number(&self) -> Result<Nullable<u16>, Error>

fn rssi(&self) -> Result<Nullable<i8>, Error>

impl<Q> WirelessDiag for WirelessNetCtl<'_, Q>

where Q: WirelessDiag,

fn connected(&self) -> Result<bool, Error>

Returns true if the device is connected to a wireless network