lte_lc_conn_eval_params_get()

int lte_lc_conn_eval_params_get

(

struct lte_lc_conn_eval_params *

params

)

#include <include/modem/lte_lc.h>

Get connection evaluation parameters.

Connection evaluation parameters can be used to determine the energy efficiency of data transmission before the actual data transmission. Connection evaluation is based on collected cell history.

In receive only functional mode with modem firmware mfw_nrf91x1 v2.0.3 and higher, and mfw_nrf9151-ntn, it is recommended to wait for the modem to complete the network selection before calling this function. This can be determined from the LTE_LC_EVT_MODEM_EVENT event with modem event LTE_LC_MODEM_EVT_SEARCH_DONE.

Note

Requires CONFIG_LTE_LC_CONN_EVAL_MODULE to be enabled.

Parameters

[out]

params

Connection evaluation parameters.

Returns

Zero on success, negative errno code if the API call fails, and a positive error code if the API call succeeds but connection evaluation fails due to modem/network related reasons.

Return values

0	if evaluation succeeded.
1	if evaluation failed, no cell available.
2	if evaluation failed, UICC not available.
3	if evaluation failed, only barred cells available.
4	if evaluation failed, radio busy (e.g GNSS activity).
5	if evaluation failed, aborted due to higher priority operation.
6	if evaluation failed, UE not registered to network.
7	if evaluation failed, unspecified.
-EINVAL	if input argument was invalid.
-EFAULT	if AT command failed.
-EOPNOTSUPP	if connection evaluation is not available in the current functional mode.
-EBADMSG	if parsing of the AT command response failed.