bt_fast_pair_fhn_pf_ranging_capability_response_send()

int bt_fast_pair_fhn_pf_ranging_capability_response_send	(	struct bt_conn *	conn,
		uint16_t	ranging_tech_bm,
		struct bt_fast_pair_fhn_pf_ranging_tech_payload *	capability_payloads,
		uint8_t	capability_payload_num )

#include <include/bluetooth/fast_pair/fhn/pf/pf.h>

Send a Ranging Capability Response message.

This function sends a Ranging Capability Response message over the Bluetooth GATT Beacon Actions characteristic to the connected peer. It should be called after receiving the bt_fast_pair_fhn_pf_ranging_mgmt_cb::ranging_capability_request callback to indicate supported ranging technologies and their configuration payloads.

The capability_payloads array must contain the technology-specific capability data for each ranging technology that is supported. The capability_payload_num parameter must indicate the number of elements in the capability_payloads array.

The array order of the capability_payloads parameter determines the ranging technology priority. The first element in the array has the highest priority.

Calling this function in the wrong context, that is without the preceding ranging capability request callback, will result in an error. Indicating the ranging technologies in the ranging_tech_bm parameter that were not requested will also result in an error.

It is possible to call this function asynchronously outside of the callback context, as the capability preparation of certain ranging technologies may require time to complete.

Parameters

conn	Connection object.
ranging_tech_bm	Bitmask of the supported ranging technologies, composed of bt_fast_pair_fhn_pf_ranging_tech_id bit positions.
capability_payloads	Array of technology-specific capability payloads.
capability_payload_num	Number of elements in the capability_payloads array.

Returns

0 if the operation was successful. Otherwise, a (negative) error code is returned.