Ronald Cron e943bd73ac configs/README.txt: Improve example with MBEDTLS/TF_PSA_CRYPTO_CONFIG_FILE
Signed-off-by: Ronald Cron <ronald.cron@arm.com>
2025-10-05 18:13:11 +02:00
..
ext Update configs README 2025-02-04 12:54:15 +00:00
config-ccm-psk-dtls1_2.h tests/configs: Adjusted for migration of MBEDTLS_PSA_CRYPTO_CONFIG_FILE. 2024-12-04 09:57:56 +00:00
config-ccm-psk-tls1_2.h tests/configs: Adjusted for migration of MBEDTLS_PSA_CRYPTO_CONFIG_FILE. 2024-12-04 09:57:56 +00:00
config-suite-b.h tests/configs: Adjusted for migration of MBEDTLS_PSA_CRYPTO_CONFIG_FILE. 2024-12-04 09:57:56 +00:00
config-symmetric-only.h tests/configs: Adjusted for migration of MBEDTLS_PSA_CRYPTO_CONFIG_FILE. 2024-12-04 09:57:56 +00:00
config-tfm.h configs: Migrated config-tfm 2024-12-04 09:57:56 +00:00
config-thread.h tests/configs: Adjusted for migration of MBEDTLS_PSA_CRYPTO_CONFIG_FILE. 2024-12-04 09:57:56 +00:00
crypto-config-ccm-psk-tls1_2.h Cleanup following the removal of MBEDTLS_ENTROPY_C option 2025-09-10 15:23:32 +02:00
crypto-config-suite-b.h Cleanup following the removal of MBEDTLS_ENTROPY_C option 2025-09-10 15:23:32 +02:00
crypto-config-thread.h Cleanup following the removal of MBEDTLS_ENTROPY_C option 2025-09-10 15:23:32 +02:00
README.txt configs/README.txt: Improve example with MBEDTLS/TF_PSA_CRYPTO_CONFIG_FILE 2025-10-05 18:13:11 +02:00

This directory contains example configuration files.

The examples are generally focused on a particular use case (eg, support for
a restricted set of ciphersuites) and aim to minimize resource usage for
the target. They can be used as a basis for custom configurations.

These files come in pairs and are complete replacements for the default
mbedtls_config.h and crypto_config.h. The two files of a pair share the same or
very similar name, with the crypto file prefixed by "crypto-". Note
that some of the cryptography configuration files may be located in
tf-psa-crypto/configs.

To use one of these pairs, you can pick one of the following methods:

1. Replace the default files include/mbedtls/mbedtls_config.h and
   tf-psa-crypto/include/psa/crypto_config.h with the chosen ones.

2. Use the MBEDTLS_CONFIG_FILE and TF_PSA_CRYPTO_CONFIG_FILE CMake options. For
   example, to build out-of-tree with the config-ccm-psk-tls1_2.h and
   crypto-config-ccm-psk-tls1_2.h configuration pair:

   cmake -DMBEDTLS_CONFIG_FILE="configs/config-ccm-psk-tls1_2.h" \
         -DTF_PSA_CRYPTO_CONFIG_FILE="configs/crypto-config-ccm-psk-tls1_2.h"
         -B build-psktls12 .
   cmake --build build-psktls12

The second method also works if you want to keep your custom configuration
files outside the Mbed TLS tree.