RangingParameters

const val CONFIG_MULTICAST_DS_TWR = 2: Int

Pre-defined one-to-many STATIC STS DS-TWR ranging

deferred mode, ranging interval = 200 ms, slot duration = 2400 RSTU, slots per ranging round = 20, hopping mode is enabled

All other MAC parameters use FiRa/UCI default values.

Typical use case: smart phone interacts with many smart devices

const val CONFIG_PROVISIONED_INDIVIDUAL_MULTICAST_DS_TWR = 7: Int

Same as CONFIG_MULTICAST_DS_TWR, except P-STS individual controlee key mode is enabled.

const val CONFIG_PROVISIONED_MULTICAST_DS_TWR = 5: Int

Same as CONFIG_MULTICAST_DS_TWR, except P-STS security mode is enabled.

const val CONFIG_PROVISIONED_UNICAST_DS_TWR = 4: Int

Same as CONFIG_UNICAST_DS_TWR, except P-STS security mode is enabled.

const val CONFIG_UNICAST_DS_TWR = 1: Int

Pre-defined unicast STATIC STS DS-TWR ranging.

deferred mode, ranging interval = 240 ms, slot duration = 2400 RSTU, slots per ranging round = 6, hopping mode is enabled

All other MAC parameters use FiRa/UCI default values.

Typical use case: device tracking tags

const val RANGING_SLOT_DURATION_1_MILLIS = 1: Long

1 millisecond slot duration

const val RANGING_SLOT_DURATION_2_MILLIS = 2: Long

2 millisecond slot duration

const val RANGING_UPDATE_RATE_AUTOMATIC = 1: Int

The update rate that differs across different config id. It is 240 millisecond for CONFIG_UNICAST_DS_TWR and CONFIG_PROVISIONED_UNICAST_DS_TWR, and is 200 millisecond for other config ids.

const val RANGING_UPDATE_RATE_FREQUENT = 3: Int

600 millisecond update rate for all config ids.

const val RANGING_UPDATE_RATE_INFREQUENT = 2: Int

120 millisecond update rate for all config ids.

val complexChannel: UwbComplexChannel?

Optional. If device type is ROLE_CONTROLEE then complex channel should be set.

val isAoaDisabled: Boolean

The indicator of whether angle of arrival (AoA) is disabled. Default to false.

val peerDevices: List<UwbDevice>

The peers to perform ranging with. If using unicast, length should be 1.

val sessionId: Int

The ID of the ranging session. If the value is SESSION_ID_UNSET (0), it will be created from the hash of controller address and complex channel values.

The same session IDs should be used at both ends (Controller and controlee).

val sessionKeyInfo: ByteArray?

The session key info to use for the ranging. If the profile uses STATIC STS, this byte array is 8-byte long with first two bytes as Vendor_ID and next six bytes as STATIC_STS_IV. If the profile uses PROVISIONED STS, this byte array is 16 or 32-byte long which represent session key.

The same session keys should be used at both ends (Controller and controlee).

val slotDurationMillis: @IntRange(from = 1, to = 2) Long

The slot duration of the ranging session in millisecond. The available slot durations are RANGING_SLOT_DURATION_1_MILLIS and RANGING_SLOT_DURATION_2_MILLIS. Default to RANGING_SLOT_DURATION_2_MILLIS.

val subSessionId: Int

The ID of the ranging sub-session. This value should be set when the Provisioned STS individual responder case is used. If other config is used, it should remain SUB_SESSION_UNSET (0)

val subSessionKeyInfo: ByteArray?

The sub-session key info to use for the ranging. This byte array is 16 or 32-byte long when the profile uses PROVISIONED STS individual responder cases. If other STS is used, this field should remain null.

val updateRateType: Int

The update rate type of the ranging data. The update rate types include RANGING_UPDATE_RATE_AUTOMATIC, RANGING_UPDATE_RATE_FREQUENT, and RANGING_UPDATE_RATE_INFREQUENT.

val uwbConfigType: Int

The UWB configuration type. One type specifies one fixed set of pre-defined parameters. The UWB config type includes CONFIG_UNICAST_DS_TWR and CONFIG_MULTICAST_DS_TWR.

val uwbRangeDataNtfConfig: UwbRangeDataNtfConfig?

Configurable range data notification reports for a UWB session.