Matter Survey

Community-driven database of Matter device capabilities

Clusters » OTA Software Update Provider

The OTA Software Update Provider cluster (0x0029) is a Matter cluster that Enables a device to serve firmware updates to other devices on the network.. It defines 5 commands and is mandatory for 2 device types.

OTA Software Update Provider 0x0029

Global Cluster
Utility
Introduced in: Matter 1.0
Devices: 372
Enables a device to serve firmware updates to other devices on the network.

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 Matter 1.4 Matter 1.5 Matter master rev 1
Commands 5
Code Name Direction Parameters
0x00 QueryImage
Upon receipt, this command SHALL trigger an attempt to find an updated Software Image by the OTA Provider to match the OTA Requestor's constraints provided in the payload fields.
 client→server
VendorID: vendor_id, ProductID: int16u, SoftwareVersion: int32u, ProtocolsSupported: DownloadProtocolEnum, HardwareVersion: int16u, Location: char_string, RequestorCanConsent: boolean, MetadataForProvider: long_octet_string
0x01 QueryImageResponse
This command is sent in response to the QueryImage command.
 server→client
Status: StatusEnum, DelayedActionTime: int32u, ImageURI: long_char_string, SoftwareVersion: int32u, SoftwareVersionString: char_string, UpdateToken: octet_string, UserConsentNeeded: boolean, MetadataForRequestor: long_octet_string
0x02 ApplyUpdateRequest
This command requests the specified version be installed on the device.
 client→server
UpdateToken: octet_string, NewVersion: int32u
0x03 ApplyUpdateResponse
This command is sent in response to the ApplyUpdateRequest command.
 server→client
Action: ApplyUpdateActionEnum, DelayedActionTime: int32u
0x04 NotifyUpdateApplied
This command tells the Provider that the specified update has been applied.
 client→server
UpdateToken: octet_string, SoftwareVersion: int32u

Device Types Using This Cluster

Device types in the Matter spec that reference this cluster

📱
OTA Provider
Mandatory Server
📱
OTA Requestor
Mandatory Client

Devices Implementing This Cluster

372 devices in the survey implement this cluster

Smartlightbulb
Espressif Systems
Smart HomeBase
Tapo
Govee Neon Light
Shenzhen Qianyan Technology
Govee Floor Lamp 3
Shenzhen Qianyan Technology
Heiman smart door sensor
HEIMAN
Smart Plug
Hama GmbH & Co KG
ANTELA Smart Plug
Hangzhou Mango Network Technology Co, LTD.
SMART MATDECORWALLTWIST230X127TW
LEDVANCE
Govee Pendant Light
Shenzhen Qianyan Technology
Aqara Light Switch H2
Aqara
Heiman smart motion sensor
HEIMAN
Level Lock Pro
Level Home
SmartWings Window Covering
SmartWings
not-specified
TEST_VENDOR
Decora Smart Wi-Fi Motion Sensing Dimmer
Leviton
Level Bolt (Matter)
Level Home
Smart RGBTW Bulb
Leedarson
Kasa Smart IoT Hub
Kasa
Smart RGBTW Bulb
Leedarson
Eve Energy
Eve Systems
PIR Sensor
NEO
Tapo Smart Plug, Energy Monitoring
Tapo
Aqara Light Switch H2
Aqara
Magic Cube WS01
Energy Magic Cube