Changelog

All notable changes to this project are documented in this file.

liblwm2m_carrier 0.22.0

Release for modem firmware version 1.3.1.

Certification status

For certification status, see Mobile network operator certifications.

Size

See Library size for an explanation of the library size in different scenarios.

Flash (Bytes)

RAM (Bytes)

Library size (binary)

67872

15484

Library size (reference application)

90532

37592

Changes

  • Added a new event LWM2M_CARRIER_DEFERRED_SIM_MSISDN.

    • This event can trigger on devices with a new SIM card that has not been registered on the network yet. (Therefore, it has not received the phone number needed for device management).

  • Removed dependency on the deprecated AT command and AT notification libraries from the glue layer.

  • Added dependency on the AT monitor library in the glue layer.

  • Changed the lwm2m_os_lte_link_up() function to perform an asynchronous connect.

  • Removed the following unused functions from the glue layer: lwm2m_os_sec_ca_chain_exists(), lwm2m_os_sec_ca_chain_cmp(), lwm2m_os_sec_ca_chain_write().

liblwm2m_carrier 0.21.0

Release for modem firmware version 1.3.1.

Certification status

For certification status, see Mobile network operator certifications.

Size

See Library size for an explanation of the library size in different scenarios.

Flash (Bytes)

RAM (Bytes)

Library size (binary)

75216

14275

Library size (reference application)

103104

42672

Changes

liblwm2m_carrier 0.20.1

Release for modem firmware version 1.3.0.

Certification status

For certification status, see Mobile network operator certifications.

Size

See Library size for an explanation of the library size in different scenarios.

Flash (Bytes)

RAM (Bytes)

Library size (binary)

64620

10687

Library size (reference application)

109520

35184

Changes

  • Fixed a race condition that could render the LwM2M carrier library unresponsive.

liblwm2m_carrier 0.20.0

Release for modem firmware version 1.3.0.

Certification status

For certification status, see Mobile network operator certifications.

Changes

liblwm2m_carrier 0.10.2

Release for modem firmware versions 1.2.3 and 1.1.4, and nRF Connect SDK 1.4.2.

Certification status

For certification status, see Mobile network operator certifications.

Size

See Library size for an explanation of the library size in different scenarios.

Flash (Bytes)

RAM (Bytes)

Library size (binary)

61728

10226

Library size (reference application)

97116

29552

Changes

  • LWM2M_CARRIER_EVENT_LTE_READY will be sent to the application even when the device is outside of AT&T and Verizon networks.

  • The interval to check for sufficient battery charge during FOTA has been reduced from five minutes to one minute.

liblwm2m_carrier 0.10.1

Release for modem firmware versions 1.2.2 and 1.1.4, and nRF Connect SDK 1.4.1.

Certification status

For certification status, see Mobile network operator certifications.

Changes

  • Minor fixes and improvements.

liblwm2m_carrier 0.10.0

Snapshot release for modem firmware version 1.2.2 and the upcoming version 1.1.4, and nRF Connect SDK 1.4.0.

This release is intended to let users begin integration towards the AT&T and Verizon device management platforms. Modem firmware version 1.1.4 must be used for Verizon, and the modem firmware version 1.2.2 must be used for AT&T.

The snapshot can be used for development and testing only. It is not ready for certification.

Certification status

The library is not certified with any carrier.

Changes

  • Reduced the required amount of stack and heap allocated by the library.

  • Reduced the power consumption of the library.

  • Renamed the event LWM2M_CARRIER_EVENT_READY to LWM2M_CARRIER_EVENT_REGISTERED.

  • Introduced a new event LWM2M_CARRIER_EVENT_LTE_READY, to indicate that the LTE link can be used by the application.

  • The Modem DFU socket can now be used by the application when it is not needed by the library.

liblwm2m_carrier 0.9.1

Release with AT&T support, intended for modem firmware version 1.2.1 and nRF Connect SDK version 1.3.1.

Certification status

The library is certified with AT&T.

Size

See Library size for an explanation of the library size in different scenarios.

Flash (Bytes)

RAM (Bytes)

Library size (binary)

61450

9541

Library size (reference application)

92750

30992

Changes

  • Minor fixes and improvements.

liblwm2m_carrier 0.9.0

Snapshot release for the upcoming modem firmware version 1.2.1 and the nRF Connect SDK 1.3.0.

This release is intended to let users begin integration towards the AT&T and Verizon device management platforms. It can be used for development and testing only. It is not ready for certification.

Certification status

The library is not certified with any carrier.

Changes

  • Added new APIs to create and access portfolio object instances. A new portfolio object instance can be created using lwm2m_carrier_portfolio_instance_create(). lwm2m_carrier_identity_read() and lwm2m_carrier_identity_write() are used to read and write to the corresponding Identity resource fields of a given portfolio object instance.

  • Expanded API with “certification_mode” variable that chooses between certification or live servers upon the initialization of the LwM2M carrier library.

  • Expanded API with “apn” variable to set a custom APN upon the initialization of the LwM2M carrier library.

  • PSK Key is now set independently of custom URI.

    • Added the LWM2M_CARRIER_USE_CUSTOM_BOOTSTRAP_PSK and LWM2M_CARRIER_CUSTOM_BOOTSTRAP_PSK Kconfig options.

  • PSK format has been modified to be more user-friendly.

    • Previous format: Byte array. For example, static const char bootstrap_psk[] = {0x01, 0x02, 0xab, 0xcd, 0xef};.

    • Current format: A null-terminated string that must be composed of hexadecimal numbers. For example “0102abcdef”.

