nrf_modem_gnss_prio_mode_enable()

int32_t nrf_modem_gnss_prio_mode_enable

(

void

)

#include <nrf_modem/include/nrf_modem_gnss.h>

Enables GNSS priority over LTE idle mode procedures.

GNSS can produce a cold start fix when there are long enough gaps in LTE idle mode operations. LTE idle eDRX cycles approximately 1 min and above will usually guarantee the ability to produce a fix. Shorter DRX cycles will be enough after GNSS has got ephemerides. GNSS priority can be enabled to help getting GNSS into that state, if there are not long enough gaps in LTE idle mode functionality. Priority for GNSS should be used only when fix has been blocked by LTE idle mode operations, which can be detected by NRF_MODEM_GNSS_PVT_FLAG_NOT_ENOUGH_WINDOW_TIME bit being set in the PVT data frame flags member. The application should not make the decision based on a single PVT event, but should enable priority only in case this flag has been set in several consecutive PVT events. Priority will be disabled automatically after producing the first fix.

Note

GNSS priority may interfere with LTE operations, if possible it would be good to time the use of priority to moments where data transfer is not anticipated. In general, long enough eDRX cycles, or PSM, will ensure better functionality for both GNSS and LTE.

Priority will not stop LTE connections.

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 stopped.
-NRF_ENOMEM	There is not enough shared memory for this request.
-NRF_ESHUTDOWN	The modem was shut down.