doc: cracen: add doxygen docs to cracenpsa headers

Added doxygen API documentation to headers under cracenpsa/include.
NCSDK-33026.

Signed-off-by: Grzegorz Ferenc <[email protected]>

Author: greg-fer

doc/nrf/nrf.doxyfile.in

@@ -963,6 +963,8 @@ INPUT                  = @DOCSET_SOURCE_BASE@/applications \
                          @DOCSET_SOURCE_BASE@/subsys/nrf_security/include/psa/crypto_driver_contexts_key_derivation.h \
                          @DOCSET_SOURCE_BASE@/subsys/nrf_security/include/psa/crypto_driver_contexts_primitives.h \
                          @DOCSET_SOURCE_BASE@/subsys/nrf_security/include/nrf_security_api_structure.h \
+                         @DOCSET_SOURCE_BASE@/subsys/nrf_security/src/drivers/cracen/cracenpsa/include \
+                         @DOCSET_SOURCE_BASE@/subsys/nrf_security/src/drivers/cracen/common/include/cracen/statuscodes.h \
                          @DOCSET_SOURCE_BASE@/subsys/trusted_storage/include/psa \
 
 # This tag can be used to specify the character encoding of the source files

doc/nrf/releases_and_maturity/releases/release-notes-changelog.rst

@@ -120,6 +120,8 @@ Security
     The algorithm implementation is conformant to the NIST SP 800-108 Rev. 1 recommendation.
   * Support for the secp384r1 key storage in the :ref:`Key Management Unit (KMU) <ug_nrf54l_crypto_kmu_supported_key_types>`.
 
+* Updated the :ref:`API documentation section for the cryptographic drivers <crypto_drivers_api_documentation>` with links to the added API documentation for the CRACEN driver.
+
 Protocols
 =========
 
@@ -437,7 +439,9 @@ Gazell libraries
 Security libraries
 ------------------
 
-|no_changes_yet_note|
+* :ref:`nrf_security` library:
+
+  * Updated the header files at :file:`subsys/nrf_security/src/drivers/cracen/cracenpsa/include/` with Doxygen documentation.
 
 Modem libraries
 ---------------

doc/nrf/security/crypto/drivers.rst

@@ -440,9 +440,64 @@ For configuration details, see the following pages:
 * :ref:`psa_crypto_support`
 * :ref:`nrf_security_legacy_backend_config` (nrf_oberon used as legacy backend)
 
+.. _crypto_drivers_api_documentation:
+
 API documentation
 *****************
 
 | Header files: :file:`subsys/nrf_security/include/psa/crypto_driver_contexts_*.h`
 
 .. doxygengroup:: nrf_security_api_structures
+
+CRACEN driver API
+=================
+
+| Header files: :file:`subsys/nrf_security/src/drivers/cracen/cracenpsa/include/cracen_psa.h`
+
+.. doxygengroup:: cracen_psa_driver_api
+
+CRACEN Key Management Unit (KMU)
+================================
+
+| Header files: :file:`subsys/nrf_security/src/drivers/cracen/cracenpsa/include/cracen_psa_kmu.h`
+
+.. doxygengroup:: cracen_psa_kmu
+
+CRACEN driver internal API
+==========================
+
+| Header files: Internal implementation headers in :file:`subsys/nrf_security/src/drivers/cracen/cracenpsa/include/`
+
+.. note::
+   These APIs are for internal use only. Applications should use the PSA Crypto API
+   (``psa_*`` functions) instead of calling these functions directly.
+
+.. doxygengroup:: cracen_psa_driver_internal
+
+CRACEN built-in key policy
+==========================
+
+| Header files: :file:`subsys/nrf_security/src/drivers/cracen/cracenpsa/include/cracen_psa_builtin_key_policy.h`
+
+.. doxygengroup:: cracen_psa_builtin_key_policy
+
+CRACEN key IDs
+==============
+
+| Header files: :file:`subsys/nrf_security/src/drivers/cracen/cracenpsa/include/cracen_psa_key_ids.h`
+
+.. doxygengroup:: cracen_psa_key_ids
+
+CRACEN PSA primitives
+=====================
+
+| Header files: :file:`subsys/nrf_security/src/drivers/cracen/cracenpsa/include/cracen_psa_primitives.h`
+
+.. doxygengroup:: cracen_psa_primitives
+
+SX status codes
+===============
+
+| Header files: :file:`subsys/nrf_security/src/drivers/cracen/common/include/cracen/statuscodes.h`
+
+.. doxygengroup:: status_codes

subsys/nrf_security/src/drivers/cracen/common/include/cracen/statuscodes.h

@@ -8,7 +8,8 @@
 #define CRACEN_STATUSCODES_HEADER_FILE
 
 /**
- * @addtogroup
+ * @defgroup status_codes SX Status Codes
+ * @brief SX status code definitions.
  *
  * @{
  */