Matter Bridge Clusters — Detailed Attribute and Functionality Reference

This document describes cluster information only for the Matter bridge data, with one separate note for device types that are important for bridge interpretation.

1. Common Matter Clusters

These clusters are common Matter clusters. They are not unique to a Matter bridge, although a bridge uses some of them heavily.

Cluster 3 — Identify

Decimal Cluster: 3
Name: Identify

Description

Allows a device or endpoint to enter identification mode.

Typical behavior:

• Blink.
• Beep.
• Show an indicator.
• Mark a device as currently being identified.

This is used by controllers to help the user locate a physical device or endpoint.

Important Values Inside Cluster

Functionality

Use for physical/logical identification only.
Do not use as normal runtime state.

Cluster 4 — Groups

Decimal Cluster: 4
Name: Groups

Description

Allows endpoints to be added to Matter groups.

A group lets a controller send one command to multiple endpoints.

Example:

• Turn off all grouped lights.
• Send one command to multiple relays.
• Group multiple endpoints for shared control.

Important Values Inside Cluster

Functionality

Use for group command routing.
Do not create a separate device because this cluster exists.

Cluster 29 — Descriptor

Decimal Cluster: 29
Name: Descriptor

Description

Describes the endpoint structure of the Matter node.

This cluster is common Matter, but it is critical for bridge/gateway parsing because it exposes how the bridge is composed.

Important Values Inside Cluster

Functionality

Use this cluster to build the endpoint tree.

For a bridge, this is used to discover:

• Root node composition.
• Aggregator endpoint.
• Bridged child endpoints.
• Sub-endpoints of composed devices.

Cluster 31 — Access Control

Decimal Cluster: 31
Name: Access Control

Description

Manages Matter fabric permissions.

This cluster defines which fabric subjects can access which endpoints, clusters, and commands.

Important Values Inside Cluster

Functionality

Use for security and fabric permissions.
Do not expose as normal device state.

Cluster 40 — Basic Information

Decimal Cluster: 40
Name: Basic Information

Description

Describes the native Matter node itself.

For a Matter bridge, this cluster describes the gateway/bridge device, not each bridged child device.

Bridged child devices use cluster 57, Bridged Device Basic Information.

Important Values Inside Cluster

Functionality

Use for bridge/gateway identity:

{
  vendorName: string,
  vendorId: number,
  productName: string,
  productId: number,
  softwareVersion: string,
  serialNumber: string,
  uniqueId: string
}

Do not use this cluster to identify bridged child devices.

Cluster 41 — OTA Software Update Provider

Decimal Cluster: 41
Name: OTA Software Update Provider

Description

Allows a Matter node to provide OTA software update images to other Matter nodes.

Important Values Inside Cluster

Functionality

Use for OTA-provider behavior only.
Not normal runtime device state.

Cluster 42 — OTA Software Update Requestor

Decimal Cluster: 42
Name: OTA Software Update Requestor

Description

Allows the node to check for, download, and apply OTA updates.

For a bridge, this normally applies to the bridge gateway itself.

Important Values Inside Cluster

Functionality

Use for firmware update state of the Matter node.

Cluster 43 — Localization Configuration

Decimal Cluster: 43
Name: Localization Configuration

Description

Controls active and supported locale configuration.

Important Values Inside Cluster

Functionality

Use for localization settings.

Cluster 44 — Time Format Localization

Decimal Cluster: 44
Name: Time Format Localization

Description

Defines user-facing time format and calendar preferences.

Important Values Inside Cluster

Functionality

Use for localized time/calendar display behavior.

Cluster 46 — Power Source Configuration

Decimal Cluster: 46
Name: Power Source Configuration

Description

Associates a node or endpoint with one or more power-source endpoints.

Important Values Inside Cluster

Functionality

Use to locate which endpoint contains power/battery data.

Cluster 47 — Power Source

Decimal Cluster: 47
Name: Power Source

Description

