diff --git a/doc/nrf/links.txt b/doc/nrf/links.txt index 1b4f01a2ef96..2a36f8547898 100644 --- a/doc/nrf/links.txt +++ b/doc/nrf/links.txt @@ -364,6 +364,7 @@ .. #### Source: www.nordicsemi.com/Events/ +.. _`nRF Connect SDK v2.9.0 webinar`: .. _`nRF Connect SDK v2.8.0 webinar`: https://webinars.nordicsemi.com/events .. _`nRF Connect SDK v2.7.0 webinar`: https://www.nordicsemi.com/Events/2024/Webinar-Exciting-new-features-in-nRF-Connect-SDK-v270 .. _`nRF Connect SDK v2.6.0 webinar`: https://www.nordicsemi.com/Events/2024/Webinar-Exciting-new-features-in-nRF-Connect-SDK-v260 @@ -423,7 +424,8 @@ .. _`nRF Connect SDK latest documentation`: https://docs.nordicsemi.com/bundle/ncs-latest/page/nrf/index.html .. _`known issues page on the main branch`: https://docs.nordicsemi.com/bundle/ncs-latest/page/nrf/releases_and_maturity/known_issues.html -.. _`known issues for nRF Connect SDK v2.8.0`: https://developer.nordicsemi.com/nRF_Connect_SDK/doc/latest/nrf/releases_and_maturity/known_issues.html?v=v2-8-0 +.. _`known issues for nRF Connect SDK v2.9.0`: https://docs.nordicsemi.com/bundle/ncs-latest/page/nrf/releases_and_maturity/known_issues.html?v=v2-9-0 +.. _`known issues for nRF Connect SDK v2.8.0`: https://docs.nordicsemi.com/bundle/ncs-latest/page/nrf/releases_and_maturity/known_issues.html?v=v2-8-0 .. _`known issues for nRF Connect SDK v2.7.0`: https://docs.nordicsemi.com/bundle/ncs-latest/page/nrf/releases_and_maturity/known_issues.html?v=v2-7-0 .. _`known issues for nRF Connect SDK v2.6.2`: https://docs.nordicsemi.com/bundle/ncs-latest/page/nrf/releases_and_maturity/known_issues.html?v=v2-6-2 .. _`known issues for nRF Connect SDK v2.6.1`: https://docs.nordicsemi.com/bundle/ncs-latest/page/nrf/releases_and_maturity/known_issues.html?v=v2-6-1 @@ -472,6 +474,7 @@ .. _`nRF socket options`: https://docs.nordicsemi.com/bundle/ncs-latest/page/nrfxlib/nrf_modem/doc/sockets.html +.. _`Repositories and revisions for v2.9.0`: https://docs.nordicsemi.com/bundle/ncs-2.9.0/page/nrf/releases_and_maturity/repository_revisions.html .. _`Repositories and revisions for v2.8.0`: https://docs.nordicsemi.com/bundle/ncs-2.8.0/page/nrf/releases_and_maturity/repository_revisions.html .. _`Repositories and revisions for v2.7.99-cs2`: https://docs.nordicsemi.com/bundle/ncs-2.7.99-cs2/page/nrf/releases_and_maturity/repository_revisions.html .. _`Repositories and revisions for v2.7.99-cs1`: https://docs.nordicsemi.com/bundle/ncs-2.7.99-cs1/page/nrf/releases_and_maturity/repository_revisions.html @@ -503,6 +506,7 @@ .. _`Repositories and revisions for v1.9.1`: https://docs.nordicsemi.com/bundle/ncs-1.9.1/page/nrf/introduction.html#repositories_and_revisions .. _`Repositories and revisions`: https://docs.nordicsemi.com/bundle/ncs-1.9.0/page/nrf/introduction.html#repositories_and_revisions +.. _`Modem library changelog for v2.9.0`: https://docs.nordicsemi.com/bundle/ncs-2.9.0/page/nrfxlib/nrf_modem/doc/CHANGELOG.html#nrf-modem-changelog .. _`Modem library changelog for v2.8.0`: https://docs.nordicsemi.com/bundle/ncs-2.8.0/page/nrfxlib/nrf_modem/doc/CHANGELOG.html#nrf-modem-changelog .. _`Modem library changelog for v2.7.0`: https://docs.nordicsemi.com/bundle/ncs-2.7.0/page/nrfxlib/nrf_modem/doc/CHANGELOG.html#nrf-modem-changelog .. _`Modem library changelog for v2.6.2`: https://docs.nordicsemi.com/bundle/ncs-2.6.2/page/nrfxlib/nrf_modem/doc/CHANGELOG.html#nrf-modem-changelog @@ -531,6 +535,7 @@ .. _`Modem library changelog for v1.9.1`: https://docs.nordicsemi.com/bundle/ncs-1.9.1/page/nrfxlib/nrf_modem/doc/CHANGELOG.html .. _`Modem library changelog for v1.9.0`: https://docs.nordicsemi.com/bundle/ncs-1.9.0/page/nrfxlib/nrf_modem/doc/CHANGELOG.html +.. _`LwM2M carrier library changelog for v2.9.0`: https://docs.nordicsemi.com/bundle/ncs-2.9.0/page/nrf/libraries/bin/lwm2m_carrier/CHANGELOG.html#liblwm2m-carrier-changelog .. _`LwM2M carrier library changelog for v2.8.0`: https://docs.nordicsemi.com/bundle/ncs-2.8.0/page/nrf/libraries/bin/lwm2m_carrier/CHANGELOG.html#liblwm2m-carrier-changelog .. _`LwM2M carrier library changelog for v2.7.0`: https://docs.nordicsemi.com/bundle/ncs-2.7.0/page/nrf/libraries/bin/lwm2m_carrier/CHANGELOG.html#liblwm2m-carrier-changelog .. _`LwM2M carrier library changelog for v2.6.2`: https://docs.nordicsemi.com/bundle/ncs-2.6.2/page/nrf/libraries/bin/lwm2m_carrier/CHANGELOG.html#liblwm2m-carrier-changelog @@ -560,6 +565,7 @@ .. _`LwM2M carrier library changelog for v1.9.0`: https://docs.nordicsemi.com/bundle/ncs-1.9.0/page/nrf/libraries/bin/lwm2m_carrier/CHANGELOG.html +.. _`Migration guide for nRF Connect SDK v2.9.0`: https://docs.nordicsemi.com/bundle/ncs-latest/page/nrf/releases_and_maturity/migration/migration_guide_2.9.html .. _`Migration guide for nRF Connect SDK v2.8.0`: https://docs.nordicsemi.com/bundle/ncs-latest/page/nrf/releases_and_maturity/migration/migration_guide_2.8.html .. _`Migration guide for nRF Connect SDK v2.7.0`: https://docs.nordicsemi.com/bundle/ncs-latest/page/nrf/releases_and_maturity/migration/migration_guide_2.7.html .. _`Migration guide for nRF Connect SDK v2.6.0`: https://docs.nordicsemi.com/bundle/ncs-latest/page/nrf/releases_and_maturity/migration/migration_guide_2.6.html @@ -1544,6 +1550,8 @@ .. ### Source: files.nordicsemi.com +.. _`Twister test report for nRF Connect SDK v2.9.0`: https://files.nordicsemi.com/ui/api/v1/download/contentBrowsing/NCS/external/release/v2.9.0/test-report/twister_test_results_report.html?isNativeBrowsing=true +.. _`Hardware test report for nRF Connect SDK v2.9.0`: https://files.nordicsemi.com/ui/api/v1/download/contentBrowsing/NCS/external/release/v2.9.0/test-report/common_ncs_test_results_report.html?isNativeBrowsing=true .. _`Twister test report for nRF Connect SDK v2.8.0`: https://files.nordicsemi.com/ui/api/v1/download/contentBrowsing/NCS/external/release/v2.8.0/test-report/twister_test_results_report.html?isNativeBrowsing=true .. _`Hardware test report for nRF Connect SDK v2.8.0`: https://files.nordicsemi.com/ui/api/v1/download/contentBrowsing/NCS/external/release/v2.8.0/test-report/common_ncs_test_results_report.html?isNativeBrowsing=true .. _`nRF Auracast configuration files`: https://files.nordicsemi.com/ui/repos/tree/General/ncs-audio/external/nRF-Aura-Config diff --git a/doc/nrf/releases_and_maturity.rst b/doc/nrf/releases_and_maturity.rst index 1f2f92ae00d2..b492d6eda2d4 100644 --- a/doc/nrf/releases_and_maturity.rst +++ b/doc/nrf/releases_and_maturity.rst @@ -28,4 +28,3 @@ If an issue is found in a release after it has taken place, those issues are lis releases_and_maturity/repository_revisions releases_and_maturity/software_maturity releases_and_maturity/abi_compatibility - releases_and_maturity/known_issues diff --git a/doc/nrf/releases_and_maturity/known_issues.rst b/doc/nrf/releases_and_maturity/known_issues.rst index 8073ca096f62..006d04af2256 100644 --- a/doc/nrf/releases_and_maturity/known_issues.rst +++ b/doc/nrf/releases_and_maturity/known_issues.rst @@ -1,3 +1,5 @@ +:orphan: + .. _known_issues: Known issues diff --git a/doc/nrf/releases_and_maturity/migration/migration_guide_1.x_to_2.x.rst b/doc/nrf/releases_and_maturity/migration/migration_guide_1.x_to_2.x.rst index d58b1e5db81a..a70e4ccbabe4 100644 --- a/doc/nrf/releases_and_maturity/migration/migration_guide_1.x_to_2.x.rst +++ b/doc/nrf/releases_and_maturity/migration/migration_guide_1.x_to_2.x.rst @@ -1,3 +1,5 @@ +:orphan: + .. _ncs_2.0.0_migration: Migration notes for |NCS| v2.0.0 diff --git a/doc/nrf/releases_and_maturity/migration/migration_guide_2.4.99-cs3_to_2.6.99-cs2.rst b/doc/nrf/releases_and_maturity/migration/migration_guide_2.4.99-cs3_to_2.6.99-cs2.rst index a5791574fac8..2fb0f6413515 100644 --- a/doc/nrf/releases_and_maturity/migration/migration_guide_2.4.99-cs3_to_2.6.99-cs2.rst +++ b/doc/nrf/releases_and_maturity/migration/migration_guide_2.4.99-cs3_to_2.6.99-cs2.rst @@ -1,3 +1,5 @@ +:orphan: + .. _migration_cs3_to_2_6_99_cs2: Migration notes for |NCS| v2.6.99_cs2 for v2.4.99-cs3 users diff --git a/doc/nrf/releases_and_maturity/migration/migration_guide_2.5.rst b/doc/nrf/releases_and_maturity/migration/migration_guide_2.5.rst index b7f4539c88be..b2cac995fd0b 100644 --- a/doc/nrf/releases_and_maturity/migration/migration_guide_2.5.rst +++ b/doc/nrf/releases_and_maturity/migration/migration_guide_2.5.rst @@ -1,3 +1,5 @@ +:orphan: + .. _migration_2.5: Migration guide for |NCS| v2.5.0 diff --git a/doc/nrf/releases_and_maturity/migration/migration_guide_2.6.rst b/doc/nrf/releases_and_maturity/migration/migration_guide_2.6.rst index d32a2ceab876..28c1318ccd70 100644 --- a/doc/nrf/releases_and_maturity/migration/migration_guide_2.6.rst +++ b/doc/nrf/releases_and_maturity/migration/migration_guide_2.6.rst @@ -1,3 +1,5 @@ +:orphan: + .. _migration_2.6: Migration guide for |NCS| v2.6.0 diff --git a/doc/nrf/releases_and_maturity/migration/migration_guide_2.7.rst b/doc/nrf/releases_and_maturity/migration/migration_guide_2.7.rst index 6921ef6bee69..fea0e6e69baf 100644 --- a/doc/nrf/releases_and_maturity/migration/migration_guide_2.7.rst +++ b/doc/nrf/releases_and_maturity/migration/migration_guide_2.7.rst @@ -1,3 +1,5 @@ +:orphan: + .. _migration_2.7: Migration guide for |NCS| v2.7.0 diff --git a/doc/nrf/releases_and_maturity/migration/migration_guide_2.8.rst b/doc/nrf/releases_and_maturity/migration/migration_guide_2.8.rst index fb8865e90cc6..5f31ccc6c84b 100644 --- a/doc/nrf/releases_and_maturity/migration/migration_guide_2.8.rst +++ b/doc/nrf/releases_and_maturity/migration/migration_guide_2.8.rst @@ -1,3 +1,5 @@ +:orphan: + .. _migration_2.8: Migration guide for |NCS| v2.8.0 diff --git a/doc/nrf/releases_and_maturity/migration/migration_guide_2.9.rst b/doc/nrf/releases_and_maturity/migration/migration_guide_2.9.rst index cfef28e3ac86..582d0c41af2f 100644 --- a/doc/nrf/releases_and_maturity/migration/migration_guide_2.9.rst +++ b/doc/nrf/releases_and_maturity/migration/migration_guide_2.9.rst @@ -1,7 +1,9 @@ +:orphan: + .. _migration_2.9: -Migration guide for |NCS| v2.9.0 (Working draft) -################################################ +Migration guide for |NCS| v2.9.0 +################################ .. contents:: :local: @@ -10,14 +12,10 @@ Migration guide for |NCS| v2.9.0 (Working draft) This document describes the changes required or recommended when migrating your application from |NCS| v2.8.0 to |NCS| v2.9.0. .. HOWTO - Add changes in the following format: - Component (for example, application, sample or libraries) ********************************************************* - .. toggle:: - * Change1 and description * Change2 and description diff --git a/doc/nrf/releases_and_maturity/migration/migration_guide_nRF54H20_cs_to_2_7.rst b/doc/nrf/releases_and_maturity/migration/migration_guide_nRF54H20_cs_to_2_7.rst index faeeff027ef1..74fe158b2745 100644 --- a/doc/nrf/releases_and_maturity/migration/migration_guide_nRF54H20_cs_to_2_7.rst +++ b/doc/nrf/releases_and_maturity/migration/migration_guide_nRF54H20_cs_to_2_7.rst @@ -1,3 +1,5 @@ +:orphan: + .. _migration_nrf54h20_to_2.7: Migration notes for |NCS| v2.7.0 and the nRF54H20 DK diff --git a/doc/nrf/releases_and_maturity/migration/migration_guide_nRF54H20_cs_to_2_7_99-cs1.rst b/doc/nrf/releases_and_maturity/migration/migration_guide_nRF54H20_cs_to_2_7_99-cs1.rst index 615f6086bf7c..1885f9f2a449 100644 --- a/doc/nrf/releases_and_maturity/migration/migration_guide_nRF54H20_cs_to_2_7_99-cs1.rst +++ b/doc/nrf/releases_and_maturity/migration/migration_guide_nRF54H20_cs_to_2_7_99-cs1.rst @@ -1,3 +1,5 @@ +:orphan: + .. _migration_nrf54h20_to_2.7.99-cs1: Migration notes for |NCS| v2.7.99-cs1 and the nRF54H20 DK diff --git a/doc/nrf/releases_and_maturity/migration/migration_guide_nRF54H20_cs_to_2_7_99-cs2.rst b/doc/nrf/releases_and_maturity/migration/migration_guide_nRF54H20_cs_to_2_7_99-cs2.rst index fdc471bc30c7..882d359fac3d 100644 --- a/doc/nrf/releases_and_maturity/migration/migration_guide_nRF54H20_cs_to_2_7_99-cs2.rst +++ b/doc/nrf/releases_and_maturity/migration/migration_guide_nRF54H20_cs_to_2_7_99-cs2.rst @@ -1,3 +1,5 @@ +:orphan: + .. _migration_nrf54h20_to_2.7.99-cs2: Migration notes for |NCS| v2.7.99-cs2 and the nRF54H20 DK diff --git a/doc/nrf/releases_and_maturity/migration/migration_hwmv2.rst b/doc/nrf/releases_and_maturity/migration/migration_hwmv2.rst index 5568857ddc18..6689347b3fdf 100644 --- a/doc/nrf/releases_and_maturity/migration/migration_hwmv2.rst +++ b/doc/nrf/releases_and_maturity/migration/migration_hwmv2.rst @@ -1,3 +1,5 @@ +:orphan: + .. _hwmv1_to_v2_migration: Migrating to the current hardware model diff --git a/doc/nrf/releases_and_maturity/migration/migration_sysbuild.rst b/doc/nrf/releases_and_maturity/migration/migration_sysbuild.rst index b813bb468c02..f891092a89e1 100644 --- a/doc/nrf/releases_and_maturity/migration/migration_sysbuild.rst +++ b/doc/nrf/releases_and_maturity/migration/migration_sysbuild.rst @@ -1,3 +1,5 @@ +:orphan: + .. _child_parent_to_sysbuild_migration: Migrating from multi-image builds to sysbuild diff --git a/doc/nrf/releases_and_maturity/migration_guides.rst b/doc/nrf/releases_and_maturity/migration_guides.rst index d169e313c883..4da6a9f09f35 100644 --- a/doc/nrf/releases_and_maturity/migration_guides.rst +++ b/doc/nrf/releases_and_maturity/migration_guides.rst @@ -9,10 +9,18 @@ Migration guides are also provided for major functionality updates. .. note:: |migration_contact_devzone| -.. toctree:: - :maxdepth: 1 - :glob: - :reversed: - :caption: Subpages: +* `Migrating from multi-image builds to sysbuild`_ +* `Migrating to the current hardware model`_ +* `Migration guide for nRF Connect SDK v2.9.0`_ +* `Migration guide for nRF Connect SDK v2.8.0`_ +* `Migration guide for nRF Connect SDK v2.7.0`_ +* `Migration guide for nRF Connect SDK v2.6.0`_ +* `Migration guide for nRF Connect SDK v2.5.0`_ +* `Migration guide for nRF Connect SDK v2.0.0`_ - migration/* +For nRF54H20 customer sampling participants: + +* `Migration notes for nRF Connect SDK v2.7.99-cs2 and the nRF54H20 DK`_ +* `Migration notes for nRF Connect SDK v2.7.99-cs1 and the nRF54H20 DK`_ +* `Migration notes for nRF Connect SDK v2.7.0 for nRF54H20 DK users`_ +* `Migration guide for nRF Connect SDK v2.6.99_cs2 for v2.4.99-cs3 users`_ diff --git a/doc/nrf/releases_and_maturity/release_notes.rst b/doc/nrf/releases_and_maturity/release_notes.rst index 3a198e6c171d..fd07dde6f2af 100644 --- a/doc/nrf/releases_and_maturity/release_notes.rst +++ b/doc/nrf/releases_and_maturity/release_notes.rst @@ -10,9 +10,8 @@ This page is included only in the latest documentation, because it might contain .. note:: A "99" at the end of the version number of this documentation indicates continuous updates on the main branch since the previous major.minor release. - When looking at this latest documentation, be aware of the following aspects: + When looking at this latest documentation, be aware of the following aspect: - * Changes between releases are tracked on the :ref:`ncs_release_notes_changelog` page, but the main branch might contain additional changes that are not listed on that page. * The release note pages that are available in the latest documentation might differ slightly from the release notes that were included in the respective |NCS| release at its release date. Therefore, to see the official version of the release notes for a specific |NCS| release, switch to the documentation for the corresponding |NCS| version using the selector in the upper left corner. @@ -20,7 +19,7 @@ This page is included only in the latest documentation, because it might contain :maxdepth: 1 :caption: Subpages: - releases/release-notes-changelog + releases/release-notes-2.9.0 releases/release-notes-2.8.0 releases/release-notes-2.7.99-cs2 releases/release-notes-2.7.99-cs1 diff --git a/doc/nrf/releases_and_maturity/releases/release-notes-2.9.0.rst b/doc/nrf/releases_and_maturity/releases/release-notes-2.9.0.rst new file mode 100644 index 000000000000..b9ab5e74e58e --- /dev/null +++ b/doc/nrf/releases_and_maturity/releases/release-notes-2.9.0.rst @@ -0,0 +1,873 @@ +.. _ncs_release_notes_290: + +|NCS| v2.9.0 Release Notes +########################## + +.. contents:: + :local: + :depth: 2 + +|NCS| delivers reference software and supporting libraries for developing low-power wireless applications with Nordic Semiconductor products in the nRF52, nRF53, nRF54, nRF70, and nRF91 Series. +The SDK includes open source projects (TF-M, MCUboot, OpenThread, Matter, and the Zephyr RTOS), which are continuously integrated and redistributed with the SDK. + +Release notes might refer to "experimental" support for features, which indicates that the feature is incomplete in functionality or verification, and can be expected to change in future releases. +To learn more, see :ref:`software_maturity`. + +Highlights +********** + + +Release tag +*********** + +The release tag for the |NCS| manifest repository (|ncs_repo|) is **v2.9.0**. +Check the :file:`west.yml` file for the corresponding tags in the project repositories. + +To use this release, check out the tag in the manifest repository and run ``west update``. +See :ref:`cloning_the_repositories` and :ref:`gs_updating_repos_examples` for more information. + +For information on the included repositories and revisions, see `Repositories and revisions for v2.9.0`_. + +Integration test results +************************ + +The integration test results for this tag can be found in the following external artifactory: + +* `Twister test report for nRF Connect SDK v2.9.0`_ +* `Hardware test report for nRF Connect SDK v2.9.0`_ + +IDE and tool support +******************** + +`nRF Connect extension for Visual Studio Code `_ is the recommended IDE for |NCS| v2.9.0. +See the :ref:`installation` section for more information about supported operating systems and toolchain. + +Supported modem firmware +************************ + +See the following documentation for an overview of which modem firmware versions have been tested with this version of the |NCS|: + +* `Modem firmware compatibility matrix for the nRF9151 DK`_ +* `Modem firmware compatibility matrix for the nRF9161 DK`_ +* `Modem firmware compatibility matrix for the nRF9160 DK`_ + +Use the latest version of the `Programmer app`_ of `nRF Connect for Desktop`_ to update the modem firmware. +See :ref:`nrf9160_gs_updating_fw_modem` for instructions. + +Modem-related libraries and versions +==================================== + +.. list-table:: Modem-related libraries and versions + :widths: 15 10 + :header-rows: 1 + + * - Library name + - Version information + * - Modem library + - `Changelog `_ + * - LwM2M carrier library + - `Changelog `_ + + +Known issues +************ + +Known issues are only tracked for the latest official release. +See `known issues for nRF Connect SDK v2.9.0`_ for the list of issues valid for the latest release. + +Migration notes +*************** + +See the `Migration guide for nRF Connect SDK v2.9.0`_ for the changes required or recommended when migrating your application from |NCS| v2.8.0 to |NCS| v2.9.0. + +.. _ncs_release_notes_290_changelog: + +Changelog +********* + +The following sections provide detailed lists of changes by component. + +IDE, OS, and tool support +========================= + +* Updated the deprecation notes for `nRF Command Line Tools`_ added in the previous release. + The notes now clearly state the tools will be archived: no updates will be made to the software, but it will still be available for download. + +Board support +============= + +* Updated various tests and samples to use Zephyr's :ref:`native_sim` instead of Zephyr's :ref:`native_posix` for :ref:`running_unit_tests`. + This mirrors the deprecation of ``native_posix`` in Zephyr. + Support for ``native_posix`` will be removed in Zephyr with the v4.2 release. + In the |NCS|, it will be removed once Zephyr v4.2 is upmerged to sdk-nrf. + +Build and configuration system +============================== + +* Fixed the issue in the ``nordic-bt-rpc`` snippet where an invalid memory map was created for nRF54H20 devices, which resulted in a runtime failure. + +Bootloaders and DFU +=================== + +* Updated the allowed offset for :ref:`doc_fw_info` in the :ref:`bootloader`. + It can now be placed at offset ``0x600``. + However, you cannot use it for any applications with |NSIB| compiled before this change. + +Developing with nRF91 Series +============================ + +* Moved the Thingy:91 and Thingy:91 X guides to new sections, :ref:`thingy91_ug_intro` and :ref:`ug_thingy91x` respectively, under :ref:`ug_app_dev`. + +Developing with nRF70 Series +============================ + +|no_changes_yet_note| + +Working with nRF54H Series +========================== + +|no_changes_yet_note| + +Developing with nRF54L Series +============================= + +* Added the :ref:`nRF54l_signing_app_with_flpr_payload` page that includes instructions for building separate applications, merging them, and signing them for MCUboot. + +Developing with nRF53 Series +============================ + +|no_changes_yet_note| + +Developing with nRF52 Series +============================ + +|no_changes_yet_note| + +Developing with Front-End Modules +================================= + +* Deprecated the explicit use of ``-DSHIELD=nrf21540ek_fwd`` for boards with ``nrf5340/cpuapp`` qualifiers when the nRF21540 EK shield is used. + The build system uses an appropriate overlay file for each core, relying only on the ``-DSHIELD=nrf21540ek`` parameter. + +Developing with PMICs +===================== + +|no_changes_yet_note| + +Security +======== + +|no_changes_yet_note| + +Protocols +========= + +|no_changes_yet_note| + +Amazon Sidewalk +--------------- + +|no_changes_yet_note| + +Bluetooth® LE +------------- + +* Added support for scanning and initiating at the same time. + This was introduced in |NCS| 2.7.0 as experimental. + The :ref:`bt_scanning_while_connecting` sample showcases how you can use this feature to reduce the time to establish connections to many devices. + +Bluetooth Mesh +-------------- + +|no_changes_yet_note| + +DECT NR+ +-------- + +|no_changes_yet_note| + +Enhanced ShockBurst (ESB) +------------------------- + +|no_changes_yet_note| + +Gazell +------ + +|no_changes_yet_note| + +Matter +------ + +* Added: + + * Implementation of the ``Spake2pVerifier`` class for the PSA crypto backend. + You can use this class to generate the Spake2+ verifier at runtime. + To use this class, enable the Kconfig options :kconfig:option:`CONFIG_PSA_WANT_ALG_PBKDF2_HMAC` and :kconfig:option:`CONFIG_PSA_WANT_KEY_TYPE_SPAKE2P_KEY_PAIR_DERIVE`. + * The Matter watchdog pause mode to the :ref:`ug_matter_device_watchdog` feature. + + +Matter fork ++++++++++++ + +The Matter fork in the |NCS| (``sdk-connectedhomeip``) contains all commits from the upstream Matter repository up to, and including, the ``v1.4.0.0`` tag. + +The following list summarizes the most important changes inherited from the upstream Matter: + +* Added: + + * Enhanced Network Infrastructure with Home Routers and Access Points (HRAP). + This provides requirements for devices such as home routers, modems or access points to create a necessary infrastructure for Matter products. + * Enhanced Multi-Admin that aims to simplify the smart home management from the user perspective. + This term includes several different features and in this release only Fabric Synchronization was fully delivered. + The Fabric Synchronization enables commissioning of devices from one fabric to another without requiring manual user actions, only user consent. + * Dynamic SIT LIT switching support that allows the application to switch between these modes, as long as the requirements for these modes are met. + You can enable this using the :kconfig:option:`CONFIG_CHIP_ICD_DSLS_SUPPORT` Kconfig option. + * The Kconfig option :kconfig:option:`CONFIG_CHIP_ICD_SIT_SLOW_POLL_LIMIT` to limit the slow polling interval value for the device while it is in the SIT mode. + You can use this to limit the slow poll interval for the ICD LIT device while it is temporarily working in the SIT mode. + * New device types: + + * Water heater + * Solar power + * Battery storage + * Heat pump + * Mounted on/off control + * Mounted dimmable load control + +* Updated: + + * Thermostat cluster with support for scheduling and preset modes, like vacation, and home or away settings. + * Electric Vehicle Supply Equipment (EVSE) with support for user-defined charging preferences, like specifying the time when the car will be charged. + * Occupancy sensing cluster with features like radar, vision, and ambient sensing. + * Intermittently Connected Devices feature with enhancements for the Long Idle Time (LIT) and Check-In protocol. + With this enhancements, the state of this feature is changed from provisional to certifiable. + +nRF IEEE 802.15.4 radio driver +------------------------------ + +|no_changes_yet_note| + +Thread +------ + +* Added Kconfig options for configuring the MLE child update timeout, child supervision interval, and child supervision check timeout. + +Zigbee +------ + +|no_changes_yet_note| + +Wi-Fi +----- + +* Updated the :ref:`wifi_regulatory_channel_rules` for some countries in the :ref:`ug_nrf70_developing_regulatory_support` documentation. + +Applications +============ + +This section provides detailed lists of changes by :ref:`application `. + +Machine learning +---------------- + +|no_changes_yet_note| + +Asset Tracker v2 +---------------- + +* Updated the Wi-Fi configurations to reduce the RAM usage by about 25 kB for an nRF91 Series DK and 12 kB for the Thingy:91 X. + +Connectivity bridge +------------------- + +* Updated the handling of USB CDC ACM baud rate requests to make sure the baud rate is set correctly when the host requests a change. + This fixes an issue when using GNU screen with the Thingy:91 X. + +IPC radio firmware +------------------ + +|no_changes_yet_note| + +Matter bridge +------------- + +* Added: + + * Support for the ``UniqueID`` attribute in the Bridged Device Basic Information cluster. + * Version 2 of bridged device data scheme containing ``UniqueID``. + * Kconfig options :ref:`CONFIG_BRIDGE_MIGRATE_PRE_2_7_0 ` and :ref:`CONFIG_BRIDGE_MIGRATE_VERSION_1 ` to enable migration from older data schemes. + +nRF5340 Audio +------------- + +* Updated the documentation for :ref:`nrf53_audio_app_building` with cross-links and additional information, based on user feedback. + +nRF Desktop +----------- + +* Updated: + + * The :ref:`nrf_desktop_settings_loader` to make the :ref:`Zephyr Memory Storage (ZMS) ` the default settings backend for all board targets that use the MRAM technology. + As a result, all :ref:`zephyr:nrf54h20dk_nrf54h20` configurations were migrated from the NVS settings backend to the ZMS settings backend. + * The :ref:`zephyr:nrf54h20dk_nrf54h20` release configuration to enable the :ref:`nrf_desktop_watchdog`. + * The configuration files of the :ref:`nrf_desktop_click_detector` (:file:`click_detector_def.h`) to allow using them also when Bluetooth LE peer control using a dedicated button (:ref:`CONFIG_DESKTOP_BLE_PEER_CONTROL `) is disabled. + * The DTS description for board targets with a different DTS overlay file for each build type to isolate the common configuration that is now defined in the :file:`app_common.dtsi` file. + The following board configurations have been updated: + + * :ref:`zephyr:nrf52840dk_nrf52840` + * :ref:`zephyr:nrf52840dongle_nrf52840` + * :ref:`zephyr:nrf54l15dk_nrf54l15` + * :ref:`zephyr:nrf54h20dk_nrf54h20` + + * MCUboot bootloader configurations to enable the following Kconfig options: + + * :kconfig:option:`CONFIG_FPROTECT` - Used to protect the bootloader partition against memory corruption. + * :kconfig:option:`CONFIG_HW_STACK_PROTECTION` - Used to protect against stack overflows. + + The :kconfig:option:`CONFIG_HW_STACK_PROTECTION` Kconfig option and its dependency (the :kconfig:option:`CONFIG_ARM_MPU` Kconfig option) might be disabled in case of targets with limited memory. + + * MCUboot bootloader configuration for the MCUboot SMP build type and the nRF52840 Gaming Mouse target to enable the :kconfig:option:`CONFIG_ARM_MPU` Kconfig option that is required to enable hardware stack protection (:kconfig:option:`CONFIG_HW_STACK_PROTECTION`). + +* Removed imply for partial erase feature of the nRF SoC flash driver (:kconfig:option:`CONFIG_SOC_FLASH_NRF_PARTIAL_ERASE`) for the USB next stack (:ref:`CONFIG_DESKTOP_USB_STACK_NEXT `). + The partial erase feature was used as a workaround for device errors that might be reported by the Windows USB host in Device Manager if a USB cable is connected while erasing a secondary image slot in the background. + The workaround is no longer needed after the nRF UDC driver was improved. + +nRF Machine Learning (Edge Impulse) +----------------------------------- + +|no_changes_yet_note| + +Serial LTE modem +---------------- + +|no_changes_yet_note| + +Thingy:53: Matter weather station +--------------------------------- + +|no_changes_yet_note| + +Samples +======= + +This section provides detailed lists of changes by :ref:`sample `. + +Amazon Sidewalk samples +----------------------- + +|no_changes_yet_note| + +Bluetooth samples +----------------- + +* Added: + + * The :ref:`channel_sounding_ras_reflector` sample demonstrating how to implement a Channel Sounding Reflector that exposes the Ranging Responder GATT Service. + * The :ref:`channel_sounding_ras_initiator` sample demonstrating basic distance estimation with Channel Sounding by setting up a Channel Sounding Initiator that acts as a Ranging Requestor GATT Client. + * The :ref:`bt_peripheral_with_multiple_identities` sample demonstrating how to use a single physical device to create and manage multiple advertisers, making it appear as multiple distinct devices by assigning each a unique identity. + * The :ref:`bt_scanning_while_connecting` sample demonstrating how to establish multiple connections faster using the :kconfig:option:`CONFIG_BT_SCAN_AND_INITIATE_IN_PARALLEL` Kconfig option. + * Support for the ``nrf54l15dk/nrf54l05/cpuapp`` and ``nrf54l15dk/nrf54l10/cpuapp`` board targets in the following samples: + + * :ref:`direct_test_mode` + * :ref:`peripheral_hids_mouse` + * :ref:`peripheral_lbs` + * :ref:`power_profiling` + * :ref:`peripheral_uart` + +* Updated: + + * Configurations of the following Bluetooth samples to make the :ref:`Zephyr Memory Storage (ZMS) ` the default settings backend for all board targets that use the MRAM technology: + + * :ref:`bluetooth_central_hids` + * :ref:`peripheral_hids_keyboard` + * :ref:`peripheral_hids_mouse` + * :ref:`central_and_peripheral_hrs` + * :ref:`central_bas` + * :ref:`central_nfc_pairing` + * :ref:`central_uart` + * :ref:`peripheral_bms` + * :ref:`peripheral_cgms` + * :ref:`peripheral_cts_client` + * :ref:`peripheral_lbs` + * :ref:`peripheral_mds` + * :ref:`peripheral_nfc_pairing` + * :ref:`power_profiling` + * :ref:`peripheral_rscs` + * :ref:`peripheral_status` + * :ref:`peripheral_uart` + * :ref:`ble_rpc_host` + + As a result, all :ref:`zephyr:nrf54h20dk_nrf54h20` configurations of the affected samples were migrated from the NVS settings backend to the ZMS settings backend. + * Testing steps in the :ref:`peripheral_hids_mouse` to provide the build configuration that is compatible with the `Bluetooth Low Energy app`_ testing tool. + + * :ref:`power_profiling` sample that now has added support for the :ref:`zephyr:nrf54h20dk_nrf54h20` board target. + +Bluetooth Fast Pair samples +--------------------------- + +* :ref:`fast_pair_locator_tag` sample: + + * Updated the MCUboot bootloader configuration for the :ref:`zephyr:nrf54l15dk_nrf54l15` board target to enable the :kconfig:option:`CONFIG_FPROTECT` Kconfig option that is used to protect the bootloader partition against memory corruption. + +* :ref:`fast_pair_input_device` sample: + + * Added support for the :ref:`zephyr:nrf54h20dk_nrf54h20` board target. + +Bluetooth Mesh samples +---------------------- + +* Added: + + * Support for nRF54L15 in the following samples: + + * :ref:`bluetooth_mesh_sensor_client` + * :ref:`bluetooth_mesh_sensor_server` + * :ref:`bluetooth_ble_peripheral_lbs_coex` + * :ref:`bt_mesh_chat` + * :ref:`bluetooth_mesh_light_switch` + * :ref:`bluetooth_mesh_silvair_enocean` + * :ref:`bluetooth_mesh_light_dim` + * :ref:`bluetooth_mesh_light` + * :ref:`ble_mesh_dfu_target` + * :ref:`bluetooth_mesh_light_lc` + * :ref:`ble_mesh_dfu_distributor` + + * Support for nRF54L05 in the following samples: + + * :ref:`bluetooth_mesh_sensor_client` + * :ref:`bluetooth_mesh_sensor_server` + * :ref:`bluetooth_ble_peripheral_lbs_coex` + * :ref:`bt_mesh_chat` + * :ref:`bluetooth_mesh_light_switch` + * :ref:`bluetooth_mesh_silvair_enocean` + * :ref:`bluetooth_mesh_light_dim` + * :ref:`bluetooth_mesh_light` + * :ref:`bluetooth_mesh_light_lc` + + +Cellular samples +---------------- + +* Updated the :kconfig:option:`CONFIG_NRF_CLOUD_CHECK_CREDENTIALS` Kconfig option to be optional and enabled by default for the following samples: + + * :ref:`nrf_cloud_rest_cell_location` + * :ref:`nrf_cloud_rest_device_message` + * :ref:`nrf_cloud_rest_fota` + +* :ref:`location_sample` sample: + + * Updated: + + * The Thingy:91 X build to support Wi-Fi by default without overlays. + * The Wi-Fi configurations to reduce the RAM usage by about 25 kB. + +* :ref:`modem_shell_application` sample: + + * Updated the Wi-Fi configurations to reduce the RAM usage by about 25 kB. + +* :ref:`nrf_cloud_multi_service` sample: + + * Updated the Wi-Fi configurations to reduce the RAM usage by about 12 kB for an nRF91 Series DK and 25 kB for the Thingy:91 X. + +Cryptography samples +-------------------- + +|no_changes_yet_note| + +Debug samples +------------- + +|no_changes_yet_note| + +DECT NR+ samples +---------------- + +* :ref:`dect_shell_application` sample: + + * Added: + + * The ``dect mac`` command. + A brief MAC-level sample on top of DECT PHY interface with new commands to create a periodic cluster beacon, scan for it, associate or disassociate a PT/client, and send data to a FT/beacon random access window. + This is not a full MAC implementation and not fully compliant with DECT NR+ MAC specification (`ETSI TS 103 636-4`_). + * The ``startup_cmd`` command. + This command is used to store shell commands to be run sequentially after bootup. + * Band 4 support for nRF9151 with modem firmware v1.0.2. + + * Updated: + + * The ``dect rssi_scan`` command with busy/possible/free subslot count-based RSSI scan. + * The ``dect rx`` command to provide the possibility to iterate all channels and to enable RX filter. + +Edge Impulse samples +-------------------- + +* Added support for the :ref:`zephyr:nrf54h20dk_nrf54h20` board target in the following samples: + + * :ref:`ei_data_forwarder_sample` + * :ref:`ei_wrapper_sample` + + * Added support for the :ref:`zephyr:nrf54h20dk_nrf54h20` board. + +Enhanced ShockBurst samples +--------------------------- + +|no_changes_yet_note| + +Gazell samples +-------------- + +|no_changes_yet_note| + +Keys samples +------------ + +|no_changes_yet_note| + +Matter samples +-------------- + +* Added the :ref:`matter_samples_config` page that documents Kconfig options and snippets used by Matter samples and applications. + +* Updated: + + * All Matter samples that support low-power mode to enable the :ref:`lib_ram_pwrdn` feature. + It is enabled by default for the release configuration of the :ref:`matter_lock_sample`, :ref:`matter_light_switch_sample`, :ref:`matter_smoke_co_alarm_sample`, and :ref:`matter_window_covering_sample` samples. + * All Matter samples to enable the ZMS file subsystem in all devices that contain MRAM, such as the nRF54H Series devices. + +* Disabled pausing Matter watchdog while CPU is in idle state in all Matter samples. + To enable it, set the :ref:`CONFIG_NCS_SAMPLE_MATTER_WATCHDOG_PAUSE_IN_SLEEP` Kconfig option to ``y``. + +* :ref:`matter_template_sample` sample: + + * Updated the internal configuration for the :ref:`zephyr:nrf54l15dk_nrf54l15` target to use the DFU image compression and provide more memory space for the application. + * Added support for the ``nrf54l15dk/nrf54l10/cpuapp`` build target. + +* :ref:`matter_smoke_co_alarm_sample` sample: + + * Added support for ICD dynamic SIT LIT switching (DSLS). + * Added support for the ``nrf54l15dk/nrf54l10/cpuapp`` build target. + +Networking samples +------------------ + +|no_changes_yet_note| + +NFC samples +----------- + +|no_changes_yet_note| + +nRF5340 samples +--------------- + +|no_changes_yet_note| + +Peripheral samples +------------------ + +* Added support for the ``nrf54l15dk/nrf54l05/cpuapp`` and ``nrf54l15dk/nrf54l10/cpuapp`` board targets in the :ref:`radio_test` sample. + +PMIC samples +------------ + +|no_changes_yet_note| + +Protocol serialization samples +------------------------------ + +* Updated GPIO pins on the nRF54L15 DK used for communication between the client and server over UART. + One of the previously selected pins was also used to drive an LED, which may have disrupted the UART communication. + +SDFW samples +------------ + +|no_changes_yet_note| + +Sensor samples +-------------- + +|no_changes_yet_note| + +SUIT samples +------------ + +|no_changes_yet_note| + +Trusted Firmware-M (TF-M) samples +--------------------------------- + +|no_changes_yet_note| + + +Thread samples +-------------- + +* Removed support for the ``nrf5340dk/nrf5340/cpuapp/ns`` build target for all samples. + +* :ref:`ot_cli_sample` sample: + + * Added support for the ``nrf54l15dk/nrf54l10/cpuapp`` build target. + +* :ref:`ot_coprocessor_sample` sample: + + * Added support for the ``nrf54l15dk/nrf54l10/cpuapp`` and ``nrf54l15dk/nrf54l05/cpuapp`` build targets. + +Zigbee samples +-------------- + +|no_changes_yet_note| + +Wi-Fi samples +------------- + +|no_changes_yet_note| + +Other samples +------------- + +* :ref:`coremark_sample` sample: + + * Updated: + + * Configuration for the :ref:`zephyr:nrf54h20dk_nrf54h20` board to support multi-domain logging using the ARM Coresight STM. + * The logging format in the standard logging mode to align it with the format used in the multi-domain logging mode. + * Support for alternative configurations to use the :ref:`file suffix feature from Zephyr `. + The following file suffixes are supported as alternative configurations: + + * ``flash_and_run`` + * ``heap_memory`` + * ``static_memory`` + * ``multiple_threads`` + +Drivers +======= + +This section provides detailed lists of changes by :ref:`driver `. + +|no_changes_yet_note| + +Wi-Fi drivers +------------- + +* Added the :ref:`nrf70_wifi_tx_power_calculation` section to the :ref:`nrf70_wifi` page. + +Libraries +========= + +This section provides detailed lists of changes by :ref:`library `. + +Binary libraries +---------------- + +* :ref:`liblwm2m_carrier_readme` library: + + * Updated the :ref:`req_appln_limitations` page to clarify carrier-specific requirements. + Added overlay files and documentation to :ref:`serial_lte_modem` application and :ref:`lwm2m_carrier` sample to guide in the correct usage of LwM2M carrier library for SoftBank and LG U+. + +Bluetooth libraries and services +-------------------------------- + + +* Added the :ref:`rreq_readme` and :ref:`rrsp_readme` libraries. + +* :ref:`hogp_readme` library: + + * Updated the :c:func:`bt_hogp_rep_read` function to forward the GATT read error code through the registered user callback. + This ensures that API user is aware of the error. + +* :ref:`bt_fast_pair_readme` library: + + * Added support in build system for devices that do not support the :ref:`partition_manager`. + The :ref:`zephyr:nrf54h20dk_nrf54h20` board target is the only example of such device. + +Common Application Framework +---------------------------- + +|no_changes_yet_note| + +Debug libraries +--------------- + +|no_changes_yet_note| + +DFU libraries +------------- + +|no_changes_yet_note| + +Gazell libraries +---------------- + +|no_changes_yet_note| + +Security libraries +------------------ + +|no_changes_yet_note| + +Modem libraries +--------------- + +* :ref:`modem_key_mgmt` library: + + * Updated to handle generic CME errors from all ``AT%CMNG`` commands. + +Multiprotocol Service Layer libraries +------------------------------------- + +|no_changes_yet_note| + +Libraries for networking +------------------------ + +|no_changes_yet_note| + +Libraries for NFC +----------------- + +|no_changes_yet_note| + +nRF RPC libraries +----------------- + +* Added the :ref:`nrf_rpc_dev_info` library for obtaining information about a device connected through the :ref:`nrfxlib:nrf_rpc`. + +Other libraries +--------------- + +|no_changes_yet_note| + +Security libraries +------------------ + +|no_changes_yet_note| + +Shell libraries +--------------- + +|no_changes_yet_note| + +Libraries for Zigbee +-------------------- + +|no_changes_yet_note| + +sdk-nrfxlib +----------- + +See the changelog for each library in the :doc:`nrfxlib documentation ` for additional information. + +Scripts +======= + +This section provides detailed lists of changes by :ref:`script `. + +* :ref:`nrf_desktop_config_channel_script` Python script: + + * Added support for pure ED25519 signature (used by nRF54L based devices that enable MCUboot hardware cryptography). + This requires using ``imgtool`` supporting pure ED25519 signature that can be installed from ``sdk-mcuboot`` repository. + +Integrations +============ + +This section provides detailed lists of changes by :ref:`integration `. + +Google Fast Pair integration +---------------------------- + +|no_changes_yet_note| + +Edge Impulse integration +------------------------ + +|no_changes_yet_note| + +Memfault integration +-------------------- + +|no_changes_yet_note| + +AVSystem integration +-------------------- + +|no_changes_yet_note| + +nRF Cloud integration +--------------------- + +|no_changes_yet_note| + +CoreMark integration +-------------------- + +|no_changes_yet_note| + +DULT integration +---------------- + +|no_changes_yet_note| + +MCUboot +======= + +The MCUboot fork in |NCS| (``sdk-mcuboot``) contains all commits from the upstream MCUboot repository up to and including ``a4eda30f5b0cfd0cf15512be9dcd559239dbfc91``, with some |NCS| specific additions. + +The code for integrating MCUboot into |NCS| is located in the :file:`ncs/nrf/modules/mcuboot` folder. + +The following list summarizes both the main changes inherited from upstream MCUboot and the main changes applied to the |NCS| specific additions: + +|no_changes_yet_note| + +Zephyr +====== + +.. NOTE TO MAINTAINERS: All the Zephyr commits in the below git commands must be handled specially after each upmerge and each nRF Connect SDK release. + +The Zephyr fork in |NCS| (``sdk-zephyr``) contains all commits from the upstream Zephyr repository up to and including ``beb733919d8d64a778a11bd5e7d5cbe5ae27b8ee``, with some |NCS| specific additions. + +For the list of upstream Zephyr commits (not including cherry-picked commits) incorporated into nRF Connect SDK since the most recent release, run the following command from the :file:`ncs/zephyr` repository (after running ``west update``): + +.. code-block:: none + + git log --oneline beb733919d ^ea02b93eea + +For the list of |NCS| specific commits, including commits cherry-picked from upstream, run: + +.. code-block:: none + + git log --oneline manifest-rev ^beb733919d + +The current |NCS| main branch is based on revision ``beb733919d`` of Zephyr. + +.. note:: + For possible breaking changes and changes between the latest Zephyr release and the current Zephyr version, refer to the :ref:`Zephyr release notes `. + +Additions specific to |NCS| +--------------------------- + +|no_changes_yet_note| + +zcbor +===== + +|no_changes_yet_note| + +Trusted Firmware-M +================== + +|no_changes_yet_note| + +cJSON +===== + +|no_changes_yet_note| + +Documentation +============= + +* Added: + + * Nordic Thingy:91 X to the list of devices supported by the `Quick Start app`_ on the :ref:`gsg_guides` page. + * The :ref:`matter_samples_config` page that documents Kconfig options and snippets shared by Matter samples and applications. + +* Fixed an issue on the :ref:`install_ncs` page where an incorrect directory path was provided for Linux and macOS at the end of the :ref:`cloning_the_repositories_win` section. diff --git a/doc/nrf/releases_and_maturity/releases/release-notes-changelog.rst b/doc/nrf/releases_and_maturity/releases/release-notes-changelog.rst index 712d0461d1bd..d0216fa0315b 100644 --- a/doc/nrf/releases_and_maturity/releases/release-notes-changelog.rst +++ b/doc/nrf/releases_and_maturity/releases/release-notes-changelog.rst @@ -1,6 +1,8 @@ +:orphan: + .. _ncs_release_notes_changelog: -Changelog for |NCS| v2.8.99 +Changelog for |NCS| v2.9.99 ########################### .. contents:: @@ -23,7 +25,7 @@ Known issues ************ Known issues are only tracked for the latest official release. -See :ref:`known_issues` for the list of issues valid for the latest release. +See `known issues for nRF Connect SDK v2.9.0`_ for the list of issues valid for the latest release. Changelog ********* diff --git a/samples/cellular/lwm2m_carrier/sample_description.rst b/samples/cellular/lwm2m_carrier/sample_description.rst index c196e418c58c..df492bdcba70 100644 --- a/samples/cellular/lwm2m_carrier/sample_description.rst +++ b/samples/cellular/lwm2m_carrier/sample_description.rst @@ -219,7 +219,7 @@ To test with the sample, complete the following steps: $ carrier_config server enable Enabled custom server config - #. Finally, as described in ref:`lwm2m_carrier_shell`, set ``auto_startup`` (or else the sample will wait indefinitely for you to configure all the settings). + #. Finally, as described in :ref:`lwm2m_carrier_shell`, set ``auto_startup`` (or else the sample will wait indefinitely for you to configure all the settings). .. code-block:: console