Skip to content

Commit

Permalink
softdevice_controller: rev e3c28fd38774d2778fd3e3e5030e2b7ca61d5690
Browse files Browse the repository at this point in the history
CHANGELOG.rst contains the list of changes.

Signed-off-by: Rubin Ingwer Gerritsen <rubin.gerritsen@nordicsemi.no>
  • Loading branch information
rugeGerritsen authored and rlubos committed Oct 23, 2024
1 parent 85e02fa commit c471e4e
Show file tree
Hide file tree
Showing 42 changed files with 3,558 additions and 3,573 deletions.
21 changes: 21 additions & 0 deletions softdevice_controller/CHANGELOG.rst
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@ Main branch
Added
=====

* Production support for the nRF54L Series. (DRGN-23325)
* Support for the LE Set Path Loss Reporting Parameters and LE Set Path Loss Reporting Enable HCI commands. (DRGN-17376)
* Support for generating connection anchor update event reports using the VS Conn Anchor Point Update Report Enable command.
When enabled, one report is generated when the anchor point of a connection is updated.
Expand All @@ -23,10 +24,27 @@ Added
See :c:func:`sdc_hci_cmd_vs_set_event_start_task`. (DRGN-20737)
* Support for the LE Set Default Subrate and LE Subrate Request HCI commands. (DRGN-19745)
* Support for ISO broadcaster handles in the :c:func:`sdc_hci_cmd_vs_zephyr_write_tx_power` and :c:func:`sdc_hci_cmd_vs_zephyr_read_tx_power` commands (DRGN-23441).
* :ref:`Experimental <nrf:software_maturity>` support for Channel Sounding (CS) on nRF54L Series devices.
Currently, the |controller| only supports one subevent per event.
The following HCI commands are now supported:

* LE CS Read Local Supported Capabilities
* LE CS Read Remote Supported Capabilities
* LE CS Security Enable
* LE CS Set Default Settings
* LE CS Read Remote FAE Table
* LE CS Create Config
* LE CS Set Channel Classification
* LE CS Set Procedure Parameters
* LE CS Procedure Enable
* LE CS Test
* LE CS Test End

Changes
=======

* Removed support for running the SoftDevice Controller on the nRF54L15 PDK v0.7.0 and earlier. (DRGN-23325)
* Removed support for running the SoftDevice Controller on the Engineering A revision of the nRF54H20 SoC. (DRGN-23325)
* The ``VersNr`` field in the ``LL_VERSION_IND`` packet now contains the value ``0x0E`` to indicate compatibility with Bluetooth Core Specification v6.0 (DRGN-23211).
* The ``sdc_coex_adv_mode_configure`` API has been deprecated as it is not applicable to any supported coexistence interfaces. (DRGN-20876).
* The ``sdc_hci_cmd_vs_coex_priority_config`` and ``sdc_hci_cmd_vs_coex_scan_mode_config`` vendor-specific HCI commands have been removed as they are not applicable to any supported coexistence interfaces. (DRGN-20876)
Expand Down Expand Up @@ -90,6 +108,9 @@ Bug fixes
* Fixed an issue where LE Power Control was not being used for CISes which are not the first CIS in a CIG. (DRGN-23291)
* Fixed an issue where the SoftDevice Controller in the peripheral role could terminate a connection due to a MIC failure during a valid encryption start procedure.
This could only happen if the ``LL_ENC_RSP`` packet was corrupted due to on-air interference. (DRGN-23204)
* Fixed an issue where received unframed Isochronous SDUs were not reported to be a SDU interval apart.
This could happen when the ISO interval is greater than the SDU interval and multiple SDUs can be received in a single ISO interval. (DRGN-23586)
* Fixed an issue where the sleep clock accuracy communicated to the peer was too inaccurate if MPSL was initialized with a low frequency clock accuracy better than 20ppm. (DRGN-23693)

