lte_lc_neighbor_cell_measurement()

int lte_lc_neighbor_cell_measurement

(

struct lte_lc_ncellmeas_params *

params

)

#include <include/modem/lte_lc.h>

Initiate a neighbor cell measurement.

The result of the measurement is reported back as an event of the type LTE_LC_EVT_NEIGHBOR_CELL_MEAS, meaning that an event handler must be registered to receive the information. Depending on the network conditions, LTE connection state and requested search type, it may take a while before the measurement result is ready and reported back. After the event is received, the neighbor cell measurements are automatically stopped.

Note

This feature is only supported by modem firmware versions >= 1.3.0.

Requires

CONFIG_LTE_LC_NEIGHBOR_CELL_MEAS_MODULE 

to be enabled.

Parameters

[in]

params

Search type parameters or NULL to initiate a measurement with the default parameters. See lte_lc_ncellmeas_params for more information.

Return values

0	if neighbor cell measurement was successfully initiated.
-EFAULT	if AT command failed.
-EINVAL	if parameters are invalid.
-EINPROGRESS	if a neighbor cell measurement is already in progress.