nrf_modem_gnss_timing_source_set()

int32_t nrf_modem_gnss_timing_source_set

(

uint8_t

timing_source

)

#include <nrf_modem/include/nrf_modem_gnss.h>

Sets the used timing source during GNSS sleep.

Using TCXO instead of RTC during GNSS sleep periods might be beneficial when used with 1PPS. When GNSS is not running all the time (periodic navigation or duty cycling is used), 1PPS accuracy can be improved by using TCXO. It may also improve sensitivity for periodic navigation when the fix interval is short.

Default value: NRF_MODEM_GNSS_TIMING_SOURCE_RTC

Note

Use of TCXO significantly raises the idle current consumption.

Parameters

[in]

timing_source

See Sleep timing source enumerator.

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.