Before generating a ConnectNetworkResponse, the server shall:

• Set the LastNetworkingStatus attribute value to the NetworkingStatus matching the response.

• Set the LastNetworkID attribute value to the NetworkID that was used in the ConnectNetwork command which caused the response to be generated.

• Set the LastConnectErrorValue attribute value to the ErrorValue matching the response, including setting it to null if the ErrorValue is not applicable.

MatterSpecification.v13.Core § 11.9.7.9

interface ConnectNetworkResponse {
    debugText?: string;
    errorValue: null | number;
    networkingStatus: NetworkCommissioning.NetworkCommissioningStatus;
}

Hierarchy (view full)

Properties

debugText?: string

See Section 11.9.7.2.2, “DebugText Field” for usage.

MatterSpecification.v13.Core § 11.9.7.9.2

errorValue: null | number

• ErrorValue interpretation for Wi-Fi association errors:

◦ On any association failure during enabling of a network, the ErrorValue field shall be set to the
  Status Code value that was present in the last frame related to association where Status Code was not
  equal to zero and which caused the failure of a final retry attempt, if this final failure was due to
  one of the following Management frames:

  ▪ Association Response (Type 0, Subtype 1)

  ▪ Reassociation Response (Type 0, Subtype 3)

  ▪ Authentication (Type 0, Subtype 11)

◦ Table 9-50 "Status Codes" in IEEE 802.11-2020 contains a description of all values possible, which can
  unambiguously be used to determine the cause, such as an invalid security type, unsupported rate, etc.

• Otherwise, the ErrorValue field shall contain an implementation-dependent value which may be used by a reader of the structure to record, report or diagnose the failure.

MatterSpecification.v13.Core § 11.9.7.9.3

The NetworkingStatus field shall indicate the status of the last connection attempt, taking one of these values:

• Success: Connection succeeded.

• NetworkNotFound: No instance of an explicitly-provided network identifier was found during the attempt to join the network.

• OutOfRange: Network identifier was invalid (e.g. empty, too long, etc).

• NetworkIdNotFound: The network identifier was not found among the added network configurations in Networks attribute.

• RegulatoryError: Could not connect to a network due to lack of regulatory configuration.

• UnknownError: An internal error occurred during the operation.

• Association errors (see also description of errors in Section 11.9.5.4, “NetworkCommissioningStatusEnum Type”): AuthFailure, UnsupportedSecurity, OtherConnectionFailure, IPV6Failed, IPBindFailed

MatterSpecification.v13.Core § 11.9.7.9.1