RangingParameters

public static final int CONFIG_MULTICAST_DS_TWR = 2

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

public static final int CONFIG_PROVISIONED_INDIVIDUAL_MULTICAST_DS_TWR = 7

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

public static final int CONFIG_PROVISIONED_MULTICAST_DS_TWR = 5

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

public static final int CONFIG_PROVISIONED_UNICAST_DS_TWR = 4

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

public static final int CONFIG_UNICAST_DS_TWR = 1

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

public static final long RANGING_SLOT_DURATION_1_MILLIS = 1

1 millisecond slot duration

public static final long RANGING_SLOT_DURATION_2_MILLIS = 2

2 millisecond slot duration

public static final int RANGING_UPDATE_RATE_AUTOMATIC = 1

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.

public static final int RANGING_UPDATE_RATE_FREQUENT = 3

600 millisecond update rate for all config ids.

public static final int RANGING_UPDATE_RATE_INFREQUENT = 2

120 millisecond update rate for all config ids.

public final UwbComplexChannel getComplexChannel()

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

public final @NonNull List<@NonNull UwbDevice> getPeerDevices()

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

public final int getSessionId()

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).

public final byte[] getSessionKeyInfo()

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).

public final long getSlotDurationMillis()

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.

public final int getSubSessionId()

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)

public final byte[] getSubSessionKeyInfo()

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.

public final int getUpdateRateType()

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.

public final int getUwbConfigType()

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.

public final UwbRangeDataNtfConfig getUwbRangeDataNtfConfig()

Configurable range data notification reports for a UWB session.

public final boolean isAoaDisabled()

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