nRF Connect SDK API 3.3.99
Loading...
Searching...
No Matches

◆ lte_lc_func_mode

#include <include/modem/lte_lc.h>

Functional mode, used to control RF functionality in the modem.

Note
The values are mapped to modem functional modes as described in "nRF91 AT Commands - Command Reference Guide". Refer to the AT command guide to verify whether a functional mode is supported by a given modem firmware version.
Enumerator
LTE_LC_FUNC_MODE_POWER_OFF 

Sets the device to minimum functionality.

Disables both transmit and receive RF circuits and deactivates LTE and GNSS.

LTE_LC_FUNC_MODE_NORMAL 

Sets the device to full functionality.

Both LTE and GNSS will become active if the respective system modes are enabled.

LTE_LC_FUNC_MODE_RX_ONLY 

Sets the device to receive only functionality.

Features supported by mfw_nrf9160 in receive only mode:

Features supported by mfw_nrf91x1 and mfw_nrf9151-ntn in receive only mode:

mfw_nrf91x1 and mfw_nrf9151-ntn perform network selection in receive only mode. When the search has been completed, an LTE_LC_EVT_MODEM_EVENT is sent with modem event LTE_LC_MODEM_EVT_SEARCH_DONE. The application can check the last received LTE_LC_EVT_CELL_UPDATE to see if a suitable cell was found or not.

After network selection, device remains camped on the found cell, but will not try to register unless the functional mode is changed. LTE registration can be triggered on the cell by setting the functional mode to LTE_LC_FUNC_MODE_NORMAL or LTE_LC_FUNC_MODE_ACTIVATE_LTE. Device should not be left in receive only mode for longer than necessary, because current consumption will be elevated.

LTE_LC_FUNC_MODE_OFFLINE 

Sets the device to flight mode.

Disables both transmit and receive RF circuits and deactivates LTE and GNSS services.

LTE_LC_FUNC_MODE_DEACTIVATE_LTE 

Deactivates LTE without shutting down GNSS services.

LTE_LC_FUNC_MODE_ACTIVATE_LTE 

Activates LTE without changing GNSS.

LTE_LC_FUNC_MODE_DEACTIVATE_GNSS 

Deactivates GNSS without shutting down LTE services.

LTE_LC_FUNC_MODE_ACTIVATE_GNSS 

Activates GNSS without changing LTE.

LTE_LC_FUNC_MODE_DEACTIVATE_UICC 

Deactivates UICC.

LTE_LC_FUNC_MODE_ACTIVATE_UICC 

Activates UICC.

LTE_LC_FUNC_MODE_OFFLINE_UICC_ON 

Sets the device to flight mode without shutting down UICC.

LTE_LC_FUNC_MODE_OFFLINE_KEEP_REG 

Sets the device to flight mode while preserving the LTE registration context.

Used to change the active cellular profile when using a dual UICC solution where one of the UICCs is a SoftSIM. Allowed only when two cellular profiles have been configured.

Note
This is only supported by the following modem firmware:
  • mfw_nrf9151-ntn
LTE_LC_FUNC_MODE_OFFLINE_KEEP_REG_UICC_ON 

Sets the device to flight mode while preserving the LTE registration context and without shutting down the UICC.

Used to change the active cellular profile when using an eUICC solution with dual profiles. Allowed only when two cellular profiles have been configured.

Note
This is only supported by the following modem firmware:
  • mfw_nrf9151-ntn