Requirements and application limitations

Following are some of the requirements and limitations of the application while running this module:

  • The LwM2M carrier library registers to receive several AT event reports using the AT monitor library. The following notifications must not be deregistered by the application:

    • SMS events (AT+CNMI).

    • Packet Domain events (AT+CGEREP).

    • Extended signal quality events (AT%CESQ).

    • ODIS events (AT+ODISNTF).

    • Network Time events (AT%XTIME).

    • Modem Domain events (AT%MDMEV).

    • Report Network Error Codes events (AT+CNEC) - EPS Session Management events are used by the LwM2M carrier library. The application may enable or disable EPS Mobility Management events.

    • Network Registration Status events (AT+CEREG) - Notification Level 4 is used by the LwM2M carrier library. The application can increase this level but must not decrease it.

  • If the application wants to use eDRX, it must enable mode 2, since the LwM2M carrier library requires the unsolicited result code.

  • The Connectivity statistics AT command (AT%XCONNSTAT) should not be used by the application.

    • This command is used by the LwM2M carrier library to update the Connectivity Statistics object.

  • The application must prioritize the LwM2M carrier library requests to connect and disconnect from the network.

  • The LwM2M carrier library uses the TLS socket for FOTA.

    • The application can still use one DTLS session and one TLS session (or two DTLS sessions).

    • If the application is using the TLS socket, it must immediately close it when the LWM2M_CARRIER_EVENT_FOTA_START event is received.

    • The socket is released by the library again upon the next reboot, or in the event of a FOTA error.

    • If the application always needs a TLS socket, it can use Mbed TLS.

    • For more information, see the LWM2M_CARRIER_EVENT_FOTA_START event in LwM2M carrier library events.

  • The LwM2M carrier library provisions the necessary security credentials to the security tags 25, 26, 27, 28. These tags must not be used by the application.

  • If the Kconfig option CONFIG_LWM2M_CARRIER_SERVER_SEC_TAG is set, the range follows that sec_tag instead.

  • The CA certificates that are used for out-of-band FOTA must be provided by the application. Out-of-band FOTA updates are done by the Downloader. Although the certificates are updated as part of the nRF Connect SDK releases, you must check the requirements from your carrier to know which certificates are applicable.

  • The LwM2M carrier library requires a Non-Volatile Storage (NVS) partition to be chosen as lwm2m_carrier in the devicetree. To mark this partition as non-secure in TF-M it needs to be (part of) a partition called storage_partition.

Carrier-specific dependencies

In order for your device to comply with the carrier’s specifications, the following additional requirements apply to your application to use the carrier’s LwM2M device management:

  • In the Verizon network, the LwM2M carrier library uses both DTLS sessions made available through the modem. Therefore, the application must expect to fail (or retry) if it attempts to establish a DTLS or TLS session. The application should never use a DTLS session indefinitely, because this will block the LwM2M carrier library.

Library size

The following library sizes are reported in the Changelog:

  • Library size (binary) - This shows the standalone size of the library. This size includes all objects since the library is not linked. This size will change when linking the library to an application.

  • Library size (reference application) - This size shows the total memory impact of enabling the LwM2M carrier library in the Cellular: LwM2M carrier sample. This size accounts for the library, abstraction layer and the associated heap and stack requirements. It also includes all the resources for all the dependencies, except Modem library. See Application integration for more information.

Note

Enabling the LwM2M carrier library into the Cellular: LwM2M carrier sample serves only as a reference. The increase in memory size due to the inclusion of the LwM2M carrier library depends on the application that it is being integrated into.