Changelog

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

nrf_modem

Core library

• Added the NRF_ECOMM error code to indicate a communication error on send.

Sockets

• Updated:

  • The nrf_send() and nrf_sendto() functions to set errno to NRF_ECOMM when data transmission with the NRF_MSG_WAITACK flag fails.

  • The NRF_SO_SENDCB callback to report NRF_ECOMM as the status when data transmission fails.

DECT NR+

• Added the NRF_MODEM_DECT_PHY_EVT_REJECT enumeration value to indicate rejected operations.

nrf_modem 3.3.0

The library is now released in three variants, with different feature sets and support for different variants of the nRF91 Series firmware.

• The cellular variant, with support for cellular firmware.

• The DECT PHY variant, with support for DECT NR+ PHY firmware.

• The DECT variant, with support for DECT NR+ firmware.

DECT NR+

• Added:

  • A new interface for the DECT NR+ firmware.

  • Clarifications concerning the operation start times in the nrf_modem_dect_phy.h header file.

  • Clarifications concerning the reference signal tracking precision in the nrf_modem_dect_clock_sync.h header file.

• Updated the radio modes section of the DECT NR+ physical layer documentation to include detailed descriptions of the radio states and their associated latencies.

Sockets

• Updated the nrf_socket.h header file with more detailed descriptions of the supported socket options.

nrf_modem 3.2.0

Core library

• Added the RS Capture API to receive reference signal samples.

DECT NR+

• Added the DECT clock synchronization API for precise timing with external 1 PPS signals. See the DECT clock sync API for more information.

  • The nrf_modem_dect_clock_sync_enable() and nrf_modem_dect_clock_sync_disable() functions to control external clock synchronization.

  • The nrf_modem_dect_clock_sync_get_pulse_info() function to query synchronization pulse timing.

  • The nrf_modem_dect_clock_sync_get_state() function to retrieve synchronization status and accuracy.

  • The nrf_modem_dect_clock_sync_enable_ref_output() and nrf_modem_dect_clock_sync_disable_ref_output() functions to control reference signal output on the COEX1 pin.

  • The nrf_modem_dect_clock_sync_event_handler_set() function to set the event handler for asynchronous operations.

• Added:

  • The nrf_modem_dect_phy_test_rf_tx_cw_control() function to control continuous wave transmission for device certification purposes.

  • The NRF_MODEM_DECT_PHY_ERR_HANDLE_IN_USE enumeration value.

Sockets

• Added:

  • The NRF_SO_SENDCB socket option to set a send callback. The callback is called when a send request is acknowledged by the network and the data has been acknowledged by the peer, if required by the network protocol. This socket option is supported by the nRF9151 NTN modem firmware.

  • The NRF_SO_SEC_DTLS_FRAG_EXT socket option to enable and disable the DTLS fragmentation extension. This socket option is supported by modem firmware v2.0.4 and higher.

nrf_modem 3.1.0

Sockets

• Added:

  • The nrf_socket_data_enabled_set() function to enable and disable data traffic through the socket interface.

  • The nrf_socket_data_enabled_get() function to retrieve the current data enabled state.

  • The NRF_SEC_TAG_TLS_INVALID macro as a designated value to represent an invalid nrf_sec_tag_t.

nrf_modem 3.0.0

Core library

• Fixed a bug introduced in the nrf_modem_init() function in version 2.3.0, where the library would use the function’s input parameter after the function had returned. This could cause several socket functions to return an error and set errno to NRF_EINVAL. If you use a version of this library from v2.3.0 to v2.9.0 outside of the nRF Connect SDK and are initializing the library by calling the nrf_modem_init() function, ensure that the parameter of the nrf_modem_init() function is always static.

AT interface

• Updated the nrf_modem_at_cmd_custom_set() function documentation to emphasize that the custom command list must be statically allocated.

• Fixed:

  • A bug where a custom AT command would not be recognized due to incompatible line ending in the terminal and application.

  • A bug in the nrf_modem_at_scanf() function where calling nrf_modem_at_scanf() from within a CFUN hook triggered by another call to nrf_modem_at_scanf() could cause the modem to crash in some situations.

Sockets

• Updated the nrf_setdnsaddr() function documentation to clarify when the fallback DNS address is used and that the fallback DNS does not overwrite the network-provided DNS.

• Fixed:

  • A bug where setting the value of the NRF_SO_SEC_HOSTNAME socket option could led to a crash if the value had been previously cleared using the nrf_setsockopt() function and setting option_len equal to zero.

  • A bug where getting the value of the NRF_SO_SEC_ROLE socket option would return an incorrect value for the client role.

Softsim

• Updated:

  • The nrf_modem_softsim_res() and the nrf_modem_softsim_err() functions to now return -NRF_EPERM if the Modem library is not initialized.

  • The data parameter of the nrf_modem_softsim_res() function with the const data type qualifier since the data is not modified by the function.

DECT NR+

Added support for DECT PHY firmware v1.1.0 with new features and improvements, notably:

• Hardware and software initialization of the stack are now separate operations.

• Full support for scheduled operations.

• Extended operation latency and band information.

• Automatic voltage measurement and reporting during operation.

Important

Due to incompatibilities between the DECT PHY 1.0.x and 1.1.0 firmware versions, this version of the library is only compatible with DECT PHY firmware version 1.1.0 and newer.

• Added:

  • The event types for all operations, and the nrf_modem_dect_phy_event_id event ID enumeration.

  • Transaction IDs to the PCC and PDC events to map the two together.

  • The nrf_modem_dect_phy_activate() function to activate the DECT PHY stack.

  • The nrf_modem_dect_phy_deactivate() function to deactivate the DECT PHY stack.

  • The nrf_modem_dect_phy_configure() function to configure the DECT PHY stack.

  • The nrf_modem_dect_phy_radio_config() function to configure the radio mode.

  • The nrf_modem_dect_phy_band_get() function to retrieve the bands supported by the firmware.

  • The nrf_modem_dect_phy_latency_get() function to retrieve the operation latencies.

  • The NRF_MODEM_DECT_PHY_VOLTAGE_NOT_MEASURED macro to indicate the voltage was not measured.

  • The NRF_MODEM_DECT_PHY_ERR_RADIO_MODE_CONFLICT and NRF_MODEM_DECT_PHY_ERR_TX_POWER_OVER_MAX_LIMIT enumeration values.

