Interface State

interface State {
    interfaceEnabled: boolean;
    lastConnectErrorValue: null | number;
    lastNetworkId: null | Uint8Array;
    lastNetworkingStatus: null | NetworkCommissioning.NetworkCommissioningStatus;
    maxNetworks: number;
    networks: TypeFromFields<{
        connected: FieldType<boolean>;
        networkId: FieldType<Uint8Array>;
    }>[];
}

Hierarchy

  • StateType
    • State

Properties

interfaceEnabled lastConnectErrorValue lastNetworkId lastNetworkingStatus maxNetworks networks

Properties

ReadonlyinterfaceEnabled

interfaceEnabled: boolean

Indicates whether the associated network interface is enabled or not. By default all network interfaces SHOULD be enabled during initial commissioning (InterfaceEnabled set to true).

It is undefined what happens if InterfaceEnabled is written to false on the same interface as that which is used to write the value. In that case, it is possible that the Administrator would have to await expiry of the fail-safe, and associated recovery of network configuration to prior safe values, before being able to communicate with the node again (see Section 11.10.6.2, “ArmFailSafe Command”).

It may be possible to disable Ethernet interfaces but it is implementation-defined. If not supported, a write to this attribute with a value of false shall fail with a status of INVALID_ACTION. When disabled, an Ethernet interface would longer employ media detection. That is, a simple unplug and replug of the cable shall NOT re-enable the interface.

On Ethernet-only Nodes, there shall always be at least one of the Network Commissioning server cluster instances with InterfaceEnabled set to true.

See

MatterSpecification.v13.Core § 11.9.6.5

ReadonlylastConnectErrorValue

lastConnectErrorValue: null | number

Indicates the ErrorValue used in the last failed attempt to connect to an operational network, using this interface, whether by invocation of the ConnectNetwork command or by

autonomous connection after loss of connectivity or during initial establishment. If no such attempt was made, or no network configurations exist in the Networks attribute, then this attribute shall be set to null.

If the last connection succeeded, as indicated by a value of Success in the LastNetworkingStatus attribute, then this field shall be set to null.

This attribute is present to assist with error recovery during Network commissioning and to assist in non-concurrent networking commissioning flows.

See

MatterSpecification.v13.Core § 11.9.6.8

ReadonlylastNetworkId

lastNetworkId: null | Uint8Array

Indicates the NetworkID used in the last attempt to connect to an operational network, using this interface, whether by invocation of the ConnectNetwork command or by autonomous connection after loss of connectivity or during initial establishment. If no such attempt was made, or no network configurations exist in the Networks attribute, then this attribute shall be set to null.

If a network configuration is removed from the Networks attribute using the RemoveNetwork command after a connection attempt, this field may indicate a NetworkID that is no longer configured on the Node.

This attribute is present to assist with error recovery during Network commissioning and to assist in non-concurrent networking commissioning flows.

See

MatterSpecification.v13.Core § 11.9.6.7

ReadonlylastNetworkingStatus

lastNetworkingStatus: null | NetworkCommissioning.NetworkCommissioningStatus

Indicates the status of the last attempt either scan or connect to an operational network, using this interface, whether by invocation of the ConnectNetwork command or by autonomous connection after loss of connectivity or during initial establishment. If no such attempt was made, or no network configurations exist in the Networks attribute, then this attribute shall be set to null.

This attribute is present to assist with error recovery during Network commissioning and to assist in non-concurrent networking commissioning flows.

See

MatterSpecification.v13.Core § 11.9.6.6

ReadonlymaxNetworks

maxNetworks: number

This shall indicate the maximum number of network configuration entries that can be added, based on available device resources. The length of the Networks attribute shall be less than or equal to this value.

See

MatterSpecification.v13.Core § 11.9.6.1

Readonlynetworks

networks: TypeFromFields<{
    connected: FieldType<boolean>;
    networkId: FieldType<Uint8Array>;
}>[]

Indicates the network configurations that are usable on the network interface represented by this cluster server instance.

The order of configurations in the list reflects precedence. That is, any time the Node attempts to connect to the network it shall attempt to do so using the configurations in Networks Attribute in the order as they appear in the list.

The order of list items shall only be modified by the AddOrUpdateThreadNetwork, AddOrUpdateWiFiNetwork and ReorderNetwork commands. In other words, the list shall be stable over time, unless mutated externally.

Ethernet networks shall be automatically populated by the cluster server. Ethernet Network Commissioning Cluster instances shall always have exactly one NetworkInfoStruct instance in their Networks attribute. There shall be no way to add, update or remove Ethernet network configurations to those Cluster instances.

See

MatterSpecification.v13.Core § 11.9.6.2

Settings

Member Visibility

On This Page

Properties