nRF Connect SDK v2.7.0
**********************
Expand Down
7 changes: 6 additions & 1 deletion softdevice_controller/README.rst
Original file line number Diff line number Diff line change
Expand Up @@ -66,6 +66,9 @@ The libraries are available as soft-float, softfp-float, and hard-float builds f
+--------------------------------+-----------------+--------------+-----------+
| Connection Subrating | | | X |
+--------------------------------+-----------------+--------------+-----------+
| Channel Sounding | | | X |
| (experimental support) | | | |
+--------------------------------+-----------------+--------------+-----------+

.. note::
The following limitations apply to the listed features:
Expand All @@ -74,7 +77,8 @@ The libraries are available as soft-float, softfp-float, and hard-float builds f
* For Connection CTE Response, angle of arrival (AoA) is supported, but angle of departure (AoD) is not.
* For Periodic Advertising Sync Transfer - Receiver, only one sync transfer reception may be in progress at any one time per link.
* For the Isochronous Channels features, nRF52820 and nRF52833 are the nRF52 Series devices that support encrypting and decrypting the Isochronous Channels packets.
* For the nRF54H and nRF54L series, all Bluetooth features are experimental.
* For the nRF54H series, all Bluetooth features are experimental.
* For the Channel Sounding feature, support is experimental and only available for nRF54L Series devices.

.. _sdc_proprietary_feature_support:

Expand Down Expand Up @@ -104,6 +108,7 @@ Proprietary feature support:
doc/softdevice_controller
doc/scheduling
doc/isochronous_channels
doc/channel_sounding
limitations
CHANGELOG
doc/api
47 changes: 47 additions & 0 deletions softdevice_controller/doc/channel_sounding.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
.. _softdevice_controller_cs:

LE Channel Sounding
###################

.. contents::
:local:
:depth: 2

LE Channel Sounding (CS) is a feature defined in the `Bluetooth Core Specification`_.
CS allows two devices in a connection to perform measurements of their communication channel, both the round trip time (RTT), and the phase and magnitude (as in-phase and quadrature (IQ) values) can be measured.
The RTT and IQ values can then be sent to an application to calculate the distance between devices.

Channel Sounding currently has :ref:`Experimental <nrf:software_maturity>` support in the |controller| for the nRF54L15 SoC.
CS can be enabled by building with the :kconfig:option:`CONFIG_BT_CTLR_CHANNEL_SOUNDING` Kconfig option enabled.

Developing with CS
******************

Currently, the :zephyr:code-sample:`bluetooth_hci_uart` sample is recommended to get started with Channel Sounding.
Build the sample with the following command to enable the CS feature:

.. code-block:: console
west build -b nrf54l15dk/nrf54l15/cpuapp --pristine -- -DCONFIG_BT_CTLR_CHANNEL_SOUNDING=y
You can use the sample to run the following supported HCI commands over UART:

* LE CS Read Local Supported Capabilities
* LE CS Read Remote Supported Capabilities
* LE CS Security Enable
* LE CS Set Default Settings
* LE CS Read Remote FAE Table
* LE CS Create Config
* LE CS Set Channel Classification
* LE CS Set Procedure Parameters
* LE CS Procedure Enable
* LE CS Test
* LE CS Test End

Experimental Limitations
************************

Currently, the following limitations apply to the :ref:`Experimental <nrf:software_maturity>` support of Channel Sounding:

* :ref:`radio coexistence <nrf:ug_radio_coex>` and :ref:`front-end modules <mpsl_fem>` are not supported.
* Only one subevent per event is supported in CS.
2 changes: 1 addition & 1 deletion softdevice_controller/include/sdc.h
Original file line number Diff line number Diff line change
Expand Up @@ -337,7 +337,7 @@ extern "C" {
*
* @param[in] count Maximum number of concurrent connections supporting CS procedure.
*/
#define SDC_MEM_CS(count) ((count) > 0 ? (13 + (count)*7371) : 0)
#define SDC_MEM_CS(count) ((count) > 0 ? (13 + (count) * 8907) : 0)

/** @brief Maximum additional memory required to support Channel Sounding setup phase procedures
*
Expand Down
Loading

0 comments on commit c471e4e

Please sign in to comment.