Function nrfxlib_sys::nrf_modem_gnss_fix_interval_set

source · 
pub unsafe extern "C" fn nrf_modem_gnss_fix_interval_set(
    fix_interval: u16
) -> i32
Expand description

Sets the GNSS fix interval in seconds.

@details Single fix navigation mode is engaged by setting the fix interval to 0.

Continuous navigation mode is engaged by setting fix interval to 1.

Periodic navigation mode is engaged by setting the fix interval to value 10…65535. The unit is seconds.

Default value: 1 (continuous navigation)

@note Fix interval values over 1800 seconds are only supported by modem firmware v1.3.0 or later.

@note In periodic navigation mode, when GNSS determines it needs to download ephemerides or almanacs from the broadcast, the fix interval and fix retry parameters are temporarily ignored. GNSS will perform scheduled downloads until it has downloaded the data it needs, after which normal operation is resumed.

  • fix_interval - 0 for single fix, 1 for continuous navigation or fix interval in seconds.

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