• Updated:

  • The nrf_modem_dect_phy_rx_stop function was renamed to nrf_modem_dect_phy_cancel() and can now be used to cancel any operation.

  • The nrf_modem_dect_phy_callback_set function was renamed to nrf_modem_dect_phy_event_handler_set(). Instead of providing a set of callbacks, one for each operation, the application now sets a single event handler function to receive events.

• Removed:

  • The nrf_modem_dect_phy_callbacks struct. The application now sets a single event handler using the nrf_modem_dect_phy_event_handler_set() function instead.

  • The nrf_modem_dect_phy_modem_cfg struct.

  • The NRF_MODEM_DECT_PHY_ERR_NO_ONGOING_OP enumeration value.

nrf_modem 2.9.0

Sockets

• Updated the nrf_send() and nrf_sendto() functions to correctly set errno when the socket is closed during a send operation with NRF_MSG_WAITACK.

DECT NR+

• Added a field to the nrf_modem_dect_phy_init_params struct to control band 4 support for nRF9151 devices.

nrf_modem 2.8.0

Core library

• Added:

  • A header file nrf_modem_toolchain.h for compiler attributes used in other header files.

  • Binaries for the nRF9230 SoC for internal development.

  • A header file nrf_modem_os_rpc.h for the nRF9230 SoC RPC OS glue.

AT interface

• Added:

  • Logging for AT responses and notifications to the logging binaries.

  • Format helpers to AT functions that take a variable number of arguments to improve type checking.

Sockets

• Added:

  • The capability to read the value of the NRF_SO_KEEPOPEN socket option with modem firmware v2.0.2 and higher.

  • The NRF_SO_IPV6_DELAYED_ADDR_REFRESH socket option to delay the IPv6 address refresh until the device wakes up from PSM or eDRX sleep. This prevents the device from waking up solely to refresh the address. This socket option is supported by modem firmware v1.3.7 and higher and modem firmware v2.0.2 and higher.

• Updated the nrf_getaddrinfo() function to support up to three concurrent DNS requests.

• Removed:

  • The deprecated types nrf_sec_cipher_t, nrf_sec_peer_verify_t, nrf_sec_role_t, and nrf_sec_session_cache_t.

  • The deprecated RAI socket options NRF_SO_RAI_NO_DATA, NRF_SO_RAI_LAST, NRF_SO_RAI_ONE_RESP, NRF_SO_RAI_ONGOING, and NRF_SO_RAI_WAIT_MORE.

DECT NR+

• Added:

  • Physical layer control field header formats.

  • New API for STF cover sequence control. This API is intended for certification purposes only and should not be used under normal operation.

• Updated the documentation to state that RSSI reporting interval is measured in slots and not subslots.

Tracing

• Updated the function nrf_modem_trace_get() to now return -NRF_EPERM if trace interface is not initialized.

nrf_modem 2.7.0

The library is now released in two variants, with different feature sets and support for different variants of the nRF91 Series firmware.

• The cellular variant, with support for cellular firmware.

• The DECT PHY variant, with support for DECT NR+ PHY firmware.

Core library

• Updated:

  • The minimum requirement for the NRF_MODEM_SHMEM_BOOTLOADER_SIZE from 0x201c to 0x2018.

  • The modem trace functionality to support future modem firmwares.

AT interface

• Added the nrf_modem_at_cmd_custom.cmd_strlen field to hold the AT filter length.

• The custom AT command filters now use the longest AT filter match. This allows to have for example filters for both AT#XSOCKET and AT#XSOCKETOPTION.

DECT NR+

• Added new interface for the DECT NR+ PHY firmware.

nrf_modem 2.6.1

Sockets

• Fixed a bug where the nrf_recv() and nrf_recvfrom() functions erroneously returned –1 and set errno to NRF_EAGAIN instead of returning 0 when these three conditions were met:

  • The nrf_recv() and nrf_recvfrom() functions were called with the NRF_MSG_DONTWAIT flag or when the socket is non-blocking (NRF_O_NONBLOCK is set on the socket).

  • The socket was closed by the server.

  • There was no more data to read (End Of File (EOF)).

nrf_modem 2.6.0

Core library

• Added the nrf_modem_os_mutex_init(), nrf_modem_os_mutex_lock() and nrf_modem_os_mutex_unlock() functions to meet the OS requirements.

• Fixed a bug where some modem faults during initialization were not sent to the modem fault handler function as intended.

Sockets

• Added:

  • The new NRF_SO_KEEPOPEN socket option to allow sockets to remain open when their PDN connection is lost, or the device is set to flight mode.

  • The RAI socket option NRF_SO_RAI and the values NRF_RAI_NO_DATA, NRF_RAI_LAST, NRF_RAI_ONE_RESP, NRF_RAI_ONGOING, and NRF_RAI_WAIT_MORE.

  • A set of security tags that can be used for testing and debugging purposes, to allow the Cellular Monitor application to decrypt TLS traffic.

• Updated:

  • The nrf_sa_family_t type definition to unsigned short (from unsigned int), to reduce the size of the socket address types.

  • The type of the field nrf_sockaddr.sa_family to nrf_sa_family_t (from int).

  • The type of the field nrf_sockaddr_in6.sin6_scope_id to uint8_t (from uint32_t).

  • The NRF_SO_RCVTIMEO socket option can now be used to set a timeout for the nrf_accept() operation.

