Function nrfxlib_sys::nrf_modem_gnss_agps_expiry_get

pub unsafe extern "C" fn nrf_modem_gnss_agps_expiry_get(
    agps_expiry: *mut nrf_modem_gnss_agps_expiry
) -> i32

Reads the current A-GPS data need and expiry times from GNSS.

@details Returns detailed information about the current GNSS A-GPS data need. The data structure contains expiry times in seconds for different types of assistance data. This function can be called at any time. If GNSS doesn’t know the current GPS system time, the expiry times can not be calculated

@note When A-GPS data has been injected but GNSS has not yet been started, ephemerides and almanacs are in some cases reported as expired. This happens when ephemerides and almanacs are injected before GPS system time. This can be prevented by either injecting GPS system time before ephemerides and almanacs or briefly starting and stopping GNSS before calling the function.

@note Only supported by modem firmware v1.3.2 or later.

• agps_expiry - Pointer to a buffer where the data is stored to.

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 buffer supplied by the application is NULL or The GNSS stack returned an error. Returns -NRF_ENOMEM There is not enough shared memory for this request. Returns -NRF_EOPNOTSUPP The operation is not supported by the modem firmware. Returns -NRF_ESHUTDOWN The modem was shut down.