Describes battery, wired power, charging, replacement, or backup power state.

This cluster can be common infrastructure and also device-specific runtime information for battery-powered child devices.

Important Values Inside Cluster

Functionality

Normalize to values such as:

{
  batteryPercent: number | null,
  batteryVoltageMv: number | null,
  batteryReplacementNeeded: boolean,
  powerSource: "battery" | "wired" | "unknown"
}

Cluster 48 — General Commissioning

Decimal Cluster: 48
Name: General Commissioning

Description

Handles Matter commissioning state and commissioning failsafe behavior.

Important Values Inside Cluster

Functionality

Use during commissioning only.

Cluster 49 — Network Commissioning

Decimal Cluster: 49
Name: Network Commissioning

Description

Manages network credentials and connection configuration for supported network interfaces.

Important Values Inside Cluster

Functionality

Use for gateway network setup and diagnostics.
Do not use for child-device availability.

Cluster 51 — General Diagnostics

Decimal Cluster: 51
Name: General Diagnostics

Description

Provides general diagnostic and network-interface information.

Important Values Inside Cluster

Functionality

Use for gateway diagnostics:

{
  uptime: number,
  rebootCount: number,
  networkInterfaces: unknown[],
  activeFaults: unknown[]
}

Cluster 60 — Administrator Commissioning

Decimal Cluster: 60
Name: Administrator Commissioning

Description

Controls opening and closing commissioning windows.

This is used when adding a Matter node to another fabric or administrator.

Important Values Inside Cluster

Functionality

Use for pairing and multi-admin commissioning flows.

Cluster 62 — Operational Credentials

Decimal Cluster: 62
Name: Operational Credentials

Description

Manages Matter operational identity and fabric credentials.

This cluster handles:

• Node Operational Certificates.
• Trusted roots.
• Fabric table.
• Current fabric index.
• CASE operational identity.

Important Values Inside Cluster

Functionality

Use for fabric/security management.
Do not expose certificate data in normal UI.

Cluster 63 — Group Key Management

Decimal Cluster: 63
Name: Group Key Management

Description

Manages group keys for secure Matter group messaging.

Important Values Inside Cluster

Functionality

Use internally for secure group command support.

Cluster 64 — Fixed Label

Decimal Cluster: 64
Name: Fixed Label

Description

Provides manufacturer-defined fixed labels.

Example labels:

[
  { label: "room", value: "bedroom 2" },
  { label: "orientation", value: "North" },
  { label: "floor", value: "2" },
  { label: "direction", value: "up" }
]

Important Values Inside Cluster

Functionality

Use as static metadata for UI grouping or installation context.

Cluster 65 — User Label

Decimal Cluster: 65
Name: User Label

Description

Provides user-defined labels.

In your bridge data, this cluster is listed but often returns:

{
  reason: "InteractionModelError: UnsupportedRead (0x8f)"
}

Important Values Inside Cluster

Functionality

Use only if readable.
If unsupported, keep it as cluster metadata but ignore runtime value.

2. Bridge-Specific Cluster

This section contains clusters that are different from a normal/native Matter device model.

Cluster 57 — Bridged Device Basic Information

Decimal Cluster: 57
Name: Bridged Device Basic Information

Description

Provides basic identity and reachability information for a device connected through a bridge.

This is the key bridge-specific cluster.

A native Matter device uses:

{
  cluster: 40,
  name: "Basic Information"
}

A bridged child device uses:

{
  cluster: 57,
  name: "Bridged Device Basic Information"
}

Important Values Inside Cluster

Functionality

Use this cluster to represent bridged child identity and availability.

3. Device-Specific Application Clusters

These clusters define actual child-device functionality.

They are not bridge-specific by themselves. They are standard Matter application clusters, but their presence determines what kind of child device the bridge is exposing.

Cluster 6 — On/Off

Decimal Cluster: 6
Name: On/Off

Description

Provides binary on/off state and control.

Used by:

• Lights.
• Plugs.
• Relays.
• Switch-like endpoints.
• Some controller-like devices.

Important Values Inside Cluster

Functionality

Normalize to:

{
  on: boolean
}

Important: do not assume every endpoint with On/Off is a light. Check product name and device type.

Cluster 98 — Scenes Management

Decimal Cluster: 98
Name: Scenes Management

Description

Provides scene storage, scene recall, scene membership, and scene-management functionality.

This is a standard Matter cluster, not a vendor-specific cluster.

Important Values Inside Cluster

Functionality

Use only if your app supports scenes or scene-like actions.

Recommended normalized fields:

{
  supportsScenes: true,
  sceneTableSize: number | null
}

Cluster 257 — Door Lock

Decimal Cluster: 257
Name: Door Lock

Description

Provides lock state, lock commands, unlock commands, user management, credential support, PIN/RFID support, schedules, operating mode, and lock configuration.

Used by:

• Door locks.
• Lock controllers.
• Bridged locks.
• Access-control devices.

Important Values Inside Cluster

Functional Lock State Mapping

const lockStateMap = {
  0: "not_fully_locked",
  1: "locked",
  2: "unlocked",
  3: "unknown"
};

Functionality

Normalize to:

{
  lockStateRaw: number,
  lockState: "not_fully_locked" | "locked" | "unlocked" | "unknown",
  actuatorEnabled: boolean | null,
  requiresPinForRemoteOperation: boolean | null
}

Cluster 1026 — Temperature Measurement

Decimal Cluster: 1026
Name: Temperature Measurement

Description

Reports measured temperature.

Used by:

• Temperature sensors.
• Environmental sensors.
• Thermostats.
• Temperature/humidity sensors.

Important Values Inside Cluster

Value Conversion

const temperatureCelsius = measuredValue / 100;

Example:

2341 / 100 === 23.41;

Functionality

Normalize to:

{
  temperatureCelsius: number
}

Cluster 1029 — Relative Humidity Measurement

Decimal Cluster: 1029
Name: Relative Humidity Measurement

Description

Reports measured relative humidity.

Used by:

• Humidity sensors.
• Temperature/humidity sensors.
• Environmental sensors.

Important Values Inside Cluster

Value Conversion

const humidityPercent = measuredValue / 100;

Example:

3941 / 100 === 39.41;

Functionality

Normalize to:

{
  humidityPercent: number
}

Cluster 1030 — Occupancy Sensing

Decimal Cluster: 1030
Name: Occupancy Sensing

Description

Reports occupancy or motion state.

Used by:

• Motion sensors.
• Occupancy sensors.
• Presence sensors.

Important Values Inside Cluster

Value Mapping

const occupancy = rawValue !== 0;

Examples:

0 === false;
1 === true;

Functionality

Normalize to:

{
  motion: boolean,
  occupancy: boolean
}

5. Important Device Types — Not Clusters

This section is intentionally separated because these are device types, not clusters.

They are required to correctly understand a Matter bridge, but they must not be listed as clusters.

Device Type 14 — Aggregator

Decimal Device Type: 14
Name: Aggregator

Description

The Aggregator device type represents a bridge container endpoint.

It groups bridged child endpoints through the Descriptor cluster PartsList.

Functionality

Use it to identify the bridge aggregation endpoint.

Do not create a separate child device for the Aggregator endpoint.

Device Type 19 — Bridged Node

Decimal Device Type: 19
Name: Bridged Node

Description

The Bridged Node device type represents a bridged child device root endpoint.

A bridged child endpoint normally has:

• Device type 19, Bridged Node.
• Cluster 57, Bridged Device Basic Information.
• One or more application clusters, such as Door Lock, Occupancy Sensing, Temperature Measurement, etc.

Functionality

Use it to identify child endpoints exposed through a bridge.

6. Final Cluster Classification

6.1 Common Matter Clusters

6.2 Bridge-Specific Cluster