• Fixed:

  • Rare multi-threading bugs in the nrf_socket(), nrf_recv(), and nrf_connect() functions.

  • A bug in the nrf_accept() function that caused it to not wait for a connection as intended.

  • A bug where the NRF_POLLNVAL event would not be reported when using poll callbacks set with the NRF_SO_POLLCB socket option.

  • A bug where retrieving the value of NRF_SO_SEC_HOSTNAME caused a bad memory access, if the option had not been set.

• Deprecated:

  • The nrf_sec_cipher_t, nrf_sec_peer_verify_t, nrf_sec_role_t, and nrf_sec_session_cache_t types. Use int instead.

  • The RAI socket options NRF_SO_RAI_NO_DATA, NRF_SO_RAI_LAST, NRF_SO_RAI_ONE_RESP, NRF_SO_RAI_ONGOING, and NRF_SO_RAI_WAIT_MORE.

• Removed the field nrf_sockaddr_in6.sin6_flowinfo, to reduce the size of the nrf_sockaddr_in6 structure. The field was unsupported.

AT interface

• Added the nrf_modem_at_cfun_handler_set() function to set a callback for functional mode changes.

• Updated the custom AT commands to be case-insensitive.

GNSS interface

• Added:

  • The NRF_MODEM_GNSS_DELETE_EKF flag for the nrf_modem_gnss_nv_data_delete() function to delete Extended Kalman Filter (EKF) state data.

  • The NRF_MODEM_GNSS_PVT_FLAG_SCHED_DOWNLOAD flag to indicate that the GNSS is running because of a scheduled download.

nrf_modem 2.5.0

Core library

• Added:

  • The SoftSIM to use a software SIM with the cellular modem.

  • Binaries for the nRF9120 SoC (nRF9161 SiP).

• Updated:

  • The nrf_modem_init() function is no longer required to be called twice when updating the modem firmware.

  • The folder structure for the library binaries. The binaries are now used by the SoC they support instead of the processor.

Sockets

• Added:

  • The NRF_SO_EXCEPTIONAL_DATA socket option to enable sending data as part of exceptional events (3GPP).

  • The NRF_MSG_WAITACK flag to request a blocking send operation until the request is acknowledged by the network.

  • Enhanced APN rate control.

• Removed the sa_len, sin_len, and sin6_len callbacks from the nrf_sockaddr, nrf_sockaddr_in, and nrf_sockaddr_in6 structs, respectively.

• Replaced the NRF_SO_BINDTODEVICE socket option with NRF_SO_BINDTOPDN. The new option takes an integer for the PDN ID.

AT interface

• Added the option to set a timeout for the waiting time for the ongoing AT commands to complete by calling the nrf_modem_at_sem_timeout_set() function.

• The nrf_modem_at_cmd_async() function now immediately returns if there is another AT command pending, regardless of whether it was sent with the nrf_modem_at_cmd_async() function or other API calls.

GNSS interface

• Added:

  • Support for QZSS assistance. Because of this, all A-GPS references in the API have been updated to A-GNSS.

  • Maximum speeds for dynamics modes.

• Updated:

  • The NRF_MODEM_GNSS_EVT_AGPS_REQ event has been renamed to NRF_MODEM_GNSS_EVT_AGNSS_REQ.

  • The NRF_MODEM_GNSS_DATA_AGPS_REQ data type has been renamed to NRF_MODEM_GNSS_DATA_AGNSS_REQ.

  • The nrf_modem_gnss_agps_data_frame struct has been renamed to nrf_modem_gnss_agnss_data_frame.

  • The nrf_modem_gnss_agps_expiry struct has been renamed to nrf_modem_gnss_agnss_expiry.

  • The nrf_modem_gnss_system_mask_set() function has been renamed to nrf_modem_gnss_signal_mask_set().

  • The nrf_modem_gnss_agps_write() function has been renamed to nrf_modem_gnss_agnss_write().

  • The nrf_modem_gnss_agps_expiry_get() function has been renamed to nrf_modem_gnss_agnss_expiry_get().

  • nrf_modem_gnss_agnss_data_frame and nrf_modem_gnss_agnss_expiry structs to contain A-GNSS data need for multiple systems.

  • Expiration times in nrf_modem_gnss_agnss_expiry struct from seconds to minutes.

Delta DFU

• Added the nrf_modem_init_params.dfu_handler callback that will be called after a DFU, and returns the result of the update.

Bootloader

• The nrf_modem_bootloader_digest() function now takes a list of firmware segments as input. The resulting digest is an array of 32-bit integers.

nrf_modem 2.4.1

• Added a workaround for mfw v1.3.5 where attaching to the network would fail with error 90 (UICC initialization failure) after performing a modem firmware update, until the modem is re-initialized.

nrf_modem 2.4.0

Sockets

• Added

  • The NRF_SO_SEC_DTLS_CID and NRF_SO_SEC_DTLS_CID_STATUS socket options for DTLS connection ID.

  • The NRF_SO_SEC_DTLS_CONN_SAVE and NRF_SO_SEC_DTLS_CONN_LOAD socket options.

  • The NRF_SO_SEC_CIPHERSUITE_USED socket option (requires modem firmware v2.0.0).

  • The NRF_SO_SEC_HANDSHAKE_STATUS socket option (requires modem firmware v2.0.0).

  • The NRF_SOCKET_TLS_MAX_SEC_TAG_LIST_SIZE macro to indicate the maximum number of security tags that can be associated with a socket.

  • Several new macros for allowed TLS/DTLS socket option values.

• Fixed a memory leak in the nrf_getsockopt() function, in certain cases where the function returned an error.

• The NRF_MODEM_MAX_SOCKET_COUNT macro was moved from nrf_modem.h to nrf_socket.h.

AT interface

• Renamed the at_cmd_filter to at_cmd_custom:

  • The nrf_modem_at_cmd_handler_t type is renamed to nrf_modem_at_cmd_custom_handler_t.

  • The nrf_modem_at_cmd_filter struct is renamed to nrf_modem_at_cmd_custom.

  • The nrf_modem_at_cmd_filter_set() function is renamed to nrf_modem_at_cmd_custom_set().

