The Proximity Ranging cluster (0x0433) is a Matter cluster that Reports distance/proximity measurements between two devices (e.g. UWB, BLE ranging).. It defines 3 commands and 7 attributes.
Proximity Ranging 0x0433
Reports distance/proximity measurements between two devices (e.g. UWB, BLE ranging).
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.
Attributes 7
Commands 3
Features 4
| Code | Name | Type | Flags |
|---|---|---|---|
| 0x0000 | RangingCapabilities | array | |
| 0x0001 | WiFiDevIK | octet_string | Optional |
| 0x0002 | BLEDeviceID | int64u | Optional |
| 0x0003 | BLTDevIK | octet_string | Optional |
| 0x0004 |
BLTCSSecurityLevel
max 0x03
|
BLTCSSecurityLevelEnum | Optional |
| 0x0005 |
BLTCSModeCapability
max 0x02
|
BLTCSModeEnum | Optional |
| 0x0006 |
SessionIDList
nullable
|
array |
| Code | Name | Direction | Parameters |
|---|---|---|---|
| 0x00 |
StartRangingRequest
This command allows the Client to request the start of a ranging session.
|
client→server |
Technology: RangingTechEnum, WiFiRangingDeviceRoleConfig: WiFiRangingDeviceRoleConfigStruct, BLERangingDeviceRoleConfig: BLERangingDeviceRoleConfigStruct, BLTChannelSoundingDeviceRoleConfig: BLTChannelSoundingDeviceRoleConfigStruct, FrequencyBand: RadioBandBitmap, Bandwidth: RangingBandwidthBitmap, SecurityMode: RangingSecurityEnum, Trigger: RangingTriggerConditionStruct, ReportingCondition: ReportingConditionStruct |
| 0x01 |
StartRangingResponse
Upon receipt of a StartRangingRequest command, the Server SHALL send a StartRangingResponse command indicating whether the request has been accepted or rejected.
|
server→client |
ResultCode: ResultCodeEnum, SessionID: int8u |
| 0x02 |
StopRangingRequest
Upon receipt of a StopRangingRequest command that contains a SessionID that matches an active ranging session, the Server SHALL terminate the corresponding ranging session.
|
client→server |
SessionID: int8u |
Wi-Fi USD Proximity Detection
(WFUSDPD)
bit 0
Supports proximity ranging based on Wi-Fi
Bluetooth Channel Sounding
(BLTCS)
bit 1
Supports proximity ranging based on Bluetooth Channel Sounding
BLE Beacon RSSI
(BLERBC)
bit 2
Supports proximity ranging based on BLE Beacon RSSI
UWB Ranging
(UWBRNG)
bit 3
Supports proximity ranging based on UWB ranging
Devices Implementing This Cluster
0 devices in the survey implement this cluster
No devices in the survey implement this cluster yet.