lte_lc_env_eval()

int lte_lc_env_eval

(

struct lte_lc_env_eval_params *

params

)

#include <include/modem/lte_lc.h>

Start environment evaluation.

Perform evaluation for PLMN selection. Evaluates available PLMNs and provides information of their estimated signalling conditions. Based on the evaluation results, the application can then select the best PLMN to use. This is useful especially in cases where the device has multiple SIMs or SIM profiles to select from.

PLMNs (MCC/MNC pairs) to be evaluated are listed in the lte_lc_env_eval_params structure. For each PLMN, evaluation results for the best found cell are returned. The results are returned with the LTE_LC_EVT_ENV_EVAL_RESULT event.

Environment evaluation can only be performed in receive only functional mode. The device does not transmit anything during the evaluation.

Note

This is only supported by the following modem firmware:

• mfw_nrf91x1 v2.0.3 or later
• mfw_nrf9151-ntn

Requires CONFIG_LTE_LC_ENV_EVAL_MODULE to be enabled.

Parameters

[in]

params

Environment evaluation parameters.

Return values

0	if environment evaluation was successfully initiated.
-EFAULT	if AT command failed or feature is not supported by the modem firmware.
-EINVAL	if parameters are invalid.
-EOPNOTSUPP	if environment evaluation is not available in the current functional mode.