• The paused field was removed from the nrf_modem_at_cmd_custom. It is no longer possible to pause the dispatching of custom AT commands to their handler function.

Delta DFU

• It is no longer necessary to call the nrf_modem_shutdown() function after updating the modem firmware. The application can call the nrf_modem_init() function to execute the update, and call that function again to run the modem firmware.

Tracing

• Fixed a bug where the nrf_modem_trace_get() function would attempt to take an uninitialized semaphore if called when tracing was disabled.

nrf_modem 2.3.1

Sockets

• Fixed a bug where the callbacks for poll events were not called.

nrf_modem 2.3.0

Core library

• The nrf_modem_init() function is now used only to initialize the library in normal operating mode. Use nrf_modem_bootloader_init() to initialize the library in bootloader mode.

• Added a context parameter to nrf_modem_os_event_notify() to allow waking up only a subset of sleeping threads.

• Added the nrf_modem_os_sleep() function.

• The nrf_modem_limits.h file has been removed.

Sockets

• Added the NRF_SO_POLLCB socket option to receive callbacks for poll events occurring on a socket.

• Added the nrf_getifaddrs() and nrf_freeifaddrs() functions to retrieve network interface data.

• Fixed a bug where not reading incoming network data in a timely manner could hang the communication with the modem.

• Fixed a bug in nrf_connect() where a blocking call could in certain cases time out and set the wrong errno (EBUSY instead of ETIMEDOUT).

• Fixed a bug in nrf_poll() where only the first nrf_pollfd structure would be updated in case the modem was shut down.

• Fixed a bug in nrf_setsockopt() where setting NRF_SO_RAI_NO_DATA on a TCP socket where the peer had closed the connection would return an error.

• Fixed a bug in nrf_send() and nrf_sendto() where the functions would hang when attempting to send a data payload larger than the TX region.

• Fixed a possible concurrency bug in nrf_socket().

• Fixed a possible concurrency bug in nrf_accept().

AT interface

• Improved error checking in nrf_modem_at_cmd() and nrf_modem_at_printf().

GNSS interface

• Added the nrf_modem_gnss_agps_expiry.position_expiry field to nrf_modem_gnss_agps_expiry to retrieve the position assistance expiry time.

Bootloader

• The Full DFU API (nrf_modem_full_dfu.h) has been moved to (nrf_modem_bootloader.h) and renamed accordingly. The nrf_modem_full_dfu_apply() function has been renamed to nrf_modem_bootloader_update().

• The order of parameters to functions which accepted a buffer and its length has changed, so that the buffer parameter is always passed before the length parameter.

• The MODEM_DFU_RESULT_ macros have been prefixed with NRF_.

nrf_modem 2.2.1

• Added the MODEM_DFU_RESULT_VOLTAGE_LOW result to nrf_modem_init() function. The new value is returned when the voltage is too low for the modem firmware to execute the scheduled modem firmware update. The application can retry the operation by re-initializing the modem when the voltage has increased. Requires modem firmware v1.3.4 or newer.

• Updated the library to use nrfx v2.10 APIs.

nrf_modem 2.2.0

• Added a timeout parameter to the nrf_modem_trace_get() function.

• Fixed an issue when compiling the nrf_modem.h header in C++.

• The Delta DFU interface (nrf_modem_delta_dfu.h) is now thread safe.

• Fixed possible race conditions in the nrf_modem_init() and nrf_modem_shutdown() functions.

• Fixed a bug in nrf_listen() function that let the queue of incoming connection requests be of size one.

• The NRF_MODEM_GNSS_EVT_BLOCKED event is now sent only when the GNSS stack does not get any runtime due to LTE activity, whereas earlier it could also be sent when the GNSS stack average runtime was too short.

• Removed the usage of the application software interrupt. The library uses only the IPC peripheral interrupt now.

• Removed the nrf_modem_application_irq_handler() function.

• Removed the nrf_modem_platform.h file.

nrf_modem 2.1.3

• Fixed a bug that prevented the GNSS API from correctly re-initializing after a modem fault.

nrf_modem 2.1.2

• Fixed a bug where, in rare cases, the nrf_modem_trace_get() function could report the trace length incorrectly.

nrf_modem 2.1.1

• Fixed a bug that caused poor tracing performance.

nrf_modem 2.1.0

• Major improvements to modem tracing. The application can now obtain trace data using the newly introduced nrf_modem_trace_get() function. Traces can be processed as necessary, and freed using the nrf_modem_trace_processed() function. The following functions have been removed from the OS glue:

  • nrf_modem_os_trace_put()

  • nrf_modem_os_trace_alloc()

  • nrf_modem_os_trace_free()

  • nrf_modem_os_trace_irq_set()

  • nrf_modem_os_trace_irq_clear()

  • nrf_modem_os_trace_irq_enable()

  • nrf_modem_os_trace_irq_disable()

  The following functions have been removed from the nrf_modem.h file:

  • nrf_modem_trace_irq_handler()

  • nrf_modem_trace_processed_callback()

• Improvements to AT filters. AT filters now apply to the formatted AT command. The paused is added to the nrf_modem_at_cmd_filter structure to pause filters whenever required.

• Added support for modem’s POFWARN related errors.

• Fixed a bug where closing a (D)TLS socket during the TLS handshake could make further calls to nrf_connect() fail.

• Fixed a bug where the nrf_send() function could return an error without setting an errno.

• When called with NRF_MSG_WAITALL, the nrf_recv() function now returns the number of bytes received so far in case the socket is closed, or when the TCP connection is terminated by the remote peer.

• Fixed a bug where, in rare cases, the nrf_recv() function on a NRF_SOCK_STREAM socket incorrectly returned 0 even though more bytes were available to read.

• Fixed a bug where, in rare cases, the nrf_recv() function would crash.

