Mbed TLS 开源项目安装与使用指南

项目简介

Mbed TLS 是一个用 C 语言编写的开源库，它实现了加密算法、X.509 证书处理以及 SSL/TLS 和 DTLS 协议。该库因其小巧的代码体积而特别适合嵌入式系统。此外，Mbed TLS 包含了 PSA（Platform Security Architecture）密码学 API 的参考实现，目前仅供评估使用。

本指南将引导您了解 Mbed TLS 的关键组件，包括其目录结构、启动与配置文件，以便于您能够顺利地集成并使用这个强大的安全库。

1. 项目目录结构及介绍

Mbed TLS 的项目结构清晰，便于开发者快速定位所需的组件：

mbedtls/
├── 3rdparty            # 第三方依赖相关
├── cmake               # CMake 构建系统相关文件
├── configs             # 预定义配置文件，适用于特定场景
├── contrib             # 贡献者提供的附加组件
├── docs                # 文档资料
│   └── doxygen         # Doxygen 配置用于生成API文档
├── framework           # Git 子模块，特定版本控制的框架代码（仅在某些分支）
├── include             # 头文件，包含了所有的 API 定义
├── library             # 核心库源代码，包括 mbedcrypto, mbedx509, mbedtls
├── programs            # 示例程序
├── scripts             # 建设、测试相关的脚本，如配置修改工具
├── tests               # 测试套件
├── travis.yml          # Travis CI 配置文件
├── ...
└── README.md           # 主要的读我文件，提供快速入门指导

2. 项目启动文件介绍

Mbed TLS 不直接提供单一的“启动文件”，它的使用通常从配置和构建过程开始。不过，如果您正在寻找开始编写应用时的一个起点，通常是从创建一个新的项目，并在该项目中引入 mbedtls 库的头文件开始，例如 #include "mbedtls/cipher.h" 等。

构建过程中，您可以选择三种主要的构建系统之一来启动项目：GNU Make、CMake 或微软的Visual Studio。对于大多数开发者来说，首先进行的是配置过程，这可能涉及到编辑 include/mbedtls/mbedtls_config.h 或使用 scripts/config.py 脚本来调整功能的启用或禁用。

3. 项目的配置文件介绍

主配置文件：mbedtls_config.h

位于 include/mbedtls/mbedtls_config.h 的配置文件是核心所在，它允许用户通过预处理器宏来定制Mbed TLS的功能。这个文件注释详尽，提供了大量选项，让开发者可以根据实际需求裁剪库的大小和功能。

配置脚本：scripts/config.py

除了直接编辑 mbedtls_config.h，Mbed TLS 提供了一个Python脚本 scripts/config.py 来帮助管理配置。通过命令行参数，比如添加、删除宏定义，或者打印当前配置状态，它可以更加灵活和程序化地处理配置。

其他配置资源

在 configs/ 目录下，存在一些预配置的 .h 文件，这些可以作为基础配置或自定义配置的起点，简化特定应用场景下的配置流程。

---

遵循以上指南，您可以有效地探索和利用Mbed TLS的强大功能。记得，在正式开始前，确保您的环境已配备所有必要的构建和测试工具。