Skip to content

Latest commit

 

History

History
77 lines (51 loc) · 2.51 KB

mbedtls.md

File metadata and controls

77 lines (51 loc) · 2.51 KB
Raw

MbedTLS

Overview

MbedTLS is a lightweight crytographic and SSL/TLS library designed for embedded systems and IoT devices.

It provides a wide range of cryptographic and security features including:

  • SSL/TLS support
  • Cryptography
  • Certificate handling
  • Key Management
  • Secure communication

In the FRI, MbedTLS is a crucial component for ensuring secure communication between IoT devices and cloud services. It is primarily used for transport layer security, authentication, encryption and certificate management.

Consult the FRI manifest.yml for the currently supported version of MbedTLS.

Configuration

User must provide an MbedTLS configuration file. It can be an empty file or override MbedTLS default configurations.

The configuration file specified by the application is retrieved by adding the C macro MBEDTLS_CONFIG_FILE=<filename> to the mbedtls-config target and its include path.

Example:

target_include_directories(mbedtls-config
    INTERFACE
        mbedtls-config
)

target_compile_definitions(mbedtls-config
    INTERFACE
        MBEDTLS_CONFIG_FILE="aws_mbedtls_config.h"
)

To enable the FreeRTOS threading protection #define MBEDTLS_THREADING_ALT should be present in the user provided mbedtls configuration file.

Integration

FreeRTOS threading support

The library mbedtls-threading-freertos is implemented in the FRI to provide a threading implementation for MbedTLS using FreeRTOS threading API.

The application must call mbedtls_threading_set_alt() to enable the multi threading protection.

Linking

In your application's CMakeLists.txt, link the application executable against the mbedtls library alongside any other libraries you need:

target_link_libraries(my-application
    ...
    mbedtls
)

💡 Replace my-application with the actual name of your application.

This not only enables the linking of the mbedtls static library, but also makes its API headers' include paths available to your application.

Documentation

For detailed documentation and API reference of MbedTLS, refer to the official MbedTLS documentation or GitHub repository.

Support

If you encounter any issues or have questions regarding the integration of MbedTLS into your IoT project, feel free to reach out to the Arm support community or consult the official documentation for assistance.