• Fixed a few instances of incorrect return values from the nrf_getaddrinfo() function.

• Removed the nrf_socket_family_t type.

• Removed the unimplemented NRF_SO_SEC_CIPHER_IN_USE socket option.

• Removed several type definitions.

nrf_modem 2.0.1+b1

• Corrected the ABI for the hard-float binary.

nrf_modem 2.0.1

• Minor improvements to nrf_modem_shutdown().

• Fixed a bug where nrf_modem_build_version() did not give the correct version number.

nrf_modem 2.0.0

• Numerous fixes and improvements to networking sockets.

• Increased logging output (in log version of the library).

• Improved modem fault handling. A new field has been added to nrf_modem_init_params_t to receive a callback upon modem faults.

• Added modem fault reasons to the nrf_modem.h file.

• Added nrf_modem_is_initialized() function to query the modem initialization status.

• Added nrf_modem_os_event_notify() function to wake up threads sleeping in the nrf_modem_os_timedwait() function.

• Added nrf_modem_os_sem_count_get() function to retrieve a semaphore’s count.

• Added nrf_modem_os_trace_alloc() and nrf_modem_os_trace_free() functions to allocate trace metadata on a dedicated memory heap.

• Updated nrf_modem_shutdown() function to shutdown quicker when a debugger is attached or the modem has faulted.

• Updated nrf_modem_os_timedwait() function to return negative values, aligning with other APIs.

• Updated nrf_modem_os_sem_take() function to return -NRF_EAGAIN on error.

• Renamed the option NRF_SO_HOSTNAME to NRF_SO_SEC_HOSTNAME.

• Renamed the option NRF_SO_CIPHERSUITE_LIST to NRF_SO_SEC_CIPHERSUITE_LIST.

• Renamed the option NRF_SO_CIPHER_IN_USE to NRF_SO_SEC_CIPHER_IN_USE.

• Fixed a bug which could lead to NRF_MODEM_GNSS_EVT_FIX event being sent before NRF_MODEM_GNSS_EVT_UNBLOCKED event.

• Removed the nrf_modem_recoverable_error_handler() function.

• Removed the nrf_modem_os_log_strdup() function.

• Removed NRF_MODEM_AT_MAX_CMD_SIZE and NRF_MODEM_IP_MAX_MESSAGE_SIZE macros from nrf_modem_limits.h.

• Removed unused NRF_SPROTO_TLS1v3 macro.

• Removed unused NRF_MSG_DONTROUTE, NRF_MSG_OOB, NRF_MSG_TRUNC macros.

• Removed unimplemented nrf_select function and relative NRF_FD_* macros.

• Removed unused nrf_sec_config_t type.

nrf_modem 1.5.2

• Added nrf_modem_os_trace_irq_enable() and nrf_modem_os_trace_irq_disable() functions.

• Added support for calling nrf_modem_trace_processed_callback() from a thread.

nrf_modem 1.5.1

• Fixed a bug where nrf_modem_trace_processed_callback() could crash in some cases.

nrf_modem 1.5.0

• Added support for deferred processing of modem traces. Introduced the nrf_modem_trace_processed_callback() function that the application must call after it has processed a trace received in nrf_modem_os_trace_put().

• It is now possible to unset the AT notification handler by passing NULL to nrf_modem_at_notif_handler_set().

• The number of required semaphores is now exported in nrf_modem_os.h.

• Removed the AT socket.

• Removed the DFU socket.

• Fixed a bug where nrf_getsockopt() do not truncate the socket option as intended when the buffer provided was too small.

• Fixed a bug where closing a socket while another thread was in a recv() operation on the same socket would result in a crash.

• Fixed a bug in the delta DFU interface where the nrf_modem_delta_dfu_offset() call returns an unexpected error code in some cases.

nrf_modem 1.4.1

• Fixed a bug in nrf_send() which could result in the function incorrectly returning –1 and setting the errno to NRF_EINPROGRESS.

nrf_modem 1.4.0

• The PDN socket has been removed.

• The GNSS socket has been removed.

• nrf_errno errno values have been aligned with those of newlibc.

• The Modem API (nrf_modem.h) has been updated to return negative errno values on error.

• The Full Modem DFU API (nrf_modem_full_dfu.h) has been updated to return negative errno values on error.

• The GNSS API (nrf_modem_gnss.h) has been updated to return negative errno values on error.

• The nrf_modem_gnss_init() and nrf_modem_gnss_deinit() functions have been removed.

• Added the GNSS velocity estimate validity bit NRF_MODEM_GNSS_PVT_FLAG_VELOCITY_VALID.

• Added the GNSS delete bitmask NRF_MODEM_GNSS_DELETE_GPS_TOW_PRECISION for time-of-week precision estimate.

• Added support for several new fields in the GNSS PVT notification.

• Added support for retrieving GNSS A-GPS data expiry.

• Added the nrf_modem_at_cmd_filter_set() function to set a callback for custom AT commands.

• Fixed a bug in nrf_modem_at_cmd_async() which could result in the wrong response being returned, or a bad memory access.

• The application can no longer specify the APN to be used with a socket using the NRF_SO_BINDTODEVICE socket option.

• The application can no longer specify the APN to be used for DNS queries using the ai_canonname field of the input hints structure in nrf_getaddrinfo().

• Fixed a potential concurrency issue in nrf_getaddrinfo() that would cause the output hints structure to contain no address upon successful completion.

• Fixed a bug in nrf_getsockopt() that would let the function return an incorrect value in case of error when called on TLS and DTLS sockets.

• Added a parameter to nrf_setdnsaddr() to specify the size of the supplied address.

• Updated nrf_setdnsaddr() to return –1 and set errno on error.

• The nrf_modem_os_application_irq_handler() and nrf_modem_os_trace_irq_handler() functions have been renamed to nrf_modem_application_irq_handler() and nrf_modem_trace_irq_handler() respectively, and their definition has been moved to nrf_modem.h.

