Matter Cluster 100 — Temperature Alarm Cluster

Cluster Identity

Revision history

Shadow Path Format

Cluster 100 values in the device shadow use this format:

endpoint_id / 100 / attribute_id

Example:

{
  "1/100/0": 0
}

Cluster 100 Features

The FeatureMap attribute (1/100/65532) is a bitmap. Each bit set means the device implements that feature and the attributes and commands that depend on it.

Example: FeatureMap = 0 means no optional feature is enabled; 1072693248 means every feature listed above is enabled.

Data Types

AlarmBitmap (bitmap)

This data type is a map32 with values defined by the derived cluster. The meaning of each bit position is consistent for all attributes in a derived cluster.

Cluster 100 Attributes

Cluster 100 defines 10 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 — Mask

Path example:

1/100/0

Indicates a bitmap where each bit set in the Mask attribute corresponds to an alarm that is enabled.

Bits (AlarmBitmap):

Example:

{
  "1/100/0": 0
}

Attribute 1 / 0x0001 — Latch

Path example:

1/100/1

Indicates a bitmap where each bit set in the Latch attribute indicates that the corresponding alarm will be latched when set, and will not reset to inactive when the underlying condition which caused the alarm is no longer present, and so requires an explicit reset using the Reset command.

Bits (AlarmBitmap):

Example:

{
  "1/100/1": 0
}

Attribute 2 / 0x0002 — State

Path example:

1/100/2

Indicates a bitmap where each bit represents the state of an alarm. The value of true means the alarm is active, otherwise the alarm is inactive.

Bits (AlarmBitmap):

Example:

{
  "1/100/2": 0
}

Attribute 3 / 0x0003 — Supported

Path example:

1/100/3

Indicates a bitmap where each bit represents whether or not an alarm is supported. The value of true means the alarm is supported, otherwise the alarm is not supported. If an alarm is not supported, the corresponding bit in Mask, Latch, and State is false.

Bits (AlarmBitmap):

Example:

{
  "1/100/3": 0
}

Attribute 128 / 0x0080 — CriticalOverTemperatureThreshold

Path example:

1/100/128

Indicates the threshold for temperature measurement over which the CriticalOverTemperature alarm is active.

Example:

{
  "1/100/128": 1
}

Attribute 129 / 0x0081 — MajorOverTemperatureThreshold

Path example:

1/100/129

Indicates the threshold for temperature measurement over which the MajorOverTemperature alarm is active.

Example:

{
  "1/100/129": 1
}

Attribute 130 / 0x0082 — MinorOverTemperatureThreshold

Path example:

1/100/130

Indicates the threshold for temperature measurement over which the MinorOverTemperature alarm is active.

Example:

{
  "1/100/130": 1
}

Attribute 131 / 0x0083 — MinorUnderTemperatureThreshold

Path example:

1/100/131

Indicates the threshold for temperature measurement under which the MinorUnderTemperature alarm is active.

Example:

{
  "1/100/131": 1
}

Attribute 132 / 0x0084 — MajorUnderTemperatureThreshold

Path example:

1/100/132

Indicates the threshold for temperature measurement under which the MajorUnderTemperature alarm is active.

Example:

{
  "1/100/132": 1
}

Attribute 133 / 0x0085 — CriticalUnderTemperatureThreshold

Path example:

1/100/133

Indicates the threshold for temperature measurement under which the CriticalUnderTemperature alarm is active.

Example:

{
  "1/100/133": 1
}

Cluster 100 Commands

Cluster 100 has 3 client-to-server commands and 0 responses.

AcceptedCommandList

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

endpoint_id / 100 / 65529

{
  "1/100/65529": [
    0,
    1,
    128
  ]
}

Bridge Command Payload Format

The bridge accepts Matter commands in this structure:

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

For Cluster 100, always use "cluster_id": 100. 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: Reset

Purpose

This command resets active and latched alarms (if possible). Any generated Notify event contains fields that represent the state of the server after the command has been processed.

Command Identity

Payload Fields

Bridge Command Example

{
  "message_id": "1",
  "command": "device_command",
  "args": {
    "endpoint_id": 1,
    "cluster_id": 100,
    "command_name": "Reset",
    "payload": {
      "alarms": 0
    }
  }
}

Command: ModifyEnabledAlarms

Purpose

This command allows a client to request that an alarm be enabled or suppressed at the server.

Command Identity

Payload Fields

Bridge Command Example

{
  "message_id": "1",
  "command": "device_command",
  "args": {
    "endpoint_id": 1,
    "cluster_id": 100,
    "command_name": "ModifyEnabledAlarms",
    "payload": {
      "mask": 0
    }
  }
}

Command: SetTemperatureAlarmThresholds

Purpose

This command will set the alarm thresholds for the specified values. The constraints related to the field values in the table above has the relationship as represented by the illustration below:

Command Identity

Payload Fields

Bridge Command Example

{
  "message_id": "1",
  "command": "device_command",
  "args": {
    "endpoint_id": 1,
    "cluster_id": 100,
    "command_name": "SetTemperatureAlarmThresholds",
    "payload": {
      "criticalOverTemperatureThreshold": 1,
      "majorOverTemperatureThreshold": 1
    }
  }
}

Cluster 100 Events

Event 0 — Notify

This event is generated when one or more alarms change state.

SmartphoneKey Notes

• Cluster 100 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/100/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.