stop_request

void(* bt_fast_pair_fhn_ring_cb::stop_request) (enum bt_fast_pair_fhn_ring_src src)

Request the user to stop the ringing action on GATT request.

This callback is called to stop the ongoing ringing action. The FHN module requests this action in response to the command from the connected peer.

If the action is accepted for at least one requested component, you shall indicate it using the bt_fast_pair_fhn_ring_state_update API and set the BT_FAST_PAIR_FHN_RING_TRIGGER_GATT_STOPPED as a trigger for the ringing state change. If all components are out of range, you shall set the BT_FAST_PAIR_FHN_RING_TRIGGER_FAILED as a trigger.

If you cannot stop the ringing action on all requested components (for example, one of them is out of range), you shall still declare success for this request. Once an unavailable component becomes reachable, you can stop the ringing action on it and indicate it using the bt_fast_pair_fhn_ring_state_update API.

This callback is executed in the cooperative thread context. You can learn about the exact thread context by analyzing the

CONFIG_BT_RECV_CONTEXT 

configuration choice. By default, this callback is executed in the Bluetooth-specific workqueue thread (

CONFIG_BT_RECV_WORKQ_BT 

).

Parameters

src	Source of the ringing activity.