Matter Cluster 1285 — Target Navigator Cluster

Cluster Identity

Revision history

Shadow Path Format

Cluster 1285 values in the device shadow use this format:

endpoint_id / 1285 / attribute_id

Example:

{
  "1/1285/0": []
}

Data Types

StatusEnum

TargetInfoStruct (struct)

This indicates an object describing the navigable target.

Cluster 1285 Attributes

Cluster 1285 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 — TargetList

Path example:

1/1285/0

Indicates a list of targets that can be navigated to within the experience presented to the user by the Endpoint (Video Player or Content App). The list must NOT contain any entries with the same Identifier in the TargetInfoStruct object.

Each entry is a TargetInfoStruct (see Data Types).

Example:

{
  "1/1285/0": []
}

Attribute 1 / 0x0001 — CurrentTarget

Path example:

1/1285/1

Indicates the Identifier for the target which is currently in foreground on the corresponding Endpoint (Video Player or Content App), or 0xFF to indicate that no target is in the foreground. When not 0xFF, the CurrentTarget is an Identifier value contained within one of the TargetInfoStruct objects in the TargetList attribute.

Example:

{
  "1/1285/1": 1
}

Cluster 1285 Commands

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

AcceptedCommandList

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

endpoint_id / 1285 / 65529

{
  "1/1285/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": 1285,
    "command_name": "NavigateTarget",
    "payload": {},
    "timed_request_timeout_ms": 1000
  }
}

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

Purpose

On receipt, this must navigation the UX to the target identified.

Command Identity

Payload Fields

Bridge Command Example

{
  "message_id": "1",
  "command": "device_command",
  "args": {
    "endpoint_id": 1,
    "cluster_id": 1285,
    "command_name": "NavigateTarget",
    "payload": {
      "target": 1
    }
  }
}

The device answers with NavigateTargetResponse (see below).

Command: NavigateTargetResponse

Purpose

This command is generated in response to NavigateTarget command.

Command Identity

Response Fields

Status values (StatusEnum): 0 = Success, 1 = TargetNotFound, 2 = NotAllowed

Cluster 1285 Events

Event 0 — TargetUpdated

This event is generated when there is a change in either the active target or the list of available targets or both.

SmartphoneKey Notes

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