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/security/crypto/drivers.rst

@@ -446,3 +446,56 @@ 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.
  *
  * @{
  */