• Added support for APN rate control feature of modem firmware v1.3.1.

• The glue layer now defines a few new functions used for logging.

• An additional version of the library is released, which is capable of outputting logs. A minimal set of logs has been added for this release.

• All library versions are now released with debugging symbols.

nrf_modem 1.3.0

• Added new AT interface for AT commands.

• Added new Delta DFU interface for modem firmware delta updates.

• The AT socket has been deprecated.

• The DFU socket has been deprecated.

• Fixed a bug in nrf_send() for blocking sockets where calling the function very quickly would cause the application to hang up.

nrf_modem 1.2.2

• Fixed a memory leak in nrf_recv() when reading many packets quickly.

• Fixed a bug in nrf_getaddrinfo() where the function was not returning the proper protocol suggested by the hints.

• Fixed a bug in nrf_getaddrinfo() where specifying NRF_AF_UNSPEC would incorrectly return an error.

• Fixed a bug in nrf_setsockopt() where the option NRF_SO_HOSTNAME would incorrectly return an error when the hostname was NULL and optlen was 0.

• Fixed a bug in nrf_modem_gnss_init() where calling the function would lead to field accuracy speed to always be 0 and to the new GNSS events not working. This issue would occur when GNSS is not enabled in %XSYSTEMMODE and modem functional mode is not online.

nrf_modem 1.2.1

• Fixed an issue where nrf_getaddrinfo() would set a wrong errno when returning NRF_EAI_SYSTEM.

• Fixed an issue where the NRF_SO_TCP_SRV_SESSTIMEO, NRF_SO_SILENCE_IP_ECHO_REPLY and NRF_SO_SILENCE_IPV6_ECHO_REPLY socket options returned an error when set using nrf_setsockopt().

• Renamed the socket option NRF_SO_SILENCE_IP_ECHO_REPLY to NRF_SO_IP_ECHO_REPLY.

• Renamed the socket option NRF_SO_SILENCE_IPV6_ECHO_REPLY to NRF_SO_IPV6_ECHO_REPLY.

nrf_modem 1.2.0

• Added the new GNSS API.

• The GNSS socket has been deprecated.

• Added the NRF_SO_TCP_SRV_SESSTIMEO socket option to control TCP server timeout.

• Added the NRF_AF_UNSPEC address family for nrf_getaddrinfo().

• The NRF_POLLIN flag is now set with NRF_POLLHUP for stream sockets.

nrf_modem 1.1.0

• The PDN socket has been deprecated.

• Added the possibility to specify the PDN ID to bind a socket by using the NRF_SO_BINDTODEVICE socket option.

• Added the NRF_AI_PDNSERV flag for nrf_getaddrinfo() to specify the PDN ID to route a DNS query.

• Added the NRF_SO_SEC_DTLS_HANDSHAKE_TIMEO socket option to set the DTLS handshake timeout.

• Added the NRF_SO_SEC_SESSION_CACHE_PURGE socket option to purge TLS/DTLS session cache.

• Updated nrf_connect() to set errno to NRF_ECONNREFUSED when failing due to a missing certificate, wrong certificate, or a wrong private key.

• Updated nrf_getaddrinfo() to return POSIX-compatible error codes from nrf_gai_error.h.

• Fixed a potential concurrency issue in nrf_getaddrinfo().

• Fixed the nrf_poll() behavior when fd is less than zero.

• Fixed the nrf_poll() behavior when nfds is zero.

nrf_modem 1.0.3

• Fixed an issue (introduced in version 1.0.2) where nrf_recv() did not return as soon as the data became available on the socket.

• Fixed an issue (introduced in version 1.0.2) where nrf_send() did not correctly report the amount of data sent for TLS and DTLS sockets.

nrf_modem 1.0.2

• Implemented RAI (Release Assistance Indication) support in Modem library.

• Fixed an issue that leads to the reporting of both NRF_POLLIN and NRF_POLLHUP by nrf_poll() when a connection is closed by the peer.

• Fixed an issue where a nrf_recv() call on a non-blocking socket would not always behave correctly when the NRF_MSG_WAITALL flag or the NRF_MSG_DONTWAIT flag was used.

• Fixed an issue where a blocking nrf_send() could return before sending all the data in some cases.

• Reduced the Heap memory usage in nrf_recv() by 20 percent when using IPv4.

• nrf_listen() on a connected socket will now correctly set errno to NRF_EINVAL, instead of NRF_EBADF.

• nrf_accept() on a non-listening socket will now correctly set errno to NRF_EINVAL, instead of NRF_EBADF.

• Added support for binding RAW sockets to PDNs.

nrf_modem 1.0.1

• Reverted the nrf_getaddrinfo() function behavior to be the same as in v0.8.99, since the LwM2M carrier library is not compatible with the newly introduced POSIX errors codes yet.

• Removed the nrf_gai_error.h header.

nrf_modem 1.0.0

• Added support for full modem firmware updates.

• Added support for configuring the size and location of the shared memory area.

• Switched to an external memory allocator that is provided by the glue.

• Added a macro to retrieve the library version.

• Added a function to retrieve the library build version.

• Updated to return POSIX error codes in nrf_getaddrinfo().

• Fixed an issue where nrf_poll() would incorrectly report NRF_POLLERR.

• Fixed an issue where nrf_getsockopt() called with NRF_SO_PDN_STATE would incorrectly set errno.

• Fixed an issue where disabling the trace output causes the modem to crash in some situations.

nrf_modem 0.8.99

• Renamed from bsdlib to Modem library (nrf_modem).

• Enabled size optimizations and reduced FLASH footprint.

bsdlib 0.8.1

• Fixed compatibility issue with SES.

• Fixed an issue with a strcmp in the PDN socket that might compare to long strings in some cases.

bsdlib 0.8.0

• Fixed the issue with stalled TLS handshake.

• Fixed the issue with TLS connection where nrf_connect() hangs.

• Fixed the issue of nrf_sendto() timeout not working in some cases.

• Updated the documentation to reflect that NRF_SO_CHIPER_IN_USE is not currently supported.

• Fixed the issue of missing AT socket and POLLIN events.

• Added support for PDN authentication parameters.

• Added flushing of the GNSS socket queue if the stop command is issued.

• Added support for GPS low accuracy use case.

bsdlib 0.7.9

• Fixed an issue introduced with the TLS server support that made nrf_connect() hang forever.

bsdlib 0.7.8

• Fixed the issue where the modem communication would not work after a shutdown-init sequence.

• Added TLS server support

bsdlib 0.7.7

• Fixed a bug in bsd_init() (introduced in the version 0.7.5) that caused the library to be in an inconsistent state when updating the modem firmware.

bsdlib 0.7.6

• Added bsdlib support for TLS_CIPHERSUITE_LIST. getsockopt() lists the supported cipher suites and setsockopt() selects a supported cipher suite.

• Support for sending packets sized more than 2048 bytes in TLS socket.

bsdlib 0.7.5

• Updated bsd_shutdown() to perform a proper shutdown of the modem and the library.

• Updated bsd_init() to properly support multiple initializations of the modem and the library.

bsdlib 0.7.4

• New socket options added:SILENCE_ALL, SILENCE_IP_ECHO_REPLY, SILENCE_IPV6_ECHO_REPLY and REUSEADDR

• Fix to fidoless trace disable

bsdlib 0.7.3

• Aligned the naming of nrf_pollfd structure elements with pollfd.

• Fixed IP socket state after accept() function call.

bsdlib 0.7.2

• Added support in bsd_init() to disable fidoless traces and define the memory location and amount reserved for bsdlib.

bsdlib 0.7.1

• Updated GNSS documentation.

• Changing socket mode from non-blocking to blocking when there is a pending connection will now give an error.

• Fixed an issue where FOTA would hang after reboot.

bsdlib 0.7.0

• Major rewrite of the lower transport layer to fix an issue where packages were lost in a high bandwidth application.

• Added support for GPS priority setting to give the GPS module priority over LTE to generate a fix.

• Added parameter checking and only return –1 on error for the PDN set socket option function.

• Added support for send timeout on TCP, UDP (including secure sockets), and AT sockets.

• Added support for MSG_TRUNC on AT, GNSS, TCP, and UDP sockets.

• Allocating more sockets than available will now return ENOBUFS instead of ENOMEM.

• Delete mask can now be applied in stopped mode, without the need to transition to started mode first.

• ai_canonname in the addrinfo structure is now properly allocated and null-terminated.

• Fixed a bug where bsdlib_shutdown() did not work correctly.

• PDN is now disconnected properly if nrf_connect() fails.

• Fixed a bug in the GPS socket driver where it would try to free the same memory twice.

• Fixed a bug where TCP/IP session would hang when the transfer is completed.

• Fixed various GNSS documentation issues.

bsdlib 0.6.2

• TLS session cache is now disabled by default due to missing support in modem firmware version 1.1.1 and older.

• When passing an address, the function sendto() now sets the errno to NRF_EISCONN instead of NRF_EINVAL if the socket type is NRF_SOCK_STREAM.

• Calling connect() on an already connected socket now properly returns NRF_EISCONN instead of NRF_EBADF.

• Sockets with family NRF_AF_LTE must now be created with type NRF_SOCK_DGRAM.

• Setting the timeout in recv() to a larger than the maximum supported value now properly returns NRF_EDOM instead of NRF_EINVAL.

• Fixed an overflow in timeout computation.

• Operations on sockets that do not match the socket family now return NRF_EAFNOSUPPORT instead of NRF_EINVAL.

• Creating a socket when no sockets are available now returns NRF_ENOBUFS instead of NRF_ENOMEM.

• Improved validation of family, type, and protocol arguments in socket().

• Improved validation of supported flags on send() and recv() for protocols.

bsdlib 0.6.1

• Implemented TLS host name verification.

• Implemented TLS session caching, enabled by default.

• Added the nrf_setdnsaddr() function to set the secondary DNS address.

• Removed unused BSD_MAX_IP_SOCKET_COUNT and BSD_MAX_AT_SOCKET_COUNT macros.

• Fixed a bug that prevented the application from detecting AGPS notifications.

• Fixed a bug where the application could not allocate the 8th socket.

bsdlib 0.6.0

• Removed the nrf_inbuilt_key API. From now on, the application is responsible for provisioning keys using the AT command %CMNG.

• Removed the nrf_apn_class API. From now on, the application is responsible for handling the Access Point Name (APN) class.

• Removed the crypto dependency towards nrf_oberon from the library. The library does not need any special cryptography functions anymore, because the application is now responsible for signing AT commands.

bsdlib 0.5.1

• Fixed internal memory issue in GNSS, which lead to crash when running for hours.

bsdlib 0.5.0

• bsd_irrecoverable_handler() has been removed. The application no longer needs to implement it to receive errors during initialization, which are instead reported through bsd_init().

• bsd_shutdown() now returns an integer.

• Added RAW socket support.

• Added missing AGPS data models.

• Added APGS notification support.

• Fixed an issue where AGPS data could not be written when the GPS socket was in stopped state.

• Fixed a memory leak in GPS socket.

bsdlib 0.4.3

Updated the library with the following changes:

• Added support for signaling if a peer sends larger TLS fragments than receive buffers can handle. If this scenario is triggered, NRF_ENOBUFS is reported in recv(). The link is also disconnected on TLS level by issuing an Encryption Alert, and TCP is reset from the device side. Subsequent calls to send() or recv() report NRF_ENOTCONN. The feature will be supported in an upcoming modem firmware version.

• Resolved an issue where sending large TLS messages very close to each other in time would result in a blocking send() that did not return.

bsdlib 0.4.2

• Reduced ROM footprint.

