doc: crypto: minor edits and fixes

greg-fer · greg-fer · commit e9e736839238 · 2025-10-13T13:49:42.000+02:00
Fixed inaccuracies in nrf_cc3xx_mbedcrypto.rst.
Added cross-links in all pages.
NCSDK-33729.

Signed-off-by: Grzegorz Ferenc &lt;Grzegorz.Ferenc@nordicsemi.no&gt;
diff --git a/crypto/README.rst b/crypto/README.rst
@@ -1,7 +1,12 @@
 .. _crypto:
 
-Crypto Libraries
-################
+Cryptographic libraries
+#######################
+
+The cryptographic libraries in this section are backends for the following components in the |NCS|:
+
+* nrf_cc3xx_platform, nrf_cc3xx_mbedcrypto, and nrf_oberon are used by the :ref:`nrf:crypto_drivers`.
+* nrf_cc310_bl is used by the :ref:`doc_bl_crypto` library.
 
 .. toctree::
    :maxdepth: 2
diff --git a/crypto/doc/nrf_cc310_bl.rst b/crypto/doc/nrf_cc310_bl.rst
@@ -7,7 +7,7 @@ nrf_cc310_bl crypto library
    :local:
    :depth: 2
 
-The nrf_cc310_bl library is a software library to interface with Arm CryptoCell CC310 hardware accelerator that is available on the nRF52840 SoC and the nRF91 Series.
+The nrf_cc310_bl library is a software library that is used as a backend by the :ref:`doc_bl_crypto` library in the |NCS| to interface with Arm CryptoCell CC310 hardware accelerator that is available on the nRF52840 SoC and the nRF91 Series.
 The library adds hardware support for cryptographic algorithms to be used in bootloader-specific use cases.
 
 The nrf_cc310_bl library supports the following cryptographic algorithms:
diff --git a/crypto/doc/nrf_cc3xx_mbedcrypto.rst b/crypto/doc/nrf_cc3xx_mbedcrypto.rst
@@ -8,17 +8,18 @@ nrf_cc3xx_mbedcrypto library
    :local:
    :depth: 2
 
-The nrf_cc3xx_mbedcrypto library is software library to interface with the Arm CryptoCell hardware accelerator that is available on the nRF52840 SoC, the nRF53 Series, and the nRF91 Series.
+The nrf_cc3xx_mbedcrypto library is a software library used by the :ref:`nrf:crypto_drivers_cc3xx` in the |NCS| to interface with the Arm CryptoCell hardware accelerator that is available on the nRF52840 SoC, the nRF53 Series, and the nRF91 Series.
 The library adds hardware support for selected cryptographic algorithms.
 
+.. note::
+   Do not link to this library directly.
+   See :ref:`nrf:psa_crypto_support` for information on how to enable its related driver.
+
 Integration with Mbed TLS
 =========================
-The nrf_cc3xx_mbedcrypto library provides low-level integration with the Mbed TLS version provided in nRF Connect SDK.
-Some of the APIs expressed in this library use the Mbed TLS "alternative implementation" abstraction layer.
-
-.. note::
-   It is not recommended to link to this library directly. Use the :ref:`nrf:nrf_security`.
 
+The nrf_cc3xx_mbedcrypto library provides low-level integration with the Mbed TLS version provided in the |NCS|.
+Some of the APIs expressed in this library use the Mbed TLS :ref:`legacy crypto <nrf:legacy_crypto_support>` abstraction layer.
 
 Supported cryptographic algorithms
 ==================================
@@ -133,8 +134,9 @@ Otherwise, the library will default to use the clib functions :c:func:`calloc` a
 
 PSA driver integration
 ======================
-Starting from version 0.9.13, the nrf_oberon library contains a companion library that provides PSA driver integration for select features.
-This must be used with the :ref:`nrf:nrf_security`.
+
+Starting from version 0.9.13, the nrf_cc3xx_mbedcrypto library contains a companion nrf_cc3xx_platform library that provides access to low-level CryptoCell APIs.
+Both must be used through the :ref:`nrf:crypto_drivers_cc3xx` in the |NCS|.
 
 Supported features
 ------------------
@@ -155,20 +157,8 @@ The supported features for the PSA driver companion library are:
 
 Initializing the library
 ------------------------
-The library requires initialization before use.
-You can initialize it by calling the :c:func:`mbedtls_platform_setup`/:c:func:`mbedtls_platform_teardown` functions.
-
-.. code-block:: c
-    :caption: Initializing the library
 
-    int ret;
-    static mbedtls_platform_context platform_context = {0};
-
-    ret = mbedtls_platform_setup(&platform_context);
-    if (ret != 0) {
-            /* Failed to initialize nrf_cc3xx_mbedcrypto platform */
-            return ret,
-    }
+Use the library through the :ref:`nrf:crypto_drivers_cc3xx` in the |NCS|.
 
 .. note::
    There is no need to enable/disable the CC310 hardware by writing to the ``NRF_CRYPTOCELL->ENABLE`` and ``NRF_CRYPTOCELL_S->ENABLE`` registers.
diff --git a/crypto/doc/nrf_cc3xx_platform.rst b/crypto/doc/nrf_cc3xx_platform.rst
@@ -8,16 +8,13 @@ nrf_cc3xx_platform library
    :local:
    :depth: 2
 
-The nrf_cc3xx_platform library is software library to interface with the Arm CryptoCell CC310/CC312 hardware accelerator that is available on the nRF52840 SoC, the nRF53 Series, and the nRF91 Series.
+The nrf_cc3xx_platform library is a software library used by the :ref:`nrf:crypto_drivers_cc3xx` in the |NCS| to interface with the Arm CryptoCell CC310/CC312 hardware accelerator that is available on the nRF52840 SoC, the nRF53 Series, and the nRF91 Series.
 
-The platform library provides low-level functionality needed by the CC310/CC312
-mbedcrypto library.
+The platform library provides low-level functionality needed by the CC310/CC312 mbedcrypto library.
 
-This includes memory, mutex, and entropy APIs needed for the CC310/CC312 mbedcrypto
-library.
+This includes memory, mutex, and entropy APIs needed for the CC310/CC312 mbedcrypto library.
 
-The library adds hardware support for the True Random Number Generator, TRNG,
-available in the CC310/CC312 hardware.
+The library adds hardware support for the True Random Number Generator, TRNG, available in the CC310/CC312 hardware.
 
 API documentation
 =================
diff --git a/crypto/doc/nrf_oberon.rst b/crypto/doc/nrf_oberon.rst
@@ -10,6 +10,7 @@ nrf_oberon crypto library
 The nrf_oberon library contains a collection of cryptographic algorithms created by Oberon Microsystems, licensed to Nordic Semiconductor ASA for redistribution.
 The library provides highly optimized software for Nordic Semiconductor SoCs based on Cortex-M0, Cortex-M4, and Cortex-M33 architectures.
 
+The library is used by the :ref:`nrf:crypto_drivers_oberon` in the |NCS|.
 
 Supported cryptographic algorithms
 ==================================
@@ -29,6 +30,7 @@ Supported cryptographic algorithms
 
 Initializing the library
 ========================
+
 The library does not require any initialization before the APIs can be used, although some APIs require calling specific initialization functions before use.
 
 