liblwm2m_carrier 0.8.2

Release for modem firmware version 1.1.2, with support for Verizon Wireless.

Certification status

The library is certified with Verizon Wireless.

Changes

  • Fixed a memory leak.

  • Added lwm2m_carrier_event_deferred_t to retrieve the event reason and timeout.

  • Added FOTA errors to LWM2M_CARRIER_EVENT_ERROR event.

Size

See Library size for an explanation of the library size in different scenarios.

Flash (Bytes)

RAM (Bytes)

Library size (binary)

45152

7547

Library size (reference application)

65572

28128

liblwm2m_carrier 0.8.1+build1

Release for modem firmware version 1.1.0, with support for Verizon Wireless.

Certification status

The library is certified with Verizon Wireless.

Changes

  • Fixed a memory leak.

Size

See Library size for an explanation of the library size in different scenarios.

Flash (Bytes)

RAM (Bytes)

Library size (binary)

44856

7546

Library size (reference application)

64680

28128

liblwm2m_carrier 0.8.1

Release for modem firmware version 1.1.0, with support for Verizon Wireless.

Certification status

The library is certified with Verizon Wireless.

Changes

  • Numerous stability fixes and improvements.

  • Updated Modem library version dependency.

  • Fixed an issue where high LTE network activity could prevent modem firmware updates over LwM2M.

  • Added the following library events:

    • LWM2M_CARRIER_EVENT_CONNECTING, to indicate that the LTE link is about to be brought up.

    • LWM2M_CARRIER_EVENT_DISCONNECTING, to indicate that the LTE link is about to be brought down.

    • LWM2M_CARRIER_EVENT_DEFERRED, to indicate that the LwM2M operation is deferred for 24 hours.

    • LWM2M_CARRIER_EVENT_ERROR, to indicate that an error has occurred.

  • Renamed the following library events:

    • LWM2M_CARRIER_EVENT_CONNECT to LWM2M_CARRIER_EVENT_CONNECTED.

    • LWM2M_CARRIER_EVENT_DISCONNECT to LWM2M_CARRIER_EVENT_DISCONNECTED.

liblwm2m_carrier 0.8.0

Release for modem firmware version 1.1.0 and nRF Connect SDK v1.1.0, with support for Verizon Wireless.

Certification status

The library is not certified with Verizon Wireless.

Changes

  • Abstracted several new functions in the glue layer to improve compatibility on top of the master branch.

  • Reorganized NVS keys usage to make it range-bound (0xCA00, 0xCAFF). This range is not backward compatible, so you should not rely on pre-existing information saved in flash by earlier versions of this library.

  • Added APIs to set the following values from the application:

    • Available Power Sources

    • Power Source Voltage

    • Power Source Current

    • Battery Level

    • Battery Status

    • Memory Total

    • Error Code

    The application must set and maintain these values to reflect the state of the device. Updated values are pushed to the servers autonomously.

  • Added API to set the “Device Type” resource. If not set, this is reported as “Smart Device”.

  • Added API to set the “Software Version” resource. If not set, this is reported as “LwM2M 0.8.0”.

  • Added API to set the “Hardware Version” resource. If not set, this is reported as “1.0”.

Known issues and limitations

  • It is not possible to use a DTLS connection in parallel with the library.

  • It is not possible to use a TLS connection in parallel with LwM2M-managed modem firmware updates. The application should close any TLS connections when it receives the LWM2M_CARRIER_EVENT_FOTA_START event from the library.

liblwm2m_carrier 0.6.0

Initial public release for modem firmware version 1.0.1. This release is intended to let users begin the integration on the Verizon Wireless device management platform and start the certification process with Verizon Wireless. We recommend upgrading to the next release when it becomes available. The testing performed on this release does not meet Nordic standard for mass production release testing.

Known issues and limitations

  • It is not possible to use a DTLS connection in parallel with the library.

  • It is not possible to use a TLS connection in parallel with LwM2M-managed modem firmware updates. The application should close any TLS connections when it receives the LWM2M_CARRIER_EVENT_FOTA_START event from the library.

  • The API to query the application for resource values is not implemented yet.

    • The “Available Power Sources” resource is reported as “DC power (0)” and “External Battery (2)”.

    • The following resources are reported to have value “0” (zero):

      • Power Source Voltage, Power Source Current, Battery Level, Battery Status, Memory Free, Memory Total, Error Code.

    • The “Device Type” resource is reported as “Smart Device”.

    • The “Software Version” resource is reported as “LwM2M 0.6.0”.

    • The “Hardware Version” is reported as “1.0”.

  • The following values are reported as dummy values instead of being fetched from the modem:

    • “IP address”, reported as 192.168.0.0.

  • The “Current Time” and “Timezone” resources do not respect write operations, instead, read operations on these resources will return the current time and timezone as kept by the nRF9160 modem.