nrf_modem_gnss_fix_retry_set()

int32_t nrf_modem_gnss_fix_retry_set

(

uint16_t

fix_retry

)

#include <nrf_modem/include/nrf_modem_gnss.h>

Sets the GNSS fix retry period in seconds.

Fix retry parameter controls the maximum time the GNSS receiver is allowed to run while trying to produce a valid PVT estimate. If the fix retry time is non-zero, the GNSS receiver is turned off after the fix retry time is up regardless of whether a valid PVT estimate was produced or not. If fix retry parameter is set to zero, the GNSS receiver is allowed to run indefinitely until a valid PVT estimate is produced.

Default value: 60s

Note

For the first fix in periodic navigation mode the GNSS receiver is allowed to run for 60 seconds even if the retry interval is set shorter.

Fix retry has no effect in continuous navigation mode.

Parameters

[in]

fix_retry

Fix retry period in seconds.

Return values

0	on success.
-NRF_EPERM	The Modem library is not initialized.
-NRF_EACCES	GNSS is not enabled in system or functional mode.
-NRF_EINVAL	The GNSS stack returned an error or the operation cannot be executed while GNSS is running.
-NRF_ENOMEM	There is not enough shared memory for this request.
-NRF_ESHUTDOWN	The modem was shut down.