timeout_expired

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

Request the user to stop the ringing action on timeout.

This callback is called to stop the ongoing ringing action. The FHN module requests this action when the ringing timeout expires.

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

This callback is called when at least one ringing component is active. The timeout is not stopped unless the API user reports that ringing is stopped for all of the components.

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 - in the system workqueue thread.

Parameters

src	Source of the ringing activity.