The General Diagnostics cluster (0x0033) is a Matter cluster that Reports general device health metrics including uptime, reboot counts, and hardware faults.. It defines 5 commands and 10 attributes and is mandatory for 1 device type.

Last updated 27 Sep 2026

General Diagnostics 0x0033

Global Cluster

Utility

Introduced in: Matter 1.0

Devices: 722

Reports general device health metrics including uptime, reboot counts, and hardware faults.

Spec History

This cluster's ClusterRevision across the Matter releases it has shipped in. Click a version to inspect the cluster as it existed in that release.

Matter 1.0 Matter 1.1 Matter 1.2 Matter 1.3 rev 2 Matter 1.4 rev 2 Matter 1.5 rev 2 Matter 1.6 rev 3 Matter master rev 3

Attributes 10

Commands 5

Features 1

Code	Name	Type	Flags
0x0000	NetworkInterfaces	array
0x0001	RebootCount	int16u
0x0002	UpTime	int64u	Optional
0x0003	TotalOperationalHours	int32u	Optional
0x0004	BootReason max 0x06	BootReasonEnum	Optional
0x0005	ActiveHardwareFaults	array	Optional
0x0006	ActiveRadioFaults	array	Optional
0x0007	ActiveNetworkFaults	array	Optional
0x0008	TestEventTriggersEnabled	boolean
0x000A	DeviceLoadStatus	DeviceLoadStruct	Optional

Code	Name	Direction	Parameters
0x00	TestEventTrigger This command SHALL be supported to provide a means for certification tests to trigger some test-plan-specific events, necessary to assist in automation of device interactions for some certification test cases.	client→server	`EnableKey`: octet_string, `EventTrigger`: int64u
0x01	TimeSnapshot This command MAY be used by a client to obtain a correlated view of both System Time, and, if currently synchronized and supported, "wall clock time" of the server.	client→server	None
0x02	TimeSnapshotResponse This command SHALL be generated in response to a TimeSnapshot command.	server→client	`SystemTimeMs`: systime_ms, `PosixTimeMs`: posix_ms
0x03	PayloadTestRequest Optional This command provides a means for certification tests or manufacturer's internal tests to validate particular command handling and encoding constraints by generating a response of a given size.	client→server	`EnableKey`: octet_string, `Value`: int8u, `Count`: int16u
0x04	PayloadTestResponse Optional This command is sent by the server on receipt of the PayloadTestRequest command.	server→client	`Payload`: long_octet_string