Matter Cluster 1362 — Camera AV Settings User Level Management Cluster

Cluster Identity

Revision history

Shadow Path Format

Cluster 1362 values in the device shadow use this format:

endpoint_id / 1362 / attribute_id

Example:

{
  "1/1362/0": {
    "pan": 1,
    "tilt": 1,
    "zoom": 1
  }
}

Cluster 1362 Features

The FeatureMap attribute (1/1362/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; 31 means every feature listed above is enabled.

Data Types

PhysicalMovementEnum

The PhysicalMovementEnum provides an enumeration of the possible physical movement states in which the camera could be.

DPTZStruct (struct)

This type is used to indicate support for the per stream digital pan, tilt, and zoom values.

MPTZPresetStruct (struct)

This type is used to save a preset location for mechanical pan, tilt and zoom.

MPTZStruct (struct)

This type is used to indicate the mechanical pan, tilt, and zoom values.

Cluster 1362 Attributes

Cluster 1362 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 — MPTZPosition

Path example:

1/1362/0

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

Value is a MPTZStruct struct (see Data Types).

Example:

{
  "1/1362/0": {
    "pan": 1,
    "tilt": 1,
    "zoom": 1
  }
}

Attribute 1 / 0x0001 — MaxPresets

Path example:

1/1362/1

This attribute indicates the maximum number of presets for the mechanical pan, tilt, zoom.

Example:

{
  "1/1362/1": 1
}

Attribute 2 / 0x0002 — MPTZPresets

Path example:

1/1362/2

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

Each entry is a MPTZPresetStruct (see Data Types).

Example:

{
  "1/1362/2": []
}

Attribute 3 / 0x0003 — DPTZStreams

Path example:

1/1362/3

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

Each entry is a DPTZStruct (see Data Types).

Example:

{
  "1/1362/3": []
}

Attribute 4 / 0x0004 — ZoomMax

Path example:

1/1362/4

Indicates the maximum value for the mechanical zoom specified by the camera manufacturer that allows for increments of 1 to be noticeable. The handling of this value is implementation specific.

Example:

{
  "1/1362/4": 2
}

Attribute 5 / 0x0005 — TiltMin

Path example:

1/1362/5

Indicates the minimum value for the mechanical tilt specified by the camera manufacturer in angular degrees.

Example:

{
  "1/1362/5": 1
}

Attribute 6 / 0x0006 — TiltMax

Path example:

1/1362/6

Indicates the maximum value for the mechanical tilt specified by the camera manufacturer in angular degrees.

Example:

{
  "1/1362/6": 1
}

Attribute 7 / 0x0007 — PanMin

Path example:

1/1362/7

Indicates the minimum value for the mechanical pan specified by the camera manufacturer in angular degrees.

Example:

{
  "1/1362/7": 1
}

Attribute 8 / 0x0008 — PanMax

Path example:

1/1362/8

Indicates the maximum value for the mechanical pan specified by the camera manufacturer in angular degrees.

Example:

{
  "1/1362/8": 1
}

Attribute 9 / 0x0009 — MovementState

Path example:

1/1362/9

Indicates the current movement state of the camera.

Values (PhysicalMovementEnum):

Example:

{
  "1/1362/9": 0
}

Cluster 1362 Commands

Cluster 1362 has 7 client-to-server commands and 0 responses.

AcceptedCommandList

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

endpoint_id / 1362 / 65529

{
  "1/1362/65529": [
    0,
    1,
    2,
    3,
    4,
    5,
    6
  ]
}

Bridge Command Payload Format

The bridge accepts Matter commands in this structure:

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

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

Purpose

MPTZSetPosition is a client-to-server command of the Camera AV Settings User Level Management cluster.

Command Identity

Payload Fields

Bridge Command Example

{
  "message_id": "1",
  "command": "device_command",
  "args": {
    "endpoint_id": 1,
    "cluster_id": 1362,
    "command_name": "MPTZSetPosition",
    "payload": {
      "pan": 1,
      "tilt": 1
    }
  }
}

Command: MPTZRelativeMove

Purpose

MPTZRelativeMove is a client-to-server command of the Camera AV Settings User Level Management cluster.

Command Identity

Payload Fields

Bridge Command Example

{
  "message_id": "1",
  "command": "device_command",
  "args": {
    "endpoint_id": 1,
    "cluster_id": 1362,
    "command_name": "MPTZRelativeMove",
    "payload": {
      "panDelta": 1,
      "tiltDelta": 1
    }
  }
}

Command: MPTZMoveToPreset

Purpose

MPTZMoveToPreset is a client-to-server command of the Camera AV Settings User Level Management cluster.

Command Identity

Payload Fields

Bridge Command Example

{
  "message_id": "1",
  "command": "device_command",
  "args": {
    "endpoint_id": 1,
    "cluster_id": 1362,
    "command_name": "MPTZMoveToPreset",
    "payload": {
      "presetID": 1
    }
  }
}

Command: MPTZSavePreset

Purpose

MPTZSavePreset is a client-to-server command of the Camera AV Settings User Level Management cluster.

Command Identity

Payload Fields

Bridge Command Example

{
  "message_id": "1",
  "command": "device_command",
  "args": {
    "endpoint_id": 1,
    "cluster_id": 1362,
    "command_name": "MPTZSavePreset",
    "payload": {
      "name": "example"
    }
  }
}

Command: MPTZRemovePreset

Purpose

MPTZRemovePreset is a client-to-server command of the Camera AV Settings User Level Management cluster.

Command Identity

Payload Fields

Bridge Command Example

{
  "message_id": "1",
  "command": "device_command",
  "args": {
    "endpoint_id": 1,
    "cluster_id": 1362,
    "command_name": "MPTZRemovePreset",
    "payload": {
      "presetID": 1
    }
  }
}

Command: DPTZSetViewport

Purpose

DPTZSetViewport is a client-to-server command of the Camera AV Settings User Level Management cluster.

Command Identity

Payload Fields

Bridge Command Example

{
  "message_id": "1",
  "command": "device_command",
  "args": {
    "endpoint_id": 1,
    "cluster_id": 1362,
    "command_name": "DPTZSetViewport",
    "payload": {
      "videoStreamID": 0,
      "viewport": 0
    }
  }
}

Command: DPTZRelativeMove

Purpose

DPTZRelativeMove is a client-to-server command of the Camera AV Settings User Level Management cluster.

Command Identity

Payload Fields

Bridge Command Example

{
  "message_id": "1",
  "command": "device_command",
  "args": {
    "endpoint_id": 1,
    "cluster_id": 1362,
    "command_name": "DPTZRelativeMove",
    "payload": {
      "videoStreamID": 0
    }
  }
}

Cluster 1362 Events

Cluster 1362 defines no events.

SmartphoneKey Notes

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