13 Troubleshooting

Build Issues

  1. CMake configuration fails—Verify XC32 compiler path is correct. Ensure DFP is installed and path is accurate. Check the Python version (v3.8+ required).
  2. Linker errors for missing symbols—Ensure both libtfpsacrypto.a and libhsmlite04777-pic32cm.a are linked.

Run-Time Issues

  1. PSA_ERROR_NOT_SUPPORTED for an algorithm—Verify the algorithm is enabled in your selected profile. Check that the correct configuration header was used during build.
  2. Random number generation fails—Ensure the HSM-Lite TRNG interrupt handler is configured. Verify MBEDTLS_PSA_CRYPTO_EXTERNAL_RNG is defined in configuration.

Memory Issues

  1. PSA_ERROR_INSUFFICIENT_MEMORY during operations—Increase the secure heap size in the linker script. Consider using a smaller profile if Flash/RAM is constrained.