Matter Cluster 1105 — Wi-Fi Network Management Cluster

Cluster Identity

Revision history

Shadow Path Format

Cluster 1105 values in the device shadow use this format:

endpoint_id / 1105 / attribute_id

Example:

{
  "1/1105/0": "AQID"
}

Cluster 1105 Attributes

Cluster 1105 defines 2 attributes plus the global attributes. Conformance: M mandatory, O optional, a feature code means "mandatory when that feature is present", square brackets mean "optional when …".

Global attributes

Attribute Details

Attribute 0 / 0x0000 — SSID

Path example:

1/1105/0

No condensed specification text is available for SSID; use the type, conformance and constraint below together with the cluster description above.

Example:

{
  "1/1105/0": "AQID"
}

Attribute 1 / 0x0001 — PassphraseSurrogate

Path example:

1/1105/1

This attribute contains an arbitrary numeric value; this value must increase whenever the passphrase or PSK associated with the primary Wi-Fi network provided by this device changes. A value of null indicates that no primary Wi-Fi network is available. Clients can subscribe to this attribute or compare its value to a locally cached copy to detect if a cached passphrase value has become stale. It is recommended that servers implement this attribute as either a timestamp or a counter.

Example:

{
  "1/1105/1": 1
}

Cluster 1105 Commands

Cluster 1105 has 1 client-to-server command and 1 response.

AcceptedCommandList

The AcceptedCommandList attribute lists the command IDs the endpoint actually implements:

endpoint_id / 1105 / 65529

{
  "1/1105/65529": [
    0
  ]
}

Bridge Command Payload Format

The bridge accepts Matter commands in this structure:

{
  "message_id": "1",
  "command": "device_command",
  "args": {
    "endpoint_id": 1,
    "cluster_id": 1105,
    "command_name": "NetworkPassphraseRequest",
    "payload": {},
    "timed_request_timeout_ms": 1000
  }
}

For Cluster 1105, always use "cluster_id": 1105. Payload keys are the command field names in lowerCamelCase. Octet-string fields are base64-encoded. timed_request_timeout_ms is required for timed commands and ignored otherwise.

Command: NetworkPassphraseRequest

Purpose

This command is used to request the current WPA-Personal passphrase or PSK associated with the Wi-Fi network provided by this device. If the command is not executed via a CASE session, the command is rejected with a status of UNSUPPORTED_ACCESS. If no primary Wi-Fi network is available (the SSID attribute is null), the command is rejected with a status of INVALID_IN_STATE. Otherwise a NetworkPassphraseResponse is generated.

Command Identity

Payload Fields

This command has no payload fields.

Bridge Command Example

{
  "message_id": "1",
  "command": "device_command",
  "args": {
    "endpoint_id": 1,
    "cluster_id": 1105,
    "command_name": "NetworkPassphraseRequest",
    "payload": {}
  }
}

The device answers with NetworkPassphraseResponse (see below).

Command: NetworkPassphraseResponse

Purpose

This command is generated in response to a NetworkPassphraseRequest command.

Command Identity

Response Fields

Cluster 1105 Events

Cluster 1105 defines no events.

SmartphoneKey Notes

• Cluster 1105 is not currently exposed by SmartphoneKey devices. This page documents the Matter 1.6.1 specification so that future devices can be interpreted without changes to the backend.
• Shadow paths follow endpoint/1105/attribute; attribute values that the device reports as unreadable are written as n/a.
• Attribute IDs, command IDs and enum values on this page come from the CSA Matter 1.6.1 data model; descriptions are condensed from the specification text.