• Miscellaneous improvements to PDN sockets.

• Fixed an issue when linking with mbedTLS.

bsdlib 0.4.1

Updated the library with the following changes:

• Added socket option NRF_SO_PDN_CONTEXT_ID for PDN protocol sockets to retrieve the Context ID of the created PDN.

• Added socket option NRF_SO_PDN_STATE for PDN protocol socket to check the active state of the PDN.

• Fixed a TCP stream empty packet indication when a blocking receive got the peer closed notification while waiting for data to arrive.

• Fixed an issue where IP sockets did not propagate a fine-grained error reason, and all disconnect events resulted in NRF_ENOTCONN. Now the error reasons could be one of the following: NRF_ENOTCONN, NRF_ECONNRESET, NRF_ENETDOWN, NRF_ENETUNREACH.

• Fixed an issue with a blocking send() operation on IP sockets that was not really blocking but returning immediately in case of insufficient memory to perform the operation. The new behavior is that blocking sockets will block until the message is sent. Also, because of internal limitations, a non-blocking socket might block for a short while until shortage of memory has been detected internally, and then return with errno set to NRF_EAGAIN.

• Corrected errno that is set by send() from NRF_ENOMEM to NRF_EMSGSIZE in case of attempts on sending larger messages than supported by the library.

• Added a define BSD_IP_MAX_MESSAGE_SIZE in bsd_limits.h to hint what size is used to report NRF_EMSGSIZE in the updated send() function.

• Fixed an issue with nrf_inbuilt_key_read() not respecting the p_buffer_len input parameter, making it possible for the library to write out-of-bounds on the buffer provided.

bsdlib 0.4.0

• Added AGPS support to GNSS socket driver.

• Added support for GNSS power save modes.

• Added support for deleting stored GPS data.

• Changed NRF_CONFIG_NMEA* define names to NRF_GNSS_NMEA* for alignment.

bsdlib 0.3.4

Updated library with various changes:

• Improved error handling when running out of memory.

• Modified nrf_inbuilt_key_exists() so that it does not return an error if a key does not exist. p_exists will be updated correctly in this case.

• Fixed a memory leak in nrf_inbuilt_key_exists() on error.

bsdlib 0.3.3

Updated library with various changes:

• Bug fix internal to the library solving issue with unresponsive sockets.

bsdlib 0.3.2

Updated library with various changes:

• Changed socket option NRF_SO_RCVTIMEO to use nrf_timeval struct instead of uint32_t.

• Improved the PDN socket close (NRF_PROTO_PDN) function.

• Added new errno values NRF_ENOEXEC, NRF_ENOSPC, and NRF_ENETRESET.

• Added a return value on bsd_init() to indicate MODEM_DFU result codes or initialization result.

• Corrected GNSS struct nrf_gnss_datetime_t to use correct size on the ms member.

• Updated modem DFU interface.

• Improved error reporting on network or connection loss.

• Corrected the value of NRF_POLLNVAL.

• Improved TCP peer stream closed notification and empty packet indication.

bsdlib 0.3.1

Updated library with various changes:

• Corrected GNSS API to not fault if not read fast enough.

• Improved length reporting on GNSS NMEA strings to report length until zero-termination.

• Improved closing of GNSS socket. If closed, it will now also stop the GNSS from running.

• Corrected bitmask value of NRF_GNSS_SV_FLAG_UNHEALTHY.

• Added side API for APN Class management.

• Removed NRF_SO_PDN_CLASS from nrf_socket.h as it is replaced by side API for APN class management.

• Improved nrf_poll() error return on non-timeout errors to be NRF_EAGAIN, to align with standard return codes from poll().

• Added implementation of inet_pton() and inet_ntop().

• Added empty packet to indicate EOF when TCP peer has closed the connection.

• Added NRF_POLLHUP to poll() bitmask to indicate sockets that peer has closed the connection (EOF).

bsdlib 0.3.0

Updated library with experimental GNSS support.

bsdlib 0.2.4

Updated library with bug fixes:

• Fix issue of reporting NRF_POLLIN on a socket handle using nrf_poll, even if no new data has arrived.

• Fix issue of sockets not blocking on recv/recvfrom when no data is available.

bsdlib 0.2.3

Updated library with various changes:

• Updated library to use nrf_oberon v3.0.0.

• Updated the library to be deployed without inbuilt libc or libgcc symbols (-nostdlib -nodefaultlibs -nostartfiles -lnosys).

• Fixed issues with some unresolved symbols internal to the library.

• Updated API towards bsd_os_timedwait function. The timeout parameter is now an in and out parameter. The bsd_os implementation is now expected to set the remaining time left of the time-out value in return.

bsdlib 0.2.2

Updated library with API for setting APN name when doing getaddrinfo request.

• Providing API through nrf_getaddrinfo, ai_next to set a second hint that defines the APN name to use for getaddrinfo query. The hint must be using NRF_AF_LTE, NRF_SOCK_MGMT, and NRF_PROTO_PDN as family, type, and protocol. The APN is set through the ai_canonname field.

bsdlib 0.2.1

Updated library with bug fixes:

• Updated nrf_inbuilt_key.h with smaller documentation fixes.

• Bug fix in the nrf_inbuilt_key API to allow PSK and Identity to be provisioned successfully.

• Bug fix in the nrf_inbuilt_key API to allow security tags in the range of 65535 to 2147483647 to be deleted, read, and listed.

• Bug fix in proprietary trace log.

bsdlib 0.2.0

Updated library and header files:

• Enabled Nordic Semiconductor proprietary trace log. Increased consumption of the dedicated library RAM, indicated in bsd_platform.h.

• Resolved include of stdint.h in bsd.h.

bsdlib 0.1.0

Initial release.

Added

• Added the following BSD Socket library variants for nrf9160, for soft-float and hard-float builds:

  • libbsd_nrf9160_xxaa.a

  • liboberon_2.0.5.a (dependency of libbsd)