Changelog
All notable changes to this project are documented in this file.
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
from0x201c
to0x2018
.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
andAT#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()
andnrf_recvfrom()
functions erroneously returned-1
and seterrno
toNRF_EAGAIN
instead of returning0
when these three conditions were met:The
nrf_recv()
andnrf_recvfrom()
functions were called with theNRF_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()
andnrf_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 valuesNRF_RAI_NO_DATA
,NRF_RAI_LAST
,NRF_RAI_ONE_RESP
,NRF_RAI_ONGOING
, andNRF_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 tounsigned short
(fromunsigned int
), to reduce the size of the socket address types.The type of the field
nrf_sockaddr.sa_family
tonrf_sa_family_t
(fromint
).The type of the field
nrf_sockaddr_in6.sin6_scope_id
touint8_t
(fromuint32_t
).The
NRF_SO_RCVTIMEO
socket option can now be used to set a timeout for thenrf_accept()
operation.
Fixed:
Rare multi-threading bugs in the
nrf_socket()
,nrf_recv()
, andnrf_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 theNRF_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
, andnrf_sec_session_cache_t
types. Useint
instead.The RAI socket options
NRF_SO_RAI_NO_DATA
,NRF_SO_RAI_LAST
,NRF_SO_RAI_ONE_RESP
,NRF_SO_RAI_ONGOING
, andNRF_SO_RAI_WAIT_MORE
.
Removed the field
nrf_sockaddr_in6.sin6_flowinfo
, to reduce the size of thenrf_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 thenrf_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
, andsin6_len
callbacks from thenrf_sockaddr
,nrf_sockaddr_in
, andnrf_sockaddr_in6
structs, respectively.Replaced the
NRF_SO_BINDTODEVICE
socket option withNRF_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 thenrf_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 toNRF_MODEM_GNSS_EVT_AGNSS_REQ
.The
NRF_MODEM_GNSS_DATA_AGPS_REQ
data type has been renamed toNRF_MODEM_GNSS_DATA_AGNSS_REQ
.The
nrf_modem_gnss_agps_data_frame
struct has been renamed tonrf_modem_gnss_agnss_data_frame
.The
nrf_modem_gnss_agps_expiry
struct has been renamed tonrf_modem_gnss_agnss_expiry
.The
nrf_modem_gnss_system_mask_set()
function has been renamed tonrf_modem_gnss_signal_mask_set()
.The
nrf_modem_gnss_agps_write()
function has been renamed tonrf_modem_gnss_agnss_write()
.The
nrf_modem_gnss_agps_expiry_get()
function has been renamed tonrf_modem_gnss_agnss_expiry_get()
.nrf_modem_gnss_agnss_data_frame
andnrf_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
andNRF_SO_SEC_DTLS_CID_STATUS
socket options for DTLS connection ID.The
NRF_SO_SEC_DTLS_CONN_SAVE
andNRF_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 fromnrf_modem.h
tonrf_socket.h
.
AT interface
Renamed the
at_cmd_filter
toat_cmd_custom
:The
nrf_modem_at_cmd_handler_t
type is renamed tonrf_modem_at_cmd_custom_handler_t
.The
nrf_modem_at_cmd_filter
struct is renamed tonrf_modem_at_cmd_custom
.The
nrf_modem_at_cmd_filter_set()
function is renamed tonrf_modem_at_cmd_custom_set()
.
The
paused
field was removed from thenrf_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 thenrf_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. Usenrf_modem_bootloader_init()
to initialize the library in bootloader mode.Added a
context
parameter tonrf_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()
andnrf_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 wrongerrno
(EBUSY
instead ofETIMEDOUT
).Fixed a bug in
nrf_poll()
where only the firstnrf_pollfd
structure would be updated in case the modem was shut down.Fixed a bug in
nrf_setsockopt()
where settingNRF_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()
andnrf_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()
andnrf_modem_at_printf()
.
GNSS interface
Added the
nrf_modem_gnss_agps_expiry.position_expiry
field tonrf_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. Thenrf_modem_full_dfu_apply()
function has been renamed tonrf_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 withNRF_
.
nrf_modem 2.2.1
Added the
MODEM_DFU_RESULT_VOLTAGE_LOW
result tonrf_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 thenrf_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()
andnrf_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 thenrf_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 thenrf_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
, thenrf_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 aNRF_SOCK_STREAM
socket incorrectly returned0
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 thenrf_modem_os_timedwait()
function.Added
nrf_modem_os_sem_count_get()
function to retrieve a semaphore’s count.Added
nrf_modem_os_trace_alloc()
andnrf_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
toNRF_SO_SEC_HOSTNAME
.Renamed the option
NRF_SO_CIPHERSUITE_LIST
toNRF_SO_SEC_CIPHERSUITE_LIST
.Renamed the option
NRF_SO_CIPHER_IN_USE
toNRF_SO_SEC_CIPHER_IN_USE
.Fixed a bug which could lead to
NRF_MODEM_GNSS_EVT_FIX
event being sent beforeNRF_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
andNRF_MODEM_IP_MAX_MESSAGE_SIZE
macros fromnrf_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 relativeNRF_FD_*
macros.Removed unused
nrf_sec_config_t
type.
nrf_modem 1.5.2
Added
nrf_modem_os_trace_irq_enable()
andnrf_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 innrf_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 toNRF_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()
andnrf_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 innrf_getaddrinfo()
.Fixed a potential concurrency issue in
nrf_getaddrinfo()
that would cause the outputhints
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()
andnrf_modem_os_trace_irq_handler()
functions have been renamed tonrf_modem_application_irq_handler()
andnrf_modem_trace_irq_handler()
respectively, and their definition has been moved tonrf_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 specifyingNRF_AF_UNSPEC
would incorrectly return an error.Fixed a bug in
nrf_setsockopt()
where the optionNRF_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 returningNRF_EAI_SYSTEM
.Fixed an issue where the
NRF_SO_TCP_SRV_SESSTIMEO
,NRF_SO_SILENCE_IP_ECHO_REPLY
andNRF_SO_SILENCE_IPV6_ECHO_REPLY
socket options returned an error when set usingnrf_setsockopt()
.Renamed the socket option
NRF_SO_SILENCE_IP_ECHO_REPLY
toNRF_SO_IP_ECHO_REPLY
.Renamed the socket option
NRF_SO_SILENCE_IPV6_ECHO_REPLY
toNRF_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 fornrf_getaddrinfo()
.The
NRF_POLLIN
flag is now set withNRF_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 fornrf_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 seterrno
toNRF_ECONNREFUSED
when failing due to a missing certificate, wrong certificate, or a wrong private key.Updated
nrf_getaddrinfo()
to return POSIX-compatible error codes fromnrf_gai_error.h
.Fixed a potential concurrency issue in
nrf_getaddrinfo()
.Fixed the
nrf_poll()
behavior whenfd
is less than zero.Fixed the
nrf_poll()
behavior whennfds
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
andNRF_POLLHUP
bynrf_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 theNRF_MSG_WAITALL
flag or theNRF_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 toNRF_EINVAL
, instead ofNRF_EBADF
.nrf_accept()
on a non-listening socket will now correctly set errno toNRF_EINVAL
, instead ofNRF_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 reportNRF_POLLERR
.Fixed an issue where
nrf_getsockopt()
called withNRF_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
andREUSEADDR
Fix to fidoless trace disable
bsdlib 0.7.3
Aligned the naming of
nrf_pollfd
structure elements withpollfd
.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 theaddrinfo
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 ofNRF_EINVAL
if the socket type isNRF_SOCK_STREAM
.Calling connect() on an already connected socket now properly returns
NRF_EISCONN
instead ofNRF_EBADF
.Sockets with family
NRF_AF_LTE
must now be created with typeNRF_SOCK_DGRAM
.Setting the timeout in recv() to a larger than the maximum supported value now properly returns
NRF_EDOM
instead ofNRF_EINVAL
.Fixed an overflow in timeout computation.
Operations on sockets that do not match the socket family now return
NRF_EAFNOSUPPORT
instead ofNRF_EINVAL
.Creating a socket when no sockets are available now returns
NRF_ENOBUFS
instead ofNRF_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
andBSD_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 anEncryption Alert
, and TCP is reset from the device side. Subsequent calls to send() or recv() reportNRF_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
toNRF_EMSGSIZE
in case of attempts on sending larger messages than supported by the library.Added a define
BSD_IP_MAX_MESSAGE_SIZE
inbsd_limits.h
to hint what size is used to reportNRF_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
, andNRF_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